dsh-file-explorer

DeepSeek Harness（DSH）Web UI 的侧边文件浏览器：不离开聊天界面就能浏览工作区文件、预览内容，面板可停靠、可浮动。

✨ 功能特性

• 懒加载目录树：按需展开工作区目录，目录在前、文件带大小；默认隐藏 node_modules、.git 等（可切换显示）
• 文件预览 + 内联编辑：点击文件在面板内预览；文本文件可进入编辑模式（Ctrl+S 保存，带磁盘冲突检测）；超大文件自动截断、二进制文件自动识别；预览区高度可拖动
• IDE 式右键菜单：树中右键即可——新建文件（txt / py / md / json / js / ts / html / css 等模板）、新建文件夹、重命名、复制、粘贴（同名自动加 (1) 后缀）、复制绝对路径 / 相对路径、删除（移入系统回收站）
• 实时刷新：新建 / 重命名 / 粘贴 / 保存 / 删除后树即时更新，无需手动刷新
• 工作区自动跟随：切换会话/工作区后约 1 秒内自动切换到对应目录
• 三种停靠模式：右侧（挤压对话栏，不遮挡）/ 中间 / 浮动（自由拖动 + 四边四角缩放）
• 悬浮球：侧边可拖动入口，可随时开关
• 偏好记忆：面板位置/尺寸/停靠模式/预览高度/悬浮球开关全部本地记忆

安装

前置要求

• DSH 0.1.0-rc.6，Windows（路径处理按 Windows 习惯）
• 官方安装方式需要 pnpm（npm install -g pnpm）

官方方式（推荐）

dsh plugin --profile web add github:Zalpha263/dsh-file-explorer

• 发布到 npm 后可直接：dsh plugin --profile web add dsh-file-explorer
• 装完重启 DSH，会话标题栏右侧会出现「📁 文件」按钮
• 升级 / 卸载：dsh plugin --profile web update/remove dsh-file-explorer

旧版手动安装（仅 v1.2 之前使用，已不推荐）

DSH 旧版本没有 dsh plugin 流程，需要把本包复制到两处并手工注册：

1. 复制包到 profile 目录：$DSH_HOME/profiles/ /node_modules/dsh-file-explorer
2. 复制包到 dsh 安装目录：/@deepseek-ai/dsh/node_modules/dsh-file-explorer
3. 在 $DSH_HOME/profiles/ /cordis.patch.yml 追加注册行：

- insert:
    - id: file-explorer
      name: dsh-file-explorer

4. 重启 DSH。

使用说明

打开方式

• 会话标题栏右侧「📁 文件」按钮
• 侧边悬浮球「📁」（点击开关面板；拖动改变位置）

面板操作

控件 / 操作