Whaleness：Harness 原生移动客户端

项目简介

Whaleness（仓库名 dsh-mobile）是独立开发的第三方原生移动客户端，用于连接 DeepSeek Harness。Android 与 iOS 两端通过 Kotlin Multiplatform（KMP）共享核心业务逻辑：shared 负责协议处理、状态机、reducer、投影与同步；androidApp 使用 Kotlin、Jetpack Compose 与 OkHttp；DeepSeekHarnessMobile 使用 SwiftUI/UIKit，通过 Kotlin/Native framework 访问共享逻辑。

客户端经 dsh-plugin-mobile-gateway 以 WebSocket 连接 Harness；开启网关的实验性 WebRTC 选项后，已配对客户端会优先使用两条原生 RTC 数据通道，协商失败时回退到 WebSocket，设置中会显示当前连接方式。

主要功能

• 实时会话：流式呈现 Markdown、代码、推理过程、工具调用与结果、图片附件。
• 语音与文本输入：按住说话、松手转写为可编辑草稿，上滑取消；转写使用宿主端的语音输入能力。
• 历史与队列：分页历史与实时消息合并去重，查看和编辑排队消息，使用宿主提供的斜杠命令。
• Agent 轨迹：查看 User、Assistant、Tool 事件，包含参数、结果、schema、token 用量与耗时。
• 交互式工作流：回答 Human Questions、处理工具审批（提交、取消、拒绝、一次性批准）。
• 多宿主与工作区：保存并切换多个 Gateway 宿主，浏览、创建、切换工作区，搜索、创建、切换、归档会话。
• 文件卡片与预览：从会话打开文件卡片、浏览远程目录、分块校验下载，预览 PDF、图片与代码。
• 插件与定时任务：浏览官方与已安装插件及运行状态，按宿主支持情况安装、启停与配置；查看、筛选、编辑、删除会话中创建的定时任务。
• 会话与默认设置：管理 Agent 预设、provider/model、推理强度，以及 read-only、workspace-write、danger-full-access 权限。
• 原生设备体验：适配 iPad、Android 平板与折叠屏，支持浅色/深色外观与文字大小调节；iOS 支持实时活动与通知；扫码或手动配对，凭据保存在平台安全存储中。

安装与使用

• iOS：通过 TestFlight 加入测试，支持 iOS / iPadOS 16.1 及以上的 iPhone 与 iPad。
• Android：从 GitHub Releases 下载 APK，需要 Android 7.0（API 24）及以上。
• 桌面宿主：需要安装并启用 dsh-plugin-mobile-gateway 0.11.2 或更高版本（最新版本说明要求 v0.11.3 或更高），安装或升级后需完整退出并重新启动 dsh web。

dsh plugin --profile web add dsh-plugin-mobile-gateway@latest

• 语音输入：在桌面宿主插件页启用官方 Voice Input 插件，完成模型下载与初始化，并在手机上授予麦克风权限。

注意事项

• 这是第三方客户端，与 DeepSeek Harness 官方无隶属关系；项目采用 MIT 许可证。
• Android 与 iOS 各自实现原生 UI 与平台集成，功能和交互正在对齐，部分系统级行为存在差异。
• 两端在进入后台时不会主动断开健康连接；回到前台后会尝试恢复，手动断开不会触发自动重连。iOS 仅使用系统授予的有限后台执行时间，不保证 WebSocket 长期保持连接。
• 会话与默认设置中的权限项控制的是宿主端的 Agent，而非手机本地文件系统。

本作品整理自 GitHub 开源项目 Clarklevis1995/dsh-mobile，原作者 @Clarklevis1995，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。