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 ピア範囲

>=0.1.5-rc.2 <0.2.0-0

Cordis ピア範囲

^4.0.2

バージョン

1.0.1

ライセンス

MIT

最終更新

2026/09/22

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:

Key	Default	Meaning
`thresholdRatio`	`0.8`	pressure ratio that triggers compaction
`retainRatio`	`0.16`	retained tail ratio after compaction
`retainTokens`	none	absolute token retention instead of the ratio
`summarizationProvider`	empty	route used for summaries
`summarizationModel`	empty	model used for summaries
`maxTokens`	`8192`	summary output cap
`compactionRetries`	`1`	retries after a failed summary
`maxOverflowRetries`	`1`	overflow-recovery retries
`modelPolicies`	none	per provider and model overrides of the keys above
`auto`	`true`	automatic compaction master switch

Added by this plugin:

Key	Default	Meaning
`toolTurnThreshold`	`2`	a gap under this many tool turns is rapid; exactly the threshold is not
`maxConsecutiveRapidRefills`	`3`	refuse on the Nth consecutive rapid refill
`announceInPrompt`	`true`	inject 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.

dsh-zcode-breaker

インストール

ドキュメント

Configuration