dsh-lan-guard 0.7.6 → 0.7.7

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
@@ -1,5 +1,29 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.7.7] — 2026-10-27(适配 DSH 0.2.1-rc.4)
4
+
5
+ **代码零改动**,只更新兼容声明、开发依赖与发布文档。
6
+
7
+ - `dsh.compatibility.dshReleases` 增加 `0.2.1-rc.4: compatible`;支持范围仍为 `>=0.1.7-rc.1 <0.3.0`(`dsh.engines.dsh`),上界 `<0.3.0` 已覆盖 rc.4,无需放宽。
8
+ - 开发依赖 `@deepseek-ai/dsh-host-webserver`、`@deepseek-ai/dsh-client-connection`、`@deepseek-ai/dsh-scope` 与 `pnpm-lock.yaml` 同步到 `0.2.1-rc.4`,用 rc.4 的真实类型跑检查与回归。
9
+ - 逐包比对了 rc.3 → rc.4 的 npm 产物:本插件用到的宿主/客户端包(webserver、connection、client-ui-renderer/layout/settings/settings-general、scope)**除版本字符串外内容逐字节一致**,DSH CLI 的 `lib` 也完全相同;`dsh-client-ui-settings-general` 的 `client.js` 只改了「设置 → 通用」里显示的 DSH 版本号。因此 rc.4 对插件没有接口或行为变更。
10
+ - 用 rc.4 类型重新构建的 4 个 `lib` 文件(`index.js`、`index.d.ts`、`client.js`、`client.js.map`)与已发布的 `0.7.6` tarball 内文件 **SHA-256 完全相同**,证明改动只落在声明与文档,构建可复现。
11
+ - 运行态核对(本机正在跑的 rc.4 实例;profile 里装的是 `0.7.6`,其 `lib` 与本版逐字节相同):`dsh --profile web --dump-config` exit 0,插件与已存配置正常合成、无拒载或版本豁免标记;局域网入口(`https://<lan>:3081/`)返回 200 且注入了本插件的客户端补丁与 `client.js`;`/plugins/dsh-lan-guard/config` 与 `/devices` 均返回 200 并带回真实数据。
12
+ - 门禁:`pnpm run typecheck` 通过;23 个测试文件、386 项用例全绿;构建与 `npm pack --dry-run` 通过,包内清单与仓库一致。
13
+ - 两版 README 五处同步到 `0.7.7` / `0.2.1-rc.4`:徽章、「已验证的 DeepSeek Harness」、当前版本句、兼容表(新增 latest 行、`0.7.6` 转为 published)、11 个已验证版本的完整清单,发版 tag 示例同步为 `v0.7.7`。
14
+ - 未做:rc.4 的手机/浏览器交互验收(触摸、锁屏、语音)。本版不把 rc.3 的端到端结论冒充成 rc.4 实测。
15
+
16
+ **rc.4 核查结果**:
17
+
18
+ | 检查 | 结果 |
19
+ | --- | --- |
20
+ | npm 产物 rc.3 → rc.4 差异 | 6 个宿主/客户端包仅版本号不同;CLI `lib` 一致;settings-general 仅显示版本字符串 |
21
+ | 类型检查(rc.4 `.d.ts`) | 通过 |
22
+ | 自动回归 | 23 文件 / 386 用例全绿 |
23
+ | 构建可复现 | 4 个 `lib` 文件与 `0.7.6` tarball SHA-256 相同 |
24
+ | `--dump-config` | exit 0,插件在合成树中,无拒载/豁免 |
25
+ | 运行态 | LAN 入口 200、顶部补丁注入、`/config` 与 `/devices` 200 |
26
+
3
27
  ## [0.7.6] — 2026-10-23(适配 DSH 0.2.1-rc.3)
4
28
 
5
29
  插件运行时代码不变;同步兼容声明、开发依赖与发布文档。
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
  <a href="https://github.com/idoall/dsh-lan-guard/actions/workflows/ci.yml"><img src="https://github.com/idoall/dsh-lan-guard/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
7
7
  <a href="https://www.npmjs.com/package/dsh-lan-guard"><img src="https://img.shields.io/npm/v/dsh-lan-guard?label=npm&color=CB3837" alt="npm version"></a>
8
8
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0F172A" alt="MIT"></a>
9
- <img src="https://img.shields.io/badge/DSH-0.2.1--rc.3-4B6BFB" alt="DSH 0.2.1-rc.3">
9
+ <img src="https://img.shields.io/badge/DSH-0.2.1--rc.4-4B6BFB" alt="DSH 0.2.1-rc.4">
10
10
  </p>
11
11
 
12
12
  <p align="center">English | <a href="README.zh.md">中文</a></p>
@@ -49,7 +49,7 @@ Requirements:
49
49
 
50
50
  - DeepSeek Harness with a Web profile
51
51
  - Node.js 20 or newer
52
- - Verified DeepSeek Harness: `0.2.1-rc.3` (API review, type checking and automated regression; phone/browser acceptance on rc.3 is pending).
52
+ - Verified DeepSeek Harness: `0.2.1-rc.4` (API review, type checking and automated regression, plus config load, LAN entry, client injection and management endpoints checked on a running rc.4 instance (running `0.7.6`, whose `lib` is byte-identical to this release); phone/browser interaction acceptance on rc.4 is still pending).
53
53
 
54
54
  Install from npm:
55
55
 
@@ -148,11 +148,12 @@ The plugin reads its config from its Cordis entry. **Every key has a usable defa
148
148
 
149
149
  ## Compatibility
150
150
 
151
- Current version: plugin **`0.7.6`**, compatible with DeepSeek Harness **`0.2.1-rc.3`**. Each row below is one plugin release: the DSH versions it was verified against, and what that release did.
151
+ Current version: plugin **`0.7.7`**, compatible with DeepSeek Harness **`0.2.1-rc.4`**. Each row below is one plugin release: the DSH versions it was verified against, and what that release did.
152
152
 
153
153
  | Plugin | Verified DeepSeek Harness | What this version is |
154
154
  | --- | --- | --- |
155
- | **`0.7.6`** (latest) | **`0.2.1-rc.3`**, `0.2.1-rc.2`, `0.2.1-alpha.5`, `0.2.1-alpha.4`, `0.2.1-alpha.3`, `0.2.1-alpha.1`, `0.2.0-rc.2`, `0.2.0-rc.1`, `0.1.7-rc.2`, `0.1.7-rc.1` | Compatibility release for DSH `0.2.1-rc.3`; no runtime code change. API/type/automated checks only; phone/browser acceptance pending. |
155
+ | **`0.7.7`** (latest) | **`0.2.1-rc.4`**, `0.2.1-rc.3`, `0.2.1-rc.2`, `0.2.1-alpha.5`, `0.2.1-alpha.4`, `0.2.1-alpha.3`, `0.2.1-alpha.1`, `0.2.0-rc.2`, `0.2.0-rc.1`, `0.1.7-rc.2`, `0.1.7-rc.1` | Keeps up with DSH `0.2.1-rc.4`: this upstream release only bumps version strings, and the host interfaces and types are byte-identical to rc.3; no plugin runtime code changed. |
156
+ | **`0.7.6`** (published) | **`0.2.1-rc.3`**, `0.2.1-rc.2`, `0.2.1-alpha.5`, `0.2.1-alpha.4`, `0.2.1-alpha.3`, `0.2.1-alpha.1`, `0.2.0-rc.2`, `0.2.0-rc.1`, `0.1.7-rc.2`, `0.1.7-rc.1` | Compatibility release for DSH `0.2.1-rc.3`; no runtime code change. API/type/automated checks only; phone/browser acceptance pending. |
156
157
  | **`0.7.5`** (published) | **`0.2.1-rc.2`**, `0.2.1-alpha.5`, `0.2.1-alpha.4`, `0.2.1-alpha.3`, `0.2.1-alpha.1`, `0.2.0-rc.2`, `0.2.0-rc.1`, `0.1.7-rc.2` | Keeps up with DSH `0.2.1-rc.2`: compatibility statement only, no code change. |
157
158
  | **`0.7.4`** | **`0.2.1-alpha.5`**, `0.2.1-alpha.4`, `0.2.1-alpha.3`, `0.2.1-alpha.1`, `0.2.0-rc.2`, `0.2.0-rc.1`, `0.1.7-rc.2` | Keeps up with DSH `0.2.1-alpha.5`: compatibility statement only, no code change. |
158
159
  | **`0.7.3`** | **`0.2.1-alpha.4`**, `0.2.1-alpha.3`, `0.2.1-alpha.1`, `0.2.0-rc.2`, `0.2.0-rc.1`, `0.1.7-rc.2` | Keeps up with DSH `0.2.1-alpha.4`: compatibility statement only, no code change. |
@@ -179,7 +180,7 @@ Current version: plugin **`0.7.6`**, compatible with DeepSeek Harness **`0.2.1-r
179
180
  | `0.1.1` | `0.1.7-rc.1` | Documentation release: bilingual user READMEs |
180
181
  | `0.1.0` | `0.1.7-rc.1` | First release: gated reverse proxy, self-signed HTTPS, device pairing, settings page, QR access |
181
182
 
182
- - Declared range `>=0.1.7-rc.1 <0.3.0` (`dsh.engines.dsh`); verified releases: `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.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.2`, `0.2.1-rc.3` (10 releases; the rc.3 verification scope is described above). DSH versions not listed are **unverified** — verify them yourself before use. The upper bound was widened from `<0.2.0` in `0.4.3` because profile load refuses a bundle whose range excludes the running release, and a plain `<0.2.0` would exclude the `0.2.0` stable.
183
+ - Declared range `>=0.1.7-rc.1 <0.3.0` (`dsh.engines.dsh`); verified releases: `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.3`, `0.2.1-alpha.4`, `0.2.1-alpha.5`, `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4` (11 releases; the rc.4 verification scope is described above). DSH versions not listed are **unverified** — verify them yourself before use. The upper bound was widened from `<0.2.0` in `0.4.3` because profile load refuses a bundle whose range excludes the running release, and a plain `<0.2.0` would exclude the `0.2.0` stable.
183
184
  - Host/client interfaces this plugin uses: `webServer.register` / `webServer.tapIndex` (indexTaps), `connection.requestRejection`, `connection.authenticatedUrl`, the additive `settings.section` seat, `@deepseek-ai/schemastery`, and `profileContext` (for deriving the default data directory).
184
185
  - **Breaking default change (from `0.3.2`)**: `listenHost` now defaults to `0.0.0.0` instead of `127.0.0.1`, so one restart after install is enough; `0.3.1` and earlier default to loopback only. The gate and self-signed TLS defaults are unchanged (with no password the gate still refuses every device). See the [CHANGELOG](CHANGELOG.md).
185
186
  - **`0.4.0` verification status**: all three changes carry measurements, not just specs.
@@ -340,8 +341,8 @@ The client half registers into the official additive `settings.section` seat; th
340
341
  Releases are tag-driven. Update `package.json`, move the matching CHANGELOG section out of `Unreleased`, write `release-notes/v<version>.md` with both language anchors, then push the release commit and tag:
341
342
 
342
343
  ```sh
343
- git tag v0.7.6
344
- git push origin v0.7.6
344
+ git tag v0.7.7
345
+ git push origin v0.7.7
345
346
  ```
346
347
 
347
348
  The release workflow checks that the tag matches the `package.json` version and that the notes carry both anchors, then runs `pnpm run verify`, packs the plugin, publishes through npm trusted publishing (OIDC), and creates a GitHub Release with the tarball attached.
package/README.zh.md CHANGED
@@ -6,7 +6,7 @@
6
6
  <a href="https://github.com/idoall/dsh-lan-guard/actions/workflows/ci.yml"><img src="https://github.com/idoall/dsh-lan-guard/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
7
7
  <a href="https://www.npmjs.com/package/dsh-lan-guard"><img src="https://img.shields.io/npm/v/dsh-lan-guard?label=npm&color=CB3837" alt="npm 版本"></a>
8
8
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0F172A" alt="MIT"></a>
9
- <img src="https://img.shields.io/badge/DSH-0.2.1--rc.3-4B6BFB" alt="DSH 0.2.1-rc.3">
9
+ <img src="https://img.shields.io/badge/DSH-0.2.1--rc.4-4B6BFB" alt="DSH 0.2.1-rc.4">
10
10
  </p>
11
11
 
12
12
  <p align="center"><a href="README.md">English</a> | 中文</p>
@@ -49,7 +49,7 @@ DSH 的 Web 界面只监听 `127.0.0.1`,而官方明确拒绝绑定 `0.0.0.0`
49
49
 
50
50
  - 带 Web profile 的 DeepSeek Harness
51
51
  - Node.js 20 或更新
52
- - 已验证的 DeepSeek Harness:`0.2.1-rc.3`(接口审查、类型检查与自动回归;rc.3 的手机/浏览器验收待完成)。
52
+ - 已验证的 DeepSeek Harness:`0.2.1-rc.4`(接口审查、类型检查与自动回归;另在运行 rc.4 的实例上核对配置加载、LAN 入口、客户端注入与管理接口,该实例装的是 `0.7.6`,其 `lib` 与本版逐字节相同。rc.4 的手机/浏览器交互验收仍待完成)。
53
53
 
54
54
  从 npm 安装:
55
55
 
@@ -149,11 +149,12 @@ dsh plugin --profile web add "link:$(pwd)"
149
149
 
150
150
  ## 兼容性
151
151
 
152
- 当前版本:插件 **`0.7.6`**,兼容 DeepSeek Harness **`0.2.1-rc.3`**。下表每行是一个插件版本:它验证过哪些 DSH 版本,以及那一版做了什么。
152
+ 当前版本:插件 **`0.7.7`**,兼容 DeepSeek Harness **`0.2.1-rc.4`**。下表每行是一个插件版本:它验证过哪些 DSH 版本,以及那一版做了什么。
153
153
 
154
154
  | 插件 | 已验证的 DeepSeek Harness | 这个版本是什么 |
155
155
  | --- | --- | --- |
156
- | **`0.7.6`** (latest) | **`0.2.1-rc.3`**、`0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1` | 跟上 DSH `0.2.1-rc.3`,运行时代码不变。仅完成接口、类型与自动检查;手机/浏览器验收待完成。 |
156
+ | **`0.7.7`** (latest) | **`0.2.1-rc.4`**、`0.2.1-rc.3`、`0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1` | 跟上 DSH `0.2.1-rc.4`:上游这次只改版本号,宿主接口与类型与 rc.3 逐字节一致;插件运行时代码不变。 |
157
+ | **`0.7.6`** (published) | **`0.2.1-rc.3`**、`0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1` | 跟上 DSH `0.2.1-rc.3`,运行时代码不变。仅完成接口、类型与自动检查;手机/浏览器验收待完成。 |
157
158
  | **`0.7.5`** (published) | **`0.2.1-rc.2`**、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2` | 跟上 DSH `0.2.1-rc.2`:只更新兼容声明,代码没动。 |
158
159
  | **`0.7.4`** | **`0.2.1-alpha.5`**、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2` | 跟上 DSH `0.2.1-alpha.5`:只更新兼容声明,代码没动。 |
159
160
  | **`0.7.3`** | **`0.2.1-alpha.4`**、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2` | 跟上 DSH `0.2.1-alpha.4`:只更新兼容声明,代码没动。 |
@@ -180,7 +181,7 @@ dsh plugin --profile web add "link:$(pwd)"
180
181
  | `0.1.1` | `0.1.7-rc.1` | 文档版:中英双语用户 README |
181
182
  | `0.1.0` | `0.1.7-rc.1` | 首个版本:门禁反向代理、自签 HTTPS、设备配对、设置页、扫码访问 |
182
183
 
183
- - 声明范围 `>=0.1.7-rc.1 <0.3.0`(`dsh.engines.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.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.2`、`0.2.1-rc.3`(共 10 个版本,rc.3 验证范围见上文)。未列入的 DSH 版本属**未验证**,请自行验证后再使用。上界在 `0.4.3` 从 `<0.2.0` 放宽:profile 加载会拒绝范围不含运行版本的 bundle,而裸的 `<0.2.0` 恰好排除 `0.2.0` 正式版。
184
+ - 声明范围 `>=0.1.7-rc.1 <0.3.0`(`dsh.engines.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.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`(共 11 个版本,rc.4 验证范围见上文)。未列入的 DSH 版本属**未验证**,请自行验证后再使用。上界在 `0.4.3` 从 `<0.2.0` 放宽:profile 加载会拒绝范围不含运行版本的 bundle,而裸的 `<0.2.0` 恰好排除 `0.2.0` 正式版。
184
185
  - 本插件用到的宿主/客户端接口:`webServer.register` / `webServer.tapIndex`(indexTaps)、`connection.requestRejection`、`connection.authenticatedUrl`、追加型 `settings.section` seat、`@deepseek-ai/schemastery`,以及 `profileContext`(用于推导默认数据目录)。
185
186
  - **破坏性默认值变更(`0.3.2` 起)**:`listenHost` 默认由 `127.0.0.1` 改为 `0.0.0.0`,装完重启一次即可用;`0.3.1` 及更早默认仅回环。门禁与自签 TLS 的默认值未变(未设密码仍拒绝所有设备)。详见 [CHANGELOG](CHANGELOG.md)。
186
187
  - **`0.4.0` 的验证状态**:三处改动都做了实测,不只跑用例。
@@ -341,8 +342,8 @@ pnpm run verify # 类型检查 + 测试 + 构建 + pack dry-run
341
342
  发版由 tag 驱动。更新 `package.json`、把对应 CHANGELOG 段落移出 `Unreleased`、编写带中英双锚点的 `release-notes/v<版本>.md` 后,推送发版提交与 tag:
342
343
 
343
344
  ```sh
344
- git tag v0.7.6
345
- git push origin v0.7.6
345
+ git tag v0.7.7
346
+ git push origin v0.7.7
346
347
  ```
347
348
 
348
349
  发版工作流会校验 tag 与 `package.json` 版本一致、要求发布说明含中英双锚点,然后运行 `pnpm run verify`、打包插件、通过 npm trusted publishing(OIDC)发布,并创建附带 tarball 的 GitHub Release。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-lan-guard",
3
- "version": "0.7.6",
3
+ "version": "0.7.7",
4
4
  "description": "DSH web plugin: expose the official desktop Web UI to the local network through a gated reverse proxy, without touching DSH's own loopback binding.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -77,7 +77,8 @@
77
77
  "0.2.1-alpha.4": "compatible",
78
78
  "0.2.1-alpha.5": "compatible",
79
79
  "0.2.1-rc.2": "compatible",
80
- "0.2.1-rc.3": "compatible"
80
+ "0.2.1-rc.3": "compatible",
81
+ "0.2.1-rc.4": "compatible"
81
82
  }
82
83
  }
83
84
  },
@@ -99,8 +100,8 @@
99
100
  ],
100
101
  "devDependencies": {
101
102
  "@deepseek-ai/cordis": "4.0.5",
102
- "@deepseek-ai/dsh-client-connection": "0.2.1-rc.3",
103
- "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.3",
103
+ "@deepseek-ai/dsh-client-connection": "0.2.1-rc.4",
104
+ "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.4",
104
105
  "@deepseek-ai/schemastery": "3.18.5",
105
106
  "@types/node": "^26.2.0",
106
107
  "@types/qrcode": "^1.5.6",
@@ -108,7 +109,7 @@
108
109
  "tsdown": "^0.22.14",
109
110
  "typescript": "^7.0.2",
110
111
  "vitest": "^4.1.11",
111
- "@deepseek-ai/dsh-scope": "0.2.1-rc.3"
112
+ "@deepseek-ai/dsh-scope": "0.2.1-rc.4"
112
113
  },
113
114
  "packageManager": "pnpm@10.33.1"
114
115
  }