dsh-mobile

项目详情摘要

DeepSeek Harness Mobile 使用 Kotlin Multiplatform 共享核心逻辑，为 Android 与 iOS 提供原生移动端体验。** 通过 Mobile Gateway 在手机上访问 DeepSeek Harness 的工作区、会话、实时对话、Agent 轨迹与文件。 项目简介 DeepSeek Harness Mobile（DshMobile）是面向 DeepSeek Harness 的社区原生移动客户端。项目已完成 Kotlin Multiplatform（KMP）架构改造，并同时提供可运行的 Android 与 iOS 应用： `shared` 负责跨端协议、状态机、Reducer、投影和同步逻辑，是共享业务状态的唯一来源。 `androidApp` 使用 Kotlin、Jetpack Compose 和 OkHttp 实现 Android 产品能力。 `DeepSeekHarnessMobile` 使用 SwiftUI/UIKit 构建 iOS 界面，并通过 Kotlin/Native framework 接入共享逻辑。 两端均通过 `dsh-plugin-mobile-gateway` 与 Harness 建立 WebSocket 连接。网络、安全存储、文件、图片、生命周期和后台任务由各平台原生实现，业务规则则尽可能收敛到 `shared/commonMain`。 当前平台状态 平台/模块 | 当前状态 | 主要实现 | --- | --- | --- | KMP `shared` | 已接入 Android 与 iOS | Gateway 协议、Store/Reducer、Conversation/Trajectory 投影、History 同步、Question/Approval、Session Control、工作区文件状态与代码预览支持 | Android | 已实现原生客户端 | Jetpack Compose、OkHttp WebSocket、DataStore（非敏感配置）、Keystore（凭据）、CameraX/ML Kit 扫码、前台服务、附件缓存、文件下载与预览 | iOS | 已实现原生客户端 | SwiftUI/UIKit、URLSession WebSocket、UserDefaults（非敏感配置）、Keychain（凭据）、二维码配对、后台执行、附件与工作区文件 | Android 与 iOS 使用各自的原生 UI 和平台能力，并不是共享 UI。功能和交互会持续对齐，但个别系统级行为可能因平台限制而不同。 功能亮点 **原生实时对话**：处理 WebSocket 增量事件，展示 Markdown、代码、思考过程、工具调用、工具结果与图片附件。 **历史与实时解耦**：分页加载历史记录时保留实时尾部，按序列与事件身份去重，避免消息重复或回退。 **完整 Agent 轨迹**：查看 User、Assistant、Tool 等事件，以及调用参数、结果、Schema、Token 和耗时信息。 **工作区与会话管理**：远程浏览、创建和切换 Harness 主机上的工作区，搜索、创建、切换及归档会话。 **工作区文件**：浏览 Harness 主机上的远端目录，分块下载文件，校验完整性，预览常见代码文件或交给系统应用打开。 **交互式 Agent 流程**：支持 Human Question 与工具审批请求，可提交、取消、拒绝或单次允许。 **会话和默认配置**：管理 Agent 预设、Provider/模型、思考等级与 `read-only`、`workspace-write`、`danger-full-access` Harness Agent 权限；这些不是手机本地文件系统权限。 **安全设备配对**：扫描 WebUI 二维码或手动输入配对信息；长期凭据保存到平台安全存储。 **移动端生命周期**：Android 在 Agent 回合执行期间通过前台服务维持连接；iOS 使用系统授予的有限后台执行时间管理活动任务，不保证无限期维持 WebSocket。 **浅色与深色主题**：两端均提供原生主题适配，并保留 Harness 的深海、网格与鲸鱼视觉语言。 界面预览