dsh-auth-remote 0.1.10 → 0.3.1

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 (37) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/CHANGELOG.zh-CN.md +31 -0
  3. package/CONTRIBUTING.md +5 -1
  4. package/CONTRIBUTING.zh-CN.md +5 -1
  5. package/README.md +22 -24
  6. package/README.zh-CN.md +22 -24
  7. package/cordis.patch.yml +2 -2
  8. package/dist/client.js +2 -2
  9. package/dist/client.js.map +1 -1
  10. package/dist/index.js +102 -38
  11. package/dist/index.js.map +4 -4
  12. package/dist/types/adapters/dsh/compatibility.d.ts +1 -1
  13. package/dist/types/adapters/dsh/compatibility.d.ts.map +1 -1
  14. package/dist/types/adapters/dsh/runtime-capabilities.d.ts +6 -11
  15. package/dist/types/adapters/dsh/runtime-capabilities.d.ts.map +1 -1
  16. package/dist/types/config.d.ts +2 -2
  17. package/dist/types/config.d.ts.map +1 -1
  18. package/dist/types/http/account-login.d.ts.map +1 -1
  19. package/dist/types/index.d.ts.map +1 -1
  20. package/dist/types/shared/dsh-support.d.ts +38 -0
  21. package/dist/types/shared/dsh-support.d.ts.map +1 -0
  22. package/docs/deployment.md +25 -21
  23. package/docs/deployment.zh-CN.md +25 -21
  24. package/docs/development.md +80 -23
  25. package/docs/development.zh-CN.md +80 -23
  26. package/docs/legacy-compatibility.md +106 -79
  27. package/docs/legacy-compatibility.zh-CN.md +106 -79
  28. package/docs/releasing.md +46 -10
  29. package/docs/releasing.zh-CN.md +46 -10
  30. package/docs/reverse-proxy.md +2 -2
  31. package/docs/reverse-proxy.zh-CN.md +2 -2
  32. package/docs/support-history.md +103 -0
  33. package/docs/support-history.zh-CN.md +103 -0
  34. package/docs/support-policy.md +87 -0
  35. package/docs/support-policy.zh-CN.md +87 -0
  36. package/examples/web-profile-auth-remote.patch.yml +3 -2
  37. package/package.json +26 -23
@@ -2,60 +2,65 @@
2
2
 
3
3
  [English](legacy-compatibility.md)
4
4
 
5
- 最后复核:2026-10-19。本文与英文清单共同维护同一组稳定 ID、版本事实、代码位置、测试与退役条件。修改任一语言时同步另一语言;矩阵是检索入口,条目是维护依据。本文记录 DSH 精确版本差异,不以发布顺序或版本简称代替适用范围。
5
+ 最后复核:2026-10-28。本文与英文清单共同维护同一组稳定 ID、版本事实、代码位置、测试与退役条件。修改任一语言时同步另一语言;矩阵是检索入口,条目是维护依据。本文记录 DSH 精确版本差异,不以发布顺序或版本简称代替适用范围。
6
+
7
+ 当前候选维护日期及承诺见 [README](../README.zh-CN.md#dsh-兼容性);未修改的[支持规范](support-policy.zh-CN.md)保留前一发布记录。历史 [DSH → 插件](support-history.zh-CN.md#by-dsh)与[插件 → DSH](support-history.zh-CN.md#by-plugin)区分声明、报告、候选与分发事实。
8
+
9
+ ## 当前迁移候选
10
+
11
+ 插件 `0.3.1` 尚未发布,声明 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-alpha.3`,默认 `0.2.1-rc.4`。三个 Alpha 自 2026-10-28 为 legacy,窗口 14 日,最早资格日为 2026-11-11(Asia/Shanghai),日期不自动结束支持。DSH `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` 退役,最后支持插件为 `0.2.0`。当前承诺见 README;保持原样的 support-policy 描述此前发布。
12
+
13
+ 下文保留精确历史证据,本轮逐项删除独占路径。HOST/PROTOCOL 旧路径、PUBLIC 选项/文本路径、THEME 旧 radius/thumb 补值、TEST 直接导航的适用集合与七版无交集;焦点颜色按七版原生规则迁移;ACCOUNT、HMR、通用引导重试与 PLUGIN-CONFIG 保留。新 RC 关键发布 lib 树与 `0.2.1-rc.2` 一致,2026-10-28 已核验精确包完整性与实际安装 API,最终运行结果另记。
6
14
 
7
15
  ## 范围与复核规则
8
16
 
9
- 插件 `0.1.10` 声明支持 DSH `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-alpha.5`。运行时范围 `>=0.1.7-rc.1` 包含预发布版本;向前准入不代表已验证,仍须检查包身份与必要 API。未列入矩阵的版本不继承验证结论;手动账号回填按 `>=0.2.1-alpha.3`(包含预发布)、必要 API 和动态 `manualAccountLogin` 配置准入,前向准入不代表已验证。
17
+ 候选 `0.3.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.4`。准入为包含预发布的 `>=0.2.1-alpha.3`,仍须包身份/API 检查;账号适配还依赖必要能力和动态配置。未列版本不能继承实测声明。
10
18
 
11
19
  - 修改 peers、`dsh.compatibility`、运行时准入、测试目标、CI 或用户兼容声明前,对照两张矩阵及所有相关条目。
12
20
  - `dsh-runtime`:适用版本与支持集合仍有交集则保留相应适配;交集为空时,在同一次变更删除专属实现与测试,更新两种语言的矩阵、条目和指南。共享安全校验不随专属分支删除。
13
- - `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.1.10` 兼容。
21
+ - `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.3.1` 兼容。
14
22
  - 缺少精确版本证据时保留实现,明确登记缺口。不同版本通过相同测试,不证明其内部实现相同。
15
- - 支持范围或共享宿主适配变更须执行同一最终产物的完整声明版本 CLI、浏览器和安装冒烟矩阵。`DSH-ACCOUNT-001` 专项完整回归针对 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`;对 `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` 检查启动、设置入口和适配未启用即可。CI 的 CLI/smoke 与浏览器矩阵均包含上述九个精确版本。
23
+ - 支持范围或共享宿主适配变更须对同一最终归档完整运行七版 CLI、browser、smoke,七版保留完整账号回归;普通固定选择见开发指南。full/发布独立验证退役边界 `0.2.1-alpha.2`,本次最终验收额外串行跑六版拒绝。
16
24
 
17
25
  ## 功能 → 版本对照表
18
26
 
19
- “原生”表示该精确 DSH 安装包提供能力;“插件校验/补值/启用”表示本插件保留适配;“拒绝/无/未提供”分别表示插件拒绝配置、缺少原生参数或没有该原生功能;“待核实”不代表可以删除代码。HTTP 反向代理的公网 HTTPS 与 DSH 原生 HTTPS 监听是不同能力。
20
-
21
- | 功能与维护 ID | `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` |
22
- | ------------------------------------------------------------------- | ------------------- | ------------------- | ------------------- | ------------------- | -------------------- | ------------------------ | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- |
23
- | 具体 IPv4 监听校验 · [DSH-HOST-001](#dsh-host-001) | 插件校验 | 插件校验 | 插件校验 | 插件校验 | 插件校验 | 原生校验 | 原生校验 | 原生校验 | 原生校验 |
24
- | 原生 IPv6 监听 · [DSH-HOST-001](#dsh-host-001) | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 原生 | 原生 | 原生 | 原生 |
25
- | 原生 HTTPS 监听 · [DSH-PROTOCOL-001](#dsh-protocol-001) | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 原生 | 原生 | 原生 | 原生 |
26
- | 服务端 Connection 桥接 · [DSH-PROTOCOL-001](#dsh-protocol-001) | HTTP / `127.0.0.1` | HTTP / `127.0.0.1` | HTTP / `127.0.0.1` | HTTP / `127.0.0.1` | HTTP / `127.0.0.1` | 实际协议与绑定 authority | 实际协议与绑定 authority | 实际协议与绑定 authority | 实际协议与绑定 authority |
27
- | 插件唯一 `publicUrl` 入口 · [DSH-PUBLIC-001](#dsh-public-001) | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
28
- | 原生 `--public-url` 参数 · [DSH-PUBLIC-001](#dsh-public-001) | 无 | 无 | 无 | 无 | 原生 | 原生 | 原生 | 原生 | 原生 |
29
- | 模型侧 Web 地址 · [DSH-PUBLIC-001](#dsh-public-001) | 原生回环文本段 | 原生回环文本段 | 原生回环文本段 | 原生回环文本段 | 最终公开根地址文本段 | 最终公开根地址文本段 | 最终公开根地址运行时上下文 | 最终公开根地址运行时上下文 | 最终公开根地址运行时上下文 |
30
- | `DSH_WEB_URL` · [DSH-PUBLIC-001](#dsh-public-001) | 原生回环地址 | 原生回环地址 | 原生回环地址 | 原生回环地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 |
31
- | 圆角与焦点主题 token · [DSH-THEME-001](#dsh-theme-001) | 插件补值 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
32
- | Switch 滑块主题 token · [DSH-THEME-001](#dsh-theme-001) | 插件补值 | 插件补值 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
33
- | HMR 监听器事务上下文 · [DSH-HMR-001](#dsh-hmr-001) | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 |
34
- | 设置入口 · [DSH-TEST-001](#dsh-test-001) | 侧栏设置 | 侧栏设置 | 侧栏设置 | 侧栏设置 | 侧栏设置 | 侧栏设置 | 账号菜单 → 设置 | 账号菜单 → 设置 | 账号菜单 → 设置 |
35
- | 首次提示/保存后重载的精确触发 · [DSH-TEST-001](#dsh-test-001) | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 账号引导已适配;notice/reload 触发待核实 | 账号引导及宿主版本刷新提示已验证;其他触发待核实 | 账号引导及宿主版本刷新提示已验证;其他触发待核实 |
36
- | 原生官方账号提供者 · [DSH-ACCOUNT-001](#dsh-account-001) | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP |
37
- | 普通 Web 官方账号入口 · [DSH-ACCOUNT-001](#dsh-account-001) | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 启用 | 启用 | 启用 |
38
- | 原生 `startSignIn` 首参 · [DSH-ACCOUNT-001](#dsh-account-001) | locale 字符串 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 |
39
- | 插件官方账号手动回填 · [DSH-ACCOUNT-001](#dsh-account-001) | 不启用 | 不启用 | 不启用 | 不启用 | 不启用 | 不启用 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 |
40
- | 插件 `0.1.5` 配置输入迁移 · [PLUGIN-CONFIG-001](#plugin-config-001) | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 |
27
+ 各行列出适配或迁移及其精确适用宿主。稳定条目保留历史原生事实;退役仅删除独占实现,保留共享安全校验。
28
+
29
+ | 条目 | 精确适用 DSH 版本 | 当前候选处理 |
30
+ | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
31
+ | [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 和具体绑定 |
32
+ | [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 分离 |
33
+ | [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` | 无交集;删除缺失选项及旧回环投影路径 |
34
+ | [DSH-PUBLIC-001](#dsh-public-001),文本投影 | `0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;删除文本位置选择;固定检查 context 和环境,仍观察 sections 中泄露/重复 |
35
+ | [DSH-THEME-001](#dsh-theme-001),radius 补值 | `0.1.7-rc.1` | 无支持交集;旧 radius 后备值已移除,保留主题/视觉检查 |
36
+ | [DSH-THEME-001](#dsh-theme-001),switch-thumb 补值 | `0.1.7-rc.1`、`0.1.7-rc.2` | 无交集;`0.3.1` 已删除补值,保留原生 token 与视觉/焦点回归 |
37
+ | [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` | 七版精确原生规则及最低/默认 UI 支持迁移,保留可见键盘焦点 |
38
+ | [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` 已删除直接入口,固定账号菜单;通用异步重试保留 |
39
+ | [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` | 保留;全局准入后删除服务端旧版本分流;导出 helper 仍检查省略/无效/低版本输入 |
40
+ | [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` | 保留受支持宿主适配;仅移除退役版矩阵目标 |
41
+ | [PLUGIN-CONFIG-001](#plugin-config-001) | 插件 `0.1.5` allowedOrigins 输入,与 DSH 版本无关 | 按独立契约保留 |
41
42
 
42
43
  ## 版本 → 功能对照表
43
44
 
44
- 每行直接列出该精确版本的实现分支和应复核的条目。`0.1.7-rc.1` 的原生 `startSignIn` 首参是 locale 字符串;`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` 使用客户端元数据对象。删除某个版本的支持时,先找该行,再检查条目的完整适用集合;某一行退出支持不代表该条目可整体删除。
45
-
46
- | DSH 精确版本 | 监听与桥接差异 | 原生公开地址、模型提示与环境变量 | 主题与设置入口 | 官方账号与手动回填 | 删除支持或迁移时复核 |
47
- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
48
- | `0.1.7-rc.1` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1`;原生 HMR 后隔离监听器事务上下文 | 无 `--public-url`;插件公开入口可用;模型文本与 `DSH_WEB_URL` 仍为原生回环地址 | 圆角/焦点及 switch 滑块需补值;侧栏设置;notice/reload 触发待核实 | 原生账号服务存在;普通 Web 入口不启用;手动回填关闭 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-THEME-001、DSH-TEST-001, DSH-HMR-001 |
49
- | `0.1.7-rc.2` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1`;原生 HMR 后隔离监听器事务上下文 | 无 `--public-url`;插件公开入口可用;模型文本与 `DSH_WEB_URL` 仍为原生回环地址 | 原生圆角/焦点;switch 滑块补值;侧栏设置;notice/reload 触发待核实 | 原生账号服务存在;普通 Web 入口不启用;手动回填关闭 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-THEME-001、DSH-TEST-001, DSH-HMR-001 |
50
- | `0.2.0-rc.1` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1`;原生 HMR 后隔离监听器事务上下文 | 无 `--public-url`;插件公开入口可用;模型文本与 `DSH_WEB_URL` 仍为原生回环地址 | 原生圆角/焦点与 switch 滑块;侧栏设置;notice/reload 触发待核实 | 原生账号服务存在;普通 Web 入口不启用;手动回填关闭 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001, DSH-HMR-001 |
51
- | `0.2.0-rc.2` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1`;原生 HMR 后隔离监听器事务上下文 | 无 `--public-url`;插件公开入口可用;模型文本与 `DSH_WEB_URL` 仍为原生回环地址 | 原生圆角/焦点与 switch 滑块;侧栏设置;notice/reload 触发待核实 | 原生账号服务存在;普通 Web 入口不启用;手动回填关闭 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001, DSH-HMR-001 |
52
- | `0.2.1-alpha.1` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1`;原生 HMR 后隔离监听器事务上下文 | 有 `--public-url`;模型文本与 `DSH_WEB_URL` 使用插件最终公开根地址 | 原生圆角/焦点与 switch 滑块;侧栏设置;notice/reload 触发待核实 | 原生账号服务存在;普通 Web 入口不启用;手动回填关闭 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001, DSH-HMR-001 |
53
- | `0.2.1-alpha.2` | 原生具体 IPv4/IPv6 与 HTTP/HTTPS;Connection 使用实际协议与绑定 authority;原生 HMR 后隔离监听器事务上下文 | 有 `--public-url`;模型文本与 `DSH_WEB_URL` 使用插件最终公开根地址 | 原生圆角/焦点与 switch 滑块;侧栏设置;notice/reload 触发待核实 | 原生账号服务存在;普通 Web 入口不启用;手动回填关闭 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001, DSH-HMR-001 |
54
- | `0.2.1-alpha.3` | 原生具体 IPv4/IPv6 与 HTTP/HTTPS;Connection 使用实际协议与绑定 authority;端口类型允许未绑定值,插件须在监听后校验;原生 HMR 后隔离监听器事务上下文 | 有 `--public-url`;模型地址在 `app:web-surface` 运行时上下文;`DSH_WEB_URL` 使用最终公开根地址 | 原生圆角/焦点与 switch 滑块;账号菜单 → 设置;账号引导已适配,notice/reload 触发待核实 | 原生仅回环 HTTP 来源;启用说明弹窗与手动回填,保留 API Key 选择;等待配置后选择入口 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-ACCOUNT-001, DSH-HMR-001 |
55
- | `0.2.1-alpha.4` | 原生具体 IPv4/IPv6 与 HTTP/HTTPS;Connection 使用实际协议与绑定 authority;端口类型允许未绑定值,插件须在监听后校验;原生 HMR 后隔离监听器事务上下文 | 有 `--public-url`;模型地址在 `app:web-surface` 运行时上下文;`DSH_WEB_URL` 使用最终公开根地址 | 原生圆角/焦点与 switch 滑块;账号菜单 → 设置;账号引导及宿主版本刷新提示已验证;其他触发待核实 | 原生仅回环 HTTP 来源;启用说明弹窗与手动回填,保留 API Key 选择;等待配置后选择入口 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-ACCOUNT-001, DSH-HMR-001 |
56
- | `0.2.1-alpha.5` | 原生具体 IPv4/IPv6 与 HTTP/HTTPS;Connection 使用实际协议与绑定 authority;端口类型允许未绑定值,插件须在监听后校验;原生 HMR 后隔离监听器事务上下文 | 有 `--public-url`;模型地址在 `app:web-surface` 运行时上下文;`DSH_WEB_URL` 使用最终公开根地址 | 原生圆角/焦点与 switch 滑块;账号菜单 → 设置;账号引导及宿主版本刷新提示已验证;其他触发待核实 | 原生仅回环 HTTP 来源;启用说明弹窗与手动回填,保留 API Key 选择;等待配置后选择入口 | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-ACCOUNT-001, DSH-HMR-001 |
57
-
58
- `PLUGIN-CONFIG-001` 与共享安全边界适用于表中每一个版本,不能因为删除任一 DSH 版本而删除。未列出的未来版本须独立回归后才能声称已验证;`DSH-ACCOUNT-001` 的前向准入本身不构成验证。
45
+ 历史行保留可查询性;退役行不属于当前正向目标。所有受支持行均使用原生具体 IPv4/IPv6、HTTP/HTTPS、上下文投影、原生 radius/thumb token 与焦点规则 和账号菜单 Settings。新 RC 精确发布代码/API 证据见下文,最终同包运行证据另记。
46
+
47
+ | 精确 DSH 版本 | 当前候选状态 | 历史适配 / 保留的共享检查 |
48
+ | --------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
49
+ | `0.1.7-rc.1` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-THEME-001、DSH-TEST-001、DSH-HMR-001;历史 startSignIn 首参为语言字符串 |
50
+ | `0.1.7-rc.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-THEME-001、DSH-TEST-001、DSH-HMR-001;startSignIn 首参为元数据对象 |
51
+ | `0.2.0-rc.1` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001 |
52
+ | `0.2.0-rc.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001 |
53
+ | `0.2.1-alpha.1` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001;原生公开地址文本 |
54
+ | `0.2.1-alpha.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001;原生传输和公开地址文本 |
55
+ | `0.2.1-alpha.3` | Legacy;最低支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验、context/env 和通用引导回归;原生 release 元数据缺失 |
56
+ | `0.2.1-alpha.4` | Legacy | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归 |
57
+ | `0.2.1-alpha.5` | Legacy | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归 |
58
+ | `0.2.1-rc.1` | 正常支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归 |
59
+ | `0.2.1-rc.2` | 正常支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings、宿主版本提示及 Search/Fetch 回归 |
60
+ | `0.2.1-rc.3` | 候选支持目标 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换 |
61
+ | `0.2.1-rc.4` | 候选支持目标;默认 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换 |
62
+
63
+ PLUGIN-CONFIG-001 与共享认证检查均独立于运行时适配退役。未来版本准入不构成已验证声明。
59
64
 
60
65
  ## 新能力迁移与退役流程
61
66
 
@@ -67,66 +72,76 @@
67
72
 
68
73
  ## DSH-HOST-001
69
74
 
70
- 具体 IP 监听与 schema 适配,类型为 `dsh-runtime`,现存生效。
75
+ 具体 IP 监听与 schema 适配,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
71
76
 
72
77
  | 字段 | 维护依据 |
73
78
  | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
74
79
  | 适配适用版本 | `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 |
75
- | 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听 |
80
+ | 原生能力版本 | `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` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听 |
76
81
  | 实现与上游 | `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 |
77
82
  | 测试与证据 | `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 与策略 |
78
83
  | 迁移与退役 | 仅当所有“适配适用版本”退出支持集合,或逐个取得原生能力证据并完成迁移后,删除该集合独占的 IPv4/schema 分支与拒绝测试。保留通配拒绝、端口验证、包身份及共同门禁 |
79
84
 
85
+ 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/来源/撤销共享检查保留。
86
+
80
87
  ## DSH-PROTOCOL-001
81
88
 
82
- 原生协议与 Connection 绑定地址差异,类型为 `dsh-runtime`,现存生效。
89
+ 原生协议与 Connection 绑定地址差异,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
83
90
 
84
91
  | 字段 | 维护依据 |
85
92
  | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
86
93
  | 回退适用版本 | `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 |
87
- | 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致 |
94
+ | 原生能力版本 | `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` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致 |
88
95
  | 实现与上游 | `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 信任,不扩大外层来源准入 |
89
96
  | 测试与证据 | `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 |
90
97
  | 迁移与退役 | 对每个“回退适用版本”取得原生 protocol/authority 支持证据后才迁移;该集合与支持范围无交集时删除专属回退。保留 HTTP 正向、双向代理、Cookie Secure、流撤销及共享认证检查 |
91
98
 
92
99
  外层 Cookie 的 Secure 取决于公开来源;原生 Cookie 的 Secure 取决于监听协议。这是共享安全行为,不是可随版本删除的回退。
93
100
 
101
+ 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/来源/撤销共享检查保留。
102
+
94
103
  ## DSH-PUBLIC-001
95
104
 
96
- 公开地址投影和模型提示位置差异,类型为 `dsh-runtime`,现存生效。
105
+ 公开地址投影和模型提示位置差异,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
97
106
 
98
107
  | 字段 | 维护依据 |
99
108
  | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
100
109
  | 无原生参数的版本 | `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 能力 |
101
110
  | 原生文本投影版本 | `0.2.1-alpha.1`、`0.2.1-alpha.2` 原生消费 `webServer.publicUrl`,模型 system prompt Web 文本与 `DSH_WEB_URL` 使用插件最终公开根地址 |
102
- | 原生上下文投影版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址 |
111
+ | 原生上下文投影版本 | `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` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址 |
103
112
  | 实现与上游 | [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 |
104
113
  | 测试与证据 | `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` 的上下文变化 |
105
- | 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`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` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
114
+ | 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`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` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
115
+
116
+ 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/来源/撤销共享检查保留。
106
117
 
107
118
  ## DSH-THEME-001
108
119
 
109
- 缺失主题 token 的 CSS 补值,类型为 `dsh-runtime`,现存生效。
120
+ 缺失主题 token 的 CSS 补值,类型为 `dsh-runtime`,已在插件 `0.3.1` 退役;原生 token 和共享视觉检查保留。
110
121
 
111
- | 字段 | 维护依据 |
112
- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
113
- | 补值适用版本 | `0.1.7-rc.1` 缺少 `--dsw-radius-md`、`--dsw-radius-lg`、`--dsw-focus-ring-color`;`0.1.7-rc.1`、`0.1.7-rc.2` 缺少 `--dsw-alias-switch-thumb` |
114
- | 原生能力版本 | `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` 提供圆角/焦点 token;`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` 同时提供 switch 滑块 token |
115
- | 实现与上游 | `src/client/settings/style.css` 与 `src/client/account/style.css` 的 `var()` fallback;精确 `@deepseek-ai/dsh-client-ui-theme/lib` 嵌入的 CSS token 定义。button switch 使用原生轨道/滑块形状,缺失滑块 token 时回退既有前景 token;账号与安全操作弹窗统一表面、圆角、焦点和控制样式 |
116
- | 测试与证据 | `tests/browser/dsh-bootstrap.spec.ts`、`tests/browser/login.spec.ts`、`tests/browser/account-login.spec.ts` 与 `.cache/ui-review/<version>` 人工截图复核。2026-10-16 精确安装包主题定义证实表列八版的 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。 |
117
- | 迁移与退役 | `0.1.7-rc.1` 退出支持且其余精确版本证据完整后才可删除圆角/焦点补值;`0.1.7-rc.1`、`0.1.7-rc.2` 任一仍在支持集合时保留 switch 滑块补值。保留动态主题、布局、焦点可见性及共享视觉验证 |
122
+ | 字段 | 维护依据 |
123
+ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
124
+ | 补值适用版本 | 历史 radius-md/lg 对应 `0.1.7-rc.1`,switch-thumb 对应 `0.1.7-rc.1`、`0.1.7-rc.2`;重复焦点颜色 fallback 按七版原生规则迁移 |
125
+ | 原生能力版本 | `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` 均提供 radius/thumb 定义与相同原生 focus.css;focus-ring-color 是可选 override,不是正常键盘模式必有的 root token。历史 radius 从 `0.1.7-rc.2`、thumb 从 `0.2.0-rc.1` 已确认 |
126
+ | 实现与上游 | `src/client/settings/style.css`、`src/client/account/style.css` 直接读取原生 radius/thumb;焦点只设 solid outline、`--dsw-focus-ring-width` 和 offset,颜色委托宿主 :focus-visible;独立登录页不变 |
127
+ | 测试与证据 | `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。 |
128
+ | 迁移与退役 | 旧 radius/thumb 适用集合退出后移除专属 fallback;当前七版焦点颜色已按原生规则迁移,不直接读取未定义 override。保留动态主题、布局、可见焦点、开关外观和共享视觉测试 |
129
+
130
+ 2026-10-28 清理:旧 radius、switch-thumb 和直接 Settings 的精确适用集合如上表,与七版支持无交集;删除专属实现。重复焦点颜色 fallback 依据七版原生规则迁移,不假定正常模式存在 focus-ring-color。通用引导、重开、持久化重试及共享视觉断言保留。
131
+
132
+ 精确焦点证据修正(2026-10-28):七版原生 focus.css 在 :focus-visible 上解析 `var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary))`;focus-ring-color 是指针模式的可选覆盖值,不是默认根 token。不能用“源码出现声明”推定正常键盘状态有值。插件现仅用原生 `--dsw-focus-ring-width` 设置实线轮廓形状,颜色交给宿主全局规则,删除插件重复后备值且保留键盘可见焦点。四类清理不能解释为直接引用未定义的覆盖变量。
118
133
 
119
134
  ## DSH-TEST-001
120
135
 
121
- 设置导航与首次引导测试适配,类型为 `dsh-runtime`,现存生效;notice/reload 的精确触发范围仍有证据缺口。
136
+ 设置导航与首次引导测试适配,类型为 `dsh-runtime`,直接入口已在插件 `0.3.1` 退役;通用首次引导重试保留,notice/reload 的精确触发范围仍有证据缺口。
122
137
 
123
- | 字段 | 维护依据 |
124
- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
125
- | 直接设置入口版本 | `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 引导 |
126
- | 账号菜单入口版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 使用账号菜单 → 设置及官方账号引导;手动登录浮层不依附侧栏或引导入口,避免入口重建取消待完成授权 |
127
- | 已知缺口 | 对 `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`,notice 延迟、确认中替换、首次 API Key 保存与页面重载之间的逐项映射尚未完整建立。不能把共享 helper 通过当作每个触发条件都已逐版复现 |
128
- | 实现与测试 | `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` |
129
- | 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码 |
138
+ | 字段 | 维护依据 |
139
+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
140
+ | 直接设置入口版本 | `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 引导 |
141
+ | 账号菜单入口版本 | `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` 使用账号菜单 → 设置及官方账号引导;手动登录浮层不依附侧栏或引导入口,避免入口重建取消待完成授权 |
142
+ | 已知缺口 | 对 `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`,notice 延迟、确认中替换、首次 API Key 保存与页面重载之间的逐项映射尚未完整建立。不能把共享 helper 通过当作每个触发条件都已逐版复现 |
143
+ | 实现与测试 | `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` |
144
+ | 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码 |
130
145
 
131
146
  `0.2.1-alpha.3` 的并发验证另发现:pnpm 共享硬链接的 ctime 会在其他隔离 profile 安装同包时变化,触发原生 HMR 并销毁客户端插件。测试安装改为复制文件,账号夹具校验客户端文件未共享硬链接;这不是首次引导重载的版本证据,不据此填补上述 notice/reload 缺口。
132
147
 
@@ -134,47 +149,55 @@
134
149
 
135
150
  2026-10-16,`tests/browser/host-release.spec.ts` 在同一隔离 profile/端口保留 `0.2.1-alpha.4` 页面,将实际宿主切换到 `0.2.1-alpha.3` 后观察原生“服务版本变化”提示;`0.2.1-alpha.3` 不发布该 release 元数据,因此界面显示“未解析”。点击原生刷新后认证检查成功,原会话及 profile 开关保留;恢复 `0.2.1-alpha.4` 后再次核对通过。测试自行准备精确旧运行时,不修改上游源码、版本或图元数据。这一精确用例不补齐其他 notice/首次保存触发的缺口。
136
151
 
152
+ 2026-10-28 清理:旧 radius、switch-thumb 和直接 Settings 的精确适用集合如上表,与七版支持无交集;删除专属实现。重复焦点颜色 fallback 依据七版原生规则迁移,不假定正常模式存在 focus-ring-color。通用引导、重开、持久化重试及共享视觉断言保留。
153
+
137
154
  ## DSH-ACCOUNT-001
138
155
 
139
156
  官方账号手动回调对接,类型为 `dsh-runtime`,现存生效;这是可独立退役的临时适配。
140
157
 
141
158
  | 字段 | 维护依据 |
142
159
  | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
143
- | 原生能力与插件范围 | `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` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
160
+ | 原生能力与插件范围 | `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` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
144
161
  | 前向准入规则 | `>=0.2.1-alpha.3`,按 SemVer 包含预发布比较;必要 provider/slot API 可用且 `manualAccountLogin: true` 才接纳新授权。默认 true,使用 Loader 原位更新的 volatile 引用;profile override 不重建认证服务 |
145
- | 明确不启用的版本 | `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 时也报告不可用。显式 false 时新 start 报 `account_disabled`,已经接纳的授权继续原生命周期 |
162
+ | 历史关闭分支 | 旧六版服务端分支随全局下限移除,不再保留正向目标;导出 helper 仍拒绝缺省/无效/旧参数。必要 API 缺失仍不可用,动态 false 拒绝新授权并保留已接纳 attempt |
146
163
  | 原因与上游 | 精确安装包的 account-platform `protocol.ts/loginOrigin` 在表列全部版本中仅接受带显式端口的回环 HTTP;ui-settings-account 默认使用浏览器 origin。公网浏览器无法自动回调 DSH 设备,外层门禁也拒绝跨站导航 |
147
164
  | 实现 | `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;菜单登录在偏好未知时等待共享读取,再按最新接纳值选择手动或原生动作。 |
148
- | 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.1-alpha.5` 提供者与本地平台替身,覆盖 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 两种配置初始延迟期间点击登录不提前发起原生授权。 |
165
+ | 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.1-rc.4` 提供者与本地平台替身,覆盖 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 两种配置初始延迟期间点击登录不提前发起原生授权。 |
149
166
  | 公网迁移条件 | 官方接受公网 `redirect_uri`,且目标精确 DSH 版本的来源策略、回调、兑换、UI、会话边界均经验证。仅平台开放、DSH 仍限制 `loginOrigin` 时不能直接删除。前向准入不构成已验证声明,新增实测声明仍须精确回归;只有原生公网流程已证实可用才迁移或退役 |
150
- | 退役与保留 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 仍在支持集合且仍需回环时保留适配;仅当其适用集合退出支持,或每个精确版本的原生公网流程已验证可用时,删除专属 callback/UI/标志与专属测试。仍被其他流程使用的会话归属、state/PKCE、单次使用、撤销和禁止 URL 网络转发等共享边界继续保留 |
167
+ | 退役与保留 | `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` 仍需回环,继续保留;只有适用集合退出支持或每个仍支持精确宿主的原生公网流程经验证可用才删除专属实现。共享 state/PKCE、会话归属、单次使用、撤销及禁止 URL 转发保留 |
151
168
  | 证据限制 | 2026-10-15,本地平台替身与真实提供者完整兑换通过;官方 `auth_init` 的回环对照成功并取消,三种 `example.com` 公网写法被 schema 拒绝。未验证真实官方账号完整授权,也未排除官方按域名白名单开放的可能 |
152
169
 
170
+ 2026-10-28:七个准入宿主都使用原生元数据对象调用。全局准入后服务端不再按旧版本停用 provider 或 bridge;能力检查和动态偏好语义保留。独立导出的 index 注入 helper 对省略、无效、低版本输入仍只提供 ownsHost,不授予手动标志。`tests/unit/client-capability.test.ts` 分别验证两个边界。
171
+
153
172
  ## DSH-HMR-001
154
173
 
155
174
  原生热重载后的长期监听器事务上下文隔离。类型:`dsh-runtime`。保留。
156
175
 
157
- | 字段 | 维护依据 |
158
- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
159
- | 适用版本 | `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` |
160
- | 原生行为与静态证据 | 2026-10-16 逐版核对 `@deepseek-ai/dsh-hmr/lib/index.js`:八版 `runExclusive` 都以私有 `executing: AsyncLocalStorage` 的布尔标记拒绝嵌套事务;原生 `watchConfig` 自身用 `executing.exit` 创建长期 watcher。热重载事务内创建的 HTTP/HTTPS 监听器会让后续独立请求继承旧标记。 2026-10-19 复核精确 `0.2.1-alpha.5` 的 JavaScript 与类型,和 `0.2.1-alpha.4` 逐字相同,未新增公开监听器隔离 API。 |
161
- | 实现边界 | `src/adapters/dsh/hmr-context.ts`、`src/index.ts`:仅在原生监听器初始化期间,确认 `runExclusive`、原生 AsyncLocalStorage 与当前 true 标记后调用 `exit`。明确依赖私有字段形状,公开 API 暂无对应入口。字段或标记不匹配时保持原生初始化行为;不改写 HMR 队列,不在设置保存/请求分派层退出事务,不削弱真实嵌套拒绝。 |
162
- | 测试与证据 | `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”。八版真实配置 HMR/队列专项全部通过:监听器 generation 增加,独立保存等待已有事务、真实嵌套仍拒绝、原会话仍有效;`0.2.1-alpha.3`、`0.2.1-alpha.4` 安装代码替换后重新开启也通过。2026-10-16 本轮专项共 10/10;未来版本不能继承八版静态或运行结论。 当前模块替换回归另覆盖 `0.2.1-alpha.5`;精确命令、数量与最终同包结果另记执行记录。 |
163
- | 迁移与退役 | 上游提供公开隔离入口时先逐版取得精确证据并迁移;仅当每个仍支持的适用版本原生隔离已修复,或适用集合与支持集合无交集时,才能移除专属实现和测试。同次更新双语双向矩阵。保留认证、来源、原生队列、真正嵌套拒绝及回归检查。 |
176
+ | 字段 | 维护依据 |
177
+ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
178
+ | 适用版本 | `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` |
179
+ | 原生行为与静态证据 | 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。 |
180
+ | 实现边界 | `src/adapters/dsh/hmr-context.ts`、`src/index.ts`:仅在原生监听器初始化期间,确认 `runExclusive`、原生 AsyncLocalStorage 与当前 true 标记后调用 `exit`。明确依赖私有字段形状,公开 API 暂无对应入口。字段或标记不匹配时保持原生初始化行为;不改写 HMR 队列,不在设置保存/请求分派层退出事务,不削弱真实嵌套拒绝。 |
181
+ | 测试与证据 | `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`;精确命令、数量与最终同包结果另记执行记录。 |
182
+ | 迁移与退役 | 上游提供公开隔离入口时先逐版取得精确证据并迁移;仅当每个仍支持的适用版本原生隔离已修复,或适用集合与支持集合无交集时,才能移除专属实现和测试。同次更新双语双向矩阵。保留认证、来源、原生队列、真正嵌套拒绝及回归检查。 |
164
183
 
165
184
  ## PLUGIN-CONFIG-001
166
185
 
167
- 插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.1.10` 保留;与 DSH 版本集合无关。
186
+ 插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.3.1` 保留;与 DSH 版本集合无关。
168
187
 
169
188
  | 字段 | 维护依据 |
170
189
  | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
171
- | 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.1.10` 仍保留 |
190
+ | 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.3.1` 仍保留 |
172
191
  | 行为与实现 | `src/config.ts`、[cordis.patch.yml](../cordis.patch.yml)。省略字段与显式空数组可区分;单项转成唯一 `publicUrl`,空数组按监听结果派生;多项、重复项和新字段共存报错。每次激活仅一次弃用提示,不改写 profile;统一启动前解析、监听后定稿 |
173
192
  | 测试 | `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 不改写 |
174
193
  | 迁移与退役 | 只有插件产品契约明确结束这组输入支持并提供迁移说明时才删除专属检测、转换及测试。任一 DSH 版本退出支持都不足以触发退役;保留唯一 URL 校验与来源安全回归 |
175
194
 
176
195
  ## 共享安全边界
177
196
 
197
+ 远程 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 监听并保留上游身份和审计。
198
+
199
+ `src/shared/dsh-support.ts` 在候选 `0.3.1` 明确记录三个 Alpha legacy、四个 RC 正常支持和六版退役(最后插件 `0.2.0`)。`retiredOn: 2026-10-28` 是准备日而非 npm 实际发布时间,不驱动停服;进程级/HMR 去重及必要 API、包身份、共享安全检查保留。当前日期见 README。
200
+
178
201
  包身份、向前准入后的 API 检查、具体监听、原始 Host/Origin/Fetch Metadata、回环准入、密码/TOTP、会话、流撤销、存储故障与 CLI 确认适用于所有声明版本。反向代理 HTTPS → HTTP、Host 设置能力 `ownsHost` 和服务端原生浏览器认证交换也不能仅因某个适配退役而删除。
179
202
 
180
203
  生产入口在官方 listener 初始化后校验绑定端口;失败须释放 listener、管理 socket 和存储锁。Connection 丢失或存储状态不可靠时撤回 ready 并关闭业务承载。不得伪造服务、关闭 Loader 启动审计或绕过原生 listener 来通过兼容检查。
@@ -187,6 +210,10 @@
187
210
 
188
211
  仍待补充:各精确版本的 notice/reload 触发映射、非回环 IPv6 实际接口验证、真实官方账号完整授权、公网 `redirect_uri` 的官方支持与 DSH 原生适配。缺口只限制相关结论,不得据此猜测版本能力或提前删除实现。
189
212
 
190
- 2026-10-16 接入证据:精确 tag `dsh-v0.2.1-alpha.4`(`86a402200d95fecef4529d969836f1fe13c6cb0d`)与实际安装包确认上述 `0.2.1-alpha.4` 能力;开发组合仍为 Cordis `4.0.5-alpha.2`、Schemastery `3.18.5-alpha.2`。全部六个 dsh-runtime 条目的适用集合与新八版支持集合仍有交集,均保留;PLUGIN-CONFIG-001 独立保留。此处为接入证据,同一最终包的八版验证另记执行记录,未运行前不推定通过。
213
+ 历史 2026-10-16 接入证据:精确 tag `dsh-v0.2.1-alpha.4`(`86a402200d95fecef4529d969836f1fe13c6cb0d`)与实际安装包确认上述 `0.2.1-alpha.4` 能力;开发组合仍为 Cordis `4.0.5-alpha.2`、Schemastery `3.18.5-alpha.2`。全部六个 dsh-runtime 条目的适用集合与新八版支持集合仍有交集,均保留;PLUGIN-CONFIG-001 独立保留。此处为接入证据,同一最终包的八版验证另记执行记录,未运行前不推定通过。
214
+
215
+ 历史 2026-10-19 Alpha 接入证据:精确 tag `dsh-v0.2.1-alpha.5`(`1517a4dbca0a2789ff1d41ba439600f8547d23fa`)及精确发布包确认新增版本的上述能力。WebServer、Connection、Settings、Slots 与 HMR 的关键 JavaScript 和类型与 `0.2.1-alpha.4` 逐字相同。当时插件开发依赖锁定 Cordis `4.0.5-alpha.2`、Schemastery `3.18.5-alpha.2`;宿主运行时实际解析组合另记执行记录并逐版验证。`0.2.1-alpha.5` 的模型名称 Slot 不参与认证;账号通知新增标题、可选 JSON 元数据和多卡片堆栈,由保留的原生账号菜单处理,插件不复制通知实现。七个 dsh-runtime 条目均与九版支持集合有交集,全部保留;PLUGIN-CONFIG-001 仍按独立政策保留。`host-release.spec.ts` 保留 `0.2.1-alpha.4` → `0.2.1-alpha.3` → `0.2.1-alpha.4`,新增 `0.2.1-alpha.5` → `0.2.1-alpha.4` → `0.2.1-alpha.5` 的真实已知版本提示及刷新检查。原有 notice/reload 触发映射缺口继续保留;同一最终包九版 CLI、完整浏览器、smoke 与哈希结果另记执行记录,不继承旧候选包或专项结果。
216
+
217
+ 历史 2026-10-19 RC 候选接入:核实 `dsh-v0.2.1-rc.1`(`1600d8a1e140dcde43a1a0941940a0480712c011`)、`dsh-v0.2.1-rc.2`(`687f282e8625c6b8d11ff58211a90524be2e4317`)及精确 npm 发布包的身份与完整性。九个已检查宿主模块的 `lib` JavaScript/类型/CSS 与 `0.2.1-alpha.5` 相同:WebServer、Connection、Settings、Slots、账号、账号平台、authorization、WebApp、HMR。开发依赖固定 Cordis `4.0.5`、Schemastery `3.18.5`,实际宿主组合沿安装依赖链另录。七个 dsh-runtime 条目逐一与十一版目标集合仍有交集,全部保留;PLUGIN-CONFIG-001 独立保留。本轮不执行任何实际退役;六版 legacy 日期见[支持规范](support-policy.zh-CN.md)。两个 RC 的真实完整回归、四组宿主切换及最终十一版同包证据记录在独立执行记录;静态相同不代表运行通过,插件 `0.2.0` 不改变 npm `0.1.10` 的历史支持集合。
191
218
 
192
- 2026-10-19 接入证据:精确 tag `dsh-v0.2.1-alpha.5`(`1517a4dbca0a2789ff1d41ba439600f8547d23fa`)及精确发布包确认新增版本的上述能力。WebServer、Connection、Settings、Slots 与 HMR 的关键 JavaScript 和类型与 `0.2.1-alpha.4` 逐字相同。插件开发依赖继续锁定 Cordis `4.0.5-alpha.2`、Schemastery `3.18.5-alpha.2`;宿主运行时实际解析组合另记执行记录并逐版验证。`0.2.1-alpha.5` 的模型名称 Slot 不参与认证;账号通知新增标题、可选 JSON 元数据和多卡片堆栈,由保留的原生账号菜单处理,插件不复制通知实现。七个 dsh-runtime 条目均与九版支持集合有交集,全部保留;PLUGIN-CONFIG-001 仍按独立政策保留。`host-release.spec.ts` 保留 `0.2.1-alpha.4` → `0.2.1-alpha.3` → `0.2.1-alpha.4`,新增 `0.2.1-alpha.5` → `0.2.1-alpha.4` → `0.2.1-alpha.5` 的真实已知版本提示及刷新检查。原有 notice/reload 触发映射缺口继续保留;同一最终包九版 CLI、完整浏览器、smoke 与哈希结果另记执行记录,不继承旧候选包或专项结果。
219
+ 2026-10-28 精确接入:`0.2.1-rc.3` tag `1f81c047fc48fa190a683e469daa699857e9afe8`、`0.2.1-rc.4` tag `504a01a9578abc2c6f1fb896b1dc322c9fe24f66` 及发布归档身份/integrity 已核验;九个关键 lib 树与 `0.2.1-rc.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` 的 focus.css 逐字相同;新 RC 仍有账号 loopback 限制和 HMR 私有 executing/runExclusive 形状,无原生公网授权/公开隔离替代证据,继续保留 ACCOUNT/HMR。Search/Fetch、导航、切换专项通过,最终同包证据另记。
package/docs/releasing.md CHANGED
@@ -2,10 +2,14 @@
2
2
 
3
3
  [简体中文](releasing.zh-CN.md)
4
4
 
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 repeats the full checks, builds the npm archive, verifies or publishes the npm version, and creates a GitHub Release containing the same archive and `SHA256SUMS`.
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
+
7
+ The seven-target support migration belongs to unpublished candidate `0.3.1`. Validate the final archive before publication; existing npm versions remain immutable. The dated changelog and `retiredOn: 2026-10-28` are preparation records, not proof of registry publication.
6
8
 
7
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.
8
10
 
11
+ Before packing, update README, the [DSH → plugin](support-history.md#by-dsh) and [plugin → DSH](support-history.md#by-plugin) history, and inventory in both languages. For this `0.3.1` migration both support-policy files remain unchanged as the previous release record. Keep historical rows/anchors, distinguish published `0.2.0` from this unpublished candidate, and never cite a nonexistent candidate tag as verified evidence.
12
+
9
13
  ## Prepare the version
10
14
 
11
15
  Update `package.json` to `X.Y.Z`, move user-visible changes from Unreleased into `## X.Y.Z - YYYY-MM-DD` in both changelogs, and update any versioned installation examples. Open a pull request, let `CI Verify` pass, merge it, and wait for the `master` check to pass. Do not tag a commit whose checks are still running.
@@ -15,12 +19,44 @@ To verify the merged checkout locally, run:
15
19
  ```sh
16
20
  pnpm install --frozen-lockfile
17
21
  pnpm exec playwright install chromium
18
- pnpm check
19
- pnpm release:pack
20
- pnpm smoke:packed
22
+ pnpm check:static
23
+ pnpm test:unit
24
+ pnpm exec tsx --test tests/integration/*.test.ts
25
+ node scripts/pack.mjs
26
+ node scripts/packed-artifact.mjs record
27
+ ```
28
+
29
+ Use Node.js 24 for production and every consumer. 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
+
31
+ ```sh
32
+ node --input-type=module - <<'JS'
33
+ import { spawnSync } from 'node:child_process'
34
+ import { readFile } from 'node:fs/promises'
35
+ import { archive, testedDshVersions } from './scripts/runtime.mjs'
36
+ import { sha256 } from './scripts/verify-packed.mjs'
37
+ const digest = sha256(await readFile(archive))
38
+ for (const version of testedDshVersions) {
39
+ const result = spawnSync(process.execPath, [
40
+ 'scripts/verify-packed.mjs', '--archive', archive, '--sha256', digest,
41
+ '--dsh-version', version, '--suite', 'cli', '--suite', 'browser', '--suite', 'smoke',
42
+ ], { stdio: 'inherit' })
43
+ if (result.error) throw result.error
44
+ if (result.status !== 0) throw new Error(`Verification failed for ${version}`)
45
+ }
46
+ JS
21
47
  ```
22
48
 
23
- `pnpm release:pack` runs static checks, creates and verifies `artifacts/dsh-auth-remote-X.Y.Z.tgz`; `pnpm smoke:packed` installs that exact archive into an isolated DSH home and tests startup. The tag workflow publishes the verified archive to npm with `npm publish ./artifacts/dsh-auth-remote-X.Y.Z.tgz --access public`. No local npm publication is needed.
49
+ Every subsequent full/release also verifies the adjacent retired host against that same archive. This migration acceptance additionally runs all six negative targets listed in development, serially; they are separate from the positive business matrix.
50
+
51
+ ```sh
52
+ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.1.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
53
+ ```
54
+
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
+
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 seven 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
+
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.
24
60
 
25
61
  ## Tag and inspect the release
26
62
 
@@ -29,18 +65,18 @@ Use the version that is already on `master`:
29
65
  ```sh
30
66
  git switch master
31
67
  git pull --ff-only origin master
32
- git tag -a v0.1.10 -m "Release v0.1.10"
33
- git push origin v0.1.10
68
+ git tag -a v0.3.1 -m "Release v0.3.1"
69
+ git push origin v0.3.1
34
70
  ```
35
71
 
36
- Replace `0.1.10` in these commands with the intended version. The tag must point to a commit reachable from `master`. A mismatched tag, missing changelog entry, failed test, or mismatched existing npm archive stops the release.
72
+ Replace `0.3.1` in these commands with the intended version. The tag must point to a commit reachable from `master`. A mismatched tag, missing changelog entry, failed test, or mismatched existing npm archive stops the release.
37
73
 
38
74
  After the workflow completes, confirm the run, GitHub Release, and npm version:
39
75
 
40
76
  ```sh
41
77
  gh run list --workflow release.yml --limit 5
42
- gh release view v0.1.10
43
- npm view dsh-auth-remote@0.1.10 version dist.integrity
78
+ gh release view v0.3.1
79
+ npm view dsh-auth-remote@0.3.1 version dist.integrity
44
80
  ```
45
81
 
46
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.