安装
在 DeepSeek Harness 里通过 dsh-market 安装
dsh plugin --profile web add dshmarket
或使用命令行
dsh plugin --profile web add github:TZHR-invest/dsh-plugins#path:/packages/dsh-lan-access
装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。
截图
README
dsh web 局域网访问支持（浏览器端 crypto.randomUUID polyfill + 0.0.0.0 绑定 + 特权围栏放行 + 访问令牌验证）。
适用条件
- 目标机器已安装并运行过 @deepseek-ai/dsh web（首次运行会初始化 ~/.dsh/profiles/web 目录）
- 仅限可信局域网使用：0.0.0.0 会让局域网内任何设备访问本 GUI（可驱动 agent 执行任意命令），切勿暴露公网
- 访问令牌：非本机（回环）请求必须携带令牌，未授权一律 401（登录页）。令牌经明文 HTTP 传输，防的是“未授权设备访问”，不防局域网内嗅探；如需防窃听请再套一层 HTTPS 反向代理
安装步骤（三步）
把本 tarball 拷到目标机器（scp / U 盘均可）：
scp dsh-lan-access-install.tar.gz user@目标机:~/解压：
cd ~ && tar xzf dsh-lan-access-install.tar.gz一键安装并重启验证：
cd dsh-lan-access-install bash install.sh --restart安装时若未配置过令牌，会自动生成随机访问令牌（仅显示一次，请保存），写入 ~/.dsh/lan-access-token（权限 600）。 安装后浏览器访问
http://<目标机IP>:3080会看到令牌登录页；localhost 访问免令牌。
访问令牌
- 令牌文件：
~/.dsh/lan-access-token（单行文本，chmod 600）。修改后保存即生效，无需重启（每次请求实时读取） - 回环（localhost / 127.*）访问豁免令牌，本机不受影响
- 局域网访问方式（任一即可）：
- 浏览器首次访问看到登录页，粘贴令牌进入（自动种 Cookie，30 天有效）
curl -H "X-DSH-Token: <令牌>" http://<IP>:3080/- 浏览器直接访问
http://<IP>:3080/?token=<令牌>（自动种 Cookie） - WebSocket 连接随 Cookie 自动携带，无需额外处理
- 登录表单提交点为
POST /__lan_auth（正确令牌 → 302 + Set-Cookie） - 删除令牌文件 = 关闭门卫（防锁死）；重新生成：删掉文件后重跑
bash install.sh
命令
| 命令 | 作用 |
|---|---|
| bash install.sh | 安装/补齐全部六层（幂等） |
| bash install.sh --check | 只检查状态，不改任何文件 |
| bash install.sh --restart | 安装后重启 dsh web 并 curl 验证 |
它装了什么
| 层 | 内容 | 落点 |
|---|---|---|
| 1 | webserver 绑定 0.0.0.0 | ~/.dsh/cordis.patch.yml |
| 2 | 插件源码 + profile 安装 | |
| 2 | 组合接线 | ~/.dsh/profiles/web/cordis.patch.yml 追加 insert 行 |
| 3 | 访问令牌（回环豁免） | ~/.dsh/lan-access-token（随机生成，600 权限） |
| 4 | 特权围栏放行 | node_modules/@deepseek-ai/dsh-client-connection/lib/index.js 一行补丁 |
| 5 | 设置持久化放行 | node_modules/@deepseek-ai/dsh-client-ui-settings/lib/client.js 一行补丁（settingsScope 强制 host，LAN 也可读写设置） |
| 6 | 令牌门卫（401 登录页 + WS 拦截） | node_modules/@deepseek-ai/dsh-host-webserver/lib/index.js 入口补丁（token-gate.js + patch-webserver.mjs，可 --revert 回滚） |
另外会把 reapply-lan-patches.sh 复制到 ~/.dsh/：以后 dsh 升级/重装后（第 4/5/6 层补丁会被覆盖），跑 bash ~/.dsh/reapply-lan-patches.sh --restart 即可恢复。
验证
- curl http://127.0.0.1:3080/ 应 200（回环豁免）
- curl http://:3080/ 应 401（无令牌，返回登录页）
curl -H "X-DSH-Token: <令牌>" http://<IP>:3080/应 200- 浏览器控制台执行 crypto.randomUUID() 应返回合法 UUID v4
故障排查
- web profile 未初始化：install.sh 提示接线跳过 → 先跑一次
dsh web再重跑bash install.sh - 特权围栏 sed 失败（"代码结构已变化"）→ dsh 版本过新，需人工适配 dsh-client-connection/lib/index.js 中 PRIVILEGED_METHODS 附近的拦截逻辑
- 令牌门卫补丁失败（"未找到锚点"）→ dsh-host-webserver 版本结构变化，需人工适配 patch-webserver.mjs 中的锚点
- 忘记令牌：
cat ~/.dsh/lan-access-token；或删除文件重跑bash install.sh重新生成 - 想关掉令牌验证：
rm ~/.dsh/lan-access-token（门卫自动关闭，回环不受影响）；彻底移除补丁：node ~/.dsh/plugins/dsh-lan-access/patch-webserver.mjs <webserver lib> --revert - 安装后 LAN 仍 403 → 检查 ~/.dsh/cordis.patch.yml 的 webserver 条目是否生效（重启后
ss -ltnp | grep 3080应看到 0.0.0.0:3080 而非 127.0.0.1:3080）