dsh-workspace-hygiene：DeepSeek Harness 工作区卫生与工件价值评估插件

前言¶

在 DeepSeek Harness (DSH) 的使用场景中，长周期的任务会不断产生日志、代码和中间文件。这些文件堆积在磁盘上，虽然不直接消耗 token，但会增加搜索空间，导致更多的工具调用、上下文噪声和推理成本，最终降低推理性能。如何让智能体自动管理这些中间产物，保持工作区清晰，是当前需要解决的问题。

dsh-workspace-hygiene 针对这三个问题：保留哪些文件、如何命名、如何组织，提供了初步方案。

插件定位¶

dsh-workspace-hygiene 是一个 DeepSeek Harness 插件，用于代理工作区卫生：工件价值评估、元数据索引和可审核的清理。

维护者：taoshi1999
分类：工作流
许可证：MIT
核心价值：评估文件价值，提供目录结构和命名建议，减少冗余，提升后续检索效率。

核心功能¶

插件主要解决工作区文件的生命周期管理问题：

工件价值评估：评估文件是核心任务材料、最终交付物、可复用中间结果、临时调试记录还是可丢弃的冗余产物。
分类管理：将文件分类为 保护 / 有价值 / 中间 / 可丢弃 / 不确定 五类。
两种整理模式：
- 手动模式（默认）：后台进程监控文件变更，点击“整理工作区”生成计划，用户确认后执行。
- 自动模式：每次主 Agent 轮次结束后刷新评估。当扫描结果低于 cleanlinessThreshold（默认 80）时，向右侧的 hygiene-Agent 提交建议。用户可以生成详细计划或拒绝。未改变的建议会被抑制。
可视化与交互：
- 在 dsh web 中新增“工作区”标签页，左侧展示目录树和分类，右侧为独立的“hygiene-Agent”对话。
- 提供 CLI 工具 dsh-workspace-hygiene，用于评估文件价值并生成整理计划。
可审计性：分离评估与行动，保留回滚能力，防止误删。

使用示例¶

在 dsh web 中查看与操作¶

进入 DSH Web 界面，在“轨迹”标签页后找到新增的“工作区”标签页。
左侧展示当前会话工作区的目录结构、文件分类（保护/有价值/中间/可丢弃/不确定）以及清洁度评分。
右侧为专属的 hygiene-Agent 对话。在此处可以查看整理计划、审核文件动作或提出修改要求。
在页面顶部切换“手动”或“自动”整理模式，选择会保存在当前会话中。
点击“整理工作区”，系统会生成整理计划，确认后执行移动或删除操作。

使用命令行工具¶

确保环境满足依赖要求。
运行 dsh-workspace-hygiene 命令。
工具将扫描当前会话的工作区，评估文件价值，并输出整理计划。

环境与依赖¶

使用该插件需满足以下条件：

Node.js 版本：需要 ^22.19.0 或 >=24.0.0。
DSH 依赖：需要 @deepseek-ai/dsh-tools，版本需满足 >=0.1.1-rc.2 或 >=0.1.2-alpha.3。
传输协议：依赖 DSH 的 Connection RPC transport。
会话配置：需要会话 ID 来确定工作区根目录。配置中可使用 workspaceRoot 锚定部署边界。

总结¶

dsh-workspace-hygiene 通过系统化的评估与组织流程，帮助开发者保持工作区的整洁与可读性，减少不必要的上下文噪声，提升智能体在长任务中的推理效率。