mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-09-06 07:11:59 +00:00
Chinesezjc
2504d0a501
The review's move-follow-ups: the Windows test exclude now points at packages/experimental/code-runtime-python (the constructor throws by design on Windows, so the suite must stay excluded); the invariant companion and @module annotations use the new npm name; the truncation marker text and tmpdir prefix stay as-is (tests anchor them); the package JSDoc and READMEs no longer call the private experimental backend 'published'/'shipped'; the code-runtime README row describes the package as protocol AND runtime; the fd-3 note records the package's experimental location.
2.4 KiB
2.4 KiB
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 |
experimental/code-runtime-python/ |
实验性 Python 后端：持有 Node host 与 CPython 子进程之间的 fd-3 协议格式与 CPython 运行时实现 | — |
相关文档
先从子系统参考了解服务约定，再看消费此能力的 PTC mode 设计，以及它所遵循的能力 seam 模型。
- 代码运行时子系统参考——请求／结果词汇、绑定与
ctx.codeRuntime的 cordis 接口面。 - PTC mode Agent Note——工具注册表如何把
run_code呈现给模型。 - 能力 seam——本家族遵循的 Service Definition / Service Provider / Consumer 拆分。
开发备注
维护者的工作上下文——点击展开
无。