前言¶
DeepSeek Harness (DSH) 的核心設計是「一切皆插件」。在開發需要週期性執行任務的智能體時，手動編寫調度邏輯往往繁瑣且容易出錯。dsh-loop 插件正是爲了解決這個問題而生，它爲智能體提供了一個用戶友好的 /loop 斜槓命令，用於管理定時循環任務。
插件定位¶
這是一個由開發者 XiaoWind 維護的 DSH 插件。它通過注入命令服務，爲智能體增加了一個定時循環執行器。通過該插件，開發者無需編寫複雜的調度代碼，即可在 Web 界面直接控制 Agent 的循環行爲。
核心功能¶
該插件主要包含以下能力：
* 定時循環指令：提供 /loop 斜槓命令，支持立即執行首次 Tick。
* 持久化配置：循環配置會在重啓後保持，通過 /loop resume 可恢復。
* 靈活的時間設置：支持 ms、s、m、h、d 等時間單位，支持組合時長（如 1h30m）。
* 手動控制：支持通過 /loop stop 或銷燬 Agent 來結束循環。
* 狀態查詢：提供 /loop status 和 /loop help 查看當前運行狀態。
安裝與啓用¶
使用 dsh plugin 命令安裝。由於插件依賴命令服務，它僅會在包含命令適配器的 Profile（例如 web profile）中激活。
dsh plugin --profile web add git+https://github.com/XiaoWind/dsh-loop.git
安裝或更新後，必須重啓 Web 應用，因爲插件層會在啓動時加載。
典型用法¶
插件提供了一組斜槓命令來控制循環：
| 命令 | 效果 |
|---|---|
/loop 30m |
立即執行一次，隨後每 30 分鐘執行一次 |
/loop 30m fix the tests |
設置一個 30 分鐘間隔的循環，目標爲修復測試 |
/loop fix the tests |
使用默認間隔，目標爲修復測試 |
/loop 1h30m |
使用組合時長（1小時30分鐘） |
/loop resume |
恢復上次重啓前保存的循環配置 |
/loop status |
顯示當前運行的循環狀態 |
/loop stop |
停止當前循環 |
/loop help |
顯示幫助信息 |
語法規則爲：首位是時間間隔（可選），其餘部分爲循環目標。如果省略時間間隔，則使用默認間隔。
配置說明¶
如果不指定時間間隔，插件使用默認值。可通過配置文件修改此默認值：
# cordis.patch.yml
- id: loop
config:
defaultIntervalMs: 900000
默認間隔爲 600000 毫秒（10 分鐘）。
注意事項¶
- 運行環境：插件以當前 DSH 進程的權限運行，建議在安裝前檢查源碼與許可證。
- 激活條件：只有在配置了命令適配器的 Profile 中才會生效。
- 文件存儲：循環配置持久化在
$DSH_HOME/dsh-loop/<sessionId>目錄下。 - 無自動完成：插件不包含自動完成檢測功能，需手動停止或銷燬 Agent 來結束循環。
- 單文件：這是一個無構建步驟的單文件 ESM 插件。
總結¶
dsh-loop 通過簡單的命令接口解決了智能體週期性任務的需求。它結合了 DSH 的插件機制，使得定時調度變得輕量且易於管理。項目源碼託管在 GitHub，可通過鏈接訪問。
- GitHub: https://github.com/XiaoWind/dsh-loop
