dsh-workspace-alias
DeepSeek Harness 插件：跨设备工作区路径别名映射——让从另一台设备同步的会话（例如 macOS 的 /Volumes/Data/notes 与 Windows 的 F:\notes）归入同一项目的本地工作区。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lodfather/dsh-workspace-alias#9ae09e94ec6c91946e0d13684ee577d4545045d4Workspace Alias 以 dsh-workspace-alias 发布，当前版本为 0.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
[English placeholder — see 中文 README below for the full design doc.]
DeepSeek Harness plugin: cross-device workspace path aliasing. When your
.dsh session store is synced between machines (Syncthing etc.) but the same
project lives at different paths (/Volumes/Data/notes on macOS,
F:\notes on Windows), this plugin makes synced sessions group into the
local workspace of the same project instead of staying ungrouped.
Install:
dsh plugin --profile web add https://github.com/lodfather/dsh-workspace-alias
Configure <dshHome>/workspace-alias.json:
{
"version": 1,
"groups": [["/Volumes/Data/notes", "F:\\notes"]]
}
.dsh 的会话按「工作区绝对路径」分组：/Volumes/Data/notes（Mac）和 F:\notes（Windows）永远对不上。用 Syncthing 同步 .dsh 后，另一台机器同步来的会话因 cwd 在本机不存在而变成「未分组」。
本插件在 workspace registry 的 cwd 归一化层加一个跨机别名表：外机 cwd → 本机同名项目的真实路径，同步会话即可正确归桶。
dsh plugin --profile web add https://github.com/lodfather/dsh-workspace-alias
# 重启 dsh web
插件自带的 cordis.patch.yml 会禁用官方 workspace 行并挂载本包（同服务名 workspaceRegistry），workspace-controller / ui-workspace / 侧边栏全部无感。
两种方式，任选其一，结果等价（workspace-alias.json 始终是唯一真源）：
方式一：DSH 设置界面（推荐，v0.4.0 起）。双半区插件：host 侧向 settings 服务注册 workspace-alias namespace；client 侧（lib/client.js，DSH client-module 格式）注册 settings.section slot，设置页出现「工作区别名」完整编辑区（别名组增删改 + autoAttach 开关，草稿式编辑、原子保存），保存即写回 JSON 文件、热生效。宿主无 settings 服务时自动退化为方式二，无需任何配置。
方式二：手工编辑 <dshHome>/workspace-alias.json（建议纳入你的 .dsh 同步白名单，一台维护、两端生效）：
{
"version": 1,
"groups": [
["/Volumes/Data/notes", "F:\\notes"]
],
"autoAttach": true
}
groups：每个数组是一组「同一个项目在不同机器上的路径」，≥2 项autoAttach：启动时把「仅靠别名解析成功的会话」挂入本地 workspace（默认 true；这类会话不可能被本机主动 detach 过，不会违背手动整理意图）remarks：
workspace-alias.json，因此 Syncthing 同步语义不变（一端 UI 修改，另一端 watcher 热加载）workspace-alias.json.bak（防误清空）fs.realpath）与 workspace path 字符串相等（官方 paths.ts："ONE uniqueness canon"）WorkspaceRegistry.indexHeader（构建 sessionPaths 索引）与 WorkspaceEntity.attachSessionAliasWorkspaceRegistry extends WorkspaceRegistry，只覆写 indexHeader 的 cwd 归一化：本机 realpath 失败 → 查别名组 → 用本机存在的兄弟路径 realpathworkspace domain v2）与实体生命周期全部继承，零迁移@deepseek-ai/dsh-workspace 的内部形态稳定（rc 期破坏性变更风险，已在 dsh.compatibility 声明 0.1.x）/ 分隔 + 大小写折叠（对 NTFS 不区分大小写的语义是正确的；对 macOS 大小写敏感盘的极端别名可能过宽）MIT