DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Mrsirlila /

Mrsirlila/dsh-pocket-plus

Topic repository only

把 DeepSeek Harness 装进口袋,扫一次码就进去。内网 / Tailscale / Cloudflare 三条链路自动择优,断线自动切换。

★ 16 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@95a9c06d
dsh-pocket-plus

dsh-pocket-plus

把 DeepSeek Harness 装进口袋 —— 扫一次码就进去。

在手机上继续会话、盯住流式输出、回答问题与审批、下载产物。
内网 / Tailscale / Cloudflare 三条链路自动择优,断线自动切换,切换不用重新扫码。

GitHub stars Android 8.0+ APK 1.41 dsh-pocket plugin GPL-2.0

dsh-pocket-plus 是 shaobeichen/dsh-pocket 的增强发行版。插件本体仍是那个插件(包名 dsh-pocket),我们在它上面打了七处补丁,并配了一个能自动择优三条链路的安卓 App。

English — An enhanced build of the dsh-pocket plugin for DeepSeek Harness: the access PIN is embedded in the QR code so scanning enters directly, a read-only /dsh-pocket/entry.json lets the phone app sync the current public address, and the companion Android app probes LAN / Tailscale / Cloudflare in order and fails over automatically.

dsh-pocket-plus:手机访问页的三条链路

目录

  • 为什么会有这个版本
  • 三条链路
  • 和上游的差异
  • 界面预览
  • 快速开始
  • 安装
  • 扫码为什么不用输密码
  • 常见问题
  • 升级与自愈
  • 安全模型
  • 仓库结构
  • 开发
  • 反馈与贡献
  • License

为什么会有这个版本

上游把「手机上用 DSH」这件事做到了能用。真正拿它当日常入口之后,剩下的是几件很具体的麻烦:

  • 扫完码还要再输一遍密码。 二维码里只有地址,密码得跟着地址一起带着走才行。
  • 公网地址每次重启都变。 手机里存的旧地址直接 ERR_NAME_NOT_RESOLVED,得回电脑前重新扫一次。
  • 手机离开家就回不去。 内网地址在外面不通,公网绕一圈又慢,中间没有一个更近的选择。
  • DSH 重启之后手机黑屏。 代理发现浏览器带着 dsh-auth-* cookie 就不补 launch token,旧 cookie 直接换来 401。
  • 对话里的宽表格被裁掉。 窄屏下 overflow-x:hidden,触屏又没有 hover,右侧那一列永远看不到。

这个版本就是把这五件事逐个补掉,并把「离开家也能连上」做成 App 里的自动切换。

功能介绍与更新记录视频:BV1XaeU65EHJ

三条链路

同一台电脑,三条路到达同一个 DSH。App 按 内网 → Tailscale → 公网 的顺序探测,选第一条真正通的加载,断了自动换下一条。

链路 地址形态 免密码 适用 速度
内网 http://192.168.x.x:3081 是 手机与电脑在同一 Wi-Fi 最快
Tailscale http://100.x.x.x:3081 是 不同网络,手机与电脑登录同一个 tailnet 接近内网,点对点
公网 https://xxx.trycloudflare.com 否(扫码免) 任意网络,无需装任何东西 取决于 Cloudflare 中转
  • 探测是 TCP + HTTP 双重判定:端口能连上还不算通,GET / 返回状态码 < 500 才算这条链路可用。
  • 长按 App 顶栏的 ⚙ 可以在三个入口之间 锁定,锁定后不再被自动探测覆盖。
  • 公网地址变了也没关系:App 连上任意一条链路时会去拉 /dsh-pocket/entry.json,把最新的公网地址与密码同步本地,下次出门不用重新扫码。
  • Tailscale 那一条之所以免密码,是因为插件把 100.64.0.0/10(CGNAT)和 RFC1918 一并判定为「局域网」,走的是内网规则。手机要装 Tailscale 并登录同一个账号。

和上游的差异

插件侧七处补丁,全部只改行为、不改接口:

# 位置 改动 解决的问题
① lib/service.mjs 二维码文本追加 ?token=<PIN> 扫码直达,不再手输密码
② lib/index.js 新增只读路由 GET /dsh-pocket/entry.json 手机同步当前公网地址与密码
③ lib/tunnel.mjs spawn 加 windowsHide: true Windows 上弹黑框、关窗即断隧道
④ lib/proxy.mjs 上游 401 时清 dsh-auth-* cookie 并 302 重握手 DSH 重启后手机黑屏
⑤ client/mobile/mobile.css.ts 表格容器可横向滚动、单元格解除最小宽度 宽表格右侧被裁
⑥ lib/service.mjs 等 新增 Tailscale 卡片、tailscaleUrl、tailscaleQr 第三条链路的入口
⑦ client/mobile/mobile.css.ts 窄屏强制 grid-template-columns: 0 minmax(0,1fr) 0 DSH 0.2.2 窄屏主列宽度为 0、整页黑屏

App 侧(DSH掌上版-1.41.apk):

  • 三入口优先级探测与自动降级、锁定入口
  • 扫码分流:100.64/10 自动识别成 Tailscale 入口
  • 连上后回拉 entry.json 同步三条地址
  • 表格渲染、401 自愈后自动重载

界面预览

桌面设置页的三条链路    手机端会话

左:三条链路 · 内网 / Tailscale / 公网各一张二维码  |  右:手机端会话 · 流式输出与代码块

手机端宽表格    手机端冷启动

左:宽表格 · 可横向滚动,长单元格自动换行  |  右:冷启动 · 加载插件中

截图为演示数据,域名、PIN、二维码均为示例。

快速开始

  1. 装插件(Web profile):

    dsh plugin --profile web add "dsh-pocket@github:Mrsirlila/dsh-pocket-plus#path:/plugin"
    
  2. 重启 DSH,侧栏打开「DSH Pocket」设置页,能看到内网 / Tailscale / 公网三块卡片。

  3. 装 App:下载 DSH掌上版-1.41.apk 安装。

  4. 扫码:手机扫任意一张二维码。带密码的那张会直接进入,不用再输 PIN。

安装

插件

推荐用 GitHub 子目录安装,升级时 pnpm update dsh-pocket 即可:

node "<DSH 安装目录>\lib\bin.js" plugin --profile web add "dsh-pocket@github:Mrsirlila/dsh-pocket-plus#path:/plugin"

也可以直接在插件市场里装上游 dsh-pocket,再手动覆盖 D:\deepseek\deepsleep\dsh-pocket-publish\plugin 里的文件 —— 但那样升级会被 pnpm 换回官方版,见 升级与自愈。

装完检查一下补丁还在:

$d="$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-pocket"
(Get-Item "$d\lib\service.mjs").Length      # 26509 = 补丁版;22202 = 官方原版
Select-String -Path "$d\lib\service.mjs" -Pattern 'tailscaleIPv4','qrTextFor' -SimpleMatch

App

文件 大小 说明
DSH掌上版-1.41.apk 602554 B 三链路自动择优、入口锁定、扫码分流、地址同步
dsh-pocket插件-已打补丁.zip 213146 B 插件完整源码,可离线部署

签名是自签名,首次安装需要允许「安装未知来源」。升级覆盖安装即可,不需要卸载(沿用同一个签名密钥)。

完整用法与更新记录见 使用说明.txt,包内容导读见 先读我-包内容说明.txt,校验值见 SHA256校验.txt,插件源码见 plugin/。

扫码为什么不用输密码

普通二维码里只有 https://xxx.trycloudflare.com,所以扫完还得手动输 PIN。这个版本把 PIN 拼进地址:

https://xxx.trycloudflare.com/?token=15469936

代理收到带 ?token= 的请求会:

  1. 校验 PIN 是否正确;
  2. 种一个 30 天有效的 HttpOnly cookie;
  3. 302 到不带参数的干净地址。

第二次打开就不需要参数了。链接里有 PIN,等同于电脑的钥匙,别往公开群里发;泄露了就在设置页点「换一个」,旧链接立即失效。

常见问题

扫码进去还是要输密码

先看二维码文本里有没有 ?token=。没有的话就是插件被换回了官方版:

(Get-Item "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-pocket\lib\service.mjs").Length

22202 是官方原版,26509 才是补丁版。用 robocopy 重新部署或重启一次 start-dsh-web.cmd(自愈脚本会自动补回)。

DSH 重启后手机黑屏:dsh web authentication required

现象:页面只有一行 dsh web authentication required; reopen the URL printed by dsh web.。

原因:DSH 每次启动会换 launch token,而代理发现浏览器带着 dsh-auth-* cookie 就不再补 token,旧 cookie 换来 401。

补丁④ 会把这种 401 变成「清掉旧 cookie 并重新握手」的 302,手机自动跳一次就进去了。如果还黑屏,下拉刷新一次,不要清 App 数据。

公网地址每次重启都变

Quick Tunnel 的域名是临时的,进程一重启就换一个。手机不用管:连上内网或 Tailscale 时会拉 /dsh-pocket/entry.json 把新地址同步过去。只有三条链路全都不通时,才需要回电脑前重新扫一次。

对话里的表格右边被切掉

补丁⑤ 让表格容器可以横向滑动,并把单元格的最小宽度从 100px 解开。如果还是被裁,确认 client.js 是 143769 B 的补丁版。

Tailscale 卡片不显示 / 显示但连不上

设置页的卡片依赖 pocket.status 里的 tailscaleUrl。如果卡片不在,先确认插件是补丁版(service.mjs 26509),再确认电脑上 tailscale status 能看到本机的 100.x 地址。

重启之后补丁又没了

pnpm 从 store 重新链接时会恢复官方文件。用 start-dsh-web.cmd 启动(而不是直接 dsh web),启动前的自愈脚本会按哈希比对:

  • 是补丁版 → 跳过
  • 是官方原版 → 整文件替换
  • 两个都不是 → 拒绝改动并报错

详见 插件维护规范.md。

升级与自愈

上游发版时,不要直接覆盖。按仓库里的 开工必读.md 走:

  1. 拉上游新版本到临时目录
  2. 逐文件比对,把七处补丁重新打上
  3. 更新 plugin/、重打 zip、更新 SHA256校验.txt
  4. 部署用 robocopy /E /PURGE(单文件覆盖会写穿 pnpm 硬链接)
  5. 推仓库 → pnpm update dsh-pocket

自愈脚本 D:\tools\patch-dsh-pocket.js 以官方原版为基线做哈希比对,只认「补丁版」和「官方原版」两种输入,避免上游换版后被乱七八糟改坏。

安全模型

  • 访问密码:6–8 位数字 PIN,公网入口强制校验;内网与 Tailscale 走免密规则。
  • Cookie:登录后种 30 天 HttpOnly cookie,JS 读不到;换密码后旧 cookie 立即失效。
  • 二维码:含 PIN,等同钥匙。不要公开分享。
  • entry.json:只读,且只暴露「地址 + 当前 PIN」,不含任何会话数据;公网访问同样要求已登录。
  • 桌面设置页:/dsh-pocket 只接受回环请求。
  • 公网链路:走 Cloudflare Quick Tunnel,传输层是 HTTPS;局域网与 Tailscale 是明文 HTTP,但只在可信网络内可达。

仓库结构

dsh-pocket-plus/
├─ plugin/                  # 插件源码(七处补丁已打)
│  ├─ lib/                  # service.mjs / index.js / proxy.mjs / tunnel.mjs
│  ├─ client/               # 桌面设置页与手机端样式、文案
│  ├─ 本地修改声明.md        # GPL-2.0 §2(a) 要求的修改声明
│  └─ 安装说明-必读.txt
├─ DSH掌上版-1.41.apk       # 安卓 App
├─ dsh-pocket插件-已打补丁.zip
├─ SHA256校验.txt
├─ 使用说明.txt
├─ 先读我-包内容说明.txt
├─ 插件维护规范.md          # 上游更新流程、故障史
└─ 开工必读.md              # 每次动手前的检查清单

开发

插件侧没有构建步骤,改完直接部署:

robocopy .\plugin "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-pocket" /E /PURGE /NFL /NDL /NJH /NJS
node --check .\plugin\lib\service.mjs
node --check .\plugin\lib\index.js
node --check .\plugin\lib\proxy.mjs
node --check .\plugin\lib\tunnel.mjs

App 侧(D:\android-build\DshPocket,单文件 MainActivity.java):

gradle -p D:\android-build\DshPocket assembleRelease --no-daemon
# 产物:app\build\outputs\apk\release\app-release.apk

改完插件记得重启 DSH 才生效;重启会换掉公网域名与 PIN,属于正常现象。

反馈与贡献

  • 上游插件本身的问题,请提到 shaobeichen/dsh-pocket。
  • 七处补丁、App 三链路相关的问题,提到 本仓库 Issues。
  • PR 请保持「只做必要改动」:一处补丁一个提交,并在描述里写清验证方式(扫码 / 401 探测 / 表格截图均可)。

License

GPL-2.0,与上游 dsh-pocket 一致。对上游代码的每一处修改都记录在 plugin/本地修改声明.md。

电脑端插件是 shaobeichen/dsh-pocket(GPL-2.0)的修改副本,以 GPL-2.0 分发,与原作者无关;问题请提到本仓库,不要反馈给上游。界面与图标中的形象版权归其原作者所有。

—/ 5

No ratings yet

Manifest verification required

Commit 95a9c06d936c

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout