前言¶
DeepSeek Harness (DSH) 插件系統強調“一切皆插件”。開發者常需要在電腦端啓動 Web 會話後，在手機或平板上查看狀態、驗證移動端渲染效果，或處理緊急事務。常規的遠程訪問方案通常需要搭建中繼服務器、綁定雲賬號或配置複雜的網絡環境，對於簡單的同網訪問需求來說過於沉重。
dsh-local-link 旨在解決這個問題。這是一個輕量級插件，允許在同一信任網絡內的其他設備（手機、平板、電腦）通過掃描二維碼，直接接入當前正在運行的 DSH Web 會話。
插件定位¶
- 核心功能：掃描二維碼，訪問當前 DSH Web 會話。
- 維護者：donoteatme。
- 許可證：MIT。
- 版本：最新版本爲 1.2.3。
核心能力¶
該插件不改變 DSH 的核心邏輯，僅提供接入層和視圖適配：
- 同網訪問：在同一受信任私有網絡內，通過二維碼或一次性鏈接將其他設備接入當前會話。
- 移動端適配：當設備視口寬度不超過 834 CSS 像素時，自動應用響應式移動視圖，解決桌面端導航擁擠、操作不便的問題。
- 零依賴接入：無需託管中繼、無需雲賬號、無需單獨的原生 App 或替換聊天 UI。
- 狀態同步：保持與桌面端相同的實時對話、權限、工作區和插件界面。
安裝與啓用¶
在安裝前，請確保已安裝並運行 DeepSeek Harness Web 模式。
- 停止當前運行的
dsh web進程。 - 在終端執行安裝命令：
dsh plugin --profile web add dsh-local-link
- 重新啓動 Harness Web：
dsh web
使用步驟¶
配置完成後，使用流程如下：
- 在電腦上打開並選中需要查看的 DSH 會話。
- 在 Harness 側邊欄底部找到並點擊
Local access。 - 使用手機或平板掃描屏幕上的二維碼，或複製顯示的一次性鏈接。
- 第一個使用該邀請的瀏覽器將自動打開當前桌面端的選中會話。
此時，設備上的瀏覽器將獲得當前會話的所有上下文和權限。對於手機和寬度不超過 834 CSS 像素的設備，系統會自動切換至 Mobile View。
安全邊界與限制¶
- 網絡環境：網關僅使用純 HTTP，僅設計用於受信任的私有網絡。嚴禁將端口暴露到公網或在公共 Wi-Fi 下使用。
- 時效性：邀請碼默認爲一次性使用，且在五分鐘後過期。過期後需重新生成。
- 權限範圍：遠程訪問僅能使用當前會話的權限，Host 端的某些管理功能（如僅限 Loopback 的功能）在遠程端不可用。
適用場景¶
- 開發者驗證移動端 UI 渲染效果。
- 在非移動設備上查看移動端適配後的聊天記錄。
- 同一網絡下的臨時會話共享，無需配置 VPN 或雲服務。
總結¶
dsh-local-link 提供了一種低門檻的本地局域網接入方案，解決了 DSH Web 在多設備場景下的狀態同步與視圖適配問題。其設計保持克制，不引入額外的業務邏輯，僅作爲現有 Harness Web 客戶端的輕量級補充。
