diff --git a/docs/design/technical-design-v2.6.md b/docs/design/technical-design-v2.6.md index 182afac..9f5ce56 100644 --- a/docs/design/technical-design-v2.6.md +++ b/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