auto-sync: 2026-06-06 08:31:19

docs/design/13-toolchain-and-dev-workflow.md

@@ -1,6 +1,6 @@
 # 三国团队工具链与开发流程设计
 
-> **状态**: v0.6 — 主公审阅后三次修订，隔离边界明确
+> **状态**: v1.0 — 司马懿终审通过，共识达成，可定稿
 > **作者**: 庞统（副军师）🐦
 > **评审**: 司马懿（仲达）🗡️
 > **日期**: 2026-06-06
@@ -473,8 +473,8 @@ CI 临时测试环境（每次 CI 自动创建）
 
 | 层面 | 隔离方式 | 说明 |
 |------|---------|------|
-| **程序逻辑**（FastAPI + Daemon + SQLite） | ✅ 完全隔离 | 独立 venv + 临时数据库 + 临时端口 |
-| **Agent spawn**（openclaw agent） | ❌ 走生产 openclaw | openclaw 是全局单例，无法隔离 |
+| **程序逻辑**（FastAPI + Daemon + SQLite） | ✅ 完全隔离 | 独立 venv + 临时数据库 + 临时端口 | — |
+| **Agent spawn**（openclaw agent） | ❌ 走生产 openclaw | openclaw 是全局单例，无法隔离 | 测试 case 用 UUID 前缀标识 + Agent 回写地址指向 8084 临时端口 |
 
 Agent spawn 走生产 openclaw 的决策理由：
 1. openclaw 是全局单例（`~/.openclaw/` 只有一份），Agent 配置和 workspace 全局共享
@@ -486,13 +486,15 @@ Agent spawn 走生产 openclaw 的决策理由：
 
 当前代码有 6 处硬编码绝对路径，需改为环境变量可配置（P1 必须完成）：
 
-| 位置 | 硬编码路径 | 改法 | 现状 |
-|------|-----------|------|------|
-| `utils.py` | 数据根目录 | `BLACKBOARD_ROOT` 环境变量 | ✅ 已支持 |
-| `bootstrap.py:42` | Skill 加载路径 | `MOZI_SKILL_PATH` 环境变量 | ✅ 已支持 |
-| `registry.py:264` | 项目扫描目录 `~/.openclaw/sanguo_projects` | 加 `SANGUO_PROJECTS_DIR` | ❌ 硬编码 |
-| `spawner.py:1177,1261` | `~/.openclaw/agents/<id>/sessions.json` | 加 `OPENCLAW_HOME` | ❌ 硬编码 |
-| `blackboard_routes.py:161` | `~/.openclaw/openclaw.json` | 从 `OPENCLAW_HOME` 读 | ❌ 硬编码 |
+| 位置 | 硬编码路径 | 改法 | 现状 | 行数 |
+|------|-----------|------|------|------|
+| `utils.py` | 数据根目录 | `BLACKBOARD_ROOT` 环境变量 | ✅ 已支持 | 1 |
+| `bootstrap.py:42` | Skill 加载路径 | `MOZI_SKILL_PATH` 环境变量 | ✅ 已支持 | 1 |
+| `registry.py:264` | 项目扫描目录 `~/.openclaw/sanguo_projects` | 加 `SANGUO_PROJECTS_DIR` | ❌ 硬编码 | 1 |
+| `spawner.py:1177,1261` | `~/.openclaw/agents/<id>/sessions.json` | 加 `OPENCLAW_HOME` | ❌ 硬编码 | 2 |
+| `blackboard_routes.py:161` | `~/.openclaw/openclaw.json` | 从 `OPENCLAW_HOME` 读 | ❌ 硬编码 | 1 |
+
+共计 6 处（2 已支持、4 待修）。
 
 #### 环境总结
 
@@ -694,6 +696,12 @@ Agent spawn 走生产 openclaw 的决策理由：
 | H1 | Agent spawn 走生产 openclaw，不隔离 | §8.5 新增隔离边界表：程序逻辑隔离 vs Agent 走生产 |
 | H2 | 路径硬编码问题 | §8.5 新增路径硬编码修复清单（6 处，2 处已支持、4 处待修） |
 
+### v0.6 → v1.0 定稿（司马懿终审通过）
+
+- 隔离边界表增加"缓解措施"列（仲达建议）
+- 路径硬编码清单增加"行数"列（仲达建议）
+- 状态标记为 v1.0 定稿
+
 ---
 
 ## §13. 项目维度组织