dsh-file-explorer

File Explorer for DeepSeek Harness — right-side resizable file tree with a right-click context menu for file operations, Markdown rendering, syntax highlighting, in-panel editing, and one-click VS Code open. Install: dsh plugin --profile web add dsh-file-explorer.

DeepSeek Harness 的全局文件资源管理器插件，拆成两块：

• 侧边栏（右侧/左侧停靠面板，可开关）：文件目录树、搜索、右键菜单文件操作——保持传统侧边栏形态，不挤占中间区域（开关按钮在左下角设置按钮上方，始终可见）
• 「文件」固定父页签 + 可关闭子页签：标题栏出现 对话 | 轨迹 | 文件 三个固定页签；点「文件」进入编辑器，其下是可关闭的文件页签（页签名 = 文件名，带 × 关闭图标）。双击树中文件 → 自动跳转到「文件」父页签并新建子页签；窗口从标题栏下方盖到屏幕底部（聊天输入框被盖住），「对话」「轨迹」保持可见；切走再切回，页签和未保存内容都在（共享 store）。没有会话时（标题栏尚未出现），双击文件改用浮动窗口承载同样的子页签，产生会话后自动并入「文件」父页签下

本项目是 joejojoking-cloud/dsh-file-explorer（MIT）的定制化 fork：在它原有的文件树、搜索、Markdown/语法高亮预览、面板内编辑、一键 VS Code 打开等能力之上，增加了右键菜单文件操作（剪切/复制/粘贴/复制路径/重命名/回收站删除/新建文件与文件夹）、可关闭的文件页签编辑器、左右侧停靠切换等增强。详见文末「上游项目与致谢」。

功能

• 侧边栏（shell.overlay，左下角开关/标题栏「⇄」切左右侧）：文件树 + 搜索 + 右键菜单
• 文件树工具栏：「文件」+ 五个图标 —— VS Code（在 VS Code 中打开整个工作区）、全部展开/折叠、刷新、左右侧切换（⇄）、关闭
• 侧边栏宽度拖拽调宽（220–900px）
• 搜索框「搜索文件」：递归扫描工作区（跳过 .git / node_modules，最多 300 条）
• 文件树：根目录默认展开，目录点击展开/折叠（懒加载）；单击文件只选中，双击文件（或右键「打开」）新建一个文件子页签并自动切到「文件」父页签
• 「文件」父页签（conversation.view，与「对话」「轨迹」并列，固定）：承载可关闭的文件子页签；无会话时由 shell.overlay 浮动窗口承担相同内容
• 文件子页签：每个打开的文件一个页签，页签名即文件名，带 × 关闭图标；未保存的页签显示圆点，关闭时弹出「保存并关闭 / 不保存关闭 / 取消」确认；点击页签切换文件，编辑内容跨父/子页签切换保留；「关闭全部」一键清空
• 编辑（预览与保存二合一）：打开文件即进入可编辑文本框，Ctrl+S（Mac 为 Cmd+S）或点「保存」写回磁盘；「预览」按钮可切换 Markdown 渲染 / 代码语法高亮视图（JSON / YAML / JS / TS / Python / C / C++ / Java / Go / Rust / Shell / SQL / TOML / INI / CSS / HTML 等）；页签切换不丢未保存内容
• 超过 1 MB 的文件提示不支持编辑
• 右键菜单（文件/文件夹/根目录）：
  • 打开 / 展开 / 折叠
  • 剪切、复制、粘贴（剪切/复制进入剪贴板，粘贴到目录）
  • 复制绝对路径、复制相对路径（写入系统剪贴板）
  • 新建文件、新建文件夹（行内输入）
  • 重命名（行内输入）
  • 删除（面板内自绘确认框确认后删除到回收站，不依赖浏览器 confirm）
  • 刷新、在 VS Code 中打开

安装

dsh plugin --profile web add 

重启 harness 后生效：所有会话都会加载该插件（host 路由 /plugins/file-explorer/* + web client 面板）。

结构

• lib/index.js — host 半部：fs 服务 + webServer HTTP 路由（list / search / read / write / copy / move / rename / mkdir / create / delete / open-vscode）；文件写操作走 Node fs/promises，删除走 subprocess + PowerShell 回收站
• lib/client.js — web client 半部：window.__ModuleLoader__ bundle，注册 UI：shell.overlay 侧边栏文件树、sidebar.footer.action 左下角开关按钮、conversation.view 固定「文件」父页签 + shell.overlay 无会话时的浮动编辑器窗口（file-editor，两者共用 EditorChrome 和共享 store）；含右键菜单、剪贴板、行内重命名/新建、面板内自绘删除确认
• cordis.patch.yml — bundle 补丁，把 file-explorer 行插入 profile 的 host 组合

上游项目与致谢

本仓库是在 joejojoking-cloud/dsh-file-explorer（MIT 协议）的基础上做的定制化 fork。

上游项目是 DeepSeek Harness 的全局文件资源管理器插件，提供：右侧可拖拽调宽的文件树面板、递归文件搜索、Markdown 渲染与代码语法高亮预览、面板内编辑、一键在 VS Code 中打开项目，安装方式为 dsh plugin --profile web add dsh-file-explorer。

我们保留了上游的全部能力，并在此基础上做了以下定制化增强：

• 右键菜单文件操作：剪切 / 复制 / 粘贴、复制绝对/相对路径、重命名、新建文件与文件夹（行内输入）、删除（进回收站，面板内自绘确认框）
• 可关闭的文件页签编辑器：固定「文件」父页签下挂载可关闭的子页签（页签名 = 文件名，× 关闭，未保存圆点，Ctrl+S 保存），双击文件自动跳转
• 左右侧停靠切换（⇄）与宽度拖拽
• 无会话时的浮动窗口兜底：标题栏尚未出现时由浮动窗口承载文件页签

定制改动仅推送到本仓库，不覆盖上游；上游如有更新可自行更进