dsh-live-progress
DSH 编辑器上方的真实任务进度条：由主机事件驱动，感知计划，绝不合成。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-live-progress@0.1.0Live Progress 以 dsh-live-progress 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A real task progress bar above the DSH composer.
It shows what the host is actually doing — and refuses to invent the rest.
English | 中文
The bar above the composer: empty while idle, deepening blue while running, solid deep blue at 100%
A slim rounded bar sits full-width above the message box, in the same column as the composer. It is there before a task starts (idle, empty, muted), it fills as the turn runs, and it stays full and dark blue until the next task begins.
Under the bar there is one line of text: what is happening right now, which step it is, what has already finished, and — when there is a real denominator — the percentage.
| State | What you see |
|---|---|
| Idle | Empty track + 待命中 / Idle, no percentage |
| Running, no real denominator | Honest indeterminate fill, Step 3 · 2 actions done, no fake % |
| Running, plan known | Fills step by step, real percentage (40%), darkest-so-far blue |
| Failed | Task ended (with errors), failure count in the detail line |
| Done | 100%, solid deep blue, stays until the next task |
Most progress bars move because a timer moved them. This one only moves when the host says something really happened:
todo_write, the plan is the real step list, so
2/5 becomes a real 40% instead of another estimate.workflow/phase reports
Phase 2/4 → 50%.turn/end or agent/status idle actually
arrives.~42% with data-estimate="true" and announced
as "about 42%".conversation.input.dock slot — no DOM
injection into anyone else's nodes.todo_write plan and follows its statuses.transform animation, GPU-friendly, honours prefers-reduced-motion.role="progressbar", aria-valuenow, and an aria-valuetext that speaks the real
detail even in indeterminate state./task-progress/client-report) instead of breaking
the page.@deepseek-ai/dsh-client-ui-conversation).dsh.bundle patch (web or desktop profile).dsh plugin --profile desktop add dsh-live-progress
Then restart DSH and refresh the page.
dsh plugin --profile desktop add /path/to/dsh-live-progress
Copy this folder to <profile>/node_modules/dsh-live-progress.
Add to <profile>/package.json:
{
"dependencies": { "dsh-live-progress": "file:/path/to/dsh-live-progress" },
"dsh": { "profile": { "bundles": ["...", "dsh-live-progress"] } }
}
Restart DSH, then refresh the page.
Uninstall: remove the dependency and the dsh.profile.bundles entry, restart DSH.
The host half is plain HTTP/SSE (no /api auth fence, by design of dsh-host-webserver):
curl -s ${DSH_WEB}/task-progress/health # subscriptions + active streams
curl -s "${DSH_WEB}/task-progress/state?session=<id>"
curl -sN "${DSH_WEB}/task-progress/stream?session=<id>" # SSE frames
curl -s ${DSH_WEB}/task-progress/debug # shapes + self-test + client diagnostics
Four assertion suites run against the very same files the browser and the host load — no DSH required:
node run-selftest.mjs # 25 assertions · host self-test + progress model
node run-real-shapes.mjs # 30 assertions · real session/event shapes
node run-client-test.mjs # 58 assertions · the browser bundle under a fake React
node run-host-routes.mjs # 75 assertions · HTTP routes, JSON contracts, SSE frames
All 188 assertions pass.
DSH host Browser
───────────────────────────────────────────── ───────────────────────────────
session/event · agent/status · tools/* conversation.input.dock slot
workflow/* · subagent/* · api-session/* │
│ │ fetch + EventSource
▼ │
lib/collector.js ── real events → one state per session │
│ │
GET /task-progress/state?session=<id> ─── JSON ───────────┤
GET /task-progress/stream?session=<id> ─── SSE ───────────┘
POST /task-progress/client-report ← browser diagnostics
index.js — host half: subscribes to events, keeps the collector, serves the routes,
pushes SSE frames, runs the built-in self-test.lib/collector.js — the progress model: real counters, plan tracking, honesty rules,
per-session state, run history.client.js — browser half: registers the dock, reads the state over SSE, renders the bar,
smooths it, and degrades quietly on any error.cordis.patch.yml — the one-line bundle patch that puts the plugin into the profile's
loader tree.More detail: docs/ARCHITECTURE.md.
dsh 0.2.0-rc.1.peerDependencies: { "@deepseek-ai/cordis": "^4.0.0" }. The SDK it reads is
not bundled, so it follows the host it is installed into rather than pinning a copy.data-plugin-css="dsh-live-progress:css"); the
disposer removes it.MIT © 2026 chioplet