dsh-dashcam 0.0.0-stage → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +624 -2
  3. package/README.zh-CN.md +835 -0
  4. package/SECURITY.md +28 -0
  5. package/bin/dsh-dashcam.js +574 -0
  6. package/cordis.patch.yml +5 -0
  7. package/docs/COMPLIANCE.md +112 -0
  8. package/docs/ROLLOUT.md +150 -0
  9. package/docs/SPEC.md +441 -0
  10. package/docs/ghost-in-the-llm/README.md +21 -0
  11. package/docs/ghost-in-the-llm/dashcam-ingress-audit-design.md +223 -0
  12. package/docs/ghost-in-the-llm/dashcam-ingress-record-plan.md +418 -0
  13. package/docs/ghost-in-the-llm/ghost-message-forensics.md +214 -0
  14. package/docs/ghost-in-the-llm/ghost-message-third-party-review.md +174 -0
  15. package/docs/multiprocess.md +292 -0
  16. package/dsh-dashcam-host/README.md +177 -0
  17. package/dsh-dashcam-host/README.zh-CN.md +181 -0
  18. package/dsh-dashcam-host/lib/client.js +1206 -0
  19. package/dsh-dashcam-host/lib/index.js +971 -0
  20. package/dsh-dashcam-host/lib/ingress.js +218 -0
  21. package/dsh-dashcam-host/lib/panel.js +487 -0
  22. package/dsh-dashcam-host/package.json +29 -0
  23. package/examples/child-plugin.js +25 -0
  24. package/examples/compliant-plugin/index.js +30 -0
  25. package/examples/compliant-plugin/manifest.json +47 -0
  26. package/examples/demo-policy.json +33 -0
  27. package/examples/negative-plugin/index.js +20 -0
  28. package/examples/negative-plugin/manifest.json +36 -0
  29. package/package.json +73 -4
  30. package/src/autopsy/activation.js +90 -0
  31. package/src/autopsy/autopsy.js +222 -0
  32. package/src/contract/capabilities.js +437 -0
  33. package/src/contract/charter.js +230 -0
  34. package/src/contract/manifest.js +162 -0
  35. package/src/contract/two-key.js +89 -0
  36. package/src/errors.js +34 -0
  37. package/src/gates/index.js +289 -0
  38. package/src/gates/loadability.js +87 -0
  39. package/src/gates/report.js +78 -0
  40. package/src/gates/safety.js +194 -0
  41. package/src/gates/structure.js +161 -0
  42. package/src/governance/behavior.js +231 -0
  43. package/src/governance/blacklist.js +66 -0
  44. package/src/governance/metrics.js +249 -0
  45. package/src/governance/rollback.js +66 -0
  46. package/src/governance/rollout.js +88 -0
  47. package/src/host/child-host.js +216 -0
  48. package/src/host/local-host.js +441 -0
  49. package/src/index.js +261 -0
  50. package/src/policy.js +239 -0
  51. package/src/portrait/portrait.js +129 -0
  52. package/src/runtime/bridge.js +1281 -0
  53. package/src/runtime/derive.js +208 -0
  54. package/src/runtime/facade.js +40 -0
  55. package/src/runtime/guards.js +583 -0
  56. package/src/runtime/handles/fs.js +193 -0
  57. package/src/runtime/handles/index.js +30 -0
  58. package/src/runtime/handles/inject.js +129 -0
  59. package/src/runtime/handles/net.js +177 -0
  60. package/src/runtime/handles/proc.js +78 -0
  61. package/src/runtime/ingress.js +717 -0
  62. package/src/runtime/ipc/child.js +88 -0
  63. package/src/runtime/ipc/protocol.js +127 -0
  64. package/src/runtime/ledger.js +582 -0
  65. package/src/runtime/one-seal.js +122 -0
  66. package/src/runtime/redirects.js +102 -0
  67. package/src/signing/bundle.js +290 -0
  68. package/src/signing/trust.js +90 -0
  69. package/src/util/paths.js +187 -0
  70. package/src/util/stable.js +25 -0
  71. package/test/attack-surface.test.js +774 -0
  72. package/test/audit.test.js +636 -0
  73. package/test/autopsy.test.js +104 -0
  74. package/test/batch-guard.test.js +81 -0
  75. package/test/behavior.test.js +132 -0
  76. package/test/bypass.test.js +231 -0
  77. package/test/child-host.test.js +127 -0
  78. package/test/child.test.js +183 -0
  79. package/test/contract.test.js +157 -0
  80. package/test/gates.test.js +275 -0
  81. package/test/glob.test.js +83 -0
  82. package/test/governance.test.js +102 -0
  83. package/test/handle.test.js +132 -0
  84. package/test/helpers/fixtures.js +124 -0
  85. package/test/ingress.test.js +416 -0
  86. package/test/invariants.test.js +314 -0
  87. package/test/ledger-mac.test.js +134 -0
  88. package/test/mac-custody.test.js +86 -0
  89. package/test/mandate.test.js +129 -0
  90. package/test/metrics-batch.test.js +234 -0
  91. package/test/metrics-telemetry.test.js +217 -0
  92. package/test/net-proc-handle.test.js +183 -0
  93. package/test/observe.test.js +169 -0
  94. package/test/options.test.js +174 -0
  95. package/test/portrait-labels.test.js +72 -0
  96. package/test/portrait.test.js +65 -0
  97. package/test/protocol.test.js +105 -0
  98. package/test/quick-wins.test.js +245 -0
  99. package/test/review-fixes.test.js +260 -0
  100. package/test/review2-fixes.test.js +191 -0
  101. package/test/review3-fixes.test.js +226 -0
  102. package/test/review4-fixes.test.js +486 -0
  103. package/test/review5-fixes.test.js +301 -0
  104. package/test/review6-fixes.test.js +311 -0
  105. package/test/runtime.test.js +185 -0
  106. package/test/sandbox.test.js +236 -0
  107. package/test/signatures.test.js +170 -0
  108. package/test/symlink.test.js +288 -0
  109. package/test/three-lens-fixes.test.js +397 -0
  110. package/test/worker.test.js +73 -0
@@ -0,0 +1,112 @@
1
+ # dsh-dashcam 合规:Charter 与 Sieve
2
+
3
+ ## 1. Charter 字段
4
+
5
+ `manifest.dashcam.content` 必须是对象,包含以下五个字段,缺一不可:
6
+
7
+ | 字段 | 取值 | 说明 |
8
+ | --- | --- | --- |
9
+ | `rating` | `general` / `teen` / `mature` / `restricted` | 内容分级,风险从低到高 |
10
+ | `scenes` | 字符串数组 | 适用场景,如 `chat`、`hud`、`coding` |
11
+ | `commercialUse` | `allowed` / `noncommercial` / `prohibited` | 商用边界 |
12
+ | `sourceFingerprint` | `sha256:<32-64 位 hex>` | 源码指纹,用于溯源 |
13
+ | `enterpriseExcluded` | 布尔 | 发布者主动声明排除企业通道 |
14
+
15
+ ### 默认值(最保守)
16
+
17
+ 未填字段不会“按宽松处理”,而是按最保守值运行:
18
+
19
+ ```js
20
+ { rating: 'restricted', scenes: [], commercialUse: 'prohibited',
21
+ sourceFingerprint: null, enterpriseExcluded: true }
22
+ ```
23
+
24
+ 注意:
25
+
26
+ - 默认 `advisory` 模式下,缺失字段输出 `Untrusted` 画像标签并继续安装;`required` / 企业通道才把
27
+ `charter_field_missing` 升级为拒装。
28
+ - 默认值用于展示与 legacy 插件的运行时画像,不构成能力授予。
29
+
30
+ ## 2. 字段校验
31
+
32
+ `validateCharter` 在契约门禁执行,逐字段报告:
33
+
34
+ | 错误码 | 条件 |
35
+ | --- | --- |
36
+ | `charter_missing` | `dashcam.content` 缺失或不是对象 |
37
+ | `charter_field_missing` | 任一必填字段为 `undefined` / `null` |
38
+ | `charter_rating_invalid` | `rating` 不在枚举内 |
39
+ | `charter_scenes_invalid` | `scenes` 不是数组 |
40
+ | `charter_commercial_invalid` | `commercialUse` 不在枚举内 |
41
+ | `charter_fingerprint_invalid` | `sourceFingerprint` 不是 `sha256:<hex>` |
42
+ | `charter_enterprise_invalid` | `enterpriseExcluded` 不是布尔 |
43
+
44
+ 所有错误都带 `field`(如 `dashcam.content.rating`)与 `file`(`manifest.json`)。
45
+
46
+ ## 3. Sieve 准入
47
+
48
+ `evaluateAdmission(manifest, {channel, policy})` 的判定顺序:
49
+
50
+ 1. **legacy**:企业通道直接拒绝(`legacy_enterprise_excluded`)。消费通道按 `policy.enforcement` 判定:
51
+ 默认 `advisory` → 放行并记为 `Quarantined` 标签(警告 `legacy_conservative_defaults`);
52
+ `required` 且 `allowLegacy=false` → 拒绝(`legacy_not_admitted`);
53
+ `allowLegacy: true` → 放行并记 `legacy_allowlisted_by_host`。
54
+ 2. **Charter 缺失**:默认输出 `Untrusted` 标签;`required` 拒绝(`charter_missing`)。
55
+ 3. **缺字段**:逐字段报告(`charter_field_missing`),默认标签、`required` 拒绝,不再继续后续判定。
56
+ 4. **分级**:`RATING_RANK[rating] > RATING_RANK[channel.maxRating]` → `rating_blocked`。
57
+ 5. **场景**:任一 `scenes` 命中 `channel.blockedScenes` → `scene_blocked`(`reason` 即场景名)。
58
+ 6. **商用**:`commercialUse` 不在 `channel.commercialUse` → `commercial_blocked`。
59
+ 7. **企业排除**:企业通道下 `enterpriseExcluded=true` → `enterprise_excluded`。
60
+ 8. **企业出站**:企业通道要求显式 allowlist,未配置 → `egress_allowlist_not_configured`。
61
+
62
+ 全部通过才 `admitted=true`。返回结构:
63
+
64
+ ```js
65
+ { admitted, charter, reasons: [{code, field, reason}], warnings: [{code, reason}] }
66
+ ```
67
+
68
+ `reason` 直接来自策略或字段值,不包装、不改写。
69
+
70
+ ## 4. 通道策略默认值
71
+
72
+ | 通道 | `maxRating` | `commercialUse` | 额外要求 |
73
+ | --- | --- | --- | --- |
74
+ | `consumer` | `mature` | `allowed` / `noncommercial` | 无 |
75
+ | `enterprise` | `teen` | `allowed` | `requireEgressAllowlist: true` |
76
+
77
+ 策略可在 `policy.channels.<channel>` 覆盖,但企业通道的 allowlist 要求不建议关闭。
78
+ 企业通道是**单独开关**:只有显式传 `channel: 'enterprise'` 才启用上述规则。
79
+
80
+ ### 执行模式
81
+
82
+ ```js
83
+ policy.enforcement = { mode: 'advisory', allowLegacy: false, requireSignature: false }
84
+ ```
85
+
86
+ | 字段 | 默认 | 含义 |
87
+ | --- | --- | --- |
88
+ | `mode` | `advisory` | 默认先装再标注;`required` 把门禁结论升级为拒装(企业通道始终 required) |
89
+ | `allowLegacy` | `false` | `required` 模式下放行 legacy 的显式逃生阀;放行写 `ruleId=admission` 的 Ledger |
90
+ | `requireSignature` | `false` | 默认验签失败只输出 `Untrusted`;打开后无签名/验签失败即拒装 |
91
+
92
+ 执行点在加载器:`LocalHost.install` 自己跑完整门禁流水线,`install(pluginDir)` 没有
93
+ “跳过准入”的参数。`advisory` 下准入结论与安全标签都写 Ledger / 挂在该插件上;只有
94
+ `report.blocked`(恶意脚本或黑名单)才真正拒绝。
95
+
96
+ ## 5. 与元数据覆盖率的关系
97
+
98
+ 月度度量中的 `metadataCoverage` 统计 10 个字段(`id`、`name`、`version`、`entry`、`dashcam` + 五个 Charter 字段)
99
+ 在 manifest 中的存在比例。覆盖率用于观察生态元数据质量,不作为单个插件的准入依据;
100
+ 单个插件的准入只认 `validateCharter` 与 Sieve 的结果。
101
+
102
+ ## 6. 常见反例
103
+
104
+ | 反例 | 结果 |
105
+ | --- | --- |
106
+ | 只写 `rating`,不写其他字段 | 默认:`Untrusted` 标签;`required`:`charter_field_missing` × 4,拒装 |
107
+ | `scenes: "chat"`(字符串) | `charter_scenes_invalid`:默认标签,`required` 拒装 |
108
+ | `sourceFingerprint: "abc"` | `charter_fingerprint_invalid`:默认标签,`required` 拒装 |
109
+ | 企业通道提交 `rating: mature` | `rating_blocked`(企业上限 `teen`),拒装 |
110
+ | 企业通道提交 `commercialUse: noncommercial` | `commercial_blocked`,拒装 |
111
+ | 未配置 `egressAllowlist` 就走企业通道 | `egress_allowlist_not_configured`,拒装 |
112
+ | 无 `dashcam` 字段 | legacy:默认 `{level:'legacy',quarantine:true}`;advisory 消费通道可装并标 `Quarantined`;`required` 拒装;企业通道恒拒 |
@@ -0,0 +1,150 @@
1
+ # dsh-dashcam 上线节奏与治理
2
+
3
+ 本文件按骨架第 8、9 节定稿上线顺序、熔断条件、回滚层级、密钥轮换、应急下架与月度度量。
4
+ 不排日期,只定义“进入下一步的条件”和“退回上一档的条件”。
5
+
6
+ ## 1. 六阶段
7
+
8
+ 顺序由 `src/governance/rollout.js` 的 `STAGES` 固化:
9
+
10
+ | # | 阶段 | 内容 | 进入下一阶段的条件 |
11
+ | --- | --- | --- | --- |
12
+ | 0 | `contract-two-key` | 契约层 + Two-Key,默认 deny-all;门禁默认 `advisory`,输出安全标签 | 反例包([examples/negative-plugin](../examples/negative-plugin))的恶意脚本被阻断;正例包按声明放行;legacy 以 `Quarantined` 运行且无任何能力 |
13
+ | 1 | `bridge-ledger` | Bridge + Ledger + One-Seal | 绕过测试集清零:直调 Node API、第三方库、patch 注入、网络/env |
14
+ | 2 | `structure-signature` | 结构门禁 + 签名 | 阻断类用例先跑通(越界 patch、非白名单安装脚本一律拒装);未签名/篡改包稳定输出 `Untrusted` 标签 |
15
+ | 3 | `safety-loadability` | 安全门禁 + 可装载性门禁 | 灰度期间误杀率与放弃率均在阈值内 |
16
+ | 4 | `portrait-autopsy` | 画像卡 + Autopsy 接入安装流程 | 首屏信息、三档交互、拒绝原因展示均通过评审 |
17
+ | 5 | `charter-sieve` | Charter + Sieve,企业通道单独开关 | 企业通道元数据覆盖率达标,且企业排除规则可审计 |
18
+
19
+ 阶段推进用 `RolloutController.advance()`;需要人工确认时保持 `autoAdvance=false`。
20
+
21
+ ## 2. 熔断
22
+
23
+ `checkCircuitBreaker(metrics, thresholds)` 对三项指标做硬判定,任一超阈值即 `action=rollback`:
24
+
25
+ | 指标 | 默认阈值 | 含义 |
26
+ | --- | --- | --- |
27
+ | `falseKillRate` | `0.02` | 误杀率:被拒但事后确认应放行的比例 |
28
+ | `abandonmentRate` | `0.05` | 放弃率:安装流程被用户/上游中止的比例 |
29
+ | `silentFailureRate` | `0.01` | 静默失效率:守卫或 Ledger 未按预期生效的比例 |
30
+
31
+ `RolloutController.evaluate(metrics)` 在违例时把 `stageIndex` 回退一档并返回 `from` / `to` / `violations`;
32
+ 未违例且 `autoAdvance=true` 时前进一档,否则 `hold`。
33
+
34
+ 阈值可按通道在 `policy.circuitBreaker` 中覆盖,但不得高于默认值太多;调整必须留痕。
35
+
36
+ ## 3. 三级回滚
37
+
38
+ `RollbackManager` 支持三个层级,语义不同,互不替代:
39
+
40
+ | 层级 | 粒度 | 典型用法 |
41
+ | --- | --- | --- |
42
+ | `rule` | 单条门禁规则 / 阈值 | 某条静态扫描规则误杀,回退该规则到上一版 |
43
+ | `module` | 一个模块(如 `net-guard`、`bridge`) | Bridge 新版本引入回归,整模块回退 |
44
+ | `contract` | 单个插件的契约版本 | 某插件升级后越权,回退到上一版 manifest 与签名包 |
45
+
46
+ - `snapshot({level,key,value})` 记录版本;`rollback({level,key})` 返回上一版;`history` 保留变更轨迹。
47
+ - 契约级回滚必须同时回退签名包与授予集,避免“旧代码 + 新授权”的组合。
48
+ - 回滚本身写 Ledger(`ruleId=rollback`),便于事后复盘。
49
+
50
+ ## 4. 密钥双钥并行轮换
51
+
52
+ 信任表 key 状态:`active`(当前主用)、`next`(下一把,已发布)、`retired`(已退役但仍可验旧包)、`revoked`(立即失效)。
53
+
54
+ 轮换步骤(不中断验签):
55
+
56
+ 1. 生成新密钥,以 `next` 状态加入信任表,客户端先行分发。
57
+ 2. 新包改用 `next` 私钥签名;旧包继续用 `active` 验证。
58
+ 3. 确认客户端全部拿到新信任表后,把旧 key 置为 `retired`,新 key 置为 `active`。
59
+ 4. 旧包全部过期或重签后,可移除 `retired` key。
60
+
61
+ 任何一步都不得删除仍在服务期内的公钥;`revoked` 只用于泄漏或误签。
62
+
63
+ ## 5. 应急下架
64
+
65
+ 黑名单是**独立通道**,不依赖签名、不依赖契约校验,位于安装流水线第一段:
66
+
67
+ - 存储:独立 JSON 文件(`Blacklist`),可离线分发;条目 `{plugin, reason, until?}`。
68
+ - 命中即拒绝,`contractChecked=false`;`until` 到期自动放行。
69
+ - CLI:`dsh-dashcam blacklist <file> add|remove|list ...`。
70
+ - 运行时:`createGuardChain({blacklist})` 在每个请求前检查,命中返回 `blacklisted`,并写 Ledger。
71
+
72
+ 应急下架优先于一切“补签名/补声明”的修复路径;恢复上架必须重新走完整门禁。
73
+
74
+ ## 6. 月度度量
75
+
76
+ `computeMetrics` / `monthlyMetrics` 从 Ledger 与安装事件离线重算,口径固定:
77
+
78
+ | 指标 | 公式 | 说明 |
79
+ | --- | --- | --- |
80
+ | 拦截率 `interceptionRate` | `deny / (allow + deny)` | 守卫链拦截比例 |
81
+ | 误杀率 `falseKillRate` | `overrides / deny` | 人工复核推翻的拒绝占比 |
82
+ | 静默失效率 `silentFailureRate` | `guardErrors / (allow + deny)`,无记录时 `guardErrors / guardErrors` | 守卫异常、Ledger 写失败等 |
83
+ | 未声明拦截率 `undeclaredInterceptionRate` | `intercepted / (allow + deny)` | 插件调用了 manifest 没声明的 API,属于越界 |
84
+ | 授权缺口率 `grantDenialRate` | `(not_granted + scope_mismatch) / deny` | 声明了但宿主没发钥匙,该改策略而不是改插件 |
85
+ | 放弃率 `abandonmentRate` | `abort / (attempt + abort)` | `attempt` 只记未被中止的安装,分母需含 `abort` |
86
+ | 元数据覆盖率 `metadataCoverage` | `present / required` | 10 个必填元数据字段 × manifest 数 |
87
+
88
+ **telemetry 附加记录排除(1.10.12)**:宿主适配层(dsh-dashcam-host)会把非判定的附加
89
+ 审计记录直接 append 进账本(mount / unmapped-tool / unjudgeable-tool / proc.commandline
90
+ 存档),capability 固定为 `telemetry`。它们不是 Two-Key 判定:判定读数(上表全部
91
+ allow/deny 口径指标)只收 `capability !== 'telemetry'` 的记录;telemetry 数量与其中
92
+ deny 条数另列并列读数 `telemetryRecords` / `telemetryDenies`,可见性不丢。
93
+ `records()` / `verify()` 等离线审计仍看全量行,不受口径影响。
94
+
95
+ **ingress 观测记录排除(1.12.0)**:`capability='llm.ingress'` 的 `llm.request` / `llm.inbound` /
96
+ `llm.anomaly` 同样是观测而非判定,判定读数一并排除;另列 `ingressRequests` / `ingressInbound` /
97
+ `ingressAnomalies` / `ingressAnomalyRate`。没有 ingress 记录的旧账本上这些读数恒为 0。
98
+ 异常记录不写 `deny`,因此不会抬高拦截率,也不会触发 `falseKillRate` / `abandonmentRate`。
99
+ `interceptionRate` 的告警阈值不因 ingress 调整;ingress 异常率是独立观察项,不参与
100
+ `checkCircuitBreaker` 的自动回滚判定。
101
+
102
+ `monthlyMetrics` 按 `ts` / `at` 的 `YYYY-MM` 分组,输出每月完整指标。
103
+
104
+ ## 7. 执行点在宿主
105
+
106
+ 准入不是商店的职责,是**加载器**的职责。这一条比任何门禁规则都重要,所以单独成节:
107
+
108
+ - 非侵入式不是“放过插件”,而是把执行点从安装时移到运行时:门禁先装、再输出安全画像标签
109
+ (`Untrusted` / `Quarantined` / `ReviewRequired` / `Broken` / `Verified`),
110
+ 真正的能力边界由 `LocalHost.install` / `activate()` 里的 Two-Key 与 Ledger 守住。
111
+ - 只有恶意脚本(越界 patch、非白名单安装脚本、entry 越界)与应急黑名单才阻断安装;
112
+ 其余问题必须在画像卡上可见,不能悄悄降级。
113
+ - 企业通道或显式 `enforcement.mode=required` 恢复拒装语义;想放宽只能改策略并留痕,
114
+ 不得在调用方传参跳过准入。
115
+ - 灰度期若误杀率超阈值,正确的动作是**回退到 `advisory` 并记一条规则级回滚**,
116
+ 而不是悄悄放宽某个白名单——后者会让「执行点在宿主」这个前提失效,且不留痕迹。
117
+
118
+ ## 8. 上线前必须告知宿主(部署责任清单)
119
+
120
+ 前七节讲「库能保证什么」。这一节讲**库保证不了、必须由部署方兜住**的部分——它们不是待修的
121
+ bug,而是这类「进程内治理」方案的物理边界。上线前逐项确认;缺哪项,就在插件画像卡上明示,
122
+ 不要让它看起来像已经解决。
123
+
124
+ | # | 边界 | 为什么库管不了 | 宿主必须做什么 | 验收方式 |
125
+ | --- | --- | --- | --- | --- |
126
+ | 1 | 目录级 TOCTOU(链接替换、父目录 rename) | `open` 之后只能拿到 `fstat` 的类型和**当前路径**的 realpath,拿不到 fd 指向的 inode 路径 | 插件工作目录独立(父目录不与他人共享可写);最小权限账号;必要时容器 + 只读挂载 | 用攻击脚本试:判定通过后、IO 之前 rename 父目录——当前会漏,属已知,必须靠文件系统隔离 |
127
+ | 2 | `vm` / 原生扩展(`.node`)/ Worker 内部 | 同一进程内没有第二道墙;Worker 的模块表是新的 | 高风险插件放独立进程或独立 realm;企业通道直接拒收含原生扩展的包 | 安全门禁 `scan.findings` 出现 `native_module` 的必须走隔离,不能只贴标签 |
128
+ | 3 | 账本可写性 | HMAC 只保证「无密钥者伪造不了」;进程账号若对账本目录有写权限,可以直接截断 | 账本放独立存储(append-only 挂载 / 外部日志系统);定期 `anchor()` 外发 | 用运行账号试删账本,应当失败;`metrics --anchor <锚点文件>` 应通过 |
129
+ | 4 | `macKey` 托管 | 密钥进了仓库/镜像/日志,等于没有密钥 | KMS 或编排层注入(`DSH_DASHCAM_MAC_KEY` / `--mac-key-file`);谁能读写进运维文档;轮换按「新账本 + 旧账本重新锚定」做 | `redact()` 只露 `{macEnabled,keyLength,source}`;密钥在仓库与日志里 grep 不到 |
130
+ | 5 | 沙箱模式 | 默认 `global` 只靠 Hook 事后拦;`handles` 需要插件改用 `ctx.handles`(`openSync` 等无法兼容) | 高敏插件显式 `sandbox.mode='handles'`;存量保持默认 `global`,零改动 | `host.coverage().sandbox.kind` 与策略一致:`global` → `none`,`handles` → `module-redirect` |
131
+
132
+ **上线检查清单**(逐项打勾;缺项要在画像卡上标 `ReviewRequired`,不要标 `Verified`):
133
+
134
+ - [ ] 插件工作目录独立,父目录对其他账号不可写
135
+ - [ ] 账本目录对运行账号只可追加、不可删除/重写(或已定期外发锚点)
136
+ - [ ] `macKey` 不落仓库、不进镜像、不出现在任何日志
137
+ - [ ] 含原生扩展或用 `vm` 的插件已隔离到独立进程,或已拒收
138
+ - [ ] 存量 `global` 沙箱插件已登记为技术债
139
+ - [ ] 跑过 `metrics --anchor` 并保留过锚点文件
140
+
141
+ **已知不可测项**:Windows 上创建文件符号链接需要管理员权限或开发者模式,无权限时
142
+ `test/symlink.test.js` 的 3 条用例会**显式 skip**。**skip 不等于通过**——在没有符号链接权限的
143
+ CI 上,那条逃逸路径只有目录联接(junction)用例覆盖着,人工复核时要记得这个差集。
144
+
145
+ ## 9. 合入与灰度要求
146
+
147
+ - 每阶段合入前必须跑通 `npm test`(含绕过测试集与准入用例:audit / mandate)。
148
+ - 阶段 2、3 的阻断类规则先行:宁可在灰度前多拒,灰度只调误杀,不放松阻断。
149
+ - 灰度期只调整 `policy`(allowlist、阈值、凭证复核名单),不改契约语义;语义变更必须走规范评审。
150
+ - 每次回退与阈值调整都写 Ledger,并纳入当月度量复盘。