shaobeichen/dsh-pocket

DSH Pocket

English | 中文

把 DeepSeek Harness 装进你的口袋：一个包、一个设置页，手机扫二维码就实时看到电脑上的同一个界面——人在外面也能用。

⭐ 顺手留颗 Star，作者能高兴一整天  ·  行，给你一颗 Star

这是什么

你不在电脑前，也想用电脑上的 DeepSeek Harness。

• 下班路上，agent 在电脑上跑任务，你想掏出手机看看它干到哪了、结果如何
• 出门在外，突然想让电脑上的 agent 查点资料、写段代码，但没有远程桌面、没有 SSH
• 电脑在宿舍/办公室，你人在外面，想随时”操控你的 DeepSeek Harness”——发任务、看输出、点审批

DSH Pocket 就是干这个的：装上它，手机扫个码，就能实时看到并操控电脑上的 DeepSeek Harness 界面——人在外面也能用。

实际效果——手机上的界面就是电脑上的界面，实时同步：

✨ 特性

🚀 怎么用

入口在哪：安装完成并重启 dsh web 后，打开 设置，左侧边栏就能看到 「手机访问」 入口（和「通用设置」「模型」同级）：

前提：电脑上已装好 DeepSeek Harness。如果终端提示 dsh: command not found（找不到 dsh 命令），先安装：

npm install -g @deepseek-ai/dsh     # 全局安装；验证：dsh --version
# 不想全局装？每次命令前加 npx：npx @deepseek-ai/dsh <命令>

# 1. 装插件（一个包全都有）
dsh plugin --profile web add dsh-pocket -w

# 2. 重启 dsh web
npx @deepseek-ai/dsh web

局域网（同一 WiFi）

设置 → 手机访问 → 手机扫「📶 局域网」二维码 → 打开链接输入局域网密码（显示在设置页局域网区块，点「刷新」可换新）→ 打开的就是电脑上的 DSH，实时同步。

公网（人在外面）

同一页点「开启公网访问」→ 等隧道建立（首次会下载 cloudflared，macOS/Linux 走清华镜像秒下）→ 手机扫「🌐 公网」二维码 → 打开链接输入 8 位访问密码（密码显示在设置页公网区块，每次开启公网变新）→ 人在外面（4G/公司网）也能访问。

更新到新版本：dsh plugin --profile web update dsh-pocket --latest -w（跨大版本时 --latest 是必须的，^0.x 范围不会自动升到 1.x）。

⚠️ 安全（必读）

• DSH 能执行你电脑上的代码。局域网二维码/URL 配上独立 8 位数字密码才是钥匙，请勿把局域网二维码、URL 或密码发给别人
• 公网有 8 位数字密码保护：链接随机分配、每次开启换新密码、旧链接立即作废——泄露了也进不来，改密码/重开即可作废
• 公网 URL 由 cloudflared 随机分配，每次重启会变化（旧链接自动失效，相当于天然轮换）
• 局域网模式不暴露公网，只有同一网络内的设备能访问
• 适合个人自用；公网密码存本机 $DSH_HOME/dsh-pocket/token（每次开启公网自动换新），局域网密码存 $DSH_HOME/dsh-pocket/token-lan（设置页手动刷新）

💻 DSH Desktop（桌面版）

• 桌面版里 dsh-pocket 的扫码同屏正常可用；更新/重启由桌面版管理（插件内这两项自动停用）
• ⚠️ 桌面端 advanced 模式暂不支持手机访问（该模式禁用网页布局、手机拿不到 layout 服务，会白屏）——请切回 compatibility 模式后重启；advanced 模式下手机打开会看到明确的提示层

🩹 常见问题（别踩的坑）

⚠️ 公网隧道常见问题（必读）

现象：点「开启公网访问」后，手机上打开公网地址报 error 1033（Tunnel error）。

最常见原因：本机开着代理/VPN（Clash、Surge、v2ray、sing-box 等，尤其 TUN 模式）。 这类工具会接管全部流量，并常常把 cloudflared 的隧道边缘连接 （*.argotunnel.com、Cloudflare 边缘 IP）掐断，导致隧道注册成功但数据面连不上。

解决（从轻到重，按顺序试）：

1. 先只关闭代理的 TUN 模式，不用退出代理软件——多数情况这一步就够：
   • Clash：设置里关掉「TUN 模式」开关（或右键菜单栏图标 → 取消勾选 TUN 模式）
   • Surge：关「增强模式」；v2ray/sing-box：关「虚拟网卡/路由接管」
   • 然后回设置页重新点「开启公网访问」
2. 仍不行就彻底退出代理软件（不只是关界面：Clash 要右键菜单栏图标 → 退出；若装有 后台服务还要在服务管理器里停掉，ps aux | grep clash 确认进程消失），再重试
3. 给代理加直连规则，放行隧道域名与 Cloudflare 边缘（Clash 规则示例）： ```yaml
   • DOMAIN-SUFFIX,argotunnel.com,DIRECT
   • DOMAIN-SUFFIX,trycloudflare.com,DIRECT
   • IP-CIDR,198.41.192.0/24,DIRECT,no-resolve ```
4. 网络实在不通时，改用局域网模式：手机开热点 → 电脑连手机热点 → 扫局域网码， 效果完全一样（人在外面也能用）

其他可能：企业防火墙/校园网拦截出站；此时请让 IT 放行或改用热点。

首次开启时「下载 cloudflared」失败/卡住：

• macOS/Linux：优先走清华镜像（实测 ~3MB/s，几秒下完）；失败自动回退官方 GitHub + 加速源。
• Windows：无清华镜像（Homebrew 不支持 Windows），走官方直连下载（约 50MB，单线程会慢，属正常，耐心等几分钟；也可挂代理加速）。
• 全部失败时设置页会给出提示。备选方案（任选其一）：
  1. 手动装好命令行 cloudflared 后重试（装好后 dsh-pocket 直接用 PATH 里的，不再下载）：
  • macOS：brew install cloudflared；Linux：sudo apt install cloudflared 或官网下载
  • Windows：winget install cloudflared 或官网下载
  • 任何平台：npm i -g cloudflared
    1. 挂代理（系统代理/Clash 等）后重新点「开启公网访问」
    2. 手动下载二进制放到 $DSH_HOME/dsh-pocket/bin/ 目录（$DSH_HOME 一般是 ~/.dsh，Windows 是 %USERPROFILE%\.dsh；文件名用 cloudflared（Windows 加 .exe）或发布资产名均可，插件都认）

🗂 架构（单包）

🛠 开发

npm install
node client/build.mjs   # 改 client/ 后重新打包
npm test                # 代理 / 认证 / 压缩 / 隧道 / 服务 / RPC（43 测试）

🤝 致谢

• 移动端适配移植自 mexiaosqwq/dsh-web-mobile（MIT）
• 公网隧道基于 cloudflared

📄 License

GPL-2.0 —— 自由软件许可：可自由使用、修改、分发，但修改版必须同样以 GPL 开源并保留版权声明；商用同样适用。

说明：移动端适配部分移植自 dsh-web-mobile（MIT 许可，兼容 GPL），其版权声明保留在 client/mobile/LICENSE.dsh-web-mobile。

有问题？欢迎反馈：遇到 Bug、有想法、想提需求，请到 GitHub Issues 告诉我们 🙏