CraftKit/.craftkit/designs/multi-language-plugin/MULTI-LANGUAGE-PLUGIN-ARCHITECTURE-PLAN.md

reviewStatus, reviewedAt, replacedBy

reviewStatus	reviewedAt	replacedBy
pending	null	null

多语言插件架构改造计划

1. 文档职责

本文只跟踪多语言插件架构的实施批次、前置依赖、验证门禁和完成状态。架构、契约、项目画像及运行机制以《多语言插件架构设计与实施方案》为唯一依据。

详细执行记录位于 .craftkit/local/tasks/multi-language-plugin/，不在本文复制过程步骤。

2. 当前决策

• 首期建立 profile、java 和 python 独立插件骨架，但在安装组合通过前不声明可独立交付。
• Profile 插件维护静态契约、匹配规则和校验器，不扫描插件缓存，也不把 Skill 协作描述为函数调用。
• 消费者从当前会话已发现的提供方 Skill 获取专项能力；提供方缺失时执行通用回退。
• knowledge:init 是项目画像的唯一写入者，guidance 是项目规则与公共规则的合并入口。
• Schema 2 先由消费者双读，再由初始化入口写入。
• 插件安装状态不进入共享项目画像。

3. 实施批次

批次	目标	前置依赖	核心产物	状态
P0	收敛文档并验证平台机制	无	架构决策、最小插件骨架、验证记录	已完成（运行时验证转 P6）
P1	建立 Profile 静态契约	P0	JSON Schema、解析规则、校验器	已完成
P2	建立 Java/Python 最小提供方	P1	双提供方 manifest 和专项资料	已完成静态实现
P3	接入首个核心消费者	P2	design-backend 双语言路由	已完成实现，待新会话验证
P4	建立 Schema 1/2 双读	P3	模块级画像、迁移与回滚规则	已完成实现
P5	逐个接入核心消费者	P4	设计、实现、测试、审查闭环	已完成实现，待新会话验证
P6	验证独立安装和发布	P5	安装矩阵、兼容矩阵、发布材料	部分完成，运行时验证待处理
P7	按需求扩展框架和前端	P6	可独立验证的增量能力	待执行

4. 阶段门禁

每个批次必须分别记录：

1. 实际修改范围。
2. 静态校验结果。
3. 真实或最小可运行场景验证结果。
4. 未验证边界。
5. 停止条件检查。
6. 是否允许进入下一批次。

静态清单或脚本校验通过不代表 Codex 运行时行为已经验证。跨插件发现、Skill 激活和缺失回退必须在安装后的新会话中验证。

5. 总体验收

• Java 与 Python 提供方遵循同一契约。
• 核心 Skill 不复制语言专属工作流。
• Schema 1 和 Schema 2 均可读取。
• 多模块仓库按目标路径解析技术栈。
• 缺少提供方、版本未知和版本不兼容都有确定回退。
• 项目规范覆盖公共 Profile 时保留双方来源。
• Spring Boot 和 FastAPI 完成同一请求的端到端对照。
• 核心、Profile、Java 和 Python 的安装组合全部验证。
• 现有 Java 与通用工作流没有回归。