docs(总览): 标记 B4(isAdminProfile 收口)完成

B4 代码在 eip4-web 分支 feat/arch-review-followup(commit 768ffa8);本提交仅同步总览 §10 B4 状态为已完成。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-24 11:20:24 +08:00
parent c4ef673b0a
commit 8df60e810c

View File

@@ -208,7 +208,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
### 10.3 P2 — 整洁度 / 一致性收敛(多为采纳自原文档的真问题,但属低优先) ### 10.3 P2 — 整洁度 / 一致性收敛(多为采纳自原文档的真问题,但属低优先)
- **✅【已完成 2026-06-24】【D5】抽共享 `LocalHostPolicy`**:原状=`AiToolRegistry`/`AiSmokeRunner`/`AiLocalReleaseExecutor` 三处本机白名单互异(ToolRegistry 认展开式 `0:0:0:0:0:0:0:1` 漏 `[::1]`,另两处反之)。**已做**:新增 `LocalHostPolicy.isLocalHost`(去 IPv6 方括号归一 + 精确比对回环集 `{localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1}`,杜绝 `127.0.0.1.evil.com` 伪本地绕过),三处删本地副本统一委托。**验证**:新增 `LocalHostPolicyTest`(接受全部回环形态 + 拒绝伪本地/非本机)3/3 + 三处既有测试(AiToolRegistry 6/AiSmokeRunner 3/AiLocalReleaseExecutor 3)无回归,整套 platform-ai 69/69 绿。 - **✅【已完成 2026-06-24】【D5】抽共享 `LocalHostPolicy`**:原状=`AiToolRegistry`/`AiSmokeRunner`/`AiLocalReleaseExecutor` 三处本机白名单互异(ToolRegistry 认展开式 `0:0:0:0:0:0:0:1` 漏 `[::1]`,另两处反之)。**已做**:新增 `LocalHostPolicy.isLocalHost`(去 IPv6 方括号归一 + 精确比对回环集 `{localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1}`,杜绝 `127.0.0.1.evil.com` 伪本地绕过),三处删本地副本统一委托。**验证**:新增 `LocalHostPolicyTest`(接受全部回环形态 + 拒绝伪本地/非本机)3/3 + 三处既有测试(AiToolRegistry 6/AiSmokeRunner 3/AiLocalReleaseExecutor 3)无回归,整套 platform-ai 69/69 绿。
- **【B4】抽 `isAdmin(profile)` 单函数**:`profile?.account==='admin'||profile?.userId==='ADMIN'` 在 Topbar/ModelerPage/NewFeatureShell/AiFeatureForm/DesignCenterPage 5 处逐字硬编码。 - **✅【已完成 2026-06-24·eip4-web】【B4】抽 `isAdminProfile(profile)` 单函数**:原状=`profile?.account==='admin'||profile?.userId==='ADMIN'` 在 Topbar/ModelerPage/NewFeatureShell/AiFeatureForm/DesignCenterPage 5 处逐字硬编码。**已做**:`auth/token.ts` 加纯函数 `isAdminProfile`(口径逐字保留),5 处统一委托。顺带把 5 个页面测试的 `vi.mock('../auth/token')` 从整模块替换改为 `importOriginal` 只覆盖 `getProfile`(不再 mock 纯函数,修复因 mock 漏 `isAdminProfile` 致的 render 崩)。**验证**:新增 `token.test.ts` 4 测试 + `tsc -b` 干净 + `vitest` 18 文件/77 测试全绿。
- **【B2】删 `api/schema.ts:65-102` overlay 死代码**(零调用,真相在 `editor/overlayApi.ts`);**【B1/B5】**拆 AmisRenderer SDK 注册逻辑、合并 todo.ts/done.ts 503 降级——均**低优先整洁度**,非架构风险。 - **【B2】删 `api/schema.ts:65-102` overlay 死代码**(零调用,真相在 `editor/overlayApi.ts`);**【B1/B5】**拆 AmisRenderer SDK 注册逻辑、合并 todo.ts/done.ts 503 降级——均**低优先整洁度**,非架构风险。
- **【D2/D3】AI 多入口来源审计**:REST/CLI/MCP 三通道 actor 恒「agent」无区分,加 `X-EIP4-Agent-Channel` 头 + 审计;`runLocalSmoke` 过 `smoke.run` 工具门对齐 `applyLocalRelease`(localhost 硬门已兜底,非可利用洞)。 - **【D2/D3】AI 多入口来源审计**:REST/CLI/MCP 三通道 actor 恒「agent」无区分,加 `X-EIP4-Agent-Channel` 头 + 审计;`runLocalSmoke` 过 `smoke.run` 工具门对齐 `applyLocalRelease`(localhost 硬门已兜底,非可利用洞)。
- **converter 单测 4820 行/164 用例塞 1 文件**(按控件族拆 6-10 个);**cli/mcp 各仅 1 测试文件**(对外 AI 门面加契约/快照测试);**e2e 5 套 config 碎片化**(合并为 1 主 config + projects)。 - **converter 单测 4820 行/164 用例塞 1 文件**(按控件族拆 6-10 个);**cli/mcp 各仅 1 测试文件**(对外 AI 门面加契约/快照测试);**e2e 5 套 config 碎片化**(合并为 1 主 config + projects)。