前言¶
DeepSeek Harness（dsh）采用插件化架构，扩展能力通常通过安装外部包实现。在 Agent 开发过程中，工具调用会产生文件（如 write 操作），这些文件分散在不同的会话中。若要回顾 Agent 在所有对话中产出的内容，需要在各个历史会话间切换。下面介绍的 @kksw/dsh-my-files 是一个 Web 客户端插件，它在 dsh 的侧边栏添加一个入口，集中展示所有会话中 Agent 创建或修改过的文件。
插件简介¶
- 名称：
@kksw/dsh-my-files - 维护者：kksw1024
- 定位：DeepSeek Harness Web 插件
- 核心价值：提供跨会话的文件索引与统一查看面板。
核心功能¶
该插件实现以下能力：
- 侧边栏入口：在侧边栏设置齿轮（Settings）上方新增“我的文件”入口，图标为文件夹，尺寸与风格与设置按钮保持一致。
- 跨会话索引：自动记录每个会话中工具调用创建或修改的文件（如
write等）。历史会话在插件加载时会自动回放并补齐索引。 - 两栏面板：面板采用左右分栏布局。左侧按会话列出，显示会话名与文件数量；右侧展示选中会话的文件列表。点击面板外的灰色蒙版或关闭按钮可退出面板。
- 文件交互：文件名支持悬停高亮与下划线样式。点击文件名调用系统默认应用打开文件；点击文件名后的文件夹图标可打开文件所在目录。
- 持久化：文件索引存储于 dsh 的 storage 领域，重启 dsh 后数据仍在。
安装与启用¶
在安装前，需确保使用的是 DeepSeek Harness Web 版本，且 dsh 版本不低于 0.1.0-rc.5。
- 执行安装命令：
dsh plugin --profile web add @kksw/dsh-my-files
- 重启 dsh：
dsh --profile web
- 刷新浏览器页面，在侧边栏底部（设置齿轮上方）即可看到“我的文件”入口。
典型用法¶
- 点击侧边栏的“我的文件”打开面板。
- 在左侧列表中选择一个会话，右侧面板会显示该会话产出的文件。
- 点击文件名即可在系统默认应用中打开文件；点击文件名右侧的文件夹图标可打开文件所在目录。
- 若需要更新索引（例如刚进行了新的工具调用），点击面板右上角的刷新按钮重新拉取。
注意事项与限制¶
- 索引范围：仅统计工具调用明确声明为“创建/修改”的文件。通过终端命令间接创建的文件不计入索引。
- 冷会话回放：在冷会话回放场景下，仅注册在某 Agent Preset 内的工具可能缺失 presenter，可能导致索引不完整（实时调用不受影响）。
- 信任边界：查询路由以
loopback为信任边界。 - 运行环境：文件打开与目录跳转依赖宿主环境的原生 opener（macOS / Windows 桌面环境）；在无原生 opener 的部署环境（如 headless 或远程）中点击无反应。
结语¶
该插件通过统一的侧边栏入口，解决了 Agent 开发中文件散落难查的问题，适合需要在多个会话中追踪工具产出成果的开发者使用。
