tsingshitao-nuke/dsh-set-workspace

dsh-set-workspace

给 Windows 文件管理器加一个右键菜单：右键文件夹，选 "在此处打开 DSH 工作区"，即可把它注册为 DSH 工作区、在其中开启会话，并把 DSH 页面切换到该工作区。

非官方社区项目，与 DeepSeek 无关联、未获其背书。

English

功能

- 在文件管理器里右键文件夹，选择"在此处打开 DSH 工作区"。
- 若 DSH 未运行，桥接脚本会拉起它（桌面版拉起应用，官方 CLI/npm 安装则拉起 dsh web）；若已在运行（即使最小化或在后台），DSH 窗口会被恢复并置前。
- 文件夹被注册为工作区（幂等），并在其中开启一个会话。
- DSH 页面自动切到新工作区（客户端半部分监听该会话并打开它，无需刷新页面）。
- 若你是在普通浏览器里看 DSH（而非桌面窗口），用 --browser 安装，桥接脚本会改为聚焦浏览器页面。
- 菜单与弹窗文案跟随系统 UI 语言（中文 / 英文）。
- 动作经 wscript 隐藏窗口启动器运行，不闪黑框。
- 菜单项使用 DSH 鲸鱼图标。
- 不新增存储、schema 或工具——复用核心工作区注册表与既有 /api RPC。

安装

环境要求：Windows、PATH 里有 Node.js >= 20、以及一个 DSH 安装——DSH Desktop 或官方 CLI（npm i -g @deepseek-ai/dsh）。DSH 未运行时桥接脚本会自动拉起；其启动路径来自 DSH 写出的运行时文件，因此首次使用前需先运行一次 DSH。

一键安装（PowerShell 5.1+ / pwsh）：

irm https://raw.githubusercontent.com/tsingshitao-nuke/dsh-set-workspace/main/scripts/install.ps1 | iex

Git Bash / WSL：

curl -fsSL https://raw.githubusercontent.com/tsingshitao-nuke/dsh-set-workspace/main/scripts/install.sh | bash

手动安装：

1. 安装 bundle
dsh plugin --profile web add github:tsingshitao-nuke/dsh-set-workspace

2. 注册文件管理器右键菜单（先重启 DSH，让 host 半部分发布端口）
node ~/.dsh/profiles/web/node_modules/dsh-set-workspace/bin/install-context-menu.cjs

移除菜单（保留 bundle）：

node ~/.dsh/profiles/web/node_modules/dsh-set-workspace/bin/install-context-menu.cjs --uninstall

工作原理

文件管理器右键
└─ wscript launch-hidden.vbs "%1"           （隐藏窗口）
└─ node set-workspace.cjs ""
├─ 读  ~/.dsh/dsh-set-workspace/runtime.json   （端口 + 启动命令）
├─ 启动 DSH Desktop 应用——未运行则启动；已运行则由应用自带的
│  单实例 second-instance 处理器恢复、显示并聚焦其窗口
│  （与 VS Code「通过 Code 打开」同款机制）
├─ 轮询等待 /api 就绪
├─ POST /api/workspace.create { path }          （幂等）
├─ POST /api/session.create  { workspaceId, sessionId: "dsw-open-…" }
└─ MessageBox 确认

DSH 客户端半部分监听会话列表，打开该 "dsw-open-…" 会话，页面即切到该工作区。

浏览器模式：若你是在普通浏览器里访问 DSH，安装时加 --browser
（或手动写 {"ui":"browser"} 到 ~/.dsh/dsh-set-workspace/config.json），
桥接脚本会改为通过回环 URL 聚焦浏览器页面，而不是桌面窗口。

本 bundle 是标准的 host/client 双半结构 DSH 包。host 半部分（src/index.ts）把当前 webserver 端口与桌面启动命令写到 ~/.dsh/dsh-set-workspace/runtime.json；客户端半部分（src/client/index.ts）负责切换。桥接脚本、鲸鱼图标与启动器复制到 ~/.dsh/dsh-set-workspace/（无空格、重装后仍稳定的目录）；注册表项位于 HKCU\Software\Classes\Directory\shell（无需管理员权限）。

兼容性

- DSH Desktop（Tauri / Electron）：host 记录应用可执行文件；桥接脚本启动它来拉起 DSH，已运行时由应用自带的单实例处理器恢复并聚焦窗口（VS Code「通过 Code 打开」同款机制）。
- 官方 CLI / npm 安装（npm i -g @deepseek-ai/dsh，DSH 在浏览器里访问）：host 记录 dsh web 启动命令（即当前内核所用的同一个 node + lib/bin.js，带 --no-open --host 127.0.0.1 --port ）；桥接脚本在 DSH 未运行时用它自举启动，并通过浏览器页面聚焦——无需桌面窗口。
- 启动方式在 host 每次启动时重新探测，同一插件可自适应你升级到的任意安装形态。

构建

npm install
npm run build   # host（tsc）+ client（tsdown -> lib/client.js）

已知限制

- Windows 11 下，第三方 Directory\shell 项可能出现在"显示更多选项"（Shift+F10）而非顶级菜单。要放到顶级需 COM IContextMenu 处理器，本插件未提供。
- 桥接脚本经回环地址访问 host。host 未运行时会自动拉起；但若 DSH 从未运行过（没有记录启动路径），则回退为提示你先手动启动 DSH。
- 浏览器模式会聚焦浏览器并打开 DSH 页面；Windows 没有跨浏览器「激活某个已存在标签页」的 API，因此可能新开一个标签页而不是切到已有的那个。

License

MIT