社区导读

简体中文

English

简体中文

English

外观

源文件索引：examples ​

本页由 study-tools/generate-source-index.mjs 根据官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec 生成，共 65 个代码或界面源文件。每个标题对应一个真实路径；用途和拆分原因是面向初学者的结构化解释，自动索引不等于人工精读。

图例 ​

本页所有条目共用以下说明：

  • 自动索引只提供定位线索，复杂行为需要回到源码和测试确认。
  • 条目中的行数、声明、结构线索和静态 import 数字是文件级定位证据，用来约束“为什么这样设计”的解释范围；它们用于定位，不替代人工源码阅读。
  • 源码链接固定到官方提交；如果当前条目与运行版本不同，应先重新生成索引再下结论。

条目按所属包分组：examples/acp-agent（27 条）、examples/headless-agent（32 条）、examples/jsonrpc-agent（6 条）。

examples/acp-agent ​

examples/acp-agent/pty-snapshot-backend.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：确定性 PTY 后端
  • 这个文件有什么用：它提供内存中的 SnapshotSession，模拟 startSend、read、signal、status、close，并通过 Cordis terminals 服务注册，让 PTY 行为无需真实终端也能重复验证。
  • 为什么这样设计：PTY 接口需要可读、可写、可 signal 和可关闭的完整状态机，但真实终端会带来平台和时序噪声；内存 SnapshotSession 复用同一 Cordis 服务契约，给示例和测试提供确定性后端。
  • 文件级设计证据：源码顶部注释把它定位为“Deterministic in-memory PTY backend for transcript snapshots.”；固定提交中扫描到的声明包括 name、inject、apply、SnapshotSession；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读 examples/acp-agent/README.md 和入口，再读当前实现，沿着相关类型、协议或实现和所在包的入口或服务确认输入输出，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 64 行；扫描到的声明包括 name、inject、apply、SnapshotSession；源码顶部原注释（英文，仅作回查线索）：Deterministic in-memory PTY backend for transcript snapshots.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/acp.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“acp-agent over real stdio (no key required)”、“emits only framed JSON-RPC on stdout”、“session/new succeeds over real stdio (no model call)”、“runs a real turn and the agent writes the requested file (verified on disk)”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“acp-agent over real stdio (no key required)”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、examples/acp-agent/tests/cleanup.ts、packages/test-support/acp-snapshot/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/acp-agent/tests/cleanup.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/test-support/acp-snapshot/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 126 行；扫描到的测试主题包括 “acp-agent over real stdio (no key required)”、“emits only framed JSON-RPC on stdout”、“session/new succeeds over real stdio (no model call)”、“runs a real turn and the agent writes the requested file (verified on disk)”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/acp.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“pins native DeepSeek Files offload and inline fallback in assembled requests”、“packed ACP fixture retains every chunk row kind without changing the logical session”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“pins native DeepSeek Files offload and inline fallback in assembled requests”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 prepareEditingCordisSkillWorkspace、prepareDelimiterPathWorkspace、prepareFsSearchWorkspace、fixtureText、fixtureRecords；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/llm/llm/src/index.ts、packages/shell/pwsh-local/src/index.ts、packages/test-support/acp-snapshot/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/llm/llm/src/index.ts、packages/shell/pwsh-local/src/index.ts、packages/test-support/acp-snapshot/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 952 行；扫描到的声明包括 prepareEditingCordisSkillWorkspace、prepareDelimiterPathWorkspace、prepareFsSearchWorkspace、fixtureText、fixtureRecords、snapshotModeFromEnv；扫描到的测试主题包括 “pins native DeepSeek Files offload and inline fallback in assembled requests”、“packed ACP fixture retains every chunk row kind without changing the logical session”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/cleanup.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“cleanupAcpExampleTest”、“removes the workspace after process shutdown fails”、“reports process and workspace failures together”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“cleanupAcpExampleTest”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：源码顶部注释把它定位为“Regression coverage for ACP example teardown.”；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、examples/acp-agent/tests/cleanup.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/acp-agent/tests/cleanup.ts
  • 阅读顺序：先看它直接使用的测试支持 examples/acp-agent/tests/cleanup.ts，再读本文件的测试主题、输入和断言；最后回到被测表面和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 38 行；扫描到的测试主题包括 “cleanupAcpExampleTest”、“removes the workspace after process shutdown fails”、“reports process and workspace failures together”；源码顶部原注释（英文，仅作回查线索）：Regression coverage for ACP example teardown.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/cleanup.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试支持
  • 这个文件有什么用：它为“cleanup”相关测试提供共享准备或环境支持；真正的行为断言由导入它的测试用例完成。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Shared teardown for ACP example tests.”；固定提交中扫描到的声明包括 cleanupAcpExampleTest；本地静态 import 图显示它直接依赖 1 个源文件，并被 4 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/test-support/acp-snapshot/src/index.ts、examples/acp-agent/tests/acp.e2e.ts、examples/acp-agent/tests/cleanup.e2e.ts、examples/acp-agent/tests/escalation.e2e.ts
  • 对应测试：examples/acp-agent/tests/acp.e2e.ts、examples/acp-agent/tests/cleanup.e2e.ts、examples/acp-agent/tests/escalation.e2e.ts、examples/acp-agent/tests/hooks.e2e.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；这些测试用例实际使用了本支持文件。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试 examples/acp-agent/tests/acp.e2e.ts、examples/acp-agent/tests/cleanup.e2e.ts、examples/acp-agent/tests/escalation.e2e.ts，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 23 行；扫描到的声明包括 cleanupAcpExampleTest；源码顶部原注释（英文，仅作回查线索）：Shared teardown for ACP example tests.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/escalation.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“default sandbox composition keyless smoke (real cordis.yml via the Loader)”、“boots the tree — sandbox executor + approval service + bridge — and opens a session”、“denial → model escalation → machine allow-once → the retried write lands on disk”、“a rejected escalation stays denied: no write lands, the turn still ends”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“default sandbox composition keyless smoke (real cordis.yml via the Loader)”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 launchExampleAcpAgent、escalationPrompt；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、examples/acp-agent/tests/cleanup.ts、packages/sandbox/sandbox-local/src/profiles.ts、packages/test-support/acp-snapshot/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/acp-agent/tests/cleanup.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/sandbox/sandbox-local/src/profiles.ts、packages/test-support/acp-snapshot/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 178 行；扫描到的声明包括 launchExampleAcpAgent、escalationPrompt；扫描到的测试主题包括 “default sandbox composition keyless smoke (real cordis.yml via the Loader)”、“boots the tree — sandbox executor + approval service + bridge — and opens a session”、“denial → model escalation → machine allow-once → the retried write lands on disk”、“a rejected escalation stays denied: no write lands, the turn still ends”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/child-question-tripwire.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/interaction/user-questions/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 17 行；扫描到的声明包括 name、inject、apply。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/parent-sandbox-override.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、沙箱提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、apply；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/core/agent/src/index.ts、packages/sandbox/sandbox-policy/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 19 行；扫描到的声明包括 name、apply。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/partial-landlock-sandbox.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、沙箱提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 PartialLandlockSandboxProvider；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/sandbox/sandbox/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 41 行；扫描到的声明包括 PartialLandlockSandboxProvider。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/shell/tool-pwsh/driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：Shell 工具测试驱动
  • 这个文件有什么用：它启动 Loader，真实执行前台和后台 PowerShell，读取输出并写报告，用来验证 shell 工具的进程和输出边界。
  • 为什么这样设计：Shell 工具最容易在“测试替身成功、真实进程失败”之间产生错觉；这个驱动保留真实 PowerShell 前后台进程和报告链路，把操作系统边界作为可观察的测试对象。
  • 文件级设计证据：源码顶部注释把它定位为“Test driver: boot the tool-pwsh Loader composition, execute one real foreground and one real background pwsh command through the tool registry, and persist the observed model-visible output to ./pwsh-loader-report.json for the package spec's inspect step.”；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/boot/app-boot/src/index.ts、packages/llm/llm/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先读 examples/acp-agent/README.md 和入口，再读当前实现，沿着 packages/boot/app-boot/src/index.ts、packages/llm/llm/src/index.ts 和所在包的入口或服务确认输入输出，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 67 行；源码顶部原注释（英文，仅作回查线索）：Test driver: boot the tool-pwsh Loader composition, execute one real foreground and one real background pwsh command through the tool registry, and persist the observed model-visible output to ./pwsh-loader-report.json for the package spec's inspect step.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent-durability-failure.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/core/session/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 131 行；扫描到的声明包括 name、inject、apply。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent-report-fence.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Loader fixture that holds the report child until its parent's spawn turn ends, then parks the parent until child settlement follows the report. @module subagent-report-fence”；固定提交中扫描到的声明包括 name、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/core/agent-loop/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 68 行；扫描到的声明包括 name、apply；源码顶部原注释（英文，仅作回查线索）：Loader fixture that holds the report child until its parent's spawn turn ends, then parks the parent until child settlement follows the report. @module subagent-report-fence。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent-result-diagnostic.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Deterministic provider for model-visible foreground and Job diagnostic snapshots.”；固定提交中扫描到的声明包括 name、inject、apply、DiagnosticProvider；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/core/session/src/index.ts、packages/subagent/subagent/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 68 行；扫描到的声明包括 name、inject、apply、DiagnosticProvider；源码顶部原注释（英文，仅作回查线索）：Deterministic provider for model-visible foreground and Job diagnostic snapshots.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent-settlement-marker.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/subagent/subagent/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 13 行；扫描到的声明包括 name、apply。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent/subagent-acp/driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Test driver: one delegation turn through a headless Loader composition.”；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/boot/app-boot/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 15 行；源码顶部原注释（英文，仅作回查线索）：Test driver: one delegation turn through a headless Loader composition.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent/subagent-acp/mock-delegating-llm.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply、MockDelegatingAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 48 行；扫描到的声明包括 name、inject、apply、MockDelegatingAdapter。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent/subagent-claude-code/driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Inspect the public Claude Code Bundle composition without invoking the product.”；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/boot/app-boot/src/index.ts、packages/core/tools/src/index.ts、packages/subagent/subagent/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 81 行；源码顶部原注释（英文，仅作回查线索）：Inspect the public Claude Code Bundle composition without invoking the product.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent/subagent-claude-code/fixture.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Reuse the composition-only parent adapter shared by the product providers.”；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、examples/acp-agent/tests/fixtures/subagent/subagent-codex/fixture.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 7 行；源码顶部原注释（英文，仅作回查线索）：Reuse the composition-only parent adapter shared by the product providers.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent/subagent-codex/driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Inspect the public Codex provider composition without invoking the product.”；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/boot/app-boot/src/index.ts、packages/core/tools/src/index.ts、packages/subagent/subagent/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 75 行；源码顶部原注释（英文，仅作回查线索）：Inspect the public Codex provider composition without invoking the product.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/subagent/subagent-codex/fixture.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Parent adapter that fails if the composition-only Loader test starts a turn.”；固定提交中扫描到的声明包括 name、inject、apply、CompositionOnlyAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 1 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts、examples/acp-agent/tests/fixtures/subagent/subagent-claude-code/fixture.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 22 行；扫描到的声明包括 name、inject、apply、CompositionOnlyAdapter；源码顶部原注释（英文，仅作回查线索）：Parent adapter that fails if the composition-only Loader test starts a turn.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/fixtures/workspace-context-compaction.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、上下文提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、apply；本地静态 import 图显示它直接依赖 5 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/compaction/compaction/src/index.ts、packages/core/agent/src/index.ts、packages/core/tools/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 36 行；扫描到的声明包括 name、apply。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/goal.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体、目标的具体场景，包括“same-session goal snapshot through the ACP automation driver”、“runs exact automatic rounds in the shipped application and persists cancellation”、“injects the wrap-up instruction after an autonomous completion and delivers a closing m...”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“same-session goal snapshot through the ACP automation driver”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 parseJsonl、normalizeGoalTimestamps、normalizeGoalLog；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、packages/core/session/src/index.ts、packages/goal/goal/src/index.ts、packages/test-support/acp-snapshot/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/goal/goal/src/index.ts、packages/test-support/acp-snapshot/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 172 行；扫描到的声明包括 parseJsonl、normalizeGoalTimestamps、normalizeGoalLog；扫描到的测试主题包括 “same-session goal snapshot through the ACP automation driver”、“runs exact automatic rounds in the shipped application and persists cancellation”、“injects the wrap-up instruction after an autonomous completion and delivers a closing message”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/hooks.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体、钩子的具体场景，包括“denies every bash command, so the requested file is never written (verified on disk)”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“denies every bash command, so the requested file is never written (verified on disk)”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md、examples/acp-agent/tests/cleanup.ts、packages/test-support/acp-snapshot/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/acp-agent/tests/cleanup.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/test-support/acp-snapshot/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 72 行；扫描到的测试主题包括 “denies every bash command, so the requested file is never written (verified on disk)”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/snapshots/hook-cc-posttool-block/workspace/posttool-once.sh ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 7 行。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/snapshots/lsp-definition/workspace/lsp-server.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 frame、location、handle；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 57 行；扫描到的声明包括 frame、location、handle。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/tests/snapshots/lsp-definition/workspace/subject.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 answer；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 2 行；扫描到的声明包括 answer。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/acp-agent/web-fetch-fixture-server.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：Web Fetch 测试服务器
  • 这个文件有什么用：它在固定 loopback 端口启动 HTTP server，供真实 web-fetch transport 和 Markdown 转换测试使用。
  • 为什么这样设计：Web Fetch 需要真实 HTTP framing 和 Markdown 转换，但不应依赖公网状态；固定 loopback server 将网络边界保留下来，同时让响应、端口和清理都可重复。
  • 文件级设计证据：源码顶部注释把它定位为“Deterministic loopback HTTP fixture for the web-fetch snapshot scenario: a small HTML page (headings, named entities, a GFM table, nested formatting) on a fixed port, so recording and keyless replay drive the REAL dsh-web-fetch-http transport and dsh-tool-w...”；固定提交中扫描到的声明包括 name、apply；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/acp-agent/README.md
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读 examples/acp-agent/README.md 和入口，再读当前实现，沿着相关类型、协议或实现和所在包的入口或服务确认输入输出，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 55 行；扫描到的声明包括 name、apply；源码顶部原注释（英文，仅作回查线索）：Deterministic loopback HTTP fixture for the web-fetch snapshot scenario: a small HTML page (headings, named entities, a GFM table, nested formatting) on a fixed port, so recording and keyless replay drive the REAL dsh-web-fetch-http transport and dsh-tool-w...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent ​

examples/headless-agent/tests/code-mode.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“Code Mode typed values: keyless real-worker contracts”、“crosses a large intermediate value intact and exposes only typed tool failure fields”、“returns a background job id, settles the outer run, and polls that id to completion”、“pre-abort spawns nothing; post-publication abort leaves job_kill as the cancellation owner”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“Code Mode typed values: keyless real-worker contracts”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 codeModeHarness、workspaceCodeModeHarness、runCode、completion、typedCodeModeHarness；本地静态 import 图显示它直接依赖 20 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/context/agent-instructions/src/index.ts、packages/core/agent-loop/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/context/agent-instructions/src/index.ts、packages/core/agent-loop/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 438 行；扫描到的声明包括 codeModeHarness、workspaceCodeModeHarness、runCode、completion、typedCodeModeHarness、backgroundCodeModeHarness、waitForIdle；扫描到的测试主题包括 “Code Mode typed values: keyless real-worker contracts”、“crosses a large intermediate value intact and exposes only typed tool failure fields”、“returns a background job id, settles the outer run, and polls that id to completion”、“pre-abort spawns nothing; post-publication abort leaves job_kill as the cancellation owner”、“keeps foreground bash coupled to the outer signal”、“uses versioned Cordis DTO ids directly for running and pending Plugins, then confirms removal”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/coding-task.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“repairs add.js so node add.test.js passes”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“repairs add.js so node add.test.js passes”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、examples/headless-agent/tests/harness.ts、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/headless-agent/tests/harness.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 86 行；扫描到的测试主题包括 “repairs add.js so node add.test.js passes”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/compaction.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“summarizes older history into a checkpoint without breaking the task”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“summarizes older history into a checkpoint without breaking the task”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、examples/headless-agent/tests/harness.ts、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/headless-agent/tests/harness.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 88 行；扫描到的测试主题包括 “summarizes older history into a checkpoint without breaking the task”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/cli-mock-llm.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：无密钥模拟 LLM
  • 这个文件有什么用：它模拟模型请求、工具调用和最终回答，让 headless CLI 测试在没有真实 API key 的条件下覆盖完整轮次。
  • 为什么这样设计：无头轮次的测试重点是 Agent、工具和 JSONL 事件的协作，不是供应商网络；模拟 LLM 保留请求到最终回答的协议形状，让完整轮次无需密钥也能稳定回归。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply、CliMockAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先读 examples/headless-agent/README.md 和入口，再读当前实现，沿着 packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts 和所在包的入口或服务确认输入输出，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 70 行；扫描到的声明包括 name、inject、apply、CliMockAdapter。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/e2b/e2b/bin.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 7 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/boot/app-boot/src/index.ts、packages/core/agent/src/index.ts、packages/core/session/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 202 行。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/e2b/e2b/fixture-lsp.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 send、respond、dispatch、drain；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 85 行；扫描到的声明包括 send、respond、dispatch、drain。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/goal-domain/seed-goal.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、目标提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Test-only Loader plugin that creates a goal at the first real step edge.”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/goal/goal/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 19 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Test-only Loader plugin that creates a goal at the first real step edge.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/headless-driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：Headless 测试驱动
  • 这个文件有什么用：它启动 headless Loader，以 JSONL 输出 session event 和最终结果，把命令行黑盒流程变成可观察的测试输入。
  • 为什么这样设计：Headless 流程的关键证据在进程输出和 Session event，而不只在返回值；驱动统一启动 Loader 并输出 JSONL，测试就能观察真实边界和最终收束。
  • 文件级设计证据：源码顶部注释把它定位为“Snapshot-only Loader driver: stream one fixture turn as canonical JSONL.”；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/boot/app-boot/src/index.ts、packages/core/session/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先读 examples/headless-agent/README.md 和入口，再读当前实现，沿着 packages/boot/app-boot/src/index.ts、packages/core/session/src/index.ts、packages/test-support/loader-smoke/src/index.ts 和所在包的入口或服务确认输入输出，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 33 行；源码顶部原注释（英文，仅作回查线索）：Snapshot-only Loader driver: stream one fixture turn as canonical JSONL.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/retry-snapshot-backend.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Deterministic provider adapter for the headless retry-policy snapshot.”；固定提交中扫描到的声明包括 name、inject、apply、RetrySnapshotAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 53 行；扫描到的声明包括 name、inject、apply、RetrySnapshotAdapter；源码顶部原注释（英文，仅作回查线索）：Deterministic provider adapter for the headless retry-policy snapshot.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/semantic-checkpoint-agent.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Loader fixture that publishes the semantic-checkpoint session before CLI dispatch. @module semantic-checkpoint-agent”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 25 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Loader fixture that publishes the semantic-checkpoint session before CLI dispatch. @module semantic-checkpoint-agent。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/session-telemetry-otel-driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、会话提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Test driver: start a mock OTLP/HTTP collector, boot the telemetry Loader composition against it, run one turn whose prompt carries a fixture credential, then persist everything the collector captured to ./otlp-captures.json for the e2e's inspect step.”；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/boot/app-boot/src/index.ts、packages/feedback/command-feedback/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 53 行；源码顶部原注释（英文，仅作回查线索）：Test driver: start a mock OTLP/HTTP collector, boot the telemetry Loader composition against it, run one turn whose prompt carries a fixture credential, then persist everything the collector captured to ./otlp-captures.json for the e2e's inspect step.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/startup-activation-error/activation-error.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、启动提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Fail activation with a deterministic stack so the user-visible startup diagnostic is snapshot-stable.”；固定提交中扫描到的声明包括 apply；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 6 行；扫描到的声明包括 apply；源码顶部原注释（英文，仅作回查线索）：Fail activation with a deterministic stack so the user-visible startup diagnostic is snapshot-stable.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/subagent-diagnostic-agent.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Loader fixture that resumes the seeded diagnostic-scenario parent before CLI dispatch, so list_agents runs against its pre-seeded cold child. @module subagent-diagnostic-agent”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 26 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Loader fixture that resumes the seeded diagnostic-scenario parent before CLI dispatch, so list_agents runs against its pre-seeded cold child. @module subagent-diagnostic-agent。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/subagent-inheritance-agent.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Loader fixture that resumes the seeded read-only parent before CLI dispatch. @module subagent-inheritance-agent”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 25 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Loader fixture that resumes the seeded read-only parent before CLI dispatch. @module subagent-inheritance-agent。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/subagent-settlement-fence.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Loader fixture that holds the parent's second step until settlement delivery. @module subagent-settlement-fence”；固定提交中扫描到的声明包括 name、apply；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/agent-loop/src/index.ts、packages/subagent/subagent/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 43 行；扫描到的声明包括 name、apply；源码顶部原注释（英文，仅作回查线索）：Loader fixture that holds the parent's second step until settlement delivery. @module subagent-settlement-fence。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/team-llm.mjs ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、大语言模型提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Deterministic keyless Agent Teams adapter for the real headless Loader snapshot.”；固定提交中扫描到的声明包括 name、inject、apply、calls、latestAssistantCalls；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/llm/llm/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 194 行；扫描到的声明包括 name、inject、apply、calls、latestAssistantCalls、hasTaskAction、latestToolText、toolChunks；源码顶部原注释（英文，仅作回查线索）：Deterministic keyless Agent Teams adapter for the real headless Loader snapshot.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/telemetry-redact-rule.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、apply、scrub；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 29 行；扫描到的声明包括 name、apply、scrub。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/time-context-driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、上下文提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Test driver that sends two turns through one Headless Loader composition.”；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/boot/app-boot/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 16 行；源码顶部原注释（英文，仅作回查线索）：Test driver that sends two turns through one Headless Loader composition.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/time-context-mock-llm.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、上下文提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply、TimeContextMockAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 22 行；扫描到的声明包括 name、inject、apply、TimeContextMockAdapter。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/fixtures/workspace-context-resume-agent.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、上下文提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Loader fixture that resumes the seeded agent-instructions session. @module workspace-context-resume-agent”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 25 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Loader fixture that resumes the seeded agent-instructions session. @module workspace-context-resume-agent。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/full-loop.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“runs a bash command on request and reports its output”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“runs a bash command on request and reports its output”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、examples/headless-agent/tests/harness.ts、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/headless-agent/tests/harness.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 49 行；扫描到的测试主题包括 “runs a bash command on request and reports its output”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/harness.ts ​

examples/headless-agent/tests/headless.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“headless stream-json snapshots”、“runs one task through the product headless profile command”、“prints a terminal model failure through the product headless profile command”、“prints the original Loader activation error through the assembled one-shot app”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“headless stream-json snapshots”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 projectSessionFixture、deepseekDefaultsServer、parseJsonl、contextFromLogs、normalizeHeadlessStream；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/session/session-persistence-jsonl/src/zstd.ts、packages/test-support/acp-snapshot/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/session/session-persistence-jsonl/src/zstd.ts、packages/test-support/acp-snapshot/src/index.ts、packages/test-support/loader-smoke/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 1008 行；扫描到的声明包括 projectSessionFixture、deepseekDefaultsServer、parseJsonl、contextFromLogs、normalizeHeadlessStream、normalizeGoalTimestamps、normalizeGoalStream、scenarioPrompt；扫描到的测试主题包括 “headless stream-json snapshots”、“runs one task through the product headless profile command”、“prints a terminal model failure through the product headless profile command”、“prints the original Loader activation error through the assembled one-shot app”、“retries a transient provider failure through the one-shot app”、“recovers from context overflow through an assembled compaction”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/keyless-smoke.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“headless-agent keyless smoke”、“boots the real Loader tree, runs a real bash tool round trip, and persists the turn”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“headless-agent keyless smoke”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/test-support/loader-smoke/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 49 行；扫描到的测试主题包括 “headless-agent keyless smoke”、“boots the real Loader tree, runs a real bash tool round trip, and persists the turn”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/real-model.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“modifies a temporary workspace and verifies the file outside the agent”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“modifies a temporary workspace and verifies the file outside the agent”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/test-support/loader-smoke/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 33 行；扫描到的测试主题包括 “modifies a temporary workspace and verifies the file outside the agent”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/resume.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“recalls a fact stored in a prior, separately-disposed session”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“recalls a fact stored in a prior, separately-disposed session”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、examples/headless-agent/tests/harness.ts、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/headless-agent/tests/harness.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 68 行；扫描到的测试主题包括 “recalls a fact stored in a prior, separately-disposed session”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/semantic-checkpoint.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“semantic checkpoint recovery snapshot”、“resumes an unknown tool outcome through the headless stream-json app”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“semantic checkpoint recovery snapshot”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 seedInterruptedSession；本地静态 import 图显示它直接依赖 6 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 120 行；扫描到的声明包括 seedInterruptedSession；扫描到的测试主题包括 “semantic checkpoint recovery snapshot”、“resumes an unknown tool outcome through the headless stream-json app”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/session-format-guard.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体、会话的具体场景，包括“session format guard through the assembled app”、“refuses to resume a newer-format log, naming the upgrade direction and the raw log path”、“refuses to resume a log with an unknown required event type”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“session format guard through the assembled app”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：源码顶部注释把它定位为“Assembled-app regression for the session-format refusal surface: resuming a log written by a "newer" harness (format version ahead, or an unknown required event type) fails loud through the real Loader composition, and the error the product user sees names ...”；固定提交中扫描到的声明包括 seedSession、closedTurn；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts、packages/test-support/loader-smoke/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 107 行；扫描到的声明包括 seedSession、closedTurn；扫描到的测试主题包括 “session format guard through the assembled app”、“refuses to resume a newer-format log, naming the upgrade direction and the raw log path”、“refuses to resume a log with an unknown required event type”；源码顶部原注释（英文，仅作回查线索）：Assembled-app regression for the session-format refusal surface: resuming a log written by a "newer" harness (format version ahead, or an unknown required event type) fails loud through the real Loader composition, and the error the product user sees names ...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/subagent-diagnostic.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体、子 agent的具体场景，包括“descriptor-less cold child diagnostic snapshot”、“surfaces the unreadable child as a corrupt diagnostic through the assembled headless app”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“descriptor-less cold child diagnostic snapshot”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：源码顶部注释把它定位为“Assembled-app regression: a persisted origin: 'subagent' child whose log carries no descriptor event is surfaced by list_agents as a diagnostic: corrupt row instead of being silently dropped.”；固定提交中扫描到的声明包括 seedDescriptorlessChild；本地静态 import 图显示它直接依赖 6 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 120 行；扫描到的声明包括 seedDescriptorlessChild；扫描到的测试主题包括 “descriptor-less cold child diagnostic snapshot”、“surfaces the unreadable child as a corrupt diagnostic through the assembled headless app”；源码顶部原注释（英文，仅作回查线索）：Assembled-app regression: a persisted origin: 'subagent' child whose log carries no descriptor event is surfaced by list_agents as a diagnostic: corrupt row instead of being silently dropped.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/subagent-inheritance.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体、子 agent的具体场景，包括“parent-only override inheritance snapshot”、“confines a delegated child through the assembled headless app”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“parent-only override inheritance snapshot”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：源码顶部注释把它定位为“Assembled-app regression: a parent-only read-only override is seeded into its child log and confines a real write under a wider deployment default.”；固定提交中扫描到的声明包括 seedReadOnlyParent；本地静态 import 图显示它直接依赖 6 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、packages/session/session-persistence-jsonl/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 143 行；扫描到的声明包括 seedReadOnlyParent；扫描到的测试主题包括 “parent-only override inheritance snapshot”、“confines a delegated child through the assembled headless app”；源码顶部原注释（英文，仅作回查线索）：Assembled-app regression: a parent-only read-only override is seeded into its child log and confines a real write under a wider deployment default.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/todo-write.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“appends a todo/write event with the model-produced task list”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“appends a todo/write event with the model-produced task list”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 4 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、examples/headless-agent/tests/harness.ts、packages/core/session/src/index.ts、packages/llm/llm/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 测试支持：examples/headless-agent/tests/harness.ts
  • 阅读顺序：先看它直接导入的被测实现 packages/core/session/src/index.ts、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 58 行；扫描到的测试主题包括 “appends a todo/write event with the model-produced task list”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/headless-agent/tests/workspace-context-resume.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体、上下文的具体场景，包括“agent-instructions resume snapshot”、“appends an offline replacement without duplicating the visible baseline”、“supersedes an incompatible baseline when precedence changed offline”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“agent-instructions resume snapshot”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：源码顶部注释把它定位为“Assembled-app regression for persisted workspace-instruction resume state. @module workspace-context-resume-snapshot”；固定提交中扫描到的声明包括 seedVisibleBaseline；本地静态 import 图显示它直接依赖 8 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/headless-agent/README.md、packages/context/agent-instructions/src/config.ts、packages/context/agent-instructions/src/index.ts、packages/core/session/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/context/agent-instructions/src/config.ts、packages/context/agent-instructions/src/index.ts、packages/core/session/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 235 行；扫描到的声明包括 seedVisibleBaseline；扫描到的测试主题包括 “agent-instructions resume snapshot”、“appends an offline replacement without duplicating the visible baseline”、“supersedes an incompatible baseline when precedence changed offline”；源码顶部原注释（英文，仅作回查线索）：Assembled-app regression for persisted workspace-instruction resume state. @module workspace-context-resume-snapshot。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/jsonrpc-agent ​

examples/jsonrpc-agent/minimal.py ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：Python SDK 最小示例
  • 这个文件有什么用：它解析 prompt、workspace、provider、model 和 token 参数，创建 DeepSeekHarness，执行一个 turn 并打印最终回答。
  • 为什么这样设计：最小示例应该只展示公共 SDK 的组合顺序，不掺入产品内部插件；把参数解析、一次 turn 和最终回答保持在一个短文件中，读者能从示例直接追到 SDK 契约。
  • 文件级设计证据：固定提交中扫描到的声明包括 main；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/jsonrpc-agent/README.md、python/sdk/src/deepseek_harness/init.py
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读 examples/jsonrpc-agent/README.md 和入口，再读当前实现，沿着 python/sdk/src/deepseek_harness/__init__.py 和所在包的入口或服务确认输入输出，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 43 行；扫描到的声明包括 main。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/jsonrpc-agent/tests/fixtures/subagent/subagent-dsh-sdk/child-mock-llm.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply、CwdEchoAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/jsonrpc-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 32 行；扫描到的声明包括 name、inject、apply、CwdEchoAdapter。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/jsonrpc-agent/tests/fixtures/subagent/subagent-dsh-sdk/driver.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：源码顶部注释把它定位为“Test driver: one delegation turn through a headless Loader composition.”；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/jsonrpc-agent/README.md、packages/boot/app-boot/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 15 行；源码顶部原注释（英文，仅作回查线索）：Test driver: one delegation turn through a headless Loader composition.。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/jsonrpc-agent/tests/fixtures/subagent/subagent-dsh-sdk/mock-delegating-llm.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试夹具
  • 这个文件有什么用：它为示例、智能体、子 agent提供固定输入、进程、事件或快照，让每次验证都从同一个受控状态开始。
  • 为什么这样设计：测试材料和被测实现分开，测试可以反复使用同一个受控输入；它不应该被误认为线上入口或生产服务。
  • 文件级设计证据：固定提交中扫描到的声明包括 name、inject、apply、MockDelegatingAdapter；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/jsonrpc-agent/README.md、packages/llm/llm/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有发现直接使用本支持文件的测试用例。
  • 测试关联依据：本文件按路径分类为测试支持，固定提交中没有发现测试用例对它的直接相对 import。
  • 阅读顺序：先看它提供的固定输入或环境，再跳到实际使用它的测试同包中与它同名或覆盖相近场景的测试，最后回看被测实现和清理路径。
  • 代码证据：固定提交归档实际读取结果：约 48 行；扫描到的声明包括 name、inject、apply、MockDelegatingAdapter。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/jsonrpc-agent/tests/keyless-smoke.e2e.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“jsonrpc-agent keyless smoke”、“rejects an invalid max-token success env value”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“jsonrpc-agent keyless smoke”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 waitForLine；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/jsonrpc-agent/README.md
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看源码中与它对应的被测实现或契约相关类型、协议或实现，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 202 行；扫描到的声明包括 waitForLine；扫描到的测试主题包括 “jsonrpc-agent keyless smoke”、“rejects an invalid max-token success env value”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

examples/jsonrpc-agent/tests/sdk.snapshot.ts ​

  • 所属层：帮助学习和回归验证的可运行示例
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查示例、智能体的具体场景，包括“TypeScript SDK snapshots over the jsonrpc runtime”、“replays ${scenario.name} through the SDK”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“TypeScript SDK snapshots over the jsonrpc runtime”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：源码顶部注释把它定位为“Keyless snapshot coverage for the TypeScript SDK path: each scenario spawns the REAL dsh-jsonrpc-agent runtime (per DSH_EXAMPLE_MODE) through the REAL @deepseek-ai/dsh-sdk-client, drives one turn over stdio JSON-RPC, and pins the SDK RunResult, the complete...”；固定提交中扫描到的声明包括 dirOf、jsonlFiles、persistedLogs、assembledTools、assembledToolRequirements；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：examples/jsonrpc-agent/README.md、packages/sdk/client/src/index.ts、packages/test-support/acp-snapshot/src/index.ts、packages/test-support/loader-smoke/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/sdk/client/src/index.ts、packages/test-support/acp-snapshot/src/index.ts、packages/test-support/loader-smoke/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 468 行；扫描到的声明包括 dirOf、jsonlFiles、persistedLogs、assembledTools、assembledToolRequirements、assembledToolDescriptions、assembledSystem、assembledRuntimeContexts；扫描到的测试主题包括 “TypeScript SDK snapshots over the jsonrpc runtime”、“replays ${scenario.name} through the SDK”；源码顶部原注释（英文，仅作回查线索）：Keyless snapshot coverage for the TypeScript SDK path: each scenario spawns the REAL dsh-jsonrpc-agent runtime (per DSH_EXAMPLE_MODE) through the REAL @deepseek-ai/dsh-sdk-client, drives one turn over stdio JSON-RPC, and pins the SDK RunResult, the complete...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。