dsh-client-sidebar-overlay：侧栏弹出层

前言¶

DeepSeek Harness（DSH）采用插件化架构。当通过社区扩展将 dsh web 嵌入 VS Code 侧栏时，可用宽度极其有限。原生侧栏展开会挤占大量对话区域。本插件旨在解决这一布局冲突，让侧栏平时收起，使用时以浮层形式覆盖在对话上方。

插件介绍¶

dsh-client-sidebar-overlay 是 DSH Web 界面的客户端插件，核心功能是将侧栏改造为按需浮层。

• 维护者：quei4r
• 许可证：MIT
• 定位：专为窄宽度嵌入环境设计，在桌面全宽浏览器中使用原生常驻侧栏通常更合适。

核心功能¶

插件提供以下交互与适配能力：

1. 鲸鱼开关：在会话头部（或主界面的浮动按钮）出现鲸鱼图标，点击后侧栏以浮层形式弹出，点击外部或再次点击可收起。浮层展开期间会自动隐藏浮动按钮。
2. 左右换边：侧栏底部设有切换按钮，可调整浮层滑出的方向（左侧或右侧）。
3. fixed 面板适配：侧栏列使用 transform 定位，修复了 position:fixed 后代面板（如 Cordis 插件面板）的锚点问题。
4. select 替身：将原生下拉框替换为页面内弹层，以支持钳制逻辑。
5. 弹层钳制：拦截所有 role=menu/listbox/tooltip/dialog/alertdialog 的弹层，防止其飞出屏幕左右边缘，自动平移回可视区。

安装与启用¶

安装过程需要手动操作文件与配置，步骤如下：

1. 复制插件目录到 Web Profile 的 node_modules：

    cp -r dsh-client-sidebar-overlay ~/.dsh/profiles/web/node_modules/

2. 编辑 ~/.dsh/profiles/web/cordis.patch.yml，添加插入项：

    - insert:
        - id: ui-sidebar-overlay
          name: dsh-client-sidebar-overlay

3. 重启 dsh web。插件随 profile 自动挂载，无需审批。

验证配置是否生效（可选）：

dsh --profile web --dump-config | grep ui-sidebar-overlay

适用场景与注意¶

• 适用场景：仅在 VS Code（或类似的窄宽度嵌入环境）中使用。
• 版本依赖：依赖 DSH 0.1.0-rc.7。
• 兼容性风险：DSH 升级后 DOM 结构或 CSS 模块变动可能导致定位失效，需检查并调整结构探针。

插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。

结尾¶

本插件通过浮层机制，在有限的嵌入式空间内恢复了对话区的完整宽度。更多细节与源码，可前往项目目录或 GitHub 查看。