Repository navigation
Description
本单的用途
这张单是 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
| 批次 | 可并行认领 | 说明 |
|---|---|---|
| 第一批 | 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
Merge pull request #1033 from T-Auto/release/consolidate-1023-1008
Thatgfsj commentedon Nov 20, 2026
18 张卡全部随统一 PR #1033 合入 main(c70633da),本索引单的用途(总索引与验收口径)已完成,关闭。后续工作请在新单进行。
chore(release): consolidate the OPS-PTC 18-card release with T-Auto#1002