前言¶
DeepSeek Harness (DSH) 插件系统允许开发者通过扩展功能来增强客户端体验。在会话中编写代码时，频繁切换窗口查看项目结构会打断开发思路。dsh-workspace-dir 插件通过在会话头部增加“目录”按钮，在 DSH 界面内直接展示当前工作目录的文件列表，解决这一痛点。该插件由 DDSG-X 维护。
核心功能¶
该插件提供以下功能：
* 会话头部按钮：在会话标题旁显示“目录”按钮。
* 浮动面板：点击按钮弹出可拖动的目录面板。
* 透明度调节：支持 0%-100% 背景透明度调节，默认为 20%。
* 状态记忆：面板的位置、透明度、打开/关闭状态会自动保存，重启 Harness 后恢复。
* 目录浏览：显示当前会话的工作目录及其文件和子目录列表。
* 层级导航：支持点击进入子目录。
* 系统打开：支持点击文件夹旁的按钮，在系统文件管理器中打开当前或指定子目录。
* 会话跟随：切换会话时，目录面板会自动跟随新会话的工作目录。
安装与启用¶
安装需要使用源码运行的 Harness。由于 peer 依赖可能不完整，npm 安装版可能无法正常工作。
pnpm dsh plugin --profile web add github:DDSG-X/dsh-workspace-dir
安装完成后必须重启 Harness 才能生效。
典型用法¶
- 打开任意会话，在标题旁点击“目录”按钮，弹出目录面板。
- 拖动面板标题栏移动位置。
- 使用滑杆调整面板背景的透明度。
- 点击目录列表中的子目录或文件夹旁的“↗”按钮，在系统文件管理器中打开对应路径。
注意事项¶
- 本项目未发布到 npm，不要使用包名安装。
- 需要源码运行的 Harness，npm 安装版可能因 peer 依赖缺失无法安装。
- 安装完成后必须重启 Harness 才能生效。
- 插件自带构建产物（
lib/），无需重新构建。
