dsh-surrogate-guard
在终端中运行以下命令:
dsh plugin install fengxiforcy/dsh-surrogate-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install fengxiforcy/dsh-surrogate-guard,或将 https://github.com/fengxiforcy/dsh-surrogate-guard 加入 profile 的 dsh.profile.bundles 后重启生效。
插件介绍
在 DeepSeek Harness 里,read、grep、命令输出或联网抓取的结果有时会按字节或长度硬截断,把 emoji 从 UTF-16 代理对中间切开,只留下一个合法的「半字符」。它在 JavaScript 里不会立刻报错,JSON 序列化也会悄悄把它转成长转义串;可一旦这类内容写进会话历史,DeepSeek API 会在解析阶段失败,而且因为每轮都会重发完整历史,同一会话此后每一轮都会 400——重试、重启都救不了,只能手工改会话文件。
本插件 dsh-surrogate-guard 在内容进入会话日志之前,扫描工具决策与结果里常见的载荷字段,把落单的高位或低位代理统一替换成替换符 U+FFFD。改写是有损的,但只影响已经残缺的字符;没有命中时直接返回原引用,不额外分配。它与 dsh-text-guard 分工不同:后者针对区域指示符对(国旗 emoji)触发的合规风险,本插件针对截断产生的孤立代理和「unexpected end of hex escape」一类错误;症状都是会话永久 400,病因不同,需要一起装才能覆盖两种场景。
适合经常让 Agent 读大文件、跑 grep、拉取长输出,又遇到过工具结果被截断后会话突然「永久坏掉」的 Harness 用户。若你已在官方讨论里看到过 read 截断切开代理对、或工具结果截断导致无法继续对话的案例,这就是对应的事后防护层——根治截断仍依赖核心侧码点对齐,本插件负责在毒进历史之前把它中和掉。
使用场景
- read 或 grep 大段输出被行长度截断后,会话从此每轮 API 400
- 工具返回里 emoji 被切成半个代理,历史写入后无法继续对话
- 已与 dsh-text-guard 并用,仍遇到 unexpected end of hex escape
适合人员
- DeepSeek Harness 上频繁使用 read、grep、命令输出的 Agent 用户
- 遇到过工具截断后会话永久坏掉、只能改会话文件的人
- 希望在不改核心截断逻辑前,先挡住孤立代理进历史的使用者