dsh-lan-guard 0.3.0 → 0.3.2

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/README.zh.md CHANGED
@@ -1,146 +1,199 @@
1
1
  <h1 align="center">DSH LAN Guard</h1>
2
2
 
3
- <p align="center">在手机上使用官方 DeepSeek Harness Web 界面——一个局域网内的门禁反向代理,不改动 DSH 自身的回环绑定。</p>
3
+ <p align="center">把桌面 DSH 的官方 Web 界面安全地开放到局域网:带门禁的反向代理 + 默认自签 HTTPS + 手机扫码入口。DSH 自身的回环监听与官方 UI 零改动。</p>
4
4
 
5
5
  <p align="center">
6
- <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>
7
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
+ <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.1.7--rc.2-4B6BFB" alt="DSH 0.1.7-rc.2">
9
10
  </p>
10
11
 
11
12
  <p align="center"><a href="README.md">English</a> | 中文</p>
12
13
 
13
14
  <p align="center">
14
- <a href="#能力">能力</a> ·
15
- <a href="#安装">安装</a> ·
16
- <a href="#使用">使用</a> ·
15
+ <a href="#能做什么">能做什么</a> ·
16
+ <a href="#快速开始">快速开始</a> ·
17
+ <a href="#设置">设置</a> ·
17
18
  <a href="#兼容性">兼容性</a> ·
18
- <a href="#配置">配置</a> ·
19
- <a href="#排障">排障</a> ·
20
19
  <a href="#安全边界">安全边界</a> ·
21
- <a href="#卸载">卸载</a> ·
22
- <a href="#开发">开发</a>
20
+ <a href="#排障">排障</a> ·
21
+ <a href="CHANGELOG.md">更新记录</a>
23
22
  </p>
24
23
 
25
- > DSH LAN Guard 是 DeepSeek Harness 的社区插件。它**不修改 DSH 核心**、**不改动 DSH 自身的监听地址**,并**原样复用官方 Web UI**。
24
+ > DSH LAN Guard 是 DeepSeek Harness 社区插件。它只注册官方设置页里的一个区块(`settings.section`),不替换任何官方布局,也不修改 DSH 源码或 DSH 自身的监听绑定。
26
25
 
27
- DSH 的 Web 界面只监听 `127.0.0.1`,手机、平板无法访问;而 DSH 官方明确拒绝绑定 `0.0.0.0`。本插件不碰那个绑定,而是另开一个**带门禁的端口**,把官方界面代理到局域网:密码门禁、默认自签 HTTPS、手机扫码入口,以及可逐个吊销的设备配对。
26
+ DSH 的 Web 界面只监听 `127.0.0.1`,而官方明确拒绝绑定 `0.0.0.0`。本插件不碰那个绑定,而是在另一个端口上再开一个**带门禁的**监听,把官方界面原样代理出去:密码门禁、默认自签 HTTPS、手机扫码入口,以及可逐个批准与拉黑的设备配对。**装完重启一次即可用**——不需要手写任何配置。
27
+
28
+ <p align="center">
29
+ <img src="./assets/settings-access.png" width="78%" alt="设置 → 局域网访问 → 扫码访问:运行中状态、免密链接与可扫描二维码">
30
+ </p>
28
31
 
29
- ## 能力
32
+ ## 能做什么
30
33
 
31
- - **门禁反向代理**:完整转发 HTTP 与 WebSocket(含官方界面的 `/api/remote.mux` 长连接),改写 `Host`/`Origin`,剥离逐跳头,上游不可达时返回 `502`。
32
- - **密码门禁**:PBKDF2-SHA256(600,000 次迭代);**访问密码**(手机等访客)与**管理密码**(本管理台)分离;`dsh_` 免密链接;持久访客会话;按 IP 锁定与 CSRF 校验。
33
- - **默认自签 HTTPS**:自动生成 `DSH LAN Guard CA`,按所选网卡地址签发叶证书;CA 身份跨重启不变,所以每台设备只需信任一次。
34
- - **本机永不锁定**:直连 `127.0.0.1` 物理免锁;远程访问按 `auth.adminPolicy` 处理——只读(默认)、需密码解锁、或不锁。
35
- - **设备配对**:远程设备通过门禁后自己命名一次,获得 HttpOnly 设备身份 cookie,出现在设置页(名称 / 创建时间 / 最近使用 / 来源 IP),可逐个吊销;被吊销的设备立刻收到 `403`。
34
+ - **门禁反向代理**:完整转发 HTTP 与 WebSocket(含官方界面的 `/api/remote.mux` 长连接),改写 `Host`/`Origin`,剥离逐跳头,上游不可达时返回 `502`。DSH 自身的绑定与配置一动不动。
35
+ - **默认对外可用,但对外可达 ≠ 可以进入**:默认监听 `0.0.0.0`,所以安装后**只需重启一次**就能用;门禁默认开启,**未设访问密码时拒绝所有设备**,且默认自签 HTTPS——不存在明文传输。想只在本机使用,在设置页切到「仅本机」即可。
36
+ - **双密码门禁**:PBKDF2-SHA256(600,000 次迭代)。**访问密码**给手机等访客设备登录用,**管理密码**用于解锁本设置页的管理台(未设置时退回访问密码);另有 `dsh_` 免密链接、持久访客会话、按 IP 锁定与 CSRF 校验。
37
+ - **默认自签 HTTPS,CA 身份跨重启不变**:自动生成 `DSH LAN Guard CA`,按所选网卡地址签发叶证书。换 IP 只重签叶证书,所以每台设备只需信任一次。
38
+ - **本机永不锁定**:直连 `127.0.0.1` 享有物理免锁特权(能用这台电脑的人本就能改这些设置);远程访问按 `adminPolicy` 处理——只读(默认)、需密码解锁、或不锁。
39
+ - **设备配对与永久拉黑**:手机首次通过门禁时自己命名一次,获得 HttpOnly 设备身份 cookie,出现在 **已授权设备** 里(名称 / 创建时间 / 最近使用 / 来源 IP),可逐个「吊销并拉黑」。拉黑不依赖设备指纹——换浏览器用密码重新配对也会被拒,「解除拉黑」是唯一的恢复方式。
36
40
  - **设置挂在官方设置页内**:「局域网访问」分区含四个 tab——扫码访问、安全认证、已授权设备、连接与证书。排版与配色全部使用官方设计 token,**不替换任何官方布局**。
37
- - **端口可配置**:默认 `3081`(DSH 端口 + 1),被占用时自动往后顺延(最多试 10 个),设置页可改并带可用性检查。
41
+ - **端口与监听范围可配**:默认 `3081`(DSH 端口 + 1),被占用时自动往后顺延(最多试 10 个);设置页可改端口并带可用性检查,也可在「局域网(默认)/ 仅本机」之间切换(两者都需重启 dsh 生效)。
38
42
  - **可选 mDNS**:默认关闭;开启后广播 `_dsh-lan-guard._tcp`。
43
+ - **升级检测**:设置页显示「当前版本 → npm 上最新版本」并给出可复制的升级命令;插件**不会自己安装或重启任何东西**。
39
44
 
40
- ## 安装
45
+ ## 快速开始
46
+
47
+ 环境要求:
48
+
49
+ - 带 Web profile 的 DeepSeek Harness
50
+ - Node.js 20 或更新
51
+ - 已验证的 DeepSeek Harness:`0.1.7-rc.2`
52
+
53
+ 从 npm 安装:
41
54
 
42
55
  ```sh
43
- dsh plugin --profile web add dsh-lan-guard
56
+ dsh plugin --profile web add dsh-lan-guard@latest
44
57
  ```
45
58
 
46
- 然后**重启一次 DSH**(插件的服务端半边在启动时加载),打开 **设置 → 局域网访问**。
59
+ 从 GitHub 安装:
47
60
 
48
- ## 使用
61
+ ```sh
62
+ dsh plugin --profile web add "github:idoall/dsh-lan-guard"
63
+ ```
49
64
 
50
- 1. 在 **设置 → 局域网访问 → 安全认证** 里设置**访问密码**(至少 8 位)。没设之前,门禁拒绝所有设备。
51
- 2. 在 **连接与证书** 里选择对外公布的网卡。配置后默认监听 `0.0.0.0`;想先本机试跑就把配置里的 `listenHost` 设为 `127.0.0.1`。
52
- 3. 打开 **扫码访问** tab,用手机扫描二维码。
53
- 4. 手机上:信任 `DSH LAN Guard CA` 证书(SHA-256 指纹在设置页可复制)、输入一次访问密码,然后在**配对页**给这台设备起个名字。
54
- 5. 手机现在运行的就是官方 DSH 界面。它会出现在 **已授权设备** 里,你可随时吊销。
65
+ 从本地克隆安装:
55
66
 
56
- > 远程设备默认是**只读**的(`adminPolicy: local_only`):能用 DSH,但不能改插件设置。想让手机也能管理,在桌面把策略改掉。
67
+ ```sh
68
+ git clone https://github.com/idoall/dsh-lan-guard.git
69
+ cd dsh-lan-guard
70
+ pnpm install && pnpm run build
71
+ dsh plugin --profile web add "link:$(pwd)"
72
+ ```
57
73
 
58
- ## 兼容性
74
+ 然后**重启一次 DSH**,打开 **设置 → 局域网访问**。重启后插件已经在对外监听(默认 `0.0.0.0:3081`,自签 HTTPS + 门禁),你只需要:
59
75
 
60
- 当前版本:插件 **`0.1.0`** 已在 DeepSeek Harness **`0.1.7-rc.1`**(最新候选版本)上验证通过。
76
+ 1. 在 **安全认证** 里设置**访问密码**(至少 8 位)。没设之前,门禁拒绝所有设备。
77
+ 2. 在 **连接与证书** 确认**监听范围**(默认「局域网」),并选择对外公布的网卡——网卡决定二维码/访问地址用哪个 IP、自签证书签哪些地址。
78
+ 3. 在 **扫码访问** 扫码,手机上信任一次 `DSH LAN Guard CA`、输入访问密码、给设备命名。之后手机运行的就是官方 DSH 界面。
61
79
 
62
- ### 插件版本与 DeepSeek Harness 版本的对应
80
+ > 远程设备默认是**只读**的(`adminPolicy: local_only`):能用 DSH,但不能改插件设置。想让手机也能管理,在桌面把策略改掉。
63
81
 
64
- | 插件 | 已验证的 DeepSeek Harness | npm 上 | 这个版本是什么 |
65
- | --- | --- | --- | --- |
66
- | **`0.1.0`** | `0.1.7-rc.1` | `latest` | 首个版本:门禁反向代理、自签 HTTPS、设备配对、设置页、扫码访问 |
82
+ ## 设置
67
83
 
68
- - 声明范围 `>=0.1.7-rc.1 <0.2.0`(`dsh.engines.dsh`),`dsh.compatibility.dshReleases` 记录 `0.1.7-rc.1: compatible`。
69
- - 未列入的 DSH 版本属**未验证**——请自行验证后再使用。
70
- - 需要锁定版本时:
84
+ 设置项集中在 **设置 → 局域网访问** 的四个 tab 里。非敏感开关(`enabled`、`listenPort`、`listenHost`、`networkInterface`、`auth.mode`、`auth.adminPolicy`、`auth.adminProtection`、`auth.allowLoopback`、`auth.requirePairing`、`auth.requireApproval`)可直接改;`listenPort` 与 `listenHost` 需重启 dsh 生效;`dataDir` 与 `tls.*` 属启动期字段,需在 profile patch 里改。
71
85
 
72
- ```sh
73
- dsh plugin --profile web add dsh-lan-guard@0.1.0
74
- ```
86
+ | 设置项 | 默认 | 作用 |
87
+ | --- | --- | --- |
88
+ | 监听范围 | **局域网 `0.0.0.0`** | 决定局域网能否访问这个端口。切到「仅本机 `127.0.0.1`」更保守,需重启 dsh。两种选择都保留门禁与自签 HTTPS。 |
89
+ | 代理端口 | **3081** | DSH 端口 + 1;被占用时自动往后顺延(最多试 10 个),带可用性检查。需重启 dsh。 |
90
+ | 对外公布的网卡 | 自动选择 | 决定二维码/访问地址用哪个 IP、自签证书签哪些地址;虚拟网卡会被降权标注。 |
91
+ | 验证模式 | **扫码免密 + 密码** | 也可选「仅密码」或「仅安全 Token」。切换会**吊销所有已有访客会话**。 |
92
+ | 访问密码 | 未设置 | 手机等访客设备的登录密码。**未设置时门禁拒绝所有设备**。 |
93
+ | 管理密码 | 未设置 | 解锁本设置页的管理台;未设置时退回访问密码。 |
94
+ | 本机回环访问免密 | **开** | `127.0.0.1` 直连跳过门禁(物理免锁)。 |
95
+ | 新设备需要命名确认 | **开** | 新设备首次通过门禁时要自己命名一次,之后才出现在设备列表里。 |
96
+ | 新设备需要管理员批准 | 关 | 开启后,命名完还要你在设备列表点「批准」才能进入。 |
97
+ | TLS | **自签 HTTPS** | 关闭会明文传输门禁密码;非回环 + 关闭 TLS 必须显式设置 `tls.allowInsecureLan: true`,否则**拒绝启动**。 |
75
98
 
76
- ## 配置
99
+ <p align="center">
100
+ <img src="./assets/settings-connection.png" width="78%" alt="连接与证书:监听范围「局域网(默认)/ 仅本机」开关、代理端口与可用性检查、网卡选择">
101
+ </p>
77
102
 
78
- 插件从它的 Cordis 条目读取配置(profile patch 或 `dsh plugin` 配置)。默认值保守:**你不开口,它不对外公布。**
103
+ 插件从它的 Cordis 条目读取配置。**所有字段都有可用默认值,装完即可用**:
79
104
 
80
105
  ```yaml
81
- enabled: true # 总开关
82
- listenHost: 0.0.0.0 # 默认 127.0.0.1(仅回环);要面向局域网需显式设置
83
- listenPort: 3081 # DSH 端口 + 1;被占用时自动顺延(最多 10 个)
84
- upstreamOrigin: http://127.0.0.1:3080
85
- dataDir: ~/.dsh/profiles/web/data/dsh-lan-guard
86
- networkInterface: en0 # 可选:只在一个网卡上公布(留空 = 自动)
87
- tls:
88
- mode: self-signed # 'self-signed'(默认)| 'provided' | 'off'
89
- allowInsecureLan: false # 局域网明文 HTTP 的显式风险确认
90
- mdns:
91
- enabled: false # 广播 _dsh-lan-guard._tcp
92
- auth:
93
- mode: token_and_password # 'token_and_password' | 'password' | 'token'
94
- adminPolicy: local_only # 'local_only'(默认)| 'password_unlock' | 'open'
95
- adminProtection: true # 管理台需要管理密码
96
- allowLoopback: true # 127.0.0.1 访客跳过门禁(物理免锁)
97
- requirePairing: true # 新的远程设备必须先命名一次
106
+ # ~/.dsh/profiles/web/cordis.patch.yml(可选:只写你想改的字段)
107
+ - id: dsh-lan-guard
108
+ config:
109
+ listenHost: 0.0.0.0 # 默认面向局域网;'127.0.0.1' = 仅本机,或写具体网卡 IP
110
+ listenPort: 3081 # DSH 端口 + 1;被占用时自动顺延
111
+ networkInterface: en0 # 可选:只在一个网卡上公布(留空 = 自动)
112
+ dataDir: ~/.dsh/profiles/web/data/dsh-lan-guard # 可选;缺省即用这个推导路径
113
+ tls:
114
+ mode: self-signed # 'self-signed'(默认)| 'provided' | 'off'
115
+ allowInsecureLan: false # 局域网明文 HTTP 的显式风险确认
116
+ mdns:
117
+ enabled: false # 广播 _dsh-lan-guard._tcp
118
+ auth:
119
+ mode: token_and_password # 'token_and_password' | 'password' | 'token'
120
+ adminPolicy: local_only # 'local_only'(默认)| 'password_unlock' | 'open'
121
+ adminProtection: true # 管理台需要管理密码
122
+ allowLoopback: true # 127.0.0.1 访客跳过门禁(物理免锁)
123
+ requirePairing: true # 新的远程设备必须先命名一次
98
124
  ```
99
125
 
100
- 以上各项也可在设置页修改(非敏感项声明为 volatile 配置字段)。
126
+ `dataDir` 是唯一需要解释的一项:**不写就用** `<当前 profile>/data/dsh-lan-guard`(例如 `~/.dsh/profiles/web/data/dsh-lan-guard`),**写了就优先用你写的**(支持 `~` 前缀)。它只影响插件私有数据(密码哈希、设备令牌哈希、会话、自签 CA)的落点,不影响可用性。
101
127
 
102
- ## 设备批准与永久拉黑
128
+ <p align="center">
129
+ <img src="./assets/settings-security.png" width="78%" alt="安全认证:验证模式三选一、访问密码与管理密码设置、本机回环免密开关">
130
+ </p>
103
131
 
104
- 已配对的设备列在 **设置 → 局域网访问 → 已授权设备**,分三组:**待批准 / 已授权 / 已拉黑**。
132
+ <p align="center">
133
+ <img src="./assets/settings-devices.png" width="78%" alt="已授权设备:命名确认与管理员批准开关,以及可吊销并拉黑的设备列表">
134
+ </p>
105
135
 
106
- - 打开 **「新设备需要管理员批准」**(默认关闭)后,新配对的设备需要你点「批准」才能进入;等待期间手机上显示「等待管理员批准」页。
107
- - **「吊销并拉黑」** 会让该设备**永久失效**:身份被拒绝,换浏览器用访问密码重新配对也会被拒;**「解除拉黑」是唯一的恢复方式**。
108
- - 这里刻意**不使用设备指纹**(换浏览器或升级系统就会失效)——由你决定,且决定是持久的。
136
+ ## 兼容性
109
137
 
110
- ## 升级
138
+ 当前版本:插件 **`0.3.2`** 已在 DeepSeek Harness **`0.1.7-rc.2`** 上验证。
111
139
 
112
- 设置页会显示「当前版本 → npm 上最新版本」,并给出**可复制**的升级命令:
140
+ | 插件 | 已验证的 DeepSeek Harness | 这个版本是什么 |
141
+ | --- | --- | --- |
142
+ | **`0.3.2`** | **`0.1.7-rc.2`**、`0.1.7-rc.1` | 装完即用:默认对外监听 + `dataDir` 自动推导;设置页液体玻璃与官方尺寸;访问地址改为单行滚动 |
143
+ | **`0.3.1`** | **`0.1.7-rc.2`**、`0.1.7-rc.1` | 针对 `0.1.7-rc.2` 的验证版:代码零改动,只更新兼容元数据 |
144
+ | `0.3.0` | `0.1.7-rc.1` | 设备批准与永久拉黑;修掉打开分享的 `?auth=` 链接时的空白页 |
145
+ | `0.2.0` | `0.1.7-rc.1` | 升级检测;移除右下角状态胶囊;间距修复 |
146
+ | `0.1.1` | `0.1.7-rc.1` | 文档版:中英双语用户 README |
147
+ | `0.1.0` | `0.1.7-rc.1` | 首个版本:门禁反向代理、自签 HTTPS、设备配对、设置页、扫码访问 |
113
148
 
114
- ```sh
115
- dsh plugin --profile web add dsh-lan-guard@latest
116
- ```
149
+ - 声明范围 `>=0.1.7-rc.1 <0.2.0`(`dsh.engines.dsh`);未列入的 DSH 版本属**未验证**,请自行验证后再使用。
150
+ - 本插件用到的宿主/客户端接口:`webServer.register` / `indexTaps`、`connection.requestRejection`、`connection.authenticatedUrl`、追加型 `settings.section` seat、`@deepseek-ai/schemastery`,以及 `profileContext`(用于推导默认数据目录)。
151
+ - **破坏性默认值变更(`0.3.2` 起)**:`listenHost` 默认由 `127.0.0.1` 改为 `0.0.0.0`,装完重启一次即可用;`0.3.1` 及更早默认仅回环。门禁与自签 TLS 的默认值未变(未设密码仍拒绝所有设备)。详见 [CHANGELOG](CHANGELOG.md)。
152
+
153
+ 官方 UI 零改动复用,手机视口下自动适配:
154
+
155
+ <p align="center">
156
+ <img src="./assets/mobile.png" width="30%" alt="390px 手机视口下的官方 DSH 界面:插件只做代理,界面由官方原样提供">
157
+ </p>
158
+
159
+ ## 安全边界
117
160
 
118
- 本插件**不会自己安装任何东西,也不会重启 DSH**——命令由你执行,执行后手动重启一次 dsh。检测只访问公开的 npm registry,结果缓存 6 小时;连不上时只在界面上提示,不影响门禁与代理。
161
+ - DSH 自身的监听地址不被改动;本插件从不修改 DSH 配置、会话数据或官方 UI。
162
+ - **门禁先于监听**:监听器只在门禁对象构造完成之后才打开。默认对外监听之所以可接受,是因为 `auth.enabled` 默认为真、**未设访问密码时门禁拒绝所有非回环设备**、且 TLS 默认自签——三者必须同时成立。
163
+ - 密钥(`secrets.json`、`devices.json`、会话)存放在 `dataDir`,权限 `600`;密码只存 PBKDF2-SHA256 哈希,设备令牌明文只返回一次,落盘只存 SHA-256 哈希,**免密链接的 token 不写日志**。
164
+ - 代理给每个转发请求打上不可伪造的来源标记,宿主据此区分「本机操作者」与「经代理的访客」。
165
+ - 回环直连**按设计物理免锁**——能使用这台电脑的人本就能改这些设置。
166
+ - 访问密码是**共享**的:吊销设备会立即让该设备的身份 cookie 失效,但换个浏览器用密码仍可重新配对。要「同一台机器永久拉黑」需要设备指纹或每设备独立令牌,本项目刻意不用指纹。
167
+ - 只面向局域网:不做公网隧道、不做 IM Bot、不做端口转发。
168
+ - 插件自己**不安装、不重启、不推送**任何东西:升级命令由你复制执行。
119
169
 
120
170
  ## 排障
121
171
 
122
- **手机提示证书不受信任。** CA 是自签的:每台设备安装/信任一次 `DSH LAN Guard CA`。信任前先比对 **连接与证书** 里显示的指纹。
172
+ **手机提示证书不受信任。** CA 是自签的:每台设备安装/信任一次 `DSH LAN Guard CA`。信任前先比对 **连接与证书** 里显示的 SHA-256 指纹。
173
+
174
+ **手机完全连不上。** 确认手机在同一网络、地址与二维码一致,并检查是否有 VPN 或「专用代理/中继」类功能拦截流量;也确认 **监听范围** 没有被切成「仅本机」。
123
175
 
124
- **手机完全连不上。** 确认手机在同一网络、地址与二维码一致,并检查是否有 VPN 或「专用代理/中继」类功能拦截流量。设置页会显示监听器**实际绑定**的地址。
176
+ **设置页显示「端口已对局域网开放,但尚未设置访问密码」。** 这是预期的中间状态:端口可达,但门禁拒绝所有设备,不会泄露数据。去 **安全认证** 设一个访问密码即可。
125
177
 
126
178
  **「配置的端口 X 已被占用,已自动改用 Y」。** 端口被别的程序占着,插件已自行顺延。可在 **连接与证书** 换端口(带可用性检查),或释放该端口。
127
179
 
128
- **「此设备已被移除访问权限」(403)。** 该设备已在 **已授权设备** 中被吊销。删除那条记录即可让它重新配对。
180
+ **「此设备已被移除访问权限」(403)。** 该设备已在 **已授权设备** 中被吊销或拉黑。删除那条记录即可让它重新配对(被拉黑的需先「解除拉黑」)。
129
181
 
130
182
  **我忘了访问密码。** 在运行 DSH 的电脑上直连 `http://127.0.0.1:3080`(本机直连物理免锁)重设。无头服务器则删除 `dataDir` 下的 `secrets.json` 后重设——在此之前门禁会拒绝所有设备。
131
183
 
132
184
  **改过密码后所有设备都要重新输密码。** 这是有意的:更换访问密码或切换验证模式会**吊销所有已有访客会话**。
133
185
 
134
- **局域网明文 HTTP 被拒绝。** `listenHost` + `tls.mode: 'off'` 会被拒绝,除非显式设置 `tls.allowInsecureLan: true`——否则门禁密码将明文传输。
186
+ **局域网明文 HTTP 被拒绝。** 非回环 `listenHost` + `tls.mode: 'off'` 会被拒绝,除非显式设置 `tls.allowInsecureLan: true`——否则门禁密码将明文传输。
135
187
 
136
- ## 安全边界
188
+ ## 升级
137
189
 
138
- - DSH 自身的监听地址不被改动;本插件从不修改 DSH 配置或官方 UI。
139
- - 密钥(`secrets.json`、`devices.json`、会话)存放在 `dataDir`,权限 `600`;设备令牌明文只返回一次,落盘只存 SHA-256 哈希。
140
- - 门禁先于监听可用;代理给每个转发请求打上不可伪造的来源标记,宿主据此区分「本机操作者」与「经代理的访客」。
141
- - 回环直连**按设计物理免锁**——能使用这台电脑的人本就能改这些设置。
142
- - 访问密码是**共享**的:吊销设备会立即让该设备的身份 cookie 失效,但换个浏览器用密码仍可重新配对。要「同一台机器永久拉黑」需要设备指纹或每设备独立令牌。
143
- - 只面向局域网:不做公网隧道、不做 IM Bot、不做端口转发。
190
+ 设置页会显示「当前版本 → npm 上最新版本」,并给出**可复制**的升级命令:
191
+
192
+ ```sh
193
+ dsh plugin --profile web add dsh-lan-guard@latest
194
+ ```
195
+
196
+ 插件**不会自己安装任何东西,也不会重启 DSH**——命令由你执行,执行后手动重启一次 dsh。检测只访问公开的 npm registry,结果缓存 6 小时;连不上时只在界面上提示,不影响门禁与代理。
144
197
 
145
198
  ## 卸载
146
199
 
@@ -158,7 +211,18 @@ pnpm run build # 打包 lib/index.js 与 lib/client.js
158
211
  pnpm run verify # 类型检查 + 测试 + 构建 + pack dry-run
159
212
  ```
160
213
 
161
- 设计与验证记录在 [`docs/`](docs/):`SPEC.md`(要做什么)、`PLAN.md`(阶段门禁与逐项验证记录)、`RESEARCH.md`(已核实的 DSH 事实)、`GUARDRAILS.md`(红线)、`RELEASE.md`(发布流程)。
214
+ 客户端半边注册到官方追加型 seat `settings.section`,宿主半边通过包内 `cordis.patch.yml` 挂载。
215
+
216
+ ## 发版
217
+
218
+ 发版由 tag 驱动。更新 `package.json`、把对应 CHANGELOG 段落移出 `Unreleased`、编写带中英双锚点的 `release-notes/v<版本>.md` 后,推送发版提交与 tag:
219
+
220
+ ```sh
221
+ git tag v0.3.1
222
+ git push origin v0.3.1
223
+ ```
224
+
225
+ 发版工作流会校验 tag 与 `package.json` 版本一致、要求发布说明含中英双锚点,然后运行 `pnpm run verify`、打包插件、通过 npm trusted publishing(OIDC)发布,并创建附带 tarball 的 GitHub Release。
162
226
 
163
227
  ## 许可
164
228
 
package/cordis.patch.yml CHANGED
@@ -3,9 +3,10 @@
3
3
  # form — DSH 0.1.7 identifies a form by the Loader entry id, so the `id` below
4
4
  # is the storage namespace and must not change).
5
5
  #
6
- # No config block on purpose: `dataDir` has no safe default (the plugin never
7
- # guesses a profile path — see docs/SPEC.md §5), so a fresh install starts
8
- # inert and logs the exact field to set. Add your own config under this row.
6
+ # No config block on purpose: every field has a working default, so a fresh
7
+ # install is usable as-is — `dataDir` derives to `<profile>/data/dsh-lan-guard`
8
+ # and the listener defaults to the LAN. Add config under this row only to
9
+ # override something (for example `listenHost: '127.0.0.1'` for loopback only).
9
10
  - insert:
10
11
  - id: dsh-lan-guard
11
12
  name: dsh-lan-guard
package/lib/client.js CHANGED
@@ -8,13 +8,13 @@ window.__ModuleLoader__.load({
8
8
  //#region src/client.ts
9
9
  /**
10
10
  * dsh-lan-guard — the browser half: one section inside DSH's OFFICIAL settings
11
- * page (docs/SPEC.md F6).
11
+ * page.
12
12
  *
13
13
  * Hard constraints from the spec, all of them load-bearing:
14
14
  *
15
15
  * - It registers the official `settings.section` seat and replaces NOTHING.
16
16
  * Layout seats (`sidebar`, `rightbar`, `shell.leading`) and layout root
17
- * hooks are out of bounds (docs/GUARDRAILS.md §7).
17
+ * hooks are out of bounds.
18
18
  * - Pure `React.createElement` — no JSX, no extra front-end build step.
19
19
  * - Styles are inline CSS using the official `--dsw-alias-*` variables, so the
20
20
  * light/dark theme follows automatically (dsh-mobile once shipped a
@@ -80,9 +80,33 @@ window.__ModuleLoader__.load({
80
80
  * 12/18, 11/14) and weight (400 regular, 500 strong). Sizes, weights and
81
81
  * line-heights therefore come from the official tokens; only colours use the
82
82
  * official --dsw-alias-* variables, and only the URL box overrides the family
83
- * (with the official code font). See docs/RESEARCH.md §4.2.13.
83
+ * (with the official code font).
84
84
  */
85
- .lg-root{max-width:790px;display:flex;flex-direction:column;gap:18px}
85
+ .lg-root{max-width:790px;display:flex;flex-direction:column;gap:18px;
86
+ /* Liquid Glass (user request 2026-09-26). One material definition, every
87
+ value DERIVED from official tokens through color-mix, so the same rules
88
+ follow the light/dark palette with no theme branch and no invented token
89
+ name (see the 2026-09-24 contrast incident). Each surface below still
90
+ declares its solid token colour FIRST: if color-mix or backdrop-filter is
91
+ unsupported the later declaration is dropped at parse time and the card
92
+ stays a plain, fully legible token surface. */
93
+ --lg-blur:blur(20px) saturate(180%);
94
+ --lg-tint:color-mix(in srgb, var(--dsw-alias-bg-layer-1,#fff) 62%, transparent);
95
+ --lg-tint-soft:color-mix(in srgb, var(--dsw-alias-bg-layer-3,#f1f2f4) 62%, transparent);
96
+ --lg-edge:color-mix(in srgb, var(--dsw-alias-label-primary,#1f2329) 14%, transparent);
97
+ --lg-sheen:linear-gradient(158deg, color-mix(in srgb, #fff 12%, transparent) 0%, transparent 46%);
98
+ --lg-lift:0 10px 30px color-mix(in srgb, #000 20%, transparent),
99
+ inset 0 1px 0 color-mix(in srgb, #fff 30%, transparent),
100
+ inset 0 -1px 0 color-mix(in srgb, #000 7%, transparent);
101
+ position:relative;isolation:isolate}
102
+ /* The light the glass refracts. Scoped to this plugin's own subtree and kept
103
+ at inset:0 so it can never add overflow to the official settings dialog. */
104
+ .lg-root::before{content:'';position:absolute;inset:0;z-index:-1;pointer-events:none;border-radius:24px;
105
+ background:
106
+ radial-gradient(42% 36% at 14% 3%, color-mix(in srgb, var(--dsw-static-deepseek-500,#4176e6) 44%, transparent), transparent 70%),
107
+ radial-gradient(38% 32% at 90% 14%, color-mix(in srgb, var(--dsw-alias-state-business-primary,#1a3f8f) 38%, transparent), transparent 72%),
108
+ radial-gradient(50% 44% at 56% 100%, color-mix(in srgb, var(--dsw-alias-state-success-primary,#1b5e20) 30%, transparent), transparent 74%);
109
+ filter:blur(10px)}
86
110
  /*
87
111
  * Tab bar = the OFFICIAL segmented-control pattern (the 外观 浅色/深色/跟随系统
88
112
  * selector in 通用设置): every item keeps the SAME font and the SAME
@@ -94,14 +118,33 @@ window.__ModuleLoader__.load({
94
118
  .lg-tabs{display:flex;gap:8px;flex-wrap:wrap}
95
119
  .lg-tab{font:var(--dsw-font-s-14,14px/22px sans-serif);cursor:pointer;
96
120
  color:var(--dsw-alias-label-primary,#1f2329);background:transparent;
97
- border:0.5px solid var(--dsw-alias-border-l2,#e5e6eb);border-radius:20px;padding:6px 14px}
121
+ border:0.5px solid var(--dsw-alias-border-l2,#e5e6eb);border-radius:20px;padding:6px 14px;
122
+ backdrop-filter:blur(10px) saturate(150%);-webkit-backdrop-filter:blur(10px) saturate(150%);
123
+ box-shadow:inset 0 1px 0 color-mix(in srgb, #fff 22%, transparent)}
98
124
  .lg-tab[aria-selected=true]{background:var(--dsw-alias-bg-layer-3,#f1f2f4);
99
- border-color:var(--dsw-alias-label-tertiary,#adb2b8)}
125
+ border-color:var(--dsw-alias-label-tertiary,#adb2b8);
126
+ background-image:var(--lg-sheen);box-shadow:var(--lg-lift)}
100
127
  .lg-tabbody{display:flex;flex-direction:column;gap:18px}
101
128
  .lg-card{background:var(--dsw-alias-bg-layer-1,#fff);border:1px solid var(--dsw-alias-border-l2,#e5e6eb);
102
- border-radius:14px;padding:20px}
129
+ border-radius:20px;padding:16px 18px;
130
+ background-color:var(--lg-tint);background-image:var(--lg-sheen);
131
+ border-color:var(--lg-edge);
132
+ backdrop-filter:var(--lg-blur);-webkit-backdrop-filter:var(--lg-blur);
133
+ box-shadow:var(--lg-lift);position:relative}
134
+ /* Specular rim: a 1px gradient edge that is bright where the "light" enters
135
+ and fades away from it — the part of Liquid Glass that reads as glass rather
136
+ than as a plain translucent panel. Masked to the border ring only. */
137
+ .lg-card::after,.lg-choice::after{content:'';position:absolute;inset:0;border-radius:inherit;padding:1px;
138
+ background:linear-gradient(152deg,
139
+ color-mix(in srgb, #fff 55%, transparent) 0%,
140
+ color-mix(in srgb, #fff 8%, transparent) 38%,
141
+ transparent 62%,
142
+ color-mix(in srgb, #fff 22%, transparent) 100%);
143
+ -webkit-mask:linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
144
+ -webkit-mask-composite:xor;mask:linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
145
+ mask-composite:exclude;pointer-events:none}
103
146
  .lg-head{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}
104
- .lg-title{font:var(--dsw-font-base-strong-16,500 16px/24px sans-serif);margin:0;
147
+ .lg-title{font:var(--dsw-font-s-strong-14,500 14px/22px sans-serif);margin:0;
105
148
  color:var(--dsw-alias-label-primary,#1f2329)}
106
149
  .lg-sub{font:var(--dsw-font-xxs-12,12px/18px sans-serif);margin:4px 0 0;
107
150
  color:var(--dsw-alias-label-secondary,#6b7280)}
@@ -109,25 +152,53 @@ window.__ModuleLoader__.load({
109
152
  font:var(--dsw-font-xxs-12,12px/18px sans-serif);white-space:nowrap;
110
153
  background:var(--dsw-alias-state-success-tertiary,#e8f5e9);color:var(--dsw-alias-state-success-primary,#1b5e20)}
111
154
  .lg-pill.off{background:var(--dsw-alias-bg-layer-3,#f1f2f4);color:var(--dsw-alias-label-secondary,#6b7280)}
112
- .lg-bar{display:flex;align-items:center;gap:8px;justify-content:space-between;margin-top:16px;padding:10px 12px;
113
- border-radius:10px;font:var(--dsw-font-xs-13,13px/20px sans-serif);
155
+ .lg-bar{display:flex;align-items:center;gap:10px;justify-content:space-between;flex-wrap:wrap;margin-top:16px;padding:8px 12px;
156
+ border-radius:var(--dsw-radius-md,12px);font:var(--dsw-font-xs-13,13px/20px sans-serif);
114
157
  background:var(--dsw-alias-state-success-tertiary,#e8f5e9);color:var(--dsw-alias-state-success-primary,#1b5e20)}
158
+ /* The notice text shrinks and wraps INSIDE itself; the action keeps its
159
+ intrinsic width and never breaks mid-label (user report 2026-09-26: the
160
+ button read "去设置访 / 问密码"). */
161
+ /* A non-zero basis keeps the text from collapsing to nothing, so a tight
162
+ container wraps the ACTION to its own line instead of squeezing it. */
163
+ .lg-bar>span:first-child{flex:1 1 16ch;min-width:0}
164
+ .lg-bar .lg-btn{flex:0 0 auto;white-space:nowrap;height:32px;padding:0 12px;
165
+ font:var(--dsw-font-xs-13,13px/20px sans-serif);font-weight:400}
115
166
  .lg-bar-compact{margin-top:0;padding:6px 10px}
116
167
  .lg-bar.info{background:var(--dsw-alias-state-business-tertiary,#e8f0fe);color:var(--dsw-alias-state-business-primary,#1a3f8f)}
117
168
  .lg-bar.warn{background:var(--dsw-alias-state-warn-tertiary,#fffbeb);color:var(--dsw-alias-state-warn-label,#92400e)}
118
169
  .lg-bar.danger{background:var(--dsw-alias-interactive-bg-hover-danger,#fef2f2);color:var(--dsw-alias-state-error-primary,#b91c1c)}
119
170
  .lg-mono-sm{font:var(--dsw-font-xxs-12,12px/18px sans-serif)}
120
- .lg-mono{margin-top:14px;padding:10px 12px;border-radius:10px;background:var(--dsw-alias-bg-base,#f1f2f4);
171
+ .lg-mono{margin-top:14px;padding:10px 12px;border-radius:12px;background:var(--dsw-alias-bg-base,#f1f2f4);
121
172
  border:1px solid var(--dsw-alias-border-l2,#e5e6eb);
173
+ background-color:color-mix(in srgb, var(--dsw-alias-bg-base,#f1f2f4) 70%, transparent);
174
+ border-color:var(--lg-edge);
175
+ backdrop-filter:blur(12px) saturate(150%);-webkit-backdrop-filter:blur(12px) saturate(150%);
176
+ box-shadow:inset 0 1px 2px color-mix(in srgb, #000 10%, transparent),
177
+ inset 0 1px 0 color-mix(in srgb, #fff 18%, transparent);
122
178
  font:var(--dsw-font-xs-13,13px/20px sans-serif);
123
179
  font-family:var(--ds-font-family-code,ui-monospace,SFMono-Regular,Menlo,monospace);
124
180
  word-break:break-all;color:var(--dsw-alias-label-primary,#1f2329)}
181
+ /* Copyable values (the access URL, the upgrade command) are SINGLE-LINE fields:
182
+ no hard wrapping, horizontal scrolling instead, so a long URL can no longer
183
+ push the rest of the card down (user request 2026-09-26). Scrolling never
184
+ truncates what you get — the copy button writes the source string, never the
185
+ rendered text — and the thin scrollbar makes "there is more to the right"
186
+ visible. Dragging inside the field selects and auto-scrolls, like a text box. */
187
+ .lg-mono-scroll{white-space:nowrap;overflow-x:auto;overflow-y:hidden;word-break:normal;
188
+ cursor:text;scrollbar-width:thin}
189
+ .lg-mono-scroll::-webkit-scrollbar{height:6px}
190
+ .lg-mono-scroll::-webkit-scrollbar-track{background:transparent}
191
+ .lg-mono-scroll::-webkit-scrollbar-thumb{border-radius:999px;
192
+ background:color-mix(in srgb, var(--dsw-alias-label-tertiary,#adb2b8) 55%, transparent)}
125
193
  .lg-row{display:flex;gap:10px;margin-top:12px}
126
194
  /* auto-fit: two options (TLS) fill the row evenly instead of leaving a third
127
195
  of the row empty, and three options (mode) still fit on one line. */
128
196
  .lg-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(190px,1fr));gap:10px;margin-top:12px}
129
- .lg-choice{text-align:left;cursor:pointer;border-radius:12px;padding:14px;background:var(--dsw-alias-bg-layer-1,#fff);
130
- border:1px solid var(--dsw-alias-border-l2,#e5e6eb);color:inherit}
197
+ .lg-choice{text-align:left;cursor:pointer;border-radius:var(--dsw-radius-md,12px);padding:12px 14px;background:var(--dsw-alias-bg-layer-1,#fff);
198
+ border:1px solid var(--dsw-alias-border-l2,#e5e6eb);color:inherit;
199
+ background-color:var(--lg-tint);background-image:var(--lg-sheen);border-color:var(--lg-edge);
200
+ backdrop-filter:var(--lg-blur);-webkit-backdrop-filter:var(--lg-blur);box-shadow:var(--lg-lift);
201
+ position:relative}
131
202
  .lg-choice[aria-pressed=true]{border:2px solid var(--dsw-static-deepseek-500,#4f46e5);
132
203
  background:var(--dsw-alias-interactive-bg-hover,#eef0ff)}
133
204
  .lg-choice h4{font:var(--dsw-font-s-strong-14,500 14px/22px sans-serif);margin:0 0 6px;
@@ -135,19 +206,30 @@ window.__ModuleLoader__.load({
135
206
  .lg-choice p{font:var(--dsw-font-xxs-12,12px/18px sans-serif);margin:0;
136
207
  color:var(--dsw-alias-label-secondary,#6b7280)}
137
208
  .lg-field{display:flex;flex-direction:column;gap:6px;margin-top:14px}
138
- .lg-label{font:var(--dsw-font-xs-13,13px/20px sans-serif);color:var(--dsw-alias-label-secondary,#6b7280)}
139
- .lg-input{box-sizing:border-box;height:44px;padding:0 12px;border-radius:10px;border:1px solid var(--dsw-alias-border-l2,#d0d3d9);
209
+ .lg-label{font:var(--dsw-font-s-14,14px/22px sans-serif);color:var(--dsw-alias-label-secondary,#6b7280)}
210
+ .lg-input{box-sizing:border-box;height:36px;padding:0 14px;border-radius:var(--dsw-radius-md,12px);border:1px solid var(--dsw-alias-border-l2,#d0d3d9);
211
+ font:var(--dsw-font-s-14,14px/22px sans-serif);
212
+ background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#1f2329);
213
+ background-color:color-mix(in srgb, var(--dsw-alias-bg-base,#fff) 74%, transparent);
214
+ border-color:var(--lg-edge);
215
+ backdrop-filter:blur(12px) saturate(150%);-webkit-backdrop-filter:blur(12px) saturate(150%);
216
+ box-shadow:inset 0 1px 2px color-mix(in srgb, #000 9%, transparent),
217
+ inset 0 1px 0 color-mix(in srgb, #fff 20%, transparent)}
218
+ .lg-btn{box-sizing:border-box;height:36px;padding:0 14px;border:0;border-radius:var(--dsw-radius-md,12px);cursor:pointer;
140
219
  font:var(--dsw-font-s-14,14px/22px sans-serif);
141
- background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#1f2329)}
142
- .lg-btn{box-sizing:border-box;height:44px;padding:0 16px;border:0;border-radius:10px;cursor:pointer;
143
- font:var(--dsw-font-s-strong-14,500 14px/22px sans-serif);
144
220
  /* Brand blue + the official white token (both are official variables): the
145
221
  reference implementation's primary action colour, chosen by the user
146
222
  2026-09-24 over the theme-dependent near-white default. */
147
223
  background:var(--dsw-static-deepseek-500,#4176e6);
148
- color:var(--dsw-static-neutral-bluish-00,#fff)}
224
+ color:var(--dsw-static-neutral-bluish-00,#fff);
225
+ background-image:linear-gradient(180deg, color-mix(in srgb, #fff 22%, transparent), transparent 62%);
226
+ box-shadow:0 6px 18px color-mix(in srgb, var(--dsw-static-deepseek-500,#4176e6) 32%, transparent),
227
+ inset 0 1px 0 color-mix(in srgb, #fff 36%, transparent)}
149
228
  .lg-btn.secondary{background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-primary,#1f2329);
150
- border:1px solid var(--dsw-alias-border-l2,#d0d3d9)}
229
+ border:1px solid var(--dsw-alias-border-l2,#d0d3d9);
230
+ background-color:var(--lg-tint-soft);background-image:var(--lg-sheen);border-color:var(--lg-edge);
231
+ backdrop-filter:blur(12px) saturate(150%);-webkit-backdrop-filter:blur(12px) saturate(150%);
232
+ box-shadow:inset 0 1px 0 color-mix(in srgb, #fff 26%, transparent)}
151
233
  .lg-btn:disabled{opacity:.55;cursor:not-allowed}
152
234
  .lg-btn.full{width:100%}
153
235
  .lg-btn-small{height:28px;padding:0 10px;white-space:nowrap;flex-shrink:0;font:var(--dsw-font-xxs-12,12px/18px sans-serif)}
@@ -163,7 +245,9 @@ window.__ModuleLoader__.load({
163
245
  /* The white plate HUGS the code (fit-content + auto margins) instead of
164
246
  stretching across the card, and the code is a compact 190px — matching the
165
247
  reference implementation's proportions (user feedback 2026-09-24). */
166
- .lg-qr{margin:14px auto 0;padding:10px;border-radius:10px;background:#fff;
248
+ /* Deliberately OPAQUE: a QR code on a translucent plate loses contrast and
249
+ may stop scanning. Never give this rule a glass treatment. */
250
+ .lg-qr{margin:14px auto 0;padding:10px;border-radius:12px;background:#fff;
167
251
  border:1px solid var(--dsw-alias-border-l2,#e5e6eb);width:fit-content}
168
252
  .lg-qr svg{display:block;width:190px;height:190px}
169
253
  .lg-hint{font:var(--dsw-font-xxs-12,12px/18px sans-serif);margin:14px 0 0;
@@ -187,8 +271,11 @@ window.__ModuleLoader__.load({
187
271
  .lg-link{color:var(--dsw-alias-label-secondary,#6b7280);text-decoration:none;
188
272
  font:var(--dsw-font-xxs-12,12px/18px sans-serif)}
189
273
  .lg-link:hover{color:var(--dsw-alias-label-primary,#1f2329)}
190
- .lg-update-panel{margin:0;padding:12px;border-radius:10px;
191
- background:var(--dsw-alias-layer-2,#f1f2f4);border:1px solid var(--dsw-alias-border-l2,#e5e6eb)}
274
+ .lg-update-panel{margin:0;padding:12px;border-radius:var(--dsw-radius-md,12px);
275
+ background:var(--dsw-alias-layer-2,#f1f2f4);border:1px solid var(--dsw-alias-border-l2,#e5e6eb);
276
+ background-color:var(--lg-tint-soft);background-image:var(--lg-sheen);border-color:var(--lg-edge);
277
+ backdrop-filter:blur(14px) saturate(150%);-webkit-backdrop-filter:blur(14px) saturate(150%);
278
+ box-shadow:inset 0 1px 0 color-mix(in srgb, #fff 24%, transparent)}
192
279
  .lg-update-title{font:var(--dsw-font-s-strong-14,500 14px/22px sans-serif);
193
280
  color:var(--dsw-alias-label-primary,#1f2329);margin-bottom:8px}
194
281
  .lg-sec-title{margin:18px 0 2px;font:var(--dsw-font-s-strong-14,500 14px/22px sans-serif);
@@ -197,8 +284,11 @@ window.__ModuleLoader__.load({
197
284
  .lg-chip.wait{background:var(--dsw-alias-state-warn-tertiary,#3a2f16);color:var(--dsw-alias-state-warn-label,#fbbf24)}
198
285
  .lg-chip.ban{background:var(--dsw-static-red-600-a08,#ec13131f);color:var(--dsw-static-red-400,#f25a5a)}
199
286
  .lg-danger{color:var(--dsw-static-red-400,#f25a5a);border-color:var(--dsw-static-red-400,#f25a5a)}
200
- .lg-device{display:block;margin-top:12px;padding:10px 12px;border-radius:10px;
201
- background:var(--dsw-alias-bg-base,#f1f2f4);border:1px solid var(--dsw-alias-border-l2,#e5e6eb)}
287
+ .lg-device{display:block;margin-top:12px;padding:10px 12px;border-radius:var(--dsw-radius-md,12px);
288
+ background:var(--dsw-alias-bg-base,#f1f2f4);border:1px solid var(--dsw-alias-border-l2,#e5e6eb);
289
+ background-color:var(--lg-tint-soft);border-color:var(--lg-edge);
290
+ backdrop-filter:blur(12px) saturate(150%);-webkit-backdrop-filter:blur(12px) saturate(150%);
291
+ box-shadow:inset 0 1px 0 color-mix(in srgb, #fff 22%, transparent)}
202
292
  .lg-device-head{display:flex;align-items:center;justify-content:space-between;gap:12px}
203
293
  .lg-name-chip{display:inline-flex;align-items:center;min-width:0}
204
294
  .lg-device-actions{display:inline-flex;align-items:center;gap:8px;flex-shrink:0}
@@ -484,10 +574,11 @@ window.__ModuleLoader__.load({
484
574
  (0, react.createElement)("div", {
485
575
  className: hasPassword ? "lg-bar" : "lg-bar warn",
486
576
  key: "bar"
487
- }, [(0, react.createElement)("span", { key: "txt" }, hasPassword ? "🛡️ 访问安全认证已生效" : "⚠️ 尚未设置访问密码,门禁不会放行任何设备"), hasPassword ? null : goSecurity]),
577
+ }, [(0, react.createElement)("span", { key: "txt" }, hasPassword ? listener.listenHost === "127.0.0.1" ? "🛡️ 访问安全认证已生效(当前仅本机可访问)" : "🛡️ 访问安全认证已生效" : listener.listenHost === "127.0.0.1" ? "⚠️ 尚未设置访问密码,门禁不会放行任何设备" : `⚠️ 端口已对局域网开放(${String(listener.listenPort)}),但尚未设置访问密码:门禁此刻拒绝所有设备,不会泄露数据;请先设置访问密码`), hasPassword ? null : goSecurity]),
488
578
  (0, react.createElement)("div", {
489
- className: "lg-mono",
490
- key: "url"
579
+ className: "lg-mono lg-mono-scroll",
580
+ key: "url",
581
+ title: scanUrl ?? ""
491
582
  }, scanUrl ?? "—"),
492
583
  (0, react.createElement)("div", {
493
584
  className: "lg-row",
@@ -747,7 +838,7 @@ window.__ModuleLoader__.load({
747
838
  const connectionTab = (0, react.createElement)("div", { className: "lg-tabbody" }, locked ? [lockCard] : [(0, react.createElement)(Card, {
748
839
  key: "connection",
749
840
  title: "连接与证书",
750
- subtitle: "监听端口与传输安全",
841
+ subtitle: "监听范围、端口与传输安全",
751
842
  children: [
752
843
  (0, react.createElement)("div", {
753
844
  className: "lg-mono",
@@ -757,6 +848,38 @@ window.__ModuleLoader__.load({
757
848
  className: "lg-bar warn",
758
849
  key: "port-busy"
759
850
  }, `配置的端口 ${String(listener.configuredPort ?? "?")} 已被占用,已自动改用 ${String(listener.listenPort)}。可在下面改端口,或先关掉占用它的程序。`) : null,
851
+ (0, react.createElement)("div", {
852
+ className: "lg-field",
853
+ key: "scope"
854
+ }, [
855
+ (0, react.createElement)("span", {
856
+ className: "lg-label",
857
+ key: "l"
858
+ }, "监听范围(修改后需重启 dsh 生效)"),
859
+ (0, react.createElement)(ChoiceGrid, {
860
+ key: "g",
861
+ choices: [{
862
+ id: "0.0.0.0",
863
+ title: "局域网(默认)",
864
+ detail: "手机等同网段设备可访问;门禁与自签 HTTPS 全程生效"
865
+ }, {
866
+ id: "127.0.0.1",
867
+ title: "仅本机",
868
+ detail: "只有这台电脑能访问;手机扫码会连不上(更保守)"
869
+ }],
870
+ value: listener.listenHost,
871
+ disabled: busy,
872
+ onPick: (id) => void write({ preferences: { listenHost: id } })
873
+ }),
874
+ listener.listenHost === "0.0.0.0" || listener.listenHost === "127.0.0.1" ? null : (0, react.createElement)("span", {
875
+ className: "lg-label",
876
+ key: "custom"
877
+ }, `当前为自定义监听地址 ${listener.listenHost}(在 profile patch 中设置);选择上面任一项会覆盖它。`),
878
+ listener.listenHost === "127.0.0.1" ? null : (0, react.createElement)("p", {
879
+ className: "lg-hint",
880
+ key: "scope-hint"
881
+ }, "对外可达不等于可以进入:未设访问密码时,门禁拒绝所有设备;已设密码则需通过门禁。若只在固定网卡上公布,可在 profile patch 里把 listenHost 写成该网卡 IP。")
882
+ ]),
760
883
  (0, react.createElement)("div", {
761
884
  className: "lg-field",
762
885
  key: "port"
@@ -919,7 +1042,8 @@ window.__ModuleLoader__.load({
919
1042
  }, `发现新版本 v${String(update.latest)}(当前 v${update.current})`),
920
1043
  (0, react.createElement)("div", {
921
1044
  key: "c",
922
- className: "lg-mono"
1045
+ className: "lg-mono lg-mono-scroll",
1046
+ title: `dsh plugin --profile web add dsh-lan-guard@${String(update.latest)}`
923
1047
  }, `dsh plugin --profile web add dsh-lan-guard@${String(update.latest)}`),
924
1048
  (0, react.createElement)("div", {
925
1049
  className: "lg-row",