dsh-task-pulse
Manifest validRead-only DSH progress tab for Markdown task records in docs/tasks.
Task Pulse
Task Pulse is a read-only DeepSeek Harness (dsh) plugin. It adds a Progress (进度) view beside the conversation and projects the current workspace's docs/tasks/ Markdown into a status page you can scan in a few seconds.
English | 中文
Why Task Pulse
Task records are written for agents: long Markdown with every field. Task Pulse keeps those records as the source of truth and shows only what a person needs to decide what to do next. It never writes files, calls the network, or runs shell commands.
Features
| Grouped progress | Now / Waiting for you / Next / Paused / Needs verification. Empty groups are hidden. |
| Task rows | Name, phase, date, next step, blockers. Click for the full record. |
| Detail card | Goal, scope, latest progress, evidence links, copy actions. |
| Decisions | Filterable decision log with evidence links. |
| Activity | Recent progress entries and the latest handoff. |
| Health | File sizes, stale tasks, parser warnings. |
| Onboarding | Copy a complete prompt that teaches an agent the record format. |
| Read-only | No writes, no network, no shell. |
Install
Requires DSH 0.2.2-rc.1 and Node.js 20 or newer.
From the DSH plugin UI: Plugins → Add plugin → Git address, then enter:
https://github.com/SwingRainbow/dsh-task-pulse
Or from a terminal:
dsh plugin --profile web add github:SwingRainbow/dsh-task-pulse
Use --profile desktop for the desktop profile. Restart or refresh DSH after installing. The Progress tab appears in non-blank sessions.
Local development:
dsh plugin --profile desktop add link:/absolute/path/to/dsh-task-pulse
Published builds include lib/client.js; Git installs do not need a build step.
What it reads
| File | Used for |
|---|---|
docs/tasks/BOARD.md | Current tasks, phases, next steps, blockers, evidence |
docs/tasks/DECISIONS.md | Decision log |
docs/tasks/progress.md | Activity feed and the latest handoff |
docs/tasks/task_plan.md, findings.md, ARCHIVE_INDEX.md | Size and health only |
Paths are relative to the session workspace. The view reloads when a file version changes, checked every 5 seconds.
New project? Copy the prompt
If the workspace has no docs/tasks/ records, the tab shows an onboarding card instead of an error. Copy prompt copies prompts/task-records.md, a self-contained specification that tells an agent how to read the project and create BOARD.md, DECISIONS.md, and progress.md in the expected format.
The plugin stays read-only; the agent creates the files after you paste the prompt.
How it works
- Registers a
conversation.viewslot and renders a React page inside DSH. - Reads files through
ctx.remote.workspaceFiles(readBytes/stat). - Parses Markdown with
src/parse.mjs; no network, no shell, no writes. - Polls file versions every 5 seconds and reloads when they change.
- Bundles the parser and prompt into
lib/client.jsat build time.
Compatibility
| DSH | 0.2.2-rc.1 |
| Node.js | >=20 |
| Client | Web (dsh.client.platform = "web") |
| Data | Read-only docs/tasks/ Markdown |
The DSH client module format is validated against the installed runtime. Re-check it after a DSH upgrade.
Development
npm run build # rebuild lib/client.js
npm test # parser, build consistency, prompt examples
Tests use fixed fixtures in test/fixtures/. Edit src/client.template.js, src/parse.mjs, or prompts/task-records.md, then rebuild.
Project layout
.
├── src/ parser and client template
├── lib/ built client bundle (committed for Git installs)
├── prompts/ onboarding prompt, inlined at build time
├── locale/ plugin manager metadata
├── test/ fixtures and Node tests
├── cordis.patch.yml DSH bundle patch
└── package.json DSH manifest
Non-goals
- No editing, drag-and-drop phase changes, or write-back.
- No workspace-wide aggregation; the tab follows the current session workspace.
- No archive browser in 0.2.0. Existing archive links still open in the evidence drawer.
License
MIT — see LICENSE.
Comments
Loading…
Similar plugins
by chen8923
Live progress for long-running DSH tasks: scripts report structured progress, the Web UI shows it in a floating overlay, a sidebar tab, and a settings page.
★ 0
MIT
TypeScript
Sep 24, 2026
dsh plugin --profile web add dsh-task-progressby Zilong6666
DSH task workspace convention: one folder per task, one PROGRESS.md per task (overwritten each update), and per-task git once a task runs long.
★ 0
MIT
JavaScript
Oct 4, 2026
dsh plugin --profile web add dsh-task-workspaceby ardesp0630
工作进度面板:在输入框下方的带区常驻显示当前会话的任务清单完成度与运行状态,展开可见任务明细、轮次步骤、模型/工具耗时与上下文占用。
★ 0
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-work-progressby mlosun
DSH WebUI 里的「随身手册」:全局 Markdown 笔记,任何工作区随时可读。
★ 9
↓ 119/wk
MIT
JavaScript
Aug 19, 2026
dsh plugin --profile web add dsh-docs-panelby zzt0818
Task details sidebar for DeepSeek Harness: a 'View task details' button under every finished turn opens a resizable right-sidebar panel listing the task's input files, intermediate artifacts, output f
★ 0
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-task-detailsby zpda88888a88888-debug
dsh的一个简单插件,用于记录和汇报工作进度。
★ 0
MIT
JavaScript
Sep 29, 2026
dsh plugin --profile web add dsh-progress-secretary