Thanksgiver233/dsh-mobile

DeepSeek Harness 移动端

DeepSeek Harness Android 应用 — 原生 Kotlin Android 应用，零依赖运行 DeepSeek Harness 引擎，覆盖网页端全部功能。

License: MIT
Android
API

项目简介

DeepSeek Harness (dsh) 是 DeepSeek AI 开源的 Agent 框架，原仅支持 PC 浏览器访问。本项目将其完整迁移至 Android 平台，实现：

- 零依赖安装：内置 Node.js + dsh CLI，下载即用，无需 Root/Termux/额外下载
- 全功能覆盖：完美复刻 Web 端对话、插件市场、会话管理、设置等核心功能
- 竖屏优化：专为手机屏幕设计的竖版 UI，流畅触控交互
- 本地优先：支持本地模式（Android）和云端模式（跨平台）双架构

解决了什么问题？

| 痛点 | 解决方案 |
|------|----------|
| dsh 仅支持 PC 浏览器，无法在手机上使用 | 原生 Android 应用，随时随地使用 |
| 需要 Node.js 环境和命令行操作 | 内置运行时，开箱即用 |
| 移动端体验不佳，Web UI 在手机上难以操作 | 原生竖屏 UI，适配触控交互 |
| 移动网络不稳定导致连接中断 | 本地引擎保活机制 + 自动重连 |
| 多设备数据同步需求 | SQLite 本地存储 + 云端同步可选 |

快速上手

前置条件

- Android Studio Ladybug 或更新版本
- JDK 17+
- Android SDK API 34
- Gradle 8.5+

构建步骤

1. 克隆项目
git clone https://github.com//dsh-mobile.git
cd dsh-mobile

2. 准备引擎资源（需从 deepseek-harness 编译）
将编译好的 node 和 dsh 二进制放入 app/src/main/assets/engine/
或使用预构建版本

3. 构建 Debug APK
./gradlew assembleDebug

4. 构建 Release APK（需签名配置）
./gradlew assembleRelease

安装到设备

通过 ADB 安装
adb install app/build/outputs/apk/debug/dsh-mobile-debug.apk

或直接发送文件到手机安装

功能特性

核心功能

- 对话界面：气泡消息、代码高亮、流式响应
- 会话管理：创建/切换/搜索/删除会话
- 插件市场：浏览和安装 DSH 插件
- 模型设置：切换默认模型、配置 API Key
- 后台保活：Foreground Service 确保引擎持续运行

技术亮点

| 特性 | 实现方式 |
|------|----------|
| 本地引擎运行 | 内置 Node.js ARM64 二进制 + dsh CLI |
| WebView 适配 | 响应式布局 + JavaScript 桥接 |
| 数据持久化 | Room Database + DataStore |
| 网络通信 | OkHttp + WebSocket |
| 状态管理 | Jetpack Compose + ViewModel + StateFlow |
| 依赖注入 | Dagger Hilt |

项目结构

dsh-mobile/
├── app/src/main/
│   ├── java/com/deepseek/dshmobile/
│   │   ├── DSHApplication.kt      # 应用入口 + Hilt 初始化
│   │   ├── di/                    # Dagger Hilt 组件
│   │   ├── service/               # 引擎管理服务
│   │   │   ├── DshEngineService.kt  # Foreground Service
│   │   │   └── DshEngineManager.kt  # 引擎生命周期管理
│   │   ├── database/              # Room 数据库
│   │   ├── repository/            # 数据仓库
│   │   ├── ui/
│   │   │   ├── MainActivity.kt    # Compose 主界面
│   │   │   ├── theme/             # Material 3 主题
│   │   │   ├── components/        # 自定义组件
│   │   │   ├── screens/           # 页面 Screen
│   │   │   ├── nav/               # 导航
│   │   │   └── viewmodel/         # ViewModel
│   │   └── receiver/              # 系统广播接收器
│   ├── res/                       # 资源文件
│   └── assets/engine/             # 引擎二进制（需自行准备）
├── gradle/
│   └── libs.versions.toml         # 版本目录
├── build.gradle.kts               # 根构建配置
└── settings.gradle.kts            # 项目设置

架构设计

graph TB
subgraph "Android App"mermaid
A[MainActivity - Compose UI] --> B[SessionListScreen]
A --> C[ChatScreen]
A --> D[SettingsScreen]
B --> E[MainViewModel]
C --> E
D --> E
E --> F[SessionRepository]
E --> G[DshEngineManager]
F --> H[(Room Database)]
G --> I[Node.js + dsh CLI]
end

subgraph "Engine Layer"
I --> J[dsh web server :3080]
J --> K[WebView / REST API]
end

subgraph "External"
K --> L[DeepSeek API]
G --> M[Plugin Marketplace]
end

GitHub 仓库配置

发布到 GitHub 时，建议使用以下 .gitignore 模板：
gitignore
构建输出
.apk
.aab
/build/
.gradle/

本地配置
local.properties
.log

Android Studio
.idea/
.iml
.cxx/

密钥文件（不要提交）
.jks
.keystore

生成的文件
app/build/
app/generated/

DSH 引擎资产（二进制文件）
app/src/main/assets/engine/

推荐选择：在 GitHub 创建仓库时选择 "Android" 模板，然后添加上述自定义规则。

贡献指南

欢迎提交 Issue 和 Pull Request！

开发流程bash
1. Fork 本仓库
2. 创建特性分支
git checkout -b feature/amazing-feature

3. 提交更改
git commit -m 'feat: add amazing feature'

4. 推送到分支
git push origin feature/amazing-feature

5. 创建 Pull Request

构建验证
bash
运行所有测试
./gradlew test

检查代码质量
./gradlew lintDebug

构建 Debug APK
./gradlew assembleDebug

协议

本项目采用 MIT License。

致谢

- DeepSeek Harness - 核心框架
- Jetpack Compose - 现代 UI 框架
- Dagger Hilt - 依赖注入框架
- Room - 本地数据库