前言¶
在 DeepSeek Harness(DSH)裏跑寫文件、改代碼、執行 shell 的任務時,工作區常會留下腳本中間產物、一次性構建目錄或調試輸出。這些文件不一定該長期留在倉庫裏,但模型在給出「最終答覆」之後又單獨跑一輪清理,容易把真正的答覆擠進摺疊的過程區,界面上的最後一條消息變成清理說明而不是你要看的結論。下面介紹社區插件 dsh-plugin-process-cleanup(維護者 zh-Littlebird),它用提示詞與工具回調後的提醒,讓模型在同一回合內、最終答覆之前完成「任務是否結束」的判斷與過程文件整理,且清理動作仍由模型通過會話里正常的 shell 工具執行,沙箱、審批與審計鏈路不變。
這是什麼¶
dsh-plugin-process-cleanup 歸類爲工作流。一句話定位:在會產生文件的任務裏,提醒模型先清理本輪過程文件,再給出最終答覆;支持直接刪除或移入工作區 .dsh-trash 回收目錄。插件自己不判斷、不刪文件——它把清理準則寫入系統提示詞,並在 write / edit / shell 等工具調用之後追加通知類提醒,由模型按規則執行移動或刪除。
設計要點(來自倉庫說明):插件不會在最終答覆之後再追加一步模型動作;提醒只出現在過程裏,最後一條助手消息始終是面向用戶的答覆。
- 目錄頁:skillhub.cn/plugins/zh-Littlebird/dsh-plugin-process-cleanup
- 源碼與文檔:github.com/zh-Littlebird/dsh-plugin-process-cleanup
- 當前
package.json版本:0.1.0,許可證 MIT
核心功能¶
會話開關與全局配置¶
開關是會話級的:每個會話在輸入框左側有獨立的掃帚圖標開關,默認關閉;打開隻影響當前會話。設置 → 通用裏是全局項:清理方式、新會話是否默認開啓。
| 字段 | 默認 | 說明 |
|---|---|---|
defaultEnabled |
false |
新打開的會話是否默認開啓收尾清理。 |
mode |
trash |
trash:移到工作區 .dsh-trash/<會話>/turn-<輪次>/;delete:直接刪除。 |
skipSubagents |
true |
子代理會話不單獨提示,由父會話統一處理。 |
會話開關保存在 Host 進程內,隨會話關閉清除;重啓後會話回到「默認關閉」(或受全局 defaultEnabled 影響的新會話初始狀態)。
何時觸發提醒¶
滿足以下條件時,插件在工具調用之後追加一次提醒:
- 當前會話開關打開;
- 調用的是
write/edit/pwsh/bash/ 子代理類工具(寫文件、改文件每次提醒;shell 與子代理每回合最多一次); - 是根會話(子代理默認跳過);
- 沒有進行中的目標(goal 爲 active / paused / blocked 時跳過,complete 後照常);
- 本輪不是失敗的寫入。
系統提示詞裏的常駐準則只在滿足 1、3、4 時出現。
安全邊界¶
- 模型先判斷任務是否完成;未完成則保留過程文件,不做清理。
- 只操作工作目錄內的精確路徑,禁止通配符與目錄外路徑。
- 交付物、用戶已有文件、源碼、配置、依賴、
.git一律保留;不確定時保留並列出請用戶確認。 trash模式只移動不刪除,可從.dsh-trash/取回;插件不會自動清空回收目錄。- 刪除被拒絕或文件被佔用時,模型列出未處理項後結束,不重試。
安裝與啓用¶
已抓取資料中未給出統一的 CLI 安裝命令原文。安裝與版本要求請以 社區目錄頁 與倉庫 README 爲準。package.json 聲明的運行環境爲:
- Node:
>=22.19.0 - DSH:
>=0.2.1-rc.2 <0.3.0
插件以當前 DSH 進程權限運行;安裝前建議閱讀源碼與 MIT 許可證,確認是否符合你的環境策略。
啓用步驟可先照下面做:
- 按目錄頁或倉庫說明完成插件安裝。
- 在 設置 → 通用 選擇
mode(trash/delete)及是否defaultEnabled。 - 在需要做收尾清理的會話裏,打開輸入框左側掃帚圖標(本會話開關)。
典型用法¶
用法不需要額外 DSL:開啓會話開關後,讓模型完成會寫文件或跑 shell 的任務即可。當模型調用寫文件或 shell 類工具後,插件注入提醒;模型在同一回合、給出最終答覆前,按提示詞判斷是否已交付,再對本輪產生的臨時過程文件執行 trash 或 delete。
trash 時文件會進入類似路徑:
<工作區>/.dsh-trash/<會話>/turn-<輪次>/
需要保留中間產物時,保持會話開關關閉,或等 goal 仍 active 時插件會跳過提醒(便於長任務分多輪交付)。
維護者在倉庫中提供的自測命令如下,供開發或二次確認行爲時參考:
node test/policy.test.mjs # 純文案與路徑規則
node test/host.test.mjs # 提醒門控、會話隔離、路由(假 ctx / 假 agent)
適用場景與注意¶
適合:重構、生成腳本、批量改文件、本地構建調試等會在工作區留下明顯「過程垃圾」的智能體任務;希望清理發生在最終答覆之前、且仍走 DSH 既有工具審批鏈路的團隊。
注意:
- 清理責任在模型執行,插件只做準則與提醒;誤刪風險取決於模型是否遵守路徑與保留規則,重要任務建議先用
trash模式。 - 子代理在
skipSubagents: true時由父會話統一處理,避免重複提示。 - 社區目錄(SkillHub)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;星標與版本以各頁面實時信息爲準。
結尾¶
dsh-plugin-process-cleanup 把「任務收尾整理過程文件」嵌進 DSH 的同一回合工作流,而不是在答覆後再開一輪對話。若你經常在 Harness 裏跑文件型任務,可從目錄頁查看安裝說明,並在需要清理的會話打開掃帚開關試用。