MrMu666/dsh-LAN

dsh-LAN

deepseek-harness Web GUI 的局域网访问插件（带口令的全功能版；移动端优化官方界面ui，适配竖屏及触控手势）。

⚠️ 版本要求：支持 DSH 0.1.2-rc.1（@deepseek-ai/dsh）及更新版本（已验证至 0.1.5-rc.1）。旧版 DSH 的 API（dsh-host-apiproxy、点分式端点）已不再兼容，请先升级 DSH。

🚀 配合 DSH-Launcher 与 dsh-app 使用，体验感更好。

安装后，Web GUI 默认绑定 0.0.0.0（所有网卡），并自动放行主机防火墙端口（Windows：Windows Defender 防火墙 Domain + Private；Linux：依次尝试 firewalld / ufw / iptables，无可用防火墙工具时视为无需放行）：

- ✅ 局域网设备先输口令才能看页面：任意设备（桌面或手机/平板）打开 http://:3080 都先显示全屏登录门，输入口令后才进入；手机竖屏打开时插件自动注入移动端触控适配（大触控目标、16px 输入字号、安全区），界面与桌面端完全一致、实时同步
- ✅ 记住口令（本机）：登录时勾选「记住口令」，口令保存在该设备浏览器 localStorage，下次打开免输；不勾选则只保存在当前标签页（sessionStorage），关闭即失效
- ✅ 设置页（General）「局域网访问」卡片：开关 + 口令设置/清除 + 状态显示
- ✅ 解锁后全部功能可用：设置、权限预设、凭据、预设管理（官方锁定为仅本机的特权方法，通过 /lanapi 口令代理通道重新暴露）
- ✅ 所有浏览器看到完全相同的对话过程：单一服务进程，会话状态全部在服务端，事件流（/api/events.mux WebSocket）向每个连接的浏览器推送相同更新

💡 最简单的安装方式：告诉DSH，安装 dsh-LAN 插件。

局域网口令设置

⚠️ 安全说明

- 登录门是界面级防护：不知道口令的人看不到页面内容；特权操作（设置/权限/凭据）在服务端强制口令校验。
- 非特权 API（会话读写等）在 API 层对局域网仍然开放——登录门主要防止「路过的人随手打开页面」。若需要更强的 API 级封锁，需要在受信网络之外关闭局域网开关。
- 仅限可信网络（家庭/办公室内网）使用。公共网络请关闭开关。

移动端（竖屏手机/平板）

- 移动端复用官方桌面界面，不再有独立的远程界面（v48 已删除 /dsh-lan/ui）：手机竖屏打开 http://:3080 时，插件在官方界面之上注入触控适配（紧凑侧栏、≥44px 触控目标、16px 输入字号防 iOS 聚焦缩放、安全区 padding），横屏/桌面视口自动还原。
- 所有能力与桌面端相同：会话/工作区/历史对话/实时聊天/模型与模式切换/任务清单/审批提问/权限切换等，全部与主机实时同步。

移动端交互细节

- 侧边栏：折叠时隐藏，左上角可拖拽小鲸鱼按钮是展开入口（拖拽位置会记住）；点击会话行、点击页面其他区域、或左滑均可收起；对话界面右滑可直接展开侧边栏。
- 输入法：页面加载不自动聚焦输入框；点小鲸鱼不会误弹键盘；Enter 只换行（发送走发送按钮）。
- 界面细节：隐藏官方 Tooltip 气泡残留（收起/发送等黑底提示）；模型提问（ask_user_question）卡片完整适配窄屏（选项 42px 触控目标）；权限/模型两行布局与底部状态栏对齐。
- 局域网特权通道：官方锁定为仅本机的特权调用（设置/凭据等）在网络层自动改写为 /lanapi 口令通道——预设/权限标签在局域网设备上显示正确的本地化名称。

安装（补丁路径，无需重启，推荐）

Windows 11

powershell -ExecutionPolicy Bypass -File install.ps1
可选参数：
powershell -ExecutionPolicy Bypass -File install.ps1 -DshHome C:\Users\me\.dsh -Profile web

Linux / macOS

./install.sh
可选参数：
./install.sh --dsh-home "$HOME/.dsh" --profile web
也可通过环境变量 DSH_HOME 指定（与 dsh 一致）

安装脚本（两个平台等价）会：

- 把插件包复制到 /profiles/node_modules/dsh-LAN（Windows 为 %USERPROFILE%\.dsh\profiles\node_modules\dsh-LAN）
- 把安装块写入 /profiles/web/cordis.patch.yml（绑定 0.0.0.0 + 挂载插件行）
- DSH 对 profile 补丁是热加载的：运行中的服务立即生效，无需重启；刷新浏览器即可看到设置页卡片
- 升级插件代码后需重启 dsh web：node 半边（lib/index.js）在进程内存中，热加载只重载补丁层；客户端 bundle 刷新浏览器即可拿到新版

防火墙说明

- Windows：自动维护 Windows Defender 防火墙放行规则（Domain + Private）；未以管理员身份运行时，设置页会提示「防火墙未放行（需管理员权限）」。
- Linux：自动检测并按 firewalld → ufw → iptables 的顺序维护放行规则；检测不到受支持的防火墙工具时，状态显示「防火墙未由插件管理」，此时端口通常本就无需放行。若检测到防火墙但无 root 权限，同样会提示需要管理员权限。
- 无论哪个平台，关闭「局域网访问」开关都会把绑定回退到 127.0.0.1，这是最根本的安全开关。

安装（bundle 路径，可选）

dsh plugin --profile web add link:
包声明了 dsh.bundle.patch，dsh plugin 会自动把它加入 bundles 列表。此路径需要重启服务生效。

使用

1. 本机打开设置 → General → 「局域网访问」，确认开关已开、防火墙已放行，并设置口令（至少 4 位）；
2. 局域网浏览器（桌面或手机/平板）：打开 http://:3080 → 登录门输入口令（勾选「记住口令」可免下次输入）；
3. 手机竖屏打开时自动启用触控适配（界面与桌面端一致）；侧栏左下角「设置」按钮上方有同款样式的「锁定」按钮，随时退出登录；
4. 本机修改口令后，其他设备下次操作会被要求重新登录（403 自动回登录门）。

卸载

Windows：

powershell -ExecutionPolicy Bypass -File uninstall.ps1

Linux / macOS：

./uninstall.sh
可选：./uninstall.sh --dsh-home "$HOME/.dsh" --profile web --port 3080

移除补丁块、防火墙规则与包副本；热加载生效，无需重启。

多机一致性原理

单一 DSH 服务进程持有全部状态：会话（jsonl 持久化 + 内存投影）、工作区、目标、子代理。所有浏览器只是同一服务的客户端，通过 /api RPC 读写同一状态，通过 /api/events.mux（WebSocket 下行流）接收相同的服务端事件推送。桌面与移动端连接的是同一份状态，任何一端的操作对其他端实时可见。

参考

早期移动端实现参考过 dsh-web-ui 的 dsh-remote-web-ui（独立轻量远程界面 + 令牌门）；v48 起移动端直接复用官方桌面界面（插件注入竖屏适配），口令模型不变（持久口令 + 本机记住 + /lanapi 特权代理）。

许可证

MIT（license: MIT）