Agent Harness 从入门到精通 / A02
附录 B · 全网精华索引
本系列全部一手材料，共 80+ 条，按来源类型分组，逐条可点开核对。 等级定义见 README 第 1 节。 本文件不收录未经核实的 URL。 未能定位一手地址的材料集中列在最后「待核实线索」。
1 · 基线原文
| 材料 | URL | 等级 | 价值 |
|---|---|---|---|
| 枪手AI《DeepSeek Harness 最新高阶指南（2026年11月）》，2026-11-05 | https://mp.weixin.qq.com/s/rsfp0Kie5xlDOKDsE3Fqvw | 原文 | 本系列的起点：四模式、五场景、插件、PTC、跑分、子 Agent、定时任务、五分钟体检 |
| 腾讯云开发者《为什么AI干得总是差点意思？教你怎么把需求一次说清楚》（袁俊晓，2026-11-06） | https://cloud.tencent.com.cn/developer/ | 社区 | 本系列「证据分级 / 不编造出处」的纪律来源 |
原文没有文末参考链接清单，全文唯一完整 URL 是示例占位
https://xxx.com。因此原文中的官方说法、DataCamp 引用、鱼皮实测、官方事故复盘 0001 等，本系列一律标为转引，并尽可能补上一手地址；补不到的列入第 9 节。
2 · DeepSeek 官方
2.1 官网与仓库
| 材料 | URL | 等级 |
|---|---|---|
| 官网中文（公式、一切皆插件、四模式、Trajectory） | https://www.deepseek.com/harness/zh/ | 官方 |
| 官网英文（保留 Code mode 措辞） | https://deepseek.com/harness/en/ | 官方 |
| GitHub 仓库（MIT，developer preview） | https://github.com/deepseek-ai/deepseek-harness | 官方 |
| README.zh.md | https://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md | 官方 |
SAFETY.md（运行前必读） |
https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md | 官方 |
SAFETY.zh.md |
https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.zh.md | 官方 |
AGENTS.md（仓库自带，可读作真实范例） |
https://github.com/deepseek-ai/deepseek-harness/blob/master/AGENTS.md | 官方 |
CLAUDE.md |
https://github.com/deepseek-ai/deepseek-harness/blob/master/CLAUDE.md | 官方 |
CONTRIBUTING.md |
https://github.com/deepseek-ai/deepseek-harness/blob/master/CONTRIBUTING.md | 官方 |
BENCHMARK.md |
https://github.com/deepseek-ai/deepseek-harness/blob/master/BENCHMARK.md | 官方 |
docs/architecture.md（本系列引用最多的官方文档） |
https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md | 官方 |
docs/development.md |
https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/development.md | 官方 |
docs/user/guide/index.md |
https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md | 官方 |
docs/ 目录 |
https://github.com/deepseek-ai/deepseek-harness/tree/master/docs | 官方 |
| GitHub Discussions（反馈 / bug） | https://github.com/deepseek-ai/deepseek-harness/discussions | 官方 |
dsh-plugin topic（插件发现） |
https://github.com/topics/dsh-plugin | 官方 |
| Discord 社区 | https://discord.gg/4MrtZUhpxg | 官方 |
| DeepSeek 开放平台（API key） | https://platform.deepseek.com/ | 官方 |
| DeepSeek API 文档 | https://api-docs.deepseek.com/ | 官方 |
2.2 官方文档站
| 材料 | URL | 等级 |
|---|---|---|
| 文档站首页 | https://deepseek-harness.github.io/deepseek-harness/ | 官方 |
llms.txt（中英各 95 页全量索引，附 raw Markdown 规则） |
https://deepseek-harness.github.io/deepseek-harness/llms.txt | 官方 |
| 使用 Web UI / 配置模型 / 网络代理 / 公开部署 | https://deepseek-harness.github.io/deepseek-harness/guide/quickstart | 官方 |
| Python SDK | https://deepseek-harness.github.io/deepseek-harness/guide/python-sdk | 官方 |
| 会话内提醒 | https://deepseek-harness.github.io/deepseek-harness/guide/schedule | 官方 |
| 记忆 MCP | https://deepseek-harness.github.io/deepseek-harness/guide/mcp-memory | 官方 |
| 插件市场 | https://deepseek-harness.github.io/deepseek-harness/guide/plugin-market | 官方 |
| GitHub 评审会话 | https://deepseek-harness.github.io/deepseek-harness/guide/github-review | 官方 |
| 第一个 Harness 插件 / Tool / 配置 / 打包 | https://deepseek-harness.github.io/deepseek-harness/develop/basic/ | 官方 |
| 插件与生命周期 / 服务与依赖 / 事件系统 | https://deepseek-harness.github.io/deepseek-harness/develop/framework/ | 官方 |
| 能力三层拆分 / LLM 适配器 / 持久化插件 | https://deepseek-harness.github.io/deepseek-harness/develop/practice/ | 官方 |
| Cordis 框架教程（7 讲） | https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/ | 官方 |
| 组合与热重载（第 06 讲） | https://deepseek-harness.github.io/deepseek-harness/develop/cordis-tutorial/06-composition-and-hmr | 官方 |
| 架构 / Cordis 入门 / 能力服务 / Agent 生命周期 | https://deepseek-harness.github.io/deepseek-harness/reference/ | 官方 |
| Tool 执行流水线 | https://deepseek-harness.github.io/deepseek-harness/reference/tool-execution-pipeline | 官方 |
| 插件配置 / Tool Schema / 持久化事件目录 | https://deepseek-harness.github.io/deepseek-harness/reference/config-catalog | 官方 |
| Cordis Core API（Context / Events / Fiber / Registry / Service） | https://deepseek-harness.github.io/deepseek-harness/reference/cordis-api/context | 官方 |
| Extension Cookbook | https://deepseek-harness.github.io/deepseek-harness/reference/cookbook/extension-cookbook | 官方 |
| 子系统总览（约 46 个 subsystem 页） | https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/ | 官方 |
| PTC 运行时 | https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/ptc-runtime | 官方 |
| 上下文压缩 | https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/compaction | 官方 |
| 审批 / 权限预设 / 沙箱 | https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/approval | 官方 |
| 会话遥测 / Token 计量 | https://deepseek-harness.github.io/deepseek-harness/reference/subsystems/session-telemetry | 官方 |
取 raw Markdown 的规则（llms.txt 原文）：页面 URL 去掉末尾斜杠再加
.md，根路径为/index.md；英文版路径含/en/。
3 · Cordis 与论文
| 材料 | URL | 等级 | 价值 |
|---|---|---|---|
| A Programming Paradigm for Spatiotemporal Composability, arXiv:2608.25512（2026-08-26，92 页，北大 + DeepSeek-AI） | https://arxiv.org/abs/2608.25512 | 论文 | temporal / spatial composability、revertible effects、reactive coeffects、context paradigm |
| 论文 PDF | https://arxiv.org/pdf/2608.25512 | 论文 | 全文 |
| 论文配套仓库 | https://github.com/cordiverse/paper | 论文 | 演算与元理论 |
| Cordis 仓库（API 未稳定） | https://github.com/cordiverse/cordis | 官方 | 元框架实现 |
| 官方 Cordis 入门 | https://deepseek-harness.github.io/deepseek-harness/reference/cordis-primer | 官方 | 概念教材 |
4 · Harness Engineering 一手文章
| 材料 | 作者 / 日期 | URL | 等级 | 本系列用到 |
|---|---|---|---|---|
| My AI Adoption Journey（Step 5: Engineer the Harness） | Mitchell Hashimoto, 2026-02-05 | https://mitchellh.com/writing/my-ai-adoption-journey | 社区 | 原始定义、两种形式、Ghostty inspector 12 行实例 |
| Harness engineering: leveraging Codex in an agent-first world | Ryan Lopopolo, OpenAI, 2026-02-11 | https://openai.com/index/harness-engineering/ | 官方 | 0 手写代码 / 100 万行 / 1500 PR / environment underspecified / golden principles / Ralph Wiggum Loop |
| The Anatomy of an Agent Harness | Vivek Trivedy, LangChain, 2026-03-10 | https://www.langchain.com/blog/the-anatomy-of-an-agent-harness | 社区 | Agent = Model + Harness、Terminal Bench 2.0 top30→top5 |
| Harness engineering for coding agent users | Birgitta Böckeler, martinfowler.com, 2026-04-02 | https://martinfowler.com/articles/harness-engineering.html | 社区 | Guides / Sensors 四象限、inner / outer harness |
| Agent Harness Engineering | Addy Osmani, 2026-04-19 | https://addyosmani.com/blog/agent-harness-engineering/ | 社区 | 每行可追溯到失败、success is silent |
| Writing good agent files | Philipp Schmid, 2026-02-24 | https://www.philschmid.de/writing-good-agents | 社区 | under 300 lines、pointers over copies |
| How to write a great agents.md: lessons from over 2,500 repositories | Matt Nigh, GitHub Blog, 2025-11-19 | https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories | 社区 | 文件靠迭代长出来 |
| Effective harnesses for long-running agents | Anthropic, 2025-11-26 | https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents | 社区 | initializer agent / progress file / feature list |
| Harness Engineering: Anatomy, Architecture, and Evolution of Coding Agents | Barbaste 等, arXiv:2609.00006, 2026-07-15 | https://arxiv.org/abs/2609.00006 | 论文 | 11 agents / 400 万行 / 29 patterns / Skills 9/11、MCP 8/11 |
| Wikipedia, Agent harness | 最后编辑 2026-10-10 | https://en.wikipedia.org/wiki/Agent_harness | 社区 | 术语沿革 |
5 · 其他厂商官方文档
| 材料 | URL | 等级 | 本系列用到 |
|---|---|---|---|
| Claude Agent SDK · Hooks（完整事件表） | https://code.claude.com/docs/en/agent-sdk/hooks | 官方 | 第 08 章事件表、PreToolUse exit 2 |
| Claude Code · 自定义子 Agent | https://code.claude.com/docs/en/sub-agents | 官方 | 子 Agent hooks、deny 规则 |
| Claude Code · Permissions | https://code.claude.com/docs/en/permissions | 官方 | 权限与沙箱互补、Deny 优先 |
| Claude Code · Sandboxing | https://code.claude.com/docs/en/sandboxing | 官方 | Seatbelt / bubblewrap、allowWrite / allowedDomains / credential mask |
| Claude Code · Memory | https://code.claude.com/docs/en/memory | 官方 | 项目记忆 |
| Claude Code · Skills | https://code.claude.com/docs/en/skills | 官方 | 按需加载 |
| Claude Code · CLI Reference | https://code.claude.com/docs/en/cli-reference | 官方 | headless 控制参数 |
| Claude Code · Authentication / Costs | https://code.claude.com/docs/en/authentication | 官方 | 无人值守鉴权与预算 |
@anthropic-ai/sandbox-runtime |
https://www.npmjs.com/package/@anthropic-ai/sandbox-runtime | 官方 | 开源沙箱运行时 |
| Anthropic 官方建议快照（第三方整理，2026-07-26） | https://github.com/EpiAware/EpiAwareAgents/blob/main/docs/reference/claude-code-recommendations.md | 社区 | 官方推荐布局汇总 |
| Databricks, What is an AI Agent Harness? | https://www.databricks.com/blog/ai-harness | 社区 | 八个 building blocks |
| InfoQ · Microsoft Agent Framework Harness GA, 2026-08-03 | https://www.infoq.com/news/2026/08/agent-framework-harness-ga/ | 社区 | tool approval / OTel |
| OWASP GenAI · LLM Top 10 | https://genai.owasp.org/llm-top-10/ | 社区 | 威胁模型基线 |
Claude Code 文档站部分页面若出现 404，试在路径末尾加
.md（官方快照中使用该形式）。
6 · 社区指南与案例
| 材料 | URL | 等级 | 本系列用到 |
|---|---|---|---|
| Heym, Harness Engineering: From AGENTS.md to Production | https://heym.run/blog/harness-engineering | 社区 | 六要素、七层、AGENTS.md 六个月增长数据、生产 checklist |
Heym 公开仓库 AGENTS.md |
https://github.com/heymrun/heym/blob/main/AGENTS.md | 社区 | 真实 ratchet 样本 |
| Heym · node placement coverage test | https://github.com/heymrun/heym/blob/main/backend/tests/test_cluster_node_placement.py | 社区 | coverage test 范式 |
| Heym 文档 · Guardrails / HITL / Alerts / Audit / OTel | https://heym.run/docs/reference/guardrails | 社区 | 生产参数 |
| AI Workflow Pro, Harness Engineering: The Complete Guide | https://aiworkflowpro.com/harness-engineering-guide/ | 社区 | 四层递进、三步起步循环、harness 应变轻 |
| amux, The Complete Guide (2026) | https://amux.io/guides/harness-engineering | 社区 | 1→10 Agent 对照、hook 示例、规模案例 |
| codeongrass, The Outer Harness | https://codeongrass.com/blog/outer-harness-real-work-ai-coding-agents | 社区 | Stop hook、self-verification、worktree |
| agents-cli.sh, Harness engineering | https://agents-cli.sh/learn/harness-engineering | 社区 | 术语溯源、七 surfaces |
| ArceApps, The Wrapper Wins | https://arceapps.com/blog/harness-engineering-wrapper-gana | 社区 | 术语时间线、三个时代 |
| 码森林, 生产级 Harness 三级递进 | https://www.masenlin.com/archives/harness-engineering-cai-shi-ai-bian-cheng-de-zhong-ji-sha-qi | 社区 | Level 1/2/3、过度设计控制流的坑 |
| 万象云档《DSH 指南》 | https://www.wanxiangyundang.top/read/dsh-guide/what-is | 社区 | 第三方结构化解读 |
| YES 开发框架网 · DSH 集成指南 | https://www.yesdotnet.com/archive/post/863977790582853.html | 社区 | 官网/仓库/文档站/Cordis 链接汇总 |
| 编程知识网 · DSH 发布背景 | http://www.hqwc.cn/news/1123027.html | 社区 | 发布时间与 Cordis 双可组合性说明（二手） |
| FDE-Wiki（本系列拟挂载站点） | https://fde-wiki.github.io/ | 社区 | 编排参照 |
| FDE-Wiki GitHub 仓库 | https://github.com/zhyese/fde-wiki/ | 官方 | VitePress 结构与 split 脚本 |
| 腾讯云《FDE工程师-从AI技术实现到业务落地》专栏 | https://cloud.tencent.com.cn/developer/column/108515 | 社区 | 分篇编号、路线图、参考来源折叠的样式参照 |
| 该专栏第 20 篇（最终篇） | https://cloud.tencent.com.cn/developer/article/2727243 | 社区 | 90 天路线图与「核心产出」写法 |
| 觉醒学院《FDE前线部署工程师入门到精通》 | https://www.jxxy.net/ai/paths/fde | 社区 | 另一种「入门到精通」编排参照 |
7 · 学术论文与前沿（自动 Harness 优化）
以下条目来自 arXiv:2610.05039 的参考文献列表，属文献引用级线索；本教程未逐篇阅读全文，标题与编号供延伸检索，不作为本系列论断依据。
| 主题 | arXiv |
|---|---|
| Causal Improvement Graph for Agentic Harness Optimization | https://arxiv.org/abs/2610.05039 |
| Meta-Harness: End-to-end optimization of model harnesses | https://arxiv.org/abs/2603.28052 |
| Agentic harness engineering: Observability-driven automatic evolution | https://arxiv.org/abs/2604.25850 |
| AutoHarness: Improving LLM agents by automatically synthesizing a code harness | https://arxiv.org/abs/2603.03329 |
| AutoDesign: Meta-harness optimization for long-horizon agentic design | https://arxiv.org/abs/2608.13560 |
| AutoSaddler: Automatic harness optimization with durable updates from traces | https://arxiv.org/abs/2608.23041 |
| Code as agent harness | https://arxiv.org/abs/2605.18747 |
| Terminal-Bench: Benchmarking agents on hard, realistic tasks in CLI | https://arxiv.org/abs/2601.11868 |
| Scaffolded LLMs as Natural Language Computers（Beren Millidge, 2023） | 按标题检索，本教程未定位到稳定一手 URL |
这一组指向本系列的下一站：Harness 本身也可以被自动优化。但它建立在第 15 章的可复现评测之上——没有固定变量的实验，自动优化只会放大噪声。
8 · FDE-Wiki 内反向链接目标
| 页面 | 建议关联本系列 |
|---|---|
| https://fde-wiki.github.io/ch09 | 第 01–04 章（工程化技术栈展开） |
| https://fde-wiki.github.io/ch22 | 第 17 章（合规、安全、数据治理） |
| https://fde-wiki.github.io/topic02 | 第 14 章（Agent 编排六种拓扑） |
| https://fde-wiki.github.io/topic03 | 第 15 章（评估驱动开发） |
| https://fde-wiki.github.io/topic20 | 第 16、18 章（可观测性与 SRE） |
| https://fde-wiki.github.io/topic25 | 附录 B（工具链生态全景） |
| https://fde-wiki.github.io/topic30 | 第 15、17 章（评估、测试与红队） |
| https://fde-wiki.github.io/topic42 | 附录 C、D（现场工具箱） |
| https://fde-wiki.github.io/topic54 | 第 18 章（容量规划与成本建模） |
| https://fde-wiki.github.io/appendix | 附录 B 工具与框架清单 |
具体插入位置与可粘贴片段见 INTEGRATION.md。
9 · 待核实线索（诚实清单）
以下材料在原文或二手文章中被提及，但本教程未定位到可核验的一手 URL，因此只作线索、不作依据：
| 线索 | 状态 |
|---|---|
官方事故复盘 0001（「不要多写 export default」） |
原文提及，未定位到仓库内文档路径 |
| DataCamp 关于 "benchmark score partly reflects the harness" 的文章 | 原文转引，未定位到具体文章 URL |
| DeepSeek V4 Pro 官方跑分图（称使用极简模式为框架） | 原文转述，未定位到官方公告 |
| 程序员鱼皮关于 4 个派活工具的选择建议 | 原文引用，未定位到原帖 |
dsh-automation / dsh-agent-teams 插件仓库 |
原文给出安装命令 @nanmicoder/dsh-agent-teams@latest，未核验 npm 包与仓库 |
| Stripe「Minions」1300 PR/周 | amux 转述，未定位到 Stripe 一手公告 |
| 原文 3D 射击游戏实测（33/23/26 分钟、520万/150万 token） | 未独立复现，本系列标 实测 |
| 原文「标准模式『你好』约 1 万+ token / 极简约 1 千+」 | 未独立复现 |
若你要把这些内容写进对外发布版，请先逐条补一手链接或删除。本系列宁可标「未复核」，也不给一个看起来很像的答案。
本系列为本站原创教程，基线为微信公众号《DeepSeek Harness 最新高阶指南》（2026-11-05），并汇总 DeepSeek 官方仓库与文档站、Cordis / arXiv:2608.25512、以及 OpenAI / Anthropic / LangChain / Martin Fowler 等一手资料。每条引用均标证据等级，完整清单见 附录 B；未定位到一手来源的线索单列，未编造补位。DeepSeek Harness 为 developer preview，官方 SAFETY.md 明确「未经过安全审计、不得视为生产就绪」，命令与配置键可能随版本失效。资料截止 2026-11-06。姊妹篇：《FDE 入门到精通》。