说明
- 本页汇总了本专题用到的主要一手资料：官方文档、源码仓库、官方博客。各篇笔记的脚注里有更精确的出处。
- 源码链接一律使用固定 commit 的永久链接。即使日后仓库更新，也能看到笔者写作时所依据的那个版本。
- 第三方资料（媒体报道、评测文章）在正文里都单独标注了“二手资料”。
1. 源码快照（2026-10-08 至 10-09 克隆）#
| 仓库 | commit | 提交日期 | 对应版本 |
|---|---|---|---|
| openai/openai-agents-python | 26345c1 | 2026-10-08 | openai-agents 0.23.1 |
| openai/openai-python | 9301e31 | 2026-10-08 | openai 3.26.1 |
| anthropics/anthropic-sdk-python | 50b78d1 | 2026-10-08 | anthropic 1.12.1 |
| anthropics/claude-agent-sdk-python | f7b0b62 | 2026-10-07 | claude-agent-sdk 0.2.164 |
| anthropics/claude-agent-sdk-typescript | 799dc78 | 2026-10-08 | @anthropic-ai/claude-agent-sdk 0.3.293（npm） |
| earendil-works/pi（原名 badlogic/pi-mono） | 6fb2e78 | 2026-10-08 | @earendil-works/pi-* 1.1.0 |
| deepseek-ai/deepseek-harness | 5badb15 | 2026-10-03 | 仓库根包 0.2.1-alpha.1；npm 上 @deepseek-ai/dsh 的 latest 为 0.2.0-rc.2 |
2. 官方文档入口#
OpenAI#
- 文档索引（每个页面都可以在 URL 末尾加
.md获取 Markdown 版本）：https://developers.openai.com/api/docs/llms.txt - Agents（三种运行时的对比）：https://developers.openai.com/api/docs/guides/agents
- Migrate to the Responses API：https://developers.openai.com/api/docs/guides/migrate-to-responses
- Function calling：https://developers.openai.com/api/docs/guides/function-calling
- Conversation state：https://developers.openai.com/api/docs/guides/conversation-state
- Using tools：https://developers.openai.com/api/docs/guides/tools
- Streaming API responses：https://developers.openai.com/api/docs/guides/streaming-responses
- Agents API：https://developers.openai.com/api/docs/guides/agents-api/overview
- Assistants migration guide：https://developers.openai.com/api/docs/assistants/migration
- Using GPT-6：https://developers.openai.com/api/docs/guides/latest-model
- Agents SDK 文档站（含中文版）：https://openai.github.io/openai-agents-python/ ，中文版位于 https://openai.github.io/openai-agents-python/zh/
Anthropic / Claude#
- 文档索引：https://platform.claude.com/llms.txt ；Claude Code 与 Agent SDK 的文档索引：https://code.claude.com/docs/llms.txt
- Models overview：https://platform.claude.com/docs/en/about-claude/models/overview
- Tool use：https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview
- Tool Runner (SDK)：https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner
- Streaming Messages：https://platform.claude.com/docs/en/build-with-claude/streaming
- Adaptive thinking：https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking
- Prompt caching：https://platform.claude.com/docs/en/build-with-claude/prompt-caching
- Refusals and fallback：https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback
- Agent SDK overview：https://code.claude.com/docs/en/agent-sdk/overview
- How the agent loop works：https://code.claude.com/docs/en/agent-sdk/agent-loop
- Claude Managed Agents overview：https://platform.claude.com/docs/en/managed-agents/overview
- Release notes：https://platform.claude.com/docs/en/release-notes/overview
pi#
- 官网与文档：https://pi.dev ，文档位于 https://pi.dev/docs/latest
- 各包 README 与 docs 见上表中的源码快照
DeepSeek Harness#
- 官方文档站：https://deepseek-harness.github.io/deepseek-harness/
- 仓库内的中文文档：
docs/*.zh.md，包括架构、Cordis 入门、Cordis 教程、cookbook、术语表
3. 官方博客与论文#
| 资料 | 日期 | 用于 |
|---|---|---|
| OpenAI，New tools for building agents | 2025-03-11 | Responses API 与 Agents SDK 的发布 |
| OpenAI，Introducing AgentKit | 2025-10-06 | Agent Builder、ChatKit |
| OpenAI Developer Community，Assistants API beta deprecation | 2025-08-26 | Assistants 下线公告 |
| Anthropic，Introducing the Model Context Protocol | 2024-11-25 | MCP |
| Anthropic Engineering，Building Effective AI Agents | 2024-12-19 | 选型原则：先找最简单的方案 |
| Anthropic Engineering，Building agents with the Claude Agent SDK | 2025-09-29 | Claude Code SDK 更名为 Claude Agent SDK |
| Mario Zechner，What I learned building an opinionated and minimal coding agent | 2025-11-30 | pi 的设计哲学 |
| Mario Zechner，I've sold out | 2026-04-08 | pi 加入 Earendil |
| Shi, Zhang, Cui，A Programming Paradigm for Spatiotemporal Composability | 2026-08-26 | Cordis 的理论基础 |
4. 第三方资料（二手，仅作参考）#
| 资料 | 用于 |
|---|---|
| developersdigest.tech，DeepSeek Harness (dsh) first look | DSH 发布初期的观察：许可证变更、代码规模等 |
| 36氪的报道 | Cordis 与 Koishi、Shigma 的渊源 |
| pi.dev，pi2dsh | 社区维护的 pi 到 DSH 桥接 |
| TechCrunch 的相关报道 | OpenAI 发布节点的交叉验证 |
5. 代码校验环境#
本专题中的代码和图示按以下方式校验，没有使用任何 API Key：
| 对象 | 工具 | 依赖版本 | 结果 |
|---|---|---|---|
| Python 代码 | pyright 1.1.414，Python 3.14 | openai 3.26.1、openai-agents 0.23.1、anthropic 1.12.1、claude-agent-sdk 0.2.164、deepseek-harness-sdk 0.1.5rc1 | 51 个代码块全部通过类型检查 |
| TypeScript 代码 | tsc 7.0.2，strict 模式，每个代码块单独检查 | @earendil-works/pi-* 1.1.0、@deepseek-ai/dsh-sdk-client 0.0.1-rc.1、@deepseek-ai/dsh-tools 0.0.1-rc.1、@deepseek-ai/cordis 4.0.4 | 22 个代码块全部通过类型检查 |
| 实际运行 | Node.js 26.8.1 | pi 用 faux provider；DSH 用 Cordis 教程第 1 到 5、7 章的示例和 weather-tool 插件 | 输出与笔记中贴出的结果一致 |
| Mermaid 图 | 在浏览器中逐个执行 mermaid.parse 和 mermaid.render | mermaid 11.17.2 | 45 张图全部通过 |
| SVG 插图 | headless Chrome 渲染后目检，再用 getBBox() 测量每段文字和每个方框 | Chrome 155 | 6 张图的文字之间不重叠，也不越出方框 |
| Excalidraw 图 | 用 restore 载入、exportToSvg 导出（内嵌 Excalifont 和 Xiaolai 字体）后目检，再按 Excalidraw 的容器规则测量文字宽高 | @excalidraw/excalidraw 0.18.1 | 3 张图全部通过 |
| 链接与元数据 | 自写脚本：按 Obsidian 的规则解析双链、嵌入、标题锚点和 Canvas 节点，用 PyYAML 解析 frontmatter，核对脚注 | PyYAML 6.0.3 | 全部能解析 |
图示的源文件
6 张 SVG、3 张 Excalidraw 图和 Canvas 知识地图，都由 assets/_build/ 下的三个 Python 脚本生成（build_svgs.py、build_excalidraw.py、build_canvas.py），只依赖 Python 标准库。以后要更新版本号或文字，改脚本后在该目录运行 python3 <脚本名> 即可重新生成。注意：重新生成会覆盖在 Obsidian 里对这些文件做的手工修改。
未覆盖的部分
- 首行标有“片段”或
no-check的代码块没有做校验。比如仓库源码版的 DSH SDK 写法，它和 npm 上的版本不一致，详见 5.3 DSH 核心机制与插件开发。 - 调用真实模型的部分（OpenAI、Claude、DeepSeek）都没有实际运行。