DSH Remote 极速版(源自 rainow/ds-harness-remote-fast,本机中转快照;安全审查 PASS 2026-11-14)
Go to file
QQ 643716d0cd Import patches/0004-fork-docs-screenshots-and-CI-adjustments.patch 2026-11-18 08:19:55 +08:00
.github Import .github/release-notes.md 2026-11-17 08:24:08 +08:00
apps Import apps/vscode/tests/remote.test.ts 2026-11-17 08:38:44 +08:00
docs Remove docs/design/webrtc-control-recovery.md (renamed upstream to control-recovery.md) 2026-11-17 09:33:38 +08:00
examples/mock-host Import examples/mock-host/tsconfig.json 2026-11-14 14:42:30 +08:00
fixtures Import fixtures/protocol/v1/negotiation/capabilities.json 2026-11-14 14:43:33 +08:00
locale Import locale/uk.json 2026-11-17 08:42:10 +08:00
packages Import packages/plugin/tests/harness-remote-bridge.test.ts 2026-11-18 08:19:39 +08:00
patches Import patches/0004-fork-docs-screenshots-and-CI-adjustments.patch 2026-11-18 08:19:55 +08:00
scripts Import scripts/verify-packed-webrtc.mjs 2026-11-17 09:20:56 +08:00
.gitattributes Import .gitattributes 2026-11-14 14:07:36 +08:00
.gitignore Import .gitignore 2026-11-14 14:08:03 +08:00
.npmrc Import .npmrc 2026-11-14 14:08:08 +08:00
.zcodeignore Import .zcodeignore 2026-11-14 14:08:11 +08:00
AGENTS.md Import AGENTS.md 2026-11-17 08:24:17 +08:00
LICENSE Import LICENSE 2026-11-14 14:08:17 +08:00
README.ja.md Import README.ja.md 2026-11-17 08:24:21 +08:00
README.md Import README.md 2026-11-18 08:18:05 +08:00
README.zh.md Import README.zh.md 2026-11-17 08:24:27 +08:00
cordis.patch.yml Import cordis.patch.yml 2026-11-14 14:32:41 +08:00
dsh-plugin.json Import dsh-plugin.json 2026-11-18 08:18:08 +08:00
icon.png Import icon.png 2026-11-14 14:43:36 +08:00
index.js Import index.js 2026-11-14 14:43:41 +08:00
package.json Import package.json 2026-11-18 08:18:11 +08:00
pnpm-lock.yaml Import pnpm-lock.yaml 2026-11-17 09:20:20 +08:00
pnpm-workspace.yaml Import pnpm-workspace.yaml 2026-11-14 15:07:34 +08:00
tsconfig.base.json Import tsconfig.base.json 2026-11-14 15:08:08 +08:00

README.md

DeepSeek Harness Remote

DS Harness Remote · 极速分支(fork)

上游仓库  ·  上游 issue #299  ·  文档  ·  Web


这个 fork 是什么

上游 liguobao/ds-harness-remote 的速度优化分支,只加一件事: 尽量少地往远端塞数据,让连接更快、更稳,尤其是大会话(几百条记录 + 插件投影)在弱网/中继下的首屏。

除「极速模式」和一处后端探测的性能修正(见下)外,本分支与 upstream/main 完全一致,跟随上游 rebase。

最近修复(0.6.5-fast.3)

  • 远端看不到图片:远端客户端按图片路径回读工作区文件时,工作区内的绝对路径不再被误判成 outside-root(工作区外、URL 形式仍拒绝),失败日志也带上了实际请求路径;
  • 图片引用丢失:极速模式压缩历史时不再把图片 / 文件附件块压成文本;
  • 「极速模式 / 强制中继」合并成一组,最左侧加上「省流提速设置」标题;
  • 包内容校验:0.6.5-fast.2 的 npm 包里客户端入口误打成未打包的中间产物,Web 端会报插件加载失败;现在发布前会自动重建并校验 bundle,装错直接失败。

已跟上上游 0.6.5(含 host 端升级流程、ACP 后端错误归因等一批修复);极速模式不再裁掉会话状态更新——切换权限、提问 / 选择卡片都能即时到达远端。

为什么单独 fork

远端首屏的整条历史快照必须塞进一条 secure 消息(MAX_SECURE_MESSAGE_BYTES = 4 MB)。会话一大就超限,Host 直接抛 Oversized Harness Remote frame 并断开——上游 issue #299。

同一个会话里真正占体积的往往不是聊天正文,而是插件投影(dsh-context-lens 这类面板动辄 1–2 MB)和几百条历史记录,这些信息在远端大部分时候没必要传。

我们把修复做成了 Host 端开关(PR #311)。上游的取向是「Host 端开关越少越好,投影强度应该由发起方在协议里约定」——方向我们认同,但当下有几个改不了的发起方:

  • Remote Web(dsh.r2049.cn)是独立闭源前端
  • iOS 还在 TestFlight,未公开
  • DSH Go 是第三方 App(它内置本插件,但不会为这个功能单独加 UI)

在它们支持新参数之前,Host 端兜底是唯一能让大会话不断连的手段。所以 PR 先关掉,fork 自己维护;等上游真的落地 per-connection 参数(projection / maxRecords / maxBytes),这个开关会退化成「默认值」,那时再回归官方包。

极速模式开关在哪

Remote 弹窗里,「主机」这一行下面单独一行:极速模式 [?] [开关](右边紧挨着「强制中继」),默认打开,切换立即生效并持久化到 cordis.patch.yml。

远端也可以用自然语言让 host 改:插件注册了 agent 工具 remote_fast_mode,在对话里说「打开 ds-harness-remote-fast 插件的极速模式开关」即可(弹窗里的 ? 提示也写了这一句)。

强制中继(可选)

弹窗里「极速模式」右边还有一个**「强制中继」开关,默认关。打开后客户端不再尝试局域网 / 互联网直连 / TURN, 直接走加密中继,并让 Host 只向服务器上报 transport.relay:首次连接和断线重连都会明显更快(省掉 12 秒的直连协商超时)。 代价是这条路线的流量全部经过服务器,P2P 能打通时反而更慢,所以默认关闭。切换对新连接**生效,已建立的连接保持原传输方式。

极速模式实测(2026-11-06)

同一台 Host、同一部手机(DSH Go,transferFrames: true),把两个图片较多的会话各打开一次、历史各上滑两次,只在 ≥256 KB 的帧上打点(小帧不值得记录,所以"0 条"就是"没有超过 256 KB 的帧"):

场景 ≥256 KB 的帧 峰值帧 明细
极速模式 关 4 条,合计 3,284,911 B 1,439,894 B snapshot 1,262,357 / 1,439,894 B;baseline 291,330 B ×2
极速模式 开 0 条 < 262,144 B 两个会话连一条 ≥256 KB 的帧都没有产生

也就是说,这两个会话首屏最大的那一帧从 1.44 MB 降到 256 KB 以内(降幅约 82%),而且不再有 291 KB 的 baseline 投影帧。

为什么降这么多:省下来的几乎全是记录条数(首屏几百条的整页 → 10 条);工具详情压缩只是小头。插件投影(dsh-context-lens 这类)在 baseline 里通常是大头,被「单项 16 KB 上限 / 单帧 256 KB 总量预算」挡掉。

它不省什么:对话过程中的增量帧、心跳/信令、Host 侧的 CPU 与磁盘(快照照旧生成,只在出站前裁剪)。

顺带的性能修正:Host 每次读设置都会同步 spawn which 去探测 ACP 后端(实测 6 次约 21 ms,最坏会卡到 5 s 超时)。现在探测改成了异步 execFile,并加 30 秒 TTL 缓存,不再阻塞事件循环。

跟随上游

git remote add upstream https://github.com/liguobao/ds-harness-remote.git
bash scripts/sync-upstream.sh    # 自动 fetch、重放 patches/、重建 dist、跑测试

上游推进很快,本分支把自身改动压成 patches/ 里的三个补丁,同步时重放而不是整段 merge;dist/ 是构建产物,由脚本重新生成后提交。

许可与致谢

代码来自 liguobao/ds-harness-remote,遵循其原许可。本分支只改「极速模式」相关逻辑和一处后端探测的性能修正,问题请先看上游 issue;确实与本分支有关再来这边提。

npm

dsh plugin --profile web add ds-harness-remote-fast

包名 ds-harness-remote-fast(不是上游的 ds-harness-remote),安装不会覆盖上游的 npm 包;cordis.patch.yml 里的 entry id 仍是 ds-harness-remote,你已有的 liteMode 等配置不会丢。同一个 profile 里只启用其中一个。 本仓库刻意不带 dsh-plugin 关键词,因此不会出现在插件市场里,也就不会被市场更新覆盖。