dsh-mobile

非侵入 · 轻量 · 灵活的移动适配 —— DeepSeek Harness（dsh web）的 Android 移动前端。

dsh 是 DeepSeek 官方的 AI 编码/任务框架，Web UI 运行在 http://127.0.0.1:3080。 本项目零 fork：不修改 dsh 本体，通过薄壳 + 本地插件为它适配移动端体验， 上游升级零冲突。灵活：插件实时加载——改 UI 刷新即所见即所得、改逻辑重启即生效， 随时二次开发，绝大部分改动无需重新编译 APK。

与 DeepSeek 官方无关：本项目是独立开源项目，非 DeepSeek 出品、未经其认可或赞助； "DeepSeek" 及相关商标归其各自所有者所有。

核心设计

原则	做法	收益
非侵入	不 fork、不改上游；只依赖稳定语义锚点（data-* / role= / 事件名 / 官方接口）	上游升级零冲突，永久可跟进
轻量	薄壳只管平台能力（WebView / 通知 / 安全区），UI 全在本地插件	改 UI 不重建 APK，插件即插即用
适配	移动端体验层：全面屏安全区 / 侧栏抽屉 / 通知状态机 / 移动设置	手机成为 dsh 的一等客户端
灵活	插件实时加载：client 改动刷新即见、host 改动重启即生效；仅壳层需重编译	随时二次开发，所见即所得

界面预览

对话	移动设置	排版优化

特性

壳（APK）

• 深色一体化：状态栏/手势条与页面同色，edge-to-edge 全面屏
• 原生 insets 安全区：内容自动避开状态栏/挖孔/手势条/输入法键盘，上下偏移可调
• 离线自动重试 + 内置离线页（远程连接 / 连接历史 / Termux 直链 / 一键启动 / 一键安装）
• 界面语言自动跟随系统（中/英）

通知（本地插件）

• 会话运行常驻通知（不可滑关）+ 完成/提问/截断/故障横幅，一会话一通知
• 手动暂停静默退出；点按通知跳转对应会话；重启无残留
• 声音/震动开关、AI 动作摘要（可选，额外消耗）

移动 UI（本地插件）

• 对话栏移动端适配（竖屏不溢出、统计条自适应转行、头部紧凑排布）
• 活动计数按钮（运行中/已完成未读，面板展开跳转）
• 移动端设置：连接地址 / 通知 / 全面屏 / 重启 / 安全模式（一键回原版）

安装

① termux 直装（推荐）

1. 安装 Termux（F-Droid 版，不要用 Play 商店版）
2. Termux 里执行（脚本自动：初始化 pkg → 工具链 → 装 dsh → 原生依赖修补 → SELinux 检测 → 插件挂载）：

pkg install -y curl
curl -L -o dsh-install-termux.sh https://raw.githubusercontent.com/knGear/dsh-mobile/main/scripts/dsh-install-termux.sh
bash dsh-install-termux.sh

1. 安装 APK：点击 Releases 下载最新版即可
2. 配置 API → 享用

② termux-ubuntu（稳定）

1. 安装 Termux（F-Droid 版）
2. Termux 里执行（脚本自动：初始化 → 安装 Ubuntu → 装 dsh → 插件挂载）：

pkg install -y curl
curl -L -o dsh-install-linux.sh https://raw.githubusercontent.com/knGear/dsh-mobile/main/scripts/dsh-install-linux.sh
bash dsh-install-linux.sh

1. 安装 APK：点击 Releases 下载最新版即可
2. 配置 API → 享用

③ addone-mobile（已有 dsh 追加）

适用于 PC / 服务器 / Termux 等任意环境。若尚未安装 dsh，先用官方命令安装：

官方安装 dsh：

npm i -g @deepseek-ai/dsh
dsh web

⚠ npm 直装的 dsh 直接跑 dsh web 可能加载不到本地插件（bin.js 缺 --expose-internals）。 两个安装脚本会自动生成 dsh wrapper 解决；手动环境可让 AI 按仓库脚本处理。

然后安装移动端插件，按你的平台选一个（任选其一，重复运行 = 更新到最新版）：

bash 版（Linux / macOS / Termux）：

curl -L -o dsh-addone-mobile.sh https://raw.githubusercontent.com/knGear/dsh-mobile/main/scripts/dsh-addone-mobile.sh
bash dsh-addone-mobile.sh

Node 跨平台版（Windows 等任意平台，需 Node 18+）：

curl.exe -L -o dsh-addone-mobile.mjs https://raw.githubusercontent.com/knGear/dsh-mobile/main/scripts/dsh-addone-mobile.mjs
node dsh-addone-mobile.mjs

或者，复制下面的仓库链接直接贴给 AI，让它帮你完成安装配置：

https://github.com/knGear/dsh-mobile

最后安装 APK：点击 Releases 下载最新版即可，连接本机（默认 127.0.0.1:3080）或远程（离线页输入 IP:端口），配置 API → 享用。

从源码构建

# 环境: proot Debian(Trixie) + aapt/javac/d8/zipalign/apksigner
git clone git@github.com:knGear/dsh-mobile.git
cd dsh-mobile && bash build.sh
# 产物: out/DSH-v<版本>.apk

⚠ 老 d8 不支持 lambda（Unable to find method metafactory）——Java 代码一律用匿名类。

项目结构

app/                      # Android 壳 (com.dsh.mobile, minSdk 26 / target 34)
  src/main/java/          #   MainActivity(安全区/IME/离线页/JS桥) + NotifyReceiver(通知渠道)
  src/main/res/           #   图标/主题/多语言 strings
build.sh                  # 构建脚本(proot Debian 混合构建)
release.keystore          # 发布签名(alias dshmobile, 密码随仓库公开——FOSS 实践)
icon-master.svg           # 图标源
plugins/
  cordis.patch.yml        # 插件挂载示例
  mobile-ui/              # 移动 UI 插件(布局注入/设置/活动计数)
  mobile-AndroidNotify/   # 通知插件(状态机/开关/工具)
scripts/
  dsh-install-termux.sh   # Termux 原生一键安装(含插件)
  dsh-install-linux.sh    # Termux 内 Ubuntu 一键安装(含插件)
  dsh-addone-mobile.sh    # 已有 dsh 追加插件(bash 版)
  dsh-addone-mobile.mjs   # 已有 dsh 追加插件(Node 跨平台版)
PROMPT.md                 # 项目总提示词(需求规格, 可作跑分题)
AGENT.md                  # AI 开发地图(铁律/修改路径/待办)
docs/                     # 架构/壳/双插件/自定义/构建发布指南

文档体系（AI 与维护者）

• PROMPT.md —— 需求规格（跑分题：功能/约束/验收，无实现线索）
• AGENT.md —— 开发地图（铁律/修改路径/待办/教训）
• docs/ —— 架构总览、壳指南、双插件指南、自定义速查、构建发布

插件挂载

# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
    - id: mobile-notify
      name: 'mobile-AndroidNotify'
    - id: mobile-ui
      name: 'mobile-ui'

⚠ 带 client 的包 exports 必须包含 "." 与 "./package.json"；插件 id 全树唯一，用 mobile- 前缀避免与上游撞名。

兼容性

• dsh：@deepseek-ai/dsh@0.1.0-rc.6（npm）
• Android：minSdk 26 / target 34（Android 8.0+）
• 界面语言：自动跟随系统（中/英，与官方一致，无切换按钮）
• 无 root 可用：安装/通知/远程连接均不依赖 root（仅旧版设备的 SELinux 补丁为可选步骤，失败自动跳过）

版本历史

• v0.01 — 首个公开版（本地 0.17 迭代重编号）

Credits

本程序使用 DeepSeek Pro / DeepSeek Flash 进行构建（DeepSeek Harness agent 辅助开发）。

License

MIT © knGear