Skip to content

[OPS-PTC P6] 给分页和可恢复读取错误提供可执行的下一步 #984

Closed

Description

@Thatgfsj

P6 · 给分页和可恢复读取错误提供可执行的下一步

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

问题:模型会把单次读取成功误认为整份文件完成。它也可能照目录错误的建议去调用本会话没有的搜索工具。

前置条件:依赖 P1 的工具可用性判据。

从哪里读

  • src/projections/ptc/
  • src/kernel/outcome.ts
  • test/ 中现有 PTC outcome/分页套件

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

按顺序执行

  1. 创建至少11行的 UTF-8 文件,按 limit=5 读取,记录外层 status、data.complete、nextOffset 及 per-file error。
  2. 为 partial、completed、目录输入、无效文本编码建立四种样例。构造下一步时保留路径,通过当前工具 schema 验证参数。
  3. 执行建议中的下一步并检查实际结果。没有可用目录浏览器时,直说需要具体文件路径;修改类效果未知时不生成自动重试。

验收清单

  • partial 且 nextOffset=6 时,下一次同路径 offset=6 从第6行开始;最后一页 complete=true 即停止,不要求再读空页。
  • 读二进制时可用 hex 才建议 view=hex;不要把 continuation 原样塞给不接受该参数的工具。

范围边界与停手条件:不改宿主重复计数阈值;不因 after-input-change 重试原样请求。

验证与交付

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

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

Activity

  1. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    984 / main@58f6e28 / 要改的文件:src/projections/ptc/next-step.ts(新增,纯函数下一步推荐器)、src/projections/ptc/outcome.ts、src/kernel/outcome.ts、src/projections/ptc/schema.ts、src/projections/ptc/contract.ts。接线扩大写域(先说明):src/projections/canonical-output.ts 与 src/projections/native/runtime.ts——共享文件 API 的最终派发在共享 runtime 里走 toOutcome,不经 publication 闭包,要按 P1 的本步可达集合判据给投影层传入 callable 集合与只读标记,必须接在这两处。测试:test/ptc-outcome.test.mjs、test/ptc-projection-worker.test.mjs、test/canonical-file-runtime.test.mjs。

    第一个失败样例(真实 worker 58f6e28,修改前实测):PTC 步 ops_inspect_local_file 指向目录 → status:"error", code:"INVALID_ARGUMENT", message:"inspect_local_file: path is a directory; choose a file, or list directory entries with the shell"——PTC 写域根本没有 shell,这是死指针;nextAction 只有 "Correct the request or inspect the manifest.",没有任何当前作用域可执行的恢复动作。同类实测:ERR_INVALID_ENCODING 只说 "or inspect with view=hex" 无参数化动作;REVISION_CONFLICT 只说 "Inspect the current revision" 不给出取新 expectedRevision 的具体读调用;partial 只有 opaque continuation,没有显式参数合法的下一步。

  2. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    完成(A 侧实现)。

    分支 card/p6-outcome-nextsteps(基于 main @ 58f6e28),PR #1019:#1019

    交付:src/projections/ptc/next-step.ts(新增纯函数推荐器)+ outcome.ts/schema.ts/contract.ts 集成 + kernel/outcome.ts partial 变体新增可选 nextAction;接线落在共享派发路径 canonical-output.ts + native/runtime.ts(按认领评论所述扩大写域),在派发时用宿主准入的工具集解析本步可达集合与只读标记。

    验收对照:

    • A) 11 行文件 limit=5 → partial+nextOffset=6,nextAction 给出同路径 offset=6 续读调用;complete=true 页无 nextAction 即停,实测 3 页读完 11 行(ptc-projection-worker 'paged reads follow the recommended next action to a complete stop')。
    • B) 目录被拒:无 surface 或本步无列举 API → 直说需要具体文件路径;有 ops_glob 可达 → 参数化 ops_glob {"path":...,"pattern":["*"]}(canonical-file-runtime 真宿主 toolSet 验证)。
    • C) 二进制:ERR_INVALID_ENCODING → ops_inspect_local_file {"path":...,"view":"hex"};read_files 项错误推荐跨工具 hex 读取,且不把 continuation 原样塞给不接受 view 的工具。
    • D) after-input-change:仅在 worker 无指引时给出「原样请求必然同样失败」文案;不诱导原样重试。
    • E) 只读作用域:推荐器结构上只可能输出读类 API;readOnly surface 额外抑制「重新提交」子句;测试对全部写类名扫描为零命中。

    红绿记录:先提交失败断言(24f0111)——ptc-outcome 5/17、ptc-projection-worker 2/9、canonical-file-runtime 1/2 失败;实现(d78a387)后三套件 17/9/2 全绿,相邻回归 20+ 套件通过;文档(a1b4a9b)中英文 + CHANGELOG 同步。定向验证用 runtime/linux-x64/dsh-ops-worker(2b5f988d…);npm run build 与 npm run check:size(822 文件全部 ≤1000 行)通过。

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