📂 dsh-file-explorer

给 DeepSeek Harness 的纯文本 Agent 装上一个「文件浏览器」。 一个右下角的浮动文件树，加一个与「对话」「轨迹」平级的预览页签——浏览工作区目录、预览文本和图片， 还能把文件直接拖进消息框（自动插入文件路径），无需切出对话。

✨ 为什么用它

纯文本模型(如 DeepSeek)没法直接「看」文件。这个插件把文件浏览和预览收进 Harness 界面里：

• 📁 浮动文件树 — 右下角一个按钮，点开即浏览当前工作区的目录树，可逐层展开
• 🗂️ 平级预览页签 — 点文件后，切到对话区顶部的「预览」页签(与「对话」「轨迹」并排)查看内容，不打断对话流
• 🎯 拖拽进消息框 — 把文件树里的文件(或目录)直接拖到消息输入框，松开即插入该文件的绝对路径， Agent 收到后可直接用 read 等工具读取，不用手动敲路径
• 🔄 实时跟随工作区 — 文件树根路径跟随当前会话的 cwd，切换工作区立即刷新
• 🔒 只读、安全 — 同源校验 + 路径规范化 + 条目/字节上限，不做写操作

🚀 快速开始

需要 DeepSeek Harness 的 Web profile 和 pnpm：

# 1. 克隆仓库
git clone https://github.com/cxzrdxy/dsh-file-explorer.git
cd dsh-file-explorer

# 2. 安装到 web profile（本地路径）
dsh plugin --profile web add file:.

重启 Web profile 即可。包内已提交编译好的 lib/，从 checkout 安装不需要消费端构建。

使用：

1. 点右下角 📁 按钮 → 打开文件树
2. 点某个文件 → 弹出提示「已打开「文件名」」
3. 点对话区顶部页签栏的「预览」→ 查看内容
4. 或直接把文件树里的文件拖到消息输入框 → 松开后文件路径自动插入消息文本，发送即可让 Agent 读取

📦 可预览的文件类型

类型	扩展名	大小上限
📄 文本	.txt .md .markdown .json .js .ts .tsx .jsx .css .html .htm .yml .yaml .xml .csv .log .py .c .cpp .h .cs .java .go .rs .sh .ps1 .sql .ini .cfg .toml .bat .cmd	512 KB
🖼️ 图片	.png .jpg .jpeg .gif .webp .bmp .svg .ico	8 MB
⚠️ 其他	二进制文件 → 显示大小提示，不预览内容	—

超出大小上限的文件会显示「文件过大」提示，不会被读取。

🏗️ 架构

单一 bundle 包，node half + browser half 同包(参照 @dsh-external/dsh-vision-toolkit)：

半	文件	作用
node half	lib/index.js / src/index.ts	同源文件 API(list/read/workspace)+ HTTP 路由 /_dsh/file-explorer/api
browser half	lib/client.js / src/client/*	文件树(shell.overlay)+ 预览页签(conversation.view)+ 消息框拖放目标(conversation.input.overlay)

文件树与预览页签通过 src/client/filePreviewStore.ts 模块级单例共享「当前预览文件」； 拖放目标 src/client/FileDropZone.tsx 经 ui-conversation 标准套件提供的 inputActions.setDraft 把拖入的文件路径写入消息草稿(路径经自定义 DataTransfer MIME application/x-dsh-file-path 传递)。

🔧 二次开发

源码随包提交，但 client bundle 的编译依赖 DSH 源码树(packages/client/tsdown.client.ts 的 clientBundle() 预设，以及 @deepseek-ai/dsh-client-* 的 workspace 类型)。要重新构建：

1. 把 src/ 放回一个 DeepSeek Harness checkout(host 半放 packages/host/、client 半放 packages/client/ui-file-explorer/)
2. 在 checkout 内运行 pnpm install + tsc -b + tsdown bundle
3. 把 lib/client.js、lib/index.js 覆盖回本包

⚠️ 已知限制

• 预览页签需手动切换(点文件后点「预览」页签)。自动跳转需要访问 ui-conversation 内部的 view store，当前 DSH 架构未对外暴露该能力
• 拖拽进消息框仅支持从文件树节点拖出(浏览器拿不到 OS 文件管理器中文件的绝对路径，File 对象不含 path)
• 只读(无编辑保存)

📄 License

MIT