Files
ai-platform/.trae/specs/full-module-independence/tasks.md
T
dongskandClaude Sonnet 4.6 noreply@anthropic.com> 8699798ea5 feat: 模组全维度独立,消除全局 DOM/Portal/存储污染
- 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>
2026-10-19 09:10:30 +08:00

3.3 KiB
Raw Blame History

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 通过)
  • 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 遮罩
  • 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 两处真实违规被检出并修复)
  • 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 无输出)
  • 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

Task Dependencies

  • Task 1、Task 2 互相独立,可并行
  • Task 3 依赖 Task 1、Task 2(修复后门禁才能通过;门禁脚本本身可先写,用 HEAD 版本验证检出能力)
  • Task 4 与 Task 1/2/3 无代码冲突,可并行
  • Task 5 依赖 Task 1-4