Skip to content

[汇总] OPS-PTC 优化总索引:目标、基线、18 张任务卡与执行顺序 #1000

Closed

Description

@Thatgfsj

本单的用途

这张单是 OPS-PTC 优化工作的总索引与口径说明,不承载实现。所有讨论、认领和交付仍在各子单进行;本单只负责三件事:给出全部 18 张卡的直达链接、统一验收与测量口径、标明依赖与推荐批次。

主线议题:#978 总计划 · #979 两档披露 · #980 验收与成本 · #981 非 PTC 旁支。

目标

以 OPS-PTC 为唯一改造对象,让模型少看无用的工具声明、看到就能调用、出错时收到当前权限下可执行的下一步,并保持同权限下的任务能力不变。最终用同一组任务的完成率和全程输入衡量,而不是只看首轮字节。

dynamicTools:false 在审计基准上表示“没有加载器,只剩常驻工具”,不是全量直出。因此“关闭渐进披露即全量可用”必须作为显式选择新增,不能改变旧配置的含义。

审计基线(2026-11-19)

代码基准为远端 main 的 58f6e281,宿主 DSH 0.2.2-rc.1。以下均为 UTF-8 字节,口径不同不可互减或相加:

测量对象 实测 正确读法
挂载 OPS 后的常驻装配 5,743 → 12,782 B(+7,039),外层 wire 1,810 B 不变 只含常驻装配,不含首次教学;0.5.3/0.5.4 线上为 +7,050,11 B 来自 inspect 描述
首次教学候选 8,645 → 7,234 B(−1,411,16.32%) 仅正文;候选需补回“只加载缺失 API”“切换模式后重查 SDK”两条规则
官方 read/glob/grep 声明 SDK 12,467 → 10,456 B(−2,011);另 338 B 指引仍指向它们 来自 #961 head 的真实官方 schema fixture,是毛声明量,不是净节省
披露两档隔离对照 按需首轮 9,232 B;加载 glob+grep 后 27,588 B;无 loader 全量 116,076 B 同一 fixture 内可比;任务实际加载越多,首轮优势越小

任何“省了多少 token / 成功率提升多少”都不能从这些数字直接推出。 需要 V5 的真实模型对照,且必须报告分母与超时。

18 张任务卡

P 组 · 提示、路由与恢复(工作流 #978)

卡 议题 依赖
P1 #995 按当前工具集合渲染教学与纠偏 无,可先与 D1/V1 并行
P2 #982 精简首轮教学并保留四条可执行示例 P1 定文案边界;与 #868/#869 协调
P3 #996 逐项验证官方文件工具的替代和回退 先联系 #961 作者,在其分支核验
P4 #983 清除指向已隐藏官方文件工具的系统指引 P3 的隐藏路径
P5 #997 区分未加载、已撤销及禁止调用的工具 与 D3 串行改发布文件
P6 #984 给分页和可恢复读取错误提供可执行的下一步 P1 的工具可用性判据
P7 #998 区分恢复后的重复教学与压缩后的漏教 与 P1/P2 协调教学 revision
P8 #999 验证等待、依赖派发和正常翻页的误报 #938 现有 PR

D 组 · 两档披露(工作流 #979)

卡 议题 依赖
D1 #985 锁定旧配置行为与两档产品真值表 无,第一批
D2 #986 解析显式披露策略并保留旧配置 D1
D3 #987 按配置在内置 OPS-PTC 实际发布工具 D1、D2;与 P5 串行
D4 #988 对齐自定义 PTC 接入与诊断结果 D3
D5 #989 让用户能选择两档并验证设置往返 D3、D4、P1

V 组 · 验收与成本(工作流 #980)

卡 议题 依赖
V1 #990 建立真正进入 OPS-PTC 的隔离测试入口 无,第一批
V2 #991 分账测量系统提示、SDK、wire 及历史消息 V1
V3 #992 把两档工具发布规则变成数据驱动验收矩阵 V1;功能验收需 D3
V4 #993 编写分页、目录、加载、等待四种任务及判定器 V1
V5 #994 执行 Flash 小规模对照并报告完整分母 V1–V4 及待测实现

依赖与推荐批次

graph LR
  D1 --> D2 --> D3 --> D4 --> D5
  V1 --> V2
  V1 --> V3
  V1 --> V4 --> V5
  P1 --> P2
  P1 --> P6
  P3 --> P4
  D3 --> V3
  P1 --> D5
Loading
批次 可并行认领 说明
第一批 D1、V1 一个锁定两档语义,一个保证测试真的跑在 OPS-PTC;互不依赖
第二批 D2、V2、P1、P8 开始有实现与测量;P8 在 #938 上补覆盖
第三批 D3、P2、V3、P3 发布逻辑、教学精简、矩阵、官方工具;D3 与 P5 共享文件需串行
第四批 D4、P6、P5、P4 接入诊断、分页纠偏、声明/准入、清理失效指引
第五批 D5、P7、V4、V5 设置入口、会话恢复、任务判定器、真实模型对照

同文件冲突优先串行:P1/P2/P8 都动教学;D3/P5/P3 都动发布路径;V2/V3 复用同一 fixture。已有 PR(#930、#938、#961)覆盖的部分先协作,不重复实现。

认领与交付规则

认领时在该卡下单条评论:编号 / 当前 main SHA / 要改的文件 / 第一个失败样例。一个 PR 对应一个行为,建议几百行,仓库硬上限为 1000 行。

PR 描述需要包含:修改前的实际输出、修改后的实际输出、撤回本次改动会失败的断言、定向测试命令与 pass/skip/fail 计数。未命中目标套件或依赖 worker 被 skip 不算通过。行为变更同 PR 更新中英文文档和 docs/CHANGELOG.md 的 Unreleased 条目。

测试入口:npm run build(依赖 native worker 时先 npm run build:ptc),定向跑 node test/run.mjs <filter>;构建阶段再跑 node scripts/verify-gate.mjs --skip-install。

统一验收口径

  • 同一权限下,按需档加载完毕的业务工具集合必须等于全量档首轮集合(排除 loader 本身)。
  • 模型看到的 API 必须可在本步调用;未加载与无权限必须给出不同且可执行的提示,不能笼统报“授权失败”。
  • 官方工具只在 OPS 替代已注册且可调用时才隐藏,替代失效要保留官方回退;隐藏后不得留下指向它的系统指引。
  • 字节报告区分 system、其中的 SDK 子集、外层 wire、历史消息四本账,SDK 不能重复计入 system。
  • 成本结论必须给分母:计划会话、完成、超时、缺 usage 分别列出;只在噪声范围内的差异写“未能区分”。
  • 每次改动都要有“撤掉即变红”的断言;不新增依赖,不手改 lib/、runtime/。

不在范围

非 PTC 的 Native 前缀缓存、Shell 平台行为、后台作业关联、宿主重复调用提醒等,统一在 #981 分流,不并入本索引的 18 张卡。上游宿主缺陷需要另开单前先确认授权。

这张单何时关闭

18 张卡全部完成,或维护者明确记录延期理由(含复核日期)。任何一张卡关闭都应在该卡留下可复验的证据,而不是只勾选完成。


维护提示:本单编号 1000,作为索引占位;新增或拆分任务卡时回填上面的总表与依赖图,保持“一卡一单、单内有失败样例”的结构。

Activity

  1. added a commit that references this issue on Nov 20, 2026
  2. Thatgfsj commented on Nov 20, 2026

    @Thatgfsj
    CollaboratorAuthor

    18 张卡全部随统一 PR #1033 合入 main(c70633da),本索引单的用途(总索引与验收口径)已完成,关闭。后续工作请在新单进行。

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