前言¶
在 DeepSeek Harness（DSH）里长期开多个工作区、多层会话时，侧栏导航往往和主聊天窗口绑在同一块区域。需要对照路径、分组和活动状态时，侧栏空间容易显得紧；若把 DSH 主窗口挪到副屏，导航仍可能挤在侧栏里，不便单独摆放。
社区插件 dsh-workspace-detached（维护者 liushimu）走另一条路：不修改 DSH 主程序，通过公开插件接口，把「工作区与会话导航」从侧栏分离到可独立移动、调整大小的 Windows 原生窗口。主窗口继续负责聊天与会话动作；独立窗口只做导航与呈现。它是第三方独立插件，不是 DSH 官方功能，也不是 Better Workspace 补丁；卸载 Better Workspace 后仍可单独使用本插件。
这是什么¶
dsh-workspace-detached 当前发行版本为 0.2.3 预览版（MIT 许可证）。分类上属于 DSH 客户端类插件：在 Windows x64 上配合 DSH 宿主运行，不能脱离 DSH 单独当作完整应用使用。
目录页：SkillHub — liushimu/dsh-workspace-detached
源码与说明：GitHub — liushimu/dsh-workspace-detached
核心功能¶
下面能力均来自项目 README 与 package 声明，安装前请以 Releases 页实际包为准。
独立导航窗口¶
侧栏提供 「弹出工作区」：导航进入独立窗口，可放到另一块屏幕或桌面位置；需要时用 「收回侧栏」 结束独立显示，「定位导航窗口」 可找回已有窗口。弹出不会新建 Agent，也不是第二个聊天后端。
层级、总览与聚焦¶
保留工作区、路径嵌套、名称分组和会话层级；支持 总览（多工作区卡片）和 聚焦某一工作区（上方聚焦内容、下方预览其他工作区）。搜索与折叠、可拖动上下分区、默认标题字号区分、显式自定义外观，以及六格活跃点阵（系统要求减少动态效果时可停用点阵动画）。
逻辑拖放与排序¶
可调整导航父级及同级顺序，支持按内容活动或手动排序。逻辑拖放不搬动磁盘目录；菜单中的「移至工作区」会改变会话运行目录，并在需要时提示确认。
沿用 DSH 会话动作¶
选择、重命名、归档、移动等由主窗口对应服务完成；菜单是否可用取决于宿主能力与会话状态。复制项复制的是 Session ID，不是聊天内容。归档可在插件侧执行；恢复已归档会话需使用 DSH 主窗口或设置里宿主提供的归档入口。
系统要求¶
- 操作系统：Windows x64（其他操作系统暂无原生窗口支持）。
- .NET Framework：4.6.2 或以上。
- Microsoft Edge WebView2 Evergreen Runtime：需系统或用户自行安装，插件不会自动安装该运行时。
- DSH：声明兼容起点 0.2.1-rc.3；宿主需提供公开的 Connection、webServer、subprocess、sessionProjections 及相关客户端槽位。
- Node.js：22.19 或以上（与 package
engines一致）。
普通安装不需要 C# 编译器、Python、dotnet SDK 或 DSH 源码。
安装与启用¶
1、从 Releases 下载 dsh-workspace-detached-0.2.3.tgz。不要把 GitHub 自动生成的 Source code 压缩包当作安装包，也不必解压 tgz。
2、若已启用 Better Workspace，先在 DSH 中停用它。两个插件占用同一侧栏位置，不应同时启用。
3、在 DSH 插件管理入口添加下载的本地 tgz，并启用 dsh-workspace-detached。不同宿主版本的入口文字可能不同，以实际界面为准。
4、回到工作区侧栏，点击 「弹出工作区」。若新安装尚未被客户端加载，按宿主提示重新加载客户端。
宿主已停止时，也可通过官方 CLI 安装（将 profile 名与 tgz 路径换成你的实际值）：
dsh plugin --profile desktop add ./dsh-workspace-detached-0.2.3.tgz
不要在宿主或独立窗口运行时直接覆盖其 node_modules、EXE 或 DLL；不要双击包内显示程序代替插件启动。
典型用法¶
弹出与收回：弹出后侧栏仍保留导航窗口状态入口；收回侧栏即结束该窗口的独立显示。
总览与聚焦：进入某一工作区后上方为聚焦内容，下方预览其他工作区，可返回总览。
调整上下分区：拖动中间手柄；焦点在手柄时可用上下键微调，Shift 加快，Home/End 到边界，双击或 Enter 恢复默认。分区比例保存在当前窗口文档，新窗口恢复默认。
活动时间排序：以用户内容和非空助手回复为依据，不把工具事件、标题修改等管理动作当作新内容；部分历史会话的活动时间可能尚未补齐。
适用场景与注意¶
适合谁：主要在 Windows 上使用 DSH、工作区与会话较多、希望导航窗口与主聊天窗口分屏或分桌面摆放的用户。
与 Better Workspace 的关系：分组及侧栏逻辑改编自 KannaKuron/dsh-better-workspace；本插件不读取 Better Workspace 的运行时 store/DOM，也不构成对其运行依赖。公开包名由内部开发名 dsh-workspace-navigator 改为 dsh-workspace-detached；切换时勿同时启用新旧包，遇 entry id 冲突应通过官方管理器移除旧包。
安全与权限：插件以当前 DSH 进程权限运行；安装前应自行查看源码与 MIT 许可证。原生显示程序当前未做代码签名，企业策略可能限制运行。插件只提供导航与呈现，不创建第二套会话后端；原生程序仅加载包内固定 HTML/JS/CSS，通过受限消息协议与主窗口通信。
数据位置：原生数据默认位于当前 DSH profile 的 data/workspace-navigator；窗口几何偏好位于其 window-state 子目录。卸载前先收回窗口，再用宿主插件管理器停用或卸载；插件不会删除工作区目录、会话或主动清扫偏好数据。
已知边界：无跨所有 DSH 版本、屏幕布局与安全策略的保证；DOM 自动化不等于真实 WebView2 下全部 GUI 组合的验收。反馈问题请提供 DSH/插件版本、Windows 与 WebView2 版本及复现步骤，并脱敏截图与路径。
结尾¶
dsh-workspace-detached 把 DSH 工作区与会话导航放进独立 Windows 窗口，保留层级、总览聚焦与逻辑排序，同时仍通过主窗口执行会话管理。需要预览版安装包与更新说明时，见 Releases；社区目录入口见 SkillHub 插件页。
