Skip to content

[设计] OPS-PTC 支持按需加载与首轮全量直出 #979

Closed
5 of 5 issues completed
Closed

Description

@Thatgfsj

父议题 #978。目标是两档共享同一组获准业务能力,用户选择什么时候承担声明成本。

用户可观察的契约

  1. 按需档:首轮默认只展开 ops_inspect_local_file、ops_load_sdk 及适用的宿主能力。以搜索为例,加载 grep 后在下一程序执行;验证同一次程序里不能提前调用。
  2. 全量档:第一个程序就可以直接调该配置允许的全部业务 API。首轮 SDK 和教学均无 loader。只读权限下禁止的写 API 不能通过切换档位获得。
  3. 取同平台、权限、组件和 allowedTools,对两档排除 loader 后比较:按需档加载完毕的业务工具集合 = 全量档首轮集合。另测结果分页/release,避免产生 ref 后无法消费。
  4. 旧配置兼容:58f6e281 的 dynamicTools:false 只发布 resident/alwaysLoaded。fix(ptc): publish the allowed pool as resident when dynamic loading is off #907 曾隐式翻转该行为,随后由 revert: withdraw the loader-less resident pool publication #910 撤回。新选择必须显式 opt-in。升级、保存设置和 global.dynamicTools 开关均不得替用户选择全量。

建议分 5 个小 PR,按编号认领

  • D1 契约与兼容样例。入口 src/presets/config.ts、src/settings/merged.ts 对应的测试与中英文配置参考。先记录旧配置的五种输入:缺省、全局关闭、行关闭、关闭且有 alwaysLoaded、residentTools:false。输出每种配置的首轮名字集合。记录 result 的隐式例外、冲突配置诊断和设置页显示文案。交付为可审阅的真值表和当前行为测试。
  • D2 配置解析和保存。依赖 D1。限于 PTC 配置解析、设置序列化及对应测试。新增显式发布策略,缺省走旧路径。验证未知值有可读诊断、旧配置可回读,保存其他设置不会丢失新选择。此切片先锁定解析契约。
  • D3 内置 OPS-PTC 发布。依赖 D2。入口 src/publication/ptc.ts、src/presets/builtin.ts、test/resident-switch.test.mjs。把获准的全量池发布到本步,使用现有权限判断。对 allowedTools=[grep,stat] 断言首步存在这两项且可用;池外业务工具不可用;另测空池、只读、resident 冲突和重复名称。构建带 worker 的隔离环境,skip 单列。与 [BUG] ops-ptc:loader 开启时 tools:sdk 声明整个 allowedTools 池,未 load 的 ops_* 调用被拒为 PUBLICATION_GRANT_UNAVAILABLE #968 协调共享文件。
  • D4 接入路径及诊断。依赖 D3。入口 src/consumer/options.ts、src/integration/diagnostics.ts 及接入测试。内置行与自定义 PTC 的 allowedTools 缺省和 alwaysLoaded 校验现有差异分别覆盖。用同一发布计划生成期望集合,验证合法配置不会因缺少 ops_result 被误报。原生模式以快照保护。
  • D5 设置入口和集成验收。依赖 D3/D4 与 [BUG] batchingGuidance 教模型使用未发布的 ops_load_sdk(dynamicTools: false) #922。让用户能明确选“按需”或“全量”,同步双语说明与升级示例。新开会话,从 UI 保存到实际首轮 SDK 和第一次调用做往返测试;旧 profile 重新打开时保留原能力预算。

接手说明

先读 src/publication/ptc.ts 的 resident/selectable/selected 三段与 test/ptc-declaration-surface.test.mjs。单个 PR 只认领 D1–D5 中的一行,写出本次用例的输入和预期名字集合。对只读、空池或配置冲突的处理若偏离 D1,先更新本 Issue 的决策记录。教学用 #922,官方替代用 #960,Native 的发现机制另行跟踪。

Activity

  1. Thatgfsj commented on Nov 20, 2026

    @Thatgfsj
    CollaboratorAuthor

    两档披露(on-demand / full)已随 #1033 合入 main(c70633da):D1–D5 卡(#985–#989)交付了真值表、配置解析、全量档发布、披露计划与设置页入口,验收矩阵 #992 覆盖三视角。本设计单完成,关闭。

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