dsh-auth-remote 0.3.2 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,19 +2,17 @@
2
2
 
3
3
  [English](deployment.md)
4
4
 
5
- 本指南面向未发布插件候选 `0.3.2` 与推荐 DSH `0.2.2-alpha.2`,使用默认 `~/.dsh` 数据目录。八版支持/日期见 [README](../README.zh-CN.md#dsh-兼容性),旧组合与分发事实见[历史](support-history.zh-CN.md#by-dsh)。源码构建见[开发指南](development.zh-CN.md)。
6
-
7
- 下列原生能力适用于 `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.2-alpha.2`。
5
+ 本指南面向插件 `0.3.3` 与推荐 DSH `0.2.2-alpha.2`,使用默认 `~/.dsh` 数据目录。九个支持版本见 [README](../README.zh-CN.md#dsh-兼容性),维护细节见[支持规范](support-policy.zh-CN.md)。源码构建见[开发指南](development.zh-CN.md)。
8
6
 
9
7
  上游 DSH `0.2.2-alpha.2` 自身要求 Node `>=24.9.0`;插件仍声明 Node `>=24`,不增加小版本拦截。
10
8
 
11
- ## 最小化安装候选归档
9
+ ## 最小化安装
12
10
 
13
- `0.3.2` 尚未发布。按[开发指南](development.zh-CN.md)构建并验证本地归档后,安装该文件。已发布 `0.3.1` 保留七版历史,不包含本次新版宿主适配;分发事实见[精确历史记录](support-history.zh-CN.md#plugin-0.3.1)。保持同一默认 `web` profile:
11
+ 安装和运行服务使用同一默认 `web` profile:
14
12
 
15
13
  ```sh
16
14
  dsh --version
17
- dsh plugin --profile web add ./artifacts/dsh-auth-remote-0.3.2.tgz
15
+ dsh plugin --profile web add dsh-auth-remote@0.3.3
18
16
  dsh plugin --profile web list
19
17
  dsh web --no-open --port 13090
20
18
  ```
@@ -55,20 +53,20 @@ HTTPS 代理入口可把以下条目合并到 `~/.dsh/profiles/web/cordis.patch.
55
53
 
56
54
  以下字段均直接位于 `auth-remote.config`,没有别名或嵌套 TLS 对象。
57
55
 
58
- | 字段 | 生效值 |
59
- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
60
- | `publicUrl` | CLI `--public-url` 整项覆盖文件,其次旧单项迁移、实际监听根。只接纳 HTTP(S) 根 URL,可带末尾斜杠,无凭据/子路径/查询/片段。 |
61
- | `host` | CLI、文件、默认 `127.0.0.1`。具体 IPv4/IPv6(含 mapped),拒绝 DNS 与通配绑定。 |
62
- | `port` | CLI `--port`、文件、默认 `3080`,与 host 分别覆盖。`0` 在真实非零端口绑定后才生成入口。 |
63
- | `tlsCert`、`tlsKey` | 文件字段或 CLI `--tls-cert`/`--tls-key` 必须成对,CLI 整组覆盖,不混来源,不读未采用文件。省略即 HTTP。 |
64
- | `requireTotp` | 默认 `false`,未绑定账号可跳过,已绑定账号仍需第二因素;设为 `true` 可强制先完成绑定再访问。升级保留显式 true/false、已有绑定及备用码。 |
65
- | `manualAccountLogin` | 默认 true,原生 Settings 写当前 profile override;保存立即影响新授权且重启保留,不重启认证。false 保留已接纳授权和官方凭据。八版完整回归,未来准入及必要 API 见 README。 |
66
- | `sessionHours` | 默认固定 168 小时。缩短会收紧已有会话,放宽不会复活过期会话。 |
67
- | `preserveOriginPaths` | 可选的规范路径段前缀,默认 `[]`。匹配路径在认证后保留已验证公网 Host 和已有 Origin;最终公开来源自动配置原生 Connection 信任。 |
56
+ | 字段 | 生效值 |
57
+ | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
58
+ | `publicUrl` | CLI `--public-url` 整项覆盖文件,其次旧单项迁移、实际监听根。只接纳 HTTP(S) 根 URL,可带末尾斜杠,无凭据/子路径/查询/片段。 |
59
+ | `host` | CLI、文件、默认 `127.0.0.1`。具体 IPv4/IPv6(含 mapped),拒绝 DNS 与通配绑定。 |
60
+ | `port` | CLI `--port`、文件、默认 `3080`,与 host 分别覆盖。`0` 在真实非零端口绑定后才生成入口。 |
61
+ | `tlsCert`、`tlsKey` | 文件字段或 CLI `--tls-cert`/`--tls-key` 必须成对,CLI 整组覆盖,不混来源,不读未采用文件。省略即 HTTP。 |
62
+ | `requireTotp` | 默认 `false`,未绑定账号可跳过,已绑定账号仍需第二因素;设为 `true` 可强制先完成绑定再访问。升级保留显式 true/false、已有绑定及备用码。 |
63
+ | `manualAccountLogin` | 默认 true,原生 Settings 写当前 profile override;保存立即影响新授权且重启保留,不重启认证。false 保留已接纳授权和官方凭据。 |
64
+ | `sessionHours` | 默认固定 168 小时。缩短会收紧已有会话,放宽不会复活过期会话。 |
65
+ | `preserveOriginPaths` | 可选的规范路径段前缀,默认 `[]`。匹配路径在认证后保留已验证公网 Host 和已有 Origin;最终公开来源自动配置原生 Connection 信任。 |
68
66
 
69
67
  **特别注意 TLS 路径:**文件中的相对值以所选 profile 目录为基准,即其 `cordis.patch.yml` 所在目录;CLI 的相对路径以进程启动 cwd 为基准。两者均不以 bundle 或其他 overlay 目录为基准。绝对路径保持绝对。
70
68
 
71
- 全部支持版本中,`dsh web --no-open --host ::1 --port 0 --public-url https://dsh.example.com/` 分别覆盖文件 host、port、URL。监听使用实际空闲端口,公开根地址保持显式值,代理须到达该实际端口;仅覆盖 port 时可省略 host。
69
+ `dsh web --no-open --host ::1 --port 0 --public-url https://dsh.example.com/` 分别覆盖文件 host、port、URL。监听使用实际空闲端口,公开根地址保持显式值,代理须到达该实际端口;仅覆盖 port 时可省略 host。
72
70
 
73
71
  例如文件 `tlsCert: ./tls/dsh.crt` 始终指 `~/.dsh/profiles/web/tls/dsh.crt`,从其他目录启动也不变。以下命令则使用 `./launch-workdir/tls/dsh.crt` 和对应私钥:
74
72
 
@@ -79,13 +77,11 @@ dsh web --no-open --tls-cert ./tls/dsh.crt --tls-key ./tls/dsh.key
79
77
 
80
78
  只给一个 CLI 参数会失败,即使文件提供另一半也不混用。证书/私钥缺失、不可读、空内容、PEM 无效或不匹配时启动失败,不回退 HTTP,并释放监听、管理 socket 和存储资源。证书须对浏览器主机名有效;TLS 由官方监听处理。
81
79
 
82
- 全部支持版本原生提供 `--public-url`、IPv6 和 TLS;本候选沿用已发布 `0.3.1` 完成的原生 API 迁移。
83
-
84
- 八版均把最终 Web URL 写入模型 runtime context 与 `DSH_WEB_URL`;测试仍扫描所有 Web 提示段,要求无重复地址或 token。
80
+ 最终公开 Web URL 写入模型 runtime context 与 `DSH_WEB_URL`,不含原生认证 token。
85
81
 
86
82
  ## 原生 HTTPS 与 IPv6
87
83
 
88
- 全部八个支持版本都可合并以下完整认证条目提供 IPv6 回环 HTTPS,使用自己的证书/私钥:
84
+ 合并以下完整认证条目,使用自己的证书/私钥提供 IPv6 回环 HTTPS:
89
85
 
90
86
  ```yaml
91
87
  - id: auth-remote
@@ -116,7 +112,7 @@ dsh web --no-open --tls-cert ./tls/dsh.crt --tls-key ./tls/dsh.key
116
112
  | 两项及以上,包含重复值 | 失败;人工选择唯一公开入口,用 `publicUrl` 替换数组。 |
117
113
  | 任意显式 `allowedOrigins` 与文件或 CLI `publicUrl` 共存,含空数组或相同 URL | 失败;使用新字段前删除旧字段。 |
118
114
 
119
- 升级前备份旧 patch。单项替换为 `publicUrl: https://dsh.example.com/`;空数组删除即可保留派生行为。旧多来源安装必须主动选择一个规范入口,在流量到达受保护上游前把其他浏览器主机名导向该入口。回退 0.1.5 时恢复其兼容的旧配置备份;新字段不属于 0.1.5 契约。
115
+ 升级前备份旧 patch。单项替换为 `publicUrl: https://dsh.example.com/`;空数组删除即可保留派生行为。旧多来源安装必须主动选择一个规范入口,在流量到达受保护上游前把其他浏览器主机名导向该入口。回退时须恢复与所选插件版本兼容的配置。
120
116
 
121
117
  ## 来源与桥接契约
122
118
 
@@ -126,11 +122,11 @@ dsh web --no-open --tls-cert ./tls/dsh.crt --tls-key ./tls/dsh.key
126
122
 
127
123
  插件 Cookie 跟随已验证外部来源,限主机、HttpOnly、SameSite,HTTPS 设置 Secure。原生桥接凭据仅保留服务端,跟随原生监听协议;公开 HTTP 代理接入原生 HTTPS 时,其原生 Cookie audience/Secure 仍按 HTTPS。浏览器 Cookie 不通过端口隔离。
128
124
 
129
- 标准 `/api` 路由在 `preserveOriginPaths: []` 下即可工作,无需列 `/api`。插件始终将定稿的原生桥接 authority 登记到 Connection 的 `trustedHosts`,使用实际绑定端口(包含 `--port 0`),读取该列表的下游插件无需额外 trusted-host 参数即可识别桥接地址。显式 CLI trusted hosts 合并去重,不扩大外层公开来源策略。仅在下游需要原始公网 Host 时加入前缀;Origin 仅在请求已有时透传,保留路径预检并登记所选公开 authority。无需单独 Connection 条目。八版普通路径统一使用归一化原生 bind authority,经过完整会话认证。撤销、Connection 丢失或存储故障会关闭活跃上传、流和升级连接,撤回业务准入。ready 不表示账号已初始化。
125
+ 标准 `/api` 路由在 `preserveOriginPaths: []` 下即可工作,无需列 `/api`。插件始终将定稿的原生桥接 authority 登记到 Connection 的 `trustedHosts`,使用实际绑定端口(包含 `--port 0`),读取该列表的下游插件无需额外 trusted-host 参数即可识别桥接地址。显式 CLI trusted hosts 合并去重,不扩大外层公开来源策略。仅在下游需要原始公网 Host 时加入前缀;Origin 仅在请求已有时透传,保留路径预检并登记所选公开 authority。无需单独 Connection 条目。普通路径使用归一化原生 bind authority,经过完整会话认证。撤销、Connection 丢失或存储故障会关闭活跃上传、流和升级连接,撤回业务准入。ready 不表示账号已初始化。
130
126
 
131
127
  ## 启动并验证公开入口
132
128
 
133
- 1. 核对 Linux、Node.js 24+、精确兼容 DSH 版本及目标 profile/包;测试开发数据独立。
129
+ 1. 核对 Linux、Node.js 24+(推荐 DSH `0.2.2-alpha.2` 至少需要 `24.9.0`)、精确兼容 DSH 版本及目标 profile/包;测试开发数据独立。
134
130
  2. 合并一个完整 profile 配置,需要代理时建立私有可达上游,参见[代理指南](reverse-proxy.zh-CN.md)。
135
131
  3. 启动 DSH。HTTP 上游示例检查 `curl -fsS -H 'Host: dsh.example.com' http://127.0.0.1:13090/auth-remote/ready`,要求预期插件/协议和 `ready: true`。
136
132
  4. 核对匿名 HTML 跳转和 API 拒绝,再本地初始化、登录、绑定 TOTP、保存备用码。经所选入口测试官方设置、工作区、预览、上传、SSE/WebSocket 和撤销。
@@ -139,9 +135,9 @@ dsh web --no-open --tls-cert ./tls/dsh.crt --tls-key ./tls/dsh.key
139
135
 
140
136
  ## 备份、恢复与变更
141
137
 
142
- 升级旧部署到 `0.3.2` 前,停止 DSH 并备份认证目录、profile patch、package/lock;保持入口私有和独立 `webserver disabled: true`。先把宿主升级至所列八版(推荐 `0.2.2-alpha.2`),再安装新插件并核对 ready、匿名拒绝、登录及撤销。六个已退役宿主不能安装 `0.3.2`,不要授予版本风险豁免。回退时停服,选择明确旧宿主(例如 `0.2.1-alpha.2`)与最后支持插件 `0.2.0`,恢复匹配的包/锁/patch 备份。六个宿主的退役发生于已发布 `0.3.1`,本次不重复退役。此次迁移不改变认证数据格式;恢复时仍核对 schema,禁止覆盖运行中的状态。
138
+ 升级到 `0.3.3` 前,停止 DSH 并备份认证目录、profile patch、package/lock;保持入口私有和独立 `webserver disabled: true`。确认宿主属于所列支持版本(推荐 `0.2.2-alpha.2`),安装插件并核对 ready、匿名拒绝、登录及撤销。回退时停服并恢复匹配的宿主/插件包、锁和 patch 备份。此次发布不改变认证数据格式;恢复时仍核对 schema,禁止覆盖运行中的状态。
143
139
 
144
- 这些是插件 `0.3.2` 自身的行为迁移,与 DSH 退役无关:CLI 固定英语,删除脚本中的 `--lang` 参数;JSON 字段不变。独立登录页不再提供语言选择器,按新 `dsh-auth-remote-lang` 缓存、`navigator.language`、英文选择语言。旧 `dsh-auth-remote.locale` 不读取、不清理、不迁移;进入 DSH 后仅同步原生已接纳的偏好,退出保留。插件八语不会扩充旧 DSH 的原生语言目录。
140
+ 从早于 `0.3.2` 的插件升级时,须考虑 `0.3.2` 已引入、`0.3.3` 保留的行为:CLI 固定英语,删除脚本中的 `--lang` 参数;JSON 字段不变。独立登录页不提供语言选择器,按 `dsh-auth-remote-lang` 缓存、`navigator.language`、英文选择语言。旧 `dsh-auth-remote.locale` 不读取、不清理、不迁移;进入 DSH 后仅同步原生已接纳的偏好,退出保留。插件八语不会扩充 DSH 的原生语言目录。
145
141
 
146
142
  停止 DSH 并确认释放 profile 锁,再复制 `~/.dsh/profiles/web/auth-remote/auth-state.json`。副本目录权限 0700、文件权限 0600;它含密码哈希、TOTP 密钥、备用码哈希和会话。不要复制写入中的临时文件、覆盖运行中持锁状态或提交 Git;同时备份对应 profile patch 和包/锁文件。
147
143
 
@@ -149,6 +145,4 @@ dsh web --no-open --tls-cert ./tls/dsh.crt --tls-key ./tls/dsh.key
149
145
 
150
146
  外部入口变更时,替换唯一 `publicUrl`、更新代理并重启 DSH。检查新入口与旧非回环入口的拒绝,包含 Cookie、重定向、上传和长连接。不要在插件中临时配置两个来源。
151
147
 
152
- 全部八个支持版本的官方 DeepSeek 账号授权使用 [README 的手动回填弹窗](../README.zh-CN.md#登录-deepseek-官方账号)。浏览器电脑无需监听器或开放回环端口。`/auth-remote/account/*` 保持相同会话/来源门禁,只接纳同源 JSON POST;直接 HTTP 访问原生 `/oauth/callback` 不能完成此手动对接。无需代理例外、扩大路径或放宽跨站规则。
153
-
154
- 在 DSH `0.2.2-alpha.2` 使用 LiveShare 前,按原生方式启用该功能、配置 Relay 并完成 Owner 登录。本插件不自动启用分享或改写 Relay 配置;查看者不获得管理员身份,插件退出与停止分享是独立操作。本地协议替身只建立基础兼容证据,真实 Relay/OAuth、访客模型及文件写入体验另行验证。无需扩大匿名例外或 preserveOriginPaths。
148
+ 官方 DeepSeek 账号授权使用 [README 的手动回填弹窗](../README.zh-CN.md#登录-deepseek-官方账号)。浏览器电脑无需监听器或开放回环端口。`/auth-remote/account/*` 保持相同会话/来源门禁,只接纳同源 JSON POST;直接 HTTP 访问原生 `/oauth/callback` 不能完成此手动对接。无需代理例外、扩大路径或放宽跨站规则。
@@ -2,7 +2,7 @@
2
2
 
3
3
  [简体中文](development.zh-CN.md)
4
4
 
5
- This guide describes eight exact verification targets for unpublished plugin candidate `0.3.2`, defaulting to DSH `0.2.2-alpha.2`. Final same-archive evidence belongs to separate, unpackaged execution records; declarations and reports are distinct.
5
+ This guide describes nine exact verification targets for planned plugin release `0.3.3`, defaulting to DSH `0.2.2-alpha.2`. Final same-archive evidence belongs to unpackaged test reports; declarations and reports are distinct.
6
6
 
7
7
  Development and the full test suite use Linux (`/proc` is required for the profile lock), Node.js 24+, pnpm 12.5.1, and DSH `0.2.2-alpha.2`. DSH `0.2.2-alpha.2` itself requires Node.js `>=24.9.0`; the plugin engine stays `>=24`. Browser tests use Playwright-managed Chromium and a Node HTTP/HTTPS forwarder.
8
8
 
@@ -16,7 +16,7 @@ pnpm pack:local
16
16
  pnpm smoke
17
17
  ```
18
18
 
19
- `pnpm check` runs type checking, formatting, build, package/deployment/document checks, then unit, integration, CLI, and browser tests. `pnpm pack:local` writes `artifacts/dsh-auth-remote-0.3.2.tgz` after static checks; it does not publish. `pnpm smoke` installs that archive into an isolated DSH home, starts the pinned DSH runtime briefly, checks readiness, anonymous redirection/denial and an online CLI status, then stops it.
19
+ `pnpm check` runs type checking, formatting, build, package/deployment/document checks, then unit, integration, CLI, and browser tests. `pnpm pack:local` writes `artifacts/dsh-auth-remote-0.3.3.tgz` after static checks; it does not publish. `pnpm smoke` installs that archive into an isolated DSH home, starts the pinned DSH runtime briefly, checks readiness, anonymous redirection/denial and an online CLI status, then stops it.
20
20
 
21
21
  ## Use the isolated development profile
22
22
 
@@ -50,11 +50,11 @@ Before changing compatibility declarations or adaptations, read the [legacy comp
50
50
 
51
51
  Isolated verification installs use pnpm file copies so shared package hardlink metadata changes cannot trigger client hot reloads in another profile.
52
52
 
53
- Current candidate support is in [README](../README.md#dsh-compatibility), release facts in the [bidirectional history](support-history.md), and adaptation evidence in the inventory. Both support policies retain the previous release record and remain unchanged for this `0.3.2` work; never derive old release claims from the current candidate manifest.
53
+ Current support is in [README](../README.md#dsh-compatibility) and the [support policy](support-policy.md), release facts in the [bidirectional history](support-history.md), and adaptation evidence in the inventory. Never derive old release claims from the current manifest.
54
54
 
55
55
  ## Cross-version verification
56
56
 
57
- The default target is DSH `0.2.2-alpha.2`; `DSH_TEST_VERSION` accepts only `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.2-alpha.2`. Test runtimes live under `.cache/test-runtime/<version>` and development runtimes under `.dev/runtime-<version>`. `DSH_TEST_BIN` must report that exact version. CI keeps eight-version CLI/installation smoke; full runs eight complete browser targets and ordinary uses the selection below. Development types and integration use locked `0.2.2-alpha.2` packages. All eight targets check the real Loader, model runtime context/`DSH_WEB_URL`, and positive IPv4/IPv6 HTTP/HTTPS security boundaries. Missing native transport support fails instead of skipping.
57
+ The default target is DSH `0.2.2-alpha.2`; `DSH_TEST_VERSION` accepts only `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5`, `0.2.2-alpha.2`. Test runtimes live under `.cache/test-runtime/<version>` and development runtimes under `.dev/runtime-<version>`. `DSH_TEST_BIN` must report that exact version. CI keeps nine-version CLI/installation smoke; full runs nine complete browser targets and ordinary uses the selection below. Development types and integration use locked `0.2.2-alpha.2` packages. All nine targets check the real Loader, model runtime context/`DSH_WEB_URL`, and positive IPv4/IPv6 HTTP/HTTPS security boundaries. Missing native transport support fails instead of skipping.
58
58
 
59
59
  ```sh
60
60
  DSH_TEST_VERSION=0.2.1-alpha.3 pnpm test:cli
@@ -69,8 +69,10 @@ DSH_TEST_VERSION=0.2.1-rc.2 pnpm test:cli
69
69
  DSH_TEST_VERSION=0.2.1-rc.2 pnpm test:browser
70
70
  DSH_TEST_VERSION=0.2.1-rc.3 pnpm test:cli
71
71
  DSH_TEST_VERSION=0.2.1-rc.3 pnpm test:browser
72
- DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:cli
73
- DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:browser
72
+ DSH_TEST_VERSION=0.2.1-rc.4 pnpm test:cli
73
+ DSH_TEST_VERSION=0.2.1-rc.4 pnpm test:browser
74
+ DSH_TEST_VERSION=0.2.1-rc.5 pnpm test:cli
75
+ DSH_TEST_VERSION=0.2.1-rc.5 pnpm test:browser
74
76
  DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:cli
75
77
  DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:browser
76
78
  ```
@@ -81,40 +83,40 @@ Official-account tests use a local Platform stand-in with the actual DSH `0.2.2-
81
83
 
82
84
  Core account tests load the exact provider from locked development dependencies, so they do not require a pre-existing CLI runtime cache. Browser tests still exercise the provider installed into each isolated DSH profile.
83
85
 
84
- The temporary account adapter retains capability and live-configuration checks; complete manual-feature regression targets `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.2-alpha.2`. After global minimum admission the server no longer branches for older hosts; the separately exported helper still checks omitted, invalid and older inputs. Forward admission is not verification. Support or shared host-adapter changes require the same final tgz across all eight CLI, complete browser and smoke runs with `--suite cli --suite browser --suite smoke` per release. Never call rebuilding/repacking wrappers in the consumer loop. The runner restores archive dist, checks SHA-256 per suite and isolates smoke from development profiles. See `DSH-ACCOUNT-001` for public-callback evidence and migration/retirement conditions.
86
+ The temporary account adapter retains capability and live-configuration checks; complete manual-feature regression targets `0.2.1-alpha.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5`, `0.2.2-alpha.2`. After global minimum admission the server no longer branches for older hosts; the separately exported helper still checks omitted, invalid and older inputs. Forward admission is not verification. Support or shared host-adapter changes require the same final tgz across all nine CLI, complete browser and smoke runs with `--suite cli --suite browser --suite smoke` per release. Never call rebuilding/repacking wrappers in the consumer loop. The runner restores archive dist, checks SHA-256 per suite and isolates smoke from development profiles. See `DSH-ACCOUNT-001` for public-callback evidence and migration/retirement conditions.
85
87
 
86
88
  `live-config.spec.ts` observes the real Loader reference/fiber, auth/store identity, lock, listener and SSE/WebSocket continuity, checks the loaded dependency chain and restarts to verify the profile override. It does not fabricate services. Dialog regression covers cancellation/errors, focus/keyboard, optional/enforced TOTP, one-time code copying and redirect holds after revocation. Task documents, test credentials, profiles, screenshots and generated directories must remain outside the npm archive.
87
89
 
88
- `account-login.spec.ts` exercises real configuration HMR on all eight: an ordinary `sessionHours` change rebuilds the listener, independent Settings writes wait for the native transaction queue, and genuine nesting remains rejected. Isolated plugin code replacement must allow manual sign-in to be enabled again. The transaction probe calls real HMR, replaces no service and is never packaged; see `DSH-HMR-001`. Protected remote profiles independently disable native webserver. On all eight, `startup-compatibility.spec.ts` damages only isolated plugin copies: `0.2.1-alpha.3` uses an incompatible Host peer for Loader skip, the other seven an incompatible `engines.dsh`; every version also gets an injected plugin admission range for post-import runtime rejection. Both paths must fail naturally without TCP/HTTP/readiness/WebSocket fallback; upstream and Loader auditing are unchanged.
90
+ `account-login.spec.ts` exercises real configuration HMR on all nine: an ordinary `sessionHours` change rebuilds the listener, independent Settings writes wait for the native transaction queue, and genuine nesting remains rejected. Isolated plugin code replacement must allow manual sign-in to be enabled again. The transaction probe calls real HMR, replaces no service and is never packaged; see `DSH-HMR-001`. Protected remote profiles independently disable native webserver. On all nine, `startup-compatibility.spec.ts` damages only isolated plugin copies: `0.2.1-alpha.3` uses an incompatible Host peer for Loader skip, the other eight an incompatible `engines.dsh`; every version also gets an injected plugin admission range for post-import runtime rejection. Both paths must fail naturally without TCP/HTTP/readiness/WebSocket fallback; upstream and Loader auditing are unchanged.
89
91
 
90
92
  The account preference binding recovers an initial failed read through the native describe mirror’s `ensure()` API. Recovery of an already held namespace uses the explicitly injected `remote.settings` transport and folds the accepted namespace back into that mirror. A sign-in click while the preference is loading waits for the shared read, then uses the latest accepted true/false value; loading does not select the native flow. Browser regression covers initial failure, a temporarily missing namespace and delayed reads for both routing choices.
91
93
 
92
- Native Search/Fetch settings regression on `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4` and `0.2.2-alpha.2` covers real settings/credentials selection, failed saves, refresh/restart persistence and anonymous/revoked-session refusal. Endpoints are local and request counts must stay zero. On `0.2.1-rc.3`, `0.2.1-rc.4` and `0.2.2-alpha.2`, `rc-navigation.spec.ts` checks global/session/right-sidebar More menus, native settings/model selection and refusal after revocation. Market/Creator entries are inspected without installation or external authorization. Public sessions/sessionProjections APIs create a real session empty completed turn to expose native menus; no chat is sent and no snapshot is replaced. Official dynamic `/models` internal semantics are outside the verification claim.
94
+ Native Search/Fetch settings regression on `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5` and `0.2.2-alpha.2` covers real settings/credentials selection, failed saves, refresh/restart persistence and anonymous/revoked-session refusal. Endpoints are local and request counts must stay zero. On `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5` and `0.2.2-alpha.2`, `rc-navigation.spec.ts` checks global/session/right-sidebar More menus, native settings/model selection and refusal after revocation. Market/Creator entries are inspected without installation or external authorization. Public sessions/sessionProjections APIs create a real session empty completed turn to expose native menus; no chat is sent and no snapshot is replaced. Official dynamic `/models` internal semantics are outside the verification claim.
93
95
 
94
96
  Startup diagnostics use installed exact declarations and explicit lifecycle records, warning once per process/version/state even across configuration/module HMR. The three Alpha releases are legacy from 2026-10-28 with a 14-day window and earliest eligibility 2026-11-11 (Asia/Shanghai); dates never stop service. The six retired versions record last plugin `0.2.0`, retirement release `0.3.1` and preparation date `retiredOn: 2026-10-28`, which is not an actual npm publication timestamp. Mock-clock tests preserve classification after eligibility; real legacy HMR checks process-wide deduplication. API, package identity and security failures still refuse service.
95
97
 
96
- `browser/host-release.spec.ts` fixes seven real round trips: `0.2.1-alpha.4` ↔ `0.2.1-alpha.3`, `0.2.1-alpha.5` ↔ `0.2.1-alpha.4`, `0.2.1-rc.1` ↔ `0.2.1-alpha.5`, `0.2.1-rc.2` ↔ `0.2.1-rc.1`, `0.2.1-rc.3` ↔ `0.2.1-rc.2`, `0.2.1-rc.4` ↔ `0.2.1-rc.3`, and `0.2.2-alpha.2` ↔ `0.2.1-rc.4`. Each keeps the page in one temporary profile/port, checks the native release prompt, reloads to verify authentication, the original session and persisted settings, then restores the starting release. Only `0.2.1-alpha.3` lacks release metadata and reads unknown; every other destination must show its actual full version. No upstream source, version or dependency-graph metadata is changed.
98
+ `browser/host-release.spec.ts` fixes eight real round trips: `0.2.1-alpha.4` ↔ `0.2.1-alpha.3`, `0.2.1-alpha.5` ↔ `0.2.1-alpha.4`, `0.2.1-rc.1` ↔ `0.2.1-alpha.5`, `0.2.1-rc.2` ↔ `0.2.1-rc.1`, `0.2.1-rc.3` ↔ `0.2.1-rc.2`, `0.2.1-rc.4` ↔ `0.2.1-rc.3`, `0.2.1-rc.5` ↔ `0.2.1-rc.4`, and `0.2.2-alpha.2` ↔ `0.2.1-rc.4`. Each keeps the page in one temporary profile/port, checks the native release prompt, reloads to verify authentication, the original session and persisted settings, then restores the starting release. Only `0.2.1-alpha.3` lacks release metadata and reads unknown; every other destination must show its actual full version. No upstream source, version or dependency-graph metadata is changed.
97
99
 
98
100
  ## Consume a fixed archive
99
101
 
100
102
  `pnpm verify:packed` consumes an existing tgz without building or packing. Record its SHA-256 first, then pass the archive, that digest, an exact declared DSH release and one or more suites:
101
103
 
102
104
  ```sh
103
- sha256sum artifacts/dsh-auth-remote-0.3.2.tgz
104
- pnpm verify:packed --archive artifacts/dsh-auth-remote-0.3.2.tgz --sha256 <recorded-sha256> --dsh-version 0.2.2-alpha.2 --suite cli --suite browser --suite smoke
105
+ sha256sum artifacts/dsh-auth-remote-0.3.3.tgz
106
+ pnpm verify:packed --archive artifacts/dsh-auth-remote-0.3.3.tgz --sha256 <recorded-sha256> --dsh-version 0.2.2-alpha.2 --suite cli --suite browser --suite smoke
105
107
  ```
106
108
 
107
109
  The consumer validates the package name/version and selected release declaration, stages those exact bytes at the fixed artifact path and restores only the archive's dist. CLI execution and installation comparisons therefore use that dist. It rejects unsafe tar entries, a changed digest, unknown selections, zero actual tests and skipped/cancelled/todo tests. Node's passing placeholder for a test file with no matching cases does not count as a real test. `--test-name-pattern` optionally filters one `cli` or `browser` suite; its report is explicitly partial and includes the files, pattern and actual commands. Fixed specialized suites cannot override their filter/count requirements; every required file must register tests.
108
110
 
109
- | Suite | Selection |
110
- | -------------- | -------------------------------------------------------------------------------------------------------------------------------- |
111
- | `cli` | All CLI test files |
112
- | `browser` | All browser test files |
113
- | `smoke` | Install and briefly boot the archive in a new marked home |
114
- | `theme` | The exact login/security theme and narrow-screen case (one real test) |
115
- | `account` | startup-compatibility, account-login and live-config on `0.2.1-alpha.3` |
116
- | `host-release` | One real round trip on `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.2-alpha.2` |
117
- | `rc-bootstrap` | host-release and dsh-bootstrap on `0.2.1-rc.1` (two real tests) |
111
+ | Suite | Selection |
112
+ | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
113
+ | `cli` | All CLI test files |
114
+ | `browser` | All browser test files |
115
+ | `smoke` | Install and briefly boot the archive in a new marked home |
116
+ | `theme` | The exact login/security theme and narrow-screen case (one real test) |
117
+ | `account` | startup-compatibility, account-login and live-config on `0.2.1-alpha.3` |
118
+ | `host-release` | One real round trip on `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4`, `0.2.1-rc.5`, `0.2.2-alpha.2` |
119
+ | `rc-bootstrap` | host-release and dsh-bootstrap on `0.2.1-rc.1` (two real tests) |
118
120
 
119
121
  Consumption is serial within a checkout, enforced by a consumer lock. Each suite checks the input archive, fixed consumer archive and restored dist again. JSON reports and test logs remain under `.cache/verify-packed/`. Smoke creates its marked temporary root directly under `.cache/v-*` to keep the management socket within Linux's pathname limit in the default GitHub checkout. It uses its own runtime/home and `--port 0`; it reads only that child process's announced actual loopback address and checks online CLI status in the same profile. Existing `.dev/dsh-home` and services on 13090 are independent. Only the newly created verification root is removed. `DSH_VERIFY_ROOT` is internal and rejects unmarked, symlinked or external paths; ordinary development commands retain their existing profile and port.
120
122
 
@@ -123,7 +125,7 @@ Consumption is serial within a checkout, enforced by a consumer lock. Each suite
123
125
  `verify-retired.mjs` does not extend `DSH_TEST_VERSION` or the positive matrix. It checks the same candidate/SHA256SUMS and published `0.2.0` integrity, then uses two private old profiles for real CLI rejection/complete rollback and native peer skip of a whole incompatible package. The latter preserves actual old peer resolution, repeatedly confirms no TCP/HTTP/readiness/WebSocket listener, and cleans up processes. The six-host one-time acceptance belongs to the `0.3.1` migration history. Current full/release plans run only `0.2.1-alpha.2`, and ordinary runs none.
124
126
 
125
127
  ```sh
126
- node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.2.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
128
+ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.3.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
127
129
  ```
128
130
 
129
131
  The six independent negative targets are `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` and `0.2.1-alpha.2`. Reports stay separate from positive evidence under `.cache/verify-retired/`.
@@ -132,7 +134,7 @@ The six independent negative targets are `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1
132
134
 
133
135
  `scripts/ci-plan.mjs` selects ordinary verification only when every changed path is one of `CHANGELOG.md`, `CHANGELOG.zh-CN.md`, `CONTRIBUTING.md`, `CONTRIBUTING.zh-CN.md`, `LICENSE` or `tests/unit/i18n.test.ts`. Any other path selects full verification, including source, shared tests/helpers, package/lock/build scripts, workflows, README, support policies and compatibility inventories. Renames/copies, unknown statuses, empty or incomplete differences and an unexpected/dirty checkout also select full. PR comparison uses the actual event base/head and verifies merge parents; push comparison uses before/after. Missing commit evidence falls back to full.
134
136
 
135
- Manual dispatch, unknown events, every release and the Monday 00:00 UTC schedule use full verification. Every plan keeps eight-version CLI/smoke. Full runs eight complete browser targets plus the independent real negative job on `0.2.1-alpha.2`; ordinary runs no real retired-host negative job. Its browser matrix is fixed:
137
+ Manual dispatch, unknown events, every release and the Monday 00:00 UTC schedule use full verification. Every plan keeps nine-version CLI/smoke. Full runs nine complete browser targets plus the independent real negative job on `0.2.1-alpha.2`; ordinary runs no real retired-host negative job. Its browser matrix is fixed:
136
138
 
137
139
  | Exact DSH release | Ordinary browser selection |
138
140
  | ----------------- | -------------------------- |
@@ -143,6 +145,7 @@ Manual dispatch, unknown events, every release and the Monday 00:00 UTC schedule
143
145
  | `0.2.1-rc.2` | `browser` |
144
146
  | `0.2.1-rc.3` | `browser` |
145
147
  | `0.2.1-rc.4` | `browser` |
148
+ | `0.2.1-rc.5` | `browser` |
146
149
  | `0.2.2-alpha.2` | `browser` |
147
150
 
148
151
  The shared workflow validates the exact matrix. Full requires validate, cli-smoke, browser and retired-rejection to succeed; ordinary accepts only the predetermined retired-rejection skip and requires the other three successes. Unknown plans, missing results, failures, cancellations and other skips fail. `CI Verify` also requires plan/producer success; releases use full and inherit the negative gate. Keep fixed-port tests serial per checkout; local parallel jobs require independent source/dist/artifacts/runtime/profile trees, writable node_modules copies and network namespaces. Copy-mode installation avoids shared HMR inode changes.
@@ -153,4 +156,4 @@ The new-host `account-login.spec.ts` source-HMR fault case preserves the initial
153
156
 
154
157
  Browser language tests cover all eight plugin dictionaries, login fallback/memory, native accepted preference vs optimistic edits, delayed/unavailable/failed reads and saves, storage failures and sign-out/revocation persistence. DSH's native language catalog is unchanged. CLI tests require fixed English across environment languages and reject every `--lang` form before profile access; the published `0.2.0` retired fixture keeps its historical Chinese contract.
155
158
 
156
- `liveshare.spec.ts` registers only on exact `0.2.2-alpha.2`: real native Host/Owner PKCE/share worker/viewer carriers and stop operations use a local Relay identity/transport stand-in. Viewer clients remain inert for administrator features. Tests do not establish real Relay/OAuth, visitor models or file writes. Partial filtered reports and file placeholders never certify the final eight-host archive.
159
+ `liveshare.spec.ts` registers only on exact `0.2.2-alpha.2`: real native Host/Owner PKCE/share worker/viewer carriers and stop operations use a local Relay identity/transport stand-in. Viewer clients remain inert for administrator features. Tests do not establish real Relay/OAuth, visitor models or file writes. Partial filtered reports and file placeholders never certify the final nine-host archive.
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](development.md)
4
4
 
5
- 本指南描述未发布插件候选 `0.3.2` 的八版精确验证目标,默认 DSH `0.2.2-alpha.2`。最终同包运行证据另记包外执行记录;声明与实测报告分开表达。
5
+ 本指南描述计划发布 `0.3.3` 的九版精确验证目标,默认 DSH `0.2.2-alpha.2`。最终同包运行证据保存在包外测试报告中;声明与实测报告分开表达。
6
6
 
7
7
  开发和完整测试需要 Linux(profile 锁依赖 `/proc`)、Node.js 24+、pnpm 12.5.1,以及 DSH `0.2.2-alpha.2`。DSH `0.2.2-alpha.2` 自身要求 Node.js `>=24.9.0`;插件引擎仍为 `>=24`。浏览器测试使用 Playwright 管理的 Chromium 和 Node HTTP/HTTPS 转发器。
8
8
 
@@ -18,7 +18,7 @@ pnpm pack:local
18
18
  pnpm smoke
19
19
  ```
20
20
 
21
- `pnpm check` 依次执行类型、格式、构建、包/部署/文档检查,以及单元、集成、CLI 和浏览器测试。`pnpm pack:local` 在静态检查后写出 `artifacts/dsh-auth-remote-0.3.2.tgz`,不会发布。`pnpm smoke` 将包安装到隔离 DSH_HOME,短暂启动固定版本的 DSH,验证就绪、匿名重定向/拒绝和在线 CLI 状态,然后停止。
21
+ `pnpm check` 依次执行类型、格式、构建、包/部署/文档检查,以及单元、集成、CLI 和浏览器测试。`pnpm pack:local` 在静态检查后写出 `artifacts/dsh-auth-remote-0.3.3.tgz`,不会发布。`pnpm smoke` 将包安装到隔离 DSH_HOME,短暂启动固定版本的 DSH,验证就绪、匿名重定向/拒绝和在线 CLI 状态,然后停止。
22
22
 
23
23
  ## 使用隔离开发 profile
24
24
 
@@ -50,11 +50,11 @@ DSH 测试运行时位于 `.cache/test-runtime/<version>`,与源码依赖分
50
50
 
51
51
  隔离验证安装使用 pnpm 的文件复制模式,避免不同 profile 共享包文件的硬链接元数据变化触发 DSH 客户端热重载。
52
52
 
53
- 本候选当前支持见 [README](../README.zh-CN.md#dsh-兼容性),发布事实见[双向历史](support-history.zh-CN.md),适配证据见库存。两份 support-policy 保留前一发布记录,本次 `0.3.2` 不修改;不能用当前候选 manifest 推导旧发布声明。
53
+ 当前支持见 [README](../README.zh-CN.md#dsh-兼容性)与[支持规范](support-policy.zh-CN.md),发布事实见[双向历史](support-history.zh-CN.md),适配证据见库存。不能用当前 manifest 推导旧发布声明。
54
54
 
55
55
  ## 跨版本验证
56
56
 
57
- 默认测试 DSH `0.2.2-alpha.2`;`DSH_TEST_VERSION` 仅可选择 `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.2-alpha.2`。测试运行时位于 `.cache/test-runtime/<version>`,开发运行时位于 `.dev/runtime-<version>`;`DSH_TEST_BIN` 必须报告所选精确版本。CI 保留八版 CLI/安装 smoke,全量运行八版完整 browser,普通使用下文固定选择。开发类型与集成测试使用锁定的 `0.2.2-alpha.2` 包。八版均验证真实 Loader、模型 runtime context/`DSH_WEB_URL` 和 IPv4/IPv6 HTTP/HTTPS 正向安全边界;测试传输不可用时失败,不跳过。
57
+ 默认测试 DSH `0.2.2-alpha.2`;`DSH_TEST_VERSION` 仅可选择 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`。测试运行时位于 `.cache/test-runtime/<version>`,开发运行时位于 `.dev/runtime-<version>`;`DSH_TEST_BIN` 必须报告所选精确版本。CI 保留九版 CLI/安装 smoke,全量运行九版完整 browser,普通使用下文固定选择。开发类型与集成测试使用锁定的 `0.2.2-alpha.2` 包。九版均验证真实 Loader、模型 runtime context/`DSH_WEB_URL` 和 IPv4/IPv6 HTTP/HTTPS 正向安全边界;测试传输不可用时失败,不跳过。
58
58
 
59
59
  ```sh
60
60
  DSH_TEST_VERSION=0.2.1-alpha.3 pnpm test:cli
@@ -69,8 +69,10 @@ DSH_TEST_VERSION=0.2.1-rc.2 pnpm test:cli
69
69
  DSH_TEST_VERSION=0.2.1-rc.2 pnpm test:browser
70
70
  DSH_TEST_VERSION=0.2.1-rc.3 pnpm test:cli
71
71
  DSH_TEST_VERSION=0.2.1-rc.3 pnpm test:browser
72
- DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:cli
73
- DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:browser
72
+ DSH_TEST_VERSION=0.2.1-rc.4 pnpm test:cli
73
+ DSH_TEST_VERSION=0.2.1-rc.4 pnpm test:browser
74
+ DSH_TEST_VERSION=0.2.1-rc.5 pnpm test:cli
75
+ DSH_TEST_VERSION=0.2.1-rc.5 pnpm test:browser
74
76
  DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:cli
75
77
  DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:browser
76
78
  ```
@@ -81,40 +83,40 @@ DSH_TEST_VERSION=0.2.2-alpha.2 pnpm test:browser
81
83
 
82
84
  账号核心测试从锁定的开发依赖加载精确版本提供者,无需预先存在 CLI 运行时缓存;浏览器测试仍使用隔离 DSH profile 中实际安装的提供者。
83
85
 
84
- 此临时账号适配保留必要能力与动态配置检查;完整手动功能回归覆盖 `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.2-alpha.2`。全局下限准入后的服务端不再分流旧宿主,独立导出 helper 仍检查缺省、无效和旧版本参数。未来准入不构成已验证声明。支持范围或共享宿主适配变更须用同一最终 tgz 完整运行八版 CLI、browser 与 smoke,逐版执行 `--suite cli --suite browser --suite smoke`;禁止在消费循环调用重建/重打包包装命令。运行器恢复归档 dist、逐 suite 校验 SHA-256,并隔离 smoke 与开发 profile。公网回调、迁移及退役条件见 `DSH-ACCOUNT-001`。
86
+ 此临时账号适配保留必要能力与动态配置检查;完整手动功能回归覆盖 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2`。全局下限准入后的服务端不再分流旧宿主,独立导出 helper 仍检查缺省、无效和旧版本参数。未来准入不构成已验证声明。支持范围或共享宿主适配变更须用同一最终 tgz 完整运行九版 CLI、browser 与 smoke,逐版执行 `--suite cli --suite browser --suite smoke`;禁止在消费循环调用重建/重打包包装命令。运行器恢复归档 dist、逐 suite 校验 SHA-256,并隔离 smoke 与开发 profile。公网回调、迁移及退役条件见 `DSH-ACCOUNT-001`。
85
87
 
86
88
  `live-config.spec.ts` 仅观察真实 Loader 的配置引用/fiber、认证/存储实例、锁、监听器及 SSE/WebSocket 连续性,核对实际依赖链并重启验证 profile override;不伪造服务。安全弹窗回归覆盖取消/错误、焦点/键盘、默认及强制 TOTP、一次性备用码复制与会话撤销后跳转保持。任务文档、测试凭证、profile、截图及生成目录不得进入 npm 包。
87
89
 
88
- `account-login.spec.ts` 在八版验证真实原生配置 HMR:修改普通 `sessionHours` 重建监听器,独立 Settings 写入仍等待已有事务,真正嵌套仍被拒绝;隔离插件代码替换后可重新开启手动登录。事务探针调用真实 HMR,不替代服务,不进入 npm 包,最小监听器上下文适配见 `DSH-HMR-001`。受保护远程部署独立禁用原生 webserver。`startup-compatibility.spec.ts` 在八版破坏隔离插件副本:`0.2.1-alpha.3` 用不兼容 Host peer 验证 Loader skip,其余七版用不兼容 `engines.dsh`;各版还注入插件自身准入范围,验证导入后的运行拒绝。两路径均须自行失败且无 TCP/HTTP/readiness/WebSocket 回退,不改上游或 Loader 审计。
90
+ `account-login.spec.ts` 在九版验证真实原生配置 HMR:修改普通 `sessionHours` 重建监听器,独立 Settings 写入仍等待已有事务,真正嵌套仍被拒绝;隔离插件代码替换后可重新开启手动登录。事务探针调用真实 HMR,不替代服务,不进入 npm 包,最小监听器上下文适配见 `DSH-HMR-001`。受保护远程部署独立禁用原生 webserver。`startup-compatibility.spec.ts` 在九版破坏隔离插件副本:`0.2.1-alpha.3` 用不兼容 Host peer 验证 Loader skip,其余八版用不兼容 `engines.dsh`;各版还注入插件自身准入范围,验证导入后的运行拒绝。两路径均须自行失败且无 TCP/HTTP/readiness/WebSocket 回退,不改上游或 Loader 审计。
89
91
 
90
92
  账号配置绑定通过原生 describe 镜像的 `ensure()` API 恢复首次读取失败;已有镜像中的命名空间恢复使用明确注入的 `remote.settings` 传输,并将已接纳值回填到同一镜像。偏好加载期间点击登录会等待共享读取,再按最新接纳的 true/false 值选择入口;加载中不等同于关闭。浏览器回归覆盖首次读取失败、命名空间暂缺,以及两种路由选择的延迟读取。
91
93
 
92
- `0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.2-alpha.2` 的原生 Search/Fetch 设置回归覆盖真实设置/凭据域的选择、保存失败和刷新/重启持久化,以及匿名/撤销会话拒绝。全部地址为本地测试地址,请求计数必须为零。`rc-navigation.spec.ts` 在 `0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.2-alpha.2` 验证全局、会话、右侧栏 More 菜单、原生设置/模型选择及撤销后拒绝;只检查插件市场/Creator 入口可见,不执行安装或外部授权。通过公开 sessions/sessionProjections 构造真实会话的空完成 turn 以展示原生菜单,不发送聊天,不替换快照。官方动态 `/models` 内部语义不在承诺内。
94
+ `0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2` 的原生 Search/Fetch 设置回归覆盖真实设置/凭据域的选择、保存失败和刷新/重启持久化,以及匿名/撤销会话拒绝。全部地址为本地测试地址,请求计数必须为零。`rc-navigation.spec.ts` 在 `0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2` 验证全局、会话、右侧栏 More 菜单、原生设置/模型选择及撤销后拒绝;只检查插件市场/Creator 入口可见,不执行安装或外部授权。通过公开 sessions/sessionProjections 构造真实会话的空完成 turn 以展示原生菜单,不发送聊天,不替换快照。官方动态 `/models` 内部语义不在承诺内。
93
95
 
94
96
  启动维护诊断读取已安装插件的精确声明与显式生命周期记录,同一进程每个精确版本/状态只提示一次,配置/模块 HMR 不重置。三个 Alpha 的 legacy 起算 2026-10-28、14 日窗口、最早资格 2026-11-11(Asia/Shanghai),日期不会停服。六个退役版本记录最后插件 `0.2.0`、退役版本 `0.3.1` 和准备日期 `retiredOn: 2026-10-28`,该日期不是 npm 实际发布时间。单元以模拟时钟确认到期不改变分类;真实 legacy HMR 用例观察同进程去重。必要 API、包身份和安全失败仍拒绝服务。
95
97
 
96
- `browser/host-release.spec.ts` 固定七组真实宿主往返切换:`0.2.1-alpha.4` ↔ `0.2.1-alpha.3`、`0.2.1-alpha.5` ↔ `0.2.1-alpha.4`、`0.2.1-rc.1` ↔ `0.2.1-alpha.5`、`0.2.1-rc.2` ↔ `0.2.1-rc.1`、`0.2.1-rc.3` ↔ `0.2.1-rc.2`、`0.2.1-rc.4` ↔ `0.2.1-rc.3`、`0.2.2-alpha.2` ↔ `0.2.1-rc.4`。同一临时 profile/端口保留页面,检查原生版本提示,刷新后核对认证、原会话和持久设置,再恢复起始版本。只有 `0.2.1-alpha.3` 无 release 元数据并显示未解析;其余目的宿主必须显示真实完整版本。不修改上游源码、版本或依赖图元数据。
98
+ `browser/host-release.spec.ts` 固定八组真实宿主往返切换:`0.2.1-alpha.4` ↔ `0.2.1-alpha.3`、`0.2.1-alpha.5` ↔ `0.2.1-alpha.4`、`0.2.1-rc.1` ↔ `0.2.1-alpha.5`、`0.2.1-rc.2` ↔ `0.2.1-rc.1`、`0.2.1-rc.3` ↔ `0.2.1-rc.2`、`0.2.1-rc.4` ↔ `0.2.1-rc.3`、`0.2.1-rc.5` ↔ `0.2.1-rc.4`、`0.2.2-alpha.2` ↔ `0.2.1-rc.4`。同一临时 profile/端口保留页面,检查原生版本提示,刷新后核对认证、原会话和持久设置,再恢复起始版本。只有 `0.2.1-alpha.3` 无 release 元数据并显示未解析;其余目的宿主必须显示真实完整版本。不修改上游源码、版本或依赖图元数据。
97
99
 
98
100
  ## 消费固定归档
99
101
 
100
102
  `pnpm verify:packed` 消费已有 tgz,不构建或打包。先记录 SHA-256,再传入归档、该摘要、精确声明的 DSH 版本及一个或多个 suite:
101
103
 
102
104
  ```sh
103
- sha256sum artifacts/dsh-auth-remote-0.3.2.tgz
104
- pnpm verify:packed --archive artifacts/dsh-auth-remote-0.3.2.tgz --sha256 <recorded-sha256> --dsh-version 0.2.2-alpha.2 --suite cli --suite browser --suite smoke
105
+ sha256sum artifacts/dsh-auth-remote-0.3.3.tgz
106
+ pnpm verify:packed --archive artifacts/dsh-auth-remote-0.3.3.tgz --sha256 <recorded-sha256> --dsh-version 0.2.2-alpha.2 --suite cli --suite browser --suite smoke
105
107
  ```
106
108
 
107
109
  运行器验证包名/版本及所选宿主声明,将相同字节放到固定制品路径,仅恢复归档中的 dist,因此 CLI 执行与安装比较都使用这份 dist。不安全 tar 条目、摘要变化、未知选择、零真实用例及 skipped/cancelled/todo 用例均失败。Node 对无匹配用例文件产生的通过占位项不计作真实测试。`--test-name-pattern` 可筛选单个 `cli` 或 `browser` suite,报告明确标记为局部,并包含文件、筛选表达式与实际命令。固定专项不能覆盖其筛选/数量要求,每个必需文件均须注册测试。
108
110
 
109
- | Suite | 选择范围 |
110
- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
111
- | `cli` | 全部 CLI 测试文件 |
112
- | `browser` | 全部浏览器测试文件 |
113
- | `smoke` | 在新建且带标记的 home 中安装并短暂启动归档 |
114
- | `theme` | 精确登录/安全主题与窄屏用例(1 个真实测试) |
115
- | `account` | `0.2.1-alpha.3` 的 startup-compatibility、account-login 与 live-config |
116
- | `host-release` | `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.2-alpha.2` 的真实往返切换(1 个真实测试) |
117
- | `rc-bootstrap` | `0.2.1-rc.1` 的 host-release 与 dsh-bootstrap(2 个真实测试) |
111
+ | Suite | 选择范围 |
112
+ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
113
+ | `cli` | 全部 CLI 测试文件 |
114
+ | `browser` | 全部浏览器测试文件 |
115
+ | `smoke` | 在新建且带标记的 home 中安装并短暂启动归档 |
116
+ | `theme` | 精确登录/安全主题与窄屏用例(1 个真实测试) |
117
+ | `account` | `0.2.1-alpha.3` 的 startup-compatibility、account-login 与 live-config |
118
+ | `host-release` | `0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-alpha.2` 的真实往返切换(1 个真实测试) |
119
+ | `rc-bootstrap` | `0.2.1-rc.1` 的 host-release 与 dsh-bootstrap(2 个真实测试) |
118
120
 
119
121
  同一 checkout 的消费以锁保证串行。每个 suite 结束均重新校验输入归档、固定消费归档及恢复的 dist。JSON 报告和测试日志保留在 `.cache/verify-packed/`。smoke 直接在 `.cache/v-*` 新建带内部标记的短目录,确保默认 GitHub 检出路径下的管理 socket 不超过 Linux 路径上限;使用独立 runtime/home,以 `--port 0` 启动,仅读取该子进程公布的实际回环地址,并在相同 profile 检查在线 CLI 状态。既有 `.dev/dsh-home` 和 13090 上的服务保持独立,只清理本次新建的验证根目录。`DSH_VERIFY_ROOT` 是内部入口,拒绝无标记、符号链接及外部路径;普通开发命令保留原有 profile 和端口。
120
122
 
@@ -123,7 +125,7 @@ pnpm verify:packed --archive artifacts/dsh-auth-remote-0.3.2.tgz --sha256 <recor
123
125
  `verify-retired.mjs` 不扩展 `DSH_TEST_VERSION` 或正向矩阵。它核验同一候选/SHA256SUMS 及已发布 `0.2.0` 的完整性,在两个私有旧 profile 验证真实 CLI 安装拒绝/完整回滚,以及完整不兼容包的原生 peer skip。后一路保留真实旧 peer 解析、连续确认无 TCP/HTTP/readiness/WebSocket 监听并清理进程。六版一次性验收属于 `0.3.1` 迁移历史;当前 full/发布仅运行 `0.2.1-alpha.2`,ordinary 不运行。
124
126
 
125
127
  ```sh
126
- node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.2.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
128
+ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.3.tgz --sha256 <recorded-sha256> --retired-dsh-version 0.2.1-alpha.2
127
129
  ```
128
130
 
129
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`。结果与正向报告分开保存在 `.cache/verify-retired/`。
@@ -132,7 +134,7 @@ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.2.tgz --
132
134
 
133
135
  `scripts/ci-plan.mjs` 仅在全部变更路径均为 `CHANGELOG.md`、`CHANGELOG.zh-CN.md`、`CONTRIBUTING.md`、`CONTRIBUTING.zh-CN.md`、`LICENSE` 或 `tests/unit/i18n.test.ts` 时选择普通计划。其他任何路径均全量,包括源码、共享测试/helper、package/lock/构建脚本、工作流、README、支持规范与兼容库存。重命名/复制、未知状态、空或不完整差异、异常/有未提交变更的检出也全量。PR 比较真实事件 base/head 并核对合并父提交,push 比较 before/after;缺少提交证据回退全量。
134
136
 
135
- 手动运行、未知事件、每次发布及 UTC 周一 00:00 的定时检查固定 full。所有计划保留八版 CLI/smoke;full 运行八版完整 browser 和 `0.2.1-alpha.2` 独立真实负向任务,ordinary 不运行真实旧宿主负向。普通 browser 固定如下:
137
+ 手动运行、未知事件、每次发布及 UTC 周一 00:00 的定时检查固定 full。所有计划保留九版 CLI/smoke;full 运行九版完整 browser 和 `0.2.1-alpha.2` 独立真实负向任务,ordinary 不运行真实旧宿主负向。普通 browser 固定如下:
136
138
 
137
139
  | 精确 DSH 版本 | 普通 browser 选择 |
138
140
  | --------------- | ----------------- |
@@ -143,6 +145,7 @@ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.2.tgz --
143
145
  | `0.2.1-rc.2` | `browser` |
144
146
  | `0.2.1-rc.3` | `browser` |
145
147
  | `0.2.1-rc.4` | `browser` |
148
+ | `0.2.1-rc.5` | `browser` |
146
149
  | `0.2.2-alpha.2` | `browser` |
147
150
 
148
151
  共享工作流先验证精确矩阵。full 聚合要求 validate、cli-smoke、browser、retired-rejection 全部成功;ordinary 仅接受 retired-rejection 的预定 skipped,其余必须成功。未知 plan、缺失结果、失败/取消或其他 skip 均拒绝。`CI Verify` 还要求 plan/producer 成功,发布固定 full 并继承负向门禁。单 checkout 固定端口测试串行;本地并发需独立源码/dist/制品/runtime/profile、可写 node_modules 副本及网络命名空间,复制安装避免共享 HMR inode 变化。
@@ -153,4 +156,4 @@ node scripts/verify-retired.mjs --archive artifacts/dsh-auth-remote-0.3.2.tgz --
153
156
 
154
157
  浏览器语言测试覆盖插件八语、登录回退/记忆、原生已接纳偏好与乐观选择、延迟/不可用/失败读取和保存、存储失败,以及退出/撤销后保留;不改变 DSH 原生语言目录。CLI 在不同环境语言下须固定英语,各种 `--lang` 在 profile 访问前拒绝;退役夹具对已发布 `0.2.0` 保留历史中文合同。
155
158
 
156
- `liveshare.spec.ts` 仅在精确 `0.2.2-alpha.2` 注册:真实原生 Host/Owner PKCE/分享 worker/查看页载体和停止操作配本地 Relay 身份/传输替身;viewer 不挂载管理员功能。不宣称真实 Relay/OAuth、访客模型或文件写入已验证。局部筛选报告和文件 placeholder 不认证最终八版归档。
159
+ `liveshare.spec.ts` 仅在精确 `0.2.2-alpha.2` 注册:真实原生 Host/Owner PKCE/分享 worker/查看页载体和停止操作配本地 Relay 身份/传输替身;viewer 不挂载管理员功能。不宣称真实 Relay/OAuth、访客模型或文件写入已验证。局部筛选报告和文件 placeholder 不认证最终九版归档。