前言¶
DeepSeek Harness (DSH) 的 WebUI 在默认安全策略下，限制了通过非 localhost IP 地址（例如局域网 IP）的访问。当从 LAN 访问时，Web UI 会因为安全上下文缺失而禁用设置、文件上传、剪贴板复制以及麦克风权限。dsh-lanmode 旨在解决这些限制，为 DSH 提供安全的局域网访问、mDNS 域名解析、Root CA 证书生成以及 PWA 支持。
核心功能¶
该插件提供以下能力：
- 局域网访问与 mDNS：启用通过非 localhost IP 访问 DSH WebUI，并提供
dsh.local的 mDNS 域名解析，无需记忆 IP 地址。 - Root CA 与 HTTPS：生成有效期 10 年的本地根 CA 证书，支持 HTTPS 访问，从而解锁 WebRTC 麦克风和剪贴板等浏览器安全 API。
- PWA 支持：提供 Web App Manifest，支持将 DSH 安装到移动设备主屏幕并作为独立应用运行。
- QR 码访问：通过
/mobileqr命令生成包含会话令牌的二维码，便于移动设备扫码快速接入。 - 浏览器 API Polyfills：提供
crypto.randomUUID、navigator.clipboard和navigator.mediaDevices.getUserMedia的回退实现。 - Loopback Hostname Bypass：绕过主机名检查，确保设置和模型页面在局域网环境下可用。
安装与依赖¶
提供的源文本中没有包含具体的安装命令。根据项目 package.json 信息，该插件有明确的依赖要求：
先决条件
- DeepSeek Harness 版本：0.1.7+
- Node.js 版本：20+
依赖项
该插件作为 Peer Dependencies 依赖以下模块：
- @deepseek-ai/cordis (^4.0.1)
- @deepseek-ai/dsh-host-webserver (^0.1.0-rc.6)
典型用法¶
在 DSH 运行环境中，通过 HTTP 请求访问以下端点进行配置或接入：
生成访问二维码
GET /mobileqr
该命令返回一个包含当前局域网 URL 和会话令牌的 SVG 二维码，移动端扫描即可连接。
安装根证书
GET /dsh-lanmode/ca.crt
下载并安装该证书到移动设备或浏览器，可建立受信任的 HTTPS 连接，使语音输入和剪贴板功能正常工作。
检查健康状态
GET /dsh-lanmode/health
获取 PWA Manifest
GET /dsh-lanmode/manifest.webmanifest
GET /dsh-lanmode/manifest.json
适用场景与注意¶
- 适用场景：需要在局域网内使用 DeepSeek Harness WebUI 的开发者，特别是需要使用移动设备进行语音交互、文件上传或需要剪贴板功能的场景。
- 注意事项：该插件以当前 DSH 进程的权限运行。在安装前，建议检查插件的源代码和许可证（MIT）以确保符合环境安全要求。
总结¶
dsh-lanmode 是 DeepSeek Harness 在局域网环境下的实用补丁，它通过非侵入式的 HTML 注入和 Root CA 机制，解决了 WebUI 在非安全上下文下的功能缺失问题。它支持 mDNS 域名、PWA 以及 QR 码快速接入，适合需要本地化部署和远程访问的用户。
- GitHub 仓库：https://github.com/GooDAnDReaDY/dsh-lanmode
- 插件目录：https://www.skillhub.cn/plugins/GooDAnDReaDY/dsh-lanmode
