dsh-anywhere

📱 专为 DSH iOS App 与多端协同打造的超级连接枢纽
电脑、iPhone、iPad 多终端同时在线无缝切换，实时同屏收发；局域网 + 通用稳定公网全覆盖，锁屏切回 0.25 秒极速自愈（Fast-Resume）。

---

🌟 核心杀手锏：完美搭配 DSH iOS App，实现真正的多终端无缝协同

传统 Web 访问或普通手机端连接 DSH 时，最令人头疼的三大痛点：

1. 多端冲突踢线：电脑开着，手机一连就把电脑挤掉，或者两边状态不同步、各打各的；
2. 手机一锁屏就假死：切出微信回个消息或锁屏几秒钟，再打开界面直接白屏、断线，必须手动刷新重新进；
3. 输入流不同步：手机发了消息电脑看不到，或者电脑端正在打印流，手机端一片空白。

dsh-anywhere 深度重构底层传输与事件流，带来前所未有的「多端实时同屏」体验：

• 🤝 多终端同时在线，实时双向广播： 电脑端（桌面客户端或浏览器）、iPhone (DSH iOS App)、iPad 或多台移动设备可以同时打开同一个会话。无论哪一台设备敲下回车发指令，所有设备屏幕实时同步滚动、同步打印 AI 的流式回复，真正的“多端一心”。
• ⚡ 毫秒级锁屏断线自愈（Fast-Resume）： 内置原生 Fast-Resume 协调机制。手机切到后台、锁屏挂起无论多久，只要重新点开 DSH iOS App，系统在 0.25 秒内自动完成静默换票重连，瞬间拉齐断网期间的所有消息增量，彻底告别白屏重载！
• 🔄 跨场景无缝切换： 在电脑前敲代码做方案，中途有事出门，直接拿起手机打开 DSH iOS App 继续聊，上下文与进行中的任务完全连贯，实现“电脑开始、手机随身走”的无缝闭环。

---

🚀 更多硬核能力

1. 统一 3083 端口主控（彻底告别双开冲突与端口漂移）

• 单进程绝对主控：无论是桌面端 DSH Desktop 还是无头模式，统一监听 3083 端口，手机端与公网统一接入 3083。
• 彻底消除后台无头服务与桌面客户端的文件锁争抢（告别 stored session 丢失），无论手机端还是电脑端，永远连入同一个进程，多端状态 100% 实时同屏！

2. 连接方式（推荐顺序：局域网优先，外网进阶）

• 🏠 首选：局域网直连（推荐所有用户）
  • 手机与电脑连同一 WiFi，地址填 http://<电脑局域网IP>:3083（或直接扫码）；
  • 局域网地址天然不变，零配置、零依赖、零风险，延迟最低，90% 的使用场景一台路由器就够了。
• 🌐 进阶：外网远程访问（看自己的搭建能力，量力选择）
  • 方案 A：免配置极速隧道（默认，开箱即用）
    • 针对国内网络深度优化：内置国内镜像并发分片加速（亦可直接内置 bin/cloudflared.exe 免下载），解决官方版在 GitHub 下载卡死在 0% 的致命问题；
    • 强制启用 --protocol http2 隧道，杜绝国内运营商对 UDP/QUIC 的丢包阻断，普通用户点开即用。
  • 方案 B：Cloudflare Zero Trust 命名隧道（永久固定域名）
    • 支持普通用户绑定自己的免费域名与 CF Tunnel Token，重启软件外网网址永久不变。
  • 方案 C：自定义穿透直连（FRP / 异地组网 / 公网IP）
    • 支持配合 SakuraFrp、OpenFrp、自建 FRP、Tailscale、ZeroTier 或公网 IP；
    • 只需在设置中填入穿透地址，插件自动生成二维码并接管访问认证与多端协同。

3. 企业级安全防爆破

• 局域网与公网独立访问密码，支持自定义固定密码；
• 内置单 IP 防暴力破解防线：连续输错 5 次密码直接拉黑封禁该 IP 24 小时，杜绝公网扫描风险。

---

📦 安装与配置

1. 安装插件

在你的 DSH Profile 目录（如 ~/.dsh/profiles/desktop）下执行：

pnpm add dsh-anywhere
# 或直接引用本地包:
pnpm add E:/path/to/dsh-anywhere-1.0.0.tgz

2. 启用插件

在 settings.yaml 中配置启用：

plugins:
  dsh-anywhere:
    enabled: true

---

📱 搭配 DSH iOS App 使用指南

1. 局域网同屏模式（极速低延迟）：
   • 手机连上与电脑相同的 Wi-Fi；
   • 打开 DSH iOS App，地址输入：http://<电脑局域网IP>:3083（或直接扫码接入）。
2. 出门随身模式（公网无缝协同）：
   • 开启公网访问后，在 DSH iOS App 中输入公网地址；
   • 无论身在何处，均可随时随地与家里的 DSH 实时对话，随时接续电脑上的工作。

---

⚙️ 配置文件说明（~/.dsh/dsh-anywhere/settings.json）

插件首次运行会自动生成纯净的通用配置，不包含任何个人敏感链接：

字段	类型	默认值	说明
lanEnabled	boolean	true	是否开启局域网多设备访问
lanAuthEnabled	boolean	true	局域网访问是否需要密码验证
tunnelMode	string	"quick"	"quick"（自动隧道）/ "named"（CF固定域名）/ "fixed"（自定义公网直连）
tunnelHostname	string	""	named 模式下的完整自定义域名
tunnelToken	string	""	named 模式下的 Cloudflare Token
fixedWanUrl	string	""	fixed 模式下的自定义外部穿透地址（如 FRP）

---

📄 开源许可

MIT License