dsh-file-explorer — 文件浏览器与多格式预览
为 DeepSeek Harness 增加一个与「对话」「轨迹」并列的 文件 标签:左侧是会话工作区的目录树, 右侧的预览会按文件本身决定形态 —— 渲染后的 Markdown(含 Mermaid 图表)、JSON 树、语法高亮源码、图片、 PDF,以及解包后的 Word / Excel / PowerPoint。只读、无需配置、不落任何数据。
| npm 包 | @jaxzhou/dsh-file-explorer(无作用域的 dsh-file-explorer 属于另一位作者) |
|---|---|
| 版本 / 许可 | v0.1.12 · MIT |
| 源码 | github.com/jaxzhou/dsh-file-explorer |
| 环境要求 | DeepSeek Harness 0.1.5-rc.2 或 0.2.0-rc.2 的 Web 界面(dsh web)—— 同一份产物同时兼容两者(0.2.0 改了图标集命名与按字节读取的接口形态,插件会在运行时探测);headless / SDK profile 没有浏览器,不会出现该标签 |
| 配置 | 无(cordis.yml 无需任何设置) |
$ dsh --profile web # bundle 成员在启动时读取
npm 信息
版本 / 说明 / 发布时间来自 npm registry,页面加载后会再校验一次最新版本。
npm registry 说明(英文原样): DeepSeek Harness plugin: a workspace file browser with a per-format preview (rendered Markdown, a JSON tree, 24 syntax grammars, images), shown as a Conversation View tab beside Chat and Trajectory
数据源 plugins.json · 由 tools/sync-plugins.py 从 npm registry 同步 ·
页面加载后自动向 npm 校验最新版本
演示
文件标签与对话、轨迹并列:左侧工作区目录树,右侧按格式预览;窗格控件以图标呈现(导出/下载、复制、源码切换)。
能力一览
| 类别 | 预览 |
|---|---|
| Markdown | 渲染为 GFM(标题、表格、任务列表、引用、公式、脚注、引用文件旁的图片、代码围栏,以及 Mermaid 图表),带 源码 切换与 导出 菜单 |
| HTML | 在沙箱 iframe 中当作页面绘制:文件自己的 CSS 生效,脚本运行于不透明源、无法触达本应用;带源码切换与导出 |
| 交给浏览器自带的 PDF 阅读器绘制(本地 blob),所以里面的文字是真文字,可选中、可搜索 | |
| Word / Excel / PowerPoint | .docx / .xlsx / .pptx 在页面内解包:文档的标题、列表、引用、表格、图片与代码,按文档自身携带的格式绘制 —— 每个 run 的字体、字号、粗体、斜体、下划线、删除线、上下标、颜色与高亮,以及每个段落的对齐、缩进与行距,全部沿文档的样式链解析(由样式而非 run 直接指定的格式也照文档的本意呈现);工作簿的每个 sheet 以网格呈现(以数字存储的日期按日期显示);幻灯片的文字与图片以大纲呈现。旧的二进制格式 .doc / .xls / .ppt 不预览,窗格会说明并提供下载 |
| JSON | 可折叠树,每个值可单独复制,带源码切换 |
| 源码 | 24 种语法高亮 + 行号 + 复制:TS/JS、shell、Python、Ruby、Go、Rust、Java、C/C++、C#、Kotlin、Swift、PHP、YAML、TOML、INI、HTML、CSS、SCSS、Less、SQL、XML、Lua、MDX |
| 图片 | PNG / JPEG / GIF / WebP / AVIF / BMP / ICO / SVG,自动适配窗格;SVG 经 <img> 绘制,脚本不执行 |
| 其它 | 带行号的纯文本;未映射后缀(.vue、.proto、.txt)保持纯文本,绝不猜一个错误的高亮 |
导出与下载
窗格工具栏只有一个 导出 按钮:第一行是 下载(保存文件本身,不做任何转换),因此对每种文件都在,包括窗格不预览的格式;渲染态的 Markdown / HTML 再多两行 PDF 与 Word。
| 格式 | 说明 |
|---|---|
| 下载(原文件) | 保存文件本身,而不是它的转换结果。大小不设上限:分窗读取 —— 32 MiB 以内直接交给浏览器下载,超过则询问保存位置并流式写入,内存占用不随文件增大;可同时进行多个下载,各自有进度与「取消」 |
| 页面的图像:按 A4 排版并分页切分;文字不可选中(刻意取舍,避免内嵌数 MB 的 CJK 字体)。注意与预览 PDF 文件不同:预览走浏览器自己的阅读器,文字可选中 | |
| Word(.docx) | 真正的 Word 文档:标题、列表、引用、表格、代码与图片都在,并写入文档自身的字符格式(字体、字号、粗斜体、下划线、删除线、上下标、颜色、高亮)与段落的对齐 / 缩进 / 行距;文字仍可编辑、可搜索,中文交给 Word 自己的字体渲染 |
| Mermaid 图表 | 图只画一次成 PNG:预览、导出的 PDF 页与 Word 文档用的是同一张图,所见即所得;图内文字因此不可选中、底色固定为白 |
隐私与权限
- 1只读读取走 Harness 自带的
workspaceFilesRemote 命名空间,可读性由 Host 的文件系统决定;插件不持有文件权限、不做路径解析、不接触凭据。 - 2不落数据不写磁盘、不写会话日志;视图状态保存在内存中,随会话释放。
- 3Host 半边是空实现包的 Node 侧不注册任何服务、工具、提示词片段或事件。
- 4沙箱边界HTML 预览在不透明源中执行;导出前先剥除脚本;SVG 经
<img>绘制,脚本完全不执行。
已知限制
- 1只预览,不编辑没有编辑、保存、diff,也不监听文件变化。
- 2JSON 按严格语法解析JSONC(注释 / 尾逗号)会提示原因并回退到高亮源码。
- 3文本预览上限 2000 行会明确提示已截断,没有「加载更多」。
- 4无搜索 / 重命名 / 右键菜单仅目录列表;已加载的预览最多保留最近 5 个标签的内容。
- 5单一根目录目录树以会话工作目录为根,Host 拒绝列出工作区之外的目录。
- 6导出的篇幅上限超长文档在 60 页 PDF 处截断;单张超过 8 MiB 的图片会被跳过;Markdown 旁图每篇最多 24 张、单张 8 MiB。
- 7预览有 32 MiB 读取上限,下载没有预览受「一次性完整读取」限制(默认 32 MiB),超过会明确说明而不是截断显示;下载分窗读取、不设上限,所以预览不了的大文件照样能保存(超过 32 MiB 走浏览器保存对话框流式写入)。
- 8Office 预览是「内容 + 文档格式」,不是排版引擎
.docx/.xlsx/.pptx会沿样式链还原字符格式与段落的对齐 / 缩进 / 行距,但仍不还原需要排版引擎的部分:分栏与分页、页眉页脚、表格边框与底纹、文本框、图表与动画;主题字体不解析(声明了主题字体的 run 用页面默认字体)。公式显示文件缓存的值而非重算。旧格式.doc/.xls/.ppt不预览。 - 9Mermaid 图是图片图表先渲染成 PNG,预览与两种导出共用同一张图,因此图内文字不可选中、底色固定为白;解析失败的图保留源码并说明原因。
常见问题
这个插件能编辑文件吗?
不能。它只做预览:不编辑、不保存、不做 diff,也不监听文件变化;某一层内容通过「重新读取」更新。
为什么打开 tsconfig.json 显示的是源码而不是 JSON 树?
插件按严格 JSON 语法解析,注释或尾逗号会让文件变成 JSONC 并被 JSON.parse 拒绝。此时窗格会说明原因并展示高亮源码,而不是勉强猜出一棵树。
支持哪些文件类型?
Markdown(渲染 + 源码,含 Mermaid 图表)、HTML(沙箱预览)、JSON(折叠树)、PDF(交给浏览器自己的阅读器)、Word / Excel / PowerPoint(.docx / .xlsx / .pptx 在页面内解包)、24 种语法的源码高亮、图片(PNG/JPEG/GIF/WebP/AVIF/BMP/ICO/SVG),其余按纯文本展示;文本预览上限 2000 行,截断会明确提示。旧的二进制格式 .doc / .xls / .ppt 不预览。
Mermaid 图和 Office 预览有什么限制?
Mermaid 图会先画成一张 PNG,预览、导出的 PDF 页与 Word 文档用的是同一张图,所以图内文字不可选中、底色固定为白,Mermaid 解析不了的图会保留源码并说明原因;Office 预览会沿文档的样式链还原内容与格式 —— .docx 显示标题、列表、引用、表格、图片与代码,并保留字体、字号、粗体、斜体、下划线、删除线、上下标、颜色、高亮,以及段落的对齐、缩进与行距(由样式指定而非 run 直接指定的同样生效);.xlsx 的每个 sheet 以网格显示(数字日期按日期显示);.pptx 以文字与图片大纲显示。仍不还原分栏与分页、页眉页脚、表格边框底纹、文本框、图表与动画,主题字体也不解析。
下载大文件会占用大量内存吗?
不会随文件变大:下载是分窗读取的。32 MiB 以内直接交给浏览器下载;超过则在支持 File System Access 的浏览器里询问保存位置并流式写入,内存占用保持平坦(260 MB 的 release 压缩包也能这样保存)。不支持该 API 的浏览器会先把文件收齐,此时超大下载才会占用自身大小的内存。多个下载可同时进行,各自有进度与「取消」。
预览里的 HTML 安全吗?会执行脚本吗?
HTML 预览在一个不透明源的沙箱 iframe 中绘制,脚本无法触达本应用的 DOM、存储或会话;SVG 经 <img> 绘制,其中的脚本不会执行;导出时会先剥除脚本再打印。
导出的 PDF 为什么不能选中文字?
PDF 是页面的图像(按 A4 排版分页),文字不可选中是刻意取舍 —— 文本模式生成中文 PDF 需要在插件里内嵌 CJK 字体(数 MB)。需要可编辑、可搜索的文字请导出 Word(.docx)。