本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-mobile

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-mobile

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 在手机上继续电脑端的工作：同一份会话、工作区、消息和工具，实时同步。
• 用对话定制手机端：直接在 DSH 对话里改手机页面的布局、交互和功能，几秒内刷新。
• 专属触屏布局：会话抽屉、工具详情、设置和输入栏都按手机重新组织。
• 自动发现、无需重新配对：切换 Wi-Fi、热点或 IP 后通常自动恢复。
• 三种配对方式：扫码、配对链接、密钥。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要做什么才能用起来？

插件本身只完成下载和补丁挂载；首次使用必须执行 dsh plugin --profile web exec dsh-mobile setup 来生成自签名 HTTPS 证书并自动选择当前局域网；之后重启 DSH，左下角打开“移动访问”卡片即可生成配对密钥或二维码。

iOS 客户端能用吗？

目前仅 Android App 可在 Release 中下载。iOS 客户端仍是未发布的本地开发实验，不进入构建、Release 或支持范围；iPhone 想用就先用手机浏览器（HTTPS 首次需手动信任该证书）。

配对是怎么完成的？支持哪些方式？

在电脑端“移动访问”卡片生成一次性密钥或配对链接后，Android App 可扫码配对（免手输密钥）、通过局域网发现选择电脑后粘贴密钥，或者直接打开配对链接（密钥自动填入）。首次配对会建立持久设备信任，之后打开 App 不再要求重新输入。

切换 Wi-Fi、IP 变了会不会断？

不会要求重新配对。setup 会自动选定当前局域网网卡并把接口名固化到 $DSH_HOME/mobile-access/setup.json；插件运行时会监听网卡地址变化（DNS-SD/mDNS + 周期性 UDP 公告），局域网切换后通常自动恢复、App 端也会用同一 stable installation identifier 找回这台电脑。

我能在 DSH 里定制手机端的界面和功能吗？

可以在电脑端 DSH 对话框输入 /mobile <需求>（例如 /mobile 把手机端做成老式终端的样子），DSH 会调用专属 agent 改 $DSH_HOME/mobile-access/ 下的 mobile.css、mobile.js 或 extensions/<id>/ 目录，几秒后手机端自动应用。改动不修改 DeepSeek Harness 源码。

能让手机端调用电脑端的能力吗（比如读电脑文件）？

可以。在 $DSH_HOME/mobile-access/extensions/<id>/ 下创建扩展，host.mjs 是电脑端 Node.js 代码（拥有本机用户的完整权限），mobile.js 是手机端脚本，通过 api.host.invoke() 或 api.host.fetch() 调用前者。也可以用命令一键生成模板：dsh plugin --profile web exec dsh-mobile extension create <id> --name "<名称>"。

卸载时数据会一起清掉吗？

仅执行 dsh plugin --profile web remove dsh-mobile 时插件进程退出，但证书、设备、配对信息、自定义文件、扩展等仍留在 $DSH_HOME/mobile-access/。要彻底清干净，需要先执行 dsh plugin --profile web exec dsh-mobile purge --yes，再 remove。Windows 上 purge 还会尝试移除它添加的两条防火墙规则。

升级 DSH 后启动失败或报兼容错误怎么办？

插件启动时会校验 DSH Host 版本，只放行 0.1.0-rc.5/rc.6/rc.7；遇到未经验证的版本会直接报错而不是带病启动。若升级 DSH 后报错，先升级 dsh-mobile 到当前支持的 alpha 版本（保持插件比 DSH 更新的策略）。

这个方案能放公网吗？

不能。配对设备拥有电脑端 DSH 的完整操作能力，等同于完全可信的电脑用户；务必只在受信任的家庭/办公局域网或受信任的 VPN 中使用，不要把 3443 端口直接转发到公网。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.5 / 0.1.0-rc.6 / 0.1.0-rc.7（src/compatibility.ts:2-6 白名单；强制校验，未通过直接报错）
• Node: ^22.19.0 || >=24.0.0（package.json:65-67 engines）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则