auto-sync: 2026-05-15 12:30:33

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(管家)设计