Skip to content

[OPS-PTC P2] 精简首轮教学并保留四条可执行示例 #982

Closed

Description

@Thatgfsj

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

  1. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    认领:982 / main@58f6e28 / 要改的文件:

    • prompts/batching-guidance.md(精简正文:删反例示范与重复散文,保留四条轨迹,补回两条规则)
    • src/ptc/batching-guidance.ts(BATCHING_GUIDANCE_REVISION 6→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 留协作评论;合并序留给集成阶段。

  2. 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