dsh-client-ui-mobile-adapt

dsh-client-ui-mobile-adapt

Your DeepSeek Harness web UI, rebuilt for the phone in your hand.

Built for developers who code in Termux on Android: the three-column desktop shell collapses into a clean single-column mobile layout — sidebar becomes a swipe drawer, composer tools stay on one line, settings and trajectory details open as full-screen panels that actually scroll, the right sidebar becomes a full-screen file/terminal layer, and a tap on the stats pill reveals the whole session report. Desktop stays exactly as it is; your phone finally works.

为在手机上用 Termux 敲代码的你，把 DeepSeek Harness 的 Web 界面真正搬上手机屏。

专为 Android 上的 Termux 开发者打造：三栏桌面布局收敛为清爽的单栏移动布局—— 侧边栏变成滑出抽屉、输入工具保持一行、设置与轨迹详情以可滚动的全屏面板呈现、 右侧栏变成全屏文件/终端层、点一下统计胶囊就能看到完整会话报告。 桌面端分毫不动，手机端终于能用了。

DeepSeek Harness Web GUI 的手机端适配客户端插件。

纯客户端插件：仅在 max-width: 767px 视口下生效，其余宽度完全不受影响。 （767 而非 768：上游 dsh-client-ui-layout 的 SIDEBAR_AUTO_COLLAPSE = 1024， 768–1023px 归上游的 56px 图标窄栏管，768px 起保留侧栏导航更合理。） 采用官方客户端插件格式（dsh.client 声明 + window.__ModuleLoader__.load 模块）， 同时可作为 profile bundle（dsh.bundle.patch）一键挂载。

功能

触摸目标修复（issue #2 根因）

上游沿用桌面尺寸，多个控件低于 44px 的最小可点区域。手机端指尖落点约 30–40 CSS px， 用户点不中，体验上就表现为「划不动 / 点不动」，这即是 issue #2《无法滑动导致无法保存配置》 的真实机制。

最严重的是字号调节 stepper：.bVCLcG_arrows 是一个 absolute 列容器， 内含两个 17×12px 上下堆叠的箭头，中心仅相距 14px —— 想调大却触发调小， 反复失败后配置就改不成。本插件在窄屏把它重排为 static 行， 两个 44×44 热区并排互不重叠。

其余一并抬到 44px 的下限：

修复的 JS 逻辑缺陷

除 CSS 之外，一并修掉了 lib/client.js 中的若干运行时缺陷：

修复的上游组件替换（DSH STORE 契约）

底部统计条目此前注册进 conversation.composer.dock 时冒用了上游 ui-chat 的条目 ID "stats" （同 ID + 更低 priority = 遮蔽官方组件），违反 DSH STORE「不替换官方组件、只用插件自有 ID」契约。

现已改为插件自有 ID dsh-mobile-stats，不再遮蔽官方条目。手机端只在 本插件胶囊确实渲染出来时，用 .uV2eYG_dock:has(.dsh-stats) 隐藏上游统计行：

• 0.2.0 用 .bOPqQW_root，0.2.1 用 .bOPqQW_anchor（activity / usage 两个胶囊），双代都匹配；
• 桌面端完全不动上游（本插件胶囊基态 display: none）；
• 插件统计组件异常或无数据时，官方统计行仍在，不会出现“两边都没有统计”的空窗。

StatsBoundary 会把这个 dock 的渲染错误限制在插件内部：捕获后渲染 null， 官方统计继续工作，控制台留下一条告警。

安装

方式零：一键脚本（推荐）

仓库自带一键安装脚本，自动完成「定位 dsh → 建 profile → 装依赖 → 校验」全流程。

Linux / macOS / WSL / Git-Bash

curl -fsSL https://raw.githubusercontent.com/Hotsteel2901/dsh-client-ui-mobile-adapt/main/install.sh | bash

或在 clone 下来的仓库里直接跑：

./install.sh                      # 装进默认 profile webmobile
./install.sh --profile my-ui      # 自定义 profile 名
./install.sh --check              # 只体检、不改动
./install.sh --version 0.2.1-rc.2 # 手动钉版本

Windows（PowerShell 5.1+ / 7+）

.\install.ps1
.\install.ps1 -Profile my-ui
.\install.ps1 -Check

脚本会把插件装进 $DSH_HOME/profiles/<profile>/，并注册到 package.json 的 dsh.profile.bundles，最后逐项校验关键包是否到位。

关于 curl … | bash 一键跑：本包尚未发布到 npm，所以脚本在检测不到本地 checkout 时会自动 git clone --depth 1 到临时目录再安装 —— 因此该用法需要 git。 想省掉克隆，就先 clone 仓库再从仓库里跑 ./install.sh（推荐，零依赖）。 --from-npm / -FromNpm 目前仅在包已发布后才可用。

需要 pnpm：dsh plugin 本身就是 pnpm 的一层封装。dsh 的 SEA 发行版内置 pnpm， 但通过 npm 安装的 dsh 会去 PATH 上找 pnpm，找不到就报 pnpm not found on PATH。脚本会先检测，缺失时自动用 corepack 或 npm i -g pnpm 装一个；实在装不上才会报错让你手动装。

给管道传参的正确写法

curl … | bash 后面直接接 --version 会被 bash 自己吃掉（变成查 bash 版本）。 要传给脚本，必须用 -s --：

# ✗ 错误：打印的是 bash 的版本
curl -fsSL .../install.sh | bash --version 0.2.1-rc.2

# ✓ 正确
curl -fsSL .../install.sh | bash -s -- --version 0.2.1-rc.2
curl -fsSL .../install.sh | bash -s -- --profile my-ui

其实一般不用传 --version：脚本会依次用「profile 里已钉的版本」→ dsh --version → registry 的 next tag 来推断，全失败才回退 0.2.1-rc.2。

脚本替你踩掉的三个坑

自己手动装很容易在这里翻车，脚本已固化处理：

装完直接启动：

dsh --profile webmobile

方式一：手动 —— 专用 profile（dsh --profile webmobile）

本包同时是 profile bundle，最省事的使用方式是建一个包含它的 profile。

# 1. 创建 webmobile profile（在 $DSH_HOME/profiles/webmobile/）
#    package.json:
#    {
#      "name": "dsh-profile-webmobile",
#      "private": true,
#      "dependencies": {
#        "@deepseek-ai/dsh-base": "0.2.1-rc.2",
#        "@deepseek-ai/dsh-web-app": "0.2.1-rc.2",
#        "dsh-client-ui-mobile-adapt": "https://github.com/Hotsteel2901/dsh-client-ui-mobile-adapt/archive/refs/heads/main.tar.gz"
#      },
#      "dsh": { "profile": { "bundles": [
#        "@deepseek-ai/dsh-base",
#        "@deepseek-ai/dsh-web-app",
#        "dsh-client-ui-mobile-adapt"
#      ] } }
#    }

# 2. 安装依赖
cd ~/.dsh/profiles/webmobile
npm install

# 3. 启动（= web 全部功能 + 手机适配）
dsh --profile webmobile

走 npm 路线时 peer 会被自动安装，所以不容易遇到上面那个 dsh-session-title-llm 缺失问题；但走 dsh plugin（pnpm）路线时必须先把 pnpm-workspace.yaml 里的 autoInstallPeers 改成 true。

方式二：装进已有 profile

# 任意 profile 目录下
dsh plugin --profile web <profile 名> add https://github.com/Hotsteel2901/dsh-client-ui-mobile-adapt/archive/refs/heads/main.tar.gz

或手动在 profile 的 cordis.patch.yml 里插入一行：

- insert:
    - id: ui-mobile-adapt
      name: 'dsh-client-ui-mobile-adapt'

重启即生效。

⚠️ 走 dsh plugin（pnpm）路线前，先确认 profiles/<name>/pnpm-workspace.yaml 里是 autoInstallPeers: true， 否则 dsh-session-title-llm 等 peer 依赖会被静默漏装，启动报 Cannot find package '@deepseek-ai/dsh-session-title-llm'。

⚠️ npm 12 安全策略：npm 默认禁止 git://、github:用户名/仓库 和远程 tarball 依赖 （EALLOWGIT / EALLOWREMOTE）。普通 https://.../archive/refs/heads/main.tar.gz URL 可以正常安装， 所以请使用 tarball URL 形式，不要用 github: 简写。

更新到最新版本（改代码重新 push 后）：

npm cache clean --force && rm -rf node_modules/dsh-client-ui-mobile-adapt && npm install

版本约束：本插件已从 DSH 0.1.0-rc.6 经 0.1.5-rc.2、0.1.7-rc.2 同步到 0.2.1-rc.2（当前 next tag）。 peerDependencies 声明为范围 >=0.1.5-rc.2 <0.3.0，因此 0.1.5-rc.2 / 0.1.7-rc.2 / 0.2.0-rc.2 / 0.2.1-rc.2 都能用； dsh.compatibility 另行给出逐版本声明（见下节）。

选择器策略为分级锚定，越靠前越抗漂移：

1. 官方语义锚（首选）——[data-sidebar-collapsed]、[data-rightbar-col]、 [data-rightbar-collapsed]、[data-chat-flow]、[data-composer-seat] 等。 这些是 dsh 自己声明的扩展点，不会随构建哈希变化。
2. 本插件自有类名——.dsh-mobile-hamburger、.dsh-stats-panel 等，完全自控。
3. 上游哈希类名（兜底）——仅在无语义锚时使用。已对 0.1.5-rc.2、0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.2 全量核对， 改名的一律双代同时匹配（见 lib/client.js 的 DRIFT REGISTER）。

历史代际的哈希类名一并保留（如 Sh0Q9G_*、iWlSmW_*、lats3W_*、uV2eYG_* 仍在选择器列表里）， 所以插件在任一受支持版本上都不会退化。

若 DSH 再次升级，优先检查 DRIFT REGISTER（见 lib/client.js 文件头注释）中登记的漂移， 再跑 tools/regress.py 与 tools/sync_check.py 复验选择器是否仍然命中。

测试工具注意（0.2.0-rc.2 起，0.2.1 相同）：0.2.0-rc.2 起的客户端会保持一条长连接， 导致 Playwright 的 wait_until="networkidle" 永不触发（表现为 Page.goto 45s 超时）。 tools/ 下的脚本已统一改为 wait_until="domcontentloaded" + 固定等待。 自己写脚本时请照此办理；对 0.1.x 两代两种等待都可以，但统一用 domcontentloaded 最稳。

DSH 兼容性声明

package.json 的 dsh.compatibility 按 DSH STORE 契约逐版本声明，engines.node 声明 Node 范围：

"compatibility": {
  "dsh": ">=0.1.5-rc.2 <0.3.0",
  "dshReleases": {
    "0.1.5-rc.2": "compatible",
    "0.1.5-rc.3": "compatible",
    "0.1.6-alpha.1": "compatible",
    "0.1.6-alpha.2": "compatible",
    "0.1.7-rc.1": "compatible",
    "0.1.7-rc.2": "compatible",
    "0.2.0-rc.1": "unknown",
    "0.2.0-rc.2": "compatible",
    "0.2.1-alpha.1": "unknown",
    "0.2.1-alpha.2": "unknown",
    "0.2.1-alpha.3": "unknown",
    "0.2.1-alpha.4": "unknown",
    "0.2.1-alpha.5": "unknown",
    "0.2.1-rc.1": "unknown",
    "0.2.1-rc.2": "compatible",
    "0.1.3-alpha.1": "incompatible",
    "0.1.3-alpha.2": "incompatible",
    "0.1.5-alpha.1": "incompatible",
    "0.1.5-alpha.2": "incompatible",
    "0.1.5-rc.1": "incompatible",
    "0.1.7-alpha.1": "unknown",
    "0.1.7-alpha.2": "unknown"
  }
}

判定依据是对上游发行包 dist 的静态核对（语义锚 + 插件引用到的全部哈希类名 + 槽位/投影 API）； 0.2.1-rc.2 另做过真实 Profile 的运行验收（插件包正常投递、汉堡/抽屉/统计/设置/轨迹/右栏在手机端接管、 桌面端零改动、零 hOverflow、插件自身零页面错误）。

• compatible：该版本 dist 中本插件引用的锚点/类名/API 全部命中。
• incompatible：早于本插件声明的支持下限（0.1.5-rc.2）。
• unknown：0.1.7-alpha.1 / 0.1.7-alpha.2 的 agent-preset 改版删除了 rtSEdW_iconButton（删除按钮 44px 触摸目标规则失配），未做完整核对； 0.2.0-rc.1、0.2.1-rc.1 为过渡版本，未单独核对。

依赖

• react、@deepseek-ai/cordis
• 运行时客户端服务（由 host 侧其他 client 包提供）：slots、layout、locale
• peer 依赖中的 @deepseek-ai/dsh-client-* 包

测试

# 纯逻辑单测（格式化函数的进位/边界），无需浏览器
npm test                          # = node tools/unit.test.mjs

# 选择器同步校验（0.2.1-rc.2）：确认每个哈希类名仍命中，且仍只在手机端生效
python3 tools/sync_check.py "http://127.0.0.1:18081/?token=<token>"

# 端到端回归（需一个运行中的 dsh web 实例）
python3 tools/regress.py "http://127.0.0.1:18081/?token=<token>"

tools/*.py 会自动从 ~/.cache/ms-playwright/chromium-*/chrome-linux*/chrome 选择 Chromium；装在别处时用 CHROME=/path/to/chrome python3 ... 覆盖。

sync_check.py 覆盖那些只在活会话里才挂载的组件（composer 模式触发器、模型/智能体选择器）。 它不依赖可用的 LLM 凭据——而是插入带真实上游类名的探针元素，然后测量插件注入的样式表： 断言在 390px（手机） 上样式生效、在 1440px（桌面） 上原样未动。 两侧同时成立才说明「选择器仍命中上游 且 仍被正确限定在移动端断点内」。

regress.py 断言两组：

• A. 触摸目标：设置面板四个 tab 内所有可交互控件 ≥ 44×44
• B. 布局：6 视口（iPhone SE/14、Pixel 7、iPad Mini、Laptop、Desktop）无横向溢出、 无越界元素；手机端单栏 + 汉堡显示 + 抽屉 fixed，桌面端保持原生三栏 + 汉堡隐藏

并回归 issue #2：字号 stepper 两箭头不重叠，且点击真实生效（14 → 15 → 14）。

开发 / 发布

npm pack              # 本地打包验证
npm publish           # 发布到 npm（需 npm 账号与 2FA；本包也可以只留在 GitHub）

包结构：

lib/index.js              # host 空入口
lib/client.js             # 浏览器客户端插件（window.__ModuleLoader__.load 官方格式）
cordis.patch.yml          # bundle patch（insert ui-mobile-adapt 行）
tools/unit.test.mjs       # 格式化函数单测
tools/regress.py          # 端到端回归（触摸目标 + 6 视口布局）
tools/probe.py            # 单次探测：CSS 注入 / 网格列 / 溢出
tools/test_mobile.py      # 多视口布局指标采集
tools/test_interactions.py# 交互路径探测（抽屉/设置/统计）

涉及的产品内部类名（已核对 DSH 0.1.5-rc.2、0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.2）

按所属包归类（扫描各代发行包 dist 得到；跨代变化标注在括号内）：

已知漂移

rc.6 → 0.1.5-rc.2：

• pI_x6G_detailsCol → 更名 pI_x6G_rightbarCol（两代同时匹配，并已换成 [data-rightbar-col] 语义锚）
• Md3f7G_*（ChatView.module.css）整包删除；其 min-width:0 职责改由 [data-chat-flow] > * 承担
• wSkVaW_headerActions 拆分出 wSkVaW_headerCorner / wSkVaW_widthHandle（widthHandle 窄屏隐藏；0.2.1 起 headerCorner 保留给右侧栏入口）

0.1.5-rc.2 → 0.1.7-rc.2：

• conversation Sh0Q9G_trigger / Sh0Q9G_triggerLabel 删除，职责并入 uV2eYG_select（两代同时匹配）
• chat lats3W_selector → 更名 _2XZxNq_selector（两代同时匹配）
• chat bOPqQW_root（上游统计行）两代稳定，手机端隐藏以让位给本插件胶囊

0.1.7-rc.2 → 0.2.0-rc.2：

• conversation Sh0Q9G_trigger / Sh0Q9G_triggerLabel（composer 模式触发器）→ iWlSmW_*。 组件还换了包：从 dsh-client-ui-conversation 搬到了 dsh-client-ui-permission-presets。 旧代际仍保留在选择器里，故 0.1.5-rc.2 / 0.1.7-rc.2 不退化。
• 其余各代已核对的前缀在 0.2.0-rc.2 dist 中全部复核仍然存在，原样匹配。

0.2.0-rc.2 → 0.2.1-rc.2：

• chat StatsPills 拆分：.bOPqQW_root 删除，改为两个 .bOPqQW_anchor（activity / usage）。 两代同时匹配，并改为仅在 .dsh-stats 存在时隐藏。
• layout 新增 pI_x6G_bottomRow（shell.bottom 第二行）和 pI_x6G_overlayLayer； frame 只覆盖列轨道，两者保持上游行为。
• conversation 新增 headerLeading / titleCluster / composerHero / heroOptions； headerCorner 在手机端保留（右侧栏入口），只隐藏 widthHandle。
• theme 新增 .bVCLcG_expander，且箭头列默认 opacity:0；触屏规则强制可见。
• settings-general 新增 .VOzbGW_mask；全屏手机模式直接隐藏遮罩。
• 运行时：conversation.composer.dock 提供 useChat，session snapshot 不再有 .chat 包装。 统计组件改为 useChat 优先 + 旧路径兜底。

License

MIT