Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

feat(exec): 程序化工具调用(run_code/PTC)——一次程序替代多轮工具往返(C 端低开销核心杠杆,借 DSH ptc-runtime)

未关闭
#134 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
20/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
javascript, rust
领域
ai, backend

调研方向

Read the proposed DSH reference points: packages/ptc-runtime/README.md, ptc-runtime-node/src/process.ts, ptc-runtime-node/src/index.ts, ptc-runtime/src/index.ts, output-ledger.ts, and bootstrap.ts. First inspect the repository’s tool registration and preset mechanism, including dependency #127; the issue does not name their files. Done means run_code supports batched tool calls, budget and invalid-binding tests pass, and benchmark #129 shows lower token use and wall time.

由索引模型根据 Issue 内容生成。

描述

场景 gap 单(okguitar 提报)· 优先级 P1 · 依赖:depends-on: #127 · 来源:DSH ptc-runtime 包借鉴(jeffkit 拍板跟进)

基线 HEAD = 4e1aee98。

Summary

C 端"高密度低开销"的核心杠杆缺失:recursive 无程序化工具调用——每次工具调用都是一个 ReAct step(一轮 LLM 往返 + KV 重算)。批量场景(>5 次同类调用 + 结果筛选/去重/统计/汇总)在 DSH 是一次 run_code 程序。

参照 DSH packages/ptc-runtime/(PTC=PTC 模式配套执行缝):

  • 模型写程序、工具当函数调:程序只回 stdout/返回值;一次运行替代多轮往返(packages/ptc-runtime/README.md:12)。
  • 执行契约:每次运行全新进程、process.env 置空字典、只保留可执行搜索/系统/临时路径(ptc-runtime-node/src/process.ts:26-30);三预算——超时 120s(上限 600s)/输出 64MiB/堆 512MiB(ptc-runtime-node/src/index.ts:55-61)。
  • 正交失败分类:exception / timeout / abort / worker-exit / invalid-output / output-limit / protocol / sandbox-unavailable——sandbox 事实与成败分开报告(README:129-130)。
  • 跨语言可移植绑定名:RESERVED_BINDING_GLOBALS + RESERVED_ERROR_MEMBERS + PORTABLE_RESERVED_WORDS(ECMAScript∪Python 保留字),绑定名非法在 run 前被拒——一份 bindings 列表对所有后端有效(ptc-runtime/src/index.ts:42-78)。
  • 输出账本有序截断:预算计入"序列化日志 + 完成值",超限返回 output-limit 并保留最大可容纳前缀(output-ledger.ts:24-64);console shim 只有 5 个方法(bootstrap.ts:98-115)。

建议

  1. run_code 工具:模型写程序(JS(或 Rust 之外选定语言))内以函数方式调用已注册工具,只回 stdout/返回值;
  2. 执行沙箱照 DSH 契约:全新进程 + 空环境 + 三预算 + 正交失败分类;
  3. 绑定名可移植性与 run 前校验;
  4. 以 preset 档位挂载(#127 的档位机制),默认关、按需开。

验收

  • 批量任务(≥5 次同类调用 + 结果聚合)改单次 run_code 后 token 与墙钟显著下降(由 benchmark #129 出数);
  • 三预算各有一条超限测试(超时/输出/堆)且失败分类正确;
  • 非法绑定名在 run 前被拒(不消耗一次执行)。
主要语言
Rust
星标
4
派生
0
平均合并
5 小时 32 分钟
30 天内合并 PR
7

环境准备

  • 提供 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

jeffkit/recursive 的其他 Issue

查看 jeffkit/recursive 的全部 Issue

相似的 Issue

更多 Rust Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。