前言¶
在 DeepSeek Harness（DSH）里做本地项目时，会话往往绑定一个工作目录，但要在界面里浏览目录、改文件名、把某个路径丢进聊天输入框，仍常要切回系统文件管理器或手打路径。DSH 社区里已有各类客户端扩展；DSH Folder Explorer（仓库 wx-98/DSH-folder）把一块 VSCode 风格的文件树放进 Web/Desktop 右侧栏，并在 Host 侧提供受控的本地文件 API。下面介绍它是什么、能做什么，以及如何安装与日常使用。
这是什么¶
DSH Folder Explorer 是维护者 wx-98 发布的 DSH 客户端类插件（社区目录：skillhub.cn 插件页）。官方简介：在 DSH 中提供 VSCode 式文件树、类型图标、文件操作，以及 Add to Chat（添加到对话）。
插件类型为 Cordis 插件 bundle（Host 半边 + Web Client 半边），不是皮肤、TUI 或独立桌面客户端。Host 侧 index.js 注册 /folder-explorer/* 路由；浏览器侧 client.js 在右侧栏注册 folder-explorer 标签类型。无构建步骤、无 npm 运行时依赖。许可证 MIT。
核心功能¶
文件树与图标¶
打开任意本地文件夹后可在树中懒加载浏览：目录优先排序，隐藏文件可见。文件类型带 VSCode 风格图标（TypeScript、JavaScript、JSON、Markdown、图片、压缩包、Office、Shell、配置、锁文件等）；常见目录名（如 .git、node_modules、src、dist 等）有专属文件夹图标。图标子集来自 MIT 许可的 Material Icon Theme（见仓库 docs/THIRD_PARTY_NOTICES.md）。
自动刷新：Host 侧 watch 变化后约 ≤2s 更新；不可用时轮询降级约 ≤5s。切换标签或预览后保留展开、选中与滚动状态，也可手动刷新。
文件操作与快捷键¶
右键菜单支持：复制绝对/相对路径、行内重命名、新建文件/文件夹、删除（二次确认后永久删除）、复制/粘贴（冲突时可保留两者、跳过或覆盖）、在 Finder/资源管理器中显示（依赖宿主 Session Remote，不可用时菜单隐藏）。
树获得焦点后可用键盘：↑/↓ 移动，→/← 展开折叠，Enter 打开，F2 重命名，Delete 删除，Cmd/Ctrl+C/V 复制粘贴，Esc 关闭浮层。单击文件用 DSH 内置文档预览打开（工作区外的绝对路径同样可用）。
添加到对话¶
在文件树右键、已打开文件的预览头部，或 tab 右键，可将文件/文件夹作为 @ 引用写入当前会话聊天输入框（类似 Cursor）：不读取文件内容、不自动发送、保留已有草稿。
界面与语言¶
中文/英文文案，跟随宿主深色/浅色主题。
安装与启用¶
前置：DSH Web/Desktop 0.2.1-rc.5。插件声明 dsh.bundle.patch 与 dsh.client，支持 GitHub、npm 与本地目录安装。
从 GitHub 安装¶
GUI：Plugins → Add plugin → Install a third-party plugin → 填写 github:wx-98/DSH-folder 或 https://github.com/wx-98/DSH-folder.git → 安装后启用 bundle 对应 row。
CLI（dsh 在 PATH 中）：
dsh plugin --profile <profile> add github:wx-98/DSH-folder
从 npm 安装¶
包名 dsh-folder-explorer。README 记载 npm 已发布 dsh-folder-explorer@0.2.0（2026-11-01）；package.json 中当前版本为 0.2.1（2026-11-02 更新记录）。
GUI：Plugins → Add plugin → 包名 dsh-folder-explorer。
CLI：
dsh plugin --profile <profile> add dsh-folder-explorer
本地开发安装¶
在 DSH GUI：Plugins → Add plugin → 本地绝对路径，填入插件仓库目录的绝对路径。本地 link 安装时，修改 client.js 可由 dsh-client-hmr 热替换；Host 半边改动需经 profile 重组生效。
典型用法¶
经过上面的安装与启用步骤后，可按 README 中的顺序操作：
- 在右侧栏标签向导打开 Folder Explorer（或从标签栏「+」选择）；
- 默认根目录为当前会话工作目录；工具栏 打开文件夹… 可切换到任意本地目录（最近一次根会记住）；
- 单击文件在右侧预览；目录行单击展开/折叠；
- 右键打开行级菜单；需要把路径交给模型时，用 添加到对话 写入输入框。
安全边界与限制¶
每个文件操作先经 DSH 连接信任栅栏（Host/Origin 校验 + 登录 cookie）。路径限定在用户显式打开的根目录内，经规范化与 realpath 复核，拒绝 .. 或符号链接逃逸。删除需显式确认；复制/移动不允许把目录放进自身。变更在 Host 内串行执行，不产生模型可见事件。
注意：插件以当前 dsh 进程权限访问磁盘；安装前应自行查看源码与 MIT 许可证，并确认只打开可信根目录。
已知限制（README）：删除不进废纸篓；暂不支持拖拽移动、多选批量、全文搜索、跨根全局索引；目标 DSH 0.2.1-rc.5，升级后建议回归。更多设计说明见仓库 docs/folder-explorer-plugin.md、docs/file-icons.md、docs/add-to-chat.md。
结尾¶
DSH Folder Explorer 把本地目录浏览、常见文件操作和「@ 路径进聊天」收进 DSH 右侧栏，适合在 Harness 里长时间盯着一个项目目录的开发者。社区插件目录与 GitHub 相互独立，并非 DeepSeek 官方应用商店。
- 目录页：https://www.skillhub.cn/plugins/wx-98/DSH-folder
- 源码与 README：https://github.com/wx-98/DSH-folder
