dsh-open-workspace-folder

dsh-open-workspace-folder

在 DSH Desktop 的工作区列表里右键任意工作区，直接打开对应的本地文件夹，或就地改名。

一个很小、无网络请求、无子进程的 DSH 客户端插件。打开文件夹复用 DSH 自带的 Session Remote session.openWorkspacePath()，所以 Windows 上用资源管理器、macOS 上用 Finder、 Linux 上用 xdg-open 打开路径，行为和 DSH 的「Open In」按钮一致；改名复用 DSH 的 workspace.rename 命令，和侧栏自己的重命名完全等价。

功能

• 打开工作区文件夹：在系统文件管理器中打开工作区根目录（回车键同样触发）。
• 在资源管理器中定位：调用 action: 'reveal'，在文件管理器中定位该目录。
• 重命名工作区：菜单内直接改名，走 DSH 自带的 workspace.rename 命令， 与侧栏自己的重命名是同一套逻辑（重启后仍然生效，其他窗口同步看到）； 名称为空或与已有工作区重名时会在菜单内提示，不会静默失败。
• 复制路径：复制工作区绝对路径到剪贴板。
• 菜单跟随 DSH 主题（明/暗），支持 Esc 关闭、方向键导航、点击外部关闭。
• 所有图标为内联 SVG；无外部字体、图片、CDN 或网络请求。

安装

要求 DSH Desktop 已安装，且 dsh 命令在 PATH 中。

从本地克隆安装

git clone https://github.com/Homeless-Attila/dsh-open-workspace-folder.git
dsh plugin --profile desktop add .\dsh-open-workspace-folder

直接从 GitHub 安装

dsh plugin --profile desktop add github:Homeless-Attila/dsh-open-workspace-folder

这条命令会：

1. 把插件目录作为 link: 依赖（或 git 依赖）写进 desktop profile；
2. 因为包声明了 dsh.bundle.patch，自动把 dsh-open-workspace-folder 追加到 dsh.profile.bundles；
3. 校验 bundle patch 可组合。

安装后需要完全退出并重新启动 DSH Desktop，让新的客户端 bundle 加载。

目前尚未发布到 npm。发布后即可直接 dsh plugin --profile desktop add dsh-open-workspace-folder。 如果以 link: 方式安装，移动插件目录后需要重新执行一次 add <新路径>。

使用

1. 在左侧工作区树中找到一个工作区。
2. 右键该工作区行。
3. 选择「打开工作区文件夹」，或「重命名工作区」后输入新名称，Enter 保存、Esc 取消。

如果当前 DSH 运行在普通浏览器里、宿主端不允许打开本地路径，菜单会显示 「当前窗口不支持打开本地文件夹」，复制路径与重命名仍然可用。

重命名有两条约束：名称不能为空，且不能和已有工作区重名（侧栏本身也如此）。 两种错误都会显示在菜单底部，菜单保持打开，方便直接改名重试。

卸载

dsh plugin --profile desktop remove dsh-open-workspace-folder

然后重启 DSH Desktop。

结构

dsh-open-workspace-folder/
  package.json        # dsh.bundle.patch + dsh.client (platform: web)
  cordis.patch.yml    # 挂载一行 host 插件
  index.js            # host half：空实现，不注册路由、不启动进程
  client.js           # 全部功能：右键菜单 + Session Remote + 重命名
  test/smoke.test.mjs # 冒烟测试：bundle 能注册、导出正确、无网络调用
  docs/preview.png    # 右键菜单截图
  README.md
  LICENSE

实现要点

• client.js 是一个标准 DSH 客户端 bundle： window.__ModuleLoader__.load({ id, factory })，React 从模块表 require('react') 取得。

• 通过 ctx.get('slots') 向 shell.overlay 注册一个菜单组件； 组件从 shell.overlay 的 useWorkspaces 属性订阅工作区快照。

• 捕获阶段监听 contextmenu，只处理带 data-row-key="workspace:<id>" 和 aria-expanded 的工作区 treeitem；会话行（带 aria-selected）和 data-row-key="workspace:" 的「未分组」伪工作区会被忽略。 通过 span[class$="_title"] 的文本兜底匹配实时工作区列表，拿到 workspace.path。

• 打开动作使用宿主已有的 Session Remote：

  const remote = ctx.get('remote')
  await remote.session.openWorkspacePath({ path })
  await remote.session.openWorkspacePath({ path, action: 'reveal' })
  

  不需要 host RPC，也不需要自己拼 explorer.exe 命令行。

• 重命名使用宿主已有的工作区服务，不新建通道：

  const remote = ctx.get('remote')
  const result = await remote.workspace.rename({ workspaceId, title })
  // { ok: true, value: { workspace } } | { ok: false, error: { code, message } }
  

  客户端服务版 ctx.get('workspaces').rename(workspaceId, title) 更直接（失败时抛 workspace rename failed: <code>: <message>），插件优先用它、退化到 remote.workspace.rename。常见错误码：workspace/name-conflict（重名）、 gateway/bad-request（名称为空）。

• 客户端模块额外导出 Cordis 服务注入：

  exports.inject = ['remote', 'remote.session']
  

  注意它和 package.json 里的 dsh.client.inject（模块依赖图）是两套机制， 只配置后者时运行时仍会报 cannot get property "remote.session" without inject。

已知限制

• 桌面端没有客户端 HMR 插槽，安装或改代码后必须完全重启 DSH Desktop； 仅刷新窗口不够。
• 菜单依赖工作区行的 DOM 结构（data-row-key / aria-expanded）。DSH 前端若改动 这些标记，需要同步调整 client.js。

开发校验

npm run check   # node --check 两个 bundle
npm test        # node --test：bundle 注册、导出、无网络调用

开发时另做过一轮隔离测试页验证（菜单注册、定位/打开/复制、Esc 关闭、会话行忽略、 「未分组」忽略、宿主不允许打开时禁用打开项等），并在独立 desktop profile Web 运行时 按 1440×900 实测右键、打开、定位与复制路径，均无报错。

License

MIT