a179-sanae/dsh-auto-collapse

A DeepSeek Harness Web client plugin that auto-collapses tool cards and Think blocks into one-line summaries, so the chat keeps only what the model says.

中文: README.md

What it does

dsh-auto-collapse is a pure front-end DOM plugin for the DeepSeek Harness Web chat UI. It collapses the working process into one-line summaries — tool calls and reasoning no longer fill the screen, giving the chat the collapsible look of the VSCode Codex desktop client, and it also rewrites “Deep diving” to “Deep sleeping”. It never modifies message content — it only controls visibility of the working process.

Preview

Features

• Turn-level auto collapse (Level 1): when a turn finishes, the whole working process collapses into a 已处理 X秒 (processed in Xs) row, leaving only the model's final text. Click to expand the full workflow (context injections → thinking → tool calls → intermediate text → final text).
• Second-level rows: after expanding level one, tool-call groups and think blocks each collapse into a single chip row (正在运行 {command} / 运行了命令 / 已思考), click to expand/collapse; adjacent tool groups merge, while body text serves as a hard boundary (never merged across).
• Third-level think merge: expanding 已思考 shows consecutive think rows merged into one row titled Think · first line, click to reveal the merged content block; raw fourth-level rows never appear.
• Native visual alignment: 16px icon box / 14px glyph / 24px line height / 16px row gap; colors use DSH native tokens (--dsw-alias-label-*); think and command icons come from DSH native icons (IconThinkOutline14 / IconApiOutline14).
• Stream-friendly: in-place assistant-step body updates, React node replacement, and out-of-order history mounting are reconciled on every pass; running rows use a smooth text pulse motion, disabled by prefers-reduced-motion.
• Complete work-node coverage: top-level command / manual-compaction, context nodes, and image-only finals follow the same turn semantics as tool calls.
• Fully reversible: uninstalling (HMR stop) restores every collapsed/hidden/rewritten node.

Install

dsh plugin --profile web add "github:a179-sanae/dsh-auto-collapse#main"

Restart the DSH web service (or trigger plugin HMR), then hard-refresh the page (Ctrl+Shift+R). No configuration needed.

Development

Project layout

src/fold.ts       core: FoldController (state machine) + findBlocks (block recognition) + collapse/expand logic
src/client.ts     browser entry (plugin registration)
src/index.ts      host half
build.mjs         esbuild build (the client registration id lives in the banner)
deploy.mjs        safe deploy: validate → back up → replace → verified restart → hash check/rollback
cordis.patch.yml  profile tree mounting
test/             fake-DOM contract, race, session-switch, and 40-order permutation regressions

Checks

npm run check

Runs TypeScript checking, a fresh build, and the complete regression suite.

Quick deploy (local dev)

npm run deploy

Validates the plugin/DSH package identities and the process listening on port 3080, then creates a timestamped backup, replaces the bundle, restarts DSH, and verifies the served hash. Failures restore the old bundle. Override defaults with DSH_AUTO_COLLAPSE_LIB, DSH_DIR, DSH_WEB_PORT, and DSH_LOG_DIR.

Publishing a new version

npm pack --pack-destination <local-plugin-dir>   # packing auto-triggers the build via the prepack hook

Point the plugin dependency in the profile's package.json to the new tarball and reinstall the plugin.

Key mechanisms

• Block recognition (findBlocks): top-level nodes are classified as tool calls, command/manual-compaction cards, contexts, thinking, or body content; user/steering/turn-tail nodes are hard boundaries.
• Segment reconciliation: every pass rebuilds segments from current DOM order. The last assistant-step containing text or media is final; earlier bodies are intermediate work. Stable flow/node keys preserve UI state without one-shot mutation bookkeeping.
• Duration: streaming segments each track their own first running observation; historical segments parse official duration or the timeStart/turn-tail range. Whole minutes omit the seconds field.
• React coexistence and reversibility: replaced nodes rebind by stable key, removed level-one rows rebuild with their expansion state, and every inline display value is saved before mutation and restored exactly.

License

MIT