前言¶

在 DeepSeek Harness（DSH）里开新对话前，通常要先选定或添加工作区。若项目目录已在磁盘上、但还没在客户端里登记，往往要在文件管理器和 DSH 之间反复切换、手动填路径或走其它导入流程。dsh-workspace-drop 把这一步收成一次拖放：从系统文件管理器把文件夹拖到工作区列表或新对话的工作区选择器，即可用原有路径注册工作区。该能力属于客户端插件，依赖 DSH 桌面应用的本地路径桥，无法在普通浏览器里等价复现。

这是什么¶

dsh-workspace-drop（仓库 MeirinRuan/dsh-workspace-drop）由维护者 MeirinRuan 发布，当前包版本为 0.1.0，采用 MIT 许可证。插件通过 Cordis 补丁挂载 workspace-drop 加载项，在客户端 shell.overlay 插槽追加提示层，不新增模型工具、系统提示或会话事件；新对话的工作目录仍由所选工作区决定。

社区目录条目见 SkillHub：dsh-workspace-drop。该目录为社区独立站点，与 DeepSeek、幻方无官方从属关系；DSH 生态奉行「一切皆插件」，安装前宜自行查阅源码与许可证。插件在 当前 dsh 进程的权限 下运行。

核心功能¶

下面介绍的能力均来自仓库 README 与中文指南。

1. 拖放注册：将一个或多个本地文件夹拖到左侧工作区列表，或新对话页的工作区选择器；松开后通过 DSH 的 workspaces.create 服务注册原路径。列表立即更新，选中即可对话；已存在的目录会复用已有工作区，文件仍留在原位置。
2. 路径与队列：拖放期间通过桌面 __DSH_HOST_PATHS__.pathFor 同步解析目录路径；同次拖放内重复路径去重，多目录按顺序注册，单个失败不影响后续项。
3. 反馈与约束：成功时顶部居中提示工作区名称，约六秒后淡出；部分失败时列出成功项与错误，可点「关闭」收起。普通文件会被拒绝并提示仅支持文件夹；注册进行中再次拖入会被拦截，不启动第二次操作。
4. 范围边界：聊天输入框附件拖放、列表内会话移动保持 DSH 默认行为。无路径桥的环境会显示限制说明，不会猜测路径或上传文件副本。

安装与启用¶

本插件包要求 DSH 0.2.2-rc.1（见 package.json 的 engines.dsh）。开发构建需要 Node.js ^22.19.0 || >=24.0.0 与 pnpm 11.28.5；日常使用在插件管理器中安装即可。

1. 打开 DSH 插件管理器。
2. 安装发布压缩包（使用指南中的官方地址，勿凭仓库名拼接 CLI 命令）：

https://github.com/MeirinRuan/dsh-workspace-drop/releases/latest/download/dsh-workspace-drop.tgz

3. 启用插件包名 dsh-workspace-drop。
4. 若仍启用旧的 @local/dsh-workspace-drop，请先禁用。两者共用提示层、事件监听器与语言命名空间，不能同时启用。

禁用或卸载后，监听器、语言字典、样式与提示层会移除；卸载会等待已开始的注册完成并停止未开始的队列，已添加的工作区仍保留。

典型用法¶

1. 确认使用 DSH 桌面客户端，且本地路径桥可用（非纯浏览器、非与主机分离的远程场景）。
2. 在文件管理器中选中项目文件夹（可多选）。
3. 拖到 DSH 左侧工作区列表或「新对话」页的工作区选择器上并松开。
4. 根据顶部提示确认名称；在列表中选择该工作区开始对话。

无需额外配置字段；行为由拖放目标上的 UI 与 workspaces.create 完成。

适用场景与注意¶

适合谁：经常在多个本地仓库或文档目录间切换、希望用磁盘上已有文件夹快速登记为 DSH 工作区的桌面用户。

前提与限制：

• 必须有桌面路径桥；普通浏览器无法读取拖入文件夹的绝对路径。
• 拖放目标绑定 DSH 的 sidebar.workspaces 与 conversation.hero.workspace DOM 插槽，未声明兼容其它 DSH 版本。
• 安装前请阅读 GitHub 仓库 源码与 MIT 许可证；插件与 DSH 同进程权限，不宜在未审计的情况下启用不可信来源的包。

自研或本地打包时，可在检出仓库后执行 pnpm install --frozen-lockfile、pnpm run build 与 pnpm test，再用 pnpm pack 产出 tgz 后在管理器中安装；详见指南「开发」一节（指南含 git clone 说明，本文不复述克隆步骤）。

小结¶

dsh-workspace-drop 在客户端用拖放调用 workspaces.create，把本地文件夹路径登记为工作区，减少手动路径录入。安装使用发布 tgz 并启用 dsh-workspace-drop，且需 DSH 0.2.2-rc.1 与桌面路径桥。

• 社区目录：https://www.skillhub.cn/plugins/MeirinRuan/dsh-workspace-drop
• GitHub：https://github.com/MeirinRuan/dsh-workspace-drop
• 中文指南：https://github.com/MeirinRuan/dsh-workspace-drop/blob/main/docs/guide.zh.md