@sagmans/dsh-terse
DeepSeek Harness 插件，让代理输出在不牺牲质量的前提下尽可能简洁、精炼、干净。始终启用，仅追加。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @sagmans/dsh-terse@0.2.1Terse 以 @sagmans/dsh-terse 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Mandatory, always-on terseness for DeepSeek Harness agents. Compresses everything an agent emits and everything it reads, without replacing the deployment's system prompt and without giving up answer quality.
There is no mode and no off switch. Mounting the row is the enabling act.
| Layer | Extension point | Effect |
|---|---|---|
| L1 constitution | systemPrompt.section | A static, cache-stable rule set that makes every reply compressed. |
| L2 standing reminder | systemPrompt.context | A durable <system-reminder> snapshot that survives compaction, where a system-only rule fades. |
| L3 drift nudge | tools/post-execute -> additionalContexts | A one-line reminder that rides a tool result and catches a reply that ran long. Capped per turn; cannot loop. |
| L4 input shaping | tools/post-execute content | Collapses repeated lines and elides the middle of oversized tool output, with a locator so the original is one call away. |
| L5 enforcement | system-prompt/assemble | Asserts the constitution survived assembly; logs a loud warning if it did not. Never rewrites peer contributions. |
| L6 coverage | per-session state | Cadence and reply observations keyed by the session object, so a resumed or forked session starts clean. |
Compression is aimed at the chat mouth, never at meaning or at durable artifacts:
Those choices are measured in benchmark/README.md; their design record is a local working artifact, not a shipped doc.
The plugin is one row, and it peers on the harness window >=0.1.5-rc.1 <0.3.0; the
releases verified for it are listed in dsh.compatibility.dshReleases of
package.json. Add it to a profile:
dsh plugin --profile <name> add @sagmans/dsh-terse
Or insert it directly in the profile's cordis.patch.yml:
- insert:
- id: terse
name: '@sagmans/dsh-terse'
The shipped row is in cordis.patch.yml.
Every field is optional; the shipped defaults are the product.
| Field | Default | Meaning |
|---|---|---|
constitution | shipped text | Replaces the L1 rule set. |
standing | shipped text | Replaces the L2 reminder; empty suppresses it. |
shaping | true | Whether L4 runs. |
drift | see below | L3 thresholds. |
shapingConfig | see below | L4 bounds. |
interface DriftConfig {
maxReplyTokens: number // 220 reply length above which the prose budget is exceeded
minReplyTokensToJudge: number // 60 floor below which no reply is judged
maxProseRatio: number // 0.72 prose ratio above which a long reply is padding
minJudgeableProseRatio: number // 0.4 below this the reply is code, never judged
idleStepsBeforeNudge: number // 14 steps with no nudge before the anti-drift backstop fires
maxNudgesPerTurn: number // 2 hard cap on nudges, and so on their extra steps
}
interface ShapingConfig {
maxResultChars: number // 12000 threshold above which a result may be elided
headChars: number // 3000 head kept
tailChars: number // 1500 tail kept, where error trails live
duplicateRunMin: number // 4 repeated lines before a run collapses
}
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm run build
A profile loads dist/, not src/; run pnpm run build before dogfooding a linked profile.
scripts/dogfood/run-terse-from-worktree.sh clones the real ~/.dsh to a scratch
directory, mounts this checkout on the real tui profile inside the clone, and launches
it. Every composition input is present — your other bundles, the profile patch, settings,
themes, credentials — while every write goes to the throwaway clone.
./scripts/dogfood/run-terse-from-worktree.sh # clone, build, launch
./scripts/dogfood/run-terse-from-worktree.sh --no-launch # set up, print the command
./scripts/dogfood/run-terse-from-worktree.sh --status # show what the clone runs
./scripts/dogfood/run-terse-from-worktree.sh --with-sessions
./scripts/dogfood/run-terse-from-worktree.sh --clean # remove the clone
What to look for on the surface: the status line shows injected … terse:standing … when
the layer is live. Ask a short factual question (expect one line), ask for code inline
(expect the full implementation, no elision), and ask something safety-critical (expect
full prose). Those three cases are the contract; if the code case is trimmed, that is a bug.
benchmark/benchmark.sh measures this plugin against a control profile that lacks it. See
benchmark/README.md; the neutral home is mandatory, because a
profile whose global instructions already ask for brevity makes the control terse too.
MIT.
Checks run in tracked local Git hooks instead of push/PR CI. Run scripts/setup-hooks once after cloning; it points this clone's core.hooksPath at .githooks. Each hook runs the generic checks first (sign-off and commit message format, a gitleaks secret scan, and signed, signed-off commits on push), then this repository's checks in .githooks/<hook>.d/ in name order. Install gitleaks first. Every check must pass before you push; never use --no-verify. Pre-push checks test exactly each pushed commit: in place only when it is the clean, unmodified checkout, otherwise in a temporary worktree of that commit.
This repository's checks:
pre-commit: staged whitespace and conflict-marker check.pre-push: npm audit signatures, pnpm run check, pnpm audit --audit-level high.