ds-bot-mobile-web

DS Bot Mobile Web 为已有的 DeepSeek Harness（DSH）和 DS Bot 增加手机会话导航、响应式聊天界面和扫码登录入口。插件运行在电脑上，手机通过浏览器使用原有团队；消息渲染、输入和流式连接继续由宿主处理。

面向手机浏览器与手机主屏幕入口使用。 无需构建原生 App，也不依赖 Mobile Bridge 或 App 配套插件。电脑、DSH 和网络入口需要保持可用。

界面预览

会话列表 · 单聊 · 群聊

这些图片来自隔离 DSH / DS Bot 宿主中实际运行的 Web 组件，使用示例数据和 mock 模型，保留原始渲染。它们是 390px 响应式浏览器截图，不能代替 iPhone Safari 真机验收。所示布局的版本范围及后续主题变化见图片来源和设计说明。

电脑端：Web 扫码登录入口

用户提供的真实 Web 标签截图。为便于公开展示，二维码已替换为不含登录凭据的 https://phone.example/demo，地址改为示意域名，背景聊天已加重模糊；其余登录界面保留。共享弹窗不表示 Web 依赖 App 插件。

为手机使用而做

0.4.17 在团队接口拒绝请求时核验原有浏览器登录，区分登录过期与连接恢复故障，减少不必要的重新扫码。保留近期会话缓存、自动重连和 iOS 27 主屏幕适配。

当前发布：0.4.17。 当前适配组合为 DSH 0.2.1-rc.2 / DS Bot 0.1.7。宿主交互能力取决于该组合；不同浏览器的键盘、后台恢复与网络切换仍有差异。详见版本状态、0.4.17 说明和验证记录。

快速开始

1. 在电脑安装 Web 插件

前提是电脑上的 DSH 和 DS Bot 已正常运行，原团队可以使用。

从 Releases 下载插件 ds-bot-mobile-web-0.4.17.tgz。在现有 DSH 插件管理器中安装、启用，再刷新页面；宿主提示重启时按提示处理。

GitHub 自动生成的 “Source code” 压缩包用于开发，手机不需要下载或解压插件包。

2. 准备手机能访问的 HTTPS 入口

复用现有 HTTPS 入口，保持电脑唤醒。使用 Tailscale 等私网时，两端都要连接对应网络。电脑的 localhost / 127.0.0.1 不能直接给手机使用。

尚无入口时，先阅读网络与登录配置。插件负责移动界面和登录入口，不创建隧道，也不修改宿主信任配置。

3. 扫码，打开原有会话

在电脑 DS Bot 账户菜单选择 手机访问 → Web。确认入口就绪后，用手机扫码或私密传递登录链接，在目标浏览器完成登录。菜单不可见时，可从官方插件配置页打开同一弹窗。

打开一个已有 Bot 或群聊，即可继续使用原来的团队。之后收藏普通入口，或按使用指南添加到 iPhone / Android 桌面。

Web 登录二维码与 App 配对二维码用途不同，不能互换。登录二维码和完整登录链接携带访问权限，只给自己的设备。

安装细节、升级、回退与旧包名迁移见安装指南。连接超时、认证失败和历史加载问题见故障排查。

0.4.7 另优化长会话发生更新时的样式匹配，减少移动布局的重算开销。测量条件与范围见性能记录。

缓存与连接如何工作

• 返回会话： 当前页面最多保留最近 3 个会话的引用，保留窗口为 5 分钟；每次打开仍向宿主确认当前会话与权限。
• 再次启动： 浏览器可复用符合条件的静态资源缓存，加载层提供等待反馈；页面、登录与聊天 API 不进入该静态缓存。
• 页面回收： 刷新、长后台或系统回收网页后，需要恢复连接和历史。添加到桌面提供便捷入口，不等于离线聊天。
• 电脑离线： 电脑休眠、退出 DSH 或私网断开后，需要先恢复宿主与网络。

性能结果按具体环境记录，不把某台设备的一次体验写成所有网络的启动承诺。缓存范围、测量方法和已知限制见性能记录与常见问题。

三个项目，各司其职

Web 与 App 可以共享一个“手机访问”弹窗，同时保持独立安装和启停。原生客户端安装形式与验证状态以 App 仓库 为准；当前没有公开即装 IPA / APK。实现边界见架构说明。

文档地图

完整入口见文档首页。详细指南目前以简体中文维护，英文概览见 English README。

参与贡献

欢迎提交缺陷、兼容性记录、文档和翻译改进。请在 Issues 附上组件版本、设备 / 浏览器与复现步骤；截图移除登录链接、二维码和私人会话。

开发使用 Node.js 24、npm、Git 和 Python 3。源码包含固定版本的 DS Bot submodule；克隆、检查和交付命令集中在开发指南。运行态测试使用隔离 profile 和 mock 数据。提交前阅读贡献指南；文档修改应同步两种 README，并核对相对链接。

许可与致谢

Apache License 2.0。本项目基于 DeepSeek Harness 的插件能力，并复用固定版本 DS Bot 的聊天和精灵组件。二维码在本地通过 qrcode 生成，相关依赖声明随安装包分发。

完整来源、固定上游版本及版权说明见 NOTICE 和插件 NOTICE。感谢上游作者与提供真实设备反馈的使用者。本项目是独立社区项目，与 DeepSeek 官方无隶属关系。