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