手机扫个码,人在外面也能用电脑上的 DSH

一、先说那个别扭的场景

下班路上你突然想起来：电脑上的 agent 还在跑那个任务，跑到哪了？

想知道结果，可你没配远程桌面，也没弄 SSH。手机能刷到的只有聊天记录，看不到那边还在滚动的终端。

于是只剩两个选择：回家再看，或者干脆让它白跑一晚。

图 1：不是没有能力，是人和电脑被分开了。

二、这插件什么来头

一句话：把 DSH 的 Web 界面通过二维码投到手机上，局域网和公网都能连，还能实时同屏。

• 仓库 github.com/shaobeichen/dsh-pocket，GPL-2.0 协议
• GitHub 1,368 星、67 fork（GitHub API，2026-09-27 抓取）
• 过去一个月下载 21,396 次（npm downloads 接口，区间 2026-08-27 至 2026-09-25）
• 当前版本 2.10.6（npm registry 的 latest 字段），仓库创建于 2026-08-15

图 2：数字都能自己复核。

三、三个真正重要的亮点

1. 同一个 WiFi 下，扫码就能用

装好之后，设置里多一个「手机访问」。打开就有一张局域网二维码，手机连同一个 WiFi 扫码即开，不用配 IP、不用改路由。

它会自动识别本机局域网地址。WSL 环境还会专门去取 Windows 物理网卡的 IP。

2. 人在外面，走公网隧道

点一下「开启公网访问」，它用 cloudflared 建一条隧道，再出一张公网二维码。手机用 4G 也能打开，看到的就是电脑上那个界面。

公网链接默认带一个 8 位随机密码，每次开启都换新的，旧链接立即作废。想省事可以在设置页把它设成固定的。

3. 实时同屏，还能双向操作

流式输出走 WebSocket 全透传：电脑上在滚，手机上同步在滚。你在手机上发消息、点审批，电脑那边一样收得到。

窄屏会自动变成抽屉布局。它还带心跳保活，防路由器掐断长连接，断了自动重连。

图 3：三条都在解决「人不在电脑前」。

四、在 DSH 里怎么装

一、通过 dsh-market 插件市场：在设置里打开插件市场，搜 dsh-pocket，点安装，然后重启 dsh web。

二、终端一条命令：

dsh plugin --profile web add -w dsh-pocket

命令末尾的 -w 别丢。pnpm 9 对 workspace 根目录有限制，丢了会报 ERR_PNPM_ADDING_TO_ROOT。

三、直接跟 agent 说「帮我在 web profile 里装上 dsh-pocket」，它会装好并提醒你重启。

三条路通向同一个包，装完3都要重启 dsh web 才生效。

图 4：三条路通向同一个包。

五、几个可能踩到的坑

• 要 Node 22 或更新
  ，peer 依赖 cordis ^4.0.1。装完不重启，界面不会有任何变化。
• 公网那道免责声明不是走形式
  。DSH 能执行你电脑上的代码，公网访问等于把它挂到互联网上。涉密网络别开，用完就关。
• 本机的代理软件会掐断隧道
  。Clash 这类工具开着 TUN 模式时，手机上会报 error 1033。先关掉 TUN 模式，或者干脆改用局域网模式。
• 公网地址会变
  。快速隧道的域名每次重启都换，旧链接自动失效。想要固定域名得用命名隧道，但那时密码不再自动轮换。
• 端口 3081 可能被占
  ，报 EADDRINUSE。要么杀掉旧进程，要么换个端口。
• 桌面版 advanced 模式暂时不支持手机访问
  ，打开会白屏，得切回 compatibility 模式。
• 升级要带 --latest
  。^0.x 的版本范围不会自动跨到 1.x，不带这个参数就一直停在旧版。
• 登录状态绑在 dsh web 进程上
  ：进程不重启就不用重输密码，一重启就得再输一次。

图 5：坑大多写在 README 里，扫一遍省一次返工。