前言¶
DeepSeek Harness（DSH）强调插件化扩展，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。对使用 dsh web GUI 的开发者来说，agent 在一轮会话中会创建、修改或下载文件，这些文件通常出现在当前会话的工作目录中，后续还需要手动查找路径、打开文件、预览图片或查看文本。
dsh-file-panel 是 DeepSeek Harness 的右侧文件面板插件。它在会话过程中跟踪 agent 创建或下载的文件，并把它们集中显示在右侧面板中，支持预览、打开、在文件夹中显示和复制路径。
定位与维护信息¶
dsh-file-panel 由 yu2025-luo 维护，许可证为 MIT。
它的核心用途是：在 dsh web 界面中提供一个右侧文件面板，显示当前会话中 agent 创建或下载的文件，并提供常见的文件查看与定位操作。
核心功能¶
dsh-file-panel 提供以下已核实能力：
- 当 agent 创建或下载文件时，自动弹出右侧面板。
- 新文件带
NEW标记。 - 图片可内联预览。
- 文本文件显示前 256 KB 内容。
- 其他类型文件显示元数据。
- 在操作系统文件管理器中选择并显示文件。
- 使用系统默认应用打开文件。
- 复制文件绝对路径。
- 提供打开当前会话工作区文件夹的快捷入口。
- 可切换新文件自动弹出。
- 可收起为浮动启动按钮，或隐藏面板。
安装与启用¶
从 GitHub 安装到 web profile：
dsh plugin --profile web add github:yu2025-luo/dsh-file-panel
插件集合在 dsh web 服务器重启后生效。安装完成后，重启 dsh web 服务器，并刷新：
http://127.0.0.1:3080
如果之后需要移除该插件：
dsh plugin --profile web remove dsh-file-panel
典型用法¶
安装并启用后，可以按下面的方式使用：
1、Agent 创建或下载文件后，右侧面板自动弹出，新文件带 NEW 标记。
2、点击某一行，可内联预览图片、文本或元数据。
3、悬停行上的操作，可执行预览、打开、在文件夹中显示或复制路径。
4、点击铃铛图标，切换新文件自动弹出。
5、点击 – / ×，将面板收起为浮动启动按钮或隐藏面板。
6、点击底部 open workspace folder，打开当前会话工作目录。
安全边界与运行限制¶
使用这个插件时，需要关注以下事实：
/file-panelRPC 通道限制为loopback authority，仅127.0.0.1页面可调用；网络访问时面板显示提示并保持不活动。- 读取/显示文件端点只接受 tracker 已观察到的绝对路径，不能作为通用文件读取接口。
- 插件以当前
dsh进程权限运行，安装前应检查源码与 MIT 许可证。 - 递归文件系统监视依赖
Node >= 20的fs.watch({ recursive: true })，在不可用平台上可能漏掉 shell 下载。 - 面板状态是进程本地，重启后为空，不会扫描历史文件。
- 默认忽略
node_modules、.git和临时文件噪声。 - 在 headless Linux 上
reveal可能报告canReveal: false并隐藏按钮。 - DeepSeek Harness 处于
pre-release，插件依赖的接口可能随dsh升级变化。
适用场景¶
dsh-file-panel 适合希望在 dsh web 会话中快速查看 agent 产出文件的开发者。它能减少手动查找文件、打开文件和复制路径的步骤，尤其适合会话中会产生图片、文本、日志、下载文件等产物的工作流。
如果依赖远程访问完整启用面板，或需要扫描历史文件、把文件读取端点用于通用文件读取，这个插件的边界不满足这些要求。
链接¶
GitHub：
https://github.com/yu2025-luo/dsh-file-panel
目录页：
https://www.skillhub.cn/plugins/yu2025-luo/dsh-file-panel
