在 DeepSeek Harness (DSH) 中處理長任務時,經常遇到一次性輸入巨大請求的情況。代理直接開始工作,沒有規劃,也沒有明確的驗收標準。dsh-goal-scaffold 作爲一個門禁,在代理執行前攔截這些請求,詢問用戶是否先規劃。
這是一個由 zriyox 開發的 DSH 插件,用於檢測一次性巨大請求。它詢問用戶是否先規劃,然後在代理工作前搭建 plan.md 和帶上限的目標。
核心功能¶
- 攔截大需求並詢問:檢測一次性巨大請求,彈出交互窗口。
- 交互式決策:提供三個選項(先規劃/直接開始/本次會話不再詢問),由用戶決定。
- 自動生成文檔:生成帶驗收清單的
plan.md,並創建帶上限的目標。 - 執行追蹤:代理逐項執行,並實時勾選完成情況。
- 會話限制:一次會話內僅觸發一次,避免重複打擾。
- 環境兼容:支持無頭模式(不阻塞消息)。
- 消息過濾:僅對人類消息生效,工具注入或驅動續寫不會觸發。
- 可配置性:可配置觸發檢測的最小消息長度和額外的範圍短語。
安裝與啓用¶
使用官方命令安裝插件。
dsh plugin --profile web add github:zriyox/dsh-goal-scaffold
通過 YAML 配置文件啓用並調整行爲。
- id: goal-scaffold
config:
enabled: true # 主開關
minLength: 80 # 參與檢測的最小消息長度
extraSignals: ['遷移'] # 額外的(不區分大小寫)範圍短語
典型用法¶
輸入一個模糊的大任務(例如 “build me a complete task management system”),系統會彈出提示窗口。
- 選擇 “Plan first”(推薦)。
- 請求發送後,代理被指示先編寫
plan.md(其中每個項目都有可驗證的驗收標準)並創建帶上限的目標。 - 代理顯示計劃,隨後逐項執行並勾選複選框。
適用場景與注意¶
該插件適合需要結構化規劃的大型複雜任務。
- 會話限制:在會話內最多觸發一次,回答任何選項或選擇 “本次會話不再詢問” 後,直到新會話纔會再次觸發。
- 無頭模式:在無頭模式下(如
headlessprofile),因爲沒有用戶提問渠道,消息會直接通過,不會阻塞。 - 消息生效範圍:僅對人類消息生效,goal-driver 的續寫、插件注入和工具產物不會觸發檢測。
- 取消行爲:如果用戶取消彈出窗口並輸入其他內容,原始消息仍會照常發送。
插件以當前 DSH 進程權限運行,安裝前建議檢查源碼與許可證。