前言¶
DeepSeek Harness (DSH) 的桌面 Web 界面默認綁定在 127.0.0.1 上，這保證了終端、文件和設置等敏感功能的安全。但在實際使用中，開發者往往需要在移動端查看會話或繼續對話。直接暴露端口存在安全風險，而使用 VPN 又增加了配置門檻。
下面介紹的插件通過在 DSH 進程內部運行一個獨立的 HTTP 監聽器，提供了一個僅限聊天的移動端入口。它保持了桌面 Web 表面不變，同時允許通過局域網或自建隧道進行訪問。
這是什麼¶
這是一個由 huanlanmie 維護的 DSH 插件。它是一個受 PIN 保護的移動端 Web 客戶端，運行在 DSH 的獨立端口上。它利用 DSH 自身的服務（如 sessionQuery、permissionPresets）提供對話能力，但不涉及對 DSH 核心功能的重寫。
核心功能¶
移動端客戶端 (/m/)¶
- 登錄與界面：通過 8 位 PIN 碼登錄，界面包含會話列表、實時對話流。
- 流式回覆與工具調用：支持流式輸出，並內聯渲染工具調用步驟。
- 會話內操作：無需離開聊天界面，即可切換模型和權限預設。
- 統計與導航：顯示與桌面端一致的會話統計（輪次、Token、成本），提供回合導航欄，支持分頁加載歷史記錄。
- 主題：支持淺色/深色模式切換。
桌面端設置頁面¶
- 全局控制：提供總開關，關閉後監聽器不啓動。
- 網絡配置：設置監聽端口、網絡模式（LAN / Tunnel / 兩者）、隧道主機名及空閒超時時間。
- 會話管理：支持掃描二維碼連接手機、撤銷會話、查看登錄歷史。
安全特性¶
- 默認安全：插件默認關閉且僅監聽環回地址，未設置 PIN 前無法從外部訪問。
- PIN 加密：使用 scrypt 算法（參數 N=2^14, r=8, p=1）存儲 PIN，包含隨機鹽值，防止暴力破解。
- 令牌管理：使用 256 位隨機令牌，持久化存儲哈希值，設有 7 天過期時間及空閒超時（默認 60 分鐘）。
- 防護機制：具備防暴力破解（每分鐘 6 次嘗試，5 次失敗鎖定 IP 15 分鐘，加倍懲罰）、主機白名單、CSRF 保護。
安裝與啓用¶
在安裝前，請確保你的環境滿足要求：Node.js ≥ 20，且已安裝 DeepSeek Harness（版本 0.1.1-rc.2 及以上）。
執行以下命令安裝插件：
dsh plugin --profile web add github:huanlanmie/dsh-mobile-access
安裝完成後，重啓 dsh web。在桌面 Web UI 的設置卡片中，會出現 Mobile access 選項。
典型用法¶
- 設置 PIN：在桌面 UI 的 Mobile access 設置卡片中，設置一個 8 位 PIN 碼。
- 啓用並配置網絡：打開總開關，選擇網絡模式：
- LAN：監聽
0.0.0.0，在同一 Wi-Fi 下，使用手機瀏覽器掃描設置頁面的二維碼訪問。 - Tunnel：配置隧道服務（如 Tailscale、cloudflared 或 cpolar），通過 HTTPS 外網訪問。
- Both：LAN 用於本地，Tunnel 用於外出。
- LAN：監聽
- 手機端使用：在手機瀏覽器訪問
/m/，輸入 PIN 碼即可繼續會話。
適用場景與注意¶
- LAN 模式限制：LAN 模式使用明文 HTTP，網絡中的任何設備都能嗅探到 PIN 和令牌。請勿在不可信的公共 Wi-Fi 下使用 LAN 模式，應優先使用 Tunnel 模式。
- PIN 重置影響：修改或重置 PIN 會撤銷所有現有的會話，需重新登錄。
- 第三方代碼：該插件爲第三方維護的開源項目，非 DeepSeek Harness 官方組件。在生產環境安裝前，建議審查源碼。
該插件通過將移動訪問與桌面管理界面隔離，在保證安全性的前提下，爲 DSH 用戶提供了便捷的移動端使用方案。更多細節可參考 GitHub 倉庫。
