Skip to content

dsh-file-share

Verified

@weibaohui/dsh-file-share · v0.3.2 · Web UI

dsh 插件 · 会话工作区文件管理:在对话区加「文件」tab,浏览当前会话工作区的目录树并就地管理(预览/上传/下载/新建文件夹/改名/删除/搜索),文件夹与多选文件可打包 zip 下载,文件可 @ 进对话框给 agent 处理。

Install

dsh plugin add @weibaohui/dsh-file-share

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

@weibaohui/dsh-file-share

DSH plugin npm version

会话工作区文件管理插件:在对话区顶部加一个「文件」tab,点开即可浏览、预览并管理当前会话工作区下的所有文件。

demo

核心功能

  • 按会话工作区:文件树绑定到当前对话的工作区目录(ctx.sessions.get(sessionId).header.cwd),不用配置任何固定目录
  • 树形浏览:目录树懒加载、逐层展开,文件大小一眼可见
  • 预览 / 查看:点文件名或行内「预览」弹出查看面板——文本/代码直接显示、图片内联渲染;超大文件或二进制类型引导下载或交给 agent
  • 上传 / 下载:一键上传本机文件到当前目录(可多选);任意文件可下载
  • 文件夹下载 / 多选打包:悬停目录行「下载」整目录打包 zip;勾选多个文件与文件夹(可混选)批量打包,zip 内保留相对目录结构(零依赖内置 ZIP 构建,条目数 / 总大小双上限,符号链接逃逸的条目自动跳过)
  • 目录管理:新建文件夹 / 改名 / 删除(目录递归、带确认)/ 刷新 / 名称过滤搜索
  • @ 进对话框:文件行点「@」把 @绝对路径 注入输入框,agent 直接处理该文件
  • 路径边界安全:所有操作锁定在会话工作区内,../、绝对路径、软链逃逸一律拒绝

安装

dsh plugin --profile web add @weibaohui/dsh-file-share -w

装完重启 dsh web 即生效。

使用

  1. 打开 Web UI,进入任意一个会话(或新建会话)
  2. 对话区顶部找到 「文件」 tab(跟在「工艺」旁),点开即见该会话工作区目录树
  3. 点击文件名可预览内容;悬停文件行可 下载 / @ / 改名 / 删除;工具栏可上传、新建文件夹、搜索过滤
  4. 上传、新建等操作作用于当前目录——点目录名展开并切换目标目录
  5. 想让 agent 处理某个文件:点「@」把 @路径 注入输入框,回车后 agent 直接读取

提示:文件管理基于会话工作区,需在本实例中打开过的活跃会话;跨实例或未打开的旧会话会提示原因。

联系我 :飞书群

link

版本兼容性

本插件与 DeepSeek Harness(@deepseek-ai/dsh)的版本对应关系:

插件版本 适配 dsh 版本 备注
0.3.2 0.1.7-rc.2 当前版本,已在 @deepseek-ai/[email protected] 下验证运行

发版约定:每次发布新版本时,请在上表追加一行,记录该插件版本实际验证所用的 @deepseek-ai/dsh 版本。package.json 的 engines.dsh 声明最低支持版本;本表记录实际验证版本,二者配合使用。