deepseek-harness/packages/code-runtime/README.zh.md

description, kind

description	kind
代码执行能力族的包映射：程序执行能为你做什么，以及每个部分由哪个包负责。	package-group

code-runtime/——代码执行能力族

English | 中文

概述

code-runtime/ 组提供程序执行能力：模型编写一个程序，把宿主提供的函数当作普通异步调用，运行时在隔离环境中执行它，只返回程序打印和返回的内容。一个包定义共享能力（ctx.codeRuntime），第二个包在全新的 Node Worker 线程中执行 TypeScript 程序，第三个包持有 Node host 与 CPython 子进程之间的 fd-3 协议格式（wire protocol），为 Python 后端服务。每次运行彼此独立——程序之间不保留任何状态——失败也会作为结果的一部分返回，调用方因此能知道程序为何失败，并把它反馈给模型。

目录

• 包
• 相关文档
• 开发备注

---

包

这三个包共同提供程序执行能力；每个 README 描述其各自部分做什么。

包	角色	ctx 键
code-runtime/	定义代码运行时做什么：针对宿主提供的绑定运行一个程序，并报告其打印和返回的内容	ctx.codeRuntime
code-runtime-worker-thread/	在全新的 Node Worker 线程中执行 TypeScript 程序	注册 ctx.codeRuntime
code-runtime-python/	持有 Node host 与 CPython 子进程之间的 fd-3 协议格式，即 Python 后端的协议层	—

---

相关文档

先从子系统参考了解服务约定，再看消费此能力的 Code Mode 设计，以及它所遵循的能力 seam 模型。

• 代码运行时子系统参考——请求／结果词汇、绑定与 ctx.codeRuntime 的 cordis 接口面。
• Code Mode Agent Note——工具注册表如何把 run_code 呈现给模型。
• 能力 seam——本家族遵循的 Service Definition / Service Provider / Consumer 拆分。

开发备注

维护者的工作上下文——点击展开

无。