dshbase

Plugin directory / UI & Skins / dsh-client-ui-mobile-adapt

dsh-client-ui-mobile-adapt

Verified · install-tested on dsh Hotsteel2901

✓ Actively maintained Builds on 5 official DSH packages

View on GitHub ↗ ← Back to plugin directory

10Stars
1Forks
2Open issues
JavaScriptLanguage
2026-08-28Last push
Cross-platformPlatform

What it does

Your DeepSeek Harness web UI, rebuilt for the phone in your hand. Built for developers who code in Termux on Android: single-column layout, sidebar drawer, one-line composer, fullscreen scrollable settings & trajectory details, tap-to-open session stats. Desktop untouched.

✅
Our take
Works — verified, early-stage project

Your DeepSeek Harness web UI, rebuilt for the phone in your hand. Built for developers who code in Termux on Android: single-column layout, sidebar drawer, one-line composer, fullscreen scrollable settings & trajectory details, tap-to-open session stats. Desktop untouched. It installs cleanly and boots without issues in our testing. It's early-stage but functional.

“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.

README

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。

# 1. 创建 webmobile profile(在 $DSH_HOME/profiles/webmobile/)
#    package.json:
#    {
#      "name": "dsh-profile-webmobile",
#      "private": true,
#      "dependencies": {
#        "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

方式二:装进已有 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'

重启即生效。

⚠️ 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

版本约束: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-* 包

开发 / 发布

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

Install

🧩 Let your agent install it (recommended)

Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:

dsh plugin add dshbase-catalog

Then say "install dsh-client-ui-mobile-adapt for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.

This plugin is GitHub source (not published to npm) — install it straight from the repo:

Web profile:

dsh plugin --profile web add github:Hotsteel2901/dsh-client-ui-mobile-adapt

Headless (CLI) profile:

dsh plugin --profile headless add github:Hotsteel2901/dsh-client-ui-mobile-adapt

Test report

Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.

When to use it

Change how dsh looks or how you interact with it — a theme, a skin, or a new panel that reshapes the workspace.

Who it's for

Users who spend hours in the web UI and want it to look and feel the way they work.

For developers — extending it

Skins, panels, and theme tokens are the extension points — author a new skin, add a panel, or sync tokens with an upstream palette.

Security: not yet scanned — our daily static scan will cover it shortly.

Share this badge

More in UI & Skins

Browse all 7797 plugins →