安卓原生客户端 SparkWeiyang/DeepseekHarness-AndroidClient

DeepSeek Harness 安卓客户端

DeepSeek Harness（DSH） 的原生安卓客户端，包名 com.spark.harness。通过 DSH Web 的 RPC 协议（POST /api/<method> + WebSocket /api/events.mux 下行流）与 PC 端 harness 通信，完全原生渲染（无 WebView 套壳），支持手机与大屏（平板/折叠屏）设备。

配套插件：dsh-lan —— 让 PC 端 harness 局域网开放（绑定 0.0.0.0）并提供 deepseek/balance 余额查询端点。

功能

三页结构（连接服务器后）

- 会话：与网页端一致的工作区分组（workspace.list）+ 会话列表（session.list）；工作区切换 chips、会话全文搜索（session.search）、新增工作区（workspace.create）、在当前工作区新建会话（session.create）。
- 详情：DeepSeek 官方消耗卡（经 PC 端 deepseek/balance 端点代查余额/赠金/充值，密钥在 PC 端、永不下发手机）+ 全站累计（输入/输出 tokens、缓存命中率）+ 每个运行中项目的统计卡（缓存命中率、首 token、生成速度、上下文压力条）+ 图表 + 进行中任务（goal 目标 + todos 清单）。
- 设置：与网页端同源的核心设置——主题（ui-theme）、安全程度（permission.defaultPreset）；「工作环境」：当前服务器 + 切换（局域网网页端 / 本机 Harness）。

聊天页（对标网页端）

- 流式输出（assistant/chunk 增量 + assistant/message 定稿）、Markdown/代码块渲染
- 思考（reasoning）折叠行：默认折叠显示一行摘要（流式时跟随最新行），点击展开
- 上下文注入折叠披露行（AGENTS.md、技能内容等非用户消息）
- 工具调用卡片：执行中 spinner → ✓ 完成 / ✗ 错误，参数/结果可展开
- 输入区统计条（粘底）：输入/输出 tok · 缓存命中% · 首 token 平均 · tok/s + 上下文压力条（实时来自 projections）
- 运行状态行：「⚙ 正在执行: <工具名>」实时显示；排队消息数（QueueDock）
- composer 座位：➕ 命令启动器（内置 /goal /compact /feedback + skill.list 技能）、模型 chip（session.models/session.selectModel）、安全程度 chip、发送/停止
- 每条回复显示 usage（输入/缓存读/缓存写/输出 tokens）；用户/助手消息长按复制

连接方式

- 手动录入（名称/主机/端口/HTTPS）
- 局域网扫描：并发探测当前 /24 网段 3080 端口，一键发现 PC harness
- 本地 Harness（Linux VM 隔离实例）：虚拟机里跑一套完整、隔离的原版 Harness（独立 ~/.dsh、端口 3090），手机经 adb reverse 直连（详见 vm/README.md）
- 明文 HTTP 与自签名 HTTPS（信任用户证书）均可

技术栈

| 项 | 选择 |
| 语言 | Kotlin 2.2.10 / Jetpack Compose（BOM 2025.06.01）+ Material 3 |
| 构建 | Gradle 8.13 / AGP 8.13.2，minSdk 26 / targetSdk 35 / compileSdk 36 |
| 网络 | OkHttp 4.12（HTTP RPC + WebSocket）+ org.json |
| 持久化 | SharedPreferences + org.json（零额外依赖） |
| 协议文档 | docs/wire-protocol.md（DSH RPC 信封/方法表/下行帧契约，744 行逆向笔记） |

目录结构

app/src/main/java/com/spark/harness/
├── MainActivity.kt # 入口 ├── data/ # ServerConfig / ServerRepository / ChatModels ├── net/ │ ├── HarnessApiClient.kt # RPC 信封 + WebSocket mux 传输层 │ ├── DeepSeekApi.kt # deepseek/balance 端点（PC 端凭证代查余额） │ └── LanScanner.kt # 局域网扫描（无 WifiManager，零额外权限） └── ui/ ├── App.kt # 服务器列表 ↔ 主壳导航 ├── MainShell.kt # 会话 / 详情 / 设置 三 Tab ├── SessionsTab.kt # 工作区 + 会话 + 搜索 ├── DetailsTab.kt # 消耗卡 + 统计卡 + 图表 + 进行中任务 ├── SettingsTab.kt # 主题 / 安全程度 / 工作环境 ├── ChatScreen.kt # 流式聊天（对标网页端 composer） ├── ChatController.kt # 事件折叠状态机 + 会话操作 ├── Markdown.kt # 极简 Markdown 渲染 └── Stats.kt # projections → 统计卡数据

构建

需要 JDK 17+（推荐 Android Studio 自带 JBR 21）与 Android SDK $env:JAVA_HOME = 'C:\Program Files\Android\Android Studio\jbr' $env:ANDROID_HOME = 'C:\Users\spark\AppData\Local\Android\Sdk' .\gradlew.bat assembleDebug # 产物 app/build/outputs/apk/debug/app-debug.apk

也可以直接用 Android Studio 打开本目录构建。

安装

adb install app\build\outputs\apk\debug\app-debug.apk

使用

前置：PC 端 harness

方式 A：安装了 dsh-lan 插件（推荐，局域网开放 + 余额端点）
dsh web

方式 B：未装插件，手动绑定局域网
dsh web --host 0.0.0.0 --port 3080

手机端连接

1. 局域网：App 内点 🔍 扫描（自动发现 192.168.x.x:3080），或手动添加主机/端口。
2. 本地（Linux VM 隔离实例）：
- VM 内：curl -fsSL …/vm/harness-vm-setup.sh | bash（部署独立 Harness，端口 3090）
- VM 端口转发：3090 → 主机 127.0.0.1:3090（WSL2 零配置；VirtualBox/VMware 见 vm/README.md）
- 主机：运行 scripts/dsh-adb-tunnel.ps1 保持 adb reverse tcp:3090
- App 内点顶部「🐧 本地 Harness（Linux VM）」连接
3. 连接后：会话 Tab 选工作区/搜索/新建会话 → 进入聊天页发消息。

安全说明

DSH 的 Web carrier 没有鉴权层（信任栅栏只是可达性策略）。请只在可信网络暴露 harness；客户端本地只保存服务器地址，不保存任何密钥。详见 SECURITY.md。

文档

- CHANGELOG.md — 版本历史
- SECURITY.md — 安全说明
- CONTRIBUTING.md — 贡献指南
- docs/wire-protocol.md — DSH RPC 协议逆向笔记

License

MIT