@2jumpsina/dsh-context-guard

Configuration

Editable on the settings page, all applied live; every config field is volatile ⇒ changing them needs no restart (changing source, however, does — see below).

Field	Default	Range	Meaning
enabled	true	bool	Master switch
locale	auto	auto|zh|en	Copy language; auto detects per half — see Language
warnRatio	0.45	0.1–0.95	Occupancy (projectedTokens / contextWindow) at which "time to wrap up" fires
hardRatio	0.60	0.1–1	"Time to start a new session"; must be > warnRatio
hysteresisRatio	0.05	0–0.2	Hysteresis: re-arm only after falling back below warn − this value
cooldownTurns	5	0–100	How many turns of silence follow a level change
onResume	true	bool	Also warn when entering an already-high historical session
respectCompaction	true	bool	Stay quiet while automatic compaction is already reducing the level
crossSessionTrend	true	bool	Count how many sessions crossed the line within the window, to escalate wording
trendWindowHours	24	1–168	Trend window (hours)
trendEscalateAt	3	2–20	Escalate wording when this many sessions hit hard inside the window
pushChannel	none	none|wechat	Extrapolation channel (off by default)
pushMinLevel	hard	warn|hard	Level from which extrapolation starts
pushCooldownMinutes	10	0–1440	Global minimum interval between two extrapolations
handoverOnWarn	true	bool	Auto-draft the handoff block once warnRatio is crossed
handoverPath	HANDOVER.md	string	Relative to the session working directory, or an absolute path
handoverRefreshPercent	5	1–25	Refresh the draft every additional N percentage points of occupancy
handoverTurns	6	1–20	How many "prompt / reply" previews the draft carries
handoverFiles	12	1–50	How many recently written files the draft carries

The schema floor for warnRatio is 0.1: a value like 0.05 stops the entire plugin from mounting (ValidationError: invalid config: $.warnRatio expected number >= 0.1, and the state route then 404s).