dsh-context-governor：DeepSeek Harness 会话上下文与成本监控

前言¶

在 DeepSeek Harness (DSH) 中进行会话开发时，上下文窗口的边界和实际 token 成本往往是模糊的。开发者需要直观的上下文概览和成本估算，以便在压缩或重试前做出判断。dsh-context-governor 插件提供了会话级别的上下文芯片，实时展示提示词大小、缓存命中率和成本倍数。

插件定位¶

dsh-context-governor 是一个 DeepSeek Harness 插件，作为会话上下文指示器。它不生成内容，仅通过读取 DSH 的投影数据、计算并展示会话的关键指标。

核心功能¶

该插件提供以下数据展示：

1. 成本与尺寸

   • 提示词大小（未缓存输入 + 缓存 token）及估算的每步成本（USD）。
   • 相对于 base 的成本倍数（新鲜输入 = 1.0，缓存读取 = cacheReadRate/freshRate）。

2. 缓存与性能

   • 会话总计缓存命中百分比（部分命中不会向上取整为 100%）。
   • 每步冷输入（fresh tokens in the last request）。

3. 上下文压力与费率

   • 带指示器（0 = 正常，1 = 警告，2 = 高，3 = 严重）。
   • 压缩阈值（基于模型窗口计算）。
   • DeepSeek 余额（仅显示数字）。
   • 峰值/非峰值费率及切换倒计时。

安装与启用¶

通过包管理器安装：

dsh plugin --profile web add dsh-context-governor

本地开发或引用源码安装：

dsh plugin --profile web add github:mpinaev/dsh-context-governor

版本支持¶

插件对 DSH 版本有特定要求：

• 0.1.7-rc.2 … <0.2.0
• 0.2.0-rc.1 … <0.3.0

DSH 会自动禁用不支持当前运行版本的插件。

技术实现与限制¶

• 不消耗代币：插件不会向模型发起任何生成请求，也不会花费任何 token。它仅读取 ctx.sessionProjections 中的 token 使用数据。
• 数据来源：
  • Tokens 数据来自 tokenUsage 投影（uncachedInputTokens, cacheReadTokens 等）。
  • 上下文窗口和压力来自 contextPressure 投影。
• 不可变性：插件不修改历史记录、系统提示或前缀缓存。
• 网络使用：网络仅用于获取 DeepSeek 余额。
• 价格显示：价格仅在插件配置了该提供商的费率时显示（默认支持 DeepSeek）。

注意事项¶

• 仅在插件拥有费率数据时显示成本，其他提供商可能不显示价格相关数据。
• 这是一个客户端插件，需要 dsh web 启动并加载插件。

总结¶

dsh-context-governor 为 DSH 用户提供了无需调用模型即可监控会话上下文和成本的工具。它通过算术计算展示关键指标，帮助开发者管理上下文压力和预算。