dsh-web-remote

DSH（DeepSeek Harness）手机 / 外网远程访问插件。

用手机浏览器随时随地访问你电脑上的 DSH：

• 公网：Cloudflare Quick Tunnel（无需公网 IP、无需注册，cloudflared 缺失时自动下载）
• 局域网：HTTP + HTTPS 直连（HTTPS 使用自动生成的自签名证书，零配置）
• 安全：每次启动生成随机访问令牌；令牌校验通过后写入 HttpOnly Cookie；链接含令牌，请勿泄露
• 体验：侧边栏常驻手机图标（刷新不消失）→ 面板可切换「公网 / 局域网」、一键复制链接、扫码访问、启动 / 停止 / 刷新
• 加速：反向代理自动 gzip 压缩（加载大历史会话更快）
• QQ 通道：内置 OneBot 11 反向 WebSocket 服务（默认端口 3001），安装 NapCat 后向机器人发送「给我链接」即可获取访问地址

安装

本插件是一个标准 DSH bundle 包。两种方式任选：

方式一：GitHub 直接安装（当前推荐）

在 profile 目录（如 $DSH_HOME/profiles/web）执行：

pnpm add github:godchen520/dsh-web-remote --config.minimumReleaseAge=0

--config.minimumReleaseAge=0 用于绕过 pnpm 11 的新包发布年龄校验；若你的 pnpm 无此限制可省略。

然后把 dsh-web-remote 加入 profile package.json 的 dsh.profile.bundles 列表：

{
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-web-remote"]
    }
  }
}

然后重启 DSH。

方式二：npm 安装（包发布到 npm registry 后可用）

pnpm add dsh-web-remote

同样把它加进 dsh.profile.bundles 并重启。

方式三：手动 patch（不依赖 pnpm 安装）

把本包放入 profile 的 node_modules（或直接放在 profile 目录旁），然后在 profile 的 cordis.patch.yml 追加：

- insert:
    - id: web-remote
      name: 'dsh-web-remote'

bundle 方式修改后需要重启 DSH；cordis.patch.yml 方式会被 HMR 热加载。

配置

全部可选，不配置即开箱即用。在 profile 的 cordis.patch.yml 里覆盖：

- id: web-remote
  config:
    targetPort: 3080        # DSH 自身端口
    httpPortStart: 3081     # 局域网 HTTP 起始端口（自动跳过占用）
    httpsPortStart: 3082    # 局域网 HTTPS 起始端口
    qqPortStart: 3001       # QQ OneBot 桥起始端口
    cloudflaredPath: ''     # 指定 cloudflared 路径；留空自动探测 PATH / 自动下载
    pfxPath: ''             # 指定 PFX 证书；留空自动生成自签名证书
    pfxPass: ''             # PFX 密码
    toolsDir: ''            # 工具与证书缓存目录；留空使用 $DSH_HOME/tools
    autoStart: true         # 插件加载即自动启动

使用

1. 启动后，页面左下角出现手机图标（刷新不消失）
2. 点击图标 → 面板显示运行状态和链接：