前言¶
DeepSeek Harness(DSH)的 Web 客户端在桌面宽屏下布局已经比较成熟;若你在手机竖屏浏览器或 Android 壳里打开同一套界面,左侧栏、输入区和工具条往往挤在一屏里,单手操作成本高。自己改官方布局插件或 fork 内核,升级和维护成本都偏高。
下面介绍社区维护者 XiaoPb 发布的 Cordis 客户端插件 @xiaopb/dsh-mobile-layout:只在手机竖屏下切换为触控向布局,横屏、平板与桌面保持官方默认,且不替换官方布局插件、不修改内核。
这是什么¶
@xiaopb/dsh-mobile-layout 归类为 DSH 客户端插件,面向 Web profile。它通过 Cordis 注入客户端脚本(发布物为单文件 lib/client.js),在识别到手机竖屏形态时给页面加上 data-dshm-mode="mobile" 作用域内的样式与交互;锚点失败或卸载插件时回退官方布局。
插件在 SkillHub 目录 可检索,源码与文档在 GitHub:XiaoPb/dsh-mobile-layout。package.json 中声明的 DSH 兼容下限为 >=0.2.1-rc.2,许可证为 MIT。
核心功能¶
形态识别与零侵入¶
插件识别三种宿主:Android 壳、桌面 Electron、浏览器。桌面端 DeepSeek Harness 永不激活该布局;其余形态仅在手机竖屏下生效,横屏与桌面像素级保持官方原样。样式与逻辑受 html[data-dshm-mode="mobile"] 作用域保护,卸载或注入失败即回退。
抽屉式左侧栏¶
官方左侧栏在手机竖屏下改为抽屉:屏幕左侧约 60% 区域右滑打开,支持跟手拖拽与松手吸附;遮罩或左滑关闭。入口为手势、无额外按键,避免遮挡子页返回键;手势在 window 捕获阶段常驻。仅在真正换页时自动收起,点空白、搜索、账号菜单等不会误关。
底部操作条与加号面板¶
输入区上方常驻约 56px 高的操作条:新建、会话、文件、图片、插件、更多。加号面板与软键盘采用揭开 / 覆盖式切换,开合带动画(系统「减少动态效果」时跳过)。面板为 4 列 × 2 行宫格,超过 8 项可横向分页;图标按功能类型哈希配色(蓝 / 橙 / 紫 / 绿等档位)。
会话与插件面板¶
按工作区分组、吸顶标题、相对时间,高度最多约占屏高 64%。顶部把手下拉即关,视觉对齐官方弹层规范。输入区与底部面板融合:去圆角 / 边框 / 阴影、全宽同表面;权限与模型短名 chip 留在输入行(「完全访问」恒标红,中英文均识别)。
设置页与选择器¶
设置页改为全屏:品牌行、可横滑页签、返回键;内容区横滑切换页签。模型 / 权限二级菜单改为贴底列表,选中态用主题蓝;空态打开选择器时不自动弹软键盘(点搜索框仍可输入)。
浮层互斥¶
抽屉、底部表、加号面板互斥,按层序逐层关闭;加号面板与输入法双向互斥(开面板先收键盘,面板开着点输入框先收面板再拉起键盘)。
三套布局预设¶
在 设置 → 通用设置 → 外观 下的「布局模式」中一键切换,即时生效、三档可双向切换且不残留:
- 原生:整体交还官方布局;官方设置弹窗改为居中悬浮窗(左右等宽、上下约 10% 视口留白,小屏保底、大屏封顶)。
- 融合:输入区与底栏连成一整条;空态虚线输入卡左右留白对称。
- 悬浮:手机应用形态——底部五项导航(会话 / 自动化任务 / 插件 / 工作台 / 设置)、输入卡悬浮、加号面板改为一 / 二级菜单;工作台开关官方右侧面板;透明底栏;可用 CSS 变量
--dshm-engine-bar(默认56px)为宿主「引擎已就绪」状态条让位,习惯先收起可设为0px。
插件自绘 UI 文案随官方语言实时刷新;支持 aria-modal、焦点管理与动效降级。
几何量通过 html[data-dshm-form="phone"] 下的 CSS 变量与 env(safe-area-inset-*) 适配多机型,可在用户样式中覆盖,例如 --dshm-settings-gutter、--dshm-classic-gutter、--dshm-v2-nav 等(完整表格见仓库 README)。
安装与启用¶
在已配置 Web profile 的 DSH 环境中,使用资料原文给出的命令安装:
dsh plugin --profile web add @xiaopb/dsh-mobile-layout
安装后客户端会按 cordis.patch.yml 注入 @deepseek-ai/dsh-client-runtime 与 @deepseek-ai/dsh-client-ui-layout 相关客户端 bundle。插件以当前 DSH 进程权限运行,安装前应阅读仓库源码与 MIT 许可证,确认符合你的安全与合规要求。
典型用法¶
- 安装插件后,用手机竖屏打开 DSH Web 客户端(或 Android 壳内的 Web 视图),确认左侧栏可通过边缘右滑以抽屉形式打开。
- 在输入区上方使用底栏快捷入口;点「更多」或加号区域展开面板,需要输入时注意面板与键盘的互斥行为。
- 进入 设置 → 通用设置 → 外观 → 布局模式,在原生 / 融合 / 悬浮三张卡片间切换,按习惯选择单手或「应用式」导航。
- 若悬浮模式下顶部被宿主引擎状态条占用,可在自定义 CSS 中调整
--dshm-engine-bar。 - 桌面 Electron 或宽屏浏览器下无需关闭插件:布局保持官方默认,便于同一套 profile 多端共用。
更细的预设截图与页面说明见仓库 docs/preset-default.md、docs/preset-classic.md、docs/preset-v2.md 及架构文档 docs/architecture.md。
适用场景与注意¶
适合:经常在手机竖屏使用 DSH Web 客户端、希望抽屉侧栏、底栏快捷入口与可选「悬浮」导航,且不想改官方内核或替换官方 layout 插件的开发者与用户。
注意:
- 仅手机竖屏激活;横屏、平板、桌面不受影响。
- 社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系;插件非官方出品,星标与版本以目录页与 npm 为准。
- 依赖 Cordis 与声明的 DSH 版本下限,升级 DSH 后若布局异常,应对照仓库
dsh.compatibility与 CHANGELOG。
结尾¶
@xiaopb/dsh-mobile-layout 把 DSH Web 在手机竖屏下的侧栏、输入区与常用操作收成触控向布局,并通过三套预设与 CSS 变量保留可调空间,同时坚持桌面与横屏官方原样。需要安装命令与变量表时直接查阅仓库 README;目录页 SkillHub,源码 GitHub。