dsh-pomodoro-timer

A Pomodoro timer for the DeepSeek Harness Web UI: a sidebar page with focus / short-break / long-break cycles, plus a countdown pill beside the composer.

English | 简体中文

Repository: https://github.com/cuznmop/dsh-pomodoro-timer · Issues: https://github.com/cuznmop/dsh-pomodoro-timer/issues · Package: https://www.npmjs.com/package/dsh-pomodoro-timer

Features

• Sidebar page — clock icon in the left panel list opens a full page with a progress ring, controls, and statistics.
• Composer pill — a compact countdown next to the message box; click it to jump to the page. It keeps running while you work in chat.
• Cycle control — focus 25 / short break 5 / long break 15 minutes by default, a long break every 4 pomodoros, and an optional auto-start for the next phase.
• Controls — start, pause, resume, reset the current phase, skip to the next phase.
• Statistics — the pomodoro number in the current round and how many you finished today; the counter rolls over at midnight.
• Chime — three short tones when a phase ends naturally (can be turned off; the page needs one interaction before the browser allows audio).
• Survives a reload — the running deadline is stored in localStorage, so refreshing the page resumes the same countdown.
• Light and dark themes — every colour is a --dsw-alias-* theme token; the plugin imports no Harness client package, so it does not break when those internals change.
• Bilingual — Simplified Chinese and English, following the GUI language.

Requirements

Component	Requirement
DeepSeek Harness	verified on 0.2.0-rc.2 (Web/Desktop profiles); the plugin uses only the public client slots and locale services, and declares no DSH peer dependency
DSH profile	a Web surface (web, or the Desktop app); headless profiles have no UI
Node.js	^22.19.0 or >=24.0.0 (only for the optional local check)

Install

# plain dsh web profile
dsh plugin --profile web add dsh-pomodoro-timer

In the Desktop app, install dsh-pomodoro-timer from the plugin market page, or from Settings → Plugins. Restart Harness (or reload the page) afterwards, then look for the clock icon in the sidebar panel list.

Usage

Control	Behaviour
Start / Pause	Start or pause the current phase
Reset	Restore the current phase to its full length and pause
Skip	Move to the next phase without crediting a pomodoro
Settings	Focus length, short break, long break, pomodoros per long break, auto-start, chime

Changing a duration while a phase is paused resizes it immediately; while it is running, the change applies from the next phase.

State lives under the dsh.plugin.pomodoro-timer.v1 key in localStorage.

Uninstall

dsh plugin --profile web remove dsh-pomodoro-timer

Development

No build step: client.js is the published browser bundle. The package ships a self-contained offline check.

npm run check     # node --check on both halves + the offline bundle test
# pnpm run check works too. On a machine that only has DSH's bundled runtime, put
# the workspace shims on PATH first:  $env:PATH = "<workspace>\bin;$env:PATH"

test/client.test.mjs loads the browser bundle with a module-loader stub and a fake client context and exercises registration ids, the phase machine, persistence, and component rendering. It proves logic, not looks — visual verification needs the running GUI.

Layout

Path	Responsibility
package.json	manifest: bundle patch, client declaration, export map, icon, file allowlist
cordis.patch.yml	inserts the Host row that puts the browser bundle in the module graph
index.js	Host half — intentionally a no-op
client.js	the timer store, the sidebar page, the composer pill, and both dictionaries
locale/*.json	plugin-card title and description
icon.svg	plugin-card artwork
test/client.test.mjs	offline check

Notes

• The plugin reads and writes nothing but its own localStorage key. It has no host-side service, no tool, and no network access.
• It registers into sidebar.panellist, main, and conversation.composer.dock; it never replaces the app root and never appends to document.body.

License

MIT