ds-harness-remote-fast/packages/plugin
QQ c8f5cc9e4d Import packages/plugin/tests/workspace-upload-authority.test.ts 2026-11-14 15:03:38 +08:00
..
bin Import packages/plugin/bin/ds-harness-remote-fast.js 2026-11-14 14:45:30 +08:00
dist Import packages/plugin/dist/client.github.js 2026-11-14 14:46:10 +08:00
locale Import packages/plugin/locale/zh.json 2026-11-14 14:49:40 +08:00
scripts Import packages/plugin/scripts/webrtc-validate.mjs 2026-11-14 14:49:54 +08:00
src Import packages/plugin/src/workspace-upload.ts 2026-11-14 14:58:40 +08:00
tests Import packages/plugin/tests/workspace-upload-authority.test.ts 2026-11-14 15:03:38 +08:00
LICENSE Import packages/plugin/LICENSE 2026-11-14 14:45:26 +08:00
README.md Import packages/plugin/README.md 2026-11-14 14:45:28 +08:00
cordis.patch.yml Import packages/plugin/cordis.patch.yml 2026-11-14 14:45:33 +08:00
dsh-plugin.json Import packages/plugin/dsh-plugin.json 2026-11-14 14:49:09 +08:00
icon.png Import packages/plugin/icon.png 2026-11-14 14:49:15 +08:00
package.json Import packages/plugin/package.json 2026-11-14 14:49:43 +08:00
public.d.ts Import packages/plugin/public.d.ts 2026-11-14 14:49:46 +08:00

README.md

ds-harness-remote-fast

DeepSeek Harness Remote 的极速分支(fork) —— 只做一件事:尽量少地往远端发数据,让大会话的远程连接不再因为帧超限而断掉,也更快。

上游项目:liguobao/ds-harness-remote 本 fork:rainow/ds-harness-remote-fast(lite 分支) 与本 fork 同步的完整说明:README

为什么有这个包

远端首屏的整条历史快照必须塞进一条 secure 消息(4 MB 上限)。大会话一超限,Host 就抛 Oversized Harness Remote frame 并断开(上游 issue #299)。真正占体积的往往不是聊天正文,而是插件投影(dsh-context-lens 这类面板动辄 1–2 MB)和几百条历史记录。

修复曾以 PR #311 提交给上游;上游的取向是「Host 端开关越少越好、投影强度由发起方在协议里约定」。方向没问题,但 Remote Web、iOS(TestFlight)、DSH Go 这些发起方改不了或改得慢,在它们支持新参数之前,Host 端兜底是唯一能让大会话不断连的手段。所以以独立包名发布、自己维护。

极速模式(默认开启)

Remote 弹窗里的极速模式开关

在 Remote 弹窗里就排在「允许控制本机」后面,默认打开;也可以在插件设置里关掉。关闭后行为与上游完全一致。

远端还能用自然语言让 host 改:插件注册了 agent 工具 remote_fast_mode,在对话里说「打开 ds-harness-remote-fast 插件的极速模式开关」即可。

开启后:

  • 首屏历史只发最近 10 条(hasMore: true,可往回翻)
  • 工具详情压缩:单条长文本 ≤512 字符,工具 input/output 折叠
  • 投影预算:单个投影 >16 KB 丢弃,单帧投影总量 ≤256 KB;标题 / 模型 / 权限 / 会话列表元数据 / 图片限制始终保留
  • 单帧超限时先裁剪再发送,而不是直接断连
  • 存储与 agent 上下文完全不动,只影响出站数据;协议与客户端未改

同一台 Host、同一部手机(DSH Go,transferFrames: true)实测两个图片较多的会话:极速模式关闭时首屏有 4 条 ≥256 KB 的帧(峰值 1.44 MB),开启后一条都没有(全部 <256 KB)。逐帧明细见仓库 README。

最近修复(0.6.4-fast.4)

上一版的极速模式会连带裁掉一部分会话状态更新,导致:远端切换权限后 Host 已生效但界面不变;提问 / 选择卡片有时到不了远端。

现在这类消息一律不参与裁剪,只有体积大且纯展示的数据(如上下文面板)才会被省略。web 与安卓两端均已实测。

安装

dsh plugin --profile web add ds-harness-remote-fast
  • 包名是 ds-harness-remote-fast(上游占用 ds-harness-remote),安装不会覆盖上游的 npm 包;同一 profile 里只启用其中一个
  • cordis.patch.yml 里的 entry id 仍是 ds-harness-remote,已有配置(liteMode / serverUrl / role …)迁移后不丢
  • 本包不带 dsh-plugin 关键词,因此不会出现在插件市场里,也不会被市场更新覆盖(这是刻意的:市场只会拉到上游版本)

除了「极速模式」,弹窗里还有一个**「强制中继」**开关(默认关):跳过局域网 / 互联网直连 / TURN 探测,直接走中继, 首次连接和断线重连会明显更快(省掉 12 秒的直连超时),代价是所有流量都经过服务器。两份配置互不影响。

配置项只有一个:

配置 默认 说明
liteMode true 极速模式;false 时与上游行为完全一致,切换立即生效

与上游的差异

除极速模式相关逻辑和一处后端探测的性能修正(同步 which 改为异步 execFile + 30 秒 TTL 缓存)外,本包与 upstream/main 保持一致,跟随上游 rebase。协议、客户端行为、数据面均未改变。

反馈

与极速模式相关的问题请提到 本 fork 的 issues;与协议层、其它客户端相关的问题请提到上游。