From 1e957e45b5c8e25c8b31a25fc14481c23549c4e2 Mon Sep 17 00:00:00 2001 From: QQ Date: Sat, 14 Nov 2026 14:45:28 +0800 Subject: [PATCH] Import packages/plugin/README.md --- packages/plugin/README.md | 64 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 packages/plugin/README.md diff --git a/packages/plugin/README.md b/packages/plugin/README.md new file mode 100644 index 0000000..e7aa469 --- /dev/null +++ b/packages/plugin/README.md @@ -0,0 +1,64 @@ +# ds-harness-remote-fast + +**DeepSeek Harness Remote 的极速分支(fork)** —— 只做一件事:**尽量少地往远端发数据**,让大会话的远程连接不再因为帧超限而断掉,也更快。 + +> 上游项目:[liguobao/ds-harness-remote](https://github.com/liguobao/ds-harness-remote) +> 本 fork:[rainow/ds-harness-remote-fast](https://github.com/rainow/ds-harness-remote-fast)(`lite` 分支) +> 与本 fork 同步的完整说明:[README](https://github.com/rainow/ds-harness-remote-fast/blob/lite/README.md) + +## 为什么有这个包 + +远端首屏的整条历史快照必须塞进一条 secure 消息(4 MB 上限)。大会话一超限,Host 就抛 `Oversized Harness Remote frame` 并断开(上游 issue [#299](https://github.com/liguobao/ds-harness-remote/issues/299))。真正占体积的往往不是聊天正文,而是插件投影(`dsh-context-lens` 这类面板动辄 1–2 MB)和几百条历史记录。 + +修复曾以 [PR #311](https://github.com/liguobao/ds-harness-remote/pull/311) 提交给上游;上游的取向是「Host 端开关越少越好、投影强度由发起方在协议里约定」。方向没问题,但 Remote Web、iOS(TestFlight)、DSH Go 这些发起方改不了或改得慢,在它们支持新参数之前,Host 端兜底是唯一能让大会话不断连的手段。所以以独立包名发布、自己维护。 + +## 极速模式(默认开启) + +![Remote 弹窗里的极速模式开关](https://raw.githubusercontent.com/rainow/ds-harness-remote-fast/lite/docs/fast-mode.png) + +在 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](https://github.com/rainow/ds-harness-remote-fast/blob/lite/README.md)。 + +## 最近修复(0.6.4-fast.4) + +上一版的极速模式会连带裁掉一部分**会话状态更新**,导致:远端切换权限后 Host 已生效但界面不变;提问 / 选择卡片有时到不了远端。 + +现在这类消息一律不参与裁剪,只有体积大且纯展示的数据(如上下文面板)才会被省略。web 与安卓两端均已实测。 + +## 安装 + +```bash +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](https://github.com/rainow/ds-harness-remote-fast/issues);与协议层、其它客户端相关的问题请提到上游。