dsh-auth-remote 0.2.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/CHANGELOG.zh-CN.md +10 -0
- package/CONTRIBUTING.md +2 -0
- package/CONTRIBUTING.zh-CN.md +2 -0
- package/README.md +19 -41
- package/README.zh-CN.md +19 -41
- package/dist/client.js +2 -2
- package/dist/client.js.map +1 -1
- package/dist/index.js +45 -49
- package/dist/index.js.map +3 -3
- package/dist/types/adapters/dsh/compatibility.d.ts +1 -1
- package/dist/types/adapters/dsh/compatibility.d.ts.map +1 -1
- package/dist/types/adapters/dsh/runtime-capabilities.d.ts +6 -11
- package/dist/types/adapters/dsh/runtime-capabilities.d.ts.map +1 -1
- package/dist/types/config.d.ts +2 -2
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/http/account-login.d.ts.map +1 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/shared/dsh-support.d.ts.map +1 -1
- package/docs/deployment.md +22 -20
- package/docs/deployment.zh-CN.md +22 -20
- package/docs/development.md +59 -56
- package/docs/development.zh-CN.md +59 -56
- package/docs/legacy-compatibility.md +97 -80
- package/docs/legacy-compatibility.zh-CN.md +90 -73
- package/docs/releasing.md +14 -8
- package/docs/releasing.zh-CN.md +14 -8
- package/docs/reverse-proxy.md +2 -2
- package/docs/reverse-proxy.zh-CN.md +2 -2
- package/docs/support-history.md +66 -60
- package/docs/support-history.zh-CN.md +66 -60
- package/examples/web-profile-auth-remote.patch.yml +1 -1
- package/package.json +16 -20
|
@@ -2,64 +2,65 @@
|
|
|
2
2
|
|
|
3
3
|
[English](legacy-compatibility.md)
|
|
4
4
|
|
|
5
|
-
最后复核:2026-10-
|
|
5
|
+
最后复核:2026-10-28。本文与英文清单共同维护同一组稳定 ID、版本事实、代码位置、测试与退役条件。修改任一语言时同步另一语言;矩阵是检索入口,条目是维护依据。本文记录 DSH 精确版本差异,不以发布顺序或版本简称代替适用范围。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
当前候选维护日期及承诺见 [README](../README.zh-CN.md#dsh-兼容性);未修改的[支持规范](support-policy.zh-CN.md)保留前一发布记录。历史 [DSH → 插件](support-history.zh-CN.md#by-dsh)与[插件 → DSH](support-history.zh-CN.md#by-plugin)区分声明、报告、候选与分发事实。
|
|
8
|
+
|
|
9
|
+
## 当前迁移候选
|
|
10
|
+
|
|
11
|
+
插件 `0.3.1` 尚未发布,声明 DSH `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`,技术准入为包含预发布的 `>=0.2.1-alpha.3`,默认 `0.2.1-rc.4`。三个 Alpha 自 2026-10-28 为 legacy,窗口 14 日,最早资格日为 2026-11-11(Asia/Shanghai),日期不自动结束支持。DSH `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 在插件 `0.3.1` 退役,最后支持插件为 `0.2.0`。当前承诺见 README;保持原样的 support-policy 描述此前发布。
|
|
12
|
+
|
|
13
|
+
下文保留精确历史证据,本轮逐项删除独占路径。HOST/PROTOCOL 旧路径、PUBLIC 选项/文本路径、THEME 旧 radius/thumb 补值、TEST 直接导航的适用集合与七版无交集;焦点颜色按七版原生规则迁移;ACCOUNT、HMR、通用引导重试与 PLUGIN-CONFIG 保留。新 RC 关键发布 lib 树与 `0.2.1-rc.2` 一致,2026-10-28 已核验精确包完整性与实际安装 API,最终运行结果另记。
|
|
8
14
|
|
|
9
15
|
## 范围与复核规则
|
|
10
16
|
|
|
11
|
-
|
|
17
|
+
候选 `0.3.1` 仅声明 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`,默认开发/测试 `0.2.1-rc.4`。准入为包含预发布的 `>=0.2.1-alpha.3`,仍须包身份/API 检查;账号适配还依赖必要能力和动态配置。未列版本不能继承实测声明。
|
|
12
18
|
|
|
13
19
|
- 修改 peers、`dsh.compatibility`、运行时准入、测试目标、CI 或用户兼容声明前,对照两张矩阵及所有相关条目。
|
|
14
20
|
- `dsh-runtime`:适用版本与支持集合仍有交集则保留相应适配;交集为空时,在同一次变更删除专属实现与测试,更新两种语言的矩阵、条目和指南。共享安全校验不随专属分支删除。
|
|
15
|
-
- `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.
|
|
21
|
+
- `plugin-contract`:按插件配置迁移政策退役,不能依据 DSH 版本退役。插件 `0.1.5` 的 `allowedOrigins` 输入仍由插件 `0.3.1` 兼容。
|
|
16
22
|
- 缺少精确版本证据时保留实现,明确登记缺口。不同版本通过相同测试,不证明其内部实现相同。
|
|
17
|
-
-
|
|
23
|
+
- 支持范围或共享宿主适配变更须对同一最终归档完整运行七版 CLI、browser、smoke,七版保留完整账号回归;普通固定选择见开发指南。full/发布独立验证退役边界 `0.2.1-alpha.2`,本次最终验收额外串行跑六版拒绝。
|
|
18
24
|
|
|
19
25
|
## 功能 → 版本对照表
|
|
20
26
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
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) | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 | 保留 |
|
|
27
|
+
各行列出适配或迁移及其精确适用宿主。稳定条目保留历史原生事实;退役仅删除独占实现,保留共享安全校验。
|
|
28
|
+
|
|
29
|
+
| 条目 | 精确适用 DSH 版本 | 当前候选处理 |
|
|
30
|
+
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
|
|
31
|
+
| [DSH-HOST-001](#dsh-host-001),旧 IPv4 schema/TLS 拒绝 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` | 与支持集合无交集;`0.3.1` 删除独占实现/测试;保留原生 Config 和具体绑定 |
|
|
32
|
+
| [DSH-PROTOCOL-001](#dsh-protocol-001),HTTP/回环 bridge | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` | 无交集;删除回退;保留真实协议、规范化 authority 和 Secure 分离 |
|
|
33
|
+
| [DSH-PUBLIC-001](#dsh-public-001),无 CLI 选项 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2` | 无交集;删除缺失选项及旧回环投影路径 |
|
|
34
|
+
| [DSH-PUBLIC-001](#dsh-public-001),文本投影 | `0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;删除文本位置选择;固定检查 context 和环境,仍观察 sections 中泄露/重复 |
|
|
35
|
+
| [DSH-THEME-001](#dsh-theme-001),radius 补值 | `0.1.7-rc.1` | 无支持交集;旧 radius 后备值已移除,保留主题/视觉检查 |
|
|
36
|
+
| [DSH-THEME-001](#dsh-theme-001),switch-thumb 补值 | `0.1.7-rc.1`、`0.1.7-rc.2` | 无交集;`0.3.1` 已删除补值,保留原生 token 与视觉/焦点回归 |
|
|
37
|
+
| [DSH-THEME-001](#dsh-theme-001), 焦点颜色迁移 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` | 七版精确原生规则及最低/默认 UI 支持迁移,保留可见键盘焦点 |
|
|
38
|
+
| [DSH-TEST-001](#dsh-test-001),直接 Settings 导航 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` | 无交集;`0.3.1` 已删除直接入口,固定账号菜单;通用异步重试保留 |
|
|
39
|
+
| [DSH-ACCOUNT-001](#dsh-account-001),手动回环回填 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` | 保留;全局准入后删除服务端旧版本分流;导出 helper 仍检查省略/无效/低版本输入 |
|
|
40
|
+
| [DSH-HMR-001](#dsh-hmr-001),监听器上下文隔离 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` | 保留受支持宿主适配;仅移除退役版矩阵目标 |
|
|
41
|
+
| [PLUGIN-CONFIG-001](#plugin-config-001) | 插件 `0.1.5` allowedOrigins 输入,与 DSH 版本无关 | 按独立契约保留 |
|
|
43
42
|
|
|
44
43
|
## 版本 → 功能对照表
|
|
45
44
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
| DSH
|
|
49
|
-
| --------------- |
|
|
50
|
-
| `0.1.7-rc.1` |
|
|
51
|
-
| `0.1.7-rc.2` |
|
|
52
|
-
| `0.2.0-rc.1` |
|
|
53
|
-
| `0.2.0-rc.2` |
|
|
54
|
-
| `0.2.1-alpha.1` |
|
|
55
|
-
| `0.2.1-alpha.2` |
|
|
56
|
-
| `0.2.1-alpha.3` |
|
|
57
|
-
| `0.2.1-alpha.4` |
|
|
58
|
-
| `0.2.1-alpha.5` |
|
|
59
|
-
| `0.2.1-rc.1` |
|
|
60
|
-
| `0.2.1-rc.2` |
|
|
61
|
-
|
|
62
|
-
`
|
|
45
|
+
历史行保留可查询性;退役行不属于当前正向目标。所有受支持行均使用原生具体 IPv4/IPv6、HTTP/HTTPS、上下文投影、原生 radius/thumb token 与焦点规则 和账号菜单 Settings。新 RC 精确发布代码/API 证据见下文,最终同包运行证据另记。
|
|
46
|
+
|
|
47
|
+
| 精确 DSH 版本 | 当前候选状态 | 历史适配 / 保留的共享检查 |
|
|
48
|
+
| --------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
|
|
49
|
+
| `0.1.7-rc.1` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-THEME-001、DSH-TEST-001、DSH-HMR-001;历史 startSignIn 首参为语言字符串 |
|
|
50
|
+
| `0.1.7-rc.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-THEME-001、DSH-TEST-001、DSH-HMR-001;startSignIn 首参为元数据对象 |
|
|
51
|
+
| `0.2.0-rc.1` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001 |
|
|
52
|
+
| `0.2.0-rc.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001 |
|
|
53
|
+
| `0.2.1-alpha.1` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-HOST-001、DSH-PROTOCOL-001、DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001;原生公开地址文本 |
|
|
54
|
+
| `0.2.1-alpha.2` | `0.3.1` 退役;最后插件 `0.2.0` | DSH-PUBLIC-001、DSH-TEST-001、DSH-HMR-001;原生传输和公开地址文本 |
|
|
55
|
+
| `0.2.1-alpha.3` | Legacy;最低支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验、context/env 和通用引导回归;原生 release 元数据缺失 |
|
|
56
|
+
| `0.2.1-alpha.4` | Legacy | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归 |
|
|
57
|
+
| `0.2.1-alpha.5` | Legacy | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归 |
|
|
58
|
+
| `0.2.1-rc.1` | 正常支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings 和真实宿主版本提示回归 |
|
|
59
|
+
| `0.2.1-rc.2` | 正常支持 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;保留原生校验/context/env/theme/Settings、宿主版本提示及 Search/Fetch 回归 |
|
|
60
|
+
| `0.2.1-rc.3` | 候选支持目标 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换 |
|
|
61
|
+
| `0.2.1-rc.4` | 候选支持目标;默认 | DSH-THEME-001, DSH-ACCOUNT-001、DSH-HMR-001;原生校验/context/env/theme/Settings;须精确验证新增 UI/Search/Fetch/宿主切换 |
|
|
62
|
+
|
|
63
|
+
PLUGIN-CONFIG-001 与共享认证检查均独立于运行时适配退役。未来版本准入不构成已验证声明。
|
|
63
64
|
|
|
64
65
|
## 新能力迁移与退役流程
|
|
65
66
|
|
|
@@ -71,58 +72,68 @@
|
|
|
71
72
|
|
|
72
73
|
## DSH-HOST-001
|
|
73
74
|
|
|
74
|
-
具体 IP 监听与 schema 适配,类型为 `dsh-runtime
|
|
75
|
+
具体 IP 监听与 schema 适配,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
|
|
75
76
|
|
|
76
77
|
| 字段 | 维护依据 |
|
|
77
78
|
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
78
79
|
| 适配适用版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` 的原生 schema 仅列 `127.0.0.1` 与 `0.0.0.0`;插件自行校验具体 IPv4,拒绝通配、IPv6 与 TLS |
|
|
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;不允许通配监听
|
|
80
|
+
| 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 使用原生 Config 与地址 API 校验具体 IPv4/IPv6;不允许通配监听 |
|
|
80
81
|
| 实现与上游 | `src/config.ts`、`src/adapters/dsh/runtime-capabilities.ts`、`src/adapters/dsh/webserver.ts`;精确 `@deepseek-ai/dsh-host-webserver/lib/index.js` 的 Config 与 listener。统一 `resolveStartupConfig` 已替代过渡 resolver |
|
|
81
82
|
| 测试与证据 | `tests/unit/config.test.ts`、`tests/integration/dsh-adapter.test.ts`、`tests/integration/native-transport.test.ts`、`tests/browser/native-transport.spec.ts`。2026-10-10 的 `0.2.1-alpha.2` 验证覆盖 IPv4、IPv6、mapped/scoped 回环及非回环 IPv4;非回环 IPv6 缺少可绑定接口,仅核对 schema 与策略 |
|
|
82
83
|
| 迁移与退役 | 仅当所有“适配适用版本”退出支持集合,或逐个取得原生能力证据并完成迁移后,删除该集合独占的 IPv4/schema 分支与拒绝测试。保留通配拒绝、端口验证、包身份及共同门禁 |
|
|
83
84
|
|
|
85
|
+
2026-10-28 退役证据:上列精确历史适用集合与受支持的 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 无交集。实际安装 Config/协议/地址 API 及新 RC 相同发布 lib 树已核验。插件 `0.3.1` 已删除独占能力布尔值、旧 schema/协议/authority、公开选项/文本位置选择及专属测试。引用文件中的端口/API/schema/身份/HTTP/TLS/IPv6/代理/Secure/来源/撤销共享检查保留。
|
|
86
|
+
|
|
84
87
|
## DSH-PROTOCOL-001
|
|
85
88
|
|
|
86
|
-
原生协议与 Connection 绑定地址差异,类型为 `dsh-runtime
|
|
89
|
+
原生协议与 Connection 绑定地址差异,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
|
|
87
90
|
|
|
88
91
|
| 字段 | 维护依据 |
|
|
89
92
|
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
90
93
|
| 回退适用版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1` 无原生 TLS/protocol API,且 Connection 不识别具体非回环 bind;服务端桥接保留 HTTP / `127.0.0.1`,实际 listener 与插件公开 URL 仍使用具体 IPv4 |
|
|
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 比较一致
|
|
94
|
+
| 原生能力版本 | `0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 使用实际 protocol 与归一化绑定 authority;IPv6 zone 不进入可移植公开 URL,mapped IPv6 必须与 Connection 的 WHATWG 比较一致 |
|
|
92
95
|
| 实现与上游 | `runtime-capabilities.ts` 的 `listenerProtocol`、`listenerTransport`,以及 `src/adapters/dsh/{readiness,browser-auth,startup-urls}.ts`、`src/http/gate.ts`、`src/index.ts`、[cordis.patch.yml](../cordis.patch.yml)。`connectionTrustedHosts` 合并最终 nativeAuthority、保留路径所需的公开 authority 与显式 CLI 信任,不扩大外层来源准入 |
|
|
93
96
|
| 测试与证据 | `tests/integration/native-transport.test.ts`、`tests/browser/native-transport.spec.ts`、`tests/browser/proxy-chain.spec.ts`。2026-10-10 的 `0.1.7-rc.1`、`0.2.1-alpha.1` 实际非回环包证明需要回环桥接;`0.2.1-alpha.2` 验证 HTTPS/IPv6 MFA、Host 设置、CLI 撤销与 mapped IPv6 HTTP/HTTPS |
|
|
94
97
|
| 迁移与退役 | 对每个“回退适用版本”取得原生 protocol/authority 支持证据后才迁移;该集合与支持范围无交集时删除专属回退。保留 HTTP 正向、双向代理、Cookie Secure、流撤销及共享认证检查 |
|
|
95
98
|
|
|
96
99
|
外层 Cookie 的 Secure 取决于公开来源;原生 Cookie 的 Secure 取决于监听协议。这是共享安全行为,不是可随版本删除的回退。
|
|
97
100
|
|
|
101
|
+
2026-10-28 退役证据:上列精确历史适用集合与受支持的 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 无交集。实际安装 Config/协议/地址 API 及新 RC 相同发布 lib 树已核验。插件 `0.3.1` 已删除独占能力布尔值、旧 schema/协议/authority、公开选项/文本位置选择及专属测试。引用文件中的端口/API/schema/身份/HTTP/TLS/IPv6/代理/Secure/来源/撤销共享检查保留。
|
|
102
|
+
|
|
98
103
|
## DSH-PUBLIC-001
|
|
99
104
|
|
|
100
|
-
公开地址投影和模型提示位置差异,类型为 `dsh-runtime
|
|
105
|
+
公开地址投影和模型提示位置差异,类型为 `dsh-runtime`,独占适配已在插件 `0.3.1` 清理;共享原生校验保留。
|
|
101
106
|
|
|
102
107
|
| 字段 | 维护依据 |
|
|
103
108
|
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
104
109
|
| 无原生参数的版本 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2` 无 `--public-url`;保留原生模型 Web 文本与 `DSH_WEB_URL`:固定 `127.0.0.1` 加实际端口、无末尾斜杠。插件自身唯一公开入口仍可配置,不能将其误写成原生 CLI 能力 |
|
|
105
110
|
| 原生文本投影版本 | `0.2.1-alpha.1`、`0.2.1-alpha.2` 原生消费 `webServer.publicUrl`,模型 system prompt Web 文本与 `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` 继续使用最终公开根地址
|
|
111
|
+
| 原生上下文投影版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 通过 `webApp.getAdvertisedUrl()` 与 harness-dev-context 的 `app:web-surface` 发布模型地址,位于 `assembly.contexts`;`DSH_WEB_URL` 继续使用最终公开根地址 |
|
|
107
112
|
| 实现与上游 | [cordis.patch.yml](../cordis.patch.yml)、`src/adapters/dsh/startup-urls.ts`;精确 WebApp `lib/startup.js`、`lib/index.js` 与 `harness-dev-context`。Connection 必须依赖 webStartup/webServer,不能等待已移除的 webRuntime |
|
|
108
113
|
| 测试与证据 | `tests/browser/deployment-profile.spec.ts`、`tests/browser/startup-compatibility.spec.ts`、`tests/fixtures/startup-observer.mjs`;调用真实 `systemPrompt.assemble` 与 `shellEnv.collect`,按精确版本断言文本段或上下文、环境变量与无 token。2026-10-09 的安装包证实无参数集合及 `0.2.1-alpha.1` 的分界;2026-10-15 核对 `0.2.1-alpha.3` 的上下文变化 |
|
|
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` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式
|
|
114
|
+
| 迁移与退役 | 无原生参数的集合退出支持后删除其能力分支和参数拒绝测试;`0.2.1-alpha.1`、`0.2.1-alpha.2` 仍受支持时保留文本位置断言;`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 保留上下文断言。不能仅因存在新投影位置而修改仍受支持版本的观察方式 |
|
|
115
|
+
|
|
116
|
+
2026-10-28 退役证据:上列精确历史适用集合与受支持的 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 无交集。实际安装 Config/协议/地址 API 及新 RC 相同发布 lib 树已核验。插件 `0.3.1` 已删除独占能力布尔值、旧 schema/协议/authority、公开选项/文本位置选择及专属测试。引用文件中的端口/API/schema/身份/HTTP/TLS/IPv6/代理/Secure/来源/撤销共享检查保留。
|
|
110
117
|
|
|
111
118
|
## DSH-THEME-001
|
|
112
119
|
|
|
113
|
-
缺失主题 token 的 CSS 补值,类型为 `dsh-runtime
|
|
120
|
+
缺失主题 token 的 CSS 补值,类型为 `dsh-runtime`,已在插件 `0.3.1` 退役;原生 token 和共享视觉检查保留。
|
|
114
121
|
|
|
115
122
|
| 字段 | 维护依据 |
|
|
116
123
|
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
117
|
-
| 补值适用版本 | `0.1.7-rc.1
|
|
118
|
-
| 原生能力版本 | `0.
|
|
119
|
-
| 实现与上游 | `src/client/settings/style.css
|
|
124
|
+
| 补值适用版本 | 历史 radius-md/lg 对应 `0.1.7-rc.1`,switch-thumb 对应 `0.1.7-rc.1`、`0.1.7-rc.2`;重复焦点颜色 fallback 按七版原生规则迁移 |
|
|
125
|
+
| 原生能力版本 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 均提供 radius/thumb 定义与相同原生 focus.css;focus-ring-color 是可选 override,不是正常键盘模式必有的 root token。历史 radius 从 `0.1.7-rc.2`、thumb 从 `0.2.0-rc.1` 已确认 |
|
|
126
|
+
| 实现与上游 | `src/client/settings/style.css`、`src/client/account/style.css` 直接读取原生 radius/thumb;焦点只设 solid outline、`--dsw-focus-ring-width` 和 offset,颜色委托宿主 :focus-visible;独立登录页不变 |
|
|
120
127
|
| 测试与证据 | `tests/browser/dsh-bootstrap.spec.ts`、`tests/browser/login.spec.ts`、`tests/browser/account-login.spec.ts` 与 `.cache/ui-review/<version>` 人工截图复核。2026-10-16 精确安装包主题定义证实`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 的 switch 滑块 token 分界。2026-10-09 核对 `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`;2026-10-10 核对 `0.2.1-alpha.2`;2026-10-15 核对 `0.2.1-alpha.3`。2026-10-19 核对精确 `0.2.1-alpha.5` 主题定义,确认提供相同圆角、焦点与 switch 滑块 token。 |
|
|
121
|
-
| 迁移与退役 |
|
|
128
|
+
| 迁移与退役 | 旧 radius/thumb 适用集合退出后移除专属 fallback;当前七版焦点颜色已按原生规则迁移,不直接读取未定义 override。保留动态主题、布局、可见焦点、开关外观和共享视觉测试 |
|
|
129
|
+
|
|
130
|
+
2026-10-28 清理:旧 radius、switch-thumb 和直接 Settings 的精确适用集合如上表,与七版支持无交集;删除专属实现。重复焦点颜色 fallback 依据七版原生规则迁移,不假定正常模式存在 focus-ring-color。通用引导、重开、持久化重试及共享视觉断言保留。
|
|
131
|
+
|
|
132
|
+
精确焦点证据修正(2026-10-28):七版原生 focus.css 在 :focus-visible 上解析 `var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary))`;focus-ring-color 是指针模式的可选覆盖值,不是默认根 token。不能用“源码出现声明”推定正常键盘状态有值。插件现仅用原生 `--dsw-focus-ring-width` 设置实线轮廓形状,颜色交给宿主全局规则,删除插件重复后备值且保留键盘可见焦点。四类清理不能解释为直接引用未定义的覆盖变量。
|
|
122
133
|
|
|
123
134
|
## DSH-TEST-001
|
|
124
135
|
|
|
125
|
-
设置导航与首次引导测试适配,类型为 `dsh-runtime
|
|
136
|
+
设置导航与首次引导测试适配,类型为 `dsh-runtime`,直接入口已在插件 `0.3.1` 退役;通用首次引导重试保留,notice/reload 的精确触发范围仍有证据缺口。
|
|
126
137
|
|
|
127
138
|
| 字段 | 维护依据 |
|
|
128
139
|
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
@@ -138,50 +149,54 @@
|
|
|
138
149
|
|
|
139
150
|
2026-10-16,`tests/browser/host-release.spec.ts` 在同一隔离 profile/端口保留 `0.2.1-alpha.4` 页面,将实际宿主切换到 `0.2.1-alpha.3` 后观察原生“服务版本变化”提示;`0.2.1-alpha.3` 不发布该 release 元数据,因此界面显示“未解析”。点击原生刷新后认证检查成功,原会话及 profile 开关保留;恢复 `0.2.1-alpha.4` 后再次核对通过。测试自行准备精确旧运行时,不修改上游源码、版本或图元数据。这一精确用例不补齐其他 notice/首次保存触发的缺口。
|
|
140
151
|
|
|
152
|
+
2026-10-28 清理:旧 radius、switch-thumb 和直接 Settings 的精确适用集合如上表,与七版支持无交集;删除专属实现。重复焦点颜色 fallback 依据七版原生规则迁移,不假定正常模式存在 focus-ring-color。通用引导、重开、持久化重试及共享视觉断言保留。
|
|
153
|
+
|
|
141
154
|
## DSH-ACCOUNT-001
|
|
142
155
|
|
|
143
156
|
官方账号手动回调对接,类型为 `dsh-runtime`,现存生效;这是可独立退役的临时适配。
|
|
144
157
|
|
|
145
158
|
| 字段 | 维护依据 |
|
|
146
159
|
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
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` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力”
|
|
160
|
+
| 原生能力与插件范围 | `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 均已有账号提供者和 API,但 ui-settings-account 的 `apply` 在没有 `dshDesktop` 时直接返回。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 对普通 Web 开放该 UI。本插件从 `0.2.1-alpha.3` 起按能力和配置准入,不将“不启用插件适配”表述为“没有原生账号能力” |
|
|
148
161
|
| 前向准入规则 | `>=0.2.1-alpha.3`,按 SemVer 包含预发布比较;必要 provider/slot API 可用且 `manualAccountLogin: true` 才接纳新授权。默认 true,使用 Loader 原位更新的 volatile 引用;profile override 不重建认证服务 |
|
|
149
|
-
|
|
|
162
|
+
| 历史关闭分支 | 旧六版服务端分支随全局下限移除,不再保留正向目标;导出 helper 仍拒绝缺省/无效/旧参数。必要 API 缺失仍不可用,动态 false 拒绝新授权并保留已接纳 attempt |
|
|
150
163
|
| 原因与上游 | 精确安装包的 account-platform `protocol.ts/loginOrigin` 在表列全部版本中仅接受带显式端口的回环 HTTP;ui-settings-account 默认使用浏览器 origin。公网浏览器无法自动回调 DSH 设备,外层门禁也拒绝跨站导航 |
|
|
151
164
|
| 实现 | `src/shared/account-login.ts`、`src/http/account-login.ts`、`src/adapters/dsh/account-callback.ts`、`src/adapters/dsh/browser-capability.ts`、`src/client/account/`;公开 slots 的 entries/subscribe/priority 替换登录动作,独立 `shell.overlay` 展示说明、输入框和按钮。原生 `useApiKey` 继续凭据引导且不调用 `complete`,账号菜单通过 `openOnboarding` 重开编辑器;未开始授权时保留该选择,授权中保留取消。服务端绑定发起会话,保留临时原生回调 handler,仅从已鉴权 POST 内部分发真实 Node 响应;不请求粘贴 URL,不读取提供者私有状态,不改原生 PKCE 或凭据存储;动态配置保留 Loader 引用,回调仅在手动 attempt 占用时拦截,否则经过既有外层 gate 委托原生 handler;关闭配置不取消已接纳授权或卸载 provider;紧凑弹窗初始显示两步,授权中隐藏已完成指引,保留 API Key 选择、失败导航说明及过期反馈;直接回调通过提供者公开状态确认归属,原生取消后再发起原生授权时,无需等待插件 state 轮询即可恢复回调;取消拒绝时保留占用,直到公开状态证明终态或不同 attempt,并允许清理重试。`src/index.ts` 按顺序尝试全部关闭资源后才报告清理错误,在请求和连接清理尝试完成前保留状态锁。配置重试由原生镜像 ensure 恢复首次读取,已有镜像的命名空间刷新使用客户端明确注入的 remote.settings;菜单登录在偏好未知时等待共享读取,再按最新接纳值选择手动或原生动作。 |
|
|
152
|
-
| 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.1-rc.
|
|
165
|
+
| 测试 | `tests/integration/account-login.test.ts` 使用锁定开发依赖的真实 `0.2.1-rc.4` 提供者与本地平台替身,覆盖 PKCE、redirect URI、state、会话、重复、取消、撤销、过期及重试;通过公开取消接口故障注入验证活动手动回调仍被拦截,关闭失败回归检查 listener/admin socket 关闭且同一 profile 可重新获锁;`tests/browser/account-login.spec.ts` 覆盖未设置 `DEEPSEEK_API_KEY` 的无凭据引导、原生 API Key 保存和账号菜单重开、先说明再授权、失败导航回填、弹窗拦截与响应式双语主题;`tests/unit/client-capability.test.ts` 验证 SemVer 下限和无上限准入,模拟未来版本不构成实测声明;`tests/browser/live-config.spec.ts` 与 `tests/fixtures/live-config-observer.mjs` 观察真实 Loader 引用/fiber、listener、锁、长连接和重启持久化,最终逐版结果记录于执行文档。另覆盖首次 describe 失败后的整份镜像恢复、命名空间暂缺后的注入传输重试,以及 true/false 两种配置初始延迟期间点击登录不提前发起原生授权。 |
|
|
153
166
|
| 公网迁移条件 | 官方接受公网 `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`
|
|
167
|
+
| 退役与保留 | `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 仍需回环,继续保留;只有适用集合退出支持或每个仍支持精确宿主的原生公网流程经验证可用才删除专属实现。共享 state/PKCE、会话归属、单次使用、撤销及禁止 URL 转发保留 |
|
|
155
168
|
| 证据限制 | 2026-10-15,本地平台替身与真实提供者完整兑换通过;官方 `auth_init` 的回环对照成功并取消,三种 `example.com` 公网写法被 schema 拒绝。未验证真实官方账号完整授权,也未排除官方按域名白名单开放的可能 |
|
|
156
169
|
|
|
170
|
+
2026-10-28:七个准入宿主都使用原生元数据对象调用。全局准入后服务端不再按旧版本停用 provider 或 bridge;能力检查和动态偏好语义保留。独立导出的 index 注入 helper 对省略、无效、低版本输入仍只提供 ownsHost,不授予手动标志。`tests/unit/client-capability.test.ts` 分别验证两个边界。
|
|
171
|
+
|
|
157
172
|
## DSH-HMR-001
|
|
158
173
|
|
|
159
174
|
原生热重载后的长期监听器事务上下文隔离。类型:`dsh-runtime`。保留。
|
|
160
175
|
|
|
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
|
-
| 迁移与退役 | 上游提供公开隔离入口时先逐版取得精确证据并迁移;仅当每个仍支持的适用版本原生隔离已修复,或适用集合与支持集合无交集时,才能移除专属实现和测试。同次更新双语双向矩阵。保留认证、来源、原生队列、真正嵌套拒绝及回归检查。
|
|
176
|
+
| 字段 | 维护依据 |
|
|
177
|
+
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
178
|
+
| 适用版本 | `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-alpha.1`, `0.2.1-alpha.2`, `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4` |
|
|
179
|
+
| 原生行为与静态证据 | 2026-10-16 逐版核对 `@deepseek-ai/dsh-hmr/lib/index.js`:`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 的 `runExclusive` 都以私有 `executing: AsyncLocalStorage` 的布尔标记拒绝嵌套事务;原生 `watchConfig` 自身用 `executing.exit` 创建长期 watcher。热重载事务内创建的 HTTP/HTTPS 监听器会让后续独立请求继承旧标记。 2026-10-19 复核精确 `0.2.1-alpha.5` 的 JavaScript 与类型,和 `0.2.1-alpha.4` 逐字相同,未新增公开监听器隔离 API。 |
|
|
180
|
+
| 实现边界 | `src/adapters/dsh/hmr-context.ts`、`src/index.ts`:仅在原生监听器初始化期间,确认 `runExclusive`、原生 AsyncLocalStorage 与当前 true 标记后调用 `exit`。明确依赖私有字段形状,公开 API 暂无对应入口。字段或标记不匹配时保持原生初始化行为;不改写 HMR 队列,不在设置保存/请求分派层退出事务,不削弱真实嵌套拒绝。 |
|
|
181
|
+
| 测试与证据 | `tests/browser/account-login.spec.ts`、`tests/fixtures/hmr-config-probe.mjs`。`0.2.1-alpha.3` 安装代码变更后经原生 profile watch 重载,已精确复现并修复用户的 settings/rejected “HMR transactions cannot be nested”。`0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 的真实配置 HMR/队列专项全部通过:监听器 generation 增加,独立保存等待已有事务、真实嵌套仍拒绝、原会话仍有效;`0.2.1-alpha.3`、`0.2.1-alpha.4` 安装代码替换后重新开启也通过。2026-10-16 本轮专项共 10/10;未来版本不能继承这些明确版本的静态或运行结论。 当前模块替换回归另覆盖 `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`;精确命令、数量与最终同包结果另记执行记录。 |
|
|
182
|
+
| 迁移与退役 | 上游提供公开隔离入口时先逐版取得精确证据并迁移;仅当每个仍支持的适用版本原生隔离已修复,或适用集合与支持集合无交集时,才能移除专属实现和测试。同次更新双语双向矩阵。保留认证、来源、原生队列、真正嵌套拒绝及回归检查。 |
|
|
168
183
|
|
|
169
184
|
## PLUGIN-CONFIG-001
|
|
170
185
|
|
|
171
|
-
插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.
|
|
186
|
+
插件 `0.1.5` 配置输入迁移,类型为 `plugin-contract`,在插件 `0.3.1` 保留;与 DSH 版本集合无关。
|
|
172
187
|
|
|
173
188
|
| 字段 | 维护依据 |
|
|
174
189
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
175
|
-
| 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.
|
|
190
|
+
| 适用配置 | 插件 `0.1.5` 顶层 `allowedOrigins` 的单项或空数组;插件 `0.1.6` 引入内存迁移,插件 `0.3.1` 仍保留 |
|
|
176
191
|
| 行为与实现 | `src/config.ts`、[cordis.patch.yml](../cordis.patch.yml)。省略字段与显式空数组可区分;单项转成唯一 `publicUrl`,空数组按监听结果派生;多项、重复项和新字段共存报错。每次激活仅一次弃用提示,不改写 profile;统一启动前解析、监听后定稿 |
|
|
177
192
|
| 测试 | `tests/unit/config.test.ts`、`tests/unit/origin-policy.test.ts`、`tests/integration/http-gate.test.ts`、`tests/browser/startup-compatibility.spec.ts`;真实 Loader 覆盖 0/1 项、多项、重复、null、file/CLI 冲突、警告次数与 profile 不改写 |
|
|
178
193
|
| 迁移与退役 | 只有插件产品契约明确结束这组输入支持并提供迁移说明时才删除专属检测、转换及测试。任一 DSH 版本退出支持都不足以触发退役;保留唯一 URL 校验与来源安全回归 |
|
|
179
194
|
|
|
180
195
|
## 共享安全边界
|
|
181
196
|
|
|
182
|
-
|
|
197
|
+
远程 profile 必须独立禁用原生 `webserver`。`tests/browser/startup-compatibility.spec.ts` 在七版验证 Loader skip/插件运行拒绝:最低 `0.2.1-alpha.3` 用 peer 故障,其余六版用 engines;`scripts/verify-retired.mjs` 在独立旧 profile 验证原样候选的安装回滚/完整包原生 peer skip,要求连续无 TCP/HTTP/readiness/WebSocket 监听并保留上游身份和审计。
|
|
183
198
|
|
|
184
|
-
|
|
199
|
+
`src/shared/dsh-support.ts` 在候选 `0.3.1` 明确记录三个 Alpha legacy、四个 RC 正常支持和六版退役(最后插件 `0.2.0`)。`retiredOn: 2026-10-28` 是准备日而非 npm 实际发布时间,不驱动停服;进程级/HMR 去重及必要 API、包身份、共享安全检查保留。当前日期见 README。
|
|
185
200
|
|
|
186
201
|
包身份、向前准入后的 API 检查、具体监听、原始 Host/Origin/Fetch Metadata、回环准入、密码/TOTP、会话、流撤销、存储故障与 CLI 确认适用于所有声明版本。反向代理 HTTPS → HTTP、Host 设置能力 `ownsHost` 和服务端原生浏览器认证交换也不能仅因某个适配退役而删除。
|
|
187
202
|
|
|
@@ -199,4 +214,6 @@
|
|
|
199
214
|
|
|
200
215
|
历史 2026-10-19 Alpha 接入证据:精确 tag `dsh-v0.2.1-alpha.5`(`1517a4dbca0a2789ff1d41ba439600f8547d23fa`)及精确发布包确认新增版本的上述能力。WebServer、Connection、Settings、Slots 与 HMR 的关键 JavaScript 和类型与 `0.2.1-alpha.4` 逐字相同。当时插件开发依赖锁定 Cordis `4.0.5-alpha.2`、Schemastery `3.18.5-alpha.2`;宿主运行时实际解析组合另记执行记录并逐版验证。`0.2.1-alpha.5` 的模型名称 Slot 不参与认证;账号通知新增标题、可选 JSON 元数据和多卡片堆栈,由保留的原生账号菜单处理,插件不复制通知实现。七个 dsh-runtime 条目均与九版支持集合有交集,全部保留;PLUGIN-CONFIG-001 仍按独立政策保留。`host-release.spec.ts` 保留 `0.2.1-alpha.4` → `0.2.1-alpha.3` → `0.2.1-alpha.4`,新增 `0.2.1-alpha.5` → `0.2.1-alpha.4` → `0.2.1-alpha.5` 的真实已知版本提示及刷新检查。原有 notice/reload 触发映射缺口继续保留;同一最终包九版 CLI、完整浏览器、smoke 与哈希结果另记执行记录,不继承旧候选包或专项结果。
|
|
201
216
|
|
|
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` 的历史支持集合。
|
|
217
|
+
历史 2026-10-19 RC 候选接入:核实 `dsh-v0.2.1-rc.1`(`1600d8a1e140dcde43a1a0941940a0480712c011`)、`dsh-v0.2.1-rc.2`(`687f282e8625c6b8d11ff58211a90524be2e4317`)及精确 npm 发布包的身份与完整性。九个已检查宿主模块的 `lib` JavaScript/类型/CSS 与 `0.2.1-alpha.5` 相同:WebServer、Connection、Settings、Slots、账号、账号平台、authorization、WebApp、HMR。开发依赖固定 Cordis `4.0.5`、Schemastery `3.18.5`,实际宿主组合沿安装依赖链另录。七个 dsh-runtime 条目逐一与十一版目标集合仍有交集,全部保留;PLUGIN-CONFIG-001 独立保留。本轮不执行任何实际退役;六版 legacy 日期见[支持规范](support-policy.zh-CN.md)。两个 RC 的真实完整回归、四组宿主切换及最终十一版同包证据记录在独立执行记录;静态相同不代表运行通过,插件 `0.2.0` 不改变 npm `0.1.10` 的历史支持集合。
|
|
218
|
+
|
|
219
|
+
2026-10-28 精确接入:`0.2.1-rc.3` tag `1f81c047fc48fa190a683e469daa699857e9afe8`、`0.2.1-rc.4` tag `504a01a9578abc2c6f1fb896b1dc322c9fe24f66` 及发布归档身份/integrity 已核验;九个关键 lib 树与 `0.2.1-rc.2` 相同。`0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4` 的 focus.css 逐字相同;新 RC 仍有账号 loopback 限制和 HMR 私有 executing/runExclusive 形状,无原生公网授权/公开隔离替代证据,继续保留 ACCOUNT/HMR。Search/Fetch、导航、切换专项通过,最终同包证据另记。
|
package/docs/releasing.md
CHANGED
|
@@ -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
|
-
The
|
|
7
|
+
The seven-target support migration belongs to unpublished candidate `0.3.1`. Validate the final archive before publication; existing npm versions remain immutable. The dated changelog and `retiredOn: 2026-10-28` are preparation records, not proof of registry publication.
|
|
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 the [
|
|
11
|
+
Before packing, update README, the [DSH → plugin](support-history.md#by-dsh) and [plugin → DSH](support-history.md#by-plugin) history, and inventory in both languages. For this `0.3.1` migration both support-policy files remain unchanged as the previous release record. Keep historical rows/anchors, distinguish published `0.2.0` from this unpublished candidate, and never cite a nonexistent candidate tag as verified evidence.
|
|
12
12
|
|
|
13
13
|
## Prepare the version
|
|
14
14
|
|
|
@@ -46,9 +46,15 @@ for (const version of testedDshVersions) {
|
|
|
46
46
|
JS
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
+
Every subsequent full/release also verifies the adjacent retired host against that same archive. This migration acceptance additionally runs all six negative targets listed in development, serially; they are separate from the positive business matrix.
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.1.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
|
|
53
|
+
```
|
|
54
|
+
|
|
49
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).
|
|
50
56
|
|
|
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
|
|
57
|
+
The workflow DAG is `tag` → `package` → reusable `verify-packed.yml` → `publish`. The producer uploads one `release-package` artifact. Independent CLI/smoke and complete-browser jobs cover all seven declared releases and check the producer's expected SHA-256, package identity and checksum file before consumption. A validation job rejects incomplete matrices; the full-plan aggregate requires every planned job, including the independent `0.2.1-alpha.2` retired-rejection job, to succeed. Failure, cancellation or an unexpected skip blocks publication.
|
|
52
58
|
|
|
53
59
|
`publish` downloads the same artifact and checks it against the producer's expected digest again. It never builds or packs. Existing npm-version byte comparison, trusted publishing and GitHub Release retry behavior remain in place. The workflow publishes the verified tgz with `npm publish ./artifacts/dsh-auth-remote-X.Y.Z.tgz --access public`; no local npm publication is needed.
|
|
54
60
|
|
|
@@ -59,18 +65,18 @@ Use the version that is already on `master`:
|
|
|
59
65
|
```sh
|
|
60
66
|
git switch master
|
|
61
67
|
git pull --ff-only origin master
|
|
62
|
-
git tag -a v0.
|
|
63
|
-
git push origin v0.
|
|
68
|
+
git tag -a v0.3.1 -m "Release v0.3.1"
|
|
69
|
+
git push origin v0.3.1
|
|
64
70
|
```
|
|
65
71
|
|
|
66
|
-
Replace `0.
|
|
72
|
+
Replace `0.3.1` in these commands with the intended version. The tag must point to a commit reachable from `master`. A mismatched tag, missing changelog entry, failed test, or mismatched existing npm archive stops the release.
|
|
67
73
|
|
|
68
74
|
After the workflow completes, confirm the run, GitHub Release, and npm version:
|
|
69
75
|
|
|
70
76
|
```sh
|
|
71
77
|
gh run list --workflow release.yml --limit 5
|
|
72
|
-
gh release view v0.
|
|
73
|
-
npm view dsh-auth-remote@0.
|
|
78
|
+
gh release view v0.3.1
|
|
79
|
+
npm view dsh-auth-remote@0.3.1 version dist.integrity
|
|
74
80
|
```
|
|
75
81
|
|
|
76
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.
|
package/docs/releasing.zh-CN.md
CHANGED
|
@@ -4,11 +4,11 @@
|
|
|
4
4
|
|
|
5
5
|
每次发布都从已通过检查的 `master` 提交开始。`vX.Y.Z` 标签必须与 `package.json` 中的稳定版本以及两份更新日志的日期条目一致。标签工作流先核对标签与 master 祖先关系,只构建一个 npm 压缩包,对全部声明的 DSH 版本验证该包,再核对或发布 npm 版本,并创建包含相同压缩包和 `SHA256SUMS` 的 GitHub Release。
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
七版支持迁移归入未发布候选 `0.3.1`。发布前须验证最终归档,既有 npm 版本不可重发。更新日志与 `retiredOn: 2026-10-28` 记录准备日期,不证明 registry 已发布。
|
|
8
8
|
|
|
9
9
|
发布准备中修改支持版本前,先复核 [Legacy 兼容维护清单](legacy-compatibility.zh-CN.md),共同检查 peers、兼容声明、运行时准入、测试目标、CI 和指南。同次删除与支持集合无交集的专属运行时适配,保留共享安全逻辑;旧插件配置退役有独立条件。打包前同步更新并人工核对中英文清单、两个维度的矩阵及完整版本号。
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
打包前同步维护双语 README、[DSH → 插件](support-history.zh-CN.md#by-dsh)和[插件 → DSH](support-history.zh-CN.md#by-plugin)历史及库存。本次 `0.3.1` 迁移保持两份 support-policy 原样,作为前一发布记录。保留历史行/锚点,区分已发布 `0.2.0` 和未发布候选,不引用不存在的候选 tag 作为已核实证据。
|
|
12
12
|
|
|
13
13
|
## 准备版本
|
|
14
14
|
|
|
@@ -46,9 +46,15 @@ for (const version of testedDshVersions) {
|
|
|
46
46
|
JS
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
+
后续每次 full/发布还须用同包验证相邻退役宿主;本次迁移最终验收另外串行运行开发指南列出的全部六版负向。它们不属于正向业务矩阵。
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.1.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
|
|
53
|
+
```
|
|
54
|
+
|
|
49
55
|
消费循环中不得构建或打包。归档内容变化须产生新候选并重新全量验证。JSON 报告记录摘要、精确版本、suite 范围、命令和真实用例数,见[固定归档指南](development.zh-CN.md#消费固定归档)。
|
|
50
56
|
|
|
51
|
-
工作流 DAG 为 `tag` → `package` → 共用 `verify-packed.yml` → `publish`。producer 上传一份 `release-package` 制品,独立 CLI/smoke 与完整 browser job
|
|
57
|
+
工作流 DAG 为 `tag` → `package` → 共用 `verify-packed.yml` → `publish`。producer 上传一份 `release-package` 制品,独立 CLI/smoke 与完整 browser job 覆盖全部七个声明版本,消费前核对 producer 给出的预期 SHA-256、包身份及摘要文件。验证 job 拒绝不完整矩阵,full 聚合要求全部计划 job(含独立 `0.2.1-alpha.2` 退役拒绝)成功;失败、取消或意外跳过均阻止发布。
|
|
52
58
|
|
|
53
59
|
`publish` 下载同一制品,再次与 producer 预期摘要核对,不构建或打包。保留 npm 同版本字节比较、可信发布及 GitHub Release 重试行为。工作流用 `npm publish ./artifacts/dsh-auth-remote-X.Y.Z.tgz --access public` 发布已验证 tgz,无需在本地手动发布。
|
|
54
60
|
|
|
@@ -59,18 +65,18 @@ JS
|
|
|
59
65
|
```sh
|
|
60
66
|
git switch master
|
|
61
67
|
git pull --ff-only origin master
|
|
62
|
-
git tag -a v0.
|
|
63
|
-
git push origin v0.
|
|
68
|
+
git tag -a v0.3.1 -m "Release v0.3.1"
|
|
69
|
+
git push origin v0.3.1
|
|
64
70
|
```
|
|
65
71
|
|
|
66
|
-
执行时把 `0.
|
|
72
|
+
执行时把 `0.3.1` 换成目标版本。标签必须指向 `master` 可达的提交。标签版本不匹配、缺少更新日志条目、测试失败,或 npm 现存版本与本次压缩包字节不同,都会阻止发布。
|
|
67
73
|
|
|
68
74
|
工作流结束后检查运行状态、GitHub Release 和 npm 版本:
|
|
69
75
|
|
|
70
76
|
```sh
|
|
71
77
|
gh run list --workflow release.yml --limit 5
|
|
72
|
-
gh release view v0.
|
|
73
|
-
npm view dsh-auth-remote@0.
|
|
78
|
+
gh release view v0.3.1
|
|
79
|
+
npm view dsh-auth-remote@0.3.1 version dist.integrity
|
|
74
80
|
```
|
|
75
81
|
|
|
76
82
|
GitHub Release 包含 `.tgz` 和 `SHA256SUMS`。把两者下载到同一个目录,在该目录运行 `sha256sum -c SHA256SUMS` 验证附件。工作流失败时先查看 **Actions → Release** 再重试;npm 版本不可覆盖,因此只有现存版本的压缩包字节与本次构建一致时,工作流才会跳过重复发布。
|
package/docs/reverse-proxy.md
CHANGED
|
@@ -6,7 +6,7 @@ DSH Auth Remote validates the browser authority before rewriting authenticated t
|
|
|
6
6
|
|
|
7
7
|
## Direct loopback
|
|
8
8
|
|
|
9
|
-
With the [profile example](../examples/web-profile-auth-remote.patch.yml), DSH binds `127.0.0.1:13090`. A browser on the same host may use `http://127.0.0.1:13090/`. Literal `localhost`, canonical `127.0.0.0/8` and bracketed `::1` are implicitly allowed when the actual listener is reachable. An IPv4-mapped IPv6 loopback origin is admitted when it is the effective `publicUrl`, either configured explicitly or derived from the listener. For a DSH
|
|
9
|
+
With the [profile example](../examples/web-profile-auth-remote.patch.yml), DSH binds `127.0.0.1:13090`. A browser on the same host may use `http://127.0.0.1:13090/`. Literal `localhost`, canonical `127.0.0.0/8` and bracketed `::1` are implicitly allowed when the actual listener is reachable. An IPv4-mapped IPv6 loopback origin is admitted when it is the effective `publicUrl`, either configured explicitly or derived from the listener. For a supported DSH IPv6 HTTP or HTTPS listener, follow the [native transport configuration](deployment.md#native-https-and-ipv6). The auth bundle disables the native `webserver` row; an independent profile disable is required for protected remote access.
|
|
10
10
|
|
|
11
11
|
Admission is the unique effective public origin plus literal loopback. Without a public URL, derive one root from the actual bound protocol, address and port. Root paths only are supported; no child path, query, fragment or credentials. Mutations and WebSocket upgrades need Origin matching their Host; extra CLI native trusted hosts do not widen this policy. A GET without Origin cannot set or clear auth cookies when its protocol is unknown. See the [old-field migration rules](deployment.md#migrate-old-allowedorigins) before changing a legacy array.
|
|
12
12
|
|
|
@@ -24,6 +24,6 @@ Set `publicUrl: https://dsh.example.com/` for the example. For a public `:8443`
|
|
|
24
24
|
|
|
25
25
|
Use one canonical public entry; route alternate hostnames to it before requests reach the protected upstream. Replace `publicUrl` and restart after an entry change, then verify the new root and rejection of the former non-loopback origin. Check anonymous redirect/API denial, password plus TOTP login, cookies, Settings, WebSocket, SSE, uploads, previews and revocation. Keep access private until `/auth-remote/ready` reports the expected plugin/protocol and `ready: true`.
|
|
26
26
|
|
|
27
|
-
A DSH
|
|
27
|
+
A supported DSH native HTTPS upstream also works behind a public HTTP or HTTPS proxy. Use an HTTPS upstream URL and configure the proxy's upstream certificate verification and hostname/SNI for that certificate. Plugin cookies follow the external entry's protocol; server-side native cookies use the listener's HTTPS audience/Secure. Preserve Host/Origin even when the two transport protocols differ. Relative file/CLI certificate paths have different bases; see the [path rules](deployment.md#configuration-priority-and-path-bases).
|
|
28
28
|
|
|
29
29
|
The authentication gate ignores `Forwarded` and `X-Forwarded-*` for trust decisions. This avoids treating a client-supplied hint as proof of TLS or hostname. The source checkout's browser suite tests these rules with its own Node HTTP/HTTPS forwarder; it does not execute Nginx or Traefik binaries.
|