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://<本机IP>:3080都先显示全屏登录门，输入口令后才进入；手机竖屏打开时插件自动注入移动端触控适配（大触控目标、16px 输入字号、安全区），界面与桌面端完全一致、实时同步 - ✅ 记住口令（本机）：登录时勾选「记住口令」，口令保存在该设备浏览器 localStorage，下次打开免输；不勾选则只保存在当前标签页（sessionStorage），关闭即失效
- ✅ 设置页（General）「局域网访问」卡片：开关 + 口令设置/清除 + 状态显示
- ✅ 解锁后全部功能可用：设置、权限预设、凭据、预设管理（官方锁定为仅本机的特权方法，通过
/lanapi口令代理通道重新暴露） - ✅ 所有浏览器看到完全相同的对话过程：单一服务进程，会话状态全部在服务端，事件流（
/api/events.muxWebSocket）向每个连接的浏览器推送相同更新
> 💡 最简单的安装方式：告诉DSH，安装 dsh-LAN 插件。
⚠️ 安全说明
- 登录门是界面级防护：不知道口令的人看不到页面内容；特权操作（设置/权限/凭据）在服务端强制口令校验。
- 非特权 API（会话读写等）在 API 层对局域网仍然开放——登录门主要防止「路过的人随手打开页面」。若需要更强的 API 级封锁，需要在受信网络之外关闭局域网开关。
- 仅限可信网络（家庭/办公室内网）使用。公共网络请关闭开关。
移动端（竖屏手机/平板）
- 移动端复用官方桌面界面，不再有独立的远程界面（v48 已删除
/dsh-lan/ui）：手机竖屏打开http://<本机IP>: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 列表。此路径需要重启服务生效。
使用
- 本机打开设置 → General → 「局域网访问」，确认开关已开、防火墙已放行，并设置口令（至少 4 位）；
- 局域网浏览器（桌面或手机/平板）：打开
http://<本机IP>:3080→ 登录门输入口令（勾选「记住口令」可免下次输入）； - 手机竖屏打开时自动启用触控适配（界面与桌面端一致）；侧栏左下角「设置」按钮上方有同款样式的「锁定」按钮，随时退出登录；
- 本机修改口令后，其他设备下次操作会被要求重新登录（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）
