前言¶
DeepSeek Harness（dsh）把模型、工具、会话、沙箱和界面都做成插件，官方口号是「一切皆插件」。开发者预览版的网页界面默认以对话为中心：智能体在工作区里读文件、写代码时，你往往还要另开终端或编辑器，才能看清目录结构和刚改过的内容。
社区插件 dsh-file-explorer 做的事情比较直接：在网页会话的标题栏加一个文件夹按钮，点开后在页面右侧出现可调宽度的文件树。Markdown 可以渲染，常见源码按扩展名高亮，面板里也能改文件并写回磁盘，需要完整 IDE 时再一键唤起 VS Code。
本文按社区插件目录页、GitHub 仓库 README、package.json 和源码交叉核对后整理。需要说明：DeepSeek Harness 本身由 DeepSeek AI 维护，仓库在 deepseek-ai/deepseek-harness；本文用到的插件目录 deepseek-harness-plugin.com 是独立的社区站点，与 DeepSeek / 幻方没有官方从属关系，不要把它当成官方应用商店。
这是什么¶
dsh-file-explorer 是一款面向 DeepSeek Harness Web 界面的文件资源管理器插件，由 GitHub 用户 joejojoking-cloud 维护，社区目录归在「工具与能力」分类。仓库当前版本为 0.1.3（package.json），主要语言是 JavaScript。目录页显示 14 星，GitHub 仓库当前为 15 星，数字会随时间变化，以打开页面时为准。
它解决的是网页会话里「看不到、不好找、不好改工作区文件」的问题，而不是再做一个独立 IDE。按 README 的定位，装好并重启 harness 后，所有会话都会加载该插件：host 侧提供 /plugins/file-explorer/* 路由，web client 负责右侧面板和标题栏按钮。
package.json 把许可证字段标为 MIT，但仓库根目录目前没有独立的 LICENSE 文件，GitHub 也未识别出许可证。安装前仍应自己打开源码核对。
核心功能¶
下面这些能力来自仓库 README，并与 lib/index.js、lib/client.js 对过，没有把未声明的功能写进去。
右侧文件树面板¶
插件把面板挂在 shell.overlay 上，从页面右侧滑出，可以开关。面板左边缘可拖拽调宽，README 给出的范围是 260–900px。面板打开时，左边缘中间有一个「>」收起按钮；双击聊天区域也可以把面板收回。
标题栏左侧写着「文件」，右侧是五个图标，功能分别是：
- 在 VS Code 中打开整个工作区
- 全部展开 / 全部折叠
- 刷新
- 进入编辑模式
- 关闭面板
会话标题栏右侧会多一个「文件资源管理器」按钮，用来开关面板。文件树以当前会话工作区为根，根目录默认展开；目录点击后懒加载子项，再点一次折叠。
搜索文件¶
面板上方有搜索框，占位符是「搜索文件」。搜索会递归扫描工作区，跳过 .git 和 node_modules，最多返回 300 条。host 侧实现里还有扫描节点上限（4000），达到上限时结果会带截断标记。匹配按文件名（及目录名）包含关系，大小写不敏感。
Markdown 预览与语法高亮¶
单击或双击文件会打开预览：
.md会渲染 Markdown，覆盖标题、列表、代码块、引用和链接；围栏代码块按语言高亮。- 其他文本文件按扩展名自动高亮。README 列出的语言包括 JSON、YAML、JS、TS、Python、C、C++、Java、Go、Rust、Shell、SQL、TOML、INI、CSS、HTML 等。高亮逻辑写在客户端里，没有额外运行时依赖。
- 超过 1 MB 的文件不支持预览，界面会提示过大。host 侧读取上限是
1_000_000字节，与 README 一致。 - 再次点击当前正在预览的文件，可以关掉预览框。
面板内编辑¶
点标题栏的「编辑」图标后，预览区变成可编辑文本。保存会通过 host 的 write 路由写回磁盘。这是真实写文件，不是会话里的临时草稿。
一键打开 VS Code¶
VS Code 图标会把当前工作区路径交给本机的 code 命令。host 侧优先用 subprocess 直接启动可执行文件；在 Windows 上如果解析到的是 .cmd 包装脚本，会尝试改走 Code.exe。找不到 code 时，返回「未找到 VS Code（code 命令不在 PATH 中）」。因此本机需要先能在终端里运行 code。
安装与启用¶
社区目录页给出的安装命令如下，在 DeepSeek Harness 终端里运行即可：
dsh plugin add github:joejojoking-cloud/dsh-file-explorer
这是目录页原文，不要自己按仓库名拼接。package.json 把客户端平台标成 web，README 的安装示例也带 --profile web。实际使用网页界面时，更稳妥的写法是装进 web profile：
dsh plugin --profile web add github:joejojoking-cloud/dsh-file-explorer
装完后需要重启 harness。README 写明：重启后所有会话才会加载该插件（host 路由 /plugins/file-explorer/* + web client 面板）。cordis.patch.yml 会把 id: file-explorer、name: dsh-file-explorer 插入当前 profile 的 host 组合，一般不用手工改补丁。
目录页建议可复现安装时固定 commit 哈希，模板是：
dsh plugin add github:joejojoking-cloud/dsh-file-explorer#commit
把末尾的 commit 换成仓库里的真实哈希。本文核对过的 main 最新提交是 9e1f3ea7baa43d737c51ffc68adb5eb95b024c32（2026-08-15，版本号升到 0.1.3）。固定安装可以写成：
dsh plugin --profile web add github:joejojoking-cloud/dsh-file-explorer#9e1f3ea7baa43d737c51ffc68adb5eb95b024c32
哈希会随仓库更新变化，安装前到 GitHub 再确认一次。
典型用法¶
下面步骤都来自 README 和实际界面文案，可以按同样顺序复现。
- 确认已经能打开 DeepSeek Harness 网页界面（官方仓库的常见入口是
npx @deepseek-ai/dsh web或源码里的pnpm dsh web）。 - 在终端执行上一节的
dsh plugin命令，然后重启 harness。 - 打开任意会话。标题栏右侧应出现文件资源管理器按钮，点击后页面右侧打开文件树。
- 在树里展开目录，单击某个
.md或源码文件，右侧预览区会渲染 Markdown 或带高亮的文本。 - 需要改文件时，点标题栏「编辑」，改完保存，内容写回工作区磁盘。不需要预览时，再点一次该文件即可关掉预览框。
- 文件较多时，用「搜索文件」按名称过滤；结果里不会出现
.git、node_modules下的路径。 - 需要完整编辑器时，点 VS Code 图标。若本机
code不在 PATH 中，这个按钮不会成功打开项目。
插件分两半，理解安装后的行为时可以用得上：
lib/index.js：host 侧，注册list/search/read/write/open-vscode五条 HTTP 路由，文件操作走 dsh 的fs服务。lib/client.js：web 客户端，注册shell.overlay面板和conversation.session.header.actions切换按钮。
适用场景与注意事项¶
比较适合这些情况：
- 主要在 DeepSeek Harness 网页界面里跟智能体协作，想顺手看工作区目录和刚生成的文件。
- 需要快速扫一眼 README、配置或源码，不一定每次都切到 VS Code。
- 改几行配置或 Markdown 后希望立刻写回磁盘，再让智能体继续跑。
使用前注意下面几条边界，都来自目录页或仓库实现，不是推测：
- 只面向 web profile。
package.json的dsh.client.platform是web。headless / TUI 会话不会出现这块面板。 - 预览有大小限制。超过 1 MB 的文件不会读入预览。
- 搜索不是全文检索。按路径名匹配，跳过
.git和node_modules，最多 300 条。 - 编辑会写盘。
write路由把内容交给fs.writeText。插件以当前 dsh 进程的权限运行，能改到进程能改到的文件。 - VS Code 依赖本机
code命令。没装 VS Code、或命令不在 PATH 里，这个按钮无效。 - 社区插件，版本仍早。当前是
0.1.3，仓库创建于 2026-08-14，API 和界面都可能继续改。社区里还有其他文件浏览类插件，名称相近，安装时认准joejojoking-cloud/dsh-file-explorer。
目录页的安全提示需要原样对待：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证；如需可复现安装，请固定 commit 哈希。
小结¶
dsh-file-explorer 把文件树、Markdown 预览、语法高亮、面板内编辑和 VS Code 唤起接到 DeepSeek Harness 的网页会话里，让对话界面少切一次窗口。它不是官方内置功能，也不是完整 IDE，但在 web profile 下足够用来看目录、读文档、改小文件。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-file-explorer/
GitHub：https://github.com/joejojoking-cloud/dsh-file-explorer
DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
