mirror of https://github.com/deepseek-ai/deepseek-harness.git synced 2026-08-30 04:40:37 +00:00

Files

T

Chinesezjc 8cf253a470 docs(code-runtime-python): sync README metering claim with code and note

Both README sides still described checkDoneValue as "one bounded traversal /
一次有界遍历" — the same overclaim already retracted in the code JSDoc and the
Agent Note. Reword both to match: the walk bounds only the incremental
allocation it adds (escaped-string copy, enqueued children, per-key stringify);
the frame's own width is parsed upstream and capped by the host's fd-3 receive
buffer, not re-bounded here. Re-record README.i18n.yaml.

2026-08-07 13:27:54 +08:00

3.7 KiB

Raw Blame History

@deepseek-ai/dsh-code-runtime-python

English | 中文

@deepseek-ai/dsh-code-runtime seam 的 CPython 子进程实现。与 @deepseek-ai/dsh-code-runtime-worker 配套；以全新的 python3 子进程取代 Node worker 线程，让模型代码从 TypeScript 换成 Python。

本包分多个 code-runtime-python PR 逐层搭建。本层交付 wire protocol；在其之上驱动 python3 -I 进程的 PythonCodeRuntime 实现随后落地。

Wire protocol

host 与 CPython 子进程在子进程的 fd 3 上交换一个无版本号的 JSON-lines 协议——每行一个 JSON 对象，让 stdout/stderr 空出给程序自己的输出。src/protocol.ts 是 host 侧；py/protocol.py 在 Python 侧镜像其帧词汇与共享的截断标记文本。

fd 3，而非 stdout —— Node 通过 stdio: ['pipe','pipe','pipe','pipe'] 按位置钉住通道；Python bootstrap 读取相同的 PROTOCOL_FD 常量。JSON-lines 帧。
host 把每个入站帧当作敌意输入 —— 模型代码对 fd 3 有完全访问权、可通过它发送任意内容，所以 validateChildFrame 在 host 读取前对每个帧做形状校验并重建：伪造的额外字段绝不随行，非数字的 call id 绝不会被回显进 reply，垃圾降为 undefined 被丢弃，而不是在 host 的 message handler 里抛错。Python 侧信任 host 回复（host 不受模型控制）。
lossless-JSON 穿越 —— 完成值与 binding 参数以精确 JSON 穿越。encodeJsonPlain 无递归地序列化一个 JSON.parse 产出的值，使低于字节预算的深层值能完整穿越，而不是死在 JSON.stringify 的栈限制上；checkDoneValue 在一次遍历中同时计量伪造完成值的字节长度与数字无损性，在它本会新增的增量工作之前就拒绝超预算 payload（转义串副本、入栈子节点、逐 key 的 JSON.stringify）——帧自身的宽度已被上游 JSON.parse 支付、由 host 的 fd-3 接收缓冲封顶，并非在此重新约束；hasUnsafeIntegerToken 读取原始帧文本，捕获 JSON.parse 会静默舍入的整数 token；hasNonLosslessNumber 拒绝无字节上限的 call.args 中的非有限数或负零。超出安全范围的整数型 double 通过 BigInt 数字序列化，穿越的是精确整数而非 String() 的舍入形式。
共享截断标记 —— logTruncationMarker(maxBytes) 在两侧产出逐字节一致的文本，使被截断的日志运行无论从哪侧触达上限都读起来一致。log 帧的 truncated 标志把子进程 ledger 自身的标记与程序输出区分开。

Model Experience

经由 dsh-tools 里的 Code Mode 间接生效：Code Mode 把本后端的精确完成值（放得下时）或一个明确的 invalid-output / output-limit 失败，连同精确的 [dsh-code-runtime-python] log capture truncated at <maxLogBytes> bytes 日志标记，渲染进一个保留的 run_code 结果。

KV Cache effect

无直接失效；具名消费者拥有任何请求前缀的变更。

Known Limitations and Deferred Work

跨语言 guard 只覆盖两个运行时执行的面 —— PROTOCOL_FD 与日志截断标记。py/protocol.py 中的 TypedDict 帧形状靠 review 而非自动化检查来镜像 src/protocol.ts：跨 TypeScript 与 Python 比较类型声明在此无机械等价物，故未来的形状漂移由 review 加后端真子进程套件捕获，而非本包的测试。
PythonCodeRuntime 实现与 Python 侧 JSON codec 不在本层 —— 它们在基于本分支的 backend-core PR 中交付；在那之前 src/index.ts 只 re-export 协议词汇。

3.7 KiB Raw Blame History Unescape Escape