dsh-client-sidebar-overlay
中文 | English
DeepSeek Harness（DSH）Web 界面的客户端插件：侧栏弹出层。
使用场景
本插件为 VS Code 侧栏嵌入场景设计：通过社区扩展（如 deepseek-harness-vsc-extension、dsh-vscode、deepseek-harness-for-vscode 等）把 dsh web 壳嵌进 VS Code 侧栏 webview 时，可用宽度非常宝贵——原生侧栏一展开就挤掉大半对话区。装上本插件后，侧栏平时完全收起，需要时以浮层形式盖在对话上方，用完即收，对话区始终占满全部宽度。
💡 个人推荐仅在 VS Code（或类似的窄宽度嵌入环境）中使用。 在桌面全宽浏览器里，原生的常驻侧栏布局通常是更好的选择，本插件不会带来明显收益。
功能
- 🐳 鲸鱼开关：会话头部「Session log」右侧出现鲸鱼图标，点击后侧栏以浮层形式弹出（不占用布局宽度），再点或点击外部收起；若侧栏处于图标栏状态会先自动展开为完整宽度。主界面（新建会话页）没有会话头部，此时右上角会出现一个浮动鲸鱼按钮作为入口，进入会话后自动让位给头部开关；浮层展开期间浮动鲸鱼自动隐藏（v0.1.3：原位置正好压住浮层内产品自带的「收起侧栏」按钮），收起后回归——该按钮的点击也被映射为收起浮层本身。
- ⇄ 左右换边：侧栏底部的「侧栏移到左/右侧」按钮，切换浮层从哪一侧滑出，样式与产品底部行一致。
- 📐 fixed 面板适配：侧栏列使用 transform 定位后，
position:fixed 的后代面板（如 Cordis 插件面板）会以侧栏列为定位基准；插件在侧栏居右时把它们的 left 锚点改写为等值 right，居左时还原。
- 🔽 select 替身：原生
<select> 的系统下拉无法被页面钳制，侧栏内的原生下拉被替换为页面内弹层（选项同步、回写 value + change 事件）。
- 🧲 弹层钳制：所有
role=menu/listbox/tooltip/dialog/alertdialog 的弹层飞出屏幕左右边缘时自动平移回可视区。
安装
假设 DSH_HOME 为 ~/.dsh（默认值）：
-
把本目录复制到 web profile 的 node_modules：
cp -r dsh-client-sidebar-overlay ~/.dsh/profiles/web/node_modules/
-
编辑 ~/.dsh/profiles/web/cordis.patch.yml，加入一行插入项：
- insert:
- id: ui-sidebar-overlay
name: dsh-client-sidebar-overlay
-
重启 dsh web。插件随 profile 自动挂载，无需审批。
验证组合是否正常（可选）：
dsh --profile web --dump-config | grep ui-sidebar-overlay
卸载
- 从
cordis.patch.yml 删除上面的 - insert: 段（或整行）；
- 删除
~/.dsh/profiles/web/node_modules/dsh-client-sidebar-overlay；
- 重启
dsh web。
文件说明
| 文件 | 说明 |
|---|
package.json | 包清单，含 dsh.client.platform: "web" 声明 |
index.js | 宿主侧空占位（loader 要求） |
client.js | 浏览器端全部逻辑（window.__ModuleLoader__ 格式，依赖 seed 里的 react） |
兼容性：随 @deepseek-ai/dsh 0.1.0-rc.7 的 web profile 测试通过。DSH 升级后若产品 DOM 结构或 CSS 模块变动，插件内的结构探针（frame/sidebarCol 定位）可能需要调整。
