dsh-workspace-dir

一个 DeepSeek Harness 插件:在会话头部加一个 "📁 目录" 按钮,点一下就能弹出 当前对话工作目录的文件/子目录列表——不用切出 harness,边写代码边看项目结构。

点击后你会看到:一个可拖动的浮动面板,列出当前工作目录下的文件和子目录, 支持点击进入子目录,还能用滑杆调整面板背景透明度(0%–100%,默认 20%);每个 文件夹旁有 "↗" 按钮,一键在系统文件管理器中打开它。面板的位置、透明度、 打开/关闭状态都会自动记忆,重启 harness 也不会丢;所有可点击区域有悬停高亮与 按下缩放反馈(高亮度随面板透明度自适应)。

功能一览

• 会话头部"目录"按钮(Feather 风格文件夹图标 + 中文文本)
• 浮动目录面板:可拖动(拖标题栏)、透明度可调(滑杆 0%–100%,默认 20%)、位置/透明度/打开状态自动记忆(重启不丢)
• 点击反馈:所有可点击区域(目录行/↗ 按钮/关闭按钮)悬停高亮 + 按下缩放;高亮度随面板透明度自适应(≤50% 时 +20%,>50% 时 −20%)
• 显示当前会话工作目录 + 文件/子目录列表,缩进分层、支持下钻
• 在系统文件管理器中打开当前文件夹或任意子文件夹(Windows 资源管理器 / macOS Finder / Linux 文件管理器,自动适配)
• 切换会话自动跟随新会话的工作目录;无工作目录的会话不显示

快速开始(最正规,一条命令装完即激活)

环境要求:本插件要求 源码运行的 harness(官方 README 推荐方式)—— npm 安装版(npx @deepseek-ai/dsh web)的 peer 依赖由源码仓库提供、npm 上不完整, 可能装不上。还需要 pnpm(装完 harness 一般已有)。

源码运行的 harness,dsh 是工作区脚本而非全局命令,需在 harness 源码目录用 pnpm dsh 调用;若你的 dsh 在 PATH 中(全局安装版),直接去掉 pnpm 前缀。

cd /path/to/deepseek-harness    # ← 你的 harness 源码目录(Windows 示例: cd D:\deepseek-harness)
pnpm dsh plugin --profile web add github:DDSG-X/dsh-workspace-dir

装完重启 harness 即生效。生效规则:

• add / remove(装/卸插件) → 必须重启 harness(loader 的 entry 表是启动时快照,只刷新会 failed to load 或 404)
• update(更新插件内容) → 刷新页面即可生效(服务端每次请求都重新读 bundle 文件)

更新 / 卸载 / 验证:

pnpm dsh plugin --profile web update dsh-workspace-dir    # 更新
pnpm dsh plugin --profile web remove dsh-workspace-dir    # 卸载
curl "http://127.0.0.1:3080/dsh-workspace-dir/list?path=<绝对路径>"   # 验证:返回 JSON 文件列表即正常
# Windows PowerShell 里 curl 是别名,请用 curl.exe:
# curl.exe "http://127.0.0.1:3080/dsh-workspace-dir/list?path=D:/your/dir"

⚠️ 本项目未发布到 npm:不要用包名安装(npm install dsh-workspace-dir、 dsh plugin add dsh-workspace-dir 会因 npm 上找不到该包而失败)。github 源直接 拉取本仓库;离线/本地开发才用 file: 指向本地克隆目录。

不想手动敲命令?对 AI 说一句话即可——见下节「安装:让 AI 帮你」。

安装:让 AI 帮你(推荐新手——本项目的安装就是为这个设计的)

本项目面向完全不熟悉它的 DeepSeek Harness 用户。 你不需要懂插件、依赖、 profile——装好它,只需要对你的 AI 说一句话:

请把 https://github.com/DDSG-X/dsh-workspace-dir 克隆到英文路径,读取项目里的 AI-INSTALL.md,按里面的步骤把 dsh-workspace-dir 插件安装到我的 harness, 并验证"目录"按钮能正常弹出面板。

AI 会自己完成:克隆仓库 → 读取安装引导(AI-INSTALL.md)→ 判断你的 harness 是源码运行还是 npm 安装 → 检测/初始化 web profile → 把插件装进 profile → 重启 harness → 验证"目录"按钮。它只会在你批准时修改你的 profile 文件; 遇到环境差异,也会按引导里的故障排查表处理,并把结果汇报给你。

引导文件 AI-INSTALL.md 为中英双语单文件(英文版在文件后半段,从 # English Guide 开始);对英文 AI 说: "Clone https://github.com/DDSG-X/dsh-workspace-dir to an English path, read the English section of AI-INSTALL.md, install the plugin, then verify the Directory button works."

备选:也可以只做 3 步(仍然让 AI 装)

1. 克隆到英文路径(目录名含中文会导致 pnpm 乱码,安装会失败):

   git clone https://github.com/DDSG-X/dsh-workspace-dir.git
   

2. 在 DeepSeek Harness 里,把克隆下来的目录设为当前工作目录(workspace) —— 这样 AI 才能读到克隆下来的 AI-INSTALL.md 并操作这个目录; 不知道怎么设置就问你的 AI,它会带你操作;

3. 对你的 AI 说:

   请读取本项目的 AI-INSTALL.md,按里面的步骤把 dsh-workspace-dir 插件安装到我的 harness,并验证"目录"按钮能正常弹出面板。

本仓库自带构建产物(lib/),克隆后无需构建,可直接安装。只有修改源码的开发者才需要重新构建。

⚠️ 本项目未发布到 npm:请不要用包名安装(如 npm install dsh-workspace-dir、 dsh plugin add dsh-workspace-dir 都会因 npm 上找不到该包而失败)。安装用 github 源(pnpm dsh plugin add github:DDSG-X/dsh-workspace-dir,一条命令装完即激活); 离线/开发场景才用 file: 指向本地克隆目录。

AI 安装效果示例

一个完全不了解插件的用户,实际体验大致是这样(实际输出会因环境和模型而异):

你:请读取本项目的 AI-INSTALL.md,把 dsh-workspace-dir 插件安装到我的
    harness,并验证"目录"按钮能正常弹出面板。

…