sqzw-x/dsh-notes-context ↗★ 0

dsh-notes-context

Notes-backed context compression for DeepSeek Harness: replace LLM-summarized compaction with a model-written persistent notebook plus recoverable raw history — the rollover boundary itself costs zero model calls. 适合长对话用户,通过模型自写笔记本代替传统压缩,降低滚动边界开销。

패키지
dsh-notes-context
호환성
미검증
Harness peer 범위
*
Cordis peer 범위
~4.0.4
버전
0.2.1
라이선스
MIT
최근 업데이트
2026. 10. 17.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:sqzw-x/dsh-notes-context

配置

常用配置项如下。完整字段见设置页,推导过程见 内部机制。

字段默认说明
thresholdTokens-1压缩阈值。绝对值优先:450000 即 450K,不随模型改变。-1 改用比例 thresholdRatio
keepRecentTokens20000滚动后保留的原文上限,绝对值。实际保留量更大(裁剪以整条消息为单位)
reserveTokens留空压缩阈值下方保留的余量。留空取窗口的 15%,不低于 16384。目标离窗口上限不足该值时,实际触发点会提前,最多提前该值

触发点取两道上限里低的那道:min(目标, 窗口 − 输出预留 − 余量)。声明了 maxTokens 的供应商(pi-ai 系列)会占掉窗口的四成左右,目标设高时会被这道上限截住。这是窗口的物理限制,不是配置错误;想让目标精确命中,就把 reserveTokens 设小。 | reminderEnabled | true | 是否注入提醒 |

提醒位置无配置项,由压缩阈值推导:

lead = min(32000, max(8192, floor(压缩阈值 × 0.125)))

压缩阈值 450,000 时提醒落在 418,000。调整提醒位置需调整压缩阈值。

生效时机:改完立即生效。rolloverText、notebookSummaryMaxChars 与两个 static* 标记例外——仅在写入边界时读取,故下次滚动才生效。

- id: notes-context
  config:
    thresholdTokens: 450000
    keepRecentTokens: 20000