父议题 #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。#907 曾隐式翻转该行为,随后由 #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 单列。与 #968 协调共享文件。 - [ ] **D4 接入路径及诊断**。依赖 D3。入口 src/consumer/options.ts、src/integration/diagnostics.ts 及接入测试。内置行与自定义 PTC 的 allowedTools 缺省和 alwaysLoaded 校验现有差异分别覆盖。用同一发布计划生成期望集合,验证合法配置不会因缺少 ops_result 被误报。原生模式以快照保护。 - [ ] **D5 设置入口和集成验收**。依赖 D3/D4 与 #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
Thatgfsj commentedon Nov 18, 2026
独立认领入口
每行直达详细步骤、文件范围与验收。已有实现的任务请在原 Issue 认领。
Thatgfsj commentedon Nov 20, 2026
两档披露(on-demand / full)已随 #1033 合入 main(c70633da):D1–D5 卡(#985–#989)交付了真值表、配置解析、全量档发布、披露计划与设置页入口,验收矩阵 #992 覆盖三视角。本设计单完成,关闭。
feat(publication): publish the explicit full PTC disclosure tier