前言¶
DeepSeek Harness (DSH) 的核心哲學是「一切皆插件」。在使用 Agent 處理重複性任務(如網頁巡檢或桌面自動化)時,每次讓模型重新規劃步驟會導致成本高且不穩定。DSH Patrol 將這一過程拆解爲兩個階段:先用 Agent 進行自然語言教學並固化,再用確定性 Runner 進行重複執行。
插件介紹¶
DSH Patrol 是面向 DeepSeek Harness 的瀏覽器與 Windows 桌面跨應用巡檢插件。它允許開發者用自然語言描述巡檢流程,固化後由系統自動重放,不再依賴模型每次臨場猜測步驟。
- 名稱:
qigelunbiya/dsh-patrol - 維護者: qigelunbiya
- 分類: 聯網工具
- 許可證: MIT
- 當前狀態: Alpha / GitHub-first
核心功能¶
1. 自然語言教學與確定性重放¶
直接描述“打開哪裏、點什麼、檢查什麼、截圖什麼”。教學完成後保存爲 Runbook,後續重複巡檢不依賴模型重新規劃路徑。
2. 瀏覽器與桌面雙模支持¶
- 瀏覽器: 自動尋找 Chrome / Edge / Chromium,使用獨立持久 Profile(保留登錄態),並自動加載內置擴展。
- Windows 桌面: 優先使用 Windows UI Automation;不足時依次使用快捷鍵、Windows OCR、座標點擊作爲後備。
- 跨應用流程: 支持同一條流程先巡檢網頁並生成截圖,再激活桌面應用(如微信、WPS)繼續操作。
3. 安全與自愈¶
- 安全憑據: Runbook 僅保存
${credential:REF},不保存明文密碼或 Cookie。 - 保守自愈: Selector 自愈僅在唯一、精確匹配時進行一次重試,需顯式確認。
- 知識庫: 內置
微信.md、WPS.md、百度網盤.md,支持工作區自定義覆蓋。
4. 輸出與檢查點¶
- Checkpoint / Resume: 支持在需要人工令牌、掃碼等步驟暫停,人工完成後繼續原 Run。
- 跨步驟引用: 支持在桌面步驟中使用
${artifact:last-screenshot}獲取前面生成的截圖。
安裝與啓用¶
當前處於 Alpha 階段,推薦直接從 GitHub 克隆源碼並使用倉庫自帶安裝腳本。
前置條件¶
- 已安裝 Git。
- Node.js
>= 22。 - 已安裝 pnpm。
- 本機已有可運行的 DeepSeek Harness 源碼環境。
- Windows PowerShell / PowerShell 7。
安裝步驟¶
- 克隆倉庫:
git clone https://github.com/qigelunbiya/DSH-Patrol.git
cd DSH-Patrol
- 執行安裝腳本(假設 Harness 位於
D:\deepseek-harness):
.\scripts\install-local.ps1 -HarnessRoot "D:\deepseek-harness"
- 啓動 Harness:
cd D:\deepseek-harness
pnpm dsh web
- 在 DSH 界面新建會話,選擇「巡檢模式」。Patrol 會自動啓動受管瀏覽器並連接擴展。
典型用法¶
網頁巡檢示例¶
創建一個不需要登錄的網頁巡檢:
“幫我創建一個網頁巡檢。巡檢名稱:Example Domain 測試巡檢。地址:https://example.com。打開頁面,確認存在“Example Domain”,讀取頁面內容,截圖,並生成報告和頁面摘要。”
桌面自動化示例¶
通過 Windows UI Automation 執行操作:
“Windows UI Automation -> 快捷鍵/鍵盤 -> 截圖+OCR -> 座標點擊”
跨應用工作流示例¶
網頁巡檢後,將截圖發送至桌面應用(如微信):
1. browser_screenshot
2. ${artifact:last-screenshot}
3. desktop_set_clipboard_files
4. desktop_paste
注意事項¶
- 當前狀態: 項目處於 Alpha 階段,推薦使用源碼安裝而非 npm 包。
- 權限控制: TEST MODE 與 NORMAL MODE 的 Desktop Automation 目前不做動作權限分級。
- 數據安全: 網頁內容始終按 UNTRUSTED DATA 處理。
- 安裝建議: 請勿將 npm 包作爲默認安裝方式,使用提供的 PowerShell 腳本以避免構建和集成問題。
總結¶
DSH Patrol 解決了智能體在重複性巡檢任務中非確定性的問題。它將“教一次”與“跑多次”分離,通過瀏覽器和桌面雙模支持,實現了從網頁檢查到桌面歸檔的全鏈路自動化。
- GitHub: https://github.com/qigelunbiya/DSH-Patrol
- 插件目錄: https://www.skillhub.cn/plugins/qigelunbiya/DSH-Patrol