dsh-auth-remote 0.3.2 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,9 +6,24 @@ This file records user-visible changes to the released package. Version numbers
6
6
 
7
7
  ## Unreleased
8
8
 
9
+ ## 0.3.4 - 2026-11-05
10
+
11
+ - Upgrade the development SDK to DSH `0.2.2-alpha.3` and observe the Loader-owned effective configuration without replacing volatile references.
12
+
13
+ - Declare nine exact DSH targets, adding `0.2.2-alpha.3` as development default and recommended host. Retain the existing legacy dates.
14
+ - Withdraw support for DSH `0.2.2-alpha.2` in this release under an explicit 2026-11-05 zero-day exception: its native settings update hook is incompatible with newly resolved Cordis dependencies. Upgrade the host to `0.2.2-alpha.3`; downgrading the plugin does not repair the host. Remove only its positive verification target, retain shared adaptations and security checks, and keep technical admission unchanged.
15
+ - Add the native shield to Security & sign-in navigation on `0.2.2-alpha.3`; older hosts keep their default icon. Preserve native slot disposal and viewer isolation, and require specialized browser registration and actual eight-language coverage.
16
+ - Synchronize bilingual production prerequisites, isolated-profile upgrade/backup/rollback, compatibility inventories and published `0.3.3` facts. Verification reports stay outside the package. The local candidate was prepared on 2026-11-03; actual publication is confirmed by the release workflow and registry.
17
+
18
+ ## 0.3.3 - 2026-10-30
19
+
20
+ - Add DSH `0.2.1-rc.5` to the compatibility declaration and CLI, complete browser and installation-smoke matrices. Retain all existing supported releases and the `0.2.2-alpha.2` development default and recommendation.
21
+ - Cover native `0.2.1-rc.5` ↔ `0.2.1-rc.4` host switching, Search/Fetch settings and navigation, while retaining authentication, account sign-in and hot-reload regression coverage.
22
+ - Rewrite the English and Chinese README around current installation and usage. Remove outdated candidate and retired-version descriptions, repeated capability version lists and the LiveShare compatibility section.
23
+
9
24
  ## 0.3.2 - 2026-10-28
10
25
 
11
- - Prepare unpublished candidate `0.3.2`, adding DSH `0.2.2-alpha.2` to the original seven exact targets and pinning the development default and manual migration recommendation to it. Retain DSH `>=0.2.1-alpha.3`, forward admission and plugin Node `>=24`. The date records preparation; final same-archive reports are recorded separately.
26
+ - Add DSH `0.2.2-alpha.2` to the original seven exact targets and pin the development default and manual migration recommendation to it. Retain DSH `>=0.2.1-alpha.3`, forward admission and plugin Node `>=24`.
12
27
  - Gate native named/fallback HTTP resources before Fetch conversion while preserving native routing, ETag/HEAD, stream cancellation and in-process peer reads.
13
28
  - Isolate LiveShare viewers from the administrator client; restore trusted business Origin only for the two native Owner-login POSTs. Verify basic flows with a local Relay protocol stand-in and keep share/session lifetimes independent; real Relay/OAuth and visitor business operations are outside that verification.
14
29
  - Make CLI text fixed English and remove `--lang` and environment-language selection; old language arguments are invalid. Preserve JSON fields, exit codes, confirmation and secret-input contracts.
@@ -6,9 +6,24 @@
6
6
 
7
7
  ## 未发布
8
8
 
9
+ ## 0.3.4 - 2026-11-05
10
+
11
+ - 开发 SDK 更新至 DSH `0.2.2-alpha.3`;观测 Loader 有效配置并保留动态引用身份。
12
+
13
+ - 声明九个精确 DSH 目标,新增 `0.2.2-alpha.3` 为开发默认和推荐宿主;保留既有 legacy 日期。
14
+ - 以 2026-11-05 明确公告的零日窗口例外,在本版本撤销对 DSH `0.2.2-alpha.2` 的支持:其原生设置更新钩子与新解析的 Cordis 依赖不兼容。请升级宿主至 `0.2.2-alpha.3`,降低插件版本不能修复宿主。仅移除该版正向验证目标,保留共享适配、安全检查及原技术准入。
15
+ - 在 `0.2.2-alpha.3` 的安全与登录导航使用原生盾牌,旧宿主保留默认图标;保留原生槽释放和 viewer 隔离,并检查浏览器专项注册与实际八语覆盖。
16
+ - 同步双语生产前提、独立 profile 升级/备份/回滚、兼容库存与已发布 `0.3.3` 事实;验证报告不入包。本地候选曾于 2026-11-03 准备;实际发布时间由发布工作流及 registry 确认。
17
+
18
+ ## 0.3.3 - 2026-10-30
19
+
20
+ - 新增 DSH `0.2.1-rc.5` 兼容声明及 CLI、完整浏览器和安装 smoke 验证目标,保留全部既有支持版本,开发默认与推荐仍为 `0.2.2-alpha.2`。
21
+ - 补齐原生 `0.2.1-rc.5` ↔ `0.2.1-rc.4` 宿主切换、Search/Fetch 设置和导航回归,保留认证、官方账号登录及热重载测试。
22
+ - 重写中英文 README,聚焦当前安装和使用方式,删除过期候选及退役版本叙述、重复的能力版本清单和 LiveShare 基础兼容章节。
23
+
9
24
  ## 0.3.2 - 2026-10-28
10
25
 
11
- - 准备未发布候选 `0.3.2`,在原七个精确目标外新增 DSH `0.2.2-alpha.2`,并将开发默认与人工迁移推荐固定到该版本。保留 DSH `>=0.2.1-alpha.3`、前向准入和插件 Node `>=24`。日期仅为准备日期,最终同包报告另行记录。
26
+ - 在原七个精确目标外新增 DSH `0.2.2-alpha.2`,并将开发默认与人工迁移推荐固定到该版本。保留 DSH `>=0.2.1-alpha.3`、前向准入和插件 Node `>=24`。
12
27
  - 在 Fetch 转换前保护原生 named/fallback HTTP resource,保留原生路由、ETag/HEAD、流取消和进程内 peer 读取。
13
28
  - 隔离 LiveShare viewer 与管理员客户端;仅对两个原生 Owner 登录 POST 恢复可信业务 Origin。以本地 Relay 协议替身验证基础流程,分享与插件会话生命周期独立;不宣称真实 Relay/OAuth 或访客业务已验证。
14
29
  - CLI 文案固定英语,移除 `--lang` 和环境语言选择;旧语言参数作为无效参数拒绝。JSON 字段、退出码、确认和保密输入合同保持。
package/CONTRIBUTING.md CHANGED
@@ -26,4 +26,4 @@ Create a focused branch from `master`. Include the reason for the change, its us
26
26
 
27
27
  The `CI Verify` check runs on pull requests and again after a merge to `master`. A maintainer updates the version and dated changelog entry before creating a release tag. The [release guide](docs/releasing.md) describes that process.
28
28
 
29
- Published `0.3.1` retains its seven-target support and retirement history. The current unpublished candidate is `0.3.2`, declaring eight exact targets; both support policies keep their prior release content. Support/shared-host changes require one final archive across eight complete CLI/browser/smoke targets, following the release guide. Full/releases also require independent `0.2.1-alpha.2` refusal; ordinary runs no real retired-host negative job. The six-host one-time negative acceptance belongs to the `0.3.1` migration history. Never rebuild or pack in the final consumer loop.
29
+ Version `0.3.4` declares nine exact DSH targets with development default and recommended host `0.2.2-alpha.3`. Release availability is confirmed by the release workflow and npm registry. Published `0.3.3` retains nine declarations and `0.3.2` retains eight. Support/shared-host changes require one final archive across nine complete CLI/browser/smoke targets, following the release guide. Follow the PR, master-CI, annotated-tag and trusted-publication sequence in that guide. Full/releases also require independent `0.2.1-alpha.2` refusal; ordinary runs no real retired-host negative job. The six-host one-time negative acceptance belongs to the `0.3.1` migration history. Never rebuild or pack in the final consumer loop.
@@ -26,4 +26,4 @@ pnpm check
26
26
 
27
27
  `CI Verify` 会在 Pull Request 和合入 `master` 后运行。维护者在创建发布标签前更新版本号和带日期的更新日志;具体流程见[发布指南](docs/releasing.zh-CN.md)。
28
28
 
29
- 已发布 `0.3.1` 的七版支持和退役事实保留在历史记录;当前未发布候选为 `0.3.2`,声明八个精确目标。两份 support-policy 继续保留此前发布内容。支持或共享宿主变更须按发布指南消费同一最终归档,八版完整 CLI/browser/smoke;full/发布还要求独立 `0.2.1-alpha.2` 退役拒绝,ordinary 不运行真实旧宿主负向。六版一次性负向属于 `0.3.1` 迁移历史。不要在最终消费循环重建或打包。
29
+ 版本 `0.3.4` 声明九个精确 DSH 目标,开发默认及推荐宿主为 `0.2.2-alpha.3`,发布可用性由发布工作流和 npm registry 确认;已发布 `0.3.3` 保留九版声明,`0.3.2` 保留八版记录。支持或共享宿主变更须按发布指南消费同一最终归档,九版完整 CLI/browser/smoke。按发布指南依次完成 PR、master CI、附注标签及可信发布;full/发布还要求独立 `0.2.1-alpha.2` 退役拒绝,ordinary 不运行真实旧宿主负向。六版一次性负向属于 `0.3.1` 迁移历史。不要在最终消费循环重建或打包。
package/README.md CHANGED
@@ -2,73 +2,76 @@
2
2
 
3
3
  [简体中文](README.zh-CN.md)
4
4
 
5
- Single-user remote sign-in for DeepSeek Harness (DSH), with password, TOTP, one-use backup codes, and revocable sessions. The package runs inside DSH and guards its browser routes, APIs, streams, and WebSockets.
5
+ Single-user remote sign-in for DeepSeek Harness (DSH), with password, TOTP, one-use backup codes, and revocable sessions. The plugin runs inside DSH and protects browser pages, APIs, streams, and WebSockets.
6
6
 
7
7
  ## Requirements
8
8
 
9
- - Linux with `/proc`, Node.js 24 or newer, and one exact DSH target below; development defaults to `0.2.2-alpha.2`. pnpm 12.5.1 is needed only when building from source.
10
- - DSH `0.2.2-alpha.2` itself requires Node.js `>=24.9.0`; the plugin keeps its own `>=24` engine range.
11
- - DSH's default `~/.dsh` data directory and a `web` profile. The account state belongs to that profile; it is not shared with another profile.
12
- - For source browser tests, install Playwright Chromium with `pnpm exec playwright install chromium`. The tests use that managed browser and a dedicated, self-signed TLS fixture.
9
+ - Linux with `/proc` and Node.js 24. DSH `0.2.2-alpha.3` requires Node.js `>=24.9.0`.
10
+ - A supported DSH release and a `web` profile. One account and its sessions belong to that profile.
13
11
 
14
12
  ## DSH compatibility
15
13
 
16
- Published `0.3.1` retains its seven-host release record. Unpublished candidate **`0.3.2`** declares the eight exact targets below in `dsh.compatibility.dshReleases`. `engines.dsh`, the WebServer peer and runtime admission share the minimum `>=0.2.1-alpha.3`, with no upper bound and SemVer prereleases included. **`0.2.2-alpha.2`** is the development default and migration recommendation. Final same-archive verification is recorded separately from declarations.
14
+ Version **`0.3.4`** declares these nine exact DSH releases. **`0.2.2-alpha.3`** is the development default and recommended host. Release availability is established by the completed release workflow and npm registry. The recommended DSH host is an upstream Alpha, not an upstream stable release. Published `0.3.3` retains its nine declarations through `0.2.2-alpha.2`; it does not declare `0.2.2-alpha.3`.
17
15
 
18
- | Exact supported DSH release | Maintenance | Legacy since | Window | Earliest eligible retirement |
19
- | --------------------------- | ----------------------------------- | ------------ | ------- | ---------------------------- |
20
- | `0.2.1-alpha.3` | Legacy; supported | 2026-10-28 | 14 days | 2026-11-11 |
21
- | `0.2.1-alpha.4` | Legacy; supported | 2026-10-28 | 14 days | 2026-11-11 |
22
- | `0.2.1-alpha.5` | Legacy; supported | 2026-10-28 | 14 days | 2026-11-11 |
23
- | `0.2.1-rc.1` | Normal support | — | — | Not announced |
24
- | `0.2.1-rc.2` | Normal support | — | — | Not announced |
25
- | `0.2.1-rc.3` | Normal support | — | — | Not announced |
26
- | `0.2.1-rc.4` | Normal support | — | — | Not announced |
27
- | `0.2.2-alpha.2` | Normal support; development default | — | — | Not announced |
16
+ | DSH release | Maintenance |
17
+ | --------------- | ----------------- |
18
+ | `0.2.1-alpha.3` | Legacy; supported |
19
+ | `0.2.1-alpha.4` | Legacy; supported |
20
+ | `0.2.1-alpha.5` | Legacy; supported |
21
+ | `0.2.1-rc.1` | Supported |
22
+ | `0.2.1-rc.2` | Supported |
23
+ | `0.2.1-rc.3` | Supported |
24
+ | `0.2.1-rc.4` | Supported |
25
+ | `0.2.1-rc.5` | Supported |
26
+ | `0.2.2-alpha.3` | Recommended host |
28
27
 
29
- Dates use `Asia/Shanghai` at 00:00; eligibility never automatically ends support or removes CI. Plugin `0.3.1` retires 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`. Their last supported plugin is published `0.2.0`; this candidate cannot be installed on them. Query [DSH → plugin](docs/support-history.md#by-dsh) or [plugin → DSH](docs/support-history.md#by-plugin) for historical declarations, reports and distribution facts. Both support policies retain the previous release's record; this README and the history describe this candidate.
28
+ Legacy versions remain supported until an explicit retirement release; see the [support policy](docs/support-policy.md). Newer versions may load after capability checks, but are outside these exact compatibility declarations.
30
29
 
31
- All eight use the same entry configuration and support concrete IPv4/IPv6, native HTTP/HTTPS and CLI `--public-url`. The final public root appears in model runtime context and `DSH_WEB_URL`. Model Web sections must not duplicate that URL or leak a token. The [compatibility inventory](docs/legacy-compatibility.md) records native capabilities and retained adaptations.
30
+ DSH `0.2.2-alpha.2` is retired in plugin `0.3.4` because fresh SDK resolution breaks native settings updates. Upgrade to `0.2.2-alpha.3`; historical plugin `0.3.3` support does not repair that host dependency combination. See the [retirement exception](docs/support-policy.md#upstream-failure-exception).
32
31
 
33
- Later versions are forward-admitted subject to WebServer/Connection APIs, host package identity and native authentication exchange; admission is not an exact support or test claim. Every plan keeps eight-version CLI/smoke. Full, manual, scheduled and release plans run eight complete browser targets plus independent refusal verification on retired boundary `0.2.1-alpha.2`. Ordinary low-risk plans use the [fixed browser selection](docs/development.md#ordinary-and-full-ci-plans) and run no real retired-host negative job.
34
-
35
- ## Install the candidate archive
36
-
37
- `0.3.2` is unpublished. Build and verify its local archive using the [development guide](docs/development.md), then install that archive. Published `0.3.1` retains its historical seven-host support and does not provide this new-host adaptation.
32
+ ## Install
38
33
 
39
34
  ```sh
40
35
  dsh --version
41
- dsh plugin --profile web add ./artifacts/dsh-auth-remote-0.3.2.tgz
36
+ dsh plugin --profile web add dsh-auth-remote@0.3.4
42
37
  dsh plugin --profile web list
43
38
  ```
44
39
 
45
- Check that `dsh --version` prints the recommended `0.2.2-alpha.2` and the plugin list includes `dsh-auth-remote@0.3.2`. These commands use DSH's default data directory. For an isolated development runtime, see the [development guide](docs/development.md).
40
+ Use this npm command after the release workflow has published the version. For an offline installation, substitute the absolute path to the verified release archive. Published `dsh-auth-remote@0.3.3` retains its nine declared hosts. Use the same data directory and profile for installation, initialization, and the running service. These commands use DSH's default `~/.dsh` directory and the `web` profile. First rehearse upgrades in an independent profile, following the [backup and rollback procedure](docs/deployment.md#backup-recovery-and-changes).
46
41
 
47
- ## Configure the web profile
42
+ ## Initialize the account
48
43
 
49
- The minimal setup needs no profile patch. Start with `dsh web --no-open --port 13090` and use the printed `http://127.0.0.1:13090/` root. Without an explicit `publicUrl`, the plugin derives one root from the actual listener protocol, address and bound port, including `--port 0`. Unauthenticated navigation redirects to sign-in. Check `/auth-remote/ready` before relying on the service. Startup prints the listener and one distinct public root, without a native `?token=` URL.
44
+ Run this in a real terminal:
50
45
 
51
- For a public HTTPS entry, use the [deployment guide](docs/deployment.md) and [profile example](examples/web-profile-auth-remote.patch.yml), with top-level `publicUrl: https://dsh.example.com/`, `host` and `port`. All eight supported versions also support concrete IPv6 and paired top-level `tlsCert`/`tlsKey`. The URL must be an HTTP(S) root, with no credentials, child path, query or fragment. One public origin plus literal loopback is admitted. Setting a URL does not configure proxy routing or TLS.
46
+ ```sh
47
+ dsh plugin --profile web exec dsh-auth-remote init
48
+ ```
52
49
 
53
- The plugin automatically declares its finalized native bridge authority in Connection's `trustedHosts`, so downstream plugins can recognize a concrete listener without an extra `--trusted-host`. If a downstream route needs the original public Host, add its path to `preserveOriginPaths`; the final public authority is then declared as well. Explicit CLI trusted hosts are retained, while the outer public-origin and sign-in checks still apply. CLI host/port and public URL override file values; TLS overrides as one complete pair. See the [migration and path rules](docs/deployment.md#configuration-priority-and-path-bases) before upgrading `allowedOrigins`: zero or one item is migrated in memory with a warning, multiple items and any explicit coexistence with `publicUrl` fail.
50
+ Enter one username and a password of 12–256 Unicode characters. The password is not echoed or passed as a command-line argument. Account creation is available only through the CLI.
54
51
 
55
- ## Initialize the account
52
+ TOTP is optional by default (`requireTotp: false`); the first password sign-in offers setup or skipping it. Set `requireTotp: true` to require setup. Save the ten backup codes when shown: each works once, and the list cannot be retrieved later.
56
53
 
57
- Run this in a real terminal against the **same** default `web` profile as the service:
54
+ ## Configure the web profile
55
+
56
+ The minimal local setup needs no profile patch:
58
57
 
59
58
  ```sh
60
- dsh plugin --profile web exec dsh-auth-remote init
59
+ dsh web --no-open --port 13090
61
60
  ```
62
61
 
63
- Enter one username and a password of 12–256 Unicode characters. The password is not a command-line argument and is not echoed. The login page guides an uninitialized profile back to this command; it cannot create the account. TOTP is optional by default (`requireTotp: false`); the first password sign-in offers setup or skipping it. Set `requireTotp: true` to require setup. Upgrading follows the new default only when no explicit policy is configured; existing TOTP bindings, backup codes and explicit true/false settings are preserved. Save the ten backup codes when shown: each works once and the list cannot be retrieved later.
62
+ Open the printed `http://127.0.0.1:13090/` address. Unauthenticated navigation redirects to sign-in. Without an explicit `publicUrl`, the plugin derives the root URL from the actual listener address, protocol, and bound port. `/auth-remote/ready` reports service readiness.
63
+
64
+ For public access, follow the [deployment guide](docs/deployment.md) and [profile example](examples/web-profile-auth-remote.patch.yml). Set top-level `publicUrl: https://dsh.example.com/`, `host`, and `port`. Keep the native `webserver` independently disabled in the profile patch, as shown in the example.
65
+
66
+ The listener supports concrete IPv4/IPv6 addresses, HTTP, and HTTPS with paired `tlsCert`/`tlsKey` settings. `publicUrl` must be an HTTP(S) root without credentials, child paths, query, or fragment. It admits one public origin plus literal loopback addresses; setting it does not configure routing or TLS. CLI listener and public-URL options override profile values. If a downstream route needs the original public Host, configure `preserveOriginPaths` as described in the deployment guide.
64
67
 
65
68
  ## Sign in and manage the account
66
69
 
67
- Open the direct loopback URL for the minimal installation. After configuring a public origin, open `https://dsh.example.com/auth-remote/login`. Security settings inside DSH can change the password, bind or disable TOTP when policy permits, and revoke sessions. Password or factor changes revoke existing sessions. Sessions have a fixed default lifetime of 168 hours and survive service restarts.
70
+ Open the local root or your configured public URL. Inside DSH, open the sidebar account menu, then **Settings → Security & sign-in**. The page shows the plugin username, TOTP status, session expiry, and active session count. It can change the password, set up or rebind TOTP, disable TOTP when policy permits, and revoke sessions.
68
71
 
69
- On all eight supported versions, open the sidebar account menu, then **Settings → Security & sign-in**.
72
+ Password and second-factor changes revoke existing sessions. Sessions have a fixed default lifetime of 168 hours (`sessionHours`) and survive service restarts. Signing out the current session preserves other sessions; signing out all sessions verifies the password and any bound second factor. TOTP setup displays backup codes once, so save and acknowledge them before signing in again.
70
73
 
71
- The sign-in page references DSH's PWA manifest. The manifest and favicons are readable before sign-in; business pages and APIs still require authentication. See the [public resource rules](docs/deployment.md#source-and-bridge-contract).
74
+ Management commands are also available:
72
75
 
73
76
  ```sh
74
77
  dsh plugin --profile web exec dsh-auth-remote status --json
@@ -77,32 +80,32 @@ dsh plugin --profile web exec dsh-auth-remote reset-totp
77
80
  dsh plugin --profile web exec dsh-auth-remote revoke-sessions
78
81
  ```
79
82
 
80
- Mutating commands require an interactive confirmation. Online commands use a private Unix socket; offline commands acquire the same profile lock. If a management response is lost after submission, check `status` before deciding whether to try again. `status --json` keeps its machine-readable keys regardless of language.
83
+ Mutating commands require interactive confirmation. If a submitted command loses its response, check `status` before retrying.
81
84
 
82
- The embedded Security page follows DSH's language setting. Browser text supports English, Chinese, Japanese, Spanish, French, German, Russian and Brazilian Portuguese. The standalone login page uses `localStorage["dsh-auth-remote-lang"]`, then `navigator.language`, then English; it has no language selector. Supported language tags match case-insensitively, including regions; invalid or unsupported values fall through to the next choice. The plugin leaves DSH's own language picker unchanged. After entering DSH, only the native locale form's accepted preference updates this memory; clearing the preference removes it. Loading or failed reads/saves leave it intact, and signing out keeps it. The old `dsh-auth-remote.locale` key is ignored and left untouched. CLI text is always English; locale environment variables do not change it, and `--lang` is no longer accepted.
85
+ Browser text supports English, Chinese, Japanese, Spanish, French, German, Russian, and Brazilian Portuguese. The embedded page follows DSH's language setting. The standalone login page uses the remembered DSH preference, then the browser language, then English; it has no language selector. CLI output is English.
83
86
 
84
- Security & sign-in shows the plugin username, TOTP status, this session’s sign-in and expiry times, and active session count. Dates follow the current UI language and browser time zone. Password and TOTP setup/rebind/disable each open a task dialog; enforced TOTP cannot be disabled. Signing out the current session needs confirmation and preserves other sessions. Signing out all sessions verifies the password and any bound second factor, and includes the current session. Security changes revoke all sessions. Successful setup shows backup codes once as the final step of the same dialog, with Copy all and an acknowledgement before signing in again. Escape, the backdrop and parent Settings cannot dismiss this step; leaving or refreshing loses it.
87
+ On DSH `0.2.2-alpha.3`, the native navigation uses a shield for this page; the other eight declared hosts retain their default icon.
85
88
 
86
89
  ## Sign in to an official DeepSeek account
87
90
 
88
- Manual callbacks are forward-admitted from `>=0.2.1-alpha.3` using SemVer with prereleases included, and require native capabilities plus `manualAccountLogin: true`. Full feature verification 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** and **0.2.2-alpha.2**; future releases need exact regression before being called verified. In its account menu, **Sign in** first opens an instruction dialog; it does not start authorization immediately. Click **Open sign-in page** to open the official page in a new tab. After approval, that tab may show a connection error or 404 at a loopback address. Copy its entire address, including `code` and `state`, paste it into **Full callback address**, and click **Confirm sign-in**. Keep the original DSH page open throughout. If the popup is blocked, use the dialog's authorization link.
89
-
90
- In **Settings → Security & sign-in → Sign-in preferences**, the remote DeepSeek sign-in switch defaults to on. Native Settings saves it to the current profile override; new authorizations on this page use the accepted value immediately and restarts preserve it. Failed saves show an error. Turning it off restores native entries for new attempts, preserves admitted manual attempts and existing official-account credentials, and does not establish native public-callback support. Other open pages need no active synchronization; a stale page starting authorization receives disabled feedback and advice to refresh.
91
+ Remote DeepSeek account sign-in is enabled by default (`manualAccountLogin: true`):
91
92
 
92
- This manual handoff needs no local listener, SSH tunnel or browser extension. The loopback address is an authorization return address; its page does not need to load. The plugin parses the pasted URL and delivers the callback inside DSH, retaining native state validation, PKCE exchange and credential storage. It never fetches the pasted address. Pending authorization belongs to the initiating remote session, lasts at most ten minutes and is cancelled when dismissed or the session is revoked. Expired or failed authorization must be restarted.
93
+ 1. Choose **Sign in** in the account menu, then **Open sign-in page** in the instruction dialog.
94
+ 2. Complete official sign-in in the new tab. The resulting loopback address may show a connection error or 404; its page does not need to load.
95
+ 3. Copy the entire callback URL, including `code` and `state`, into **Full callback address** in the original DSH tab, then choose **Confirm sign-in**.
93
96
 
94
- On 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` and `0.2.2-alpha.2`, the dialog also offers **Use API key** before authorization begins. It opens the native credential editor and continues setup until the key is saved or the user chooses to defer. The same option is available from the account menu. During active authorization, the secondary button cancels that attempt instead.
97
+ Keep the original DSH tab open. If a popup is blocked, use the dialog's authorization link. No local listener, SSH tunnel, or browser extension is needed. The plugin delivers the callback inside DSH and never requests the pasted URL. Authorization expires after ten minutes and is cancelled when its dialog is dismissed or the initiating session is revoked; expired or failed attempts must be restarted.
95
98
 
96
- ## LiveShare basic compatibility
99
+ Before authorization, **Use API key** opens DSH's native credential editor; the same option is available from the account menu. During authorization, the secondary button cancels the attempt.
97
100
 
98
- On DSH `0.2.2-alpha.2`, enable LiveShare, configure its Relay and sign in as Owner through DSH's native setup first. This plugin does not enable sharing or rewrite Relay configuration. Administrator sign-in and share viewers retain separate identities and transports. Signing out of this plugin does not stop existing shares; use native LiveShare management to stop them.
99
-
100
- Local verification covers the real Host, Owner PKCE flow, share worker, viewer page and stopping shares, with a local protocol stand-in for Relay identity/transport. It does not establish real Relay/OAuth, visitor model calls or file-write experience.
101
+ The switch in **Settings → Security & sign-in → Sign-in preferences** controls new manual authorizations and persists in the profile. Turning it off restores native sign-in entries while preserving active attempts and existing official-account credentials. Native sign-in still requires a callback route reachable by your browser.
101
102
 
102
103
  ## Put a proxy in front
103
104
 
104
105
  Use the [reverse proxy guide](docs/reverse-proxy.md) with the [Nginx](examples/nginx.conf) or [Traefik](examples/traefik-dsh.yml) example. Preserve the browser's Host and Origin, WebSocket upgrades, and streaming responses. TLS can terminate at the proxy; set its exact HTTPS root as `publicUrl`. Keep the DSH listener private and do not cache authentication responses.
105
106
 
106
- ## Project and maintenance
107
+ Acceptance targets Linux, Node.js 24, Chromium, native IPv4/IPv6 HTTP/HTTPS and the existing Node forwarding topologies. Other platforms/browsers, a real non-loopback IPv6 interface, Nginx/Traefik binaries and real external authorization are not established by these tests. See the deployment and development guides for the precise boundaries; local verification is separate from GitHub Actions and publication.
108
+
109
+ ## Documentation
107
110
 
108
- The plugin uses DSH's WebServer, Connection, settings slots, and official workspace browser and preview. It stores one account plus sessions in a private profile JSON file. It provides single-user access without a separate identity server. See [development](docs/development.md) and [deployment](docs/deployment.md) for checks and boundaries. Changes and releases are recorded in the [changelog](CHANGELOG.md); see [contributing](CONTRIBUTING.md), [releasing](docs/releasing.md), and the [MIT license](LICENSE).
111
+ See [deployment](docs/deployment.md) for configuration, profile backups, and operational details, or [development](docs/development.md) to build and test from source. Changes are in the [changelog](CHANGELOG.md). Contributions follow the [contribution guide](CONTRIBUTING.md) and [release guide](docs/releasing.md). Licensed under [MIT](LICENSE).
package/README.zh-CN.md CHANGED
@@ -6,69 +6,72 @@ DeepSeek Harness(DSH)的单用户远程登录插件,提供密码、TOTP、
6
6
 
7
7
  ## 前置条件
8
8
 
9
- - Linux(含 `/proc`)、Node.js 24 或更高版本,以及下表某个精确 DSH 目标;开发默认 `0.2.2-alpha.2`。仅从源码构建时需要 pnpm 12.5.1。
10
- - DSH `0.2.2-alpha.2` 自身要求 Node.js `>=24.9.0`;插件自身仍保持 `>=24` 引擎范围。
11
- - DSH 默认的 `~/.dsh` 数据目录和 `web` profile。账号状态属于该 profile,不与其他 profile 共用。
12
- - 源码浏览器测试先执行 `pnpm exec playwright install chromium`。测试使用 Playwright 管理的浏览器和专用自签 TLS 夹具。
9
+ - Linux(含 `/proc`)和 Node.js 24。DSH `0.2.2-alpha.3` 要求 Node.js `>=24.9.0`。
10
+ - 一个受支持的 DSH 版本和 `web` profile。一个账号及其会话属于该 profile。
13
11
 
14
12
  ## DSH 兼容性
15
13
 
16
- 已发布 `0.3.1` 保留原有七版发布记录。未发布候选 **`0.3.2`** 在 `dsh.compatibility.dshReleases` 声明以下八个精确目标。`engines.dsh`、WebServer peer 和运行时准入下限一致为 `>=0.2.1-alpha.3`,不设上限且按 SemVer 包含预发布。开发默认与迁移推荐为 **`0.2.2-alpha.2`**。最终同包验证记录与声明分开保存。
14
+ 版本 **`0.3.4`** 声明以下九个精确 DSH 版本,**`0.2.2-alpha.3`** 为开发默认和推荐宿主。发布可用性以发布工作流完成状态和 npm registry 为准。推荐的 DSH 宿主仍是上游 Alpha,不是上游稳定版。已发布 `0.3.3` 保留截至 `0.2.2-alpha.2` 的九版声明,未声明 `0.2.2-alpha.3`。
17
15
 
18
- | 精确支持的 DSH 版本 | 维护状态 | Legacy 起算 | 窗口 | 最早退役资格日 |
19
- | ------------------- | ------------------ | ----------- | ----- | -------------- |
20
- | `0.2.1-alpha.3` | Legacy;继续支持 | 2026-10-28 | 14 日 | 2026-11-11 |
21
- | `0.2.1-alpha.4` | Legacy;继续支持 | 2026-10-28 | 14 日 | 2026-11-11 |
22
- | `0.2.1-alpha.5` | Legacy;继续支持 | 2026-10-28 | 14 日 | 2026-11-11 |
23
- | `0.2.1-rc.1` | 正常支持 | — | — | 未公告 |
24
- | `0.2.1-rc.2` | 正常支持 | — | — | 未公告 |
25
- | `0.2.1-rc.3` | 正常支持 | — | — | 未公告 |
26
- | `0.2.1-rc.4` | 正常支持 | — | — | 未公告 |
27
- | `0.2.2-alpha.2` | 正常支持;开发默认 | — | — | 未公告 |
16
+ | DSH 版本 | 维护状态 |
17
+ | --------------- | -------------- |
18
+ | `0.2.1-alpha.3` | Legacy;支持中 |
19
+ | `0.2.1-alpha.4` | Legacy;支持中 |
20
+ | `0.2.1-alpha.5` | Legacy;支持中 |
21
+ | `0.2.1-rc.1` | 支持中 |
22
+ | `0.2.1-rc.2` | 支持中 |
23
+ | `0.2.1-rc.3` | 支持中 |
24
+ | `0.2.1-rc.4` | 支持中 |
25
+ | `0.2.1-rc.5` | 支持中 |
26
+ | `0.2.2-alpha.3` | 推荐宿主 |
28
27
 
29
- 日期按 `Asia/Shanghai` 当日 00:00 计算;资格日不自动终止支持或删除 CI。插件 `0.3.1` 退役 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.0`,不能安装本候选。按[DSH → 插件](docs/support-history.zh-CN.md#by-dsh)或[插件 → DSH](docs/support-history.zh-CN.md#by-plugin)查询历史声明、报告与分发事实;两份支持规范保留前一发布的记录,本候选事实以本文和历史表为准。
28
+ Legacy 版本在明确发布退役版本前继续支持,详见[支持规范](docs/support-policy.zh-CN.md)。更新版本可通过能力检查后加载,但不在上述精确兼容声明内。
30
29
 
31
- 八版均使用同一入口配置,支持具体 IPv4/IPv6、原生 HTTP/HTTPS、CLI `--public-url`,最终公开根地址写入模型运行时上下文与 `DSH_WEB_URL`。模型 Web 提示各段不应重复公开 URL 或泄露 token。原生能力与保留适配见[兼容维护清单](docs/legacy-compatibility.zh-CN.md)。
30
+ 插件 `0.3.4` 因新解析 SDK 导致原生设置更新失败,已退役 DSH `0.2.2-alpha.2`。请升级至 `0.2.2-alpha.3`;插件 `0.3.3` 的历史支持声明不能修复该宿主依赖组合。详见[退役例外](docs/support-policy.zh-CN.md#upstream-failure-exception)。
32
31
 
33
- 后续版本按范围向前准入,仍须通过 WebServer/Connection API、宿主包身份和原生认证交换检查;准入不构成逐版支持或实测声明。八版始终运行 CLI/smoke,全量、手动、定时及发布计划运行八版完整 browser,并独立验证退役边界 `0.2.1-alpha.2` 的拒绝路径。普通低风险计划使用[固定 browser 选择](docs/development.zh-CN.md#普通与全量-ci-计划),不运行真实旧宿主负向任务。
34
-
35
- ## 安装候选归档
36
-
37
- `0.3.2` 尚未发布。先按[开发指南](docs/development.zh-CN.md)构建并验证本地归档,再安装该文件。已发布 `0.3.1` 保留历史七版支持,不包含本次新版宿主适配。
32
+ ## 安装
38
33
 
39
34
  ```sh
40
35
  dsh --version
41
- dsh plugin --profile web add ./artifacts/dsh-auth-remote-0.3.2.tgz
36
+ dsh plugin --profile web add dsh-auth-remote@0.3.4
42
37
  dsh plugin --profile web list
43
38
  ```
44
39
 
45
- 确认 `dsh --version` 输出推荐的 `0.2.2-alpha.2`,且插件列表中有 `dsh-auth-remote@0.3.2`。这些命令使用 DSH 默认数据目录;隔离开发运行时参见[开发指南](docs/development.zh-CN.md)。
40
+ 发布工作流成功发布该版本后使用此 npm 命令;离线安装时替换为已验证发布归档的绝对路径。已发布 `dsh-auth-remote@0.3.3` 保留其九版宿主声明。安装、初始化和运行服务须使用相同的数据目录及 profile。这些命令使用 DSH 默认的 `~/.dsh` 目录和 `web` profile。升级前先在独立 profile 演练,按[备份与回滚步骤](docs/deployment.zh-CN.md#备份恢复与变更)操作。
46
41
 
47
- ## 配置 web profile
42
+ ## 初始化账号
48
43
 
49
- 最小安装无需修改 profile 补丁。用 `dsh web --no-open --port 13090` 启动,使用终端打印的 `http://127.0.0.1:13090/` 根地址。未显式设置 `publicUrl` 时,插件根据监听的实际协议、地址和绑定端口生成唯一根地址,包含 `--port 0` 的实际结果。未登录导航跳转登录页;使用服务前检查 `/auth-remote/ready`。启动输出包含监听地址和一个不同的公开根地址,不含原生 `?token=` URL。
44
+ 在真实交互终端中执行:
50
45
 
51
- 公网 HTTPS 入口请使用[部署指南](docs/deployment.zh-CN.md)和 [profile 示例](examples/web-profile-auth-remote.patch.yml),设置顶层 `publicUrl: https://dsh.example.com/`、`host`、`port`。全部八个支持版本还支持具体 IPv6 和成对的顶层 `tlsCert`/`tlsKey`。URL 必须是 HTTP(S) 根地址,不能带凭据、子路径、查询或片段。准入范围是唯一公开来源加字面回环。配置 URL 不会配置代理路由或 TLS。
46
+ ```sh
47
+ dsh plugin --profile web exec dsh-auth-remote init
48
+ ```
52
49
 
53
- 插件自动将定稿的原生桥接 authority 登记到 Connection 的 `trustedHosts`,下游插件无需额外 `--trusted-host` 即可识别具体监听地址。下游路由若需要原始公网 Host,可把路径加入 `preserveOriginPaths`,此时也自动登记最终公开 authority。显式 CLI trusted hosts 继续保留,外层公开来源与登录校验仍然生效。CLI 的 host/port 和公开 URL 覆盖文件值;TLS 按完整一对覆盖。升级 `allowedOrigins` 前阅读[迁移和路径规则](docs/deployment.zh-CN.md#配置优先级与路径基准):零项或单项在内存迁移并告警,多项及任意显式新旧字段共存报错。
50
+ 输入一个用户名和 12–256 个 Unicode 字符的密码。密码不会回显,也不作为命令行参数传递。账号只能通过 CLI 创建。
54
51
 
55
- ## 初始化账号
52
+ 默认 `requireTotp: false`,首次密码登录可选择绑定或跳过 TOTP;设为 `true` 可强制绑定。显示十个备用码时立即妥善保存:每个只能用一次,之后不能重新查看列表。
56
53
 
57
- 在真实交互终端中,使用与服务**相同**的默认 `web` profile:
54
+ ## 配置 web profile
55
+
56
+ 最小化本机配置无需修改 profile 补丁:
58
57
 
59
58
  ```sh
60
- dsh plugin --profile web exec dsh-auth-remote init
59
+ dsh web --no-open --port 13090
61
60
  ```
62
61
 
63
- 输入一个用户名和 12–256 个 Unicode 字符的密码。密码不作为命令行参数传递,也不会回显。未初始化时登录页会提示该命令,但网页不能创建账号。默认 `requireTotp: false`,首次密码登录可选择绑定或跳过;设为 `true` 可强制绑定。升级仅在未显式配置时采用新默认值,已有 TOTP、备用码与显式 true/false 均保留。显示十个备用码时立即妥善保存:每个只能用一次,之后不能重新查看列表。
62
+ 打开终端打印的 `http://127.0.0.1:13090/` 地址。未登录导航会跳转登录页。未显式设置 `publicUrl` 时,插件根据监听的实际地址、协议和绑定端口生成根地址。`/auth-remote/ready` 用于检查服务是否就绪。
63
+
64
+ 公网访问请按[部署指南](docs/deployment.zh-CN.md)和 [profile 示例](examples/web-profile-auth-remote.patch.yml)配置顶层 `publicUrl: https://dsh.example.com/`、`host`、`port`,并按示例在 profile 补丁中独立禁用原生 `webserver`。
65
+
66
+ 监听支持具体 IPv4/IPv6 地址、HTTP,以及通过成对 `tlsCert`/`tlsKey` 配置的 HTTPS。`publicUrl` 必须是 HTTP(S) 根地址,不能带凭据、子路径、查询或片段;准入范围是唯一公开来源加字面回环地址。配置此值不会配置路由或 TLS。CLI 的监听和公开 URL 参数覆盖 profile 值。下游路由若需要原始公网 Host,按部署指南配置 `preserveOriginPaths`。
64
67
 
65
68
  ## 登录与账号管理
66
69
 
67
- 最小化安装时访问本机回环地址;配置公网入口后访问 `https://dsh.example.com/auth-remote/login`。DSH 内的安全设置可以修改密码、绑定 TOTP、在策略允许时关闭 TOTP,以及撤销会话。密码或第二因素变更会撤销已有会话。会话默认固定有效 168 小时,服务重启后仍保留。
70
+ 打开本机根地址或配置的公开 URL。在 DSH 侧栏账号菜单中进入 **设置 → 安全与登录**,即可查看本插件用户名、TOTP 状态、会话到期时间和有效会话数,修改密码、绑定或重新绑定 TOTP、在策略允许时关闭 TOTP,以及撤销会话。
68
71
 
69
- 全部八个支持版本从侧栏账号菜单进入 **设置 → 安全与登录**。
72
+ 密码或第二因素变更会撤销已有会话。会话默认固定有效 168 小时(`sessionHours`),服务重启后仍保留。退出当前会话会保留其他会话;退出所有会话需验证密码及已绑定的第二因素。TOTP 绑定成功后仅展示一次备用码,请保存并确认后重新登录。
70
73
 
71
- 登录页引用 DSH 的 PWA manifest,manifest 与 favicon 在登录前即可读取;业务页面和 API 仍需认证。具体范围见[公开资源规则](docs/deployment.zh-CN.md#来源与桥接契约)。
74
+ 也可通过命令管理:
72
75
 
73
76
  ```sh
74
77
  dsh plugin --profile web exec dsh-auth-remote status --json
@@ -77,32 +80,32 @@ dsh plugin --profile web exec dsh-auth-remote reset-totp
77
80
  dsh plugin --profile web exec dsh-auth-remote revoke-sessions
78
81
  ```
79
82
 
80
- 修改命令需要交互确认。在线命令走私有 Unix socket;离线命令取得同一 profile 锁。如果管理请求已提交但响应丢失,先运行 `status` 再判断是否重试。`status --json` 的机器字段不随语言变化。
83
+ 修改命令需要交互确认。命令提交后若响应丢失,先检查 `status`,再决定是否重试。
81
84
 
82
- 内嵌安全页跟随 DSH 语言设置。浏览器文案支持英、中、日、西、法、德、俄和巴西葡萄牙语。独立登录页依次使用 `localStorage["dsh-auth-remote-lang"]`、`navigator.language`、英文,不提供语言选择器;支持的合法语言标签忽略大小写并匹配地区变体;非法或不支持的值依次回退。插件不扩充 DSH 自身的语言选择目录。进入 DSH 后仅按原生 locale 表单已接纳的偏好更新缓存,明确清除偏好时删除缓存;加载中、读取或保存失败时保留,退出也保留。旧 `dsh-auth-remote.locale` 字段不读取、不清理。CLI 文案固定英语;语言环境变量不会改变输出,`--lang` 不再接受。
85
+ 浏览器文案支持英、中、日、西、法、德、俄和巴西葡萄牙语。内嵌页面跟随 DSH 语言设置;独立登录页依次使用已记住的 DSH 偏好、浏览器语言、英文,不提供语言选择器。CLI 文案固定英语。
83
86
 
84
- 安全与登录页面展示本插件用户名、TOTP 状态、本次登录时间、到期时间和有效会话数;时间按当前界面语言及浏览器本地时区显示。修改密码、开启/重新绑定/关闭 TOTP 均在独立任务弹窗完成;强制策略不允许关闭 TOTP。退出当前会话只需确认且保留其他会话,退出所有会话需验证密码及已绑定的第二因素,并包含当前会话。安全修改会撤销所有会话;绑定成功的同一弹窗最后一步仅展示一次备用码,支持复制全部,确认保存后重新登录。此步骤不能用 Esc、遮罩或父设置关闭;离开或刷新后无法恢复。
87
+ DSH `0.2.2-alpha.3` 的原生导航为此页显示盾牌;其余八个声明宿主保留默认图标。
85
88
 
86
89
  ## 登录 DeepSeek 官方账号
87
90
 
88
- 手动回填按 SemVer(包含预发布)从 `>=0.2.1-alpha.3` 前向准入,还须具备必要原生 API 且 `manualAccountLogin: true`。完整功能实测目标为 **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**;未来版本须精确回归后才宣称已验证。账号菜单中的“登录”先打开步骤说明弹窗,不会立即发起授权。点击“打开登录页”,在新标签页完成官方登录;授权后该标签页可能在回环地址显示连接失败或 404。复制地址栏中的完整 URL(包含 `code` 和 `state`),粘贴到“完整回调地址”,再点击“确认登录”。整个过程中保留原 DSH 页面;弹窗被浏览器拦截时,可使用弹窗内的授权链接。
89
-
90
- 在 **设置 → 安全与登录 → 登录配置** 中切换“远程 DeepSeek 账号登录”,默认开启。保存通过原生 Settings 写入当前 profile override,当前页新授权立即采用最新值,重启后保留;保存失败会显示错误。关闭只恢复新授权的原生入口,不取消已接纳的手动授权、不退出已有官方账号,也不承诺原生公网回调可用。其他已打开页面无需主动同步;旧页新建授权会提示关闭并建议刷新。
91
+ 远程 DeepSeek 账号登录默认开启(`manualAccountLogin: true`):
91
92
 
92
- 手动回填无需本地监听器、SSH 隧道或浏览器扩展。回环地址用于承载授权结果,页面无需正常打开。插件只解析粘贴的 URL,在 DSH 内部分发回调,保留原生 state 校验、PKCE 兑换与凭据存储,不会请求粘贴的地址。待完成授权绑定发起操作的远程会话,最长有效期为十分钟;关闭弹窗或撤销该会话会取消待完成授权。过期或失败后须重新开始。
93
+ 1. 在账号菜单中选择“登录”,再点击步骤说明弹窗中的“打开登录页”。
94
+ 2. 在新标签页完成官方登录。随后回环地址可能显示连接失败或 404,该页面无需正常打开。
95
+ 3. 复制包含 `code` 和 `state` 的完整回调 URL,粘贴到原 DSH 标签页的“完整回调地址”,再点击“确认登录”。
93
96
 
94
- 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.2-alpha.2` 的弹窗在授权开始前也提供“使用 API Key”,点击后进入原生凭据编辑器,直到保存密钥或用户选择“稍后配置”才结束引导;账号菜单中也保留同一入口。授权进行中时,次要按钮用于取消本次授权。
97
+ 整个过程中保留原 DSH 标签页。弹窗被浏览器拦截时,可使用弹窗内的授权链接。无需本地监听器、SSH 隧道或浏览器扩展;插件在 DSH 内部分发回调,不会请求粘贴的地址。授权十分钟后过期,关闭弹窗或撤销发起授权的会话会取消本次授权;过期或失败后须重新开始。
95
98
 
96
- ## LiveShare 基础兼容
99
+ 授权开始前,“使用 API Key”会打开 DSH 原生凭据编辑器,账号菜单中也有同一入口;授权进行中时,次要按钮用于取消本次授权。
97
100
 
98
- 在 DSH `0.2.2-alpha.2` 中先按原生方式启用 LiveShare、配置 Relay 并完成 Owner 身份登录;本插件不会自动启用分享或改写 Relay 配置。管理员登录与分享查看者使用各自的身份和传输,退出本插件会话不会停止已创建的分享;停止分享仍由原生 LiveShare 管理。
99
-
100
- 本地验证覆盖真实 Host、Owner PKCE 流程、分享 worker、查看页和停止分享,Relay 身份/传输使用本地协议替身。真实 Relay/OAuth、访客模型调用及文件写入体验不属于这些验证结论。
101
+ **设置 → 安全与登录 → 登录配置** 中的开关控制新的手动授权,并保存在 profile 中。关闭后恢复原生登录入口,保留进行中的授权和已有官方账号凭据。原生登录仍要求浏览器能够访问回调地址。
101
102
 
102
103
  ## 接入反向代理
103
104
 
104
- 参见[反向代理指南](docs/reverse-proxy.zh-CN.md)以及 [Nginx](examples/nginx.conf) 或 [Traefik](examples/traefik-dsh.yml) 示例。保留浏览器原始 Host、Origin、WebSocket 升级和流式响应。TLS 可在代理终止;把其精确 HTTPS 根地址设置为 `publicUrl`。保持 DSH 监听私有,且不要缓存认证响应。
105
+ 参见[反向代理指南](docs/reverse-proxy.zh-CN.md)以及 [Nginx](examples/nginx.conf) 或 [Traefik](examples/traefik-dsh.yml) 示例。保留浏览器原始 Host、Origin、WebSocket 升级和流式响应。TLS 可在代理终止;将其精确 HTTPS 根地址设为 `publicUrl`。保持 DSH 监听私有,不要缓存认证响应。
106
+
107
+ 验收目标为 Linux、Node.js 24、Chromium、原生 IPv4/IPv6 HTTP/HTTPS 和既有 Node 转发拓扑。其他平台/浏览器、真实非回环 IPv6 网卡、Nginx/Traefik 二进制及真实外部授权未由这些测试证明。精确边界见部署与开发指南;本地验证与 GitHub Actions、发布分开记录。
105
108
 
106
- ## 项目与维护
109
+ ## 文档
107
110
 
108
- 插件复用 DSH 的 WebServer、Connection、设置 slot、官方工作区浏览与预览。一个账号及其会话存储在 profile 的私有 JSON 文件中;无需独立身份服务。检查和边界参见[开发](docs/development.zh-CN.md)与[部署](docs/deployment.zh-CN.md)。变更记录见[更新日志](CHANGELOG.zh-CN.md);参与项目可阅读[贡献指南](CONTRIBUTING.zh-CN.md)、[发布指南](docs/releasing.zh-CN.md)及 [MIT 协议](LICENSE)。
111
+ [部署指南](docs/deployment.zh-CN.md)介绍配置、profile 备份和运维细节;从源码构建与测试请阅读[开发指南](docs/development.zh-CN.md)。变更见[更新日志](CHANGELOG.zh-CN.md),参与项目请阅读[贡献指南](CONTRIBUTING.zh-CN.md)和[发布指南](docs/releasing.zh-CN.md)。项目采用 [MIT 协议](LICENSE)。
package/dist/client.js CHANGED
@@ -4078,6 +4078,7 @@ __export(index_exports, {
4078
4078
  name: () => name
4079
4079
  });
4080
4080
  module.exports = __toCommonJS(index_exports);
4081
+ var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
4081
4082
 
4082
4083
  // src/client/adapters/dsh.ts
4083
4084
  function isAdministratorPage() {
@@ -6679,6 +6680,13 @@ function apply(ctx) {
6679
6680
  })
6680
6681
  )
6681
6682
  );
6683
+ slots.inject(
6684
+ "settings.section.icon",
6685
+ () => slots.register(
6686
+ { name: "settings.section.icon", id: "security" },
6687
+ ({ size }) => (0, import_react7.createElement)(import_dsh_client_ui_primitives.IconShieldOutlineMedium, { size })
6688
+ )
6689
+ );
6682
6690
  }
6683
6691
  return module.exports; } });
6684
6692
  //# sourceMappingURL=client.js.map