前言¶

DeepSeek Harness（DSH）默认在本机 Web 端口提供服务，手机或另一台电脑要连进来，常见做法是改端口转发、自建反向代理，或单独配 Cloudflare Tunnel。每一步都要自己管 cloudflared、域名和 HTTPS，还要处理浏览器对 Host、Origin、WebSocket 的限制，移动端往往和本机用的不是同一套地址。

下面介绍社区插件 dsh-public-edge（维护者 ArtificialAngels，分类：联网工具）。它在 DSH 设置里提供「公网访问」面板：一键启停 Cloudflare quick tunnel，复制带 token 的公网链接与二维码；同时内置局域网桥，让局域网设备与公网入口走同一套转发逻辑。插件以 MIT 许可发布，当前资料中的版本号为 0.2.1，未发布到 npm，需从 GitHub 安装。

这是什么¶

dsh-public-edge 是 DSH 的 host 插件：启动后在本机监听可配置的桥端口（默认 8787），把流量转到 DSH Web 服务，并可选拉起 cloudflared 做免账号、免域名的 trycloudflare.com 快速隧道。控制面通过 DSH 已鉴权的 /api 通道，设置页 UI 挂在 头像菜单 → 设置 → 公网访问。cloudflared 缺失时会自动下载到 ~/.dsh/dsh-public-edge/；GitHub 直连失败时可按配置尝试镜像前缀。

核心功能¶

一键启停与公网链接¶

在设置 → 公网访问 → 启动 后，插件运行 Cloudflare quick tunnel（HTTPS 由 Cloudflare 终结）。面板展示形如 https://<随机>.trycloudflare.com/?token=… 的链接，支持一键复制；隧道重连域名变化时可用 换地址 刷新。不用时点 停止 即可。

二维码与本机配对页¶

面板内可展示二维码；也可在本机浏览器打开 http://127.0.0.1:8788/pair（仅允许本机访问）扫码。首次通过带 token 的链接打开后，浏览器会获得 cookie（资料说明有效期 30 天），之后访问裸隧道地址也可进入。

局域网桥¶

桥默认监听 0.0.0.0:8787，转发到 DSH 本机 Web 端口，并自动改写 Host、剥掉 Origin / Sec-Fetch-*、透传 WebSocket，便于手机与 PC 在局域网内使用同一入口。经桥访问的 /pair 返回 404，token 配对页只在本机回环端口提供；经隧道的响应会补 Secure cookie 与 HSTS。

工具链与安全边界¶

未指定 cloudflaredPath 时插件自动下载二进制（首次启动约 55 MB，视网络约 1–5 分钟，面板可显示进度或错误）。链接中的 token 等同 DSH 进程令牌，具有本机 DSH 的控制能力；公网入口认证依赖该 token，无额外密码层。Cloudflare 作为 TLS 终点，流量在 Cloudflare 侧为明文；quick tunnel 无 SLA、域名随机。需要固定域名或 Cloudflare Access 等能力时，需自行用 Cloudflare 账号做 named tunnel，本插件不包含该部分。

安装与启用¶

本插件没有发布到 npm，插件市场内可能搜不到名称，应使用仓库地址安装。装完后需完全退出 DSH 再打开（host 插件在启动时加载）。

仓库地址（复制这一条）：

https://github.com/ArtificialAngels/dsh-public-edge

方式 A：插件页粘贴地址（推荐）¶

1. 打开 DSH → 左侧 插件 → 右上 添加插件；
2. 将上述仓库地址粘贴到输入框（支持包名、GitHub 仓库地址或本地目录路径）；
3. 点 安装；
4. 完全退出 DSH 再打开。

方式 B：命令行¶

dsh plugin 会把参数转发给 profile 里的 pnpm：

# Windows / DSH-Portable
E:\DSH-Portable\dsh.exe plugin --profile web add https://github.com/ArtificialAngels/dsh-public-edge

# 固定版本（推荐，避免跟着 main 走）
E:\DSH-Portable\dsh.exe plugin --profile web add github:ArtificialAngels/dsh-public-edge#v0.2.1

非 Portable 安装时，将可执行文件换成本机的 dsh，--profile 按实际 profile 名（默认 web）。

方式 C：本地 tgz¶

从 Release 下载 dsh-public-edge-0.2.1.tgz（https://github.com/ArtificialAngels/dsh-public-edge/releases/tag/v0.2.1），在插件页粘贴本地路径，或：

E:\DSH-Portable\dsh.exe plugin --profile web add file:E:/path/to/dsh-public-edge-0.2.1.tgz

方式 D：手动写 profile¶

在 <DSH_HOME>\profiles\web 下执行 pnpm add https://github.com/ArtificialAngels/dsh-public-edge，并把 "dsh-public-edge" 加入同目录 package.json 的 dsh.profile.bundles 数组，重启 DSH。

启用：重启后在 设置 → 公网访问 点「启动」。验证可查看 profile 内 node_modules\dsh-public-edge\package.json 的版本，或在 dsh.stdout.log 中搜索 [public-edge] tunnel url:。

典型用法¶

1. 打开 DSH → 头像 → 设置 → 公网访问 → 启动，待状态为「运行中」，记录面板上的隧道地址与带 token 的链接。
2. 点 复制链接，在手机浏览器打开；或本机访问 http://127.0.0.1:8788/pair 扫码。
3. 首次带 token 访问成功后，可依赖 cookie 在短期内直接打开裸地址；域名变更时使用 换地址。
4. 不用公网时点 停止；若 token 可能泄露，重启 DSH（token 换新）并 换地址。

资料注明：手机端「Helm·DSH」一类 App 目前只认 主机:端口 的局域网地址，公网访问请用浏览器。

配置¶

默认一般无需修改。在 profile 的 cordis.patch.yml 中按 id 覆盖：

- id: public-edge
  config:
    port: 8787                # 桥端口（局域网访问端口 = 它）
    autoStart: true           # DSH 启动时自动开隧道
    cloudflaredPath: ""       # 留空 = 自动；也可指定已有的 cloudflared 可执行文件
    downloadMirrors:          # cloudflared 下载镜像前缀，按顺序尝试（"" = GitHub 直连）
      - ""
      - "https://gh-proxy.com/"
      - "https://ghfast.top/"

适用场景与注意¶

适合需要在不自备域名的情况下，临时把本机 DSH 暴露为 HTTPS 公网入口，并同时让局域网设备走统一桥接的场景。插件与 DSH 同进程权限运行，安装前应阅读 GitHub 仓库 源码与 MIT 许可证，自行评估 token 泄露与 Cloudflare 可见性的风险。桥监听 0.0.0.0 时，Windows 可能弹出防火墙提示；局域网仅在有需要时启动亦可。

卸载示例：

E:\DSH-Portable\dsh.exe plugin --profile web remove dsh-public-edge

重启 DSH；可选删除 ~/.dsh/dsh-public-edge/ 下已下载的 cloudflared。

结尾¶

dsh-public-edge 把 Cloudflare quick tunnel、带 token 的链接/二维码与局域网桥收进 DSH 设置页，减少自建隧道与头字段处理的重复劳动。社区目录页：SkillHub · dsh-public-edge；源码与完整说明：GitHub · ArtificialAngels/dsh-public-edge。