前言¶
DeepSeek Harness (DSH) 的插件生態允許擴展功能，但原版 DSH 缺乏原生的、全局的調度與審計機制。在現有做法中，自動化任務通常與特定的聊天 Session 綁定，導致會話複用、難以追蹤跨 Workspace 的歷史，以及缺乏統一的管理入口。
dsh-automation-center 是一個 Root-level automation center，它爲 DeepSeek Harness 提供了可計劃、可審計的自動化任務管理能力。每次觸發都會在指定 Workspace 中創建新的根 Agent 和 Result Session；任務定義、計劃、權限與運行歷史由插件管理，完整結果和軌跡保存在獨立的 Session 中。
核心能力¶
該插件主要解決調度、會話隔離和權限管理三個問題。
計劃與會話隔離¶
- 計劃支持：支持一次性、固定間隔、每日和每週計劃。界面提供 IANA 時區配置與下次運行預覽。
- 獨立 Session：每次運行（occurrence）都會創建新的根 Agent 和 Session，不復用現有的聊天會話。
- 結果歸檔：Result Session 使用自動化任務名作爲標題，而不是 Workspace 或項目名，便於查找。
權限與模型策略¶
- 無人值守權限：提供“只讀”和“Workspace 可寫”兩種權限模式。
- 模型選擇：每個任務可選擇“運行時繼承 DSH 默認模型”，或固定 provider、model 和 reasoning effort。系統會記錄運行歷史中的實際模型。
- 健康檢查：保存與運行前會檢查 Workspace、Preset 和模型；不可用目標會顯示爲
blocked，避免創建無效 Session。
穩定性與審計¶
- 調度機制：創建冪等、防重疊、確定性的 occurrence 領取機制，配合有限 misfire 補償與保守的 Host 重啓恢復策略。
- 生命週期：作業經歷
claim / setup / executing / settling / delivery階段，包含租約心跳與超時控制。 - 狀態反饋：提供
expected/admitted/claimed/queue/progress健康狀態，以及結構化的 Outcome/Attention、attempt 與副作用不確定性。 - 持久化：所有寫操作返回持久 Receipt（request ID、revision、committed/rejected/unknown），隨後通過讀取權威狀態確認結果。
- Git 集成：可選 Git worktree 隔離審閱模式，支持 patch hash/stat 與 accept/keep/discard 操作，源工作區漂移時 fail closed。
安裝與啓用¶
當前版本爲 0.1.0-alpha.8。安裝前需確保 DSH 版本在 0.1.0-rc.8 至 0.1.2-alpha.2 之間，且 Node.js 版本爲 ^22.19.0 或 >=24.0.0。
- 下載插件包
dsh-automation-center-0.1.0-alpha.8.tgz。 - 在終端執行以下命令安裝：
dsh plugin --profile web add ./dsh-automation-center-0.1.0-alpha.8.tgz
dsh plugin --profile desktop add ./dsh-automation-center-0.1.0-alpha.8.tgz
安裝後需要完全退出並重新打開 DSH，以使 Host Bundle 在啓動時正確掛載。
使用流程¶
安裝並重啓 DSH 後，可以通過以下步驟創建和管理自動化任務：
- 打開“設置 → 自動化”，或在左側欄找到“自動化”入口。
- 點擊“新建自動化”或“創建第一個自動化”。
- 填寫必要信息：名稱、任務指令、目標 Workspace、計劃（類型、頻率、時區）、Agent Preset、模型策略、權限和超時設置。
- 檢查“下次運行預覽”並保存配置。
- 等待計劃觸發，或直接點擊“立即運行”。
- 在“最近運行”列表中查看摘要，點擊對應條目打開 Result Session 查看完整結果。
建議先用“只讀”權限驗證配置，確認無誤後再開放 Workspace 寫權限。
注意事項¶
- 衝突檢測：如果舊的
@dsh-external/dsh_automation正在運行，新插件會報告AUTOMATION_PLUGIN_CONFLICT。請先停用或移除舊插件。 - 取消限制：取消操作只能終止後續執行，無法回滾已經完成的副作用。
- 安全邊界：日誌和 RPC 錯誤不得輸出 Prompt、Token、環境變量或憑證。無人值守工具使用白名單，拒絕後臺進程逃逸。
- 身份識別：Run 對外提供由 Definition revision、occurrence 與 Workspace scope 組成的穩定 identity，不按列表位置恢復。
