前言¶

DeepSeek Harness（DSH）的左側邊欄即便處於摺疊狀態，在移動端也會佔用網格列空間。dsh-mobile-topbar 插件通過在窄屏下將側邊欄轉換爲緊湊的頂部欄，來節省這些空間。

核心功能¶

該插件主要在 768px 寬度或更窄的屏幕上生效：

1. 側邊欄形態變化：側邊欄不再佔據網格列，而是變爲隱藏的抽屜（off-canvas drawer），通過漢堡菜單打開。
2. 頂部欄佈局：頂部欄包含漢堡菜單、品牌標記和新建會話按鈕。
3. 右側面板調整：右側面板（文件/文檔預覽）變爲全寬固定面板。
4. 設置模態框重定位：設置模態框會重新定位，避免遮擋頂部欄。

安裝與啓用¶

在 DSH profile 目錄下執行安裝命令：

dsh plugin --profile web add github:pureexe/dsh-mobile-topbar

安裝後，需在 profile 的 package.json 的 dsh.profile.bundles 中列出該插件：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-mobile-topbar"
      ]
    }
  }
}

重啓 profile（例如 dsh web）以應用更改。

兼容性與注意事項¶

• 版本兼容：已驗證兼容 DSH 0.1.5-rc.3、0.1.6-alpha.x、0.1.7-rc.x 和 0.2.0-rc.2。
• CSS 實現細節：CSS 覆蓋針對 DSH 構建生成的特定類名（內部實現細節），未來版本可能會更改。
• 0.1.7 版本的禁用方式：在 0.1.7 主機上禁用該插件時，不要在 cordis.patch.yml 中添加 disabled: true，應從 dsh.profile.bundles 中移除插件。
• 依賴聲明：該插件故意聲明沒有 peerDependencies。