DeepSeek Harness (DSH) 的 Web 界面在设计上偏向通用,在移动设备或 PWA 场景下可能存在交互冗余。dsh-mobile-ui 插件提供了一套移动优先的界面重构方案,将现有的 Web UI 修改为更接近原生应用的体验。
插件概况¶
- 名称:dsh-mobile-ui
- 所有者:Canary-Builds
- 分类:客户端
- 许可证:MIT
该插件通过 Cordis 架构注入 CSS 样式和 PWA Manifest,在不修改核心代码的情况下,改变 Web 界面的布局和交互逻辑。
核心功能¶
侧边栏优化¶
侧边栏采用应用风格设计:
- 可折叠图标栏:折叠后隐藏 56px 的图标栏,聊天区域占据全屏宽度。
- 浮动鲸鱼启动器:在侧边栏第一列的头部中央显示主题跟随的鲸鱼图标。点击可展开侧边栏,以全屏覆盖层的形式覆盖聊天区域,而非推开内容。
- 自动收起:从会话列表打开会话时,侧边栏会自动收起。
顶部栏与控制¶
- 全宽顶部栏:顶部栏宽度铺满。
- 模式芯片:显示当前代理预设模式(如 STD, PTC, MIN, CTR),支持中英文。
- 日志导出:右侧提供会话日志导出按钮。
设置界面¶
- 全屏设置表:设置面板铺满全屏,无边距和圆角。
- 图标导航:导航栏折叠为仅图标模式,保留无障碍标签。
PWA 支持¶
- 插件提供独立的 PWA Manifest,设置
display: standalone,使界面能像原生应用窗口一样安装和运行。
安装与启用¶
确保环境满足以下条件:
- Node.js 22.19+
- DeepSeek Harness (DSH)
安装插件到 Web 配置文件:
dsh plugin --profile web add @canary-builds/dsh-mobile-ui
安装完成后,重启 DSH 并刷新浏览器即可生效。
典型用法¶
迁移自 Splash 插件¶
如果之前安装了 dsh-plugin-splash,需要先移除再安装:
dsh plugin --profile web remove dsh-plugin-splash
dsh plugin --profile web add @canary-builds/dsh-mobile-ui
如果安装过过渡包 @canary-builds/dsh-wpa,请先移除它:
dsh plugin --profile web remove @canary-builds/dsh-wpa
代码测试¶
插件包含测试脚本,可在本地运行:
npm test
npm run test:package
注意事项与兼容性¶
- 桌面浏览器:桌面浏览器标签页中的 UI 保持原样(Stock UI),样式和交互仅对触摸设备生效。
- 版本依赖:CSS 类哈希是构建特定的,插件针对 DSH 0.1.1-rc.x 版本编写。如果 DSH 升级导致类名哈希变化,功能可能失效(不会报错,只是不生效)。
- 冲突规避:不要与
dsh-plugin-splash或@canary-builds/dsh-wpa同时加载,两者拥有相同的 UI 行为和路由。 - 重置方式:禁用该插件行可完全恢复所有样式、插槽和路由。
生态背景¶
DeepSeek Harness 采用「一切皆插件」的理念。社区目录 skillhub.cn 提供了插件索引,与 DeepSeek 或幻方官方无从属关系。