NinjaSln-labs/dsh-context-compass0

dsh-context-compass

Session health for DeepSeek Harness: real token-meter data, configurable continue-vs-new decision model. Reactive header badge (compaction-aware), /compass command, context_compass tool.

包名
dsh-context-compass
版本
0.11.4
许可证
MIT
最近更新
2026年9月2日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:NinjaSln-labs/dsh-context-compass

配置

live 生效(v0.10.0):插件注册 settings 命名空间 context-compass——宿主设置体系(ctx.settings)挂载时,thresholds / checks / cost 显示项改动即时生效(badge 下一帧、下次 /compass 即用新值),无需重启;projection.enabled 切换亦 live。仅 cost.priceSource / priceUrl / priceFallbackUrl / priceRefreshHours 四项(价格刷新 wiring)需重启。无 settings 服务的部署回退组合入口配置,行为不变。

// thresholds: 判定模型参数
thresholds: {
  windowMid: 0.3, windowHigh: 0.5, windowCritical: 0.8,   // 窗口占比档位
  economyTokenFloor: 50000, economyWindowRatio: 0.3,      // 经济维度(计费当量 ≥ max(50K, 30%×窗口) 才黄)
  economyRoundFloor: 10,                                  // 剩余轮数阈值:工具/命令带剩余 ≥10 轮时经济档升级
  messageCountProxy: 800,                                  // 上下文膨胀代理指标(随窗口缩放:max(800, 0.2%×窗口))
  messageCountWindowRatio: 0.002,                          // 代理指标随窗口缩放比例(1M 窗口 → 2000 条)
}
// checks: 探测开关(全部只读)
checks: {
  git: { enabled: true, workspaceRoot?: string },          // .git 存在性探测
  handoff: { enabled: true, paths: [] },                   // 你的交接文档文件名
  sessionResume: { enabled: true },                        // DSH 持久化说明
  processes: { enabled: false },                           // 运行中进程检测(增量信号,默认关闭;/compass processes 强制开启)
}
projection: { enabled: true }                              // 响应式徽章单元
cost: {
  cacheHitDiscount: 0.1,       // 缓存命中价格比例
  inputPricePerM: 0.28,        // 静态兜底:USD / 1M 输入 token
  priceSource: 'auto',         // 'auto':定期拉取;'static':从不拉取
  priceUrl: 'https://cdn.jsdelivr.net/gh/NinjaSln-labs/dsh-context-compass@main/pricing/deepseek.json',   // 主源(jsdelivr,CN 可达)
  priceFallbackUrl: 'https://raw.githubusercontent.com/NinjaSln-labs/dsh-context-compass/main/pricing/deepseek.json', // 同轮回退(GitHub raw)
  priceRefreshHours: 24,
}