diff --git a/docs/design/architecture-v2.6.md b/docs/design/architecture-v2.6.md index b2e848b..d2ec752 100644 --- a/docs/design/architecture-v2.6.md +++ b/docs/design/architecture-v2.6.md @@ -450,6 +450,24 @@ def add_comment(task_id: str, author: str, body: str, mentions: list = None): 不需要复杂的分布式共识--职责分工已经自然避免了大部分冲突。 +### 3.7 黑板是索引不是仓库 + +**核心原则:黑板只存元数据 + 摘要 + 文件路径,不存大段文本内容。** + +设计推导(课题 2): +- Network-AI 的核心洞察:Agent 只读黑板摘要,详细数据在文件中 +- Claude Code 的 file reference 模式:不内联,只引用 +- 一个典型任务全量黑板信息 ~1100-1750 tokens,极端 ~4000 tokens——远小于 128K context +- 问题不是空间不够,而是**信号噪声比**:全量注入让 Agent 在无关信息上浪费注意力 + +落地到 schema: +- `outputs` 表:`content_path` + `summary`,不存文件内容 +- `comments` 表:`body` 可能较长(Agent 分析报告),但评论本身是 Agent 输出的一部分 +- `decisions` 表:`decision` + `rationale` 是结构化文本,通常较短 +- `observations` 表:`body` 是简短风险描述,通常 <100 字 + +Agent 获取信息的分层策略(L1/L2/L3)详见 §4.4。 + --- ## 4. Daemon(管家)设计