DSH｜DeepSeek Harness Mobile｜用 Kuikly 跨端框架做的 Android 原生 DSH 客户端

[yukiykchen]

项目地址

• App（Kuikly / Kotlin Multiplatform）：yukiykchen/deepseek-harness-mobile
• 电脑端扫码插件 + Relay：yukiykchen/dsh-scan-remote

项目介绍

DeepSeek Harness Mobile 是一个 Android 原生 DSH 客户端。聊天界面和 Host 协议层写在 Kotlin Multiplatform 的 shared 模块里，UI 使用腾讯 TDS 的 Kuikly 跨端框架，而不是把 dsh web 塞进 WebView。

Kuikly 用声明式 Kotlin DSL 出原生布局。本项目里，会话列表、流式 Markdown、Think / 工具卡片、审批和提问弹窗、输入栏都走同一套共享代码；Android 侧再用 Kotlin 管生命周期、扫码 Keystore 和本机 Node。先把 Android 体验做完整，同一套 UI 之后可以接到 iOS / 鸿蒙，而不用再维护一份 Web 壳。

三种连接方式：

模式	Agent 跑在哪	手机怎么连上 Host
手机本地	手机内嵌 Harness	本机 127.0.0.1:3080，HTTP RPC + SSE
扫码连接	电脑上正在跑的 DSH	扫 Settings 二维码，经 Relay 密封隧道
SSH	电脑上正在跑的 DSH	SSH 本地端口转发 + WebSocket

扫码模式：电脑安装配套插件后，在 Settings > Remote Access 出示二维码。API Key 配在电脑 Host 上，不写进手机。手机和电脑需要同一 Wi-Fi 或同一热点。

当前对话里已经接上的能力：

• 远程时间线：流式助手消息、Think、可点开的工具卡片（Bash / Read / Search / Web / Ask）
• 提问卡、审批卡、队列和 Goal
• 断线重连后回补会话历史，不把传输中断当成用户错误
• 三种连接模式的会话缓存互相隔离

项目截图

与 DSH 的集成方式

• 不修改 DeepSeek Harness 源码，也不替换电脑上的 dsh web 页面。
• App 按公开 Host 协议通信：本地模式连内嵌 Host；扫码 / SSH 走 HTTP RPC + events.mux WebSocket，对齐电脑上的同一份会话、工具和流式事件。
• 扫码仓库是独立的 MIT 插件：电脑 DSH 继续只监听 loopback，手机只出站连接 Relay。安装：

npx @deepseek-ai/dsh plugin --profile web add "github:yukiykchen/dsh-scan-remote#v0.0.1"

完整步骤见 插件中文说明。

为什么用 Kuikly，而不是套 Web

• 长会话、流式 token、工具卡片展开，在原生 List 上比 WebView 套壳更稳，键盘和安全区也好做。
• 时间线折叠、工具模型和 RPC 客户端都在 KMP shared，Android 和以后的其它端共用，避免再写一套 TypeScript UI。
• 框架文档：Kuikly 官网 · KuiklyUI

欢迎试用、提 Issue

---