前言¶
在本地运行 DeepSeek Harness (DSH) 进行智能体开发或调试时,开发者通常需要直接操作桌面环境。Pocket Bridge 提供了一种替代方案:它允许通过手机浏览器直接访问运行在 Windows 电脑上的 DSH,处理本地项目、查看流式回复以及管理对话。它不需要在手机上安装额外的 App,且连接通过加密通道传输。
是什么¶
Pocket Bridge 是一个轻量级、非官方的 Windows 客户端插件。它通过一个浏览器接口,将手机与本地运行的 DSH 连接起来,充当网关的角色。该项目由 jyb114 维护,采用 MIT 许可证。
核心功能¶
该插件主要解决本地 DSH 的远程接入问题,具体能力如下:
- 项目与对话管理:在浏览器中浏览电脑上的项目,添加现有目录,创建或继续对话。
- 消息交互与流式输出:发送消息,查看流式回复,以及暴露推理过程、工具活动记录和排队消息。
- 状态确认:在刷新页面或更换入口后,检查电脑端的提交回执,确认指令是否送达。
- 模型与工具控制:选择连接的运行时报告的模型和工具预设;在运行时支持的情况下,处理批准、选择和问题。
- 文件管理:上传附件,浏览、预览或下载允许的工作区文件;支持查看目标、计划控制、余额信息以及显式请求的桌面截图。
- 连接方式:使用加密的本地连接,或使用可选的临时 Cloudflare 隧道。
- 零 App 依赖:整个过程无需安装手机端应用,仅依赖浏览器。
安装与启用¶
要使用 Pocket Bridge,需要先在 Windows 电脑上安装并运行 DSH,然后建立连接。
- 安装 DSH:在电脑上安装并登录 DeepSeek Harness (DSH)。确保本地可以正常打开项目并收到回复。
- 下载安装程序:下载 DSH-only Windows setup (Preview.18) 或更新的版本。旧版本的安装程序仍可在 GitHub Releases 中找到。
- 安装 Pocket Bridge:运行下载的安装程序进行安装。升级操作会保留安装目录、连接密钥、设备记录、上传内容和本地日志。
- 启动与验证:打开电脑上的桌面控制台,确认检测到的 DSH 运行时处于活动状态。
- 获取链接:复制完整的 HTTPS 手机连接链接。注意保持访问密钥和
#k=片段的私密性。 - 手机连接:在手机的浏览器中打开该链接。选择项目、对话,或添加电脑文件夹并创建新对话。在此过程中,电脑必须保持唤醒和连接状态。
可选 DSH 插件¶
除了独立的 Windows 安装程序,Pocket Bridge 提供了一个可选的 DSH 插件。该插件会将 Pocket Bridge 集成到 DSH 的设置面板中,提供显式的网关启动/暂停、私有 QR 配对以及连接诊断功能。安装该插件需要 Node.js 24+ 运行时,且网络隧道功能需要单独安装 cloudflared。
适用场景与注意事项¶
- 非官方性质:Pocket Bridge 是独立项目,与 DeepSeek、OpenAI 或 Cloudflare 无官方隶属或背书。DSH 的模型访问和提供商费用是分开的。
- 兼容性:对于 DeepSeek-V4.1-Flash-1017 模型,建议使用 Harness 0.2.1-rc.1 或更新版本。插件版本声明不代表与所有旧版或新版 DSH 完全兼容,需查阅兼容性矩阵。
- 网络安全:手机内容要求浏览器在安全上下文中支持 WebCrypto。普通 LAN HTTP 不被支持,必须使用 HTTPS 隧道或手机信任的本地 HTTPS 入口。
- 连接状态:Cloudflare 隧道不可用或断开并不代表消息未被接受。如果不确定消息是否送达,不应重复发送。
- 操作限制:不支持的操作必须明确提示为不可用或进行解释,不能显示为可点击但无效的按钮。
短结尾¶
Pocket Bridge 通过加密连接和浏览器界面,降低了使用本地 DSH 的门槛,特别适合需要随时随地进行调试和查看日志的场景。更多细节和源码可访问其 GitHub 仓库。