dsh-managed-workspaces

让 DSH 的工作区不再必须指向一个已经存在的文件夹：插件在指定根目录下自建工作区文件夹，并允许把多个文件夹关联到同一个工作区。

工作区模型

<根目录>/                     ← 可配置，默认 <用户目录>/DSH-Workspaces
  demo/                       ← 工作区主目录，注册进侧边栏，会话 cwd 就是它
    _roots/                   ← 固定目录，存放关联文件夹的链接
      web/                    ← junction → D:\repos\web
      api/                    ← junction → D:\repos\api

工作区主目录由插件创建，并通过 ctx.workspaceRegistry 注册；在侧边栏出现后，直接在该行新建会话即可（会话 cwd = 主目录）。
关联文件夹以 _roots/<别名> 的形式出现在工作区里（Windows 使用 NTFS junction，无需管理员权限）。它同时保留真实绝对路径。
解除关联只删除链接，绝不删除被关联的文件夹；从插件移除工作区只删除注册与插件记录，绝不删除文件夹或会话。

安装

dsh plugin --profile desktop add dsh-managed-workspaces

把 desktop 换成你的 profile 名。该命令会在 profile 里安装包，并把新增的 bundle 自动加入 dsh.profile.bundles；重启 DSH 后生效。

用 plugin_manager

plugin_manager({ action: "install_bundle", target: "dsh-managed-workspaces" })

也可以从 GitHub 安装，或先用本地目录安装便于开发：

plugin_manager({ action: "install_bundle", target: "https://github.com/CoraxEldridge/dsh-managed-workspaces" })
plugin_manager({ action: "install_bundle", target: "D:\\path\\to\\dsh-managed-workspaces" })

安装后点侧边栏「+」（添加工作区）即可看到托管工作区入口；若结果显示 restart-required，重启 DSH 后生效。更新已安装版本时重复对应的安装命令即可。

接入已有工作区

侧边栏里已经存在的工作区可以「接入」插件，纳入同一套管理（这样就能给它们关联额外文件夹），而且不移动、不改名、不新建任何文件：

界面：右键任意工作区 → 「接入托管工作区」；或在「托管工作区」面板的「已有工作区（未接入）」里逐个点「接入」/「全部接入」。
模型：managed_workspace({ action: "adopt", all: true })，或 managed_workspace({ action: "adopt", folder: "D:\\某目录" })。

接入后的行为差异：

接入的工作区不会立刻产生 _roots/，只有第一次「关联」文件夹时才创建，因此仓库里不会多出空目录。
「移出插件」对接入的工作区只删除插件记录，保留它在侧边栏的注册（因为那个工作区原本就属于你）；对 DSH 新建的工作区则同时移除侧边栏注册。
如果接入的工作区目录被外部删除，「修复」不会替你重建，只报告缺失。

侧边栏集成

右键工作区（已托管）：打开托管面板 / 关联文件夹… / 迁移… / 修复 / 移出插件。
右键工作区（未托管）：接入托管工作区。
「添加工作区」按钮：插件以更高优先级接管该流程，点「+」后提供：新建托管工作区（在根目录下建） / 选择已有文件夹（走宿主的目录选择器，保留官方添加行为） / 接入已有工作区 / 打开托管面板。所有管理入口都在这里和右键菜单中，侧边栏不再有单独的底部按钮。

该接管使用槽位的 priority: -1（单槽按 priority 升序取第一个，官方选择器为 0）；卸载插件后官方选择器自动恢复。

迁移工作区

展开任一工作区，点「迁移…」，填入一个尚不存在的目标路径（或用「浏览…」选父目录后自动补上当前名称），确认即可。也可以用工具：managed_workspace({ action: "migrate", destination: "D:\\新位置", workspace: "名称" })。

迁移会移动整个工作区目录（同一磁盘用重命名，跨磁盘用“复制 → 校验文件数/字节数 → 删除源”），并重建 _roots 下的关联链接。

对话记录为什么不会丢：DSH 的会话头里记录着创建时的工作目录，且该记录不可修改；侧边栏按这个路径把会话归到工作区。因此：

工作区还有会话时（自动 anchor 模式）：目录被移走，但原路径会保留为指向新位置的目录链接，历史会话的 cwd 仍然有效，对话照常打开、继续、归组在同一个工作区下。工作区在 DSH 注册表里会改指向新的物理路径（realpath 之后），这样按 realpath(cwd) 分组的会话不会落到「未分组」；旧路径只作为链接保留给历史会话。
工作区没有会话时（自动 clean 模式）：直接移动并在侧边栏把工作区重新注册到新路径，不留链接。

anchor 模式需要保留原位置的那一个链接；如果原磁盘将被移除，请先确认该路径可以长期保留（链接本身只占极小空间）。手动指定 mode: "clean" 时，若工作区仍有会话会被拒绝。

迁移后界面会显示「实际位置」。若链接被误删，点「修复」（或让模型调用 managed_workspace({ action: "repair", workspace: "名称" })）即可重建；如果升级前迁移过的工作区出现了「会话未分组」，「修复」也会把注册表改指向新位置并重新挂回会话。迁移时若有会话没能重新挂回，工具的返回里会列出 Session warnings，修好对应路径后再执行一次 repair 即可。

使用

点侧边栏「+」（添加工作区）→「打开托管面板」，设置工作区根目录并保存。
输入名称点「新建」：创建 <根目录>/<名称>/ 并注册到侧边栏。
展开某个工作区，填入要关联的文件夹（或用「浏览…」选择），可指定别名，点「关联」。
在侧边栏该工作区行新建会话即可开始工作。

模型也可以通过 managed_workspace 工具完成同样的操作：

action	说明
`status`	当前会话属于哪个托管工作区、关联了哪些文件夹
`list`	列出全部托管工作区，以及尚未接入的已有工作区
`create`	新建工作区（`name`）
`adopt`	接入已有文件夹（`folder`），或接入全部已有工作区（`all: true`）
`attach`	关联文件夹（`folder`，可选 `alias`、`workspace`）
`detach`	解除关联（`alias`）
`register`	重新注册到侧边栏
`repair`	修复：重建工作区目录、迁移链接、关联文件夹，并把会话重新挂回（`workspace`）
`forget`	移出插件（不删文件；接入的工作区保留侧边栏注册）

未指定 workspace 时，工具使用当前会话所在的工作区；工作区嵌套（接入的工作区位于另一个工作区里）时取最内层那个。

状态文件

%DSH_HOME%\managed-workspaces\manifest.json（DSH_HOME 未设置时用 ~/.dsh），记录根目录、工作区与关联关系。写入是原子的（临时文件 + rename）；文件损坏会被改名为 manifest.json.corrupt-<时间戳> 并以空状态继续，同时在界面里给出告警。

已知限制

搜索不会自动穿越链接：glob/grep 通过 ripgrep 执行且不带 --follow，所以从工作区根搜索一般不会进入 _roots/<别名>。请对每个关联文件夹显式指定路径，例如 grep({ path: "_roots/web" })。插件会在提示上下文中提醒模型。
workspace-write 下无法写关联文件夹：链接目标是工作区根之外的路径，文件沙箱会拒绝写入（Windows 上又无法用 additionalWritableRoots 表达，因为会让 pwsh 的 ACL 沙箱直接失败）。需要修改关联文件夹时把会话切到 danger-full-access。
不支持 UNC 路径：Windows junction 不能指向网络共享（会明确报错）。
「添加工作区」流程依赖宿主的目录选择器：桌面版可用；若宿主只提供应用内浏览选择器（无原生选择能力），「选择已有文件夹」会不可用，请改用托管面板里的路径输入。
会话不能跨工作区拖动或移动：工作区归属由会话头中不可变的 cwd 推导（attachSession 要求它等于工作区路径），DSH 没有修改该记录的接口。侧边栏的拖拽只在同一工作区内排序；要整理对话位置，请用本插件的「迁移工作区」移动目录。
工作区文件夹被外部删除时不会静默重建，需在界面点「修复」。
若 _roots/<别名> 被真实文件或目录占用，插件只报告冲突，绝不覆盖或删除。
卸载插件不会动磁盘上的任何工作区文件夹、链接或会话。
插件的 HTTP 路由先向宿主的 connection 服务要一次准入（Host/Origin 校验 + 浏览器认证，挡住 DNS 重绑定与跨站调用），再要求带 x-dsh-managed-workspaces: 1 请求头的 POST；路由只操作插件自身记录与根目录下的文件夹。

开发

node --test test/store.test.js test/context.test.js

dsh-managed-workspaces

安装

README