dsh-plugin-process-cleanup:DSH 任務收尾清理過程文件

前言

在 DeepSeek Harness(DSH)裏跑寫文件、改代碼、執行 shell 的任務時,工作區常會留下腳本中間產物、一次性構建目錄或調試輸出。這些文件不一定該長期留在倉庫裏,但模型在給出「最終答覆」之後又單獨跑一輪清理,容易把真正的答覆擠進摺疊的過程區,界面上的最後一條消息變成清理說明而不是你要看的結論。下面介紹社區插件 dsh-plugin-process-cleanup(維護者 zh-Littlebird),它用提示詞與工具回調後的提醒,讓模型在同一回合內、最終答覆之前完成「任務是否結束」的判斷與過程文件整理,且清理動作仍由模型通過會話里正常的 shell 工具執行,沙箱、審批與審計鏈路不變。

這是什麼

dsh-plugin-process-cleanup 歸類爲工作流。一句話定位:在會產生文件的任務裏,提醒模型先清理本輪過程文件,再給出最終答覆;支持直接刪除或移入工作區 .dsh-trash 回收目錄。插件自己不判斷、不刪文件——它把清理準則寫入系統提示詞,並在 write / edit / shell 等工具調用之後追加通知類提醒,由模型按規則執行移動或刪除。

設計要點(來自倉庫說明):插件不會在最終答覆之後再追加一步模型動作;提醒只出現在過程裏,最後一條助手消息始終是面向用戶的答覆。

核心功能

會話開關與全局配置

開關是會話級的:每個會話在輸入框左側有獨立的掃帚圖標開關,默認關閉;打開隻影響當前會話。設置 → 通用裏是全局項:清理方式、新會話是否默認開啓。

字段 默認 說明
defaultEnabled false 新打開的會話是否默認開啓收尾清理。
mode trash trash:移到工作區 .dsh-trash/<會話>/turn-<輪次>/;delete:直接刪除。
skipSubagents true 子代理會話不單獨提示,由父會話統一處理。

會話開關保存在 Host 進程內,隨會話關閉清除;重啓後會話回到「默認關閉」(或受全局 defaultEnabled 影響的新會話初始狀態)。

何時觸發提醒

滿足以下條件時,插件在工具調用之後追加一次提醒:

  1. 當前會話開關打開;
  2. 調用的是 write / edit / pwsh / bash / 子代理類工具(寫文件、改文件每次提醒;shell 與子代理每回合最多一次);
  3. 是根會話(子代理默認跳過);
  4. 沒有進行中的目標(goal 爲 active / paused / blocked 時跳過,complete 後照常);
  5. 本輪不是失敗的寫入。

系統提示詞裏的常駐準則只在滿足 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 許可證,確認是否符合你的環境策略。

啓用步驟可先照下面做:

  1. 按目錄頁或倉庫說明完成插件安裝。
  2. 在 設置 → 通用 選擇 mode(trash / delete)及是否 defaultEnabled。
  3. 在需要做收尾清理的會話裏,打開輸入框左側掃帚圖標(本會話開關)。

典型用法

用法不需要額外 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 裏跑文件型任務,可從目錄頁查看安裝說明,並在需要清理的會話打開掃帚開關試用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜