前言¶
DeepSeek Harness（DSH）的設計理念是「一切皆插件」。dsh-deeppilot 是其中的一個客戶端插件，爲 DeepSeek Harness 提供原生的 iPhone 伴侶應用。它不替代或修改 DSH 的 Web 界面，而是通過加密隧道直接連接到你的 DSH 主機，允許你在手機上瀏覽會話、發送提示詞並管理智能體流程。
插件信息¶
- 名稱：
dsh-deeppilot - 維護者：Mars-Sea
- 分類：客戶端
- 許可證：MIT
核心功能¶
- 全流程交互：從 iPhone 瀏覽項目、會話、歷史記錄和實時代理輸出；發送提示詞、切換模型、創建會話，以及處理系統提示的審批與問題。
- 安全配對：使用五分鐘單次有效代碼和每設備 P-256 密鑰進行配對。物理 iPhone 將私鑰保存在 Secure Enclave 中，確保密鑰不離設備。
- 連接方式：
- 局域網 (LAN)：默認啓用獨立 TCP 端口 3098，僅支持 TLS 加密，主機在配對時頒發證書並校驗指紋。
- Tailscale Funnel：支持可選的嵌入式 Tailscale Funnel 模式。
- 通知支持：支持實時推送通知，並可選離線 APNs 通知（離線模式下中繼模式僅傳遞 APNs 設備令牌和有限負載，不傳輸完整對話歷史）。
- 自更新：設置頁腳顯示已安裝版本，後臺檢查 GitHub 穩定版發佈，並提供版本更新鏈接（無第三方依賴）。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-deeppilot
安裝完成後，重啓 DSH。進入 Settings（設置） → DeepPilot，啓用連接並顯示配對二維碼。在 DeepPilot 應用中掃描二維碼即可完成配對。配對面板下方也會顯示可複製的地址、一次性代碼和證書指紋，方便在無法使用相機時進行粘貼配對。
配置與注意事項¶
- 端口與防火牆：局域網訪問默認監聽 TCP 3098。如果系統啓用防火牆，請在使用的網絡中放行該入站端口。端口可在 DeepPilot 的設置頁面更改。
- 連接切換：在局域網和公網地址之間切換時，插件會立即生成新的二維碼和字符串。
- 協議升級：如果從舊版本升級（舊版本在局域網使用明文
ws://），所有通過局域網配對的設備必須重新配對，以獲取新的證書指紋。 - 數據保留：卸載插件不會刪除
$DSH_HOME/deeppilot/下的本地狀態文件。
適用場景與限制¶
- DeepPilot 狀態：DeepPilot 目前處於 Apple TestFlight 審覈階段，邀請鏈接將在 Apple 審覈通過後生效。
- DSH 版本要求：插件源碼基於 Node.js 22+ 和 DSH 0.2.x 系列開發（兼容
0.2.0-rc.2至0.3.0之前版本），需要使用web配置文件。 - 安全建議：對話流量直接在 iPhone 和 DSH 主機之間傳輸，全程加密。在啓用遠程訪問或推送功能前，請閱讀
PRIVACY.md和SECURITY.md。
總結¶
dsh-deeppilot 爲 DSH 用戶提供了原生的移動端操作能力。通過物理設備隔離私鑰、TLS 證書綁定以及直接連接模式，它在提供便捷操作的同時保持了較高的安全性。目前該插件正處於測試階段，適合希望在移動端深入使用 DeepSeek Harness 的開發者。
