dsh-pocket 是什么？手机扫码实时访问电脑上的 DeepSeek Harness

dsh-pocket 是 DeepSeek Harness（DSH Plugin）生态的移动端访问插件：电脑上跑 dsh web，手机扫二维码就能实时查看并操控同一个 DSH 界面，人在外面也能用，无需远程桌面或 SSH。 本文基于官方 README 介绍它是什么、核心功能、安装启用、局域网与公网扫码用法，以及常见排错，助你人不在电脑前时随时用上 DSH。

dsh-pocket 是什么？

dsh-pocket 解决「人不在电脑前，也想用电脑上的 DeepSeek Harness」的问题：装上它，手机扫个码，就能实时看到并操控电脑上的 DSH 界面，支持局域网与公网两种访问方式。 以下定位与事实均来自官方 README（来源）：

dsh-pocket 由 shaobeichen 维护、以 GPL-2.0 协议开源。它的使用场景很直白：下班路上 agent 在电脑上跑任务，掏出手机看它干到哪了；出门在外，想让电脑上的 agent 查资料、写代码，但没有远程桌面也没有 SSH。dsh-pocket 把 DeepSeek Harness「装进口袋」——一个 npm 包、一个设置页，手机界面与电脑界面实时同步。它零依赖安装，无需账号、无需服务器：局域网模式走同一 WiFi 的二维码，公网模式通过 cloudflared 隧道生成二维码，4G 网络也能访问。

dsh-pocket 的核心功能有哪些？

dsh-pocket 的核心能力是把 DSH 装进手机：局域网扫码即用、公网隧道随时访问、固定域名、独立访问密码、会话保持与实时同步，外加传输压缩与隧道自动恢复。 这些能力全部来自官方 README（来源）：

• 局域网扫码即用：装好即用，设置 → 手机访问，手机连同一 WiFi 扫码即开；自动识别本机局域网 IP，WSL 环境自动取 Windows 物理网卡 IP；局域网访问可一键关闭（关闭后二维码与链接立即失效）。
• 公网扫码访问：点「开启公网访问」→ cloudflared 隧道 → 出公网二维码，4G 或任何网络都能访问；DSH 重启后自动重新拉起之前开着的公网隧道。
• 公网固定域名：可选「命名隧道」模式，填 Cloudflare Tunnel Token + 自己的域名，公网地址固定不变（重启不再变化）。
• 访问密码保护：公网链接需输入 8 位密码（默认每次开启换新，可自定义固定密码）；局域网有独立 8 位密码（默认开启，可一键关闭实现扫码直连）。
• 会话保持与实时同步：手机输一次密码后长期免输（登录状态绑定电脑上的 dsh web 进程）；流式输出走 WebSocket 全透传，双向操作，内置心跳保活与断线重连。
• 传输压缩：大 JSON 响应自动 gzip/brotli 压缩，长会话 17MB 压缩至约 1MB，手机加载更快、更省流量。

怎么安装与启用 dsh-pocket？

安装 dsh-pocket 需要一条 dsh plugin 命令装进当前 profile，重启 dsh web 后设置页出现「手机访问」入口即可扫码使用；更新与卸载同样走 DSH CLI。 以下命令与事实均来自官方 README（来源）：

1. 安装 dsh-pocket：在 DeepSeek Harness 终端执行安装命令。若提示 dsh: command not found（找不到 dsh 命令），先全局安装 CLI：

npm install -g @deepseek-ai/dsh     # 全局安装；验证：dsh --version

再执行安装命令：

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

等待命令输出安装完成。

2. 重启 dsh web 并启用：安装后重启 dsh web 才能加载新插件：

npx @deepseek-ai/dsh web

重启后打开设置，左侧边栏会出现「手机访问」入口（与「通用设置」「模型」同级），扫码即可访问。

3. 更新 dsh-pocket：更新插件用带 --latest 的命令（跨大版本时 --latest 是必须的，^0.x 范围不会自动升到 1.x）：

dsh plugin --profile web update dsh-pocket --latest -w

运行后重启 dsh web 生效。

4. 卸载 dsh-pocket：从当前 profile 移除插件：

dsh plugin --profile web remove dsh-pocket

卸载后手机扫码链接即失效。

dsh-pocket 典型用法

dsh-pocket 的典型用法是「电脑跑 dsh web、手机扫码访问」：局域网模式适合同一 WiFi，公网模式适合人在外面，固定域名适合需要稳定地址的场景。（来源）以下四个步骤覆盖从局域网到公网固定域名的日常用法。

1. 局域网访问：手机连与电脑同一的 WiFi，打开设置 →「手机访问」，扫「局域网」二维码并输入局域网密码，打开的就是电脑上的 DSH 界面、实时同步（密码显示在设置页局域网区块，可「刷新」换新或「自定义」设成固定 8 位；只有自己用时可直接关闭密码实现扫码直连）。

2. 公网访问：在「手机访问」页点「开启公网访问」，每次都会先弹出安全免责声明，勾选「我已知情」后才能开启；等隧道建立（首次会下载 cloudflared），手机扫「公网」二维码并输入 8 位访问密码（默认每次开启换新，可点「自定义」设成固定密码），人在外面（4G/公司网）也能访问。

3. 配置公网固定域名：默认快速隧道的公网地址每次重启都会变（前缀随机）；想要固定公网地址，用 Cloudflare 命名隧道：在 Cloudflare Zero Trust 的 Networks → Tunnels 创建一条 Tunnel 并复制 Tunnel Token → 在 Public Hostname 里把域名（如 pocket.example.com）的 Service 指向 http://127.0.0.1:3081 → 回到设置页公网区块切到「命名隧道」模式，粘贴 Token、填写域名，保存后开启公网访问，地址固定不变。

4. 自定义端口（可选）：默认端口 3081 被占用时，可在 $DSH_HOME/dsh-pocket/settings.json 写入 "proxyPort": 3082 后重启 dsh web；CLI 模式用 dsh-pocket --port 3082：

dsh-pocket --port 3082

dsh-pocket 常见问题与排错

dsh-pocket 最常见的四类问题是公网 error 1033、装完界面没变化、端口被占用、版本停在 0.x 升不上去，分别通过关代理 TUN、重启 dsh web、杀旧进程与 --latest 更新解决。（来源）

1. 公网打开报 error 1033（Tunnel error）：症状是开启公网访问后，手机上打开公网地址报 error 1033；最常见原因是本机开着代理/VPN（Clash、Surge、v2ray、sing-box 等，尤其 TUN 模式）掐断了 cloudflared 的隧道边缘连接。解决：先只关代理的 TUN 模式（Clash 关「TUN 模式」开关），仍不行就彻底退出代理软件，再不行给代理加直连规则放行 argotunnel.com；网络实在不通时改用手机热点 + 局域网模式，效果一样。

2. 装完或更新了但界面没变化：症状是安装后看不到「手机访问」入口或功能未更新；原因是运行中的进程仍加载旧代码。解决：必须重启 dsh web 才生效。

3. 提示 listen EADDRINUSE ... :3081：症状是启动报端口被占用；原因是旧 dsh-pocket 进程还占着 3081 端口。解决：杀掉占用端口的旧进程后重试：

lsof -ti :3081 | xargs kill -9

4. 版本停在 0.x 升不上去：症状是执行普通更新命令后版本不涨；原因是 ^0.x 依赖范围不允许自动升到 1.x。解决：更新命令必须带 --latest（dsh plugin --profile web update dsh-pocket --latest -w）。

适用场景与注意

dsh-pocket 适合所有「人不在电脑前却要用 DSH」的场景，但它会把能执行代码的 DSH 暴露到网络：公网访问强制免责声明与 8 位密码、带登录限速，涉密网络请勿开启。（来源）

适用场景：下班路上查看 agent 任务进度与结果；出门在外给电脑上的 agent 发任务、看输出、点审批；宿舍/办公室的电脑留在原地，人在外面随时操控。注意事项：

1. DSH 能执行你电脑上的代码——请勿把局域网二维码、URL 或密码发给别人；局域网访问仅限同一网络内的设备。
2. 公网访问每次开启都会弹出安全免责声明且必须勾选（服务端强制校验，无法绕过），请使用强密码、用完即关、涉密网络勿用。
3. 登录限速防暴力破解：同一 IP 连续输错 5 次锁定 60 秒；公网判定是 fail closed——除本机和局域网私网地址外，一切陌生域名（包括自建隧道指向本机端口的固定域名）一律按公网处理、强制公网密码。
4. DSH Desktop 桌面版的 advanced 模式暂不支持手机访问（手机打开会白屏），请切回 compatibility 模式后重启。

项目链接

dsh-pocket 是 shaobeichen 维护的 GPL-2.0 开源项目。 插件详情页：dsh-pocket 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：shaobeichen/dsh-pocket。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。