前言¶

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。