跳转至

Super-agent 设计参照

本目录与 architecture.md 所代表的 DeepSeek Harness 内核复现（A 线）并行：此处整理 Super-agent 论文与 dsh-superagent-prototype 的设计抽象、候选原则与忠实译文，默认对 mini 开发无约束力。

双轨关系

轨道 权威来源 mini 中的位置 默认是否约束实现
A 线 deepseek-harness/ 包与 wire 章节、映射表、测试 是
B 线 论文 + superagent 旁路仓库 本目录 否（见 adopted.md）

A 线回答「与上游约定是否一致」；B 线回答「若团队显式采纳某条设计原则，产品/编排/体验向何处倾斜」。二者冲突时以 A 线为准。

三源关系

flowchart TB
  Paper["论文 / 知乎专栏"]
  Proto["dsh-superagent-prototype"]
  DSH["deepseek-harness A线"]
  Bdocs["本目录"]
  Paper --> Bdocs
  Proto --> Bdocs
  DSH --> MiniImpl["mini 代码与 wire"]
  Bdocs -.->|"仅 adopted 登记后"| MiniImpl

论文描述的目标架构 宽于 公开 prototype；prototype README 声明与论文及内版不完全一致。出处见 sources.md。

阅读顺序

  1. 设计抽象（主文） — 流程与架构图、对照表、与 mini 边界；产品级抽象单一事实源
  2. 源码走读（source_implement） — 旁路 src/ 代码行为解读真源：container → lifecycle/ 1–7 → side-paths → 按需 reference-semantics / sidechain
  3. 出处与治理 — 原文链接、旁路上游 commit、译文粒度说明、走读维护、00-governance.md 采纳规则
  4. 候选原则总表 与 adopted.md — 全部 SA-*；生效 subset 仅见 adopted
  5. 延伸阅读（译文） — 需要逐句核对英文时打开论文卷 / Prototype 卷；页首指向主文对应节，不在延伸页重复维护解读
卷 入口
论文 01 动机与四特征 → … → 06
Prototype 000 哲学 → … → 007 架构 → 008 Cookbook

与 A 线文档的链接