dsh-stream-index-guard
在终端中运行以下命令:
dsh plugin install r-ayin/dsh-stream-index-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install r-ayin/dsh-stream-index-guard,或在插件市场安装;源码见 https://github.com/r-ayin/dsh-stream-index-guard。
插件介绍
在使用 DSH 大模型助手时,部分上游中继会在流式输出里带上非法的 chunk 索引。一旦 AssistantStreamAccumulator 收到这样的 text-delta、reasoning-delta 或 tool-call-delta,整轮对话可能直接报错中断,表现为会话卡住或输出被截断,而问题往往只出在单个坏包上。
本插件在应用阶段定位宿主已加载的 @deepseek-ai/dsh-llm 模块,在运行时修补 AssistantStreamAccumulator.push:把越界的索引钳制到最后一个合法位置(或 0),把原本的硬失败降级为丢弃或合并异常块。通过 Symbol 标记保证重复应用不会叠加补丁;也可用 DSH_STREAM_GUARD_TARGETS 指定要修补的模块文件。
同时注册 stream_index_guard_stats 工具,汇总补丁目标、被钳制的 chunk 数量与样本,并将状态写入磁盘,便于确认中继是否频繁触发索引异常。
适合依赖第三方或自建 LLM 中继、又希望助手流在偶发协议瑕疵下仍能走完一轮的用户;若你只使用稳定官方通道且从未遇到流索引错误,可以不必安装。
使用场景
- 上游中继偶发非法 chunk 索引导致整轮对话失败
- 助手流在 text/reasoning/tool-call delta 处卡住或截断
- 需要统计被钳制的异常块以排查中继质量
适合人员
- 使用第三方或自建 LLM 中继的 DSH 用户
- 遇到过流式索引错误导致会话中断的开发者
- 希望在坏包下仍能完成一轮助手对话的运维者