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 查看。