本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-file-explorer

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:joejojoking-cloud/dsh-file-explorer

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 右侧面板（shell.overlay，可开关）：左边缘拖拽调宽（260–900px），面板打开时左边缘中间有「>」收起按钮，双击聊天区域也可收回
• 标题栏：「文件」+ 五个图标 —— VS Code（在 VS Code 中打开整个工作区）、全部展开/折叠、刷新、编辑、关闭
• 搜索框「搜索文件」：递归扫描工作区（跳过 .git / node_modules，最多 300 条）
• 文件树：根目录默认展开，目录点击展开/折叠（懒加载），文件单击/双击打开预览
• 超过 1 MB 的文件提示不支持预览

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后看不到文件资源管理器面板怎么办？

插件依赖 host 端的 webServer/httpServer、fs 服务以及 client 端的 slots 服务。安装后需要重启 DSH harness 让 cordis.patch.yml 生效；若仍不显示，检查 profile 是否启用了 web 客户端，以及 DSH 版本是否兼容。

文件树显示空白或搜索不到文件怎么办？

搜索会跳过 .git 和 node_modules 目录，且最多扫描 4000 个节点、最多返回 300 条匹配，命中上限后会标记 truncated。检查根路径是否设置正确，或者目录里是否几乎全是 .git/node_modules。

点文件预览出现"不支持预览"提示是怎么触发的？

host 端对大于 1 MB 的文件不会返回内容，client 会显示"不支持预览"。属于刻意的安全限制，避免大文件把内存或 UI 卡住。

在 VS Code 中打开按钮没有响应怎么办？

host 端优先通过 subprocess 直接 spawn code 可执行文件（Windows 下从 code.cmd 推导 Code.exe），找不到时回退到沙箱化 shell 的 Start-Process。两种方式都需要宿主机上能解析到 code 命令（PATH 中或 VS Code 已安装）；都没找到时返回 ok:false 并提示"未找到 VS Code"。

在面板里编辑文件会写到哪里？

编辑器调用 host 的 /plugins/file-explorer/write 路由，通过 host 端的 fs 服务把 content 写回到 fs.resolve(path) 解析出的目标路径，等价于用工作区文件系统的当前挂载点落盘。保存后会立即在面板刷新状态。

这个插件跟其他 DSH 插件冲突吗？

没有 manifest 级冲突。它只占用 shell.overlay 和 conversation.session.header.actions 两个 slot，不读写全局配置；不过同位置的其他 overlay 插件会按 order 排序共存。

如何卸载这个插件？

卸载方式取决于你当初安装时使用的包源（npm 包名、本地路径或 GitHub 地址）。一般通过 dsh plugin --profile web remove <源标识> 卸载后重启 harness 即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则