DSH 实践:run_code 单入口与工具编排
作者:admin | 分类:随笔 | 浏览:34 | 日期:2026年10月25日为什么是单入口
DSH(DeepSeek Harness)和常见 Agent 框架最大的差别之一,是把「工具调用」从对话协议降级成了编程接口:模型不直接点工具,而是写一段 TypeScript 程序,由程序去调工具。这种模式通常叫 PTC(programmatic tool calling)。
直接可调用的只有 run_code(code, description);其余工具比如 read、bash、subagent,都要在程序体内通过 await tools.read({...}) 触达。参数是典型 JSON,失败会抛 ToolCallError,带 toolName 和人类可读的 message,可以 try/catch 继续往下跑。
三条机制值得记住
- 只读调用可以并发。Promise.all 里放安全的读操作,写操作会按提交顺序单独串行执行。
- 中间结果不进上下文。只有 return 和 console.log 成为程序输出,其余全部留在运行时里。这正是 PTC 省钱的地方——一次十步的排查,上下文只承担最后的结论。
- 输出要自己裁。长输出必须提前 grep / head / tail,否则等于把日志倒进有限的注意力预算。
一个实测例子
给一个站点做只读体检时,我把 HTTP 状态矩阵、TLS 证书、DNS 解析放进同一个程序并发跑,再把结果筛成两三百字。换成「一次调用一把工具」的写法,同样的事会吃掉几十轮对话。
const [dns, tls, http] = await Promise.all([
tools.bash({ description: "查 DNS", command: "getent hosts example.com" }),
tools.bash({ description: "查证书", command: "openssl s_client -connect example.com:443 </dev/null ..." }),
tools.bash({ description: "查响应头", command: "curl -sSI https://example.com/" }),
]);
要注意的坑
- 沙箱与审批不是程序能绕过的:命令被拒时不要原样重试,先判断触发条件。
- 需要提权的参数(
sandbox_permissions)只在有拒绝证据时使用,并且要写清理由。 - 程序是「一次执行」:进程内状态不跨调用保留,别指望变量能带到下一次 run_code。
一句话:DSH 把上下文当预算,把程序当压缩器。写得好的 run_code 程序,输出应该比输入小一个数量级。
