DSH Mobile 移动页面模块设置指南:按需加载前端模块,省掉手机首屏流量
DSH Mobile 移动页面模块设置指南:按需加载前端模块,省掉手机首屏流量
DSH Mobile 是 DeepSeek Harness 的安全移动访问插件与 Android App,支持局域网和远程访问、设备管理与移动界面适配。本指南带你使用 DSH Mobile 的“移动页面模块”设置,按需加载前端模块、减少手机首屏流量。手机每次打开专用移动页面时,会下载该页面用到的全部客户端模块;插件装得越多,首屏加载的 JavaScript 就越多。通过模块管理,你可以只保留真正需要的功能,显著降低流量与启动等待。
移动页面模块是什么?有什么用?
“移动页面模块”位于插件 0.6.0 起提供,入口在:
- 电脑端:设置 → 通用设置 → 移动页面模块 → 管理
- 手机端:设置 → 通用设置 → 移动页面模块 → 管理
它只决定专用移动页面下次打开时加载哪些客户端组件,注意三点:
- 不卸载电脑上的插件,也不停止插件服务;
- 不是设备权限隔离,已配对手机仍是受信任的操作者;
- 选择作用于完整模块 ID,不能只隐藏模块里的某个按钮或卡片。
换句话说:它帮你“瘦身”手机页面的首屏加载,而不改变电脑端的运行方式。电脑页面与 ?frontend=stock 页面完全不受影响。
打开移动访问入口,进入模块管理
模块目录需要从正在运行的 DSH 中读取,所以请先开启一个局域网或远程访问入口。打开“移动访问”面板后可看到访问地址、二维码与已加载的扩展数量:
配对完成后,在电脑端或手机端的 设置 → 通用设置 → 移动页面模块 → 管理 中即可打开模块清单。目录读取失败或超时时,点击“重新读取”即可,不必关闭弹窗。
三级优先级:选择到底听谁的?
DSH Mobile 的模块选择按以下顺序生效,前面的优先:
| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | 本设备覆盖 | 手机端保存的选择,只作用于当前配对设备 |
| 2 | 电脑默认 | 电脑端保存的选择,局域网与远程入口共用 |
| 3 | profile 配置 excludedClientModules |
高级用户直接在插件配置中写死的排除列表 |
任何一级都没有自定义设置时,就不排除任何模块。手机上的“恢复默认”只删除本设备的覆盖,回到电脑默认;电脑上的“恢复默认”回到插件配置。其他设备的选择不受影响。
这些选择的存储与优先级逻辑实现在 src/client-module-preferences.ts 中,每个设备条目还会记录模块的 gzip 体积等元数据。
在模块清单中勾选与保存
模块清单按分组展示:
- 可选扩展默认展开,排在最前;
- DSH 可选组件(高级) 和 启动必需项 折叠显示,后者不能关闭。
操作建议:
- 用搜索框按名称或模块 ID 查找,或用“加载/不加载”筛选;
- 勾选表示下次打开时加载,取消勾选表示下次不加载(当前页面不会立即卸载);
- 查看“未保存”改动数量,点击保存选择;
- 保存后不会自动刷新当前会话,下次手动打开或刷新 DSH 页面时生效,也不需要重启 DSH。
⚠️ 依赖保护:如果某个保留模块依赖你排除的模块,保存会被拒绝并提示冲突——你可以保留依赖,或同时排除不再需要的依赖方。系统不会自动连带取消其他模块。
用“测量体积”量化节省,开启最小加载
想知道每个模块到底占多少流量?点击测量体积才会读取模块资源并计算各模块独立 gzip 后的体积:
- 每次测量最多 5 秒预算,可随时取消,未保存的选择不会被覆盖;
- 已知结果缓存 10 分钟,分组内按体积从大到小排列;
- 数字只用于比较当前各模块的相对大小——模块合并、浏览器缓存、压缩协商都会影响真实下载量,不代表固定的节省比例。
能解析到包元数据的模块还会显示插件自己的 package.json 描述(最长 200 字),帮你判断陌生模块的用途。
💡 最省事的做法:点击**“仅必需(最小加载)”**,只保留启动必需项及其依赖,其他一律设为不加载,然后点“保存选择”。界面逻辑可参考 src/client-module-presentation.ts 与 src/client-module-ui.ts。
插件更新导致选择失效怎么办?
DSH 或社区插件更新后,模块目录和依赖关系可能变化:旧的排除项可能已不存在,或变成了启动必需项。此时清单会单独列出“失效的旧选择”,点击“移除旧排除”并保存即可,其他选择保留。
更极端的情况:已保存的选择阻止了移动页面启动。此时页面会提供**“为本设备加载全部模块并重试”,点击后仅恢复本设备**的加载选择,不改变电脑默认、其他设备或配对授权。恢复流程的实现在 src/client-module-recovery.ts。
高级玩法:在 profile 中直接排除模块
熟悉配置的深度用户,也可以跳过界面,直接在当前 profile 的 mobile-access 插件配置中写入 excludedClientModules,填入启动清单中的准确包名,重启 DSH 后生效。这是按安装环境选择的高级配置,没有默认排除列表;若配置引用了不存在的包、启动必需模块或仍被保留模块引用的包,移动页面会返回 409 excluded_client_modules_invalid 并给出冲突详情。详见 README 可选模块与高级配置。
常见问题速查
问:关掉一个模块会停止手机操作电脑的能力吗? 不会。要停止某台手机操作电脑,请在电脑端撤销设备配对,而不是只关闭一个客户端模块;撤销配对会同时移除该设备的模块覆盖。
问:局域网和远程访问会共用我的选择吗? 电脑默认由两个入口共用;但设备覆盖按配对身份保存,同一部手机的局域网配对和远程配对不会自动共用一个覆盖。
问:安全方面会泄露什么吗? 选择保存在电脑的 DSH Mobile 私有数据目录,目录接口不返回上游下载 URL、本机文件路径或配对凭据;手机端修改与测量还需通过同源和 CSRF 校验。
完整的官方规则(含生效、恢复与授权细节)请阅读 docs/CLIENT_MODULES.md,英文版见 docs/CLIENT_MODULES.en.md。按需加载、量力配置,让 DSH Mobile 的首屏加载又快又省。

