前言¶
DSH 插件生態強調「一切皆插件」。dsh-pilot 是一個面向 DeepSeek Harness Web GUI 的插件，用於讓 DSH agent 在聊天中通過 CDP 驅動本機 Edge 或 Chrome。
它面向瀏覽器操作任務：打開頁面、讀取結構化文本、按 snapshot ref 點擊和輸入、填寫表單、上傳文件，並在 Web GUI 中通過 cockpit 面板觀察截圖、URL、狀態和操作日誌。插件使用零運行時依賴，不需要 API key，可通過一條命令安裝。
定位¶
項目信息¶
- 倉庫：guo6x/dsh-pilot
- 類型：DeepSeek Harness 插件，安裝到 web profile
- 許可證：MIT
- 瀏覽器：通過 CDP 使用本機 Edge 或 Chrome
- 依賴：零運行時依賴，不需要 API key
運行要求¶
- Node >= 22
- 本機已安裝 Edge 或 Chrome
- 安裝後需要重啓 dsh web 進程，再刷新頁面
核心能力¶
頁面讀取¶
插件可以從聊天中打開頁面，並讀取結構化文本，包括 title、URL、text、links，以及一個帶編號的元素列表。
元素操作¶
點擊和輸入基於 snapshot ref 進行，而不是猜測 CSS selector。表單填寫可按 label、aria-label、placeholder、name 或 id 解析人類可見字段。文件上傳可指定 snapshot ref，用於定位文件輸入框。
導航與輔助動作¶
支持 back、reload、wait、JS evaluation、screenshot 和 download 等工具。
pilot_wait接受 1-30000 ms 的等待時間。pilot_upload接受 1-10 個絕對路徑文件。- 上傳文件總大小上限爲 100 MB。
- 下載上限爲 20 MB。
可視化與會話隔離¶
Web GUI 中提供可拖動的 cockpit 面板，展示截圖、URL、狀態和操作日誌。
默認情況下，面板跟隨最近使用的會話；當多個會話存在時，也可以固定到另一個會話。每個 agent 會話使用獨立的瀏覽器實例，便於並行會話互不干擾。
安裝與啓用¶
先安裝插件，再重啓宿主進程，最後檢查安裝結果。
- 從 GitHub 安裝：
dsh plugin --profile web add github:guo6x/dsh-pilot
-
重啓正在運行的
dsh web進程，然後刷新頁面。僅刷新瀏覽器頁面不能加載新的 host 代碼。 -
在 web profile 中檢查：
dsh plugin --profile web list dsh-pilot
- 如果你使用本地 checkout，也可以在倉庫目錄中執行：
dsh plugin --profile web add .
從 GitHub 安裝會使用已提交的 lib/ 文件，不運行 build 腳本。
典型用法¶
只讀檢查¶
在新聊天中給出這樣的任務：
Open
https://example.com, tell me what the page says, then verify that theLearn morelink is visible.
該任務只讀取公開頁面；完成後可以覈對頁面標題、文本和鏈接信息，cockpit 中也會顯示截圖、URL、狀態和操作日誌。
表單填寫¶
對 staging 表單可以給出一個有邊界的任務：
Open our staging application form, fill the contact fields, upload the approved resume, verify the entered values, and stop before final submission.
填寫可按人類可見字段名解析，上傳按 snapshot ref 定位文件輸入框，並停在最終提交之前。
限制與注意¶
- 每個會話一個標籤頁；refs 固定在當前頁面。
- 僅支持 headless，不提供 headed 模式。
- 安裝後必須重啓
dsh web進程；只刷新頁面不能加載新的 host 代碼。 - 插件以當前 dsh 進程權限運行；安裝前應檢查源碼和 MIT 許可證。
- 不需要額外賬號或 API key；文檔說明數據不離開本機。
- 上傳和下載有大小限制：上傳總大小上限 100 MB，下載上限 20 MB。
鏈接¶
- GitHub：https://github.com/guo6x/dsh-pilot
- 社區目錄頁：本文已覈實事實未提供具體 URL，因此不列出。
