口袋桥 jyb114/pocket-bridge

Pocket Bridge

一个轻量、非官方的手机界面，用来连接运行在你自己 Windows 电脑上的 DeepSeek Harness（DSH）。在手机上打开浏览器，就能操作本地项目和会话、发送指令、响应受支持的审批、传输工作区文件。电脑负责运行 DSH，Pocket Bridge 负责连接，并提供一个小巧的浏览器界面。

新版本只专注 DSH。 Codex 和 Dot 已从新网关和 Windows 安装程序中退役。此前合并发布的版本及其安装程序仍可在 GitHub Releases 获取，但不再更新集成。升级会保留安装目录、连接密钥、设备记录、上传文件和已有的本地日志。升级不会关闭 Codex，不会删除它的会话，也不会移除你的目标应用。

Pocket Bridge 独立且非官方，与 DeepSeek、OpenAI、Cloudflare 均无隶属关系，也未获其背书。DSH、模型访问以及任何服务商费用都需另行处理。见第三方声明。

社区里还有其他手机客户端和插件，包括 DSH Mobile Remote、dsh-mobile 和 dsh-Remote。Pocket Bridge 侧重小巧的浏览器界面、Windows 安装程序、显式加载图片、受保护的内容传输，以及精确的版本兼容性报告。它的可选插件会复用已识别的网关，并给出可操作的本地诊断信息。选择之前，请先查阅各项目自己的平台、协议和安全要求。

它能做什么

- 浏览电脑上的项目，添加已有目录，创建会话。
- 发送消息，查看流式回复、暴露的推理过程、工具活动和排队中的消息。
- 选择所连接运行时上报的模型和工具预设。受支持的权限预设要通过回读确认，不要假定命令已成功。
- 当运行时暴露相应能力时，处理审批、选项和提问。
- 上传附件，浏览、预览或下载允许访问的工作区文件。图片只在你请求时才加载。受支持的图片引用会走运行时的会话授权附件读取器。新上传的普通图片在本页还有一个有上限的临时预览；连接或会话切换时即清除。两种来源都没有的附件会明确显示为不可用。
- 查看受支持的目标、计划控制项、余额信息，以及显式请求的桌面截图。
- 使用加密的本地连接，或可选的临时 Cloudflare 隧道。无需安装手机应用。
能力取决于已安装的 DSH 运行时、它的插件，以及已连接的账号。这是专门打造的移动端界面，并非桌面端每个插件的完整复刻。不支持的操作必须说明清楚或标记为不可用，不能做成能点的按钮假装能用。请阅读兼容性矩阵和人工验收记录。

Windows 安装

1. 在电脑上安装 DSH 并登录。确认它能打开项目并在本地回复。
2. 从 Releases 下载仅含 DSH 的 Windows 安装包。较早的合并安装包属于历史版本。
3. 安装 Pocket Bridge。升级会沿用已保存的安装位置；全新安装时如需可改选 D: 盘位置。
4. 打开桌面控制台，确认检测到的 DSH 运行时正在运行。控制台始终只在本机运行。
5. 复制完整的 HTTPS 手机连接链接。访问密钥和 #k= 片段务必保密。
6. 在手机上打开该链接。选择项目和会话，或添加电脑文件夹并新建一个。主机必须保持唤醒并联网。

Windows 安装包内置 Node.js 和 cloudflared 及其许可证文本，但不内置 DSH。临时隧道地址在重启后可能变化；遇到这种情况请使用新复制的链接。隧道不可用或已断开，并不代表消息已被接收。投递结果不确定时，不要反复发送同一条指令。

手机端内容需要浏览器 WebCrypto，且必须处于安全上下文。请使用 HTTPS 隧道，或使用手机信任其证书的本地 HTTPS 入口。普通局域网 HTTP 不提供这种上下文，也不属于受支持的明文降级方案。本地控制台会给出 HTTPS 设置指引；证书信任需另行配置。

可选 DSH 插件

插件会在 DSH 设置中加入 Pocket Bridge，支持显式启动和暂停网关、私密二维码配对，以及连接诊断。它复用现有的轻量手机界面。本地监听是否运行、加密连接是否可用、手机投递是否成功，这三项分别上报。

请通过对应的 DSH 插件管理器安装 release 中经过测试的 .tgz。插件要求真正的 Node.js 24+ 运行时；联网隧道需另行安装 cloudflared。Windows 安装包已包含两者。插件把网关数据保存在可替换包之外，暂停手机访问时不会关闭 DSH。详见插件指南与确切验收范围。

插件在 npm DSH Web 0.2.0-rc.2 上的实际运行情况。连接信息已隐藏；这与真机验收是两回事。

源码安装

源码用户需要 Node.js 24 或更高版本。要用互联网隧道，请单独安装 cloudflared，或使用本地配置所要求的官方发行版。然后运行：

node scripts/gateway-daemon.js

桌面启动器和本地控制台会报告实际的监听地址；网关会避免占用其他应用已占用的端口。运行时配置和生成的密钥都是本地文件，不包含在本仓库中。不要把别人的配置、访问链接、日志或通知凭据复制到公开检出中。

DSH 的官方 npm 入口是 npx @deepseek-ai/dsh web。历史 npm 测试只覆盖特定版本和流程，并不承诺每个旧版本或未来版本都完全兼容。DSH 仍是快速变化的开发者预览版。具体测试范围见兼容性矩阵和官方项目。

隐私与传输

受支持的手机内容通道使用经过认证的加密请求和响应，包括消息和受保护的工作区传输。被动隧道中继会收到这些通道的密文。它仍能看到流量元数据，并负责提供初始 Web 应用；如果中继主动替换该应用，就不在这层保护范围内。模型服务商必然会收到 DSH 提交给它的指令。

新版本不再把原始 DSH Web 界面作为远程替代方案对外暴露。需要时请在电脑上本地打开原始界面。加密失败、密钥缺失、授权过期以及不支持的能力都必须如实上报，不得回退到明文远程内容。

可选的私有 Tailscale HTTPS 入口可以避免通过 Cloudflare 提供初始应用。它默认关闭，保留桥接的设备与加密检查，也不会安装或配置 VPN。所有者完成设置后，必须验证真实的手机注册与连通性。手机的「设置 → 连接与兼容性」面板会分别显示观测到的运行时和已实现的接口覆盖范围，与发布验收分开。

本地 DSH 历史、上传、配置和浏览器草稿各有独立的存储边界。不要假设电脑或手机上的每个文件都做了静态加密。可选的通知服务是独立的外部接收方。不包含任何个人通知脚本或账号。确切范围见 SECURITY.md。

移动端设计

Pocket Bridge 使用自己的 bridge 标记和一套共享的简单控件。紧凑的顶栏让手机对话占满整个屏幕宽度。次要操作放在带标签的菜单里；模型、工具、权限和目标控件始终可见，不需要隐藏的横向工具栏。主要触摸操作至少有 44 像素的点击区域。界面使用系统字体和本地资源，提供浅色和深色调色板，以及中文、英文和西班牙文文案。

历史记录分页加载，未变化的消息行会复用，流式更新会合并，图片按需显式请求。这些做法减少了工作量，但不会删减内容、认证或加密。网络速度、隧道稳定性、运行时发现和历史记录数量仍会影响响应时间。

公开页面资源有带上限的压缩缓存，每次请求都会校验当前源字节和文件标识。这减少了服务端的重复工作，同时不改变压缩设置，也不缓存私密对话/文件响应；首次未命中时的压缩行为保持不变。并发现代会话的队列、目标和模型读取只共享一个进行中的请求，合并窗口为一秒，变更或连接切换后会重新读取。重复的目录更新会保留未变化的导航按钮，而不是重新创建它们。这些优化保留了现有的功能和安全边界，而不是省略内容。

UI 演示，内容为合成数据。此图不代表真实账号、加密连接或真机验收结果。

开发与验证

npm run ci
npm run audit
npm run scan:strict

隔离测试套件覆盖 DSH/共享网关、加密、授权、文件范围、UI 行为、生命周期、载荷闭合和升级保留。它不能替代运行真实运行时或真机测试。实机检查单独记录，包含运行时版本、传输方式、观察到的结果和未测试的边界。

公开产品文档为英文。面向用户的移动端翻译仍然可用。通过 GitHub Issues 报告可复现的 bug；公开报告中不要包含凭据、完整连接 URL 和私密对话记录。敏感报告请参阅 SECURITY.md。

Pocket Bridge 自身的代码和原创美术资源采用 MIT 许可证。