dsh-thinking-channel-guard
Manifest validMoves reasoning that a provider leaks into the visible text channel back into the reasoning channel, and emits a text block when a whole turn of answer text lands only in the reasoning channel. Catche
dsh-thinking-channel-guard
面向 DeepSeek Harness 的通道修复插件:把漏进正文的思考收回思考通道,把整段写进思考里的回答显示为答复。
思考与回答错位不是渲染问题。DSH 只按 provider 上报的 blockType 决定一段内容进"回答"还是进"思考"区,因此 provider 送错通道时,错的内容会原样入库、原样回放、原样显示。本插件挂在 llm/stream 瀑布最外层,改的是流里的通道标记,所以界面、会话记录和之后每一次 replay 看到的是同一份修好的数据。
状态:
v1.3.0,本机回放 83 个会话 / 8,077 条已记录助手消息,修复 77 条、0 次块重排、其余逐字节一致。
它修的三类问题
| # | 现象 | 判据 |
|---|---|---|
| 1 | 整段思考出现在回答区,通常以 <thinking> 之类标记开头 | 正文块以思考标记 / ```thinking 围栏开头 |
| 2 | 思考写到一半被掐断,同一句话在回答区接着写,没有任何标记 | 上一块是 reasoning 且以非句末标点收尾,本正文块以不能起句的标点开头(`、,、)、"…) |
| 3 | 回答整段写进思考区,折叠后看不到 | 以 stop 收尾、无正文、无工具调用,且思考正文 ≥ 40 字 |
第 2 类是真实案例里最隐蔽的一种:模型把 reasoning 通道关掉,把剩下的思考当正文继续输出,日志里只有两个块紧挨着,标点位置是唯一线索。
规则
| 规则 | 默认 | 作用 |
|---|---|---|
tagRouting | 开 | 以思考标记开头的正文块整块改发为 reasoning |
continuationRouting | 开 | 接着上一段思考往下写的正文块整块改发为 reasoning(句末悬空在中英断句处、或正文以小写英文词起头续写) |
deliberationRouting | 开 | 中段紧跟工具调用、拉丁字母占比 ≥50%、≥200 字、整段推敲口气的正文块改发为 reasoning;纯英文块要求中文会话,混排(英文思考里引中文原文)只要出现 ≥2 处推敲措辞即可,不依赖会话语言 |
stripTags | 开 | 只对刚被改判的块去掉标记;可见正文永不改写,哪怕正文里正在引用 <thinking> 字样 |
answerRescue | 开 | 回答整段留在思考通道时补发一份正文;思考行保留原文,回答不会丢 |
健康流量逐字节转发:不重排块、不动原生 reasoning、不改正文、不合成新块。判定时最多暂扣一个正文块的前若干字节;block-start 的落定被严格限制在本块增量内完成,任何属于其它块、usage 或 finish 的 chunk 到来前必须先落定,因此块顺序与 provider 产出一致。
修复过的流会丢弃适配器的 replayState:那份元数据按 provider 原始块索引对齐,块被搬动后不再匹配。Harness 本就把它当"降级回放"处理(思考重放时不带签名),不是错误。
安装
插件市场(本机 profile):
github:laoyingfuhuole/dsh-thinking-channel-guard
默认跟随 main;要固定版本就加 tag,例如 #v1.1.0。
或用插件管理器指向工作区目录(开发时):
plugin_manager({ action: "install_bundle", target: "/path/to/dsh-thinking-channel-guard" })
安装后在「插件」页应出现 思考通道纠偏;~/.dsh/thinking-channel-guard.log 里出现一条 guardVersion 记录即表示已加载。卸载/重装会重载插件模块;宿主里已经打开的旧会话要等它下次启动才换新模块。
配置
$DSH_HOME/thinking-channel-guard.json,改完自动生效(按 mtime + size 重读):
{
"version": 1,
"rules": {
"tagRouting": true,
"continuationRouting": true,
"deliberationRouting": true,
"stripTags": true,
"answerRescue": true
},
"dryRun": false,
"trace": false,
"sessions": { "session-xxxx": { "tagRouting": false } }
}
dryRun:只记录"本来会修什么",原样转发,用来在不改变输出的前提下观察。trace:每次模型调用都写一行日志,用来确认插件确实在跑(默认关闭,只在真正修复时写)。sessions[sessionId]:按会话覆盖rules里的任意键,外加dryRun/trace。
日志
$DSH_HOME/thinking-channel-guard.log,JSON Lines,追加写,超过 4 MiB 停止追加:
{"guardVersion":"1.0.0","time":"…","sessionId":"session-…","provider":"hc-kimi","model":"kimi-k3.1-pro","dryRun":false,"blocks":4,"repairs":[{"kind":"reasoning-in-text-channel","index":0,"bytes":16}]}
repairs[].kind 取值:reasoning-in-text-channel、reasoning-continuation、answer-rescue、markup-stripped。
证据
node --test:34 个用例,覆盖真实漏例(Kimi 标记两例、本会话中途翻转一例、feishu 小写续写两例、英文推敲三例)、合法过程叙述对照两例、含中文长正文对照一例、英文会话对照一例、健康 DeepSeek 轮次逐字节透传、仅工具调用轮次逐字节透传、五条规则的开关与边界、dryRun、流中断、未知 chunk 类型。- 全库回放:
node scripts/audit.mjs <已解压的会话目录>(需本机会话库):7,827 条消息里修复 73 条(64 条标记改道 + 3 条无标记续写 + 6 条英文推敲),0 次块重排,其余逐字节一致。 - 发布物校验:
npm run check:integrity对照integrity.json校验每个发布文件;CI 在 Node 22 / 24 上跑测试 + 校验 +npm pack --dry-run。
限制
- provider 完全不写标记、句子又自洽的泄漏无法判定(实测回放里 0 例;这类只能靠 provider 侧修)。
- 被搬动的块会以"思考"身份进入 provider 历史。若某 provider 在 replay 时拒收外来 thinking 块,请对该 provider / 会话关掉
tagRouting。 - 安装前的历史消息不会被追溯修改;只对之后新产生的流生效。
开发
node --test # 34 个用例
npm run integrity # 重新生成 integrity.json
npm run check # 测试 + 完整性校验
npm pack --dry-run # 查看发布物
目录:index.js(插件入口、配置与日志)、lib/guard.js(流修复算法)、test/(用例与真实样本)、scripts/integrity.mjs(发布物哈希)、cordis.patch.yml(bundle 插入行)。
English
A DeepSeek Harness plugin that repairs channel mix-ups at the llm/stream
waterfall: reasoning that a provider delivers as ordinary text (with or
without <thinking> markup, including a flip that splits one sentence across
channels) goes back to the reasoning channel, and an answer that arrived as a
single reasoning block is additionally surfaced as the reply. Healthy traffic
is forwarded byte-for-byte; block order, native reasoning and visible prose are
never rewritten. Configuration and repair log live under $DSH_HOME. MIT.
许可
MIT。DeepSeek Harness 及其商标归其权利人所有;本项目为独立第三方插件,与官方无关。
Versions
| Latest version | Published | Size |
|---|---|---|
| 1.1.0 | — | — |
Comments
Loading…
Similar plugins
Keeps one reasoning-only turn from making an entire session unusable. When a turn produces no visible text and no tool call, the assistant message is persisted empty, the gateway then rejects every la
★ 0
dsh plugin --profile web add dsh-reasoning-only-guardby himi-li
Detects verbatim reasoning loops in DSH LLM streams and cuts them early. Zero-dependency Cordis plugin with a fire journal and a reasoning_loop_log tool.
★ 2
MIT
JavaScript
Oct 18, 2026
dsh plugin --profile web add dsh-reasoning-loop-guardby XiaoSHang05
A passive watchdog for DeepSeek Harness: watches a turn's thinking and text streams and cancels it when the model starts repeating itself.
★ 0
MIT
JavaScript
Oct 27, 2026
dsh plugin --profile web add dsh-rice-guardby XiaoSHang05
A passive watchdog for DeepSeek Harness: watches a turn's thinking and text streams and cancels it when the model starts repeating itself.
★ 0
MIT
JavaScript
Oct 14, 2026
dsh plugin --profile web add dsh-loop-guardby lyc0110
Guardrail for DSH llm/stream: detects when model reasoning or text degenerates into a periodic repetition loop and aborts the request instead of streaming until you give up.
★ 0
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-loop-guardby ADistanceThereIs
DSH guard against self-repetition in streamed model output: detects a degeneration loop in reasoning or visible text, aborts the runaway turn and wakes the agent with a corrective notice.
★ 0
MIT
JavaScript
Oct 16, 2026
dsh plugin --profile web add dsh-output-loop-guard