前言¶
在 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 里跑文件型任务,可从目录页查看安装说明,并在需要清理的会话打开扫帚开关试用。