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

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

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

Xiaoye