希望直接在手机使用？ 先选 DS Bot Mobile Web，通过浏览器连接，无需构建原生客户端。本仓库提供 iOS / Android 客户端源码及电脑端 App 配套插件，目前没有可直接安装的 IPA/APK。

已有团队的原生入口

连接电脑上已经运行的 DeepSeek Harness（DSH）和 DS Bot，保留原有 Bot、群聊和会话。手机提供原生导航、消息阅读与草稿体验；电脑端 App 插件负责配对批准、设备管理、认证与传输。

会话列表	单聊	群聊

_{真实 iPhone 中的示例界面，使用合成会话。图片展示原生布局；当前功能与设备支持以状态页为准。}

电脑端：手机访问 → App

从同一入口生成配对二维码、批准设备请求、查看和撤销授权。图中未展示配对二维码或访问凭据，图片来源见截图说明。

为手机使用而设计

会话跟着团队走 读取已有 Bot 和群聊的文字历史，保留群成员归属。无需在手机重新创建一份团队。	适合阅读的消息 中文 Markdown、代码和表格；iOS 原生局部选字与拖动手柄，气泡下方一键复制原始 Markdown。
继续写下一条草稿 发送后立即显示待确认气泡，输入框留给新草稿。未知或失败的发送保留原内容，供检查与手动重试。	每台设备单独授权 电脑所有者批准配对，按设备撤销访问。授权保存在 App 插件的专用目录，停用插件不会丢失。

还有中英文界面、明暗主题、角色头像、近期会话缓存和回到最新消息的快捷按钮。离线时可阅读已有缓存和编辑草稿；收发仍需要电脑、App 插件与网络可用，恢复网络不会自动发送草稿。

当前能力

范围	当前行为
文字会话	Bot / 群文字历史、完整回复、发送确认与状态查询
宿主扩展能力	模型、用量、记忆、日程、队列等按宿主实际声明开放
尚未提供	逐 token 增量、原生工具审批、媒体/语音传输、系统推送通知、群管理
平台状态	iOS / Android 源码预览；已有部分 iPhone 验证，Android 真机验收尚未完成

界面中存在某个控件，不代表当前 App 插件支持相应功能。完整范围见状态说明和能力与验证矩阵。

两个电脑插件 + 原生 App

项目	安装位置	职责	适合谁
Mobile Web	电脑 DSH；手机浏览器访问	移动 Web 界面、浏览器登录与历史浏览	希望直接在手机使用的用户
Mobile App · 本仓库	原生客户端在手机；配套插件在电脑 DSH	原生交互、草稿与缓存；电脑上的配对批准、设备管理、认证与传输	能够自行构建原生客户端的开发者

电脑端只有两个插件：Web 与 App，均复用已有 DSH / 官方 DS Bot 团队（无需补丁）。只用 Web 无需安装 App 插件；原生 App 无需安装 Web。 原独立的 Mobile Bridge 自 App 插件 0.3.0 起并入 App 插件。详见插件职责与生命周期。

版本与交付

交付项	当前版本	获取方式
App 源码预览	0.1.7-preview.2	本仓库与发布页
原生客户端	0.1.7	使用自己的平台工具链构建；无公开 IPA/APK
电脑端 App 插件	0.3.0	ds-bot-mobile-app-0.3.0.tgz，安装到 DSH；包含原 Mobile Bridge

Mobile Bridge 已并入 App 插件 0.3.0，不再单独发布；从旧版迁移见 companion/README.md。

快速开始

1. 准备电脑端

准备已有 DSH（0.2.1-rc.5+）与官方 DS Bot（0.2.6+）团队，安装并启用 App 插件，配置手机可达、证书可信的 HTTPS 入口。完整步骤见安装与配对。

App 插件 0.3.0 直接使用官方 npm DS Bot 0.2.6+ 的公开接口，不需要补丁或兼容包；早期发布页中的 ds-bot-0.1.7-codex.1.tgz 已不再需要。从 Bridge 0.0.x 迁移见安装指南。

2. 构建原生客户端

需要 Node.js 24 + npm。iOS 需要 macOS、Xcode 和模拟器或自己的设备签名；Android 需要 Android SDK、对应构建工具和模拟器或设备。

git clone https://github.com/MuQY1818/ds-bot-mobile-app.git
cd ds-bot-mobile-app
npm run setup
npm --prefix apps/mobile run ios

Android 改用 npm --prefix apps/mobile run android。项目使用 Expo SDK 54、React Native 0.81.5 和自定义原生模块，须使用完整开发构建；Expo Go 不提供完整运行环境。平台构建与签名见原生客户端指南。

3. 扫码，核对，批准

1. 在电脑账户菜单打开 手机访问 → App，生成配对二维码。
2. 使用原生客户端扫描，核对主机身份；无法扫码时使用面板提供的手动配对资料。
3. 在电脑批准匹配的设备请求，再从手机打开已有会话。

Web 登录码不能用于 App 配对。未使用的配对码两分钟后失效，扫码本身不会授予访问权限。遇到连接问题请看故障排查。

文档地图

从文档首页按目标选择指南，也可以直接进入：

目标	文档
安装并开始使用	安装与配对 · 日常使用 · 常见问题
处理连接或升级问题	故障排查 · Bridge 配置
理解组件与接口	插件职责 · 所有者接口 · Mobile SDK
构建与参与开发	原生客户端 · 开发检查 · 交互设计
了解版本与完成范围	更新记录 · 当前状态 · 验证记录

参与贡献

欢迎提交复现清晰的问题、文档改进和功能 PR。先阅读开发指南，使用独立 fixture 验证，保留公共 DSH API 边界。安装依赖后，基础检查为：

npm --prefix bridge run test:prepare
npm run check
npm run audit

Bridge、配套插件改动还需要各自的集成与打包交付检查。报告问题时说明平台、组件版本、复现步骤与预期行为；设备签名、配对资料、私聊和运行态数据不应进入提交或公开截图。

提交问题 · 查看贡献记录

许可与来源

采用 Apache License 2.0。App / SDK 基于 QingJ01/DS-Bot-App，DS Bot 原始角色与精灵算法来自 Fei2411/DeepSeek-Bot。版权、依赖与修改来源保留于 NOTICE 和来源说明。

这是独立社区项目，与 DeepSeek 官方无隶属关系。