前言¶
DeepSeek Harness Web 界面默认绑定到本地地址，若要在局域网内访问，通常需要手动配置端口转发或反向代理。本插件直接配置并管理 DSH 0.1.5 自带的 0.0.0.0 WebServer LAN 监听、trustedHosts 信任栅栏以及基于随机 launch token 的认证流程。它不实现第二套反向代理或自定义存储，而是利用 DSH 原生的 WebServer 和 BrowserAuth 机制，提供安全且持久的局域网访问入口。
核心功能¶
插件主要提供以下能力：
1. 配置并展示 DSH 0.1.5 自带的 0.0.0.0 WebServer LAN 监听。
2. 管理 LAN IP trustedHosts 信任栅栏。
3. 使用每进程随机 launch token 进行认证。
4. 签发 HttpOnly Cookie。
5. 设置授权 Cookie 有效期（默认 30 天）。
6. 提供一键 Save and restart DSH 功能。
7. 提供完整的 token 授权链接。
安装与启用¶
安装前请确保已安装 DeepSeek Harness CLI 0.1.5-rc.1 和 Node.js >=22.19.0。
git clone https://github.com/advance-lion/dsh-lan-link.git
cd dsh-lan-link
dsh plugin --profile web add .
安装后，进入设置 → 插件 → 插件配置 → LAN Link，开启 LAN 访问开关并重启进程。
使用流程¶
开启 LAN 访问并重启 DSH 后，设置页面会生成一个包含随机 token 的授权链接，格式如 http://IP:PORT/?token=...。
- 远程浏览器访问生成的链接。
- DSH 原生
BrowserAuth校验该进程的随机 token。 - 校验成功后，DSH 返回重定向并写入绑定 hostname 和 port 的签名 Cookie。
- 此后访问不含 token 的 URL 即可进入界面，Cookie 默认有效 30 天。
修改绑定地址、端口或授权天数后，需点击“Save and restart DSH”按钮应用更改。
安全与注意事项¶
依赖环境：插件依赖 DeepSeek Harness CLI 0.1.5-rc.1 和 Node.js >=22.19.0。
重启机制：DSH 0.1.5 的 WebServer 和 BrowserAuth 在进程启动时读取配置。监听地址（如 127.0.0.1 与 0.0.0.0）和 Cookie 有效期无法热切换，因此修改相关设置后必须重启进程才能生效。
安全属性：Cookie 具有严格的浏览器安全属性（HttpOnly、Host-only、SameSite=Strict），绑定 hostname 和 port，更换 IP 或端口需重新授权。
网络风险：普通 HTTP 不加密，局域网内存在嗅探风险。不建议将端口映射到公网或公共 Wi-Fi，请仅允许本地防火墙的“专用网络”访问。
功能范围：插件不实现自建 HTTP/WebSocket 代理，也不存储长期 token。所有权限等同于 DSH 原生的完整 token 授权。
