前言¶

在用 DeepSeek Harness（DSH）开发或调试智能体时，经常需要确认「这一轮到底生成了哪些文件」「哪些是实际写入的、哪些只是被提到」。如果没有一个集中的、按轮次列出的视图，逐个查看终端输出、日志和文件系统会非常低效。

这是什么¶

dsh-turn-files 是一个 DeepSeek Harness 原生插件，由维护者 yxue301603 开发。它把 DSH 中真实交付的文件与成功的文件改动按轮次集中列出，支持按文件名、路径、说明搜索，支持按「交付文件」「改动清单」「工具写入」筛选，并能逐个或批量复制路径，并在 DSH 右侧原生面板中预览文件。

核心功能¶

1. 按轮次列出本轮文件与改动
   - 来自原生 deliverables/presented、workspace/changes 事件以及成功的 write、edit、str_replace_editor 调用。
   - 仅显示真实交付与成功改动的文件；读取操作、失败写入、回答中随意提到的路径不会混入；终端命令创建但未交付、也未进入改动清单的文件无法自动识别。

2. 搜索与筛选
   - 支持按文件名、路径、说明搜索。
   - 支持按「交付文件」「改动清单」「工具写入」筛选。

3. 路径复制与预览
   - 支持逐个复制路径，或批量复制路径。
   - 在 DSH 右侧原生面板中预览文件。

4. 打开所在目录
   - 对于有原生授权记录的交付文件和改动文件，桌面宿主提供「打开所在目录」。
   - 打开所在目录通过 DSH 官方接口使用事件坐标，由宿主再次验证文件权限。
   - 文件已移动、删除或宿主不支持时会明确报错。

5. 历史扩展
   - 仅显示当前已加载历史，可通过「加载更早轮次」扩展。

6. 其他说明
   - 插件不执行 Shell 命令，也不会把模型返回的路径当作系统命令执行。
   - 支持中英文、深浅主题。
   - 无模型调用、无外部网络传输。

安装与启用¶

在 DSH 中打开「插件 → 添加插件」，粘贴以下地址并安装：

https://github.com/yxue301603/dsh-turn-files

安装并启用后，按 DSH 提示重新加载。仓库已包含预构建文件，无需自行编译。

系统要求 DSH 0.2.1-rc.2 或兼容的 0.2.x 版本。迁移、整套安装与升级说明见 工具箱安装指南。

典型用法¶

1. 在 DSH 的输入框旁点击「本轮文件」按钮，即可进入本轮文件列表视图。
2. 在列表中，你可以：
   - 使用搜索框按文件名、路径、说明筛选。
   - 通过筛选器切换「交付文件」「改动清单」「工具写入」。
   - 逐个或批量复制文件路径。
   - 在右侧原生面板中预览文件。
   - 对于有原生授权的文件，使用「打开所在目录」跳转到文件所在目录。

适用场景与注意¶

适合需要精确掌握本轮生成或修改了哪些文件的开发与调试场景，尤其是需要频繁查看交付文件与改动清单时。

插件以当前 DSH 进程权限运行。安装前建议检查源码与许可证（MIT）。

结尾¶

dsh-turn-files 通过按轮次集中展示交付文件与改动，为 DSH 使用者提供了一份清晰的「本轮文件清单」，便于快速定位刚生成的文档、图片和代码。如需查看目录页与源码，可访问：
- DSH 插件目录页
- GitHub 仓库