前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者根据需求扩展功能。在智能体开发中，直接在对话流中管理当前会话的文件是一个常见痛点。dsh-file-share 专注于解决这一问题，它通过在对话界面增加“文件”标签页，提供可视化的目录树和文件操作入口，让文件浏览、预览和管理无缝集成到对话上下文中。
这是什么¶
这是由 weibaohui 维护的 DSH 插件。它将文件浏览、预览和管理集成到当前的会话工作区上下文中，无需配置固定的外部目录。
核心功能¶
- 按会话工作区绑定文件树：文件树自动绑定到当前对话的工作区目录。
- 树形浏览：支持懒加载的目录树展示。
- 文件预览：支持文本、代码和图片预览，超大文件或二进制类型引导下载。
- 上传/下载：支持一键上传本机文件到当前目录，以及任意文件的下载。
- 批量打包下载：支持文件夹或多选文件批量打包为 zip，并保留目录结构。
- 目录管理：支持新建文件夹、重命名、删除、刷新和名称搜索过滤。
- @ 进对话框：点击“@”按钮将文件绝对路径注入输入框，供 agent 处理。
- 路径边界安全：所有操作锁定在会话工作区内，拒绝
../、绝对路径和软链逃逸。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add @weibaohui/dsh-file-share -w
安装完成后，重启 dsh web 即可生效。
典型用法¶
- 打开 Web UI，进入任意一个在当前实例中打开过的活跃会话。
- 在对话区顶部找到 「文件」 标签页（通常位于「工艺」旁），点击即可查看该会话工作区的目录树。
- 点击文件名可预览内容；悬停文件行可进行下载、@ 或重命名/删除操作；工具栏可进行上传、新建文件夹或搜索过滤。
- 上传、新建等操作作用于当前目录——点击目录名展开并切换目标目录。
- 想让 agent 处理某个文件：点击「@」将绝对路径注入输入框，回车后 agent 直接读取该文件。
适用场景与注意¶
- 适用场景：需要在对话中频繁读写当前会话工作区文件的 agent 开发场景。
- 注意：文件管理基于当前会话工作区，必须是在本实例中打开过的活跃会话；跨实例或未打开的旧会话无法访问。所有操作严格限制在会话工作区内，拒绝
../、绝对路径和软链逃逸。
短结尾¶
该插件为 DSH 用户提供了在对话上下文中直接操作文件的便捷方式，适合需要文件交互的 agent 场景。项目地址：GitHub。
