Skip to content

[OPS-PTC V3] 把两档工具发布规则变成数据驱动验收矩阵 #992

Closed

Description

@Thatgfsj

V3 · 把两档工具发布规则变成数据驱动验收矩阵

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

问题:同一工具名可能在目录存在而本步不可调用。一次只查名字或只看说明,容易漏掉这类错误。

前置条件:依赖 V1;目标功能验收需要 D3,字节报告复用 V2。

从哪里读

  • test/ptc-declaration-surface.test.mjs
  • test/resident-switch.test.mjs
  • test/mode-contract-audit.test.mjs

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

按顺序执行

  1. 建立表:缺省、旧关闭、按需首步、按需已加载、全量首步、只读、窄池、自定义 preset。每行写输入和预期具体业务名字。
  2. 分别采集 declared/admitted/程序绑定,对每个配置执行一个无副作用的 sentinel;写工具权限用安全拒绝断言。
  3. 另造无 toolSet 诊断装配并单列。官方文件替代开启与关闭均检查 SDK 及交叉推荐文本;Windows 模拟与实机标识分开。

验收清单

  • 同权限下按需加载完毕与全量首步业务集合一致;被撤销或未加载的 API 不能假装已能执行。
  • 故意删除一个准入条件或读错注册表视图时,至少一格失败并打印缺失/多余的具体名字。

范围边界与停手条件:只写测试与必要的断言 helper;发现业务缺陷回报对应 P/D 卡,不在此顺手修。

验证与交付

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

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

Activity

  1. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    V3 完成,交付于 #1020(分支 card/v3-two-tier-matrix → card/d3-full-publication,HEAD c68fe3d)。

    • 新套件 test/ptc-two-tier-matrix.test.mjs:12 行配置数据(8 规范行 + 旧关闭四变体展开 + hideOfficialTools:false 钉子行)× 三视角(声明/准入/绑定)+ 单列的无 toolSet 诊断视图,全部走同一比较器 expectCell,漂移时打印缺失/多余名字。
    • 每行经真实 worker 跑无副作用哨兵;只读行的 inspect 在只读沙箱真跑;写权限用 ops_load_sdk 安全拒绝断言(INVALID_ARGUMENT 点名 write_file,effectState none)。
    • 漂移性质被断言且现场演示:改坏 global-off 行期望 → missing [ops_load_sdk] 报红,还原即绿。
    • 统一口径成立:按需加载完毕的业务集合(加载集含 result)= 全量首轮,预设与自定义 integration 两条路径一致。
    • fix(ptc): hide replaced official file tools under PTC presets #961 未入基线:官方 read/glob/grep 三件钉为两种 hideOfficialTools 状态下均可见(开关今日对 PTC 行无效),合入时该钉子随其翻转。
    • 定向验证:node test/run.mjs ptc-two-tier-matrix 16/16 过(~10s);回归 ptc-full-disclosure 8/8、ptc-declaration-surface 5/5(未触碰)、ptc-config-truth 13/13、resident-switch 24/24;check:size 825 文件全过。先红如实记录于 PR Validation 段。
    • 文档:设计决策 20261119 中英各加 V3 附录;CHANGELOG ## [Unreleased] 中英条目。
    • 边界遵守:未动 src/lib/runtime,未动 ptc-declaration-surface.test.mjs(归 P5),无新依赖。
  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