dsh-auth-remote 0.1.9 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +32 -0
- package/CHANGELOG.zh-CN.md +32 -0
- package/CONTRIBUTING.md +3 -1
- package/CONTRIBUTING.zh-CN.md +3 -1
- package/README.md +49 -23
- package/README.zh-CN.md +37 -11
- package/cordis.patch.yml +4 -3
- package/dist/cli.js +91 -46
- package/dist/cli.js.map +2 -2
- package/dist/client.js +2880 -581
- package/dist/client.js.map +4 -4
- package/dist/index.js +201 -36
- package/dist/index.js.map +4 -4
- package/dist/login.css +2 -8
- package/dist/login.css.map +2 -2
- package/dist/login.js +80 -42
- package/dist/login.js.map +2 -2
- package/dist/types/adapters/dsh/account-callback.d.ts +3 -0
- package/dist/types/adapters/dsh/account-callback.d.ts.map +1 -1
- package/dist/types/adapters/dsh/hmr-context.d.ts +10 -0
- package/dist/types/adapters/dsh/hmr-context.d.ts.map +1 -0
- package/dist/types/auth/service.d.ts +2 -0
- package/dist/types/auth/service.d.ts.map +1 -1
- package/dist/types/auth/sessions.d.ts +2 -0
- package/dist/types/auth/sessions.d.ts.map +1 -1
- package/dist/types/config.d.ts +9 -3
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/http/account-login.d.ts +5 -3
- package/dist/types/http/account-login.d.ts.map +1 -1
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/shared/account-login.d.ts +2 -1
- package/dist/types/shared/account-login.d.ts.map +1 -1
- package/dist/types/shared/auth-contract.d.ts +2 -0
- package/dist/types/shared/auth-contract.d.ts.map +1 -1
- package/dist/types/shared/dsh-support.d.ts +38 -0
- package/dist/types/shared/dsh-support.d.ts.map +1 -0
- package/dist/types/shared/i18n.d.ts +78 -40
- package/dist/types/shared/i18n.d.ts.map +1 -1
- package/dist/types/shared/locales/en.d.ts +39 -20
- package/dist/types/shared/locales/en.d.ts.map +1 -1
- package/dist/types/shared/locales/zh.d.ts +39 -20
- package/dist/types/shared/locales/zh.d.ts.map +1 -1
- package/docs/deployment.md +26 -21
- package/docs/deployment.zh-CN.md +26 -21
- package/docs/development.md +74 -8
- package/docs/development.zh-CN.md +74 -8
- package/docs/legacy-compatibility.md +96 -64
- package/docs/legacy-compatibility.zh-CN.md +96 -64
- package/docs/releasing.md +40 -10
- package/docs/releasing.zh-CN.md +40 -10
- package/docs/support-history.md +97 -0
- package/docs/support-history.zh-CN.md +97 -0
- package/docs/support-policy.md +87 -0
- package/docs/support-policy.zh-CN.md +87 -0
- package/examples/web-profile-auth-remote.patch.yml +6 -3
- package/package.json +28 -17
|
@@ -2,56 +2,64 @@
|
|
|
2
2
|
|
|
3
3
|
[English](legacy-compatibility.md)
|
|
4
4
|
|
|
5
|
-
最后复核:2026-10-
|
|
5
|
+
最后复核:2026-10-19。本文与英文清单共同维护同一组稳定 ID、版本事实、代码位置、测试与退役条件。修改任一语言时同步另一语言;矩阵是检索入口,条目是维护依据。本文记录 DSH 精确版本差异,不以发布顺序或版本简称代替适用范围。
|
|
6
|
+
|
|
7
|
+
维护日期及当前正常/legacy 承诺见[支持规范](support-policy.zh-CN.md)。历史 [DSH → 插件](support-history.zh-CN.md#by-dsh)与[插件 → DSH](support-history.zh-CN.md#by-plugin)查询区分声明、报告、候选实测及可获取性。下列能力矩阵本身不构成退役公告。
|
|
6
8
|
|
|
7
9
|
## 范围与复核规则
|
|
8
10
|
|
|
9
|
-
插件 `0.1.
|
|
11
|
+
插件 `0.2.0`(不扩写 npm `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-rc.1`、`0.2.1-rc.2`,默认开发和测试版本为 `0.2.1-rc.2`。运行时范围 `>=0.1.7-rc.1` 包含预发布版本;向前准入不代表已验证,仍须检查包身份与必要 API。未列入矩阵的版本不继承验证结论;手动账号回填按 `>=0.2.1-alpha.3`(包含预发布)、必要 API 和动态 `manualAccountLogin` 配置准入,前向准入不代表已验证。
|
|
10
12
|
|
|
11
13
|
- 修改 peers、`dsh.compatibility`、运行时准入、测试目标、CI 或用户兼容声明前,对照两张矩阵及所有相关条目。
|
|
12
14
|
- `dsh-runtime`:适用版本与支持集合仍有交集则保留相应适配;交集为空时,在同一次变更删除专属实现与测试,更新两种语言的矩阵、条目和指南。共享安全校验不随专属分支删除。
|
|
13
|
-
- `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.
|
|
15
|
+
- `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.2.0` 兼容。
|
|
14
16
|
- 缺少精确版本证据时保留实现,明确登记缺口。不同版本通过相同测试,不证明其内部实现相同。
|
|
15
|
-
- 支持范围或共享宿主适配变更须执行同一最终产物的完整声明版本 CLI、浏览器和安装冒烟矩阵。`DSH-ACCOUNT-001`
|
|
17
|
+
- 支持范围或共享宿主适配变更须执行同一最终产物的完整声明版本 CLI、浏览器和安装冒烟矩阵。`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.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` 检查启动、设置入口和适配未启用即可。CLI/smoke 始终包含十一版;全量/发布 browser 同样全覆盖,普通低风险 browser 使用开发指南的固定计划。
|
|
16
18
|
|
|
17
19
|
## 功能 → 版本对照表
|
|
18
20
|
|
|
19
21
|
“原生”表示该精确 DSH 安装包提供能力;“插件校验/补值/启用”表示本插件保留适配;“拒绝/无/未提供”分别表示插件拒绝配置、缺少原生参数或没有该原生功能;“待核实”不代表可以删除代码。HTTP 反向代理的公网 HTTPS 与 DSH 原生 HTTPS 监听是不同能力。
|
|
20
22
|
|
|
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`
|
|
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
|
|
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
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
|
|
|
23
|
+
| 功能与维护 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` | `0.2.1-rc.1` | `0.2.1-rc.2` |
|
|
24
|
+
| ------------------------------------------------------------------- | ------------------- | ------------------- | ------------------- | ------------------- | -------------------- | ------------------------ | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------- |
|
|
25
|
+
| 具体 IPv4 监听校验 · [DSH-HOST-001](#dsh-host-001) | 插件校验 | 插件校验 | 插件校验 | 插件校验 | 插件校验 | 原生校验 | 原生校验 | 原生校验 | 原生校验 | 原生校验 | 原生校验 |
|
|
26
|
+
| 原生 IPv6 监听 · [DSH-HOST-001](#dsh-host-001) | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
|
|
27
|
+
| 原生 HTTPS 监听 · [DSH-PROTOCOL-001](#dsh-protocol-001) | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
|
|
28
|
+
| 服务端 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 | 实际协议与绑定 authority | 实际协议与绑定 authority |
|
|
29
|
+
| 插件唯一 `publicUrl` 入口 · [DSH-PUBLIC-001](#dsh-public-001) | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
|
|
30
|
+
| 原生 `--public-url` 参数 · [DSH-PUBLIC-001](#dsh-public-001) | 无 | 无 | 无 | 无 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
|
|
31
|
+
| 模型侧 Web 地址 · [DSH-PUBLIC-001](#dsh-public-001) | 原生回环文本段 | 原生回环文本段 | 原生回环文本段 | 原生回环文本段 | 最终公开根地址文本段 | 最终公开根地址文本段 | 最终公开根地址运行时上下文 | 最终公开根地址运行时上下文 | 最终公开根地址运行时上下文 | 最终公开根地址运行时上下文 | 最终公开根地址运行时上下文 |
|
|
32
|
+
| `DSH_WEB_URL` · [DSH-PUBLIC-001](#dsh-public-001) | 原生回环地址 | 原生回环地址 | 原生回环地址 | 原生回环地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 | 最终公开根地址 |
|
|
33
|
+
| 圆角与焦点主题 token · [DSH-THEME-001](#dsh-theme-001) | 插件补值 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
|
|
34
|
+
| Switch 滑块主题 token · [DSH-THEME-001](#dsh-theme-001) | 插件补值 | 插件补值 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 | 原生 |
|
|
35
|
+
| HMR 监听器事务上下文 · [DSH-HMR-001](#dsh-hmr-001) | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 | 插件隔离 |
|
|
36
|
+
| 设置入口 · [DSH-TEST-001](#dsh-test-001) | 侧栏设置 | 侧栏设置 | 侧栏设置 | 侧栏设置 | 侧栏设置 | 侧栏设置 | 账号菜单 → 设置 | 账号菜单 → 设置 | 账号菜单 → 设置 | 账号菜单 → 设置 | 账号菜单 → 设置 |
|
|
37
|
+
| 首次提示/保存后重载的精确触发 · [DSH-TEST-001](#dsh-test-001) | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 待核实;保留 helper | 账号引导已适配;notice/reload 触发待核实 | 账号引导及宿主版本刷新提示已验证;其他触发待核实 | 账号引导及宿主版本刷新提示已验证;其他触发待核实 | 账号引导及宿主版本刷新提示已验证;其他触发待核实 | 账号引导及宿主版本刷新提示已验证;其他触发待核实 |
|
|
38
|
+
| 原生官方账号提供者 · [DSH-ACCOUNT-001](#dsh-account-001) | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP | 有;仅回环 HTTP |
|
|
39
|
+
| 普通 Web 官方账号入口 · [DSH-ACCOUNT-001](#dsh-account-001) | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 不启用;仅桌面 | 启用 | 启用 | 启用 | 启用 | 启用 |
|
|
40
|
+
| 原生 `startSignIn` 首参 · [DSH-ACCOUNT-001](#dsh-account-001) | locale 字符串 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 | 客户端元数据对象 |
|
|
41
|
+
| 插件官方账号手动回填 · [DSH-ACCOUNT-001](#dsh-account-001) | 不启用 | 不启用 | 不启用 | 不启用 | 不启用 | 不启用 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 | 插件启用;保留原生 API Key 选择;等待配置后选择入口 |
|
|
42
|
+
| 插件 `0.1.5` 配置输入迁移 · [PLUGIN-CONFIG-001](#plugin-config-001) | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 |
|
|
39
43
|
|
|
40
44
|
## 版本 → 功能对照表
|
|
41
45
|
|
|
42
|
-
每行直接列出该精确版本的实现分支和应复核的条目。`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` 使用客户端元数据对象。删除某个版本的支持时,先找该行,再检查条目的完整适用集合;某一行退出支持不代表该条目可整体删除。
|
|
46
|
+
每行直接列出该精确版本的实现分支和应复核的条目。`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`、`0.2.1-rc.1`、`0.2.1-rc.2` 使用客户端元数据对象。删除某个版本的支持时,先找该行,再检查条目的完整适用集合;某一行退出支持不代表该条目可整体删除。
|
|
43
47
|
|
|
44
|
-
| DSH 精确版本 | 监听与桥接差异
|
|
45
|
-
| --------------- |
|
|
46
|
-
| `0.1.7-rc.1` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1
|
|
47
|
-
| `0.1.7-rc.2` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1
|
|
48
|
-
| `0.2.0-rc.1` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1
|
|
49
|
-
| `0.2.0-rc.2` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1
|
|
50
|
-
| `0.2.1-alpha.1` | 插件校验具体 IPv4;仅 HTTP;Connection 使用 HTTP / `127.0.0.1
|
|
51
|
-
| `0.2.1-alpha.2` | 原生具体 IPv4/IPv6 与 HTTP/HTTPS;Connection 使用实际协议与绑定 authority | 有 `--public-url`;模型文本与 `DSH_WEB_URL` 使用插件最终公开根地址 |
|
|
52
|
-
| `0.2.1-alpha.3` | 原生具体 IPv4/IPv6 与 HTTP/HTTPS;Connection 使用实际协议与绑定 authority
|
|
48
|
+
| DSH 精确版本 | 监听与桥接差异 | 原生公开地址、模型提示与环境变量 | 主题与设置入口 | 官方账号与手动回填 | 删除支持或迁移时复核 |
|
|
49
|
+
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
|
50
|
+
| `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 |
|
|
51
|
+
| `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 |
|
|
52
|
+
| `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 |
|
|
53
|
+
| `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 |
|
|
54
|
+
| `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 |
|
|
55
|
+
| `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 |
|
|
56
|
+
| `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 |
|
|
57
|
+
| `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 |
|
|
58
|
+
| `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 |
|
|
59
|
+
| `0.2.1-rc.1` | 原生具体 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 |
|
|
60
|
+
| `0.2.1-rc.2` | 原生具体 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 |
|
|
53
61
|
|
|
54
|
-
`PLUGIN-CONFIG-001` 与共享安全边界适用于表中每一个版本,不能因为删除任一 DSH
|
|
62
|
+
`PLUGIN-CONFIG-001` 与共享安全边界适用于表中每一个版本,不能因为删除任一 DSH 版本而删除。未列出的未来版本须独立回归后才能声称已验证;`DSH-ACCOUNT-001` 的前向准入本身不构成验证。
|
|
55
63
|
|
|
56
64
|
## 新能力迁移与退役流程
|
|
57
65
|
|
|
@@ -68,7 +76,7 @@
|
|
|
68
76
|
| 字段 | 维护依据 |
|
|
69
77
|
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
70
78
|
| 适配适用版本 | `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 |
|
|
71
|
-
| 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听
|
|
79
|
+
| 原生能力版本 | `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` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听 |
|
|
72
80
|
| 实现与上游 | `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 |
|
|
73
81
|
| 测试与证据 | `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 与策略 |
|
|
74
82
|
| 迁移与退役 | 仅当所有“适配适用版本”退出支持集合,或逐个取得原生能力证据并完成迁移后,删除该集合独占的 IPv4/schema 分支与拒绝测试。保留通配拒绝、端口验证、包身份及共同门禁 |
|
|
@@ -80,7 +88,7 @@
|
|
|
80
88
|
| 字段 | 维护依据 |
|
|
81
89
|
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
82
90
|
| 回退适用版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` 无原生 TLS/protocol API,且 Connection 不识别具体非回环 bind;服务端桥接保留 HTTP / `127.0.0.1`,实际 listener 与插件公开 URL 仍使用具体 IPv4 |
|
|
83
|
-
| 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致
|
|
91
|
+
| 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致 |
|
|
84
92
|
| 实现与上游 | `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 信任,不扩大外层来源准入 |
|
|
85
93
|
| 测试与证据 | `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 |
|
|
86
94
|
| 迁移与退役 | 对每个“回退适用版本”取得原生 protocol/authority 支持证据后才迁移;该集合与支持范围无交集时删除专属回退。保留 HTTP 正向、双向代理、Cookie Secure、流撤销及共享认证检查 |
|
|
@@ -95,68 +103,86 @@
|
|
|
95
103
|
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
96
104
|
| 无原生参数的版本 | `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 能力 |
|
|
97
105
|
| 原生文本投影版本 | `0.2.1-alpha.1`、`0.2.1-alpha.2` 原生消费 `webServer.publicUrl`,模型 system prompt Web 文本与 `DSH_WEB_URL` 使用插件最终公开根地址 |
|
|
98
|
-
| 原生上下文投影版本 | `0.2.1-alpha.3` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址
|
|
106
|
+
| 原生上下文投影版本 | `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` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址 |
|
|
99
107
|
| 实现与上游 | [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 |
|
|
100
108
|
| 测试与证据 | `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` 的上下文变化 |
|
|
101
|
-
| 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`0.2.1-alpha.1`、`0.2.1-alpha.2` 仍受支持时保留文本位置断言;`0.2.1-alpha.3` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式
|
|
109
|
+
| 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`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` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
|
|
102
110
|
|
|
103
111
|
## DSH-THEME-001
|
|
104
112
|
|
|
105
113
|
缺失主题 token 的 CSS 补值,类型为 `dsh-runtime`,现存生效。
|
|
106
114
|
|
|
107
|
-
| 字段 | 维护依据
|
|
108
|
-
| ------------ |
|
|
109
|
-
| 补值适用版本 |
|
|
110
|
-
| 原生能力版本 | `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`
|
|
111
|
-
| 实现与上游 | `src/client/settings/style.css` 的 `var()` fallback;精确 `@deepseek-ai/dsh-client-ui-theme/lib`
|
|
112
|
-
| 测试与证据 | `tests/browser/dsh-bootstrap.spec.ts` 与 `.cache/ui-review/<version>` 人工截图复核。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`
|
|
113
|
-
| 迁移与退役 | `0.1.7-rc.1`
|
|
115
|
+
| 字段 | 维护依据 |
|
|
116
|
+
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
117
|
+
| 补值适用版本 | `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` |
|
|
118
|
+
| 原生能力版本 | `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` 提供圆角/焦点 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`、`0.2.1-rc.1`、`0.2.1-rc.2` 同时提供 switch 滑块 token |
|
|
119
|
+
| 实现与上游 | `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;账号与安全操作弹窗统一表面、圆角、焦点和控制样式 |
|
|
120
|
+
| 测试与证据 | `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。 |
|
|
121
|
+
| 迁移与退役 | `0.1.7-rc.1` 退出支持且其余精确版本证据完整后才可删除圆角/焦点补值;`0.1.7-rc.1`、`0.1.7-rc.2` 任一仍在支持集合时保留 switch 滑块补值。保留动态主题、布局、焦点可见性及共享视觉验证 |
|
|
114
122
|
|
|
115
123
|
## DSH-TEST-001
|
|
116
124
|
|
|
117
125
|
设置导航与首次引导测试适配,类型为 `dsh-runtime`,现存生效;notice/reload 的精确触发范围仍有证据缺口。
|
|
118
126
|
|
|
119
|
-
| 字段 | 维护依据
|
|
120
|
-
| ---------------- |
|
|
121
|
-
| 直接设置入口版本 | `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 引导
|
|
122
|
-
| 账号菜单入口版本 | `0.2.1-alpha.3` 使用账号菜单 → 设置及官方账号引导;手动登录浮层不依附侧栏或引导入口,避免入口重建取消待完成授权 |
|
|
123
|
-
| 已知缺口 | 对 `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`,notice 延迟、确认中替换、首次 API Key 保存与页面重载之间的逐项映射尚未完整建立。不能把共享 helper 通过当作每个触发条件都已逐版复现 |
|
|
124
|
-
| 实现与测试 | `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`
|
|
125
|
-
| 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码
|
|
127
|
+
| 字段 | 维护依据 |
|
|
128
|
+
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
129
|
+
| 直接设置入口版本 | `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 引导 |
|
|
130
|
+
| 账号菜单入口版本 | `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` 使用账号菜单 → 设置及官方账号引导;手动登录浮层不依附侧栏或引导入口,避免入口重建取消待完成授权 |
|
|
131
|
+
| 已知缺口 | 对 `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 通过当作每个触发条件都已逐版复现 |
|
|
132
|
+
| 实现与测试 | `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` |
|
|
133
|
+
| 迁移与退役 | 先以真实 UI 补齐每种交互的精确适用版本,再按支持集合交集删除专属分支。通用异步重试、持久化等待、浏览器 fallback 不自动归类为某个 DSH 版本的专属代码 |
|
|
126
134
|
|
|
127
135
|
`0.2.1-alpha.3` 的并发验证另发现:pnpm 共享硬链接的 ctime 会在其他隔离 profile 安装同包时变化,触发原生 HMR 并销毁客户端插件。测试安装改为复制文件,账号夹具校验客户端文件未共享硬链接;这不是首次引导重载的版本证据,不据此填补上述 notice/reload 缺口。
|
|
128
136
|
|
|
129
137
|
2026-10-15 的 CI 与未设置 `DEEPSEEK_API_KEY` 的本地复现确认:`0.2.1-alpha.3` 在未配置模型凭据时,显式刷新页面会再次显示账号引导;原生 `SettingsRoot` 将已完成引导步骤保存在组件状态中。`tests/browser/login.spec.ts` 在 DSH 运行时环境中清除继承的密钥,刷新后打开插件设置时重新检查引导弹窗,保留原有设置持久化断言。`completeApiKeyPrompt` 在 `0.2.1-alpha.3` 先选择原生 API Key 入口,再进入共用凭据编辑器,确保夹具确实配置了模型提供者。此精确用例不能证明上述全部 notice 延迟或自动重载触发条件。
|
|
130
138
|
|
|
139
|
+
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/首次保存触发的缺口。
|
|
140
|
+
|
|
131
141
|
## DSH-ACCOUNT-001
|
|
132
142
|
|
|
133
143
|
官方账号手动回调对接,类型为 `dsh-runtime`,现存生效;这是可独立退役的临时适配。
|
|
134
144
|
|
|
135
|
-
| 字段 | 维护依据
|
|
136
|
-
| ------------------ |
|
|
137
|
-
| 原生能力与插件范围 | `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`
|
|
138
|
-
|
|
|
139
|
-
| 明确不启用的版本 | `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`
|
|
140
|
-
| 原因与上游 | 精确安装包的 account-platform `protocol.ts/loginOrigin` 在表列全部版本中仅接受带显式端口的回环 HTTP;ui-settings-account 默认使用浏览器 origin。公网浏览器无法自动回调 DSH 设备,外层门禁也拒绝跨站导航
|
|
141
|
-
| 实现 | `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
|
|
142
|
-
| 测试 | `tests/integration/account-login.test.ts`
|
|
143
|
-
| 公网迁移条件 | 官方接受公网 `redirect_uri`,且目标精确 DSH 版本的来源策略、回调、兑换、UI、会话边界均经验证。仅平台开放、DSH 仍限制 `loginOrigin`
|
|
144
|
-
| 退役与保留 | `0.2.1-alpha.3`
|
|
145
|
-
| 证据限制 | 2026-10-15,本地平台替身与真实提供者完整兑换通过;官方 `auth_init` 的回环对照成功并取消,三种 `example.com` 公网写法被 schema 拒绝。未验证真实官方账号完整授权,也未排除官方按域名白名单开放的可能
|
|
145
|
+
| 字段 | 维护依据 |
|
|
146
|
+
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
147
|
+
| 原生能力与插件范围 | `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` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
|
|
148
|
+
| 前向准入规则 | `>=0.2.1-alpha.3`,按 SemVer 包含预发布比较;必要 provider/slot API 可用且 `manualAccountLogin: true` 才接纳新授权。默认 true,使用 Loader 原位更新的 volatile 引用;profile override 不重建认证服务 |
|
|
149
|
+
| 明确不启用的版本 | `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`,已经接纳的授权继续原生命周期 |
|
|
150
|
+
| 原因与上游 | 精确安装包的 account-platform `protocol.ts/loginOrigin` 在表列全部版本中仅接受带显式端口的回环 HTTP;ui-settings-account 默认使用浏览器 origin。公网浏览器无法自动回调 DSH 设备,外层门禁也拒绝跨站导航 |
|
|
151
|
+
| 实现 | `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;菜单登录在偏好未知时等待共享读取,再按最新接纳值选择手动或原生动作。 |
|
|
152
|
+
| 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.1-rc.2` 提供者与本地平台替身,覆盖 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 两种配置初始延迟期间点击登录不提前发起原生授权。 |
|
|
153
|
+
| 公网迁移条件 | 官方接受公网 `redirect_uri`,且目标精确 DSH 版本的来源策略、回调、兑换、UI、会话边界均经验证。仅平台开放、DSH 仍限制 `loginOrigin` 时不能直接删除。前向准入不构成已验证声明,新增实测声明仍须精确回归;只有原生公网流程已证实可用才迁移或退役 |
|
|
154
|
+
| 退役与保留 | `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` 仍在支持集合且仍需回环时保留适配;仅当其适用集合退出支持,或每个精确版本的原生公网流程已验证可用时,删除专属 callback/UI/标志与专属测试。仍被其他流程使用的会话归属、state/PKCE、单次使用、撤销和禁止 URL 网络转发等共享边界继续保留 |
|
|
155
|
+
| 证据限制 | 2026-10-15,本地平台替身与真实提供者完整兑换通过;官方 `auth_init` 的回环对照成功并取消,三种 `example.com` 公网写法被 schema 拒绝。未验证真实官方账号完整授权,也未排除官方按域名白名单开放的可能 |
|
|
156
|
+
|
|
157
|
+
## DSH-HMR-001
|
|
158
|
+
|
|
159
|
+
原生热重载后的长期监听器事务上下文隔离。类型:`dsh-runtime`。保留。
|
|
160
|
+
|
|
161
|
+
| 字段 | 维护依据 |
|
|
162
|
+
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
163
|
+
| 适用版本 | `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` |
|
|
164
|
+
| 原生行为与静态证据 | 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。 |
|
|
165
|
+
| 实现边界 | `src/adapters/dsh/hmr-context.ts`、`src/index.ts`:仅在原生监听器初始化期间,确认 `runExclusive`、原生 AsyncLocalStorage 与当前 true 标记后调用 `exit`。明确依赖私有字段形状,公开 API 暂无对应入口。字段或标记不匹配时保持原生初始化行为;不改写 HMR 队列,不在设置保存/请求分派层退出事务,不削弱真实嵌套拒绝。 |
|
|
166
|
+
| 测试与证据 | `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`;精确命令、数量与最终同包结果另记执行记录。 |
|
|
167
|
+
| 迁移与退役 | 上游提供公开隔离入口时先逐版取得精确证据并迁移;仅当每个仍支持的适用版本原生隔离已修复,或适用集合与支持集合无交集时,才能移除专属实现和测试。同次更新双语双向矩阵。保留认证、来源、原生队列、真正嵌套拒绝及回归检查。 |
|
|
146
168
|
|
|
147
169
|
## PLUGIN-CONFIG-001
|
|
148
170
|
|
|
149
|
-
插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.
|
|
171
|
+
插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.2.0` 保留;与 DSH 版本集合无关。
|
|
150
172
|
|
|
151
173
|
| 字段 | 维护依据 |
|
|
152
174
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
153
|
-
| 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.
|
|
175
|
+
| 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.2.0` 仍保留 |
|
|
154
176
|
| 行为与实现 | `src/config.ts`、[cordis.patch.yml](../cordis.patch.yml)。省略字段与显式空数组可区分;单项转成唯一 `publicUrl`,空数组按监听结果派生;多项、重复项和新字段共存报错。每次激活仅一次弃用提示,不改写 profile;统一启动前解析、监听后定稿 |
|
|
155
177
|
| 测试 | `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 不改写 |
|
|
156
178
|
| 迁移与退役 | 只有插件产品契约明确结束这组输入支持并提供迁移说明时才删除专属检测、转换及测试。任一 DSH 版本退出支持都不足以触发退役;保留唯一 URL 校验与来源安全回归 |
|
|
157
179
|
|
|
158
180
|
## 共享安全边界
|
|
159
181
|
|
|
182
|
+
受保护远程部署必须在 profile 补丁中独立禁用原生 `webserver`,被跳过的认证 bundle 无法应用自身禁用条目。`tests/browser/startup-compatibility.spec.ts` 在 `0.2.1-rc.1`、`0.2.1-rc.2` 使用损坏的隔离插件副本验证真实 bundle 跳过与插件侧运行拒绝,保留 Loader 审计及上游包。TCP、HTTP、readiness 与 WebSocket 升级探测均须拒绝连接;这些夹具仅建立拒绝路径证据。
|
|
183
|
+
|
|
184
|
+
插件 `0.2.0` 在 `src/shared/dsh-support.ts` 根据 manifest 精确声明和显式记录分类维护状态。六版仍在声明中并保持 legacy,没有真实退役记录或日历驱动的准入变化。启动诊断在同一进程中对每个精确版本/状态仅提示一次,配置及模块 HMR 也不重置;认证、必要 API 和包身份仍决定能否提供服务。单元/集成测试及 `tests/browser/account-login.spec.ts` 的真实 legacy/正常版 HMR 诊断覆盖此分离。日期与退役决策见[支持规范](support-policy.zh-CN.md)。
|
|
185
|
+
|
|
160
186
|
包身份、向前准入后的 API 检查、具体监听、原始 Host/Origin/Fetch Metadata、回环准入、密码/TOTP、会话、流撤销、存储故障与 CLI 确认适用于所有声明版本。反向代理 HTTPS → HTTP、Host 设置能力 `ownsHost` 和服务端原生浏览器认证交换也不能仅因某个适配退役而删除。
|
|
161
187
|
|
|
162
188
|
生产入口在官方 listener 初始化后校验绑定端口;失败须释放 listener、管理 socket 和存储锁。Connection 丢失或存储状态不可靠时撤回 ready 并关闭业务承载。不得伪造服务、关闭 Loader 启动审计或绕过原生 listener 来通过兼容检查。
|
|
@@ -168,3 +194,9 @@
|
|
|
168
194
|
2026-10-09 至 2026-10-10 的记录确立了 `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` 的 schema、公开地址、协议分界与插件配置迁移。2026-10-15 增加 `0.2.1-alpha.3` 的运行时上下文、账号菜单、端口类型与账号回调证据。DSH `0.2.1-alpha.3` 开发组合使用 Cordis `4.0.5-alpha.2`、Schemastery `3.18.5-alpha.2`;这些是依赖包版本,不能简称为 DSH 的版本。同日逐一核对全部声明版本的 base 提供者、WebApp 的 account-controller 和 ui-settings-account,确认原生账号提供者已存在、普通 Web UI 的启用分界与 `startSignIn` 首参差异。
|
|
169
195
|
|
|
170
196
|
仍待补充:各精确版本的 notice/reload 触发映射、非回环 IPv6 实际接口验证、真实官方账号完整授权、公网 `redirect_uri` 的官方支持与 DSH 原生适配。缺口只限制相关结论,不得据此猜测版本能力或提前删除实现。
|
|
197
|
+
|
|
198
|
+
历史 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 独立保留。此处为接入证据,同一最终包的八版验证另记执行记录,未运行前不推定通过。
|
|
199
|
+
|
|
200
|
+
历史 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 与哈希结果另记执行记录,不继承旧候选包或专项结果。
|
|
201
|
+
|
|
202
|
+
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` 的历史支持集合。
|
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
|
|
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 RC/lifecycle changes belong to version `0.2.0`. Each release must validate its final archive before publishing. Do not republish or rewrite npm `0.1.10`.
|
|
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 the [support policy](support-policy.md), [DSH → plugin](support-history.md#by-dsh) and [plugin → DSH](support-history.md#by-plugin) history, inventory and README in both languages. Add a newly published version as a new historical row with its own distribution evidence; keep the old npm 0.1.10 record unchanged.
|
|
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,38 @@ 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
|
|
20
|
-
pnpm
|
|
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
|
-
|
|
49
|
+
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).
|
|
50
|
+
|
|
51
|
+
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 eleven declared releases and check the producer's expected SHA-256, package identity and checksum file before consumption. A validation job rejects incomplete matrices; the aggregate requires every planned job to succeed. Failure, cancellation or an unexpected skip blocks publication.
|
|
52
|
+
|
|
53
|
+
`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
54
|
|
|
25
55
|
## Tag and inspect the release
|
|
26
56
|
|
|
@@ -29,18 +59,18 @@ Use the version that is already on `master`:
|
|
|
29
59
|
```sh
|
|
30
60
|
git switch master
|
|
31
61
|
git pull --ff-only origin master
|
|
32
|
-
git tag -a v0.
|
|
33
|
-
git push origin v0.
|
|
62
|
+
git tag -a v0.2.0 -m "Release v0.2.0"
|
|
63
|
+
git push origin v0.2.0
|
|
34
64
|
```
|
|
35
65
|
|
|
36
|
-
Replace `0.
|
|
66
|
+
Replace `0.2.0` 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
67
|
|
|
38
68
|
After the workflow completes, confirm the run, GitHub Release, and npm version:
|
|
39
69
|
|
|
40
70
|
```sh
|
|
41
71
|
gh run list --workflow release.yml --limit 5
|
|
42
|
-
gh release view v0.
|
|
43
|
-
npm view dsh-auth-remote@0.
|
|
72
|
+
gh release view v0.2.0
|
|
73
|
+
npm view dsh-auth-remote@0.2.0 version dist.integrity
|
|
44
74
|
```
|
|
45
75
|
|
|
46
76
|
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.
|
package/docs/releasing.zh-CN.md
CHANGED
|
@@ -2,10 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
[English](releasing.md)
|
|
4
4
|
|
|
5
|
-
每次发布都从已通过检查的 `master` 提交开始。`vX.Y.Z` 标签必须与 `package.json`
|
|
5
|
+
每次发布都从已通过检查的 `master` 提交开始。`vX.Y.Z` 标签必须与 `package.json` 中的稳定版本以及两份更新日志的日期条目一致。标签工作流先核对标签与 master 祖先关系,只构建一个 npm 压缩包,对全部声明的 DSH 版本验证该包,再核对或发布 npm 版本,并创建包含相同压缩包和 `SHA256SUMS` 的 GitHub Release。
|
|
6
|
+
|
|
7
|
+
RC/生命周期变更归入版本 `0.2.0`。每次发布前须验证其最终归档;不得重发或改写 npm `0.1.10`。
|
|
6
8
|
|
|
7
9
|
发布准备中修改支持版本前,先复核 [Legacy 兼容维护清单](legacy-compatibility.zh-CN.md),共同检查 peers、兼容声明、运行时准入、测试目标、CI 和指南。同次删除与支持集合无交集的专属运行时适配,保留共享安全逻辑;旧插件配置退役有独立条件。打包前同步更新并人工核对中英文清单、两个维度的矩阵及完整版本号。
|
|
8
10
|
|
|
11
|
+
打包前同时维护两种语言的[支持规范](support-policy.zh-CN.md)、[DSH → 插件](support-history.zh-CN.md#by-dsh)与[插件 → DSH](support-history.zh-CN.md#by-plugin)历史、库存及 README。新发布版本须新增历史行及自身分发证据,不改写旧 npm 0.1.10 记录。
|
|
12
|
+
|
|
9
13
|
## 准备版本
|
|
10
14
|
|
|
11
15
|
将 `package.json` 更新为 `X.Y.Z`,把两份更新日志中用户可见的“未发布”变更移入 `## X.Y.Z - YYYY-MM-DD`,同时更新带版本号的安装示例。创建 Pull Request,等待 `CI Verify` 通过,合入后再等待 `master` 检查通过。检查尚未结束时不要打标签。
|
|
@@ -15,12 +19,38 @@
|
|
|
15
19
|
```sh
|
|
16
20
|
pnpm install --frozen-lockfile
|
|
17
21
|
pnpm exec playwright install chromium
|
|
18
|
-
pnpm check
|
|
19
|
-
pnpm
|
|
20
|
-
pnpm
|
|
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
|
+
生产及全部消费验证使用 Node.js 24。直接集成测试命令复用静态检查的构建,`pack.mjs` 只生成一次归档,随后 `packed-artifact.mjs record` 写入摘要和精确全量矩阵。对全部声明目标串行消费这份冻结归档:
|
|
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
|
-
|
|
49
|
+
消费循环中不得构建或打包。归档内容变化须产生新候选并重新全量验证。JSON 报告记录摘要、精确版本、suite 范围、命令和真实用例数,见[固定归档指南](development.zh-CN.md#消费固定归档)。
|
|
50
|
+
|
|
51
|
+
工作流 DAG 为 `tag` → `package` → 共用 `verify-packed.yml` → `publish`。producer 上传一份 `release-package` 制品,独立 CLI/smoke 与完整 browser job 覆盖全部十一个声明版本,消费前核对 producer 给出的预期 SHA-256、包身份及摘要文件。验证 job 拒绝不完整矩阵,聚合要求全部计划 job 成功;失败、取消或意外跳过均阻止发布。
|
|
52
|
+
|
|
53
|
+
`publish` 下载同一制品,再次与 producer 预期摘要核对,不构建或打包。保留 npm 同版本字节比较、可信发布及 GitHub Release 重试行为。工作流用 `npm publish ./artifacts/dsh-auth-remote-X.Y.Z.tgz --access public` 发布已验证 tgz,无需在本地手动发布。
|
|
24
54
|
|
|
25
55
|
## 打标签并核对结果
|
|
26
56
|
|
|
@@ -29,18 +59,18 @@ pnpm smoke:packed
|
|
|
29
59
|
```sh
|
|
30
60
|
git switch master
|
|
31
61
|
git pull --ff-only origin master
|
|
32
|
-
git tag -a v0.
|
|
33
|
-
git push origin v0.
|
|
62
|
+
git tag -a v0.2.0 -m "Release v0.2.0"
|
|
63
|
+
git push origin v0.2.0
|
|
34
64
|
```
|
|
35
65
|
|
|
36
|
-
执行时把 `0.
|
|
66
|
+
执行时把 `0.2.0` 换成目标版本。标签必须指向 `master` 可达的提交。标签版本不匹配、缺少更新日志条目、测试失败,或 npm 现存版本与本次压缩包字节不同,都会阻止发布。
|
|
37
67
|
|
|
38
68
|
工作流结束后检查运行状态、GitHub Release 和 npm 版本:
|
|
39
69
|
|
|
40
70
|
```sh
|
|
41
71
|
gh run list --workflow release.yml --limit 5
|
|
42
|
-
gh release view v0.
|
|
43
|
-
npm view dsh-auth-remote@0.
|
|
72
|
+
gh release view v0.2.0
|
|
73
|
+
npm view dsh-auth-remote@0.2.0 version dist.integrity
|
|
44
74
|
```
|
|
45
75
|
|
|
46
76
|
GitHub Release 包含 `.tgz` 和 `SHA256SUMS`。把两者下载到同一个目录,在该目录运行 `sha256sum -c SHA256SUMS` 验证附件。工作流失败时先查看 **Actions → Release** 再重试;npm 版本不可覆盖,因此只有现存版本的压缩包字节与本次构建一致时,工作流才会跳过重复发布。
|