Repository navigation
Description
更新目标
在 OPS-PTC 中用更少的提示完成同样的任务。模型看到一个工具时,要知道本步能否调用。出错时,给出当前权限下能执行的下一步。比较依据是相同任务的完成率、纠错后的动作、首轮与全程输入。Native、第三方 MCP 和宿主全局调度另行跟踪。
从哪里开始
审计基准为 main@58f6e281,宿主 DSH 0.2.2-rc.1。认领时记录当前提交、宿主版本、平台、权限及实际 preset。先读 PTC 发布路径、教学正文。顶层工具是 run_code,嵌套工具的签名位于系统段 tools:sdk。首次教学和后续提醒会影响消息历史,须另计。
工程入口
- [设计] OPS-PTC 支持按需加载与首轮全量直出 #979 — 两档披露,D1–D5。
- [验收] 建立 OPS-PTC 工具可调用性、提示成本与 Flash 恢复率基线 #980 — 可调用性与成本验收,V1–V5。
- [调查分流] OPS-PTC 调研发现的 Native、Shell 与宿主问题 #981 — 独立的旁支调查索引。
推荐首批并行认领:D1 锁定旧配置和两档语义,V1 固定测试环境。先在相应 Issue 评论“认领编号 / 修改文件 / 一个失败用例”。已有 PR 对应的切片先联系原作者,避免重复开发。
PR 描述模板:关联 Issue 和切片编号 → 复现输入与修改前结果 → 改动文件与新行为 → 局部测试命令及通过/跳过/失败数 → 撤回改动后哪条断言会失败。多切片共用一个 Issue 时,在最后一片通过前使用 Refs #编号,避免提前关闭整张议题。
现有问题及未来 PR 认领卡
表中每行只交付一个行为。先看关联的开放 PR,已有实现就在原讨论里补验收。下列文件是写域起点,若需增加文件,先在所认领的 Issue 补全范围。按表中依赖串行修改共享文件。
| 切片与归属 | 开始位置 / 前置 | 只做这一件事 | 验收与反例 |
|---|---|---|---|
| P1 教学按可用工具生成 · #922 / #930 | src/ptc/batching-guidance.ts、test/batching-guidance.test.mjs | 根据本步的 loader、resident、loadable 集合渲染教学 | 无 loader 的整条教学和纠偏中查不到加载指令。窄池、只读、全池各保留一个样例 |
| P2 精简教学正文 · 本总单,接 P1 | prompts/batching-guidance.md、src/ptc/batching-guidance.ts、test/batching-examples.test.mjs | 删重复散文和反例示范,保留四条可实际执行的轨迹;提升 revision 并更新双语文档 | 重算 trim 后 UTF-8 字节;保留“只加载缺失项”“模式切换后重查 SDK”、下一程序生效、分页游标及部分失败。示例真实执行,禁止为省字删除参数和权限契约 |
| P3 文件工具可见性 · #960 / #961 | src/publication/replacements.ts、src/publication/ptc.ts、PR 的 ptc-hide-official 测试 | 仅逐项处理 read/glob/grep。替代已可用,或确有可执行的加载路径时才隐藏 | 替代不可达保留官方入口;自定义 preset 默认保留;write/edit/read_image 保留。符号链接、ignore、分页和 CAS 差异在文档可查 |
| P4 清理已隐藏工具的指引 · 接 P3 | src/publication/ptc.ts、PTC 装配测试 | 检查真实工具提供方注册的 tool:* 段,消除指向已隐藏名字的建议 | 同一步捕获 SDK、提示和程序绑定。隐藏后不能出现“Use the read tool”之类的死指针;官方入口恢复时,其适用说明也恢复。仅使用受支持的作用域扩展点 |
| P5 修加载与授权反馈 · #968 / #888 | src/publication/ptc.ts、src/publication/registrar.ts、test/ptc-declaration-surface.test.mjs | 对齐注册、声明及执行判断;把“可加载但本步未加载”和“当前权限禁止”分开 | 一个未加载名称不能在当前可调用表冒充已加载;存在 loader 才给加载建议。无 toolSet 的诊断装配另列;保留 Native 子作用域 shadow 回归 |
| P6 分页及错误下一步 · 本总单,接 P1 | src/projections/ptc/、对应 PTC Outcome 测试 | 根据外层状态和当前能力推荐一个参数合法的动作 | 前5行返回 partial、nextOffset=6 时,继续原路径 offset=6;目录输入不推荐不存在的 glob/grep;二进制输入可用 hex 时给出参数;after-input-change 不诱导原样重试 |
| P7 避免重复教学和漏教 · #929 | src/publication/ptc.ts、src/prompt-injection/index.ts、test/prompt-injection.test.mjs | 用隔离会话区分本次新增、历史重放和上下文压缩 | 恢复且同版教学仍可见时新增0条;压缩移除后按需补短提示;撤回的批次不消耗教学机会。先复现再选通道,不能将无限循环归因于 step-tail |
| P8 等待与批处理提醒 · #893 / #938 | src/ptc/batching-guidance.ts、test/batching-trigger.test.mjs | 修正等待、多个依赖调用被当作单操作 | 正常等待、循环翻页、有依赖多派发均设反例;真正的薄单调用仍可识别。与 P1/P2 改同文件,按合入顺序更新 |
已测量的边界
- 固定提交的隔离 prompt-budget fixture,在挂载 OPS 前后为 5,743 → 12,782 B(+7,039 B),外层 run_code 声明增量为 0。此项未计历史教学。
- 首次教学候选为 8,645 → 7,234 B(−1,411 B,16.32%)。两条契约需要恢复,发布稿须重新计量。这个百分比仅对应正文。
- fix(ptc): hide replaced official file tools under PTC presets #961 head 的 Linux 真实官方 schema fixture 中,三项都可替代时 SDK 12,467 → 10,456 B(−2,011 B);只剩读取替代时差 565 B。隐藏后的三段官方指引正文还有 338 B。字节不能换算为已实现的 token、费用或任务成功率收益。
接手和关闭规则
先认领一行并注明依赖、文件、失败样例及预期;一项一 PR,建议控制在几百行以内,遵守仓库 1000 行门槛。复用已有 PR。每个行为 PR 随带能检测回退的断言、相应中英文文档和 Unreleased 记录。局部套件写实际 pass/skip/fail,构建阶段再跑完整 gate。共享代码若影响 Native,需要同配置对照。总单待两张工程子单及上表逐项通过或记录维护者明确延期理由后关闭。
Activity
Thatgfsj commentedon Nov 18, 2026
独立认领入口
18 张卡均已独立建单。一行一卡,链接直达问题、文件范围、步骤与验收;括号内为议题号。
Thatgfsj commentedon Nov 20, 2026
18/18 张卡已随统一 PR #1033 合入 main(c70633da),本单的优化目标与执行顺序已完成;各卡 issue 已逐张关闭,并集验收见 #1033 描述与
docs/CHANGELOG.md。若 0.5.x 需要新一轮优化,请新开单。