## P2 · 精简首轮教学并保留四条可执行示例 总计划 #978,所属工作流 #978。 **问题**:首轮教学会进入消息历史。缩短重复说明可减少重放成本,但删掉游标或加载规则会使模型多走几步。 **前置条件**:P1 的文案渲染边界确定后;先协调 #868/#869 的示例变更。 ### 从哪里读 - prompts/batching-guidance.md - src/ptc/batching-guidance.ts - test/batching-examples.test.mjs 认领前记录当前 main SHA。以上为优先检查的范围,需要扩大写域时先说明文件与原因。 ### 按顺序执行 1. 取同一提交的原文,按读取逻辑 trim 后用 Buffer.byteLength(text, "utf8") 计量。正文和84 B来源前缀分开记。 2. 逐段标注保留、合并、移至双语文档。保留侦察、检索后读取、带版本校验的编辑、循环分页四条轨迹。 3. 补回“只加载缺失 API”和“模式变化后重查当前 SDK”,提升教学 revision 并同步来源记录。运行示例套件而不只做字符串快照。 ### 验收清单 - [ ] 基准正文8645 B,7234 B只是候选:必须提交实际前后值及删改表。 - [ ] 四条轨迹可执行;分页示例检查 complete 与 nextOffset,编辑示例仍使用 expectedRevision,整组示例通过类型/执行测试。 **范围边界与停手条件**:不修改 Outcome 类型换字节,不以 token 或遵从率代替正文测量。 ### 验证与交付 先运行 npm run build;依赖 native worker 的测试先运行 npm run build:ptc。定向入口:node test/run.mjs batching-examples。确认过滤器命中目标套件,记录实际 pass / skip / fail。 认领模板:编号 / 当前 SHA / 目标文件 / 第一个失败样例。提交时贴修改前与修改后结果,以及撤掉改动后会失败的断言。已有 PR 请先在原讨论协作。行为及中英文文档同 PR。
Activity
Thatgfsj commentedon Nov 19, 2026
认领:982 / main@58f6e28 / 要改的文件:
prompts/batching-guidance.md(精简正文:删反例示范与重复散文,保留四条轨迹,补回两条规则)src/ptc/batching-guidance.ts(BATCHING_GUIDANCE_REVISION6→7)test/batching-guidance.test.mjs(revision 固定断言与红绿断言在此套件;[OPS-PTC P2] 精简首轮教学并保留四条可执行示例 #982 未列此文件,写域扩大的原因即此)docs/CHANGELOG.md+docs/configuration-reference.md/docs/配置参考.md(中英文档与 Unreleased 同 PR)第一个失败样例:
assert.equal(BATCHING_GUIDANCE_REVISION, '7')(test/batching-guidance.test.mjs)——当前 src 仍为 '6',先红后绿。修订前实测:正文 8645 B(UTF-8)、投递来源前缀 84 B,与验收清单基准一致。已核对 #868 / PR #869:其 "one session, one scope" 为纯增量章节,本卡删除的是反例示范与重复散文,无内容冲突,将另在 #869 留协作评论;合并序留给集成阶段。
Thatgfsj commentedon Nov 20, 2026
已由 #1033 合入 main 交付(18 张卡并集,见 PR 描述与 docs/CHANGELOG.md 的 Unreleased 条目)。