dsh-auth-remote 0.3.3 → 0.3.4
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.
- package/CHANGELOG.md +9 -0
- package/CHANGELOG.zh-CN.md +9 -0
- package/CONTRIBUTING.md +1 -1
- package/CONTRIBUTING.zh-CN.md +1 -1
- package/README.md +11 -5
- package/README.zh-CN.md +11 -5
- package/dist/client.js +8 -0
- package/dist/client.js.map +2 -2
- package/dist/index.js +22 -17
- package/dist/index.js.map +2 -2
- package/dist/types/shared/dsh-support.d.ts.map +1 -1
- package/docs/deployment.md +11 -7
- package/docs/deployment.zh-CN.md +11 -7
- package/docs/development.md +27 -19
- package/docs/development.zh-CN.md +27 -19
- package/docs/legacy-compatibility.md +104 -68
- package/docs/legacy-compatibility.zh-CN.md +98 -62
- package/docs/releasing.md +12 -10
- package/docs/releasing.zh-CN.md +12 -10
- package/docs/reverse-proxy.md +2 -0
- package/docs/reverse-proxy.zh-CN.md +2 -0
- package/docs/support-history.md +67 -63
- package/docs/support-history.zh-CN.md +67 -63
- package/docs/support-policy.md +28 -15
- package/docs/support-policy.zh-CN.md +28 -15
- package/package.json +17 -15
|
@@ -2,23 +2,25 @@
|
|
|
2
2
|
|
|
3
3
|
[English](legacy-compatibility.md)
|
|
4
4
|
|
|
5
|
-
最后复核:2026-
|
|
5
|
+
最后复核:2026-11-05。本文与英文清单共同维护同一组稳定 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
|
-
|
|
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` 保留如下。
|
|
12
12
|
|
|
13
|
-
HOST/PROTOCOL
|
|
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,也不继承旧归档成功。
|
|
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`,仍须保留私有边界。
|
|
14
16
|
|
|
15
17
|
## 范围与复核规则
|
|
16
18
|
|
|
17
|
-
当前九版精确声明如上;DSH `0.2.2-alpha.2` 自身要求 Node `>=24.9.0`,插件引擎仍为 `>=24`,不增加小版本拦截。包含预发布的前向准入仍须身份/API 检查,未知版本不继承实测结论;账号适配还须必要能力和 live `manualAccountLogin`。
|
|
19
|
+
当前九版精确声明如上;DSH `0.2.2-alpha.2`、`0.2.2-alpha.3` 自身要求 Node `>=24.9.0`,插件引擎仍为 `>=24`,不增加小版本拦截。包含预发布的前向准入仍须身份/API 检查,未知版本不继承实测结论;账号适配还须必要能力和 live `manualAccountLogin`。
|
|
18
20
|
|
|
19
21
|
- 修改 peers、`dsh.compatibility`、运行时准入、测试目标、CI 或用户兼容声明前,对照两张矩阵及所有相关条目。
|
|
20
22
|
- `dsh-runtime`:适用版本与支持集合仍有交集则保留相应适配;交集为空时,在同一次变更删除专属实现与测试,更新两种语言的矩阵、条目和指南。共享安全校验不随专属分支删除。
|
|
21
|
-
- `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.3.
|
|
23
|
+
- `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.3.4` 兼容。
|
|
22
24
|
- 缺少精确版本证据时保留实现,明确登记缺口。不同版本通过相同测试,不证明其内部实现相同。
|
|
23
25
|
- 支持范围或共享宿主适配变更须对同一最终归档完整运行九版 CLI、browser、smoke,并保留完整账号回归;普通选择见开发指南。当前 full/发布独立验证相邻退役 `0.2.1-alpha.2`;六版一次性负向验收属于 `0.3.1` 迁移历史,本次不重复。
|
|
24
26
|
|
|
@@ -26,45 +28,47 @@ HOST/PROTOCOL 旧路径、PUBLIC 参数/文本路径、THEME radius/thumb 补值
|
|
|
26
28
|
|
|
27
29
|
各行列出适配或迁移及其精确适用宿主。稳定条目保留历史原生事实;退役仅删除独占实现,保留共享安全校验。
|
|
28
30
|
|
|
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`
|
|
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`
|
|
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`
|
|
35
|
-
| [DSH-THEME-001](#dsh-theme-001),radius 补值 | `0.1.7-rc.1`
|
|
36
|
-
| [DSH-THEME-001](#dsh-theme-001),switch-thumb 补值 | `0.1.7-rc.1`、`0.1.7-rc.2`
|
|
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`、`0.2.1-rc.5`、`0.2.2-alpha.2` |
|
|
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`
|
|
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`、`0.2.1-rc.5`、`0.2.2-alpha.2` | 保留;全局准入后删除服务端旧版本分流;导出 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`、`0.2.1-rc.5`、`0.2.2-alpha.2` | 保留受支持宿主适配;仅移除退役版矩阵目标
|
|
41
|
-
| [DSH-RESOURCE-001](#dsh-resource-001) | `0.2.2-alpha.2` | 保留单实例私有 HTTP resource 门禁;原生进程内 peer
|
|
42
|
-
| [DSH-LIVESHARE-001](#dsh-liveshare-001) | `0.2.2-alpha.2` | 公开 peer/baseline 隔离与 connection/request Origin 业务恢复;本地原生 HTTPS/代理 Relay
|
|
43
|
-
| [
|
|
44
|
-
| [PLUGIN-
|
|
45
|
-
| [PLUGIN-
|
|
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 由插件政策结束 |
|
|
46
49
|
|
|
47
50
|
## 版本 → 功能对照表
|
|
48
51
|
|
|
49
52
|
历史行保留可查询性;退役行不属于当前正向目标。所有受支持行均使用原生具体 IPv4/IPv6、HTTP/HTTPS、上下文投影、原生 radius/thumb token 与焦点规则 和账号菜单 Settings。新 RC 精确发布代码/API 证据见下文,最终同包运行证据另记。
|
|
50
53
|
|
|
51
|
-
| 精确 DSH 版本 | 当前状态
|
|
52
|
-
| --------------- |
|
|
53
|
-
| `0.1.7-rc.1` | `0.3.1` 退役;最后插件 `0.2.0`
|
|
54
|
-
| `0.1.7-rc.2` | `0.3.1` 退役;最后插件 `0.2.0`
|
|
55
|
-
| `0.2.0-rc.1` | `0.3.1` 退役;最后插件 `0.2.0`
|
|
56
|
-
| `0.2.0-rc.2` | `0.3.1` 退役;最后插件 `0.2.0`
|
|
57
|
-
| `0.2.1-alpha.1` | `0.3.1` 退役;最后插件 `0.2.0`
|
|
58
|
-
| `0.2.1-alpha.2` | `0.3.1` 退役;最后插件 `0.2.0`
|
|
59
|
-
| `0.2.1-alpha.3` | Legacy;最低支持
|
|
60
|
-
| `0.2.1-alpha.4` | Legacy
|
|
61
|
-
| `0.2.1-alpha.5` | Legacy
|
|
62
|
-
| `0.2.1-rc.1` | 正常支持
|
|
63
|
-
| `0.2.1-rc.2` | 正常支持
|
|
64
|
-
| `0.2.1-rc.3` | 支持
|
|
65
|
-
| `0.2.1-rc.4` | 支持
|
|
66
|
-
| `0.2.1-rc.5` | 支持
|
|
67
|
-
| `0.2.2-alpha.2` |
|
|
54
|
+
| 精确 DSH 版本 | 当前状态 | 历史适配 / 保留的共享检查 |
|
|
55
|
+
| --------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
56
|
+
| `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 首参为语言字符串 |
|
|
57
|
+
| `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 首参为元数据对象 |
|
|
58
|
+
| `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 |
|
|
59
|
+
| `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 |
|
|
60
|
+
| `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;原生公开地址文本 |
|
|
61
|
+
| `0.2.1-alpha.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001;原生传输和公开地址文本 |
|
|
62
|
+
| `0.2.1-alpha.3` | Legacy;最低支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验、context/env 和通用引导回归;原生 release 元数据缺失; DSH-SETTINGS-ICON-001:宿主默认 |
|
|
63
|
+
| `0.2.1-alpha.4` | Legacy | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归; DSH-SETTINGS-ICON-001:宿主默认 |
|
|
64
|
+
| `0.2.1-alpha.5` | Legacy | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归; DSH-SETTINGS-ICON-001:宿主默认 |
|
|
65
|
+
| `0.2.1-rc.1` | 正常支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归; DSH-SETTINGS-ICON-001:宿主默认 |
|
|
66
|
+
| `0.2.1-rc.2` | 正常支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings、宿主版本提示及 Search/Fetch 回归; DSH-SETTINGS-ICON-001:宿主默认 |
|
|
67
|
+
| `0.2.1-rc.3` | 支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换; DSH-SETTINGS-ICON-001:宿主默认 |
|
|
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
|
+
| `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
|
+
| `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 原生盾牌;保留共享原生/安全检查 |
|
|
68
72
|
|
|
69
73
|
PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均独立于运行时适配退役,适用于当前插件的全部宿主;前向准入不构成精确实测。
|
|
70
74
|
|
|
@@ -83,7 +87,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
83
87
|
| 字段 | 维护依据 |
|
|
84
88
|
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
85
89
|
| 适配适用版本 | `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 |
|
|
86
|
-
| 原生能力版本 | `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` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听
|
|
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;不允许通配监听 |
|
|
87
91
|
| 实现与上游 | `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 |
|
|
88
92
|
| 测试与证据 | `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 与策略 |
|
|
89
93
|
| 迁移与退役 | 仅当所有“适配适用版本”退出支持集合,或逐个取得原生能力证据并完成迁移后,删除该集合独占的 IPv4/schema 分支与拒绝测试。保留通配拒绝、端口验证、包身份及共同门禁 |
|
|
@@ -97,7 +101,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
97
101
|
| 字段 | 维护依据 |
|
|
98
102
|
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
99
103
|
| 回退适用版本 | `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 |
|
|
100
|
-
| 原生能力版本 | `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` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致
|
|
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 比较一致 |
|
|
101
105
|
| 实现与上游 | `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 信任,不扩大外层来源准入 |
|
|
102
106
|
| 测试与证据 | `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 |
|
|
103
107
|
| 迁移与退役 | 对每个“回退适用版本”取得原生 protocol/authority 支持证据后才迁移;该集合与支持范围无交集时删除专属回退。保留 HTTP 正向、双向代理、Cookie Secure、流撤销及共享认证检查 |
|
|
@@ -114,10 +118,10 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
114
118
|
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
115
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 能力 |
|
|
116
120
|
| 原生文本投影版本 | `0.2.1-alpha.1`、`0.2.1-alpha.2` 原生消费 `webServer.publicUrl`,模型 system prompt Web 文本与 `DSH_WEB_URL` 使用插件最终公开根地址 |
|
|
117
|
-
| 原生上下文投影版本 | `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` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`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` 继续使用最终公开根地址 |
|
|
118
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 |
|
|
119
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` 的上下文变化 |
|
|
120
|
-
| 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`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` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式
|
|
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` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
|
|
121
125
|
|
|
122
126
|
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/来源/撤销共享检查保留。
|
|
123
127
|
|
|
@@ -128,10 +132,10 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
128
132
|
| 字段 | 维护依据 |
|
|
129
133
|
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
130
134
|
| 补值适用版本 | `0.3.1` 历史迁移:历史 radius-md/lg 对应 `0.1.7-rc.1`,switch-thumb 对应 `0.1.7-rc.1`、`0.1.7-rc.2`;重复焦点颜色 fallback 按七版原生规则迁移 |
|
|
131
|
-
| 原生能力版本 | `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` 均提供 radius/thumb 定义与相同原生焦点规则;focus-ring-color 是可选 override,不是正常键盘模式必有的 root token。历史 radius 从 `0.1.7-rc.2`、thumb 从 `0.2.0-rc.1` 已确认
|
|
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` 已确认 |
|
|
132
136
|
| 实现与上游 | `src/client/settings/style.css`、`src/client/account/style.css` 直接读取原生 radius/thumb;焦点只设 solid outline、`--dsw-focus-ring-width` 和 offset,颜色委托宿主 :focus-visible;独立登录页保持自身样式 |
|
|
133
137
|
| 测试与证据 | `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。 |
|
|
134
|
-
| 迁移与退役 | 旧 radius/thumb 适用集合退出后移除专属 fallback
|
|
138
|
+
| 迁移与退役 | 旧 radius/thumb 适用集合退出后移除专属 fallback;当前九个受支持版本的焦点颜色已按原生规则迁移,不直接读取未定义 override。保留动态主题、布局、可见焦点、开关外观和共享视觉测试 |
|
|
135
139
|
|
|
136
140
|
2026-10-28 清理:旧 radius、switch-thumb 和直接 Settings 的精确适用集合如上表,与七版支持无交集;删除专属实现。重复焦点颜色 fallback 依据七版原生规则迁移,不假定正常模式存在 focus-ring-color。通用引导、重开、持久化重试及共享视觉断言保留。
|
|
137
141
|
|
|
@@ -141,13 +145,13 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
141
145
|
|
|
142
146
|
设置导航与首次引导测试适配,类型为 `dsh-runtime`,直接入口已在插件 `0.3.1` 退役;通用首次引导重试保留,notice/reload 的精确触发范围仍有证据缺口。
|
|
143
147
|
|
|
144
|
-
| 字段 | 维护依据
|
|
145
|
-
| ---------------- |
|
|
146
|
-
| 直接设置入口版本 | `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 引导
|
|
147
|
-
| 账号菜单入口版本 | `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` 使用账号菜单 → 设置与原生官方账号引导;手动登录浮层不创建另一设置入口,通用异步重试继续保留。 |
|
|
148
|
-
| 已知缺口 | 对 `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`,notice 延迟、确认中替换、首次 API Key 保存与页面重载之间的逐项映射尚未完整建立。不能把共享 helper 通过当作每个触发条件都已逐版复现 |
|
|
149
|
-
| 实现与测试 | `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`
|
|
150
|
-
| 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码
|
|
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 版本的专属代码 |
|
|
151
155
|
|
|
152
156
|
`0.2.1-alpha.3` 的并发验证另发现:pnpm 共享硬链接的 ctime 会在其他隔离 profile 安装同包时变化,触发原生 HMR 并销毁客户端插件。测试安装改为复制文件,账号夹具校验客户端文件未共享硬链接;这不是首次引导重载的版本证据,不据此填补上述 notice/reload 缺口。
|
|
153
157
|
|
|
@@ -163,14 +167,14 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
163
167
|
|
|
164
168
|
| 字段 | 维护依据 |
|
|
165
169
|
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
166
|
-
| 原生能力与插件范围 | `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` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力”
|
|
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` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
|
|
167
171
|
| 前向准入规则 | `>=0.2.1-alpha.3`,按 SemVer 包含预发布比较;必要 provider/slot API 可用且 `manualAccountLogin: true` 才接纳新授权。默认 true,使用 Loader 原位更新的 volatile 引用;profile override 不重建认证服务 |
|
|
168
172
|
| 历史关闭分支 | 旧六版服务端分支随全局下限移除,不再保留正向目标;导出 helper 仍拒绝缺省/无效/旧参数。必要 API 缺失仍不可用,动态 false 拒绝新授权并保留已接纳 attempt |
|
|
169
173
|
| 原因与上游 | 精确安装包的 account-platform `protocol.ts/loginOrigin` 在表列全部版本中仅接受带显式端口的回环 HTTP;ui-settings-account 默认使用浏览器 origin。公网浏览器无法自动回调 DSH 设备,外层门禁也拒绝跨站导航 |
|
|
170
174
|
| 实现 | `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;菜单登录在偏好未知时等待共享读取,再按最新接纳值选择手动或原生动作。 |
|
|
171
|
-
| 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.2-alpha.
|
|
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 两种配置初始延迟期间点击登录不提前发起原生授权。 插件字典不扩充旧宿主原生语言目录。 |
|
|
172
176
|
| 公网迁移条件 | 官方接受公网 `redirect_uri`,且目标精确 DSH 版本的来源策略、回调、兑换、UI、会话边界均经验证。仅平台开放、DSH 仍限制 `loginOrigin` 时不能直接删除。前向准入不构成已验证声明,新增实测声明仍须精确回归;只有原生公网流程已证实可用才迁移或退役 |
|
|
173
|
-
| 退役与保留 | `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` 仍需回环,继续保留;只有适用集合退出支持或每个仍支持精确宿主的原生公网流程经验证可用才删除专属实现。共享 state/PKCE、会话归属、单次使用、撤销及禁止 URL 转发保留
|
|
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 转发保留 |
|
|
174
178
|
| 证据限制 | 2026-10-15,本地平台替身与真实提供者完整兑换通过;官方 `auth_init` 的回环对照成功并取消,三种 `example.com` 公网写法被 schema 拒绝。未验证真实官方账号完整授权,也未排除官方按域名白名单开放的可能 |
|
|
175
179
|
|
|
176
180
|
2026-10-28:七个准入宿主都使用原生元数据对象调用。全局准入后服务端不再按旧版本停用 provider 或 bridge;能力检查和动态偏好语义保留。独立导出的 index 注入 helper 对省略、无效、低版本输入仍只提供 ownsHost,不授予手动标志。`tests/unit/client-capability.test.ts` 分别验证两个边界。
|
|
@@ -183,19 +187,21 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
183
187
|
|
|
184
188
|
| 字段 | 维护依据 |
|
|
185
189
|
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
186
|
-
| 适用版本 | `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`
|
|
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` |
|
|
187
191
|
| 原生行为与静态证据 | 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 嵌套拒绝,没有公开监听器隔离接口;不能据同名方法推定未来版本。 |
|
|
188
192
|
| 实现边界 | `src/adapters/dsh/hmr-context.ts`、`src/index.ts`:仅在原生监听器初始化期间,确认 `runExclusive`、原生 AsyncLocalStorage 与当前 true 标记后调用 `exit`。明确依赖私有字段形状,公开 API 暂无对应入口。字段或标记不匹配时保持原生初始化行为;不改写 HMR 队列,不在设置保存/请求分派层退出事务,不削弱真实嵌套拒绝。 |
|
|
189
193
|
| 测试与证据 | `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 断连、锁释放/再获取和认证状态持久化均纳入用例。最终同包报告另记。 |
|
|
190
194
|
| 迁移与退役 | 上游提供公开隔离入口时先逐版取得精确证据并迁移;仅当每个仍支持的适用版本原生隔离已修复,或适用集合与支持集合无交集时,才能移除专属实现和测试。同次更新双语双向矩阵。保留认证、来源、原生队列、真正嵌套拒绝及回归检查。 |
|
|
191
195
|
|
|
196
|
+
2026-11-03 精确复核:DSH `0.2.2-alpha.3` 的 HMR 保留 `executing: AsyncLocalStorage` 与 `runExclusive` 嵌套拒绝;其整个 lib 并不与 `0.2.2-alpha.2` 相同。Loader 改为保存 registry wrapper,canonical 身份为 `entry.fiber.ctx.fiber`。Cordis `4.0.6-alpha.2` 的 `config` 保存原始输入,`effectiveConfig` 保存运行对象。`tests/fixtures/live-config-observer.mjs` 要求 ACTIVE 和 `.get()` 引用,仅在访问器不存在时回退旧 `config`,比较同一 fiber/引用/auth/store/listener/lock。生产 `src/config.ts`/`src/index.ts` 保留构造参数的 Volatile。`0.2.2-alpha.2`、`0.2.2-alpha.3` 均注册真实 HMR 故障/清理/回滚用例;最终归档证据另记。
|
|
197
|
+
|
|
192
198
|
## DSH-RESOURCE-001
|
|
193
199
|
|
|
194
200
|
原生 HTTP resource 准入。类型:`dsh-runtime`。新增于插件 `0.3.2`。
|
|
195
201
|
|
|
196
202
|
| 字段 | 维护依据 |
|
|
197
203
|
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
198
|
-
| 精确适用版本 | `0.2.2-alpha.2
|
|
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 注册门禁。 |
|
|
199
205
|
| 原生形状与顺序 | 精确发布 `@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。方法存在不能证明未来语义相同。 |
|
|
200
206
|
| 实现 | `src/adapters/dsh/webserver.ts`:单实例捕获原函数并保留 this;转换前执行 gate,根 token 删除后按已接纳 req.url 重建 target,然后委托原生。不修改 prototype、不复制路由/流、不将 resource 包成 handler、不伪造 owner、不包装 `readResource(request, peer)`;handler/upgrade 门禁保留。 |
|
|
201
207
|
| 失败与生命周期 | resource 读取存在但缺失 serveResource、私有包装无法安装、未安装边界却注册 resource 时,按具体 API 错误拒绝激活/注册。DenyGate/readiness 保持关闭。AuthConnections 跟踪原始 Node response,覆盖等待 Response 与背压;IO 的 abort/body cancel 继续原生处理。不新增版本上限或未知版本拒绝。 |
|
|
@@ -204,6 +210,8 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
204
210
|
|
|
205
211
|
2026-10-28 候选交集复核:DSH-HOST-001、DSH-PROTOCOL-001,以及 DSH-PUBLIC-001/DSH-THEME-001/DSH-TEST-001 已退役路径维持原精确历史集合,不重复退役。DSH-ACCOUNT-001、DSH-HMR-001 在 `0.2.2-alpha.2` 的精确发布 loopback/AsyncLocalStorage 代码仍需保留,`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` 同样保留。PLUGIN-CONFIG-001 按独立政策保留;本次准入不填补既有历史证据缺口。
|
|
206
212
|
|
|
213
|
+
2026-11-03 扩展:精确 `@deepseek-ai/dsh-host-webserver@0.2.2-alpha.3` 与 `@deepseek-ai/dsh-host-webserver@0.2.2-alpha.2` 的完整 lib 树逐字相同,包含上述 named/fallback 分派与私有 `serveResource` 边界。新源码身份为 tag `dsh-v0.2.2-alpha.3`、commit `05b1cae8db6e674c5685101494d4eec24652424a`。支持适用交集精确为 `0.2.2-alpha.2`、`0.2.2-alpha.3`,保留单实例私有门禁及共享安全测试;两宿主均注册资源缓存和四个 ingress/compression mux 用例,不将静态相同当作最终运行验收。
|
|
214
|
+
|
|
207
215
|
## DSH-LIVESHARE-001
|
|
208
216
|
|
|
209
217
|
公开 peer 准入与 Owner 登录业务 Origin。类型:`dsh-runtime`。插件 `0.3.2` 新增,精确适用 DSH `0.2.2-alpha.2`。
|
|
@@ -214,15 +222,29 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
214
222
|
| 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 不变。 |
|
|
215
223
|
| 保留安全与生命周期 | 外层原始头/来源/会话门禁、native admit、原生 Cookie authority、readiness、trustedHosts 和 preserveOriginPaths 保持。不能用 owner peer 替代 HTTP 鉴权,不绑定分享与插件会话生命周期。插件激活不启用 LiveShare,不改变生产 Relay 配置。 |
|
|
216
224
|
| 测试与限制 | `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/产品体验、访客模型操作或文件写入。 |
|
|
217
|
-
| 迁移与退役 | 受支持的 `0.2.2-alpha.2` 仍需这些边界时保留。原生提供公开业务 Origin 合同后先取得精确证据并迁移;仅当全部受支持适用版本已迁移或支持交集为空才删除专属实现/测试;共享准入、owner/viewer 身份与生命周期回归保留。
|
|
225
|
+
| 迁移与退役 | 受支持的 `0.2.2-alpha.2`、`0.2.2-alpha.3` 仍需这些边界时保留。原生提供公开业务 Origin 合同后先取得精确证据并迁移;仅当全部受支持适用版本已迁移或支持交集为空才删除专属实现/测试;共享准入、owner/viewer 身份与生命周期回归保留。 |
|
|
226
|
+
|
|
227
|
+
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
|
+
## DSH-SETTINGS-ICON-001
|
|
230
|
+
|
|
231
|
+
安全与登录导航的可选原生图标。类型:`dsh-runtime`。插件 `0.3.4` 新增,支持适用交集非空时保留。
|
|
232
|
+
|
|
233
|
+
| 字段 | 维护依据 |
|
|
234
|
+
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
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`。 |
|
|
237
|
+
| 实现与生命周期 | `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/测试,并同步两种语言及两个维度矩阵。保留管理员边界、宿主所有权和共享视觉/安全检查。 |
|
|
218
240
|
|
|
219
241
|
## PLUGIN-CONFIG-001
|
|
220
242
|
|
|
221
|
-
插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.3.
|
|
243
|
+
插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.3.4` 保留;与 DSH 版本集合无关。
|
|
222
244
|
|
|
223
245
|
| 字段 | 维护依据 |
|
|
224
246
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
225
|
-
| 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.3.1`、`0.3.2` 与 `0.3.
|
|
247
|
+
| 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.3.1`、`0.3.2`、`0.3.3` 与 `0.3.4` 仍保留 |
|
|
226
248
|
| 行为与实现 | `src/config.ts`、[cordis.patch.yml](../cordis.patch.yml)。省略字段与显式空数组可区分;单项转成唯一 `publicUrl`,空数组按监听结果派生;多项、重复项和新字段共存报错。每次激活仅一次弃用提示,不改写 profile;统一启动前解析、监听后定稿 |
|
|
227
249
|
| 测试 | `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 不改写 |
|
|
228
250
|
| 迁移与退役 | 只有插件产品契约明确结束这组输入支持并提供迁移说明时才删除专属检测、转换及测试。任一 DSH 版本退出支持都不足以触发退役;保留唯一 URL 校验与来源安全回归 |
|
|
@@ -247,7 +269,7 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
247
269
|
|
|
248
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 监听并保留上游身份和审计。
|
|
249
271
|
|
|
250
|
-
`src/shared/dsh-support.ts`
|
|
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、身份和共享安全检查保留;零日上游故障例外见支持规范。
|
|
251
273
|
|
|
252
274
|
包身份、向前准入后的 API 检查、具体监听、原始 Host/Origin/Fetch Metadata、回环准入、密码/TOTP、会话、流撤销、存储故障与 CLI 确认适用于所有声明版本。反向代理 HTTPS → HTTP、Host 设置能力 `ownsHost` 和服务端原生浏览器认证交换也不能仅因某个适配退役而删除。
|
|
253
275
|
|
|
@@ -275,4 +297,18 @@ PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 与共享认证检查均
|
|
|
275
297
|
|
|
276
298
|
`0.3.3` 逐条支持交集复核:DSH-HOST-001、DSH-PROTOCOL-001 及 DSH-PUBLIC-001/DSH-THEME-001/DSH-TEST-001 已退役路径维持原精确历史适用集合和退役证据;原生校验、上下文/主题和账号菜单检查加入 `0.2.1-rc.5`,通用异步重试及 notice/reload 证据缺口保留。DSH-ACCOUNT-001 在 `0.2.1-rc.5` 仍需回环回填,DSH-HMR-001 仍需相同 executing/runExclusive 隔离,两者与支持集合的交集继续非空。DSH-RESOURCE-001 和 DSH-LIVESHARE-001 仍仅适用 `0.2.2-alpha.2`。PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 继续按独立合同保留。本次新增支持不退役任何实现或测试。
|
|
277
299
|
|
|
278
|
-
新精确回归目标使用 `tests/browser/account-login.spec.ts`、`live-config.spec.ts`、`startup-compatibility.spec.ts`、`web-search-settings.spec.ts`、`rc-navigation.spec.ts`,以及 `host-release.spec.ts` 的 `0.2.1-rc.5` ↔ `0.2.1-rc.4
|
|
300
|
+
新精确回归目标使用 `tests/browser/account-login.spec.ts`、`live-config.spec.ts`、`startup-compatibility.spec.ts`、`web-search-settings.spec.ts`、`rc-navigation.spec.ts`,以及 `host-release.spec.ts` 的 `0.2.1-rc.5` ↔ `0.2.1-rc.4`。上述历史 `0.3.3` 验证合同要求九个精确版本的 CLI、完整 browser 与 smoke;不认证当前 `0.3.4` 归档,也不推定旧包实测结果。
|
|
301
|
+
|
|
302
|
+
2026-11-03 `0.3.4` 准入复核:精确 DSH tag `dsh-v0.2.2-alpha.3` 为 `05b1cae8db6e674c5685101494d4eec24652424a`,已核对发布包身份/完整性及隔离安装的实际依赖链。WebApp、WebServer、Connection 和账号包解析到 `0.2.2-alpha.3`,Cordis 为 `4.0.6-alpha.2`、Schemastery 为 `3.18.6-alpha.2`、Loader 为 `1.0.7-alpha.2`、Include 为 `1.0.11-alpha.2`,不改写各旧宿主组合事实。原生 `@deepseek-ai/dsh-client-ui-theme@0.2.2-alpha.3/lib/client.js` 第1473行保留原生 focus fallback 和透明 pointer override,SHA-256 为 `78d79a77112e2a83cfa1a9015c06f4b980efb9e1b071bc0b2ba46525748c3592`,不表示整个主题包相同。
|
|
303
|
+
|
|
304
|
+
逐条复核维持 HOST/PROTOCOL 和 PUBLIC/THEME/TEST 独占路径原有空交集及退役证据;共享原生校验、context、focus 和账号菜单检查加入精确 `0.2.2-alpha.3`,notice/reload 触发映射缺口保留。ACCOUNT/HMR 仍有非空支持交集,继续回环/事务适配;RESOURCE/LIVESHARE 交集扩为精确 `0.2.2-alpha.2`、`0.2.2-alpha.3`;SETTINGS-ICON 交集为精确 `0.2.2-alpha.3`,其余九个默认已逐一列出。PLUGIN-CONFIG-001、PLUGIN-LOCALE-001、PLUGIN-CLI-001 保持独立迁移政策,不退役任何适配或共享安全检查。两张矩阵和条目经人工及本地 agent 复核,不引入库存生成器或专用 CI gate。2026-11-03 复核时,`0.3.4` 仍为本地候选;最终十版 CLI/browser/smoke 与独立 `0.2.1-alpha.2` 拒绝报告在 npm 包外绑定各自源码/归档身份,本地协议替身和未知宿主不继承更广声明。
|
|
305
|
+
|
|
306
|
+
2026-11-04 发布准备:当前版本说明改为正式发布流程,十个精确声明、十三个库存条目、适用版本交集、legacy 日期和独立插件合同均未改变。实际可用性由发布工作流及 registry 确认;早期本地候选报告不认证新的发布归档。标签工作流须重新产出归档,对十版完整验收后才发布。
|
|
307
|
+
|
|
308
|
+
## 2026-11-05 退役复核
|
|
309
|
+
|
|
310
|
+
`0.3.4` 仅撤销精确 DSH `0.2.2-alpha.2`:原生隔离复现证实已发布 `@deepseek-ai/dsh-app-boot@0.2.2-alpha.2` 的 `internal/update` 回调与 Cordis `4.0.6-alpha.2` 不兼容。全新解析报 `next is not a function`,原始 Cordis `4.0.6-alpha.1` 组合正常。CI run `41807651546` / browser job `126499190719` 不等同于早期通过的依赖组合;早期 CI 的 SDK 版本按发布等待时间窗口重建,并非恢复的原锁文件。2026-11-05 已复核插件 `0.3.3` 及迁移宿主 `0.2.2-alpha.3` 的 registry 归档/完整性;旧插件可获取不能修复原生依赖不匹配。
|
|
311
|
+
|
|
312
|
+
逐条交集复核: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
|
+
`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,不能沿用旧归档结果。
|
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
|
-
|
|
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.
|
|
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` from the
|
|
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.
|
|
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.
|
|
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:
|
|
30
30
|
|
|
31
31
|
```sh
|
|
32
32
|
node --input-type=module - <<'JS'
|
|
@@ -46,10 +46,10 @@ 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.
|
|
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.
|
|
50
50
|
|
|
51
51
|
```sh
|
|
52
|
-
node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.
|
|
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
|
|
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).
|
|
@@ -65,18 +65,20 @@ Use the version that is already on `master`:
|
|
|
65
65
|
```sh
|
|
66
66
|
git switch master
|
|
67
67
|
git pull --ff-only origin master
|
|
68
|
-
git tag -a
|
|
69
|
-
git push origin
|
|
68
|
+
git tag -a vX.Y.Z -m "Release vX.Y.Z"
|
|
69
|
+
git push origin vX.Y.Z
|
|
70
70
|
```
|
|
71
71
|
|
|
72
|
-
Replace `
|
|
72
|
+
Replace `X.Y.Z` 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.
|
|
73
73
|
|
|
74
74
|
After the workflow completes, confirm the run, GitHub Release, and npm version:
|
|
75
75
|
|
|
76
76
|
```sh
|
|
77
77
|
gh run list --workflow release.yml --limit 5
|
|
78
|
-
gh release view
|
|
79
|
-
npm view dsh-auth-remote@
|
|
78
|
+
gh release view vX.Y.Z
|
|
79
|
+
npm view dsh-auth-remote@X.Y.Z version dist.integrity
|
|
80
80
|
```
|
|
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
|
+
|
|
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.
|