前言¶
DeepSeek Harness 是一个以插件化为核心的系统，但其默认界面设计基于桌面端的三栏布局。在手机或窄视口下打开时，这种布局会导致导航混乱，且官方设置面板并不适配移动端操作习惯。dsh-ui-mobile-layout 插件通过客户端样式重排与覆盖层叠加，将桌面三栏在窄视口下重排为单栏，并将官方设置面板改造成符合手机原生习惯的两级导航界面。该插件由 RyzeZhou 维护，遵循 MIT 协议。
核心功能¶
- 手机单栏布局：在窄视口下，导航栏收为左侧抽屉，对话区占满整屏，无需在三列间左右横跳。
- 手机原生设置界面：设置面板全屏化，呈现“设置 → 条目列表 → 具体设置页”的二级导航结构。
- 大触控目标：顶部返回键、列表条目均为 ≥44px 触控区，适应手指操作。
安装与启用¶
安装该插件需要手动将包复制到本地实例目录，并在配置文件中登记依赖与 bundle。具体步骤如下：
- 将包复制到
<profile>/node_modules/dsh-ui-mobile-layout。 - 在
profile/package.json的dependencies中添加：
"dsh-ui-mobile-layout": "file:./node_modules/dsh-ui-mobile-layout"
- 在
dsh.profile.bundles数组中添加"dsh-ui-mobile-layout"。 - 重启该实例，并验证 HTTP 200 与插件在 boot graph 中。
安装并重启后即自动生效，无需任何开关。
使用方法¶
- 使用手机（或 DevTools 窄视口）打开 DSH。
- 左侧抽屉：从屏幕左缘滑出（或点左上菜单按钮）。
- 点设置入口进入全屏设置列表。
- 点任意条目进入该条目具体设置页（标题 = 条目名）。
- 使用左箭头返回：详情页回到列表页，列表页关闭设置。
注意事项¶
- 依赖环境：本插件在自带官方基础插件（shell / ui-settings-general / ui-layout 等）的环境实测可用。
- 插件冲突：可能与其他做移动端样式重排的插件、重写/替换官方设置面板或使用极高 z-index 全屏浮层的插件冲突。遇到冲突时建议在独立实例中逐个验证。
- 版本回归：升级 DeepSeek Harness 后需要回归测试，因为官方 SettingsRoot 的 nav/content/close 结构若变化，可能需要轻微适配。
- 运行形态：本插件的真实运行形态是 client bundle 插件（责任在浏览器端），并不修改/替换官方任何 slot 的占用者。
