在使用 DeepSeek Harness (DSH) 進行智能體開發或調試時,開發者往往需要留在辦公桌前處理工具調用、回答模型提問,或者在需要視覺輸入時(如拍照)進行操作。如果離開電腦,智能體可能會停滯,或者無法獲取必要的上下文信息。DSH Pocket 插件解決了這個問題,它通過手機瀏覽器連接到運行在電腦上的 DSH 實例,讓你在移動端也能監控和引導智能體。
插件定位與功能¶
DSH Pocket 是一個由 keman-ai 維護的客戶端插件。它的核心價值在於將 DSH 智能體的控制權延伸到手機瀏覽器上,無需物理回到電腦前即可接管智能體的運行。
核心功能包括:
* 實時監控:查看智能體的輸出流,包括推理過程和最終答案。
* 工具調用控制:批准或拒絕智能體發起的工具調用。
* 交互補充:回答智能體在運行中提出的暫停性問題。
* 多媒體輸入:通過手機發送消息或拍攝照片並直接交給智能體。
* 運行控制:強制停止當前正在進行的回合。
* 配置調整:在手機端切換模型、編輯偏好設置(語言、外觀、默認模型、智能體循環)或更換皮膚。
安裝與啓用¶
插件默認是關閉的,需要手動安裝並配置。
1. 安裝插件
使用官方安裝命令,將插件安裝到 web 配置文件中:
dsh plugin --profile web add -w github:keman-ai/dsh-pocket
2. 啓用插件
安裝完成後,插件不會自動運行。需要在配置文件中開啓它。編輯 $DSH_HOME/profiles/web/cordis.patch.yml,添加以下內容:
- id: pocket
config:
enabled: true
3. 鏈接賬戶
啓用後,在 DSH 客戶端的 Settings → Pocket → Link an A2H account 中鏈接一個 A2H Market 賬戶。完成後,你的機器會顯示爲在線狀態。
4. 手機端訪問
在手機瀏覽器中打開 dsh-pocket.a2hmarket.ai,使用與機器端相同的賬戶登錄。登錄後,點擊你的計算機並選擇一個會話即可開始操作。
運行機制與注意事項¶
DSH Pocket 通過 A2H Market 的中繼服務連接手機與電腦,這意味着它不需要在電腦上開放入站端口。
運行依賴:
* DeepSeek Harness:版本需在 0.1.2 或以上。
* 配置文件:必須使用 web 配置文件,因爲插件依賴其提供的 UI 和設置面板。
* Node.js:環境要求 >= 22.19。
* 賬戶:需要一個有效的 A2H Market 賬戶。
安全特性:
* 默認關閉:未手動啓用前,不會建立任何連接。
* 僅出站連接:插件和手機均主動發起連接到中繼服務,電腦端不會監聽任何入站端口,無需配置端口轉發或 NAT 穿透。
* 數據隱私:會話幀通過中繼轉發,僅在內存中傳輸,不會被存儲或記錄到日誌中。
總結¶
DSH Pocket 讓開發者可以在移動場景下保持對智能體的控制。通過批准工具調用、回答問題或發送照片,它填補了桌面端操作與移動端需求之間的空白。如果你經常需要遠程調試或管理 DSH 智能體,這是一個實用的工具。