这套拆解回答什么
Section titled “这套拆解回答什么”| 阅读方向 | 你将理解 |
|---|---|
| Agent 主链 | 一条消息如何落盘、选后端、组 Prompt、跑工具、处理中断并回到 UI |
| 平台架构 | Electron、本地服务、远程服务和 WebUI 如何共享同一协议 |
| 多模型 | Claude 与 Pi 如何共享产品外壳，同时保留原生恢复、分支和压缩语义 |
| 工具与安全 | 权限模式、路径、命令、MCP、OAuth 和凭据如何进入统一安全管道 |
| 工作流 | Tasks、Automations、Browser 与 Messaging 如何复用 SessionManager |
| 工程判断 | 哪些模式值得迁移，哪些大类、协议和存储债务需要优先偿还 |
三条阅读路线
Section titled “三条阅读路线”Agent 工程
Section titled “Agent 工程”00 → 05 → 06 → 07 → 08 → 09 → 10 → 11
抓住 Session Actor、双后端、事件投影、上下文与工具权限的完整主链。
01 → 02 → 03 → 04 → 12 → 14 → 15 → 17
理解一个 Agent 产品如何扩展到多工作区、数据源、远程运行、工作流和外部消息入口。
02 → 03 → 04 → 05 → 09 → 13 → 16 → 18
定位新 RPC、新会话字段、新 provider、新 source 和新 UI 能力应该接入的边界。
- 分析版本：
craft-ai-agents/craft-agents-oss@v0.11.2 - 文档规模：19 章，约 6,700 行
- 分析日期：2026-07-25
- 方法参考：
refs/dg-ai-notes对 Pi 项目的问题驱动式源码拆解
文档中的源码链接固定指向
v0.11.2标签，避免上游后续更新导致行号和实现漂移。