- jieya-ibp/welltrust-qap ThemeContext 改为作用域容器承载 CSS 变量与背景色,不再写 document - 删除 order-cost CostCockpit 对 documentElement 的死变量写入 - bomx Drawer createPortal 挂载点内移到 .bomx-app,移除 document.body 兜底 - knowledge-graph 拖拽 cursor 改为根容器 ref - 新增 check-module-independence 门禁并接入 build - SOP 与融合技能文档补充「模组完全独立互不影响」章节 Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com>
3.3 KiB
3.3 KiB
Tasks
- Task 1: 修复全局 DOM 写入污染(jieya-ibp / welltrust-qap ThemeContext)
- SubTask 1.1:
jieya-ibp/context/ThemeContext.tsx:移除useEffect中对document.documentElement的setProperty与document.body.style.background/color;改为ThemeProvider返回的<ThemeContext.Provider>内包裹一层作用域<div>,以 inline style 设置--body-bg/--scroll-thumb/--glow-color/--hover-bg变量与background/color(值取自tokens),宽高 100% 承接AppInner的 100vw/100vh 根容器 - SubTask 1.2:
welltrust-qap/context/ThemeContext.tsx:同 1.1 改造 - SubTask 1.3:
order-cost-analysis/pages-orig/CostCockpit.tsx:移除向document.documentElement写--body-bg的useEffect(var(--body-bg)在模组内无引用,属死代码) - SubTask 1.4: 浏览器验证:进入 jieya 再回首页,首页背景/文字色未被覆盖;jieya 明暗主题切换正常(welltrust 同构改造,tsc + build 通过)
- SubTask 1.1:
- Task 2: Portal 挂载点内移(bomx Drawer)
- SubTask 2.1:
bomx-reuse-analyzer/pages/BomxReuseHome.tsx根容器内新增 Portal 挂载点<div ref={portalMountRef} /> - SubTask 2.2:
bomx-reuse-analyzer/components/Drawer.tsx:createPortal第二参数改为必传portalMount: HTMLDivElement,彻底移除document.body兜底 - SubTask 2.3: Drawer 当前未被任何文件引用(死代码),无运行时实例;
.bomx-app根容器无 transform/filter/perspective,不会破坏 fixed 遮罩
- SubTask 2.1:
- Task 3: 新增模组独立门禁脚本
- SubTask 3.1: 新增
scripts/check-module-independence.mjs(ESM 零依赖),扫描src/modules/**/*.{ts,tsx,js,jsx},检测 5 类违规(body 样式写入、documentElement 写入、head 注入、body Portal、无前缀 storage key),跳过字符串与注释,违规非零退出 - SubTask 3.2:
package.json增加check:independence;build改为tsc -b && npm run check:styles && npm run check:independence && vite build - SubTask 3.3: 自测:修复后退出码 0(扫描 270 文件);故意保留/插入的违规样例可正确检出(已验证 bomx Drawer、knowledge-graph 两处真实违规被检出并修复)
- SubTask 3.1: 新增
- Task 4: 文档沉淀(SOP + 技能)
- SubTask 4.1:
docs/react-module-integration-sop.md新增 §5「模组完全独立互不影响」(5.1–5.9),覆盖全维度规则与双门禁说明;章节顺延 - SubTask 4.2:
.trae/skills/react-module-integration/SKILL.md红线与验证清单同步 - SubTask 4.3:
.trae/skills/react-module-integration/references/react-module-integration-sop.md与 docs 完全同源(diff 无输出)
- SubTask 4.1:
- Task 5: 端到端验证
- SubTask 5.1:
npm run build通过(含双门禁),dist 无回归 - SubTask 5.2: 浏览器验证:首页→jieya→首页 body 样式串 before/during/after 完全一致(仅平台深色主题值),jieya 主题背景作用于
.jieya-root;控制台无报错 - SubTask 5.3:
npm run check:independence与npm run check:styles均退出码 0
- SubTask 5.1:
Task Dependencies
- Task 1、Task 2 互相独立,可并行
- Task 3 依赖 Task 1、Task 2(修复后门禁才能通过;门禁脚本本身可先写,用 HEAD 版本验证检出能力)
- Task 4 与 Task 1/2/3 无代码冲突,可并行
- Task 5 依赖 Task 1-4