auto-sync: 2026-05-17 13:42:37

docs/design/technical-design-v2.6.md

@@ -355,13 +355,13 @@ sanguo_moziplus_v2/                    # 项目根目录
 
 ## 4. 数据库设计
 
-### 3.1 数据库架构（per-project）
+### 4.1 数据库架构（per-project）
 
 每个项目独立 SQLite 数据库，物理隔离。路径：`projects/{project_id}/blackboard.db`。
 
 全局注册表：`projects/_registry.yaml`（YAML 文件，人可读可 Git 版本管理，紧急运维可直接编辑）。tick 热路径用内存 dict 缓存，_registry.yaml 只在 CLI 操作时读写（非热路径）。
 
-### 3.2 表结构
+### 4.2 表结构
 
 完整 Schema 见 `architecture-v2.6.md §3.2`，此处列出核心表：
 
@@ -377,7 +377,7 @@ sanguo_moziplus_v2/                    # 项目根目录
 | `experiences` | 经验沉淀（含 tags） | 课题6 |
 | `experience_tags` | 经验标签关联表 | 课题6 |
 
-### 3.3 关键约束
+### 4.3 关键约束
 
 - WAL 模式 + `busy_timeout=5000` + `PRAGMA foreign_keys=ON`
 - 所有写操作走 `BEGIN IMMEDIATE` 串行化
@@ -387,7 +387,7 @@ sanguo_moziplus_v2/                    # 项目根目录
 
 ## 5. Daemon 核心架构
 
-### 4.1 Tick 循环（30s）
+### 5.1 Tick 循环（30s）
 
 ```python
 async def tick(project_id: str):
@@ -426,7 +426,7 @@ async def tick(project_id: str):
 - Inbox JSONL 秒级推送加速（Push）
 - Inbox 文件用 truncate（清空不删除），避免并发写入时文件不存在
 
-### 4.2 Agent 调度判据（三级决策树）
+### 5.2 Agent 调度判据（三级决策树）
 
 详见 `topic3-challenge-review-proposal.md §5.4`。
 
@@ -456,7 +456,7 @@ def dispatch(task, action_type, project_config):
 - Full Agent：`asyncio.create_subprocess_exec`（异步非阻塞），不 await 完成，下次 tick 检查产出
 - Subagent：`sessions_spawn`（Gateway API），等返回
 
-### 4.3 线程模型：纯 asyncio 单线程
+### 5.3 线程模型：纯 asyncio 单线程
 
 整个 Daemon 运行在单个 asyncio event loop 中（与 FastAPI 共享）。
 
@@ -480,7 +480,7 @@ async def spawn_full_agent(agent_id: str, message: str, new_session: bool = Fals
 
 **Subagent spawn** 通过 OpenClaw Gateway 内部 API（`sessions_spawn`），天然异步。
 
-### 4.4 ActiveAgentCounter（课题11）
+### 5.4 ActiveAgentCounter（课题11）
 
 纯 asyncio 实现（`asyncio.Semaphore`），与线程模型一致：
     """异步计数器，控制并发"""
@@ -505,7 +505,7 @@ async def spawn_full_agent(agent_id: str, message: str, new_session: bool = Fals
         self._global.release()
 ```
 
-### 4.4 build_bootstrap() 四层上下文拼装
+### 5.5 build_bootstrap() 四层上下文拼装
 
 详见 `topic4-decomposition-skill-proposal.md D4-7`。
 
@@ -529,7 +529,7 @@ L2 按角色精确注入：执行者注入⑤⑥，审查者注入⑥，庞统
 
 ## 6. 审查流水线
 
-### 5.1 分级审查
+### 6.1 分级审查
 
 | 风险等级 | 流水线 | 方案审查 | 产出审查 | 模式 | max_rounds |
 |---------|--------|---------|---------|------|-----------|
@@ -538,7 +538,7 @@ L2 按角色精确注入：执行者注入⑤⑥，审查者注入⑥，庞统
 | **low** | 一阶段 | ❌ | ⚡ Guardrail 自动 | auto | 0 |
 | **research** | 一阶段 | ❌ | ✅ 庞统确认 | single_reviewer | 2 |
 
-### 5.2 Guardrail 执行
+### 6.2 Guardrail 执行
 
 ```yaml
 # config/guardrails.yaml 示例
@@ -566,13 +566,13 @@ task_types:
       required: false  # low 风险，Guardrail 自动
 ```
 
-### 5.3 反驳权流控
+### 6.3 反驳权流控
 
 审查者 verdict=needs_revision（有 critical/major）→ spawn 原执行者反驳 → 协商轮次 ≤ max_rounds → 不设超时，有催促通知 → 超轮次升级庞统。
 
 详见 `topic3-challenge-review-proposal.md §5.3`。
 
-### 5.4 评审详情 Schema
+### 6.4 评审详情 Schema
 
 评审结果写入 `{task_id}/reviews/{review_id}.json`，包含：
 - `issues[]`（status/severity/category/location+context/suggestion）
@@ -586,14 +586,14 @@ task_types:
 
 ## 7. 经验沉淀
 
-### 6.1 两级蒸馏
+### 7.1 两级蒸馏
 
 | 级别 | 触发时机 | 产出 | 存储 |
 |------|---------|------|------|
 | 一级（实时） | 任务完成后 | 经验条目（key findings/lessons/tags） | experiences 表 |
 | 二级（周期） | 同 tag 积累 N 条 | Skill 草稿（draft→active→deprecated） | skills/ 目录 |
 
-### 6.2 经验注入
+### 7.2 经验注入
 
 build_bootstrap() 按 tag 检索 experiences 表，格式化后注入 L2 上下文。
 
@@ -603,7 +603,7 @@ build_bootstrap() 按 tag 检索 experiences 表，格式化后注入 L2 上下
 
 ## 8. Skill 体系
 
-### 7.1 Skill 三层载体
+### 8.1 Skill 三层载体
 
 | 载体 | 自由度 | 生命周期 | 产出者 | 存储 |
 |------|--------|---------|--------|------|
@@ -737,7 +737,7 @@ components:
 
 ## 9. API 设计
 
-### 7.1 黑板 API
+### 9.1 黑板 API
 
 | 方法 | 路径 | 说明 |
 |------|------|------|
@@ -752,7 +752,7 @@ components:
 | POST | `/api/projects/{pid}/tasks/{id}/observations` | 添加观察 |
 | POST | `/api/projects/{pid}/tasks/{id}/reviews` | 提交评审 |
 
-### 7.2 Daemon 控制 API
+### 9.2 Daemon 控制 API
 
 | 方法 | 路径 | 说明 |
 |------|------|------|
@@ -760,7 +760,7 @@ components:
 | GET | `/api/daemon/status` | Daemon 状态 |
 | GET | `/api/daemon/sessions` | 活跃 session |
 
-### 7.3 SSE 推送
+### 9.3 SSE 推送
 
 ```
 GET /api/events?project={pid}
@@ -769,7 +769,7 @@ GET /api/events?project={pid}
   notification（4级：🔴🟡🟢🔵）
 ```
 
-### 7.4 多项目 API
+### 9.4 多项目 API
 
 | 方法 | 路径 | 说明 |
 |------|------|------|
@@ -796,11 +796,11 @@ GET /api/events?project={pid}
 
 ## 11. 前端架构
 
-### 9.1 技术选型
+### 11.1 技术选型
 
 复用 v1.0 前端框架（React + Vite + TypeScript），重设计页面结构。
 
-### 9.2 页面结构（5页）
+### 11.2 页面结构（5页）
 
 | 页面 | 内容 | 来源 |
 |------|------|------|
@@ -810,11 +810,11 @@ GET /api/events?project={pid}
 | **系统配置** | 项目管理、Agent 配置、Guardrail 编辑 | 课题9 |
 | **AI Briefing** | 日报/周报自动生成 | 课题9 |
 
-### 9.3 实时推送
+### 11.3 实时推送
 
 SSE 端点 `/api/events`，前端 EventSource 监听。4 级推送（🔴🟡🟢🔵）。降级：SSE 不可用时 30s 轮询。
 
-### 9.4 构建部署
+### 11.4 构建部署
 
 ```bash
 cd src/frontend && npm run build