dsh-auth-remote 0.3.4 → 0.3.5

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.
@@ -2,50 +2,50 @@
2
2
 
3
3
  [English](legacy-compatibility.md)
4
4
 
5
- 最后复核:2026-11-05。本文与英文清单共同维护同一组稳定 ID、版本事实、代码位置、测试与退役条件。修改任一语言时同步另一语言;矩阵是检索入口,条目是维护依据。本文记录 DSH 精确版本差异,不以发布顺序或版本简称代替适用范围。
5
+ 最后复核:2026-11-06。本文与英文清单共同维护同一组稳定 ID、版本事实、代码位置、测试与退役条件。修改任一语言时同步另一语言;矩阵是检索入口,条目是维护依据。本文记录 DSH 精确版本差异,不以发布顺序或版本简称代替适用范围。
6
6
 
7
7
  当前维护日期及承诺见[支持规范](support-policy.zh-CN.md)。历史 [DSH → 插件](support-history.zh-CN.md#by-dsh)与[插件 → DSH](support-history.zh-CN.md#by-plugin)区分声明、报告、计划发布版本与分发事实。
8
8
 
9
9
  ## 当前发布范围
10
10
 
11
- 插件 `0.3.4` 声明 DSH `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.3`。技术准入仍为包含预发布的 `>=0.2.1-alpha.3`,不设上限。开发默认及推荐宿主为 `0.2.2-alpha.3`,发布以最终同包验收为前提。已发布 `0.3.3` 保留不含 `0.2.2-alpha.3` 的九版声明;`0.3.4` 的可用性由发布工作流和 npm registry 确认。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 的 legacy 日期仍为 2026-10-28、14 日窗口、2026-11-11(Asia/Shanghai)起具备资格;日期不自动终止支持。历史退役及最后支持插件 `0.2.0` 保留如下。
11
+ 插件 `0.3.5` 正在准备发布,声明 DSH `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.3`、`0.2.2-rc.1`。技术准入仍为包含预发布的 `>=0.2.1-alpha.3`,不设上限。开发默认及推荐宿主为上游 RC 预发布 `0.2.2-rc.1`,发布以最终同包验收为前提。已发布 `0.3.4` 保留含 `0.2.2-alpha.3`、不含 `0.2.2-rc.1` 的九版声明;`0.3.5` 的可用性由发布工作流和 npm registry 确认。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 的 legacy 日期仍为 2026-10-28、14 日窗口、2026-11-11(Asia/Shanghai)起具备资格;日期不自动终止支持。历史退役及最后支持插件 `0.2.0` 保留如下。
12
12
 
13
- HOST/PROTOCOL、PUBLIC 参数/文本、THEME radius/thumb 与 TEST 直接导航的独占路径维持 `0.3.1` 既有退役,共享原生/安全检查保留。ACCOUNT/HMR 和通用引导重试仍有支持交集;RESOURCE/LIVESHARE 精确适用 `0.2.2-alpha.2`、`0.2.2-alpha.3`。DSH-SETTINGS-ICON-001 仅为 `0.2.2-alpha.3` 新增原生导航图标,其余精确默认范围见下表。最终同包报告不入 npm,也不继承旧归档成功。
13
+ HOST/PROTOCOL、PUBLIC 参数/文本、THEME radius/thumb 与 TEST 直接导航的独占路径维持 `0.3.1` 既有退役,共享原生/安全检查保留。ACCOUNT/HMR 和通用引导重试仍有支持交集;RESOURCE/LIVESHARE 精确适用 `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1`。DSH-SETTINGS-ICON-001 为 `0.2.2-alpha.3`、`0.2.2-rc.1` 新增原生导航图标,其余精确默认范围见下表。最终同包报告不入 npm,也不继承旧归档成功。
14
14
 
15
- 适用版本列保留包含已退役 `0.2.2-alpha.2` 的历史精确宿主;当前支持为上方九版集合。该版于 2026-11-05 按明确零日上游故障例外在 `0.3.4` 退役,最后历史支持插件 `0.3.3`,详见[支持规范](support-policy.zh-CN.md#upstream-failure-exception)。RESOURCE/LIVESHARE 当前与支持集合的交集仅为 `0.2.2-alpha.3`,仍须保留私有边界。
15
+ 适用版本列保留包含已退役 `0.2.2-alpha.2` 的历史精确宿主;当前支持为上方十版集合。该版于 2026-11-05 按明确零日上游故障例外在 `0.3.4` 退役,最后历史支持插件 `0.3.3`,详见[支持规范](support-policy.zh-CN.md#upstream-failure-exception)。RESOURCE/LIVESHARE 当前与支持集合的交集为 `0.2.2-alpha.3`、`0.2.2-rc.1`,仍须保留私有边界。
16
16
 
17
17
  ## 范围与复核规则
18
18
 
19
- 当前九版精确声明如上;DSH `0.2.2-alpha.2`、`0.2.2-alpha.3` 自身要求 Node `>=24.9.0`,插件引擎仍为 `>=24`,不增加小版本拦截。包含预发布的前向准入仍须身份/API 检查,未知版本不继承实测结论;账号适配还须必要能力和 live `manualAccountLogin`。
19
+ 当前十版精确声明如上;DSH `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 自身要求 Node `>=24.9.0`,插件引擎仍为 `>=24`,不增加小版本拦截。包含预发布的前向准入仍须身份/API 检查,未知版本不继承实测结论;账号适配还须必要能力和 live `manualAccountLogin`。
20
20
 
21
21
  - 修改 peers、`dsh.compatibility`、运行时准入、测试目标、CI 或用户兼容声明前,对照两张矩阵及所有相关条目。
22
22
  - `dsh-runtime`:适用版本与支持集合仍有交集则保留相应适配;交集为空时,在同一次变更删除专属实现与测试,更新两种语言的矩阵、条目和指南。共享安全校验不随专属分支删除。
23
- - `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.3.4` 兼容。
23
+ - `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.3.5` 兼容。
24
24
  - 缺少精确版本证据时保留实现,明确登记缺口。不同版本通过相同测试,不证明其内部实现相同。
25
- - 支持范围或共享宿主适配变更须对同一最终归档完整运行九版 CLI、browser、smoke,并保留完整账号回归;普通选择见开发指南。当前 full/发布独立验证相邻退役 `0.2.1-alpha.2`;六版一次性负向验收属于 `0.3.1` 迁移历史,本次不重复。
25
+ - 支持范围或共享宿主适配变更须对同一最终归档完整运行十版 CLI、browser、smoke,并保留完整账号回归;普通选择见开发指南。当前 full/发布独立验证相邻退役 `0.2.1-alpha.2`;六版一次性负向验收属于 `0.3.1` 迁移历史,本次不重复。
26
26
 
27
27
  ## 功能 → 版本对照表
28
28
 
29
29
  各行列出适配或迁移及其精确适用宿主。稳定条目保留历史原生事实;退役仅删除独占实现,保留共享安全校验。
30
30
 
31
- | 条目 | 精确适用 DSH 版本 | 当前处理 |
32
- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
33
- | [DSH-HOST-001](#dsh-host-001),旧 IPv4 schema/TLS 拒绝 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` | 与支持集合无交集;`0.3.1` 删除独占实现/测试;保留原生 Config 和具体绑定 |
34
- | [DSH-PROTOCOL-001](#dsh-protocol-001),HTTP/回环 bridge | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` | 无交集;删除回退;保留真实协议、规范化 authority 和 Secure 分离 |
35
- | [DSH-PUBLIC-001](#dsh-public-001),无 CLI 选项 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2` | 无交集;删除缺失选项及旧回环投影路径 |
36
- | [DSH-PUBLIC-001](#dsh-public-001),文本投影 | `0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;删除文本位置选择;固定检查 context 和环境,仍观察 sections 中泄露/重复 |
37
- | [DSH-THEME-001](#dsh-theme-001),radius 补值 | `0.1.7-rc.1` | 无支持交集;旧 radius 后备值已移除,保留主题/视觉检查 |
38
- | [DSH-THEME-001](#dsh-theme-001),switch-thumb 补值 | `0.1.7-rc.1`、`0.1.7-rc.2` | 无交集;`0.3.1` 已删除补值,保留原生 token 与视觉/焦点回归 |
39
- | [DSH-THEME-001](#dsh-theme-001), 焦点颜色迁移 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` | 已按精确原生规则迁移;当前九个受支持版本保留共享视觉/可见键盘焦点检查 |
40
- | [DSH-TEST-001](#dsh-test-001),直接 Settings 导航 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;`0.3.1` 已删除直接入口,固定账号菜单;通用异步重试保留 |
41
- | [DSH-ACCOUNT-001](#dsh-account-001),手动回环回填 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` | 保留;全局准入后删除服务端旧版本分流;导出 helper 仍检查省略/无效/低版本输入 |
42
- | [DSH-HMR-001](#dsh-hmr-001),监听器上下文隔离 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` | 保留受支持宿主适配;仅移除退役版矩阵目标 |
43
- | [DSH-RESOURCE-001](#dsh-resource-001) | `0.2.2-alpha.2`、`0.2.2-alpha.3` | 保留单实例私有 HTTP resource 门禁;原生进程内 peer 读取不变;当前支持交集仅 `0.2.2-alpha.3`,保留全部实现/安全测试 |
44
- | [DSH-LIVESHARE-001](#dsh-liveshare-001) | `0.2.2-alpha.2`、`0.2.2-alpha.3` | 公开 peer/baseline 隔离与 connection/request Origin 业务恢复;本地原生 HTTPS/代理 Relay 协议往返已验证;当前支持交集仅 `0.2.2-alpha.3`,保留全部实现/安全测试 |
45
- | [DSH-SETTINGS-ICON-001](#dsh-settings-icon-001) | `0.2.2-alpha.3` | 原生可选图标槽;其余精确默认范围见条目 |
46
- | [PLUGIN-CONFIG-001](#plugin-config-001) | 插件 `0.1.5` allowedOrigins 输入,与 DSH 版本无关 | 按独立契约保留 |
47
- | [PLUGIN-LOCALE-001](#plugin-locale-001) | Plugin `0.3.2`; 独立于 DSH 版本 | 新记忆合同;旧 key 不读取/清理/迁移 |
48
- | [PLUGIN-CLI-001](#plugin-cli-001) | Plugin `0.3.2`; 独立于 DSH 版本 | 固定英语;此前 --lang 由插件政策结束 |
31
+ | 条目 | 精确适用 DSH 版本 | 当前处理 |
32
+ | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
33
+ | [DSH-HOST-001](#dsh-host-001),旧 IPv4 schema/TLS 拒绝 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` | 与支持集合无交集;`0.3.1` 删除独占实现/测试;保留原生 Config 和具体绑定 |
34
+ | [DSH-PROTOCOL-001](#dsh-protocol-001),HTTP/回环 bridge | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` | 无交集;删除回退;保留真实协议、规范化 authority 和 Secure 分离 |
35
+ | [DSH-PUBLIC-001](#dsh-public-001),无 CLI 选项 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2` | 无交集;删除缺失选项及旧回环投影路径 |
36
+ | [DSH-PUBLIC-001](#dsh-public-001),文本投影 | `0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;删除文本位置选择;固定检查 context 和环境,仍观察 sections 中泄露/重复 |
37
+ | [DSH-THEME-001](#dsh-theme-001),radius 补值 | `0.1.7-rc.1` | 无支持交集;旧 radius 后备值已移除,保留主题/视觉检查 |
38
+ | [DSH-THEME-001](#dsh-theme-001),switch-thumb 补值 | `0.1.7-rc.1`、`0.1.7-rc.2` | 无交集;`0.3.1` 已删除补值,保留原生 token 与视觉/焦点回归 |
39
+ | [DSH-THEME-001](#dsh-theme-001), 焦点颜色迁移 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` | 已按精确原生规则迁移;当前十个受支持版本保留共享视觉/可见键盘焦点检查 |
40
+ | [DSH-TEST-001](#dsh-test-001),直接 Settings 导航 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;`0.3.1` 已删除直接入口,固定账号菜单;通用异步重试保留 |
41
+ | [DSH-ACCOUNT-001](#dsh-account-001),手动回环回填 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` | 保留;全局准入后删除服务端旧版本分流;导出 helper 仍检查省略/无效/低版本输入 |
42
+ | [DSH-HMR-001](#dsh-hmr-001),监听器上下文隔离 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` | 保留受支持宿主适配;仅移除退役版矩阵目标 |
43
+ | [DSH-RESOURCE-001](#dsh-resource-001) | `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` | 保留单实例私有 HTTP resource 门禁;原生进程内 peer 读取不变;当前支持交集为 `0.2.2-alpha.3`、`0.2.2-rc.1`,保留全部实现/安全测试 |
44
+ | [DSH-LIVESHARE-001](#dsh-liveshare-001) | `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` | 公开 peer/baseline 隔离与 connection/request Origin 业务恢复;本地原生 HTTPS/代理 Relay 协议往返已验证;当前支持交集为 `0.2.2-alpha.3`、`0.2.2-rc.1`,保留全部实现/安全测试 |
45
+ | [DSH-SETTINGS-ICON-001](#dsh-settings-icon-001) | `0.2.2-alpha.3`、`0.2.2-rc.1` | 原生可选图标槽;其余精确默认范围见条目 |
46
+ | [PLUGIN-CONFIG-001](#plugin-config-001) | 插件 `0.1.5` allowedOrigins 输入,与 DSH 版本无关 | 按独立契约保留 |
47
+ | [PLUGIN-LOCALE-001](#plugin-locale-001) | Plugin `0.3.2`; 独立于 DSH 版本 | 新记忆合同;旧 key 不读取/清理/迁移 |
48
+ | [PLUGIN-CLI-001](#plugin-cli-001) | Plugin `0.3.2`; 独立于 DSH 版本 | 固定英语;此前 --lang 由插件政策结束 |
49
49
 
50
50
  ## 版本 → 功能对照表
51
51
 
@@ -68,7 +68,8 @@ HOST/PROTOCOL、PUBLIC 参数/文本、THEME radius/thumb 与 TEST 直接导航
68
68
  | `0.2.1-rc.4` | 支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换; DSH-SETTINGS-ICON-001:宿主默认 |
69
69
  | `0.2.1-rc.5` | 支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换; DSH-SETTINGS-ICON-001:宿主默认 |
70
70
  | `0.2.2-alpha.2` | `0.3.4` 退役(2026-11-05);最后历史支持 `0.3.3` | DSH-RESOURCE-001, DSH-LIVESHARE-001, DSH-ACCOUNT-001, DSH-HMR-001, DSH-THEME-001; 保留原生验证、context/主题/Settings 共同检查;最终同包报告另记; DSH-SETTINGS-ICON-001:宿主默认 |
71
- | `0.2.2-alpha.3` | 受支持;开发默认及推荐宿主 | DSH-THEME-001、DSH-ACCOUNT-001、DSH-HMR-001、DSH-RESOURCE-001、DSH-LIVESHARE-001、DSH-SETTINGS-ICON-001 原生盾牌;保留共享原生/安全检查 |
71
+ | `0.2.2-alpha.3` | 受支持 | DSH-THEME-001、DSH-ACCOUNT-001、DSH-HMR-001、DSH-RESOURCE-001、DSH-LIVESHARE-001、DSH-SETTINGS-ICON-001 原生盾牌;保留共享原生/安全检查 |
72
+ | `0.2.2-rc.1` | 受支持;开发默认及推荐 RC 预发布宿主 | DSH-THEME-001、DSH-ACCOUNT-001、DSH-HMR-001、DSH-RESOURCE-001、DSH-LIVESHARE-001、DSH-SETTINGS-ICON-001 原生盾牌;保留共享原生/安全检查 |
72
73
 
73
74
  PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均独立于运行时适配退役,适用于当前插件的全部宿主;前向准入不构成精确实测。
74
75
 
@@ -87,7 +88,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
87
88
  | 字段 | 维护依据 |
88
89
  | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
89
90
  | 适配适用版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` 的原生 schema 仅列 `127.0.0.1` 与 `0.0.0.0`;插件自行校验具体 IPv4,拒绝通配、IPv6 与 TLS |
90
- | 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听 |
91
+ | 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听 |
91
92
  | 实现与上游 | `src/config.ts`、`src/adapters/dsh/runtime-capabilities.ts`、`src/adapters/dsh/webserver.ts`;精确 `@deepseek-ai/dsh-host-webserver/lib/index.js` 的 Config 与 listener。统一 `resolveStartupConfig` 已替代过渡 resolver |
92
93
  | 测试与证据 | `tests/unit/config.test.ts`、`tests/integration/dsh-adapter.test.ts`、`tests/integration/native-transport.test.ts`、`tests/browser/native-transport.spec.ts`。2026-10-10 的 `0.2.1-alpha.2` 验证覆盖 IPv4、IPv6、mapped/scoped 回环及非回环 IPv4;非回环 IPv6 缺少可绑定接口,仅核对 schema 与策略 |
93
94
  | 迁移与退役 | 仅当所有“适配适用版本”退出支持集合,或逐个取得原生能力证据并完成迁移后,删除该集合独占的 IPv4/schema 分支与拒绝测试。保留通配拒绝、端口验证、包身份及共同门禁 |
@@ -101,7 +102,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
101
102
  | 字段 | 维护依据 |
102
103
  | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
103
104
  | 回退适用版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` 无原生 TLS/protocol API,且 Connection 不识别具体非回环 bind;服务端桥接保留 HTTP / `127.0.0.1`,实际 listener 与插件公开 URL 仍使用具体 IPv4 |
104
- | 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致 |
105
+ | 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致 |
105
106
  | 实现与上游 | `runtime-capabilities.ts` 的 `listenerProtocol`、`listenerTransport`,以及 `src/adapters/dsh/{readiness,browser-auth,startup-urls}.ts`、`src/http/gate.ts`、`src/index.ts`、[cordis.patch.yml](../cordis.patch.yml)。`connectionTrustedHosts` 合并最终 nativeAuthority、保留路径所需的公开 authority 与显式 CLI 信任,不扩大外层来源准入 |
106
107
  | 测试与证据 | `tests/integration/native-transport.test.ts`、`tests/browser/native-transport.spec.ts`、`tests/browser/proxy-chain.spec.ts`。2026-10-10 的 `0.1.7-rc.1`、`0.2.1-alpha.1` 实际非回环包证明需要回环桥接;`0.2.1-alpha.2` 验证 HTTPS/IPv6 MFA、Host 设置、CLI 撤销与 mapped IPv6 HTTP/HTTPS |
107
108
  | 迁移与退役 | 对每个“回退适用版本”取得原生 protocol/authority 支持证据后才迁移;该集合与支持范围无交集时删除专属回退。保留 HTTP 正向、双向代理、Cookie Secure、流撤销及共享认证检查 |
@@ -114,14 +115,14 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
114
115
 
115
116
  公开地址投影和模型提示位置差异,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
116
117
 
117
- | 字段 | 维护依据 |
118
- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
119
- | 无原生参数的版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2` 无 `--public-url`;保留原生模型 Web 文本与 `DSH_WEB_URL`:固定 `127.0.0.1` 加实际端口、无末尾斜杠。插件自身唯一公开入口仍可配置,不能将其误写成原生 CLI 能力 |
120
- | 原生文本投影版本 | `0.2.1-alpha.1`、`0.2.1-alpha.2` 原生消费 `webServer.publicUrl`,模型 system prompt Web 文本与 `DSH_WEB_URL` 使用插件最终公开根地址 |
121
- | 原生上下文投影版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址 |
122
- | 实现与上游 | [cordis.patch.yml](../cordis.patch.yml)、`src/adapters/dsh/startup-urls.ts`;精确 WebApp `lib/startup.js`、`lib/index.js` 与 `harness-dev-context`。Connection 必须依赖 webStartup/webServer,不能等待已移除的 webRuntime |
123
- | 测试与证据 | `tests/browser/deployment-profile.spec.ts`、`tests/browser/startup-compatibility.spec.ts`、`tests/fixtures/startup-observer.mjs`;调用真实 `systemPrompt.assemble` 与 `shellEnv.collect`,按精确版本断言文本段或上下文、环境变量与无 token。2026-10-09 的安装包证实无参数集合及 `0.2.1-alpha.1` 的分界;2026-10-15 核对 `0.2.1-alpha.3` 的上下文变化 |
124
- | 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`0.2.1-alpha.1`、`0.2.1-alpha.2` 仍受支持时保留文本位置断言;`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
118
+ | 字段 | 维护依据 |
119
+ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
120
+ | 无原生参数的版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2` 无 `--public-url`;保留原生模型 Web 文本与 `DSH_WEB_URL`:固定 `127.0.0.1` 加实际端口、无末尾斜杠。插件自身唯一公开入口仍可配置,不能将其误写成原生 CLI 能力 |
121
+ | 原生文本投影版本 | `0.2.1-alpha.1`、`0.2.1-alpha.2` 原生消费 `webServer.publicUrl`,模型 system prompt Web 文本与 `DSH_WEB_URL` 使用插件最终公开根地址 |
122
+ | 原生上下文投影版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址 |
123
+ | 实现与上游 | [cordis.patch.yml](../cordis.patch.yml)、`src/adapters/dsh/startup-urls.ts`;精确 WebApp `lib/startup.js`、`lib/index.js` 与 `harness-dev-context`。Connection 必须依赖 webStartup/webServer,不能等待已移除的 webRuntime |
124
+ | 测试与证据 | `tests/browser/deployment-profile.spec.ts`、`tests/browser/startup-compatibility.spec.ts`、`tests/fixtures/startup-observer.mjs`;调用真实 `systemPrompt.assemble` 与 `shellEnv.collect`,按精确版本断言文本段或上下文、环境变量与无 token。2026-10-09 的安装包证实无参数集合及 `0.2.1-alpha.1` 的分界;2026-10-15 核对 `0.2.1-alpha.3` 的上下文变化 |
125
+ | 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`0.2.1-alpha.1`、`0.2.1-alpha.2` 仍受支持时保留文本位置断言;`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
125
126
 
126
127
  2026-10-28 退役证据:上列精确历史适用集合与受支持的 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 无交集。实际安装 Config/协议/地址 API 及新 RC 相同发布 lib 树已核验。插件 `0.3.1` 已删除独占能力布尔值、旧 schema/协议/authority、公开选项/文本位置选择及专属测试。引用文件中的端口/API/schema/身份/HTTP/TLS/IPv6/代理/Secure/来源/撤销共享检查保留。
127
128
 
@@ -132,10 +133,10 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
132
133
  | 字段 | 维护依据 |
133
134
  | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
134
135
  | 补值适用版本 | `0.3.1` 历史迁移:历史 radius-md/lg 对应 `0.1.7-rc.1`,switch-thumb 对应 `0.1.7-rc.1`、`0.1.7-rc.2`;重复焦点颜色 fallback 按七版原生规则迁移 |
135
- | 原生能力版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 均提供 radius/thumb 定义与相同原生焦点规则;focus-ring-color 是可选 override,不是正常键盘模式必有的 root token。历史 radius 从 `0.1.7-rc.2`、thumb 从 `0.2.0-rc.1` 已确认 |
136
+ | 原生能力版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 均提供 radius/thumb 定义与相同原生焦点规则;focus-ring-color 是可选 override,不是正常键盘模式必有的 root token。历史 radius 从 `0.1.7-rc.2`、thumb 从 `0.2.0-rc.1` 已确认 |
136
137
  | 实现与上游 | `src/client/settings/style.css`、`src/client/account/style.css` 直接读取原生 radius/thumb;焦点只设 solid outline、`--dsw-focus-ring-width` 和 offset,颜色委托宿主 :focus-visible;独立登录页保持自身样式 |
137
138
  | 测试与证据 | `tests/browser/dsh-bootstrap.spec.ts`、`tests/browser/login.spec.ts`、`tests/browser/account-login.spec.ts` 与 `.cache/ui-review/<version>` 人工截图复核。2026-10-16 精确安装包主题定义证实`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 的 switch 滑块 token 分界。2026-10-09 核对 `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`;2026-10-10 核对 `0.2.1-alpha.2`;2026-10-15 核对 `0.2.1-alpha.3`。2026-10-19 核对精确 `0.2.1-alpha.5` 主题定义,确认提供相同圆角、焦点与 switch 滑块 token。 |
138
- | 迁移与退役 | 旧 radius/thumb 适用集合退出后移除专属 fallback;当前九个受支持版本的焦点颜色已按原生规则迁移,不直接读取未定义 override。保留动态主题、布局、可见焦点、开关外观和共享视觉测试 |
139
+ | 迁移与退役 | 旧 radius/thumb 适用集合退出后移除专属 fallback;当前十个受支持版本的焦点颜色已按原生规则迁移,不直接读取未定义 override。保留动态主题、布局、可见焦点、开关外观和共享视觉测试 |
139
140
 
140
141
  2026-10-28 清理:旧 radius、switch-thumb 和直接 Settings 的精确适用集合如上表,与七版支持无交集;删除专属实现。重复焦点颜色 fallback 依据七版原生规则迁移,不假定正常模式存在 focus-ring-color。通用引导、重开、持久化重试及共享视觉断言保留。
141
142
 
@@ -145,13 +146,13 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
145
146
 
146
147
  设置导航与首次引导测试适配,类型为 `dsh-runtime`,直接入口已在插件 `0.3.1` 退役;通用首次引导重试保留,notice/reload 的精确触发范围仍有证据缺口。
147
148
 
148
- | 字段 | 维护依据 |
149
- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
150
- | 直接设置入口版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 使用侧栏设置和 API Key 引导 |
151
- | 账号菜单入口版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 使用账号菜单 → 设置与原生官方账号引导;手动登录浮层不创建另一设置入口,通用异步重试继续保留。 |
152
- | 已知缺口 | 对 `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`,notice 延迟、确认中替换、首次 API Key 保存与页面重载之间的逐项映射尚未完整建立。不能把共享 helper 通过当作每个触发条件都已逐版复现 |
153
- | 实现与测试 | `tests/helpers/runtime.ts` 的 `openDshSettings`、`completeApiKeyPrompt`、`clickThroughDshPrompts` 与 reopen;`tests/browser/dsh-bootstrap.spec.ts`、`tests/browser/dsh-gate.spec.ts`、`tests/browser/account-login.spec.ts` |
154
- | 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码 |
149
+ | 字段 | 维护依据 |
150
+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
151
+ | 直接设置入口版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 使用侧栏设置和 API Key 引导 |
152
+ | 账号菜单入口版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 使用账号菜单 → 设置与原生官方账号引导;手动登录浮层不创建另一设置入口,通用异步重试继续保留。 |
153
+ | 已知缺口 | 对 `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1`,notice 延迟、确认中替换、首次 API Key 保存与页面重载之间的逐项映射尚未完整建立。不能把共享 helper 通过当作每个触发条件都已逐版复现 |
154
+ | 实现与测试 | `tests/helpers/runtime.ts` 的 `openDshSettings`、`completeApiKeyPrompt`、`clickThroughDshPrompts` 与 reopen;`tests/browser/dsh-bootstrap.spec.ts`、`tests/browser/dsh-gate.spec.ts`、`tests/browser/account-login.spec.ts` |
155
+ | 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码 |
155
156
 
156
157
  `0.2.1-alpha.3` 的并发验证另发现:pnpm 共享硬链接的 ctime 会在其他隔离 profile 安装同包时变化,触发原生 HMR 并销毁客户端插件。测试安装改为复制文件,账号夹具校验客户端文件未共享硬链接;这不是首次引导重载的版本证据,不据此填补上述 notice/reload 缺口。
157
158
 
@@ -167,14 +168,14 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
167
168
 
168
169
  | 字段 | 维护依据 |
169
170
  | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
170
- | 原生能力与插件范围 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 均已有账号提供者和 API,但 ui-settings-account 的 `apply` 在没有 `dshDesktop` 时直接返回。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
171
+ | 原生能力与插件范围 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 均已有账号提供者和 API,但 ui-settings-account 的 `apply` 在没有 `dshDesktop` 时直接返回。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
171
172
  | 前向准入规则 | `>=0.2.1-alpha.3`,按 SemVer 包含预发布比较;必要 provider/slot API 可用且 `manualAccountLogin: true` 才接纳新授权。默认 true,使用 Loader 原位更新的 volatile 引用;profile override 不重建认证服务 |
172
173
  | 历史关闭分支 | 旧六版服务端分支随全局下限移除,不再保留正向目标;导出 helper 仍拒绝缺省/无效/旧参数。必要 API 缺失仍不可用,动态 false 拒绝新授权并保留已接纳 attempt |
173
174
  | 原因与上游 | 精确安装包的 account-platform `protocol.ts/loginOrigin` 在表列全部版本中仅接受带显式端口的回环 HTTP;ui-settings-account 默认使用浏览器 origin。公网浏览器无法自动回调 DSH 设备,外层门禁也拒绝跨站导航 |
174
175
  | 实现 | `src/shared/account-login.ts`、`src/http/account-login.ts`、`src/adapters/dsh/account-callback.ts`、`src/adapters/dsh/browser-capability.ts`、`src/client/account/`;公开 slots 的 entries/subscribe/priority 替换登录动作,独立 `shell.overlay` 展示说明、输入框和按钮。原生 `useApiKey` 继续凭据引导且不调用 `complete`,账号菜单通过 `openOnboarding` 重开编辑器;未开始授权时保留该选择,授权中保留取消。服务端绑定发起会话,保留临时原生回调 handler,仅从已鉴权 POST 内部分发真实 Node 响应;不请求粘贴 URL,不读取提供者私有状态,不改原生 PKCE 或凭据存储;动态配置保留 Loader 引用,回调仅在手动 attempt 占用时拦截,否则经过既有外层 gate 委托原生 handler;关闭配置不取消已接纳授权或卸载 provider;紧凑弹窗初始显示两步,授权中隐藏已完成指引,保留 API Key 选择、失败导航说明及过期反馈;直接回调通过提供者公开状态确认归属,原生取消后再发起原生授权时,无需等待插件 state 轮询即可恢复回调;取消拒绝时保留占用,直到公开状态证明终态或不同 attempt,并允许清理重试。`src/index.ts` 按顺序尝试全部关闭资源后才报告清理错误,在请求和连接清理尝试完成前保留状态锁。配置重试由原生镜像 ensure 恢复首次读取,已有镜像的命名空间刷新使用客户端明确注入的 remote.settings;菜单登录在偏好未知时等待共享读取,再按最新接纳值选择手动或原生动作。 |
175
- | 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.2-alpha.3` 提供者与本地平台替身,覆盖 PKCE、redirect URI、state、会话、重复、取消、撤销、过期及重试;通过公开取消接口故障注入验证活动手动回调仍被拦截,关闭失败回归检查 listener/admin socket 关闭且同一 profile 可重新获锁;`tests/browser/account-login.spec.ts` 覆盖未设置 `DEEPSEEK_API_KEY` 的无凭据引导、原生 API Key 保存和账号菜单重开、先说明再授权、失败导航回填、弹窗拦截与响应式八语主题;`tests/unit/client-capability.test.ts` 验证 SemVer 下限和无上限准入,模拟未来版本不构成实测声明;`tests/browser/live-config.spec.ts` 与 `tests/fixtures/live-config-observer.mjs` 观察真实 Loader 引用/fiber、listener、锁、长连接和重启持久化,最终逐版结果记录于执行文档。另覆盖首次 describe 失败后的整份镜像恢复、命名空间暂缺后的注入传输重试,以及 true/false 两种配置初始延迟期间点击登录不提前发起原生授权。 插件字典不扩充旧宿主原生语言目录。 |
176
+ | 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.2-rc.1` 提供者与本地平台替身,覆盖 PKCE、redirect URI、state、会话、重复、取消、撤销、过期及重试;通过公开取消接口故障注入验证活动手动回调仍被拦截,关闭失败回归检查 listener/admin socket 关闭且同一 profile 可重新获锁;`tests/browser/account-login.spec.ts` 覆盖未设置 `DEEPSEEK_API_KEY` 的无凭据引导、原生 API Key 保存和账号菜单重开、先说明再授权、失败导航回填、弹窗拦截与响应式八语主题;`tests/unit/client-capability.test.ts` 验证 SemVer 下限和无上限准入,模拟未来版本不构成实测声明;`tests/browser/live-config.spec.ts` 与 `tests/fixtures/live-config-observer.mjs` 观察真实 Loader 引用/fiber、listener、锁、长连接和重启持久化,最终逐版结果记录于执行文档。另覆盖首次 describe 失败后的整份镜像恢复、命名空间暂缺后的注入传输重试,以及 true/false 两种配置初始延迟期间点击登录不提前发起原生授权。 插件字典不扩充旧宿主原生语言目录。 |
176
177
  | 公网迁移条件 | 官方接受公网 `redirect_uri`,且目标精确 DSH 版本的来源策略、回调、兑换、UI、会话边界均经验证。仅平台开放、DSH 仍限制 `loginOrigin` 时不能直接删除。前向准入不构成已验证声明,新增实测声明仍须精确回归;只有原生公网流程已证实可用才迁移或退役 |
177
- | 退役与保留 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` 仍需回环,继续保留;只有适用集合退出支持或每个仍支持精确宿主的原生公网流程经验证可用才删除专属实现。共享 state/PKCE、会话归属、单次使用、撤销及禁止 URL 转发保留 |
178
+ | 退役与保留 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 仍需回环,继续保留;只有适用集合退出支持或每个仍支持精确宿主的原生公网流程经验证可用才删除专属实现。共享 state/PKCE、会话归属、单次使用、撤销及禁止 URL 转发保留 |
178
179
  | 证据限制 | 2026-10-15,本地平台替身与真实提供者完整兑换通过;官方 `auth_init` 的回环对照成功并取消,三种 `example.com` 公网写法被 schema 拒绝。未验证真实官方账号完整授权,也未排除官方按域名白名单开放的可能 |
179
180
 
180
181
  2026-10-28:七个准入宿主都使用原生元数据对象调用。全局准入后服务端不再按旧版本停用 provider 或 bridge;能力检查和动态偏好语义保留。独立导出的 index 注入 helper 对省略、无效、低版本输入仍只提供 ownsHost,不授予手动标志。`tests/unit/client-capability.test.ts` 分别验证两个边界。
@@ -187,7 +188,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
187
188
 
188
189
  | 字段 | 维护依据 |
189
190
  | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
190
- | 适用版本 | `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-alpha.1`, `0.2.1-alpha.2`, `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3` |
191
+ | 适用版本 | `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-alpha.1`, `0.2.1-alpha.2`, `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5`、`0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` |
191
192
  | 原生行为与静态证据 | 2026-10-16 逐版核对 `@deepseek-ai/dsh-hmr/lib/index.js`:`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 的 `runExclusive` 都以私有 `executing: AsyncLocalStorage` 的布尔标记拒绝嵌套事务;原生 `watchConfig` 自身用 `executing.exit` 创建长期 watcher。热重载事务内创建的 HTTP/HTTPS 监听器会让后续独立请求继承旧标记。 2026-10-19 复核精确 `0.2.1-alpha.5` 的 JavaScript 与类型,和 `0.2.1-alpha.4` 逐字相同,未新增公开监听器隔离 API。 精确 `0.2.2-alpha.2` 发布包仍使用 private `executing: AsyncLocalStorage` 的 true marker 与 runExclusive 嵌套拒绝,没有公开监听器隔离接口;不能据同名方法推定未来版本。 |
192
193
  | 实现边界 | `src/adapters/dsh/hmr-context.ts`、`src/index.ts`:仅在原生监听器初始化期间,确认 `runExclusive`、原生 AsyncLocalStorage 与当前 true 标记后调用 `exit`。明确依赖私有字段形状,公开 API 暂无对应入口。字段或标记不匹配时保持原生初始化行为;不改写 HMR 队列,不在设置保存/请求分派层退出事务,不削弱真实嵌套拒绝。 |
193
194
  | 测试与证据 | `tests/browser/account-login.spec.ts`、`tests/fixtures/hmr-config-probe.mjs`。`0.2.1-alpha.3` 安装代码变更后经原生 profile watch 重载,已精确复现并修复用户的 settings/rejected “HMR transactions cannot be nested”。`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 的真实配置 HMR/队列专项全部通过:监听器 generation 增加,独立保存等待已有事务、真实嵌套仍拒绝、原会话仍有效;`0.2.1-alpha.3`、`0.2.1-alpha.4` 安装代码替换后重新开启也通过。2026-10-16 本轮专项共 10/10;未来版本不能继承这些明确版本的静态或运行结论。 当前模块替换回归另覆盖 `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`;精确命令、数量与最终同包结果另记执行记录。 `0.2.2-alpha.2` 的 `tests/fixtures/hmr-lifecycle-probe.mjs` 和 browser 故障用例观察:导入失败保留同一实例;真实初始化后失败释放旧/失败实例,再由原生用旧实现创建新 fiber。随后成功替换、首次 Settings 写入、真实 mux 断连、锁释放/再获取和认证状态持久化均纳入用例。最终同包报告另记。 |
@@ -201,7 +202,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
201
202
 
202
203
  | 字段 | 维护依据 |
203
204
  | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
204
- | 精确适用版本 | `0.2.2-alpha.2`、`0.2.2-alpha.3`;当前支持交集仅 `0.2.2-alpha.3`,保留。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5` 保留 handler 注册门禁。 |
205
+ | 精确适用版本 | `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1`;当前支持交集为 `0.2.2-alpha.3`、`0.2.2-rc.1`,保留。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5` 保留 handler 注册门禁。 |
205
206
  | 原生形状与顺序 | 精确发布 `@deepseek-ai/dsh-host-webserver@0.2.2-alpha.2`,`lib/index.js` 427–440、456–471、599–628 行;源码 tag `dsh-v0.2.2-alpha.2`(`f3803c96974ad4a94195fb97e5c637e9c2a3afe3`)。named/fallback resource 优先于 handler 分派。私有 `serveResource(req, res, target, resource)` 将 Node 头转为 Fetch Headers 并负责原生响应桥接。构造时先安装包装,再初始化监听器或注册 resource。方法存在不能证明未来语义相同。 |
206
207
  | 实现 | `src/adapters/dsh/webserver.ts`:单实例捕获原函数并保留 this;转换前执行 gate,根 token 删除后按已接纳 req.url 重建 target,然后委托原生。不修改 prototype、不复制路由/流、不将 resource 包成 handler、不伪造 owner、不包装 `readResource(request, peer)`;handler/upgrade 门禁保留。 |
207
208
  | 失败与生命周期 | resource 读取存在但缺失 serveResource、私有包装无法安装、未安装边界却注册 resource 时,按具体 API 错误拒绝激活/注册。DenyGate/readiness 保持关闭。AuthConnections 跟踪原始 Node response,覆盖等待 Response 与背压;IO 的 abort/body cancel 继续原生处理。不新增版本上限或未知版本拒绝。 |
@@ -222,7 +223,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
222
223
  | Origin 顺序 | 精确发布 Connection 先验证内部 Host/Cookie,再进入公开 connection/request waterfall。`src/adapters/dsh/liveshare.ts` 由 `src/index.ts` 每个 server fiber 安装一次,仅在 POST `/api/liveshare.ownerLoginStart`、POST `/api/liveshare.ownerLoginRedeem` 的 await next 期间恢复 requireRequestContext 中外层已验证的 Origin;finally 在成功、拒绝、取消时恢复旧头。缺失 Origin 保持缺失,缺失可信上下文拒绝;相似/子路径、其他方法、Cancel 和 ownerCredential 不变。 |
223
224
  | 保留安全与生命周期 | 外层原始头/来源/会话门禁、native admit、原生 Cookie authority、readiness、trustedHosts 和 preserveOriginPaths 保持。不能用 owner peer 替代 HTTP 鉴权,不绑定分享与插件会话生命周期。插件激活不启用 LiveShare,不改变生产 Relay 配置。 |
224
225
  | 测试与限制 | `tests/unit/client-capability.test.ts`、`tests/browser/liveshare.spec.ts`、`tests/fixtures/liveshare-viewer.mjs` 和 liveshare-client-observer.js 验证真实原生 viewer carrier/index 与完整入口隔离;`tests/integration/liveshare-origin.test.ts` 以真实 Node 请求对象检查公开 waterfall 头恢复、精确选择与 fiber 销毁/重载;`tests/helpers/liveshare-relay.ts`、`tests/fixtures/liveshare-session.mjs` 提供本地协议与薄探针,不替换 Host 服务。本地 Relay 协议专项覆盖原生 HTTPS 与 HTTPS→HTTP 入口、真实 Start/Redeem 的 state/PKCE/取消/重试、原生 worker、create/list/stop、真实 viewer index/资源/载体及被原生接纳的 viewer channel 操作;匿名/撤销/错误、缺失、重复 Origin 和跨站请求仍在外层拒绝,退出不停止分享。替身只提供 Relay consent/身份/传输,原生载体由真实 plain Node Host 序列化;不代表真实 Relay/OAuth/产品体验、访客模型操作或文件写入。 |
225
- | 迁移与退役 | 受支持的 `0.2.2-alpha.2`、`0.2.2-alpha.3` 仍需这些边界时保留。原生提供公开业务 Origin 合同后先取得精确证据并迁移;仅当全部受支持适用版本已迁移或支持交集为空才删除专属实现/测试;共享准入、owner/viewer 身份与生命周期回归保留。 |
226
+ | 迁移与退役 | 受支持的 `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1` 仍需这些边界时保留。原生提供公开业务 Origin 合同后先取得精确证据并迁移;仅当全部受支持适用版本已迁移或支持交集为空才删除专属实现/测试;共享准入、owner/viewer 身份与生命周期回归保留。 |
226
227
 
227
228
  2026-11-03 扩展:精确 Connection、account、account-platform、authorization 和 LiveShare protocol 的 lib 树在 `0.2.2-alpha.2`、`0.2.2-alpha.3` 之间逐字相同,两版仍需上述边界。`0.2.2-alpha.3` 的 LiveShare 实现本身有变化,不宣称整个包相同。其已发布实验性 bundle 位于 `OPTIONAL_BUNDLES`,`listedByDefault: false`,出厂 Web profile 不启用。保留必要本地协议回归和 viewer 隔离,不自动启用,也不宣称生产 Relay/OAuth、真实访客模型调用或文件写入已验证。
228
229
 
@@ -232,19 +233,19 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
232
233
 
233
234
  | 字段 | 维护依据 |
234
235
  | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
235
- | 原生图标适用范围 | 精确 DSH `0.2.2-alpha.3` 声明 `settings.section.icon`,以 `settings.section` 的 `security` id 匹配。 |
236
- | 默认图标政策 | 精确 DSH `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2` 无该声明,保留宿主默认;十个精确 primitives 包均导出 `IconShieldOutlineMedium`。 |
236
+ | 原生图标适用范围 | 精确 DSH `0.2.2-alpha.3`、`0.2.2-rc.1` 声明 `settings.section.icon`,以 `settings.section` 的 `security` id 匹配。 |
237
+ | 默认图标政策 | 精确 DSH `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2` 无该声明,保留宿主默认;十一个精确 primitives 包均导出 `IconShieldOutlineMedium`。 |
237
238
  | 实现与生命周期 | `src/client/index.ts`、`package.json` 的客户端模块依赖、`scripts/build.mjs`/`check-package.mjs`。仅管理员判定后以原生 `slots.inject`/`register` 注册 `IconShieldOutlineMedium`,传递 slot size;`currentColor`、选中态、标签和装饰性无障碍容器由宿主拥有。声明缺失时等待且无贡献,声明撤下释放、重建仅注册一次,客户端卸载清理;DSH 模块/React 继续 external,不替换服务、DOM 或图标。 |
238
- | 测试与精确证据 | `tests/browser/settings-icon.spec.ts` 九版均注册;`tests/fixtures/settings-icon-observer.js` 仅在测试保留真实原生工厂/facade/disposer。检查原生模块/元素身份、明暗桌面/窄屏选中/未选中、仅释放贡献保留 section 并恢复默认、真实 settings-general 销毁/重建两次、去重、客户端卸载和 viewer 早退;`tests/browser/liveshare.spec.ts` 另检查真实 viewer carrier。上述精确 tag/commit、Settings contract 和 ui-renderer declaration epoch 生命周期证明 API,截图与同包结果不入包。 |
239
- | 退役 | 受支持精确 `0.2.2-alpha.3` 仍需贡献时保留;未来原生替代须精确证据及迁移,支持交集为空时才可删除专属贡献/import/测试,并同步两种语言及两个维度矩阵。保留管理员边界、宿主所有权和共享视觉/安全检查。 |
239
+ | 测试与精确证据 | `tests/browser/settings-icon.spec.ts` 十版均注册;`tests/fixtures/settings-icon-observer.js` 仅在测试保留真实原生工厂/facade/disposer。检查原生模块/元素身份、明暗桌面/窄屏选中/未选中、仅释放贡献保留 section 并恢复默认、真实 settings-general 销毁/重建两次、去重、客户端卸载和 viewer 早退;`tests/browser/liveshare.spec.ts` 另检查真实 viewer carrier。上述精确 tag/commit、Settings contract 和 ui-renderer declaration epoch 生命周期证明 API,截图与同包结果不入包。 |
240
+ | 退役 | 受支持精确 `0.2.2-alpha.3`、`0.2.2-rc.1` 仍需贡献时保留;未来原生替代须精确证据及迁移,支持交集为空时才可删除专属贡献/import/测试,并同步两种语言及两个维度矩阵。保留管理员边界、宿主所有权和共享视觉/安全检查。 |
240
241
 
241
242
  ## PLUGIN-CONFIG-001
242
243
 
243
- 插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.3.4` 保留;与 DSH 版本集合无关。
244
+ 插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.3.5` 保留;与 DSH 版本集合无关。
244
245
 
245
246
  | 字段 | 维护依据 |
246
247
  | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
247
- | 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.3.1`、`0.3.2`、`0.3.3` 与 `0.3.4` 仍保留 |
248
+ | 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.3.1`、`0.3.2`、`0.3.3` 、`0.3.4` 与 `0.3.5` 仍保留 |
248
249
  | 行为与实现 | `src/config.ts`、[cordis.patch.yml](../cordis.patch.yml)。省略字段与显式空数组可区分;单项转成唯一 `publicUrl`,空数组按监听结果派生;多项、重复项和新字段共存报错。每次激活仅一次弃用提示,不改写 profile;统一启动前解析、监听后定稿 |
249
250
  | 测试 | `tests/unit/config.test.ts`、`tests/unit/origin-policy.test.ts`、`tests/integration/http-gate.test.ts`、`tests/browser/startup-compatibility.spec.ts`;真实 Loader 覆盖 0/1 项、多项、重复、null、file/CLI 冲突、警告次数与 profile 不改写 |
250
251
  | 迁移与退役 | 只有插件产品契约明确结束这组输入支持并提供迁移说明时才删除专属检测、转换及测试。任一 DSH 版本退出支持都不足以触发退役;保留唯一 URL 校验与来源安全回归 |
@@ -267,9 +268,9 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
267
268
 
268
269
  ## 共享安全边界
269
270
 
270
- 远程 profile 必须独立禁用原生 `webserver`。`tests/browser/startup-compatibility.spec.ts` 在九版验证 Loader skip/插件运行拒绝:最低 `0.2.1-alpha.3` 用 peer 故障,其余八版用 engines;`scripts/verify-retired.mjs` 在独立旧 profile 验证原样候选的安装回滚/完整包原生 peer skip,要求连续无 TCP/HTTP/readiness/WebSocket 监听并保留上游身份和审计。
271
+ 远程 profile 必须独立禁用原生 `webserver`。`tests/browser/startup-compatibility.spec.ts` 在十版验证 Loader skip/插件运行拒绝:最低 `0.2.1-alpha.3` 用 peer 故障,其余九版用 engines;`scripts/verify-retired.mjs` 在独立旧 profile 验证原样候选的安装回滚/完整包原生 peer skip,要求连续无 TCP/HTTP/readiness/WebSocket 监听并保留上游身份和审计。
271
272
 
272
- `src/shared/dsh-support.ts` 记录三个 Alpha legacy、五个受支持 RC 和受支持 `0.2.2-alpha.3`;六版历史退役保留最后插件 `0.2.0`,`0.2.2-alpha.2` 则于 2026-11-05 在 `0.3.4` 退役,最后历史支持插件为 `0.3.3`。日期记录准备/决策,不是 npm 发布时间或定时拒绝。进程/HMR 提示去重、必要 API、身份和共享安全检查保留;零日上游故障例外见支持规范。
273
+ `src/shared/dsh-support.ts` 读取当前精确声明 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.3`、`0.2.2-rc.1` 并保留显式生命周期记录;六版历史退役保留最后插件 `0.2.0`,`0.2.2-alpha.2` 则于 2026-11-05 在 `0.3.4` 退役,最后历史支持插件为 `0.3.3`。日期记录准备/决策,不是 npm 发布时间或定时拒绝。进程/HMR 提示去重、必要 API、身份和共享安全检查保留;零日上游故障例外见支持规范。
273
274
 
274
275
  包身份、向前准入后的 API 检查、具体监听、原始 Host/Origin/Fetch Metadata、回环准入、密码/TOTP、会话、流撤销、存储故障与 CLI 确认适用于所有声明版本。反向代理 HTTPS → HTTP、Host 设置能力 `ownsHost` 和服务端原生浏览器认证交换也不能仅因某个适配退役而删除。
275
276
 
@@ -312,3 +313,11 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
312
313
  逐条交集复核:DSH-HOST-001、DSH-PROTOCOL-001 及 DSH-PUBLIC-001/DSH-THEME-001/DSH-TEST-001 独占路径维持既有空交集和退役证据;共享 context、原生主题/焦点和账号菜单检查仍覆盖当前九个精确声明。DSH-ACCOUNT-001、DSH-HMR-001 与同一支持集合的交集仍非空。DSH-RESOURCE-001、DSH-LIVESHARE-001 保留受支持精确 `0.2.2-alpha.3`,DSH-SETTINGS-ICON-001 仍保留精确 `0.2.2-alpha.3`。PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 独立不变。没有生产独占适配因此可删除;通用引导重试及证据缺口保持。
313
314
 
314
315
  `package.json`、`scripts/runtime.mjs`、`scripts/packed-artifact.mjs`、`scripts/verify-packed.mjs` 移除退役正向目标,browser 注册保留其余全部适用用例;`tests/browser/host-release.spec.ts` 改测 `0.2.2-alpha.3` ↔ `0.2.1-rc.5`,不再加载已退役运行时。`src/shared/dsh-support.ts` 与 `tests/unit/dsh-support.test.ts` 记录和检查退役分类及提示。技术准入及安全测试仍包含 `0.2.2-alpha.2`,不将其加入原生 peer 拒绝集合;独立退役 `0.2.1-alpha.2` 拒绝保持。须对新最终归档执行九版 CLI/browser/smoke,不能沿用旧归档结果。
316
+
317
+ ## 2026-11-06 RC 准入复核
318
+
319
+ `0.3.5` 新增精确 DSH `0.2.2-rc.1`,保留全部九个既有支持目标;开发默认与推荐为该上游 RC 预发布版本。精确 tag `dsh-v0.2.2-rc.1` 的 commit 为 `66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db`,与 `dsh-v0.2.2-alpha.3`(`05b1cae8db6e674c5685101494d4eec24652424a`)的完整源码差异为 387 个 manifest 仅改自身版本。24 对精确 npm 包共 48 个归档已核验身份/integrity,954 个两版 lib 文件相同,常规文件差异仅 manifest;不能把静态相同当作最终运行通过。真实 RC 链解析 WebApp、WebServer、Connection、account/account-platform 为 `0.2.2-rc.1`,Cordis `4.1.0`、Schemastery `3.19.0`、Loader/Include `1.1.0`,不重写旧宿主 SDK 事实。
320
+
321
+ 逐条交集决定:DSH-HOST-001、DSH-PROTOCOL-001 及 DSH-PUBLIC-001/DSH-THEME-001/DSH-TEST-001 的历史独占路径仍无支持交集,退役证据不变;共享原生 Config/协议、context、theme/focus、账号菜单验证扩为 `0.2.2-rc.1`。通用引导重试和 notice/reload 触发映射缺口保留。DSH-ACCOUNT-001 与 DSH-HMR-001 在 RC 仍分别需要 loopback 回填和 executing/runExclusive 事务隔离。DSH-RESOURCE-001 与 DSH-LIVESHARE-001 的精确适用历史为 `0.2.2-alpha.2`、`0.2.2-alpha.3`、`0.2.2-rc.1`,当前支持交集为 `0.2.2-alpha.3`、`0.2.2-rc.1`。DSH-SETTINGS-ICON-001 的原生盾牌集合为 `0.2.2-alpha.3`、`0.2.2-rc.1`;八个受支持默认及历史 `0.2.2-alpha.2` 默认政策保持。没有专属生产实现可因本次增加支持删除。PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 继续独立合同。
322
+
323
+ 代码/测试位置保持各条目所列;`tests/browser/{native-transport,account-login,login,liveshare,settings-icon,web-search-settings,rc-navigation}.spec.ts` 扩展 RC 精确分支,`host-release.spec.ts` 新增 `0.2.2-rc.1` ↔ `0.2.2-alpha.3` 并保留 `0.2.2-alpha.3` ↔ `0.2.1-rc.5`;固定归档消费者要求两版完整资源/mux/HMR/八语/图标及两种 Owner LiveShare 名称,拒绝 Search/Fetch/导航零注册。配置观测仍读 canonical fiber 的 effectiveConfig;生产 Volatile 不变。最终十版同包 CLI/browser/smoke、独立 `0.2.1-alpha.2` 拒绝、源码和归档身份及截图证据单独保留在 npm 包外;局部或历史成功不认证最终候选。真实授权、生产 Relay、非回环 IPv6 网卡及既有触发映射缺口不因 RC 标签关闭。
package/docs/releasing.md CHANGED
@@ -4,11 +4,11 @@
4
4
 
5
5
  Each release starts from a tested commit on `master`. A `vX.Y.Z` tag must match the stable version in `package.json` and the dated entries in both changelogs. The tag workflow checks the tag and master ancestry, builds one npm archive, verifies that exact archive on every declared DSH release, then verifies or publishes the npm version and creates a GitHub Release containing the same archive and `SHA256SUMS`.
6
6
 
7
- Version `0.3.4` declares nine exact targets, including `0.2.2-alpha.3`. Published `0.3.3` retains nine declarations and `0.3.2` retains eight and its immutable archive. Publication follows the PR, master-CI, tag and release-workflow sequence below. The completed workflow and npm registry establish actual availability. Final same-archive reports stay outside npm. The changelog records the release preparation date; `retiredOn: 2026-10-28` is not an npm publication timestamp.
7
+ Version `0.3.5` declares ten exact targets, including `0.2.2-rc.1`. Published `0.3.4` retains nine declarations without the RC; `0.3.3` retains its nine historical declarations and `0.3.2` retains eight and its immutable archive. Publication follows the PR, master-CI, tag and release-workflow sequence below. The completed workflow and npm registry establish actual availability. Final same-archive reports stay outside npm. The changelog records the release preparation date; `retiredOn: 2026-10-28` is not an npm publication timestamp.
8
8
 
9
9
  Before changing version support for a release, review the [legacy compatibility inventory](legacy-compatibility.md). Check peers, compatibility declarations, runtime admission, test targets, CI and guides together. Remove runtime adaptations whose applicable versions no longer intersect support in that same change, while keeping shared security checks. Old plugin configuration has independent retirement conditions; update both inventory languages and both matrix views with complete version numbers before packing.
10
10
 
11
- Before packing, update README, the support policy, the [DSH → plugin](support-history.md#by-dsh) and [plugin → DSH](support-history.md#by-plugin) history, and inventory in both languages. Keep historical rows/anchors, distinguish published `0.2.0`/`0.3.1`/`0.3.2`/`0.3.3` from the `0.3.4` release declaration, and never cite a nonexistent tag as verified evidence.
11
+ Before packing, update README, the support policy, the [DSH → plugin](support-history.md#by-dsh) and [plugin → DSH](support-history.md#by-plugin) history, and inventory in both languages. Keep historical rows/anchors, distinguish published `0.2.0`/`0.3.1`/`0.3.2`/`0.3.3`/`0.3.4` from the `0.3.5` release declaration, and never cite a nonexistent tag as verified evidence.
12
12
 
13
13
  ## Prepare the version
14
14
 
@@ -26,7 +26,7 @@ node scripts/pack.mjs
26
26
  node scripts/packed-artifact.mjs record
27
27
  ```
28
28
 
29
- Use Node.js 24 for production and every consumer, satisfying the selected Host's own requirement (`0.2.2-alpha.3` requires `>=24.9.0`); the plugin engine remains `>=24`. The direct integration command reuses the static build; `pack.mjs` creates the archive once, then `packed-artifact.mjs record` writes its checksum and exact full matrices. Consume that frozen archive serially across all declared targets:
29
+ Use Node.js 24 for production and every consumer, satisfying the selected Host's own requirement (`0.2.2-rc.1` requires `>=24.9.0`); the plugin engine remains `>=24`. The direct integration command reuses the static build; `pack.mjs` creates the archive once, then `packed-artifact.mjs record` writes its checksum and exact full matrices. Consume that frozen archive serially across all declared targets:
30
30
 
31
31
  ```sh
32
32
  node --input-type=module - <<'JS'
@@ -46,15 +46,15 @@ for (const version of testedDshVersions) {
46
46
  JS
47
47
  ```
48
48
 
49
- Every current full/release also verifies adjacent retired `0.2.1-alpha.2` against that same archive. The six-host one-time negative acceptance belongs to the `0.3.1` migration history and is not repeated for `0.3.4`; negative reports stay separate from the positive business matrix.
49
+ Every current full/release also verifies adjacent retired `0.2.1-alpha.2` against that same archive. The six-host one-time negative acceptance belongs to the `0.3.1` migration history and is not repeated for `0.3.5`; negative reports stay separate from the positive business matrix.
50
50
 
51
51
  ```sh
52
- node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.4.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
52
+ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.5.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
53
53
  ```
54
54
 
55
55
  Do not build or pack inside the consumer loop. An archive content change requires a new candidate and full verification. JSON reports record the hash, exact release, suite scope, commands and actual test counts. See the [fixed-archive guide](development.md#consume-a-fixed-archive).
56
56
 
57
- The workflow DAG is `tag` → `package` → reusable `verify-packed.yml` → `publish`. The producer uploads one `release-package` artifact. Independent CLI/smoke and complete-browser jobs cover all nine declared releases and check the producer's expected SHA-256, package identity and checksum file before consumption. A validation job rejects incomplete matrices; the full-plan aggregate requires every planned job, including the independent `0.2.1-alpha.2` retired-rejection job, to succeed. Failure, cancellation or an unexpected skip blocks publication.
57
+ The workflow DAG is `tag` → `package` → reusable `verify-packed.yml` → `publish`. The producer uploads one `release-package` artifact. Independent CLI/smoke and complete-browser jobs cover all ten declared releases and check the producer's expected SHA-256, package identity and checksum file before consumption. A validation job rejects incomplete matrices; the full-plan aggregate requires every planned job, including the independent `0.2.1-alpha.2` retired-rejection job, to succeed. Failure, cancellation or an unexpected skip blocks publication.
58
58
 
59
59
  `publish` downloads the same artifact and checks it against the producer's expected digest again. It never builds or packs. Existing npm-version byte comparison, trusted publishing and GitHub Release retry behavior remain in place. The workflow publishes the verified tgz with `npm publish ./artifacts/dsh-auth-remote-X.Y.Z.tgz --access public`; no local npm publication is needed.
60
60
 
@@ -81,4 +81,4 @@ npm view dsh-auth-remote@X.Y.Z version dist.integrity
81
81
 
82
82
  The GitHub Release includes the `.tgz` and `SHA256SUMS`. Download them into the same directory and run `sha256sum -c SHA256SUMS` there to check the release asset. A failed workflow should be inspected in **Actions → Release** before retrying; npm versions are immutable, so the workflow only skips an existing version when its archive bytes match.
83
83
 
84
- For an uncommitted local candidate, also freeze source identity: HEAD, status, complete binary diff, nonignored new-file digests, a path/type/mode/SHA-256 manifest of tracked and new source/tests/scripts/configuration/docs/locks, and the original index baseline. Exclude task, runtime data, reports and generated output. Compare source manifest, index and tgz digest before and after consumption. Any source, test, script, lock or packaged-document edit requires core checks, a new freeze and all nine CLI/browser/smoke targets plus independent refusal again; HEAD alone and old-archive success are insufficient.
84
+ For an uncommitted local candidate, also freeze source identity: HEAD, status, complete binary diff, nonignored new-file digests, a path/type/mode/SHA-256 manifest of tracked and new source/tests/scripts/configuration/docs/locks, and the original index baseline. Exclude task, runtime data, reports and generated output. Compare source manifest, index and tgz digest before and after consumption. Any source, test, script, lock or packaged-document edit requires core checks, a new freeze and all ten CLI/browser/smoke targets plus independent refusal again; HEAD alone and old-archive success are insufficient.
@@ -4,11 +4,11 @@
4
4
 
5
5
  每次发布都从已通过检查的 `master` 提交开始。`vX.Y.Z` 标签必须与 `package.json` 中的稳定版本以及两份更新日志的日期条目一致。标签工作流先核对标签与 master 祖先关系,只构建一个 npm 压缩包,对全部声明的 DSH 版本验证该包,再核对或发布 npm 版本,并创建包含相同压缩包和 `SHA256SUMS` 的 GitHub Release。
6
6
 
7
- 版本 `0.3.4` 声明含 `0.2.2-alpha.3` 在内的九个精确目标。已发布 `0.3.3` 保留九版声明,`0.3.2` 保留八版历史与不可变归档。发布按下文依次完成 PR、master CI、标签和发布工作流;实际可用性由工作流完成状态及 npm registry 确认。最终同包报告不入 npm 包,changelog 日期记录发布准备日,`retiredOn: 2026-10-28` 不是 npm 发布时间。
7
+ 版本 `0.3.5` 声明含 `0.2.2-rc.1` 在内的十个精确目标。已发布 `0.3.4` 保留不含 RC 的九版声明,`0.3.3` 保留其九版历史声明,`0.3.2` 保留八版历史与不可变归档。发布按下文依次完成 PR、master CI、标签和发布工作流;实际可用性由工作流完成状态及 npm registry 确认。最终同包报告不入 npm 包,changelog 日期记录发布准备日,`retiredOn: 2026-10-28` 不是 npm 发布时间。
8
8
 
9
9
  发布准备中修改支持版本前,先复核 [Legacy 兼容维护清单](legacy-compatibility.zh-CN.md),共同检查 peers、兼容声明、运行时准入、测试目标、CI 和指南。同次删除与支持集合无交集的专属运行时适配,保留共享安全逻辑;旧插件配置退役有独立条件。打包前同步更新并人工核对中英文清单、两个维度的矩阵及完整版本号。
10
10
 
11
- 打包前同步维护双语 README、支持规范、[DSH → 插件](support-history.zh-CN.md#by-dsh)和[插件 → DSH](support-history.zh-CN.md#by-plugin)历史及库存。保留历史行/锚点,区分已发布 `0.2.0`/`0.3.1`/`0.3.2`/`0.3.3` 和 `0.3.4` 发布声明,不引用不存在的 tag 作为已核实证据。
11
+ 打包前同步维护双语 README、支持规范、[DSH → 插件](support-history.zh-CN.md#by-dsh)和[插件 → DSH](support-history.zh-CN.md#by-plugin)历史及库存。保留历史行/锚点,区分已发布 `0.2.0`/`0.3.1`/`0.3.2`/`0.3.3`/`0.3.4` 和 `0.3.5` 发布声明,不引用不存在的 tag 作为已核实证据。
12
12
 
13
13
  ## 准备版本
14
14
 
@@ -26,7 +26,7 @@ node scripts/pack.mjs
26
26
  node scripts/packed-artifact.mjs record
27
27
  ```
28
28
 
29
- 生产及全部消费验证使用 Node.js 24,并满足所选宿主自身要求(`0.2.2-alpha.3` 要求 `>=24.9.0`);插件引擎仍为 `>=24`。直接集成测试命令复用静态检查的构建,`pack.mjs` 只生成一次归档,随后 `packed-artifact.mjs record` 写入摘要和精确全量矩阵。对全部声明目标串行消费这份冻结归档:
29
+ 生产及全部消费验证使用 Node.js 24,并满足所选宿主自身要求(`0.2.2-rc.1` 要求 `>=24.9.0`);插件引擎仍为 `>=24`。直接集成测试命令复用静态检查的构建,`pack.mjs` 只生成一次归档,随后 `packed-artifact.mjs record` 写入摘要和精确全量矩阵。对全部声明目标串行消费这份冻结归档:
30
30
 
31
31
  ```sh
32
32
  node --input-type=module - <<'JS'
@@ -46,15 +46,15 @@ for (const version of testedDshVersions) {
46
46
  JS
47
47
  ```
48
48
 
49
- 当前每次 full/发布还须用同包验证相邻退役 `0.2.1-alpha.2`。六版一次性负向验收属于 `0.3.1` 迁移历史,`0.3.4` 不重复;负向报告与正向业务矩阵分开。
49
+ 当前每次 full/发布还须用同包验证相邻退役 `0.2.1-alpha.2`。六版一次性负向验收属于 `0.3.1` 迁移历史,`0.3.5` 不重复;负向报告与正向业务矩阵分开。
50
50
 
51
51
  ```sh
52
- node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.4.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
52
+ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.5.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
53
53
  ```
54
54
 
55
55
  消费循环中不得构建或打包。归档内容变化须产生新候选并重新全量验证。JSON 报告记录摘要、精确版本、suite 范围、命令和真实用例数,见[固定归档指南](development.zh-CN.md#消费固定归档)。
56
56
 
57
- 工作流 DAG 为 `tag` → `package` → 共用 `verify-packed.yml` → `publish`。producer 上传一份 `release-package` 制品,独立 CLI/smoke 与完整 browser job 覆盖全部九个声明版本,消费前核对 producer 给出的预期 SHA-256、包身份及摘要文件。验证 job 拒绝不完整矩阵,full 聚合要求全部计划 job(含独立 `0.2.1-alpha.2` 退役拒绝)成功;失败、取消或意外跳过均阻止发布。
57
+ 工作流 DAG 为 `tag` → `package` → 共用 `verify-packed.yml` → `publish`。producer 上传一份 `release-package` 制品,独立 CLI/smoke 与完整 browser job 覆盖全部十个声明版本,消费前核对 producer 给出的预期 SHA-256、包身份及摘要文件。验证 job 拒绝不完整矩阵,full 聚合要求全部计划 job(含独立 `0.2.1-alpha.2` 退役拒绝)成功;失败、取消或意外跳过均阻止发布。
58
58
 
59
59
  `publish` 下载同一制品,再次与 producer 预期摘要核对,不构建或打包。保留 npm 同版本字节比较、可信发布及 GitHub Release 重试行为。工作流用 `npm publish ./artifacts/dsh-auth-remote-X.Y.Z.tgz --access public` 发布已验证 tgz,无需在本地手动发布。
60
60
 
@@ -81,4 +81,4 @@ npm view dsh-auth-remote@X.Y.Z version dist.integrity
81
81
 
82
82
  GitHub Release 包含 `.tgz` 和 `SHA256SUMS`。把两者下载到同一个目录,在该目录运行 `sha256sum -c SHA256SUMS` 验证附件。工作流失败时先查看 **Actions → Release** 再重试;npm 版本不可覆盖,因此只有现存版本的压缩包字节与本次构建一致时,工作流才会跳过重复发布。
83
83
 
84
- 未提交候选的本地验收须另外冻结源码身份:HEAD、status、完整 binary diff、非忽略新增文件摘要、受跟踪和新增源码/测试/脚本/配置/文档/锁文件的路径、类型/模式与 SHA-256 清单,以及原暂存区基线。排除 task、运行数据、报告和生成物。消费者前后比较源码清单、index 和 tgz 摘要;任何源码、测试、脚本、锁文件或入包文档变化都重跑核心检查、重新冻结并完整重跑九版 CLI/browser/smoke 与独立拒绝,不能只记录 HEAD 或沿用旧归档结果。
84
+ 未提交候选的本地验收须另外冻结源码身份:HEAD、status、完整 binary diff、非忽略新增文件摘要、受跟踪和新增源码/测试/脚本/配置/文档/锁文件的路径、类型/模式与 SHA-256 清单,以及原暂存区基线。排除 task、运行数据、报告和生成物。消费者前后比较源码清单、index 和 tgz 摘要;任何源码、测试、脚本、锁文件或入包文档变化都重跑核心检查、重新冻结并完整重跑十版 CLI/browser/smoke 与独立拒绝,不能只记录 HEAD 或沿用旧归档结果。
@@ -28,4 +28,4 @@ A supported DSH native HTTPS upstream also works behind a public HTTP or HTTPS p
28
28
 
29
29
  The authentication gate ignores `Forwarded` and `X-Forwarded-*` for trust decisions. This avoids treating a client-supplied hint as proof of TLS or hostname. The source checkout's browser suite tests these rules with its own Node HTTP/HTTPS forwarder; it does not execute Nginx or Traefik binaries.
30
30
 
31
- Verification of `0.3.4` targets Linux/Node.js 24 with Chromium and the existing Node forwarding harness. These examples remain deployment templates: real Nginx/Traefik products, a real non-loopback IPv6 interface, other platforms/browsers and real external services are not verified. Follow the deployment guide for independent-profile rehearsal, full backups and matching-data rollback.
31
+ Verification of `0.3.5` targets Linux/Node.js 24 with Chromium and the existing Node forwarding harness. These examples remain deployment templates: real Nginx/Traefik products, a real non-loopback IPv6 interface, other platforms/browsers and real external services are not verified. Follow the deployment guide for independent-profile rehearsal, full backups and matching-data rollback.
@@ -28,4 +28,4 @@ DSH Auth Remote 会先验证浏览器 authority,再为 DSH 改写已认证流
28
28
 
29
29
  认证门禁不会用 `Forwarded` 或 `X-Forwarded-*` 作信任判断,避免把客户端可伪造提示当成 TLS 或主机证明。源码检出的浏览器套件使用自有 Node HTTP/HTTPS 转发器测试这些规则,不运行 Nginx 或 Traefik 二进制。
30
30
 
31
- `0.3.4` 以 Linux/Node.js 24、Chromium 和既有 Node 转发测试为验收边界。这些示例仍是部署模板;真实 Nginx/Traefik 产品、真实非回环 IPv6 网卡、其他平台/浏览器及真实外部服务未验证。独立 profile 演练、完整备份和对应数据回滚见部署指南。
31
+ `0.3.5` 以 Linux/Node.js 24、Chromium 和既有 Node 转发测试为验收边界。这些示例仍是部署模板;真实 Nginx/Traefik 产品、真实非回环 IPv6 网卡、其他平台/浏览器及真实外部服务未验证。独立 profile 演练、完整备份和对应数据回滚见部署指南。