DSH Plugins
返回列表
🧠

dsh-usage-guard

记忆 更新于 2026.08.25

在终端中运行以下命令:

dsh plugin install GooDAnDReaDY/dsh-usage-guard

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install GooDAnDReaDY/dsh-usage-guard 安装该插件(源码地址:https://github.com/GooDAnDReaDY/dsh-usage-guard),安装后重启 Web UI 即可生效并恢复已锁定会话。

插件介绍

DeepSeek Harness 的会话回放会逐条重放事件日志并累积 token 计数,而核心仅对 cache 字段做了 ?? 0 保护,inputTokens 和 outputTokens 直接参与裸运算。一旦上游 provider、本地推理服务或代理网关返回 NaN、负数、字符串甚至缺失字段,整个累计值瞬间被污染,schema 校验拒绝整段摘要,会话历史从此永久打不开,且因为回放是动态重算的,损坏不可逆。

dsh-usage-guard 在投影折叠点做运行时拦截,不修改磁盘上的任何日志文件。它内置覆盖 OpenAI、Google Gemini、Ollama 等数十种 vendor 别名字典,先尝试借用合法值,再通过 typeof number、Number.isFinite、>= 0 三重校验过滤 NaN、Infinity、负数和字符串化数字,未命中的计数器安全回退为零。对已注册和延迟绑定的投影均做 this 上下文完整的包装,附带去重诊断日志并设缓存上限,零额外性能开销。插件安装后重启 Web UI,所有此前被锁死的会话立即恢复可读。

适合使用非标准上游、混合多路由、本地 Ollama 推理或经过自定义代理网关的 DeepSeek Harness 用户。只需一条 install 命令加上一次重启,即可在不动日志的前提下彻底杜绝 token 污染导致的会话砖化。

使用场景

  • 上游返回 NaN 或负数导致 token 累计值污染后无法打开历史会话
  • 使用 Ollama、Gemini 等非标准 provider 时 token 字段名不一致引发统计崩溃
  • 多路由或自定义代理网关偶发返回缺失字段,需安全回退为零
  • session 投影注册顺序不确定时需要对延迟绑定的投影同样施加保护

适合人员

  • 使用非标准上游或混合多路由的 DeepSeek Harness 用户
  • 曾遭遇会话历史永久锁死、无法回放的 DeepSeek 运维者
  • 通过自定义代理网关或本地推理服务接入的开发者