dsh-client-ui-mobile-adaptDeepSeek Harness plugin

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, 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: 768px 视口下生效，桌面端完全不受影响。 采用官方客户端插件格式（dsh.client 声明 + window.__ModuleLoader__.load 模块）， 同时可作为 profile bundle（dsh.bundle.patch）一键挂载。

功能

区域	效果
整体布局	三栏 Grid 覆盖为 0 minmax(0,1fr) 0，中栏占满全宽
侧边栏	左侧抽屉（left 位移动画），内容组件填满抽屉宽度
汉堡按钮	shell.overlay 槽位浮动按钮（左上角，安全区适配），点遮罩关闭
会话头部	给汉堡留位、标题/操作可换行、「对话/轨迹」标签以屏幕中线为对称轴居中
输入工具行	强制单行（权限选择/计划/附加/模型选择/上下文/发送），触发器限宽 112px
弹层	模型选择、上下文详情、命令菜单限宽 calc(100vw - 16px) 不出屏
设置面板	全屏显示，顶部导航单行可横滑，内容区可滚动，自带 × 关闭
插件面板	fixed 悬浮、底部 130px（不遮触发按钮），可开可关
轨迹页面	表格全宽；详情面板改固定高度悬浮窗（min(52vh,460px)），内部可滚动
底部统计	胶囊摘要（轮/步/缓存/Token），点击展开完整统计面板（可滚动，× 关闭）
iOS	100dvh 动态视口、刘海/底部安全区适配

安装

方式一：推荐 —— 专用 profile（dsh --profile webmobile）

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

bash
1# 1. 创建 webmobile profile（在 $DSH_HOME/profiles/webmobile/）
2#    package.json:
3#    {
4#      "name": "dsh-profile-webmobile",
5#      "private": true,
6#      "dependencies": {
7#        "dsh-client-ui-mobile-adapt": "https://github.com/Hotsteel2901/dsh-client-ui-mobile-adapt/archive/refs/heads/main.tar.gz"
8#      },
9#      "dsh": { "profile": { "bundles": [
10#        "@deepseek-ai/dsh-base",
11#        "@deepseek-ai/dsh-web-app",
12#        "dsh-client-ui-mobile-adapt"
13#      ] } }
14#    }
15
16# 2. 安装依赖
17cd ~/.dsh/profiles/webmobile
18npm install
19
20# 3. 启动（= web 全部功能 + 手机适配）
21dsh --profile webmobile

方式二：装进已有 profile

bash
# 任意 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 里插入一行：

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

重启即生效。

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

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

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

版本约束：CSS 类名对应 DSH 0.1.0-rc.6 的前端构建产物（CSS Modules 哈希类名）。 peerDependencies 已精确锁定到 0.1.0-rc.6（不是 ^0.1.0-rc.6）： ^ 范围会解析到更新的构建（如 0.1.0-rc.8），其哈希类名与 rc.6 不一致会导致布局类名失效。 若 DSH 升级、前端构建变化，需要按新构建产物重新核对类名，并同步更新 peerDependencies。

依赖

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

开发 / 发布

bash
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 行）

涉及的产品内部类名（对应 0.1.0-rc.6 前端构建）

• 布局：.pI_x6G_*（dsh-client-ui-layout）
• 会话/输入：.wSkVaW_*、.uV2eYG_*、.Md3f7G_*（dsh-client-ui-conversation）
• 设置：.VOzbGW_*（dsh-client-ui-settings-general）
• 插件面板：.Nqubda_*（dsh-client-ui-cordis）
• 轨迹：.qBU-ya_*、.Y0dWHa_*、.fV0t5q_*（dsh-client-ui-trajectory）

License

MIT