前言¶
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 授權。
