baa-conductor

README.md

 1# BAA 指令系统设计方案 v5（语法兼容 v3）
 2
 3日期：2026-03-27
 4
 5这是在上一版 v4 的基础上，进一步把 **结果产物管理收口到 conductor** 后的完整版。
 6
 7## 这版最关键的变更
 8
 91. **插件降级成纯传输层 / 文件传输层**
10   - 插件只负责：
11     - 页面桥接
12     - 最终消息观察
13     - 上传文件
14     - 下载文件
15     - 注入文本 / 点击发送
16   - 插件不负责：
17     - baa 提取
18     - 指令解析
19     - 去重
20     - 结果总结
21     - 大结果提取
22     - artifact 打包
23     - manifest 生成
24
252. **conductor 成为唯一的结果产物管理中心**
26   - conductor 统一负责：
27     - 解析 / 标准化 / 路由 / 权限 / 审计
28     - 执行结果总结
29     - 大结果转 artifact
30     - manifest / 索引文本生成
31     - delivery plan 生成
32     - 上传确认后的最终注入文本
33
343. **结果交付升级为 `artifact + index + manifest + ack`**
35   - 小结果：直接文本
36   - 中 / 大结果：artifact 上传 + 文本索引
37   - 多结果并行：manifest 汇总
38   - 上传成功后才发送索引文本
39
40## 这个包里有什么
41
42- `docs/00-executive-summary.md`：执行摘要
43- `docs/01-design-principles.md`：原则与边界
44- `docs/02-protocol-spec.md`：协议规范
45- `docs/03-routing-capability-borrowing.md`：路由与能力借用
46- `docs/04-execution-loop-state-machine.md`：状态机
47- `docs/05-auth-governance-and-safety.md`：权限与治理
48- `docs/06-integration-with-current-baa-conductor.md`：与当前 repo 的对接方式
49- `docs/07-rollout-plan.md`：渐进式落地阶段
50- `docs/08-examples.md`：直接可用示例
51- `docs/09-artifact-delivery-thin-plugin.md`：结果交付与薄插件专项说明
52- `contracts/`：类型与伪代码
53- `schemas/`：JSON schema
54- `prompts/`：提示词模板
55- `reference/`：原始 v3 文档与本版变更说明
56
57## 一句话结论
58
59> **v3 解决“怎么输出可执行指令”，v4 解决“怎么稳定执行”，v5 解决“怎么让插件变薄、让 conductor 成为真正的中控与产物管理中心”。**