65 lines
4.5 KiB
Markdown
65 lines
4.5 KiB
Markdown
# 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 弹窗里就排在「允许控制本机」后面,**默认打开**;也可以在插件设置里关掉。关闭后行为与上游完全一致。
|
||
|
||
远端还能用自然语言让 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);与协议层、其它客户端相关的问题请提到上游。
|