在 DeepSeek Harness (DSH) 的工程化場景中，Agent 需要在項目範圍內發現任務、評估變更影響、執行後臺任務並收集驗證結果。dsh-project-ops 插件旨在解決這些問題，它不修補 Harness 源碼，也不繞過審批流程，而是通過 Agent 工具爲項目任務提供有邊界的管理和回執機制。
插件定位¶
該插件由開發者 Missher12 維護，開源協議爲 MIT。它是一個獨立的 Cordis 項目執行插件，兼容 DeepSeek Harness 0.1.5-rc.2 / Cordis 4.0.2。其核心價值在於爲 Agent 提供一個受控的任務發現、計劃與執行環境，確保任務運行在 Harness 的現有 Jobs 運行時和沙箱中，而不是創建新的引擎或繞過權限。
兼容性與前置要求¶
使用前需確認宿主環境滿足以下版本與配置要求：
- DeepSeek Harness: 0.1.5-rc.2
- Cordis: @deepseek-ai/cordis 4.0.2
- Node.js: ^22.19.0 或 >=24.0.0
- Profile 服務: 當前 Profile 必須提供
fs、tools、jobs和systemPrompt服務。
安裝與啓用¶
在 Web Profile 環境下，使用以下命令安裝插件包：
dsh plugin --profile web add https://github.com/Missher12/Missher-DSH-Project-Ops/releases/download/v0.3.1/dsh-project-ops-0.3.1.tgz
安裝完成後，請確保 Profile 已重新加載。需要注意的是，Git 倉庫中的代碼更新不會自動替換本地已安裝的插件，如需更新，需手動重新執行上述安裝命令。
核心能力與工具¶
安裝成功後，Agent 可使用以下四個主要工具進行任務管理：
-
missher_project_ops_task_list
- 功能: 列出項目任務。
- 行爲: 從當前會話的根目錄和聲明的包工作區中發現任務。返回結果包含任務身份、源清單、SHA-256 校驗和、相對工作區、可選的包名、推斷用途、依賴任務 ID 和運行狀態。該工具不會返回具體的任務命令文本。
-
missher_project_ops_task_plan
- 功能: 任務計劃與影響分析。
- 行爲: 接受 1 到 256 個相對工作區的
changedFiles和目標（verify/build/all）。它會找出直接受影響的包、反向依賴、任務依賴和匹配的根任務，並返回穩定的拓撲排序、受影響的工作區名稱、診斷信息以及基於項目內容和快照的摘要。
-
missher_project_ops_task_run
- 功能: 後臺任務執行。
- 行爲: 接受任務 ID、清單校驗和以及可選模式（
foreground/background/auto）。它會通過 Harness 的 Jobs 運行時執行任務，並返回執行回執。
-
missher_project_ops_verification_gate
- 功能: 驗證回執收集。
- 行爲: 收集並評估任務執行後的驗證結果。
注意事項¶
- 權限與邊界: 插件複用宿主的命令權限和沙箱，不創建新的 Shell 或作業註冊表。它不會繞過審批流程。
- 環境隔離: 插件以當前 Profile 的權限運行，因此安裝前應仔細檢查源碼與許可證。
- Agent 工作流: Agent 應遵循固定流程：先列出任務，再基於變更文件進行計劃，最後僅運行返回的任務聲明並收集回執。
