MrMu666/dsh-LAN 预览 preview

MrMu666/dsh-LAN

为DeepSeek harness开启局域网访问及移动端页面的插件,移动端界面适配

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds password-protected LAN access to DSH’s built-in Web GUI, plus touch-optimized mobile support for the official DSH interface. It only works with DSH versions 0.1.2-rc.1 and newer, and has been tested up to version 0.1.5-rc.1; older DSH versions are not supported, so users must upgrade DSH before installing. After installation, the Web GUI is bound to all network interfaces by default, and the plugin automatically detects and configures firewall allow rules for Windows and Linux hosts. This lets any device on the same local network connect to and access the DSH interface.

Any LAN-connected device, from desktop laptops to mobile phones and tablets, can connect to DSH at http://<host-ip-address>:3080, and must enter the correct password to access the interface. Users can opt to save the password on their local device via browser local storage, so they do not need to re-enter it on future visits. When a mobile device visits the site in portrait orientation, the plugin automatically injects touch adaptation tweaks, including larger touch targets, properly sized input fonts, and gesture controls for opening and closing the DSH sidebar. All official DSH features work exactly as they do on the host device after login.

The plugin enforces server-side password checks for all privileged DSH operations like settings and credential access, and the login gate blocks random unauthorized access from other LAN users. Installation can be done via platform-specific shell scripts for Windows, Linux, and macOS, and the plugin supports hot loading, so no restart of the DSH service is required after installation. Uninstallation is also handled via a provided script that cleans up all changes to the system and DSH configuration. The project is released under the open source MIT license, allowing free use, modification, and redistribution.

这是一款专为 DeepSeek Harness 开发的原生插件,用于给 DSH 的 Web GUI 添加带口令验证的局域网访问能力,同时为官方界面提供移动端竖屏触控优化。它仅支持 DSH 0.1.2-rc.1 及以上版本(已验证到 0.1.5-rc.1),旧版 DSH 不兼容,使用前需先升级 DSH。安装后,Web GUI 默认绑定所有网卡,并自动配置主机防火墙放行规则,方便局域网内其他设备访问。

成功启用后,任意局域网设备(桌面端、手机、平板)都可以通过 http://<本机IP>:3080 访问 DSH,访问前需通过全屏登录门输入口令验证。插件支持在本地设备浏览器存储记住口令,解锁后所有 DSH 官方功能都可正常使用。手机竖屏访问时,插件会自动注入触控适配,包括更大的触控目标、适配的字号和侧栏滑开收起等手势优化。

它对特权操作做了服务端口令校验,登录门可防止无关人员随意访问界面,仅建议在可信的家庭或办公室内网使用。用户可以通过项目提供的自动化脚本在 Windows、Linux 和 macOS 上完成安装,支持热加载无需重启 DSH 服务,卸载也可通过对应脚本干净完成。整个项目以 MIT 开源许可证发布,允许自由使用和修改。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • 10 stars - an early-stage project星标 10,属于早期项目
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:MrMu666/dsh-LAN

把 MrMu666/dsh-LAN 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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.mux WebSocket)向每个连接的浏览器推送相同更新

💡 最简单的安装方式:告诉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 一致)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-model-switch 下一个 Next dsh-science-workbench →