4.1 KiB
4.1 KiB
跨 Runtime 适配
CLI 调用（check_deps / log_call / 上游两个 CLI）在所有 runtime 完全一致——它们只依赖 python3 与 sh。差异只在两处：frontend-design 怎么装载、critique 的双 sub-agent 怎么派。
适配矩阵
| Runtime | frontend-design 装载 | critique 双评审 | 备注 |
|---|---|---|---|
| ZCode | Skill 工具（首选）或 Read 原文 | Agent 工具并行派 A/B 两个子代理 | 全功能路径，E2E 验证即在此环境跑 |
| Claude Code | Skill 工具（首选）或 Read 原文 | Task/Agent 工具并行派 A/B | 同上 |
| Codex | Read 原文全文（一等路径） | 有 spawn_agent：按 critique.md 的 Codex 门先问用户一次再派；无则顺序跑 + ⚠️ DEGRADED 横幅 |
上游需先装进 ~/.codex/skills/（见 README）；插画资产可用内建 image_gen（见下节） |
| OpenCode | Read 原文全文（一等路径） | 有 sub-agent 工具就派，无则降级横幅 | 同 Codex 逻辑 |
| MausBot / 其它 | Read 原文全文（一等路径） | 无 sub-agent 则降级横幅 | 限制：见下 |
Codex 的图像生成（image_gen）
Codex 内建 image_gen 工具可直接生成图片，le-app-design 在 Codex 运行时允许用它产出小型插画资产：
- 适用：S4 构建需要的插画类资产——吉祥物/角色形象（手绘 SVG 常见「认不出是什么」的翻车）、场景插图、封面图。prompt 必须携带 design-plan 的色板 hex 与题材世界描述，保证与方向一致；生成后按 craft-floor「Real illustration or none」的插图标准对待。
- 不适用：UI 图标系统仍走 SVG（真图标库或手绘一致描边——icons are drawn，要可缩放可主题化）；需要精确几何的图形（图表、印章、格线）走 SVG。
- 产物落
<项目>/imgs/（或<RUN>/assets/）并进 S7 产物清单；生成图随首屏截图一起在停点 1.5 接受视觉复核（错字/形近字/认不出主体即重生成或退回 SVG）。 - image_gen 是宿主能力不是上游 Skill，不进调用账本；非 Codex runtime 不为此引入依赖——维持 SVG 自绘，宿主另有图像能力（如本机 le-gpt-image）则由用户指示后使用。
「一等路径」的含义：frontend-design 是纯指导型 Skill，官方机制就是把它的 SKILL.md 全文装进执行上下文并照做。Read 原文 + log_call.py --load 记 sha256，与 Skill 工具装载等效且可审计——不是降级。降级只发生在 critique 的双评审（impeccable 自己的定义，见其 critique.md Hard Invariants）。
已知限制（如实告知用户，不静默吞掉）
- impeccable detect 只读 web markup（HTML/JSX 等）。原生 Swift/Kotlin 源码扫不出东西——纯原生方案 critique 走 Assessment A 单评审（这是上游定义的完整方法，非降级）。本 Skill 交付形态固定为 Web 高保真原型，不受影响。
- impeccable 二进制按平台分发（本机 darwin-arm64 已带）。换机器跑 check_deps 会立刻发现缺
scripts/impeccable或其 bin/ 子目录——按报告里的安装指引处理；上游 README 说明二进制会在首跑时按平台下载。 - 截图依赖本机 Chrome。找不到时 S4/S5 的截图核对降级为 craft-floor 逐条人工核对 + 在 INTEGRATION-REPORT 的 Run Notes 声明，不静默跳过。
- Windows：impeccable 用
scripts/impeccable.cmd，python3 可能叫python——check_deps/liveness 若失败按报告指引调整；其余逻辑不变。 - 上游版本漂移：check_deps 记录的是路径 + 活性，不锁版本。上游大版本更新导致 playbook 接口变化时（如 critique.md 的命令名变了），S5 会暴露失败——按失败模式处理并报告，不猜测新接口。
路径解析优先级（check_deps 的顺序）
$LE_APP_DESIGN_DEP_ROOTS（冒号分隔，自定义安装位）→ ~/.agents/skills（首选默认，与 impeccable SKILL.md 自引用路径一致）→ ~/.zcode/skills → ~/.codex/skills → ~/.claude/skills。
同一机器多份副本时取优先级最高的一份并在 deps.json 记录实际路径；S2/S5 的命令一律用该路径，不硬编码。