dsh-snapcompact
DSH 的位图帧上下文压缩插件：使用确定性像素字体对对话历史进行可视化归档
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:JessenReinhart/dsh-snapcompact#6fb85e26537c6ff8eb5b2db95480ac265499bca5Snapcompact 以 dsh-snapcompact 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Bitmap-frame context compression plugin for DeepSeek Harness (DSH).
Inspired by @oh-my-pi/snapcompact.
Instead of asking an LLM to summarize discarded conversation history in lossy prose, snapcompact serializes the exact conversation and renders the text into dense PNG frames of pixel-font glyphs that vision models read back directly. The entire process is local, fast, and deterministic — no auxiliary LLM API calls, no summarization latency, and zero token-cost overhead beyond the compact bitmap frames.
@oh-my-pi/pi-natives).anthropic (11on16-bw): 8x13 font on 11px advance, black-and-white.google (8on22-bw): 8x13 font on 22px pitch, tuned for Gemini vision budget.openai (8on22-bw): 8x13 font on 22px pitch, sent with detail: "original".cjk (silver16-bw): Silver TrueType font on 16x16 grid for East Asian (Chinese, Japanese, Korean) text.¶user: user message sections¶think: assistant reasoning blocks¶ai: assistant message sections¶call: name(args)//intent tool calls with parameters<out>...</out> formatted tool results with dimmed noiseFILES section tracking read and modified files ((Read), (Write), (RW))ctx.attachments.saveImages/snapcompact [--frames <N>] [--shape <name>] [--all] command for on-demand manual compactionSnapcompactEngine implements the standard DSH CompactionEngine serviceagent/pre-stepagent/request-errorClone the repository into your active DSH profile's packages/ directory (e.g. desktop):
# Windows PowerShell
git clone https://github.com/JessenReinhart/dsh-snapcompact.git "$env:USERPROFILE\.dsh\profiles\desktop\packages\dsh-snapcompact"
# macOS / Linux
git clone https://github.com/JessenReinhart/dsh-snapcompact.git ~/.dsh/profiles/desktop/packages/dsh-snapcompact
Add packages/dsh-snapcompact to dsh.profile.bundles in your profile's package.json (e.g. ~/.dsh/profiles/desktop/package.json):
{
"dsh": {
"profile": {
"bundles": [
"packages/dsh-snapcompact"
]
}
}
}
The plugin automatically mounts its Cordis row via the bundled cordis.patch.yml.
Snapcompact uses the high-performance native pixel-font rasterizer binary (pi_natives.<platform>.node).
The plugin automatically discovers this binary from any of:
~/.omp/natives/<version>/pi_natives.<platform>.node~/.bun/install/cache/@oh-my-pi/pi-natives-*PI_NATIVES_PATH=/path/to/pi_natives.<platform>.nodeRestart DeepSeek Harness to load the profile bundle. In chat, test with:
/snapcompact status
In any DSH session chat:
/snapcompact — Archive older history immediately using smart defaults (auto shape, max 8 frames, retains 16% recent tokens in plain text)./snapcompact auto — Toggle automatic background compaction when the agent is idle./snapcompact auto on — Enable automatic idle compaction./snapcompact auto off — Disable automatic idle compaction./snapcompact auto threshold <pct> — Set context window threshold percentage to trigger idle compaction (default 80%)./snapcompact status — Display current configuration, threshold, and live session token usage./snapcompact --frames <N> — Archive history with custom maximum frame count./snapcompact --shape <name> — Archive history with specific font/shape variant (11on16-bw, 8on22-bw, silver16-bw)./snapcompact --all — Archive all eligible history without retaining recent plain text.Auto-compaction preferences are saved to ~/.dsh/snapcompact-config.json and persist across sessions and application restarts.
const snapcompact = ctx.get("snapcompact");
await snapcompact.compactNow(agent, signal);