前言¶
在本地運行 DeepSeek Harness (DSH) 進行智能體開發或調試時,開發者通常需要直接操作桌面環境。Pocket Bridge 提供了一種替代方案:它允許通過手機瀏覽器直接訪問運行在 Windows 電腦上的 DSH,處理本地項目、查看流式回覆以及管理對話。它不需要在手機上安裝額外的 App,且連接通過加密通道傳輸。
是什麼¶
Pocket Bridge 是一個輕量級、非官方的 Windows 客戶端插件。它通過一個瀏覽器接口,將手機與本地運行的 DSH 連接起來,充當網關的角色。該項目由 jyb114 維護,採用 MIT 許可證。
核心功能¶
該插件主要解決本地 DSH 的遠程接入問題,具體能力如下:
- 項目與對話管理:在瀏覽器中瀏覽電腦上的項目,添加現有目錄,創建或繼續對話。
- 消息交互與流式輸出:發送消息,查看流式回覆,以及暴露推理過程、工具活動記錄和排隊消息。
- 狀態確認:在刷新頁面或更換入口後,檢查電腦端的提交回執,確認指令是否送達。
- 模型與工具控制:選擇連接的運行時報告的模型和工具預設;在運行時支持的情況下,處理批准、選擇和問題。
- 文件管理:上傳附件,瀏覽、預覽或下載允許的工作區文件;支持查看目標、計劃控制、餘額信息以及顯式請求的桌面截圖。
- 連接方式:使用加密的本地連接,或使用可選的臨時 Cloudflare 隧道。
- 零 App 依賴:整個過程無需安裝手機端應用,僅依賴瀏覽器。
安裝與啓用¶
要使用 Pocket Bridge,需要先在 Windows 電腦上安裝並運行 DSH,然後建立連接。
- 安裝 DSH:在電腦上安裝並登錄 DeepSeek Harness (DSH)。確保本地可以正常打開項目並收到回覆。
- 下載安裝程序:下載 DSH-only Windows setup (Preview.18) 或更新的版本。舊版本的安裝程序仍可在 GitHub Releases 中找到。
- 安裝 Pocket Bridge:運行下載的安裝程序進行安裝。升級操作會保留安裝目錄、連接密鑰、設備記錄、上傳內容和本地日誌。
- 啓動與驗證:打開電腦上的桌面控制台,確認檢測到的 DSH 運行時處於活動狀態。
- 獲取鏈接:複製完整的 HTTPS 手機連接鏈接。注意保持訪問密鑰和
#k=片段的私密性。 - 手機連接:在手機的瀏覽器中打開該鏈接。選擇項目、對話,或添加電腦文件夾並創建新對話。在此過程中,電腦必須保持喚醒和連接狀態。
可選 DSH 插件¶
除了獨立的 Windows 安裝程序,Pocket Bridge 提供了一個可選的 DSH 插件。該插件會將 Pocket Bridge 集成到 DSH 的設置面板中,提供顯式的網關啓動/暫停、私有 QR 配對以及連接診斷功能。安裝該插件需要 Node.js 24+ 運行時,且網絡隧道功能需要單獨安裝 cloudflared。
適用場景與注意事項¶
- 非官方性質:Pocket Bridge 是獨立項目,與 DeepSeek、OpenAI 或 Cloudflare 無官方隸屬或背書。DSH 的模型訪問和提供商費用是分開的。
- 兼容性:對於 DeepSeek-V4.1-Flash-1017 模型,建議使用 Harness 0.2.1-rc.1 或更新版本。插件版本聲明不代表與所有舊版或新版 DSH 完全兼容,需查閱兼容性矩陣。
- 網絡安全:手機內容要求瀏覽器在安全上下文中支持 WebCrypto。普通 LAN HTTP 不被支持,必須使用 HTTPS 隧道或手機信任的本地 HTTPS 入口。
- 連接狀態:Cloudflare 隧道不可用或斷開並不代表消息未被接受。如果不確定消息是否送達,不應重複發送。
- 操作限制:不支持的操作必須明確提示爲不可用或進行解釋,不能顯示爲可點擊但無效的按鈕。
短結尾¶
Pocket Bridge 通過加密連接和瀏覽器界面,降低了使用本地 DSH 的門檻,特別適合需要隨時隨地進行調試和查看日誌的場景。更多細節和源碼可訪問其 GitHub 倉庫。