dsh-project-tabs
给 DSH 桌面端加一排浏览器式项目标签：Windows 原生标题栏里「应用 / 编辑」菜单
右侧那块空白，变成一条标签栏。
┌──────────────────────────────────────────────────────────────────────┐
│ 应用 编辑 │ alpha beta × gamma × │ － □ × │ ← 标签栏
├───────────────┴──────────────────────────────────────────────────────┤
│ 工作区 │ 会话正文（原版界面） │
│ ▸ alpha │ │
│ ▾ beta │ │
└───────────────────┴──────────────────────────────────────────────────┘
安装
用 dsh 自带的插件安装器（推荐）：
dsh plugin --profile desktop add dsh-project-tabs
桌面端也可以直接在界面里装：左侧栏「插件」→「添加插件」→ 填包名 → 安装 → 立即启用。
从源码装（开发用）： 克隆本仓库然后
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1
默认装进 desktop profile（-Profile web|both 可选，-Uninstall 卸载，幂等可重跑）。
客户端半边改完硬刷新页面即可，宿主半边改完要重启桌面端。
一个标签是什么
一个标签 = 一条会话（session）。标签上只显示工作区（项目）标题；左边的状态点
告诉你它现在在干什么：
| 状态点 | 标签配色 | 含义 |
|---|---|---|
| 转圈 | 品牌蓝底（选中时） | 正在跑 |
| 黄点 | 黄底 | 在等你审批 / 回答 |
| 对勾 | 绿底 + 加粗 | 已经跑完，你还没看过 |
| 灰点 | 中性 | 空闲 |
界面其余部分完全是原版：左侧工作区列表、右侧面板、会话正文、输入框都不变。
标签只决定「中间那一栏显示哪条会话」。
用法
| 操作 | 结果 |
|---|---|
| 点标签 | 切到那条会话 |
| 点标签上的 × / 中键点标签 | 关掉这个标签（不动会话、不动工作区） |
| 拖标签 | 调整顺序 |
| 右键标签 | 关闭 / 关闭其他 / 关闭右侧 / 复制项目路径 |
点 +（紧跟在最后一个标签后面） |
选一个已有项目，或「选择目录…」挑一个新目录 → 在新标签里打开 |
| 在左侧工作区行上右键 | 「在新标签中打开」（由 dsh-sidebar-context-menu 提供这一项） |
侧边栏点会话时会怎样：如果那条会话已经有标签，就跳过去；否则在当前标签里打开
（不会越点标签越多）。所以标签数量和你的项目数是同一个量级。
为什么切标签不像「在重新加载」
一开始确实像：0.2.0 里 mainView 只保留一条会话，切走的会话会被 release 掉本地
generation —— 它的 SessionBinding、已加载的历史窗口、实时 tail 全部销毁。
再切回去是冷开（openState: 'loading'），界面上就是「重新加载了会话内容」。
所以本插件对每一个后台标签都额外持一个
sessions.retain(id, { source: 'projectTabs' })：历史窗口和 tail 一直活着，切回去时
ConversationMainPanel 直接是 active 相位 —— 不闪、不等，落点就是你上次读的那条消息。
在跑的标签优先保留，最多同时保 MAX_WARM_TABS = 10 个（每个保活标签 = 一条实时事件流）。
滚动位置本身由平台记着：dsh-client-ui-chat 的 chatScrollPositions 以 sessionId 为键存
{ anchorKey, anchorTop, scrollTop }，切走时保存、切回时锚回那条消息
（dsh-client-ui-chat/lib/client.js:12327 / 4313 / 4656 / 4964）。
还差什么（诚实说明）：这是「从热数据里重新渲染一遍」，不是「页面一直挂在那儿」。
所以 React 组件局部状态仍会复位 —— 最明显的是你展开的工具卡片 / 思考块会收起。
要连这个都保住，就得把每个标签的会话同时挂载，而 0.2.0 不允许复用官方的
main.conversation / conversation.header（renderSlot 有所有权校验），必须自己重新渲染
正文并放弃官方标题栏（面包屑、标题动作、右侧面板开关、View 标签页），代价明显。
真要做到「浏览器那样的独立页面」，只有 iframe 一条路，而桌面壳不允许
（preload 不在子框架运行）。详见文末「已知限制」。
标签列表持久化在 localStorage（dsh.project.tabs.v1），重启桌面端会恢复。
非 Windows / 浏览器里怎么办
插件会检测 html[data-windows-titlebar]：
- 有（Windows 桌面）：贴进那 40px 标题栏，避开原生菜单和窗口按钮，不动页面布局。
- 没有（macOS 桌面 / 浏览器）：降级成中栏顶部的一条 36px 标签栏，
同时给中栏加padding-top把内容推下去；卸载时撤销。
和另一个插件的关系
本插件对外提供一个客户端服务 projectTabs（另有一份 window.__DSH_PROJECT_TABS__
兜底），让 dsh-sidebar-context-menu 的右键菜单能加「在新标签中打开」：
const tabs = ctx.get('projectTabs') ?? globalThis.__DSH_PROJECT_TABS__;
const sessionId = await tabs.openWorkspaceInTab(workspaceId); // 连接工作区 + 开标签 + 切过去
tabs.openSessionInTab(sessionId); // 直接给某条会话开标签
tabs.listTabs(); // [{ id, sessionId }]
没装那个插件时，本插件完全独立工作。
实现要点（改代码前先读）
- 挂载点：
shell.overlay是唯一一个「root 作用域 + list +replaceRisk:none」的
全窗口浮层插槽。Windows 下 frame 有padding-top: var(--dsh-windows-titlebar-height)，
而绝对定位的包含块是 padding box，所以top:0正好落在那 40px 里。 - 别抢地盘：原生菜单宿主是
[data-windows-menu]（桌面 preload 用 shadow DOM 画的，
left: var(--dsh-windows-menu-start,48px)），运行时量它的 rect；右上角窗口按钮用
env(titlebar-area-*)探针量。原生菜单宽度会随界面语言变，所以挂了 ResizeObserver。 - 切标签 =
ctx.uiWorkspace.openSession(sessionId)：0.2.0 里「当前显示的会话」
就是retainedBy.mainView > 0的那一条，openSession 同步换掉这个引用。 - 不依赖构建：bundle 是 classic script，只调
window.__ModuleLoader__.load。
require()用的是平台静态模块表（react、react/jsx-runtime、react-dom/client、
client-store、ui-slots、ui-primitives、ui-dockkit），所以不需要打包器。 - 宿主半边
lib/index.js是故意空的：它存在的唯一意义是让
@deepseek-ai/dsh-client-modules能从 Loader 条目里扫描到本包的dsh.client声明，
这样lib/client.js才会作为/plugins/dsh-project-tabs/client.js提供给页面。
测试
node scripts\smoke-test.mjs
离线跑，不需要浏览器 / 联网 / 安装 React：自带一个迷你 hook 运行时，
把 react/jsx-runtime 的产物当普通对象树来断言。覆盖模块加载、清单要求、
apply 接线、标签 store 的全部动作、组件渲染与回调，以及几处副作用
（标题栏几何 / 降级布局 / 后台保活 / 跟随侧边栏 / 清理消失的会话）。
已知限制
- 左侧工作区列表是全局共享的（它本来就是全局列表，内容在每个标签下都一样）。
- 展开/收起的工具卡片在切换标签后会复位 —— 这是「重新渲染」而不是「一直挂着」的
唯一可见代价，也是下面那条路要解决的问题。 - 右侧面板跟着当前会话走。
- 打开
+菜单时会列出全部工作区；工作区特别多时列表会很长（会按视口夹取）。 data-windows-titlebar与原生菜单都是桌面端的实现细节；如果 DSH 改了标题栏结构，
标签栏会退回「中栏顶部」那种降级布局（不会报错）。
为什么不做成「真·多页面」（iframe / 同时挂载）
用户最初想要的是「每个标签就是一份完整独立的页面」。桌面端做不到插件级实现，原因：
- 桌面壳不允许在子框架里启动客户端：主窗口
webPreferences没有开
nodeIntegrationInSubFrames（lib/main.js:11099-11107），所以 iframe 里没有 preload，
拿不到dsh-desktop:boot的注入，那份 DSH 根本起不来。window.open也被
setWindowOpenHandler直接 deny（:11109-11112），插件开不了新窗口。
唯一的绕法是让 iframe 走宿主的 SPA 回退去拿带注入的 index，再靠webServer.tapIndex
塞一个__DSH_TRANSPORT__.streamBaseUrl（否则 WebSocket 连不上，见
dsh-api-gateway/lib/client.js:730）—— 这依赖若干未公开行为，DSH 一升级就可能坏，
而且每个标签是一整份客户端（内存按标签数线性增长）。 - 同时挂载多条会话技术上可行（ui-subagent 的侧边栏聊天就是这么做的：
sessions.retain(source:'sidebarChat')+SessionProvider+
renderFactorySlot('conversation.content', { variant: 'embedded' })），
但不能复用官方的主会话外壳：main.conversation/conversation.header/
conversation.session.header都是single/有所有权校验的槽，第三方只能重新渲染正文，
于是会丢掉官方标题栏（面包屑、标题动作、右侧面板开关、View 标签页）和宽度拖拽条。
这和「和原版界面完全一样」是矛盾的。
当前方案选了「官方外壳 + 热数据重渲染」，在保真度和成本之间取平衡。
