前言¶
在用 DeepSeek Harness（DSH）开发或调试智能体时，经常需要确认「这一轮到底生成了哪些文件」「哪些是实际写入的、哪些只是被提到」。如果没有一个集中的、按轮次列出的视图，逐个查看终端输出、日志和文件系统会非常低效。
这是什么¶
dsh-turn-files 是一个 DeepSeek Harness 原生插件，由维护者 yxue301603 开发。它把 DSH 中真实交付的文件与成功的文件改动按轮次集中列出，支持按文件名、路径、说明搜索，支持按「交付文件」「改动清单」「工具写入」筛选，并能逐个或批量复制路径，并在 DSH 右侧原生面板中预览文件。
核心功能¶
-
按轮次列出本轮文件与改动
- 来自原生deliverables/presented、workspace/changes事件以及成功的write、edit、str_replace_editor调用。
- 仅显示真实交付与成功改动的文件；读取操作、失败写入、回答中随意提到的路径不会混入；终端命令创建但未交付、也未进入改动清单的文件无法自动识别。 -
搜索与筛选
- 支持按文件名、路径、说明搜索。
- 支持按「交付文件」「改动清单」「工具写入」筛选。 -
路径复制与预览
- 支持逐个复制路径，或批量复制路径。
- 在 DSH 右侧原生面板中预览文件。 -
打开所在目录
- 对于有原生授权记录的交付文件和改动文件，桌面宿主提供「打开所在目录」。
- 打开所在目录通过 DSH 官方接口使用事件坐标，由宿主再次验证文件权限。
- 文件已移动、删除或宿主不支持时会明确报错。 -
历史扩展
- 仅显示当前已加载历史，可通过「加载更早轮次」扩展。 -
其他说明
- 插件不执行 Shell 命令，也不会把模型返回的路径当作系统命令执行。
- 支持中英文、深浅主题。
- 无模型调用、无外部网络传输。
安装与启用¶
在 DSH 中打开「插件 → 添加插件」，粘贴以下地址并安装：
https://github.com/yxue301603/dsh-turn-files
安装并启用后，按 DSH 提示重新加载。仓库已包含预构建文件，无需自行编译。
系统要求 DSH 0.2.1-rc.2 或兼容的 0.2.x 版本。迁移、整套安装与升级说明见 工具箱安装指南。
典型用法¶
- 在 DSH 的输入框旁点击「本轮文件」按钮，即可进入本轮文件列表视图。
- 在列表中，你可以：
- 使用搜索框按文件名、路径、说明筛选。
- 通过筛选器切换「交付文件」「改动清单」「工具写入」。
- 逐个或批量复制文件路径。
- 在右侧原生面板中预览文件。
- 对于有原生授权的文件，使用「打开所在目录」跳转到文件所在目录。
适用场景与注意¶
适合需要精确掌握本轮生成或修改了哪些文件的开发与调试场景，尤其是需要频繁查看交付文件与改动清单时。
插件以当前 DSH 进程权限运行。安装前建议检查源码与许可证（MIT）。
结尾¶
dsh-turn-files 通过按轮次集中展示交付文件与改动，为 DSH 使用者提供了一份清晰的「本轮文件清单」，便于快速定位刚生成的文档、图片和代码。如需查看目录页与源码，可访问：
- DSH 插件目录页
- GitHub 仓库
