BOWLUNA/dsh-zcode-breaker ↗★ 0

dsh-zcode-breaker

Rapid-refill circuit breaker for DeepSeek Harness automatic compaction: stops the futile compact-refill-compact loop, which has no attempt bound and burns one summarization call per step, and tells the user which oversized read or tool output caused it. 适合频繁处理超大输入或工具输出、需要避免Token无限消耗的用户。

패키지
dsh-zcode-breaker
호환성
미검증
Harness peer 범위
>=0.1.5-rc.2 <0.2.0-0
Cordis peer 범위
^4.0.2
버전
1.0.1
라이선스
MIT
최근 업데이트
2026. 9. 22.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:BOWLUNA/dsh-zcode-breaker

Configuration

Every base-engine key survives, re-declared on the subclass so it is neither rejected by the base engine's strict validator nor lost:

KeyDefaultMeaning
thresholdRatio0.8pressure ratio that triggers compaction
retainRatio0.16retained tail ratio after compaction
retainTokensnoneabsolute token retention instead of the ratio
summarizationProvideremptyroute used for summaries
summarizationModelemptymodel used for summaries
maxTokens8192summary output cap
compactionRetries1retries after a failed summary
maxOverflowRetries1overflow-recovery retries
modelPoliciesnoneper provider and model overrides of the keys above
autotrueautomatic compaction master switch

Added by this plugin:

KeyDefaultMeaning
toolTurnThreshold2a gap under this many tool turns is rapid; exactly the threshold is not
maxConsecutiveRapidRefills3refuse on the Nth consecutive rapid refill
announceInPrompttrueinject the advisory prompt section once tripped

That is 13 config keys in total, and this file declares compatibility with dsh >=0.1.5-rc.2 <0.2.0-0.