不改一行宿主源码:dsh-mobile 把手机接进 DSH 的那条通道
DSH Mobile 在开源生态里的位置与通道取舍 在 DeepSeek Harness 的插件生态里,dsh-mobile 是少数不碰宿主源码、却把「手机也能用」做成完整闭环的项目。它的定位可以用一句话概括:在 DSH 之外加一层移动访问层,而不是改 DSH 本身。
在 DeepSeek Harness 的插件生态里,dsh-mobile 是少数不碰宿主源码、却把「手机也能用」做成完整闭环的项目。它的定位可以用一句话概括:在 DSH 之外加一层移动访问层,而不是改 DSH 本身。想先看它在清单里和其他插件并排的位置,可以从 DeepSeek Harness Hub 的插件清单 进去对照,本文只谈它的生态站位和通道取舍。
一个不改宿主源码的移动访问层
dsh-mobile 的第一条设计边界,是不修改 DeepSeek Harness 源码,安装和卸载完全走插件机制。这意味着它不会在你的 DSH 仓库里留下补丁,升级 DSH 时也不用担心被本地改动卡住。它对外暴露的是独立 HTTPS 入口与独立设备配对,和 DSH 自带的管理面分离:手机走的那条 3443 入口仍然是移动端界面,不会变身为桌面管理口;管理 API 依然要求 TCP 对端是本机回环。
原生部分同样收着做。Android App 里那个 Bridge 使用 androidx.webkit 的 WebMessage,每条消息都校验精确顶层 Origin 和主 Frame,并限制消息大小;它不使用 addJavascriptInterface。这是生态里值得注意的一个取法:能少给网页一层原生能力,就少给一层。
通道矩阵与各自的取舍
远程访问一共给了六条路:Tailscale Funnel、cpolar、cloudflared 快速隧道、cloudflared 命名隧道、自建 FRP、自有反向代理。它们不是「越多越好」的并列选项,而是按网络环境和维护意愿分工的。
| 通道 | 适合谁 | 主要代价 |
|---|---|---|
| 局域网 | 电脑附近的日常使用 | 只覆盖同一网络 |
| Tailscale Funnel | 想一次登录就用 | 大陆网络下可能不稳定,macOS 无组件 |
| cpolar | 国内网络、想省事 | 免费线路 1 Mbps,临时地址会变 |
| cloudflared 快速隧道 | 临时验证、不想注册 | 地址随机,官方定位测试用途 |
| cloudflared 命名隧道 | 要有固定域名 | 需账号与域名,0.5.4 暂无 macOS 组件 |
| 自建 FRP / 自有反代 | 已有 VPS 或反代的用户 | 需要自己维护服务器与证书 |
下面四条坑,正好对应这套矩阵里最容易踩错的地方。
坑一 · cpolar 免费线路 1 Mbps 的带宽现实
现象。 连接是通的,但操作明显卡顿,长会话滚动时尤其难受。
原因。 cpolar 免费方案当前限制在 1 Mbps,插件无法提高服务商的限额;它能做的是静态资源 gzip、WebSocket 长连接和顶部按需加载,但压不出服务商不给的带宽。
解决。 把免费远程访问当「应急看进度」而不是长时间交互;要稳定就在自建 FRP 或命名隧道里选一条,把带宽变量拿到自己手里。
坑二 · Tailscale Funnel 在中国大陆网络下可能不稳定
现象。 同一套配置,有时连得上、有时时好时坏,难以复现。
原因。 README 明确提示大陆网络下可能不稳定;其运行组件还把公开监听的生命周期绑定到父进程和受限控制通道,父进程退出或控制通道关闭就会结束当前代次并清理资源。
解决。 国内网络优先考虑 cpolar,或直接上自建通道;把 Funnel 当成「能用就用、不承诺稳定」的备选。
坑三 · cloudflared 快速隧道地址随机、无可用性保证
现象。 重连之后公网地址变了,之前保存的配对也随之失效。
原因。 快速隧道不需要账号,但地址是随机分配的,官方把它定位为测试用途、有限流且无可用性保证,请勿用于必须长期可达的生产访问。
解决。 需要固定入口就换成命名隧道,配合自己的 Cloudflare 账号与域名拿到重启后不变的地址;只是临时验证,就接受每次重新扫二维码。
坑四 · 中国大陆 VPS 上未备案域名可能被云厂商拦截
现象。 DNS 解析正常,但外部访问被拦住,通道看起来「就是不通」。
原因。 云厂商会对未备案域名做拦截,这与插件配置无关,改成任何隧道参数都不会生效。
解决。 改用公网 IPv4 模式,或者先完成 ICP 备案。这条在自建 FRP 场景里最常撞上,排查时要先分清是通道问题还是备案问题。
第三方插件适配与放行规则
生态位置决定了它必须和别的插件共处。移动层保持 DSH 原有的工作区、任务管理、终端和文件面板入口,不把第三方插件内容隔离成另一套页面;第三方插件仍由 DSH 自己加载。但 WebSocket 是个例外:网关默认只放行 DSH 第一方路径(含 /sidebar/ws/terminal),社区侧边栏插件的其他路径默认拦截,需要在 连接诊断 → 第三方 WebSocket 路径 里按确认过的精确路径逐条放行。系统不接受查询字符串或模糊前缀,放行也只代表该路径能过网关,不会开放任意端口、也不会绕过配对。
社区微信小程序客户端为何仍受限于微信
社区有人用原生小程序复刻了客户端,复用「移动访问」的配对与 Remote 流协议(需 dsh-mobile ≥ 0.3.8)。但它目前仍需通过微信开发者工具或真机调试使用——原因是微信正式版强制「合法域名」,而合法域名要求一个已 ICP 备案的自有 HTTPS 域名。这不是插件的技术缺陷,而是平台规则带来的准入门槛;理解这一点,就不会把「小程序版跑不起来」误判成插件的问题。
总结
看懂 dsh-mobile 的生态位置,关键就三件事:不改宿主源码、把配对与 HTTPS 独立出来、把通道的选择权交回用户;想横向比较生态里其他插件,可在这里查看 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:已经有 VPS 或反向代理、愿意自己维护入口的进阶用户;国内网络为主、能接受 cpolar 免费线路当应急的用户;需要社区插件在手机上也能用的用户;重视「不污染宿主源码」这一点的团队。
不适合:期望开箱即得稳定高速远程访问的用户——免费线路被限、Funnel 在大陆可能不稳定;只用 macOS 又想用 Funnel 或 cpolar 的用户,这两者没有 macOS 组件;不愿维护 VPS 与 Caddy 的用户,自建 FRP 的稳定性由你自己负责。
标签:DSH Mobile、DeepSeek Harness、开源生态、远程访问通道
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。
打开 dsh-mobile 的源码看它的三层结构
如果你已经装过 DSH Mobile,可能更关心它内部怎么分工——尤其是想自己动手改手机端的时候。这篇按源码结构拆开看:三层各自管什么、网关怎么代理、兼容层在什么时机加载,以及 /mobile 定制和 extensions/ 的权限边界。涉及的版本与兼容矩阵,可以在 DeepSeek Harness Hub 的插件清单 对照。
三层结构:谁负责什么
排除文档,插件本体可以清晰分成三层。
Phone[Android App / 手机浏览器] -->|局域网 HTTPS| Lan[局域网网关]
Phone -->|远程 HTTPS| Remote[独立远程网关]
Lan --> Gateway[DSH Mobile Gateway Core]
Remote --> Gateway
Gateway -->|回环代理| DSH[原生 DSH Web 与 Host]
DSH -->|同一工作区、会话和事件流| Phone
- Host face:负责发现、配对、HTTPS、回环代理和扩展注册表。它跑在电脑侧,是网关的核心。
- Client face:提供独立的移动布局与扩展 SDK,也就是手机实际渲染的那套界面。
- Android App:提供受限的原生 Bridge。Bridge 使用
androidx.webkit的WebMessage,每条消息校验精确顶层 Origin 和主 Frame,并限制消息大小,不使用addJavascriptInterface。
值得注意的是,「独立的移动布局」不等于另起一套逻辑:DSH 的源码和当前 Web 页面(默认端口 3080,可用 dsh web --port 改)都不会被改动,安装与卸载完全通过插件机制完成。
坑五 · 三层结构职责混淆,改错层等于白改
现象。 想给手机端加一个功能,改了半天却不见效,或者改了界面层的文件却在电脑上看到副作用。
原因。 三层各管一段:界面与交互属于 Client face(mobile.css / mobile.js),需要调用电脑能力时必须走 extensions/ 下的扩展;把本该放在扩展里的电脑能力硬塞进界面层,自然跑不通。
解决。 动手前先定位职责——先问「这段逻辑应该跑在电脑上还是手机上」,再决定改哪个文件,不要指望界面层越权去拿本机能力。
移动网关:以本机操作者身份代理,写请求仍要校验
网关不是简单转发。它以 DSH 本机操作者的身份代理请求,支持普通插件路由的 GET、HEAD、POST、PUT、PATCH、DELETE。但写请求依然要过三道校验:配对 Session、精确 Origin 与 CSRF。源码里有一条明确约束:第三方插件不能把上游回环 Host 当成「请求来自电脑物理本机」的证明。换句话说,「网关是本机进程」这件事只对网关自身成立,不能被下游插件借用。
坑六 · 自签 FRP 档须由 0.4.6 Android App 在配对时固定远程 CA
现象。 用自签档的自建 FRP 接上后,证书校验过不去,或旧版 App 根本不认这个入口。
原因。 自签档走的是 frps TCP 透传至电脑端 HTTPS 网关,必须由 0.4.6 及以上的 Android App 在配对时固定远程 CA;旧版 App 不支持,而且自签档目前面向公网 IPv4。
解决。 先用 0.4.6+ 的 App 完成配对;如果暂时升不了 App,就先退回公开 CA 档(仍需受限 HTTP vhost 与 Caddy)。
坑七 · excludedClientModules 配置不匹配时移动页面返回 409
现象。 为了省流量配置了模块排除,结果移动页面打不开,报 409。
原因。 插件会拒绝不存在的包、启动必需的模块,以及仍被保留模块通过 inject 或 external 引用的包;配置不匹配当前 DSH 或社区插件时,返回 409 excluded_client_modules_invalid 和冲突详情。
解决。 按启动清单里的准确包名填写,出现 409 就按冲突详情调整或移除;它只影响经网关提供的专用移动页面,电脑端和 ?frontend=stock 页面不变。另外它没有默认排除列表,别人的节省比例不能当成自己的预期。
坑八 · 旧内核 WebView 缺 Iterator helpers
现象。 手机页面启动即报 Iterator is not defined,界面起不来。
原因。 旧内核的 WebView 缺少 Iterator / Iterator helpers。专用移动页面会在 DSH 的第一个启动脚本之前,同步加载经网关鉴权的同源 /mobile-access/compat.js,用随插件打包的 core-js 做兜底。
解决。 优先更新 Android System WebView 或 Chrome。要知道这层兜底不依赖 CDN,也不会放宽 CSP,但它并不承诺支持所有旧内核——前端仍以 ES2022 为构建目标,兼容层只是把最常见的启动错误挡在前面。
compat.js 的加载时机决定了它的边界
上面提到 compat.js,它的设计重点其实在「什么时候加载」。它必须在 DSH 第一个启动脚本之前同步完成,否则启动过程早就抛错了;同时它经网关鉴权、与页面同源,因此不需要放宽 CSP,也不碰 Android APK、桌面页面或 ?frontend=stock 页面。它按能力检测保留或修正原生 helper,属于「补齐 + 修正」,而不是替换整个运行环境。
/mobile 与 extensions/:定制的权限边界
想让手机端变成你想要的形态,入口是在 DSH 对话里用 /mobile <需求>,由当前会话的 agent 直接修改 $DSH_HOME/mobile-access/ 下的文件,保存后手机端通常会在几秒内刷新。要调用电脑能力时用 extensions/ 下的扩展,其 host.mjs 以本机用户权限在电脑上运行——这意味着它的权限和你的本机程序相同。所以源码层面给出的建议很直接:只创建和运行你理解并信任的电脑端扩展。这不是限制,而是这层能力的真实代价。
总结
三层结构的价值在于把「手机怎么显示」「网关怎么代理」「原生能给多少能力」拆成互不越界的三件事,理解了这条边界,定制与排错都会变得可预测;结构细节之外的版本与通道信息,可以在 DeepSeek Harness Hub 插件清单 里对照。
适合与不适合
适合:想自己动手改手机端布局与交互的用户;需要通过 extensions/ 把电脑能力接到手机上的开发者;在意「不改宿主源码、可完整卸载」的团队;需要理解网关鉴权与 WebSocket 放行机制以便排查第三方插件的用户。
不适合:只想开箱即用、不愿读结构文档的用户;不愿意为 extensions/ 承担本机权限风险的用户——host.mjs 与你本机程序同权;以及打算把手机端界面改动交回上游的人,先确认改动落在正确的层,否则容易白改。
标签:DSH Mobile、DeepSeek Harness、源码解读、插件架构
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。
本文同步发布于
- 开源中国 ↗平台主页(原文链接暂未收录)