社区导读

简体中文

English

简体中文

English

外观

源文件索引：packages/code-runtime ​

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

图例 ​

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

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

packages/code-runtime/code-runtime-python/py/protocol.py ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：协议边界
  • 这个文件有什么用：它规定运行时、Python 支持、协议两端交换的消息形状和生命周期，避免不同进程或线程各自解释协议。
  • 为什么这样设计：协议独立于两端实现，消息版本、生命周期和失败语义才有单一的审查位置；进程或线程替换不会改变上层契约。
  • 文件级设计证据：固定提交中扫描到的声明包括 bodies、ErrorClass、Namespace、BootMessage、RunMessage；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md
  • 对应测试：packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts、packages/code-runtime/code-runtime-python/tests/protocol.spec.ts
  • 测试关联依据：按同包文件名保守推断，未确认直接 import；这不是完整覆盖证明。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-python/README.md、入口和消费者，再读当前契约，沿着所在包的入口或服务看它怎样约束运行时，最后对照 packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts、packages/code-runtime/code-runtime-python/tests/protocol.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 138 行；扫描到的声明包括 bodies、ErrorClass、Namespace、BootMessage、RunMessage、BootAckMessage、LogMessage、DoneErrorField。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-python/src/index.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：模块入口
  • 这个文件有什么用：它把运行时、Python 支持相关的公开能力集中导出，并决定调用者可以依赖哪些边界；调用者因此不必记住所有内部文件。
  • 为什么这样设计：入口文件把公开边界固定下来，内部文件可以继续拆分或替换；其他包只依赖入口暴露的 API，依赖方向更稳定。
  • 文件级设计证据：源码顶部注释把它定位为“CPython subprocess code runtime for the DeepSeek Harness code-execution seam. The package owns the versionless fd-3 wire protocol between the Node host and the CPython subprocess. The protocol's host-side codec and hostile-frame validators are re-exported s...”；本地静态 import 图显示它直接依赖 1 个源文件，并被 1 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md、packages/code-runtime/code-runtime-python/src/protocol.ts、packages/code-runtime/code-runtime-python/tests/protocol.spec.ts
  • 对应测试：packages/code-runtime/code-runtime-python/tests/protocol.spec.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-python/README.md、入口和消费者，再读当前契约，沿着 packages/code-runtime/code-runtime-python/tests/protocol.spec.ts 看它怎样约束运行时，最后对照 packages/code-runtime/code-runtime-python/tests/protocol.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 19 行；源码顶部原注释（英文，仅作回查线索）：CPython subprocess code runtime for the DeepSeek Harness code-execution seam. The package owns the versionless fd-3 wire protocol between the Node host and the CPython subprocess. The protocol's host-side codec and hostile-frame validators are re-exported s...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-python/src/invariant.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：运行时不变量
  • 这个文件有什么用：它检查运行时、Python 支持必须始终成立的条件，在错误刚出现时报告，而不是等到更深层才出现难以解释的结果。
  • 为什么这样设计：把不变量集中在一个位置，调用者和测试就能用同一条规则检查状态；错误在边界处报告，比在后续 UI 或网络请求中才暴露更容易修复。
  • 文件级设计证据：源码顶部注释把它定位为“Package-owned invariant companion for @deepseek-ai/dsh-code-runtime-python. @module @deepseek-ai/dsh-code-runtime-python/invariant”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md、packages/runtime-diagnostics/invariants/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读相关类型和事件，再读当前状态或存储实现，沿着 packages/runtime-diagnostics/invariants/src/index.ts、vendor/cordis/src/index.ts 和所在包的入口或服务理解状态变化，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 31 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Package-owned invariant companion for @deepseek-ai/dsh-code-runtime-python. @module @deepseek-ai/dsh-code-runtime-python/invariant。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-python/src/protocol.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：协议边界
  • 这个文件有什么用：它规定运行时、Python 支持、协议两端交换的消息形状和生命周期，避免不同进程或线程各自解释协议。
  • 为什么这样设计：协议独立于两端实现，消息版本、生命周期和失败语义才有单一的审查位置；进程或线程替换不会改变上层契约。
  • 文件级设计证据：源码顶部注释把它定位为“Versionless, JSON-lines wire protocol between the Node host and the CPython subprocess. Frames travel on the child's fd 3 (one JSON object per line), leaving stdout/stderr free for the program's own output. Host treats every inbound frame as hostile because...”；固定提交中扫描到的声明包括 PROTOCOL_FD、BootMessage、ChildToHost、ReplyMessage、WIRE_FRAME_FIELDS；本地静态 import 图显示它直接依赖 0 个源文件，并被 2 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md、packages/code-runtime/code-runtime-python/src/index.ts、packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts
  • 对应测试：packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-python/README.md、入口和消费者，再读当前契约，沿着 packages/code-runtime/code-runtime-python/src/index.ts、packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts 看它怎样约束运行时，最后对照 packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts。
  • 代码证据：固定提交归档实际读取结果：约 656 行；扫描到的声明包括 PROTOCOL_FD、BootMessage、ChildToHost、ReplyMessage、WIRE_FRAME_FIELDS、logTruncationMarker、encodeJsonPlain、checkDoneValue；源码顶部原注释（英文，仅作回查线索）：Versionless, JSON-lines wire protocol between the Node host and the CPython subprocess. Frames travel on the child's fd 3 (one JSON object per line), leaving stdout/stderr free for the program's own output. Host treats every inbound frame as hostile because...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-python/tests/protocol-mirror.e2e.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时、Python 支持、协议的具体场景，包括“agrees on PROTOCOL_FD and the log truncation marker across byte budgets”、“agrees on every frame type\”、“names the py/ directory that ships with the package”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“agrees on PROTOCOL_FD and the log truncation marker across byte budgets”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 hasPython3；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md、packages/code-runtime/code-runtime-python/src/protocol.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-python/src/protocol.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 103 行；扫描到的声明包括 hasPython3；扫描到的测试主题包括 “agrees on PROTOCOL_FD and the log truncation marker across byte budgets”、“agrees on every frame type\”、“names the py/ directory that ships with the package”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-python/tests/protocol.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时、Python 支持、协议的具体场景，包括“logTruncationMarker”、“names the configured byte budget”、“validateChildFrame”、“rebuilds boot-ack frames without extra fields”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“logTruncationMarker”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md、packages/code-runtime/code-runtime-python/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-python/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 304 行；扫描到的测试主题包括 “logTruncationMarker”、“names the configured byte budget”、“validateChildFrame”、“rebuilds boot-ack frames without extra fields”、“rebuilds log frames when the text field is a string”、“carries a log frame truncation flag only for the literal true”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-python/tsdown.config.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：构建或测试配置
  • 这个文件有什么用：它告诉工具链怎样处理运行时、Python 支持：从哪里开始、使用哪个环境、解析哪些依赖以及输出什么产物；这些规则集中后，构建和测试才可重复。
  • 为什么这样设计：工具链配置独立于业务实现，构建、测试和发布可以复用同一套入口规则；改配置时也能单独看出运行环境变化。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-python/README.md
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-python/README.md，再读本配置/脚本，沿着所在包的入口或服务确认它如何影响入口和产物，最后对照对应 gate 或快照测试。
  • 代码证据：固定提交归档实际读取结果：约 16 行。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：代码运行 Worker 启动器
  • 这个文件有什么用：它在 Worker 侧创建受限的 console、绑定命名空间、捕获 stdout/stderr，并通过 port 运行用户代码；日志和完成值都受统一 JSON 字节预算约束。
  • 为什么这样设计：用户代码执行必须与宿主插件树隔离，并限制日志、返回值和通信预算；Worker 启动器统一建立 console、port 和 JSON 边界，异常或超量输出不会直接污染主进程。
  • 文件级设计证据：源码顶部注释把它定位为“Worker-side execution logic, written as plain functions over an injected port so the unit suite can run every line IN-PROCESS against a fake port (a real worker thread is a separate V8 isolate the coverage provider cannot observe). @module @deepseek-ai/dsh-...”；固定提交中扫描到的声明包括 BootstrapPort、PatchableStream、LogBuffer、makeConsoleShim、captureStreamWrites；本地静态 import 图显示它直接依赖 3 个源文件，并被 2 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/output-json.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts、packages/code-runtime/code-runtime-worker-thread/src/worker.ts
  • 对应测试：packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md 和入口，再读当前实现，沿着 packages/code-runtime/code-runtime-worker-thread/src/output-json.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts 和 packages/code-runtime/code-runtime-worker-thread/src/worker.ts、packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts 确认输入输出，最后对照 packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 424 行；扫描到的声明包括 BootstrapPort、PatchableStream、LogBuffer、makeConsoleShim、captureStreamWrites、prepareCompletion、prepareException、PendingCall；源码顶部原注释（英文，仅作回查线索）：Worker-side execution logic, written as plain functions over an injected port so the unit suite can run every line IN-PROCESS against a fake port (a real worker thread is a separate V8 isolate the coverage provider cannot observe). @module @deepseek-ai/dsh-...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/index.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：模块入口
  • 这个文件有什么用：它把运行时、工作线程相关的公开能力集中导出，并决定调用者可以依赖哪些边界；调用者因此不必记住所有内部文件。
  • 为什么这样设计：入口文件把公开边界固定下来，内部文件可以继续拆分或替换；其他包只依赖入口暴露的 API，依赖方向更稳定。
  • 文件级设计证据：源码顶部注释把它定位为“Worker-thread code runtime: a fresh worker runs each host-type-stripped TypeScript program and bridges bindings over its message port. This is containment, not a security boundary: model code has bash-equivalent trust despite an empty environment, a heap ca...”；固定提交中扫描到的声明包括 Config、WorkerThreadCodeRuntime、messageOf、waitForPipeDrain、parseWorkerMessage；本地静态 import 图显示它直接依赖 8 个源文件，并被 4 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/output-json.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts、examples/headless-agent/tests/code-mode.e2e.ts
  • 对应测试：examples/headless-agent/tests/code-mode.e2e.ts、packages/code-runtime/code-runtime-worker-thread/tests/built-lib.e2e.ts、packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.ts、packages/spill/spill-policy/tests/spill-policy.spec.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md、入口和消费者，再读当前契约，沿着 examples/headless-agent/tests/code-mode.e2e.ts、packages/code-runtime/code-runtime-worker-thread/tests/built-lib.e2e.ts、packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.ts 看它怎样约束运行时，最后对照 examples/headless-agent/tests/code-mode.e2e.ts、packages/code-runtime/code-runtime-worker-thread/tests/built-lib.e2e.ts、packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 561 行；扫描到的声明包括 Config、WorkerThreadCodeRuntime、messageOf、waitForPipeDrain、parseWorkerMessage、OutputLedger；源码顶部原注释（英文，仅作回查线索）：Worker-thread code runtime: a fresh worker runs each host-type-stripped TypeScript program and bridges bindings over its message port. This is containment, not a security boundary: model code has bash-equivalent trust despite an empty environment, a heap ca...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/invariant.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：运行时不变量
  • 这个文件有什么用：它检查运行时、工作线程必须始终成立的条件，在错误刚出现时报告，而不是等到更深层才出现难以解释的结果。
  • 为什么这样设计：把不变量集中在一个位置，调用者和测试就能用同一条规则检查状态；错误在边界处报告，比在后续 UI 或网络请求中才暴露更容易修复。
  • 文件级设计证据：源码顶部注释把它定位为“Package-owned invariant companion for @deepseek-ai/dsh-code-runtime-worker-thread. @module @deepseek-ai/dsh-code-runtime-worker-thread/invariant”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/runtime-diagnostics/invariants/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读相关类型和事件，再读当前状态或存储实现，沿着 packages/runtime-diagnostics/invariants/src/index.ts、vendor/cordis/src/index.ts 和所在包的入口或服务理解状态变化，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 30 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Package-owned invariant companion for @deepseek-ai/dsh-code-runtime-worker-thread. @module @deepseek-ai/dsh-code-runtime-worker-thread/invariant。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/output-json.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：JSON 边界
  • 这个文件有什么用：它检查或转换运行时、工作线程的可安全序列化 JSON 数据，阻止不可重放的对象穿过协议和持久化边界。
  • 为什么这样设计：协议和日志只接受可重放的 JSON 数据，把检查放在边界可以阻止函数、循环对象或带原型对象混入持久化事实。
  • 文件级设计证据：源码顶部注释把它定位为“JSON string-prefix accounting for the outer-output ledger. @module @deepseek-ai/dsh-code-runtime-worker-thread/output-json”；固定提交中扫描到的声明包括 jsonStringBytesUpTo、jsonValueBytesUpTo、truncateJsonStringBytes、dataDescriptor、defineEnumerableDataProperty；本地静态 import 图显示它直接依赖 1 个源文件，并被 3 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime/src/index.ts、packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime-worker-thread/tests/output-json.spec.ts
  • 对应测试：packages/code-runtime/code-runtime-worker-thread/tests/output-json.spec.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md、入口和消费者，再读当前契约，沿着 packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime-worker-thread/tests/output-json.spec.ts 看它怎样约束运行时，最后对照 packages/code-runtime/code-runtime-worker-thread/tests/output-json.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 179 行；扫描到的声明包括 jsonStringBytesUpTo、jsonValueBytesUpTo、truncateJsonStringBytes、dataDescriptor、defineEnumerableDataProperty、byteLength、append、takeLast；源码顶部原注释（英文，仅作回查线索）：JSON string-prefix accounting for the outer-output ledger. @module @deepseek-ai/dsh-code-runtime-worker-thread/output-json。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/protocol.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：协议边界
  • 这个文件有什么用：它规定运行时、工作线程、协议两端交换的消息形状和生命周期，避免不同进程或线程各自解释协议。
  • 为什么这样设计：协议独立于两端实现，消息版本、生命周期和失败语义才有单一的审查位置；进程或线程替换不会改变上层契约。
  • 文件级设计证据：源码顶部注释把它定位为“Versionless, structured-clone wire protocol between co-shipped host and worker code. The host treats inbound traffic as hostile because model code can forge parentPort messages; the worker trusts host replies. @module @deepseek-ai/dsh-code-runtime-worker-th...”；固定提交中扫描到的声明包括 WorkerBootData、DoneMessage、WorkerToHost、ReplyMessage；本地静态 import 图显示它直接依赖 1 个源文件，并被 4 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts、packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime-worker-thread/src/worker.ts
  • 对应测试：packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md、入口和消费者，再读当前契约，沿着 packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime-worker-thread/src/worker.ts 看它怎样约束运行时，最后对照 packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 68 行；扫描到的声明包括 WorkerBootData、DoneMessage、WorkerToHost、ReplyMessage；源码顶部原注释（英文，仅作回查线索）：Versionless, structured-clone wire protocol between co-shipped host and worker code. The host treats inbound traffic as hostile because model code can forge parentPort messages; the worker trusts host replies. @module @deepseek-ai/dsh-code-runtime-worker-th...。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：JSON 边界
  • 这个文件有什么用：它检查或转换运行时、工作线程的可安全序列化 JSON 数据，阻止不可重放的对象穿过协议和持久化边界。
  • 为什么这样设计：协议和日志只接受可重放的 JSON 数据，把检查放在边界可以阻止函数、循环对象或带原型对象混入持久化事实。
  • 文件级设计证据：源码顶部注释把它定位为“Lossless-JSON snapshots for the dependency-free source worker closure. @module @deepseek-ai/dsh-code-runtime-worker-thread/worker-json”；固定提交中扫描到的声明包括 snapshotCodeJsonValue、WorkerJsonWire、encodeWorkerJson、decodeWorkerJson、dataDescriptor；本地静态 import 图显示它直接依赖 1 个源文件，并被 6 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime/src/index.ts、packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts
  • 对应测试：packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts、packages/code-runtime/code-runtime-worker-thread/tests/source-worker.compat.spec.ts、packages/code-runtime/code-runtime-worker-thread/tests/worker-json.spec.ts
  • 测试关联依据：固定提交源码中的本地静态 import 直接引用；测试用例直接导入了这个源文件。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md、入口和消费者，再读当前契约，沿着 packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts 看它怎样约束运行时，最后对照 packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts、packages/code-runtime/code-runtime-worker-thread/tests/source-worker.compat.spec.ts、packages/code-runtime/code-runtime-worker-thread/tests/worker-json.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 420 行；扫描到的声明包括 snapshotCodeJsonValue、WorkerJsonWire、encodeWorkerJson、decodeWorkerJson、dataDescriptor、defineEnumerableDataProperty、append、takeLast；源码顶部原注释（英文，仅作回查线索）：Lossless-JSON snapshots for the dependency-free source worker closure. @module @deepseek-ai/dsh-code-runtime-worker-thread/worker-json。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/src/worker.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：进程或线程边界
  • 这个文件有什么用：它把运行时、工作线程的工作放进独立进程、线程或 worker 中，隔离资源、取消和崩溃影响，也方便替换执行后端。
  • 为什么这样设计：固定提交的文件顶部注释把它定位为“Spawn-only worker entrypoint over runWorkerMain. Executable logic stays in bootstrap.ts for in-process coverage; real-worker tests cover this glue. @module @deepseek-ai/dsh-code-runtime-worker-thread/src/worker”；把这项职责单独放置，可以让边界、输入和失败处理在一个地方被阅读和测试。
  • 文件级设计证据：源码顶部注释把它定位为“Spawn-only worker entrypoint over runWorkerMain. Executable logic stays in bootstrap.ts for in-process coverage; real-worker tests cover this glue. @module @deepseek-ai/dsh-code-runtime-worker-thread/src/worker”；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts
  • 对应测试：packages/code-runtime/code-runtime-worker-thread/tests/source-worker.compat.spec.ts、packages/code-runtime/code-runtime-worker-thread/tests/worker-json.spec.ts
  • 测试关联依据：按同包文件名保守推断，未确认直接 import；这不是完整覆盖证明。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md 和入口，再读当前实现，沿着 packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts 和所在包的入口或服务确认输入输出，最后对照 packages/code-runtime/code-runtime-worker-thread/tests/source-worker.compat.spec.ts、packages/code-runtime/code-runtime-worker-thread/tests/worker-json.spec.ts。
  • 代码证据：固定提交归档实际读取结果：约 14 行；源码顶部原注释（英文，仅作回查线索）：Spawn-only worker entrypoint over runWorkerMain. Executable logic stays in bootstrap.ts for in-process coverage; real-worker tests cover this glue. @module @deepseek-ai/dsh-code-runtime-worker-thread/src/worker。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/tests/bootstrap.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时、工作线程、启动的具体场景，包括“LogBuffer”、“streams entries to the sink until the byte budget, then emits one fitting prefix and re...”、“makeConsoleShim”、“captures the five methods and renders non-strings inspect-style”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“LogBuffer”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 FakePort、fakeStreams、rejectionOf、toolNamespace、Exotic；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-worker-thread/src/bootstrap.ts、packages/code-runtime/code-runtime-worker-thread/src/protocol.ts、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 444 行；扫描到的声明包括 FakePort、fakeStreams、rejectionOf、toolNamespace、Exotic；扫描到的测试主题包括 “LogBuffer”、“streams entries to the sink until the byte budget, then emits one fitting prefix and reports the limit once”、“makeConsoleShim”、“captures the five methods and renders non-strings inspect-style”、“captureStreamWrites”、“redirects writes into the buffer and restores on request”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/tests/built-lib.e2e.ts ​

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

packages/code-runtime/code-runtime-worker-thread/tests/output-json.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时、工作线程的具体场景，包括“truncateJsonStringBytes”、“returns a fitting string whole and rejects budgets without JSON quotes”、“accounts every JSON escape and cuts only between complete code points”、“bounds hostile strings without materializing their complete escaped form”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“truncateJsonStringBytes”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/output-json.ts、packages/code-runtime/code-runtime/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-worker-thread/src/output-json.ts、packages/code-runtime/code-runtime/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 109 行；扫描到的测试主题包括 “truncateJsonStringBytes”、“returns a fitting string whole and rejects budgets without JSON quotes”、“accounts every JSON escape and cuts only between complete code points”、“bounds hostile strings without materializing their complete escaped form”、“jsonValueBytesUpTo”、“matches JSON serialization for every lossless value branch and stops at the cap”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/tests/runtime.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时、工作线程的具体场景，包括“WorkerThreadCodeRuntime — programs and bindings (real workers)”、“registers with the seam descriptors”、“runs TypeScript (erasable syntax), captures output in order, returns the value”、“bridges binding calls both ways and rejects the program-side call on a host rejection”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“WorkerThreadCodeRuntime — programs and bindings (real workers)”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 setup、tools；本地静态 import 图显示它直接依赖 3 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-worker-thread/src/index.ts、packages/code-runtime/code-runtime/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 893 行；扫描到的声明包括 setup、tools；扫描到的测试主题包括 “WorkerThreadCodeRuntime — programs and bindings (real workers)”、“registers with the seam descriptors”、“runs TypeScript (erasable syntax), captures output in order, returns the value”、“bridges binding calls both ways and rejects the program-side call on a host rejection”、“materializes a typed rejection from a generic namespace descriptor”、“bridges a deeply nested lossless JSON argument, resolution, and completion”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/tests/source-worker.compat.spec.ts ​

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

packages/code-runtime/code-runtime-worker-thread/tests/worker-json.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时、工作线程的具体场景，包括“snapshotCodeJsonValue”、“matches the canonical scalar boundary”、“detaches dense arrays and plain or null-prototype records”、“accepts intrinsic plain containers from another JavaScript realm”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“snapshotCodeJsonValue”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 ExoticObject、ExoticArray；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md、packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts、packages/core/session/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime-worker-thread/src/worker-json.ts、packages/core/session/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 257 行；扫描到的声明包括 ExoticObject、ExoticArray；扫描到的测试主题包括 “snapshotCodeJsonValue”、“matches the canonical scalar boundary”、“detaches dense arrays and plain or null-prototype records”、“accepts intrinsic plain containers from another JavaScript realm”、“reads each accepted slot once and preserves a literal proto key”、“accepts deeply nested valid JSON without using the JavaScript call stack”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime-worker-thread/tsdown.config.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：构建或测试配置
  • 这个文件有什么用：它告诉工具链怎样处理运行时、工作线程：从哪里开始、使用哪个环境、解析哪些依赖以及输出什么产物；这些规则集中后，构建和测试才可重复。
  • 为什么这样设计：工具链配置独立于业务实现，构建、测试和发布可以复用同一套入口规则；改配置时也能单独看出运行环境变化。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 0 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime-worker-thread/README.md
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读 packages/code-runtime/code-runtime-worker-thread/README.md，再读本配置/脚本，沿着所在包的入口或服务确认它如何影响入口和产物，最后对照对应 gate 或快照测试。
  • 代码证据：固定提交归档实际读取结果：约 29 行。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime/src/index.ts ​

packages/code-runtime/code-runtime/src/invariant.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：运行时不变量
  • 这个文件有什么用：它检查运行时必须始终成立的条件，在错误刚出现时报告，而不是等到更深层才出现难以解释的结果。
  • 为什么这样设计：把不变量集中在一个位置，调用者和测试就能用同一条规则检查状态；错误在边界处报告，比在后续 UI 或网络请求中才暴露更容易修复。
  • 文件级设计证据：源码顶部注释把它定位为“Package-owned invariant companion for @deepseek-ai/dsh-code-runtime. @module @deepseek-ai/dsh-code-runtime/invariant”；固定提交中扫描到的声明包括 name、inject、apply；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime/README.md、packages/runtime-diagnostics/invariants/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：没有确认到直接测试；公共入口可能仍有间接覆盖。
  • 测试关联依据：固定提交中没有找到直接或传递的本地静态 import，也没有找到明显的同包同名测试；公共入口可能仍有间接覆盖。
  • 阅读顺序：先读相关类型和事件，再读当前状态或存储实现，沿着 packages/runtime-diagnostics/invariants/src/index.ts、vendor/cordis/src/index.ts 和所在包的入口或服务理解状态变化，最后对照同包中与它同名或覆盖相近场景的测试。
  • 代码证据：固定提交归档实际读取结果：约 30 行；扫描到的声明包括 name、inject、apply；源码顶部原注释（英文，仅作回查线索）：Package-owned invariant companion for @deepseek-ai/dsh-code-runtime. @module @deepseek-ai/dsh-code-runtime/invariant。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime/src/types.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：类型契约
  • 这个文件有什么用：它描述运行时中流转的数据长什么样、哪些字段必填以及各部分怎样关联，让不同模块先共享同一份约定。
  • 为什么这样设计：先把形状和规则集中声明，执行代码只负责使用已经检查过的数据；这样错误更早暴露，读代码时也有一张共同的地图。
  • 文件级设计证据：源码顶部注释把它定位为“Vocabulary types for the code-execution seam: what a caller hands a ../index.ts | CodeRuntime and what it gets back. Pure types — no runtime code lives here. @module @deepseek-ai/dsh-code-runtime/src/types”；固定提交中扫描到的声明包括 CodeBindingFunction、CodeJsonValue、CodeBindingErrorClass、CodeBindingNamespace、CodeRunRequest；本地静态 import 图显示它直接依赖 0 个源文件，并被 1 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime/README.md、packages/code-runtime/code-runtime/src/index.ts
  • 对应测试：间接测试线索（通过本地 import 链，非直接覆盖）：apps/cli/tests/memory-mcp-configs.spec.ts、apps/cli/tests/web-agent-presets.e2e.ts、apps/web/tests/agent-preset-selection.e2e.ts、apps/web/tests/plan-control-row.e2e.ts、apps/web/tests/shipped-composition.e2e.ts、apps/web/tests/sidebar-subagent-activity.e2e.ts
  • 测试关联依据：固定提交源码中的本地静态 import 传递引用；这些测试通过包入口或中间模块到达本文件，不等于本文件被直接覆盖。
  • 阅读顺序：先读 packages/code-runtime/code-runtime/README.md、入口和消费者，再读当前契约，沿着 packages/code-runtime/code-runtime/src/index.ts 看它怎样约束运行时，最后对照 apps/cli/tests/memory-mcp-configs.spec.ts、apps/cli/tests/web-agent-presets.e2e.ts、apps/web/tests/agent-preset-selection.e2e.ts。
  • 代码证据：固定提交归档实际读取结果：约 127 行；扫描到的声明包括 CodeBindingFunction、CodeJsonValue、CodeBindingErrorClass、CodeBindingNamespace、CodeRunRequest、CodeRunFailure、CodeRunResult；源码顶部原注释（英文，仅作回查线索）：Vocabulary types for the code-execution seam: what a caller hands a ../index.ts | CodeRuntime and what it gets back. Pure types — no runtime code lives here. @module @deepseek-ai/dsh-code-runtime/src/types。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime/tests/reserved.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时的具体场景，包括“seam-owned portable identifier exclusions”、“RESERVED_BINDING_GLOBALS covers each backend-owned slot”、“RESERVED_ERROR_MEMBERS covers the JS Error and Python exception-protocol members”、“DUNDER_MEMBER matches dunder-form names only”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“seam-owned portable identifier exclusions”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：本次固定提交归档没有扫描到顶部注释、顶层声明或专门的结构线索；本地静态 import 图显示它直接依赖 1 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime/README.md、packages/code-runtime/code-runtime/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 57 行；扫描到的测试主题包括 “seam-owned portable identifier exclusions”、“RESERVED_BINDING_GLOBALS covers each backend-owned slot”、“RESERVED_ERROR_MEMBERS covers the JS Error and Python exception-protocol members”、“DUNDER_MEMBER matches dunder-form names only”、“dict”、“init”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。

packages/code-runtime/code-runtime/tests/service.spec.ts ​

  • 所属层：packages/code-runtime：可复用的 Harness 功能包
  • 文件角色：测试用例
  • 这个文件有什么用：它用自动化测试检查运行时的具体场景，包括“CodeRuntime service seam”、“registers as ctx.codeRuntime and serves the abstract API”、“reports a failed run as an error field on a resolved result, never a rejection”、“reports a pre-aborted signal as an abort failure”；这些断言把“应该发生什么”变成可以重复运行的证据。
  • 为什么这样设计：把测试主题“CodeRuntime service seam”写成独立测试用例，读者可以从输入、触发动作和断言反推实现的不变量；不同回归问题也不会互相遮蔽。
  • 文件级设计证据：固定提交中扫描到的声明包括 StubRuntime、setup；本地静态 import 图显示它直接依赖 2 个源文件，并被 0 个源文件直接引用。
  • 直接协作者：packages/code-runtime/code-runtime/README.md、packages/code-runtime/code-runtime/src/index.ts、vendor/cordis/src/index.ts
  • 对应测试：本文件本身就是测试用例。
  • 测试关联依据：本文件本身就是测试用例，不把同目录的其他测试冒充成它的“对应测试”。
  • 阅读顺序：先看它直接导入的被测实现 packages/code-runtime/code-runtime/src/index.ts、vendor/cordis/src/index.ts，再读本文件的测试主题、输入和断言；最后对照测试支持和失败输出。
  • 代码证据：固定提交归档实际读取结果：约 88 行；扫描到的声明包括 StubRuntime、setup；扫描到的测试主题包括 “CodeRuntime service seam”、“registers as ctx.codeRuntime and serves the abstract API”、“reports a failed run as an error field on a resolved result, never a rejection”、“reports a pre-aborted signal as an abort failure”、“is removed from the context when the providing fiber disposes (HMR safety)”、“rejects a second implementation in the same context (duplicate service)”。
  • 固定版本：源码链接固定到官方提交 aa6c361a972c8369148dea7380bb5c21c24e07ec。