前言¶

在 DeepSeek Harness (DSH) 的开发或使用过程中，一个常见的问题是判断当前上下文是否已经接近窗口上限，或者是否应该结束当前会话开启新会话。这种判断通常依赖经验，缺乏量化依据。

dsh-context-compass 插件旨在解决这一问题。它通过收集 DSH 内部的真实运行数据，为开发者提供一个基于事实的“继续 vs 新开”决策罗盘。

插件介绍¶

dsh-context-compass 是 DeepSeek Harness 的一个会话健康插件，由 NinjaSln-labs 维护。它不依赖估算，而是直接读取 Harness 的 sessionHealth 投影、tokenMeter、fs 探测以及 Git 状态等真实数据，帮助用户判断当前会话的健康状态。

核心功能¶

头部徽章¶

插件会在会话日志按钮旁显示一个响应式的头部徽章。徽章的颜色由 sessionHealth 投影驱动，反映了当前的上下文压力。

悬停徽章会显示详细信息：
* 占用趋势：最近 ≤40 次请求的压力采样迷你折线图。
* 成本与缓存：每轮 token 成本、缓存命中率（上下文稳定度的表现）。
* 压缩信息：压缩次数、上次压缩比例（按快照口径推断）。
* 计费预期：显示 CNY 或 USD，并标注忙时价/闲时价。

/compass 命令¶

输入 /compass 可查看完整的文本报告。该命令支持多种变体：

• /compass：全部探测（默认关闭进程探测）。
• /compass minimal：仅核心指标（token / 窗口 / 规模）。
• /compass no-git / /compass no-handoff：跳过 Git 或交接文档探测。
• /compass doc=<文件名>：检查指定的交接文档。
• /compass remaining=<轮数>：根据剩余轮数预估费用。
• /compass processes：强制开启进程探测。

context_compass 工具¶

这是一个模型可调用的只读评估工具，适用于长任务自查。它会返回结构化结论，包括 severity（严重程度）、recommendation（建议）、signals（信号）、cost（成本）和 handoffReady（交接就绪状态）。

多会话罗盘一览面板¶

在侧栏底部“设置”旁点击“罗盘一览”按钮，可打开全屏面板。该面板列出所有会话的健康判定，按运行状态排序。状态列包含三态：运行中、已加载、冷却。点击行可打开对应会话并运行 /compass。

判定模型¶

插件采用二维“继续 vs 切换”模型，参数可在配置中调整。默认档位如下：

• 绿：窗口占比 < 30%，每轮计费当量 < 50K。建议放心继续。
• 蓝：占比 30–50%，或消息数 ≥ 800。建议继续，留意窗口。
• 黄：占比 ≥ 50%，或每轮计费当量 ≥ max(50K, 30% × 窗口)。建议在下一个任务边界收尾。
• 红：占比 ≥ 80%。建议尽快收尾并交接。

经济成本（每轮计费当量）优先于容量（窗口占比）。

安装与启用¶

安装命令如下：

dsh plugin add dsh-context-compass

安装后，插件会自动注册 sessionHealth 投影和 /compass 命令。

配置¶

插件支持通过配置文件或浏览器配置卡片进行调节。关键配置项包括：

• thresholds：判定模型参数（窗口占比、经济门槛、消息数代理指标）。
• checks：探测开关（Git、交接文档、进程探测等）。
• cost：计费相关配置（缓存折扣、价格源、刷新时间）。

其中 projection.enabled 控制徽章显示，thresholds 和 checks 的改动通常即时生效，无需重启。

价格与计费¶

插件内置了 DeepSeek 官方定价文档的解析逻辑。金额显示支持 CNY 和 USD 双币种，并区分忙时价和闲时价（按北京时间判定）。

数据源为官方定价文档，支持自动刷新（默认 24 小时）和回退机制。首次加载前或配置为 static 时，会使用兜底的静态价格。

生态与注意¶

• 知识库联动：插件解耦了知识库依赖，仅当检测到知识库插件（如 dsh-knowledge-sqlite）时，才会进行跨会话回顾的探测。
• 本地持久化：仅本机 loopback 部署支持本地写持久化。
• 权限：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。

总结¶

dsh-context-compass 通过将上下文管理从经验主义推向数据驱动，帮助开发者更精准地控制会话生命周期。