Skip to content

[OPS-PTC P1] 按当前工具集合渲染教学与纠偏 #995

Closed

Description

@Thatgfsj

P1 · 按当前工具集合渲染教学与纠偏

总计划 #978,所属工作流 #978。

问题:同一份教学被发送给不同工具配置。模型如果看到一个不存在的加载入口,就会耗费一轮才发现根本不能执行。

前置条件:可立即协调 #930 作者。

从哪里读

  • src/ptc/batching-guidance.ts
  • test/batching-guidance.test.mjs

认领前记录当前 main SHA。以上为优先检查的范围,需要扩大写域时先说明文件与原因。

按顺序执行

  1. 构造三种作用域:loader 开且允许 grep、loader 关仅 inspect、只读且无写权限。保留原始工具名集合和渲染正文。
  2. 分别检查首轮教学和后续 bypass 提醒中的工具引用。区分“本步直接调用”与“先请求加载、下一程序调用”。
  3. 优先在 fix(ptc): teach only the tool surface a scope publishes #930 上补缺失用例和中英文说明;如分支已合,先在最新 main 重跑相同用例。

验收清单

  • loader 关时,输入目录的引导不能出现调用 ops_load_sdk 的代码;若只能 inspect,必须说明需要具体文件路径。
  • loader 开且 grep 可加载时,给出先 load 再调用的顺序;窄池里不能推荐未获准的写工具。

范围边界与停手条件:不得为让文字看似正确而扩大 allowedTools;不改错误对象或 SDK 注册。

验证与交付

先运行 npm run build;依赖 native worker 的测试先运行 npm run build:ptc。定向入口:node test/run.mjs batching-guidance。确认过滤器命中目标套件,记录实际 pass / skip / fail。

认领模板:编号 / 当前 SHA / 目标文件 / 第一个失败样例。提交时贴修改前与修改后结果,以及撤掉改动后会失败的断言。已有 PR 请先在原讨论协作。行为及中英文文档同 PR。


原问题讨论:#922。本单与其指向同一交付,评论处保留原始复现记录。

Activity

  1. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    995 / main@58f6e28 / src/ptc/batching-guidance.ts、test/batching-guidance.test.mjs、test/batching-trigger.test.mjs、test/resident-switch.test.mjs、docs/configuration-reference.md、docs/配置参考.md、docs/CHANGELOG.md / 第一个失败样例:dynamicTools: false 且常驻面仅有 ops_inspect_local_file 时,替换后的教学 Step 3 只列出 API 名,整段渲染正文查不到「目录被拒绝、需要具体文件路径」的说明(#995 验收第 1 条后半句明确要求「若只能 inspect,必须说明需要具体文件路径」)。

    按本卡要求,优先在 PR #930 分支(fix-batching-guidance-unpublished@995d753)上补缺失用例与中英文说明,不重复实现:已逐条核验 #930 覆盖——无 loader 路径的教学/纠偏断言、窄池与只读的提醒断言均已存在且本地实测全绿(batching 4 套件 20+17+8+5 全过,resident-switch 26 检查全过)。待补缺口:上述 inspect 路径说明(行为+用例)、窄池 bypass load 行的「下一程序生效」顺序表述(#995 验收第 2 条前半句的窄池对应)、只读作用域 loader 关场景的教学端到端用例、以及对应的中英文档与 CHANGELOG。写域在卡内声明文件之外新增 test/batching-trigger.test.mjs 与 test/resident-switch.test.mjs(#930 已改的相邻套件,缺口断言按类别落位)与双语文档(卡的「验证与交付」节要求行为与中英文档同 PR)。只在 #930 分支追加 commit,不改写作者历史。

  2. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    P1 补验收完成(在 PR #930 上追加,未重复实现)

    Refs #930(https://github.com/T-Auto/dsh-ops/pull/930)。按本卡「优先在 #930 上补缺失用例与中英文说明」执行:先在 PR head(995d753)逐项核验 #930 已有覆盖并本地实测全绿(batching 4 套件 20+17+8+5、resident-switch 26 全过),确认缺口后只在 #930 分支追加新 commit,未改写作者任何已推送提交。PR head 已 fast-forward 到 72bd6d9。

    追加的 commit 与目的

    • c7e5e34 fix(ptc): state exact paths and load order on narrow surfaces —— 补验收第 1 条后半句:dynamicTools: false 且仅发布 ops_inspect_local_file 时,直调一节新增其契约说明(按精确路径读单文件、目录被拒绝、未发布 ops_glob/ops_grep 无从列目录或搜索、做文件工作需要具体路径);同时给窄池 bypass 的 load 行补上「for the next program」顺序表述(验收第 2 条前半句的窄池对应)。含渲染级红/绿断言、双语配置参考与 CHANGELOG 条目。
    • 72bd6d9 test(ptc): pin the read-only loader-less lesson and notice live —— 补「窄池里不能推荐未获准的写工具」的 loader 关端到端用例:alwaysLoaded: ['edit_file'] + 只读会话时,直调列表与 bypass 提醒都不点名 ops_edit_file(read-only 过滤若被移除即红);可写对照用例钉住过滤按策略而非无条件(若改成无条件即红);live loader-less 行同时断言新增的路径说明。

    红→绿记录(如实)

    • Gap A(inspect 路径说明):先写断言跑红 —— batching-guidance 1 of 19 check(s) failed("the directory rejection is stated");resident-switch 1 of 26 check(s) failed(live 行 "the inspect path requirement is taught")。实现 exactPathNote 并重建后变绿:19/19、26/26。
    • Gap B(窄池 load 顺序):先写断言跑红 —— batching-trigger 1 of 21 check(s) failed("the load lands before the call")。实现后变绿:21/21。
    • 只读 loader-less 双向用例:即刻绿(钉住 fix(ptc): teach only the tool surface a scope publishes #930 已有的 surfaceFor 行为,属补缺失用例,非新行为)。

    定向验证(npm run build 后;worker 用本 worktree staged runtime/linux-x64,sha256 2b5f988d…,node bin/native-runtime.mjs check --staged 通过;所有套件 0 skip)

    • DSH_OPS_WORKER_BIN=$PWD/runtime/linux-x64/dsh-ops-worker node test/run.mjs batching:4 套件全过 —— batching-trigger 21 / batching-guidance 19 / file-batching-worker 8 / batching-examples 5。
    • 同前缀 node test/run.mjs resident-switch:28/28。
    • 同前缀 node test/run.mjs modes:modes 12/12。该过滤顺带命中 release-tar-modes:其在本机直接运行时因定位不到 npm bundled tar 在模块加载即失败,stash 掉本卡全部改动后同样失败——预先存在的环境问题,与本卡无关,CI 为该 gate 步骤的基准。
    • node test/run.mjs docs-facts 与 node test/run.mjs install-channel:通过(CHANGELOG/文档结构断言不受影响)。
    • npm run check:size:822 个代码文件全部 ≤1000 行。

    中英文档与 CHANGELOG

    • docs/configuration-reference.md 与 docs/配置参考.md 成对更新:inspect-only 契约、窄池 load 句顺序、以及只读策略边界(只收窄作用域自己拼出的列表,不改写随包轨迹——原 PR 只声明了窄池的对应取舍)。
    • docs/CHANGELOG.md ## [Unreleased] 新增中英一对条目(沿用现有「英文在前、中文随后」格式)。

    边界与未跑项

  3. Thatgfsj commented on Nov 20, 2026

    @Thatgfsj
    CollaboratorAuthor

    已由 #1033 合入 main 交付(18 张卡并集,见 PR 描述与 docs/CHANGELOG.md 的 Unreleased 条目)。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions