番茄任务看板 atzx/dsh-plugin-pomodoro

dsh-plugin-pomodoro

DeepSeek Harness 的番茄钟 + Trello 风格任务看板——计时器浮在应用上方，看板也在同一个浮层里，专注时间会记到你正在做的任务上。

插件分两半：纯浏览器客户端（浮动计时器和看板 UI），以及一个小型宿主端，把看板存进 DSH 主目录下的 SQLite，通过五条带鉴权的路由对外提供。这些都不会碰到模型：没有工具、提示词、会话事件，也没有服务商请求。

任务看板，番茄钟正专注在一个任务上

功能

专注计时器

- 外壳浮层里的浮动胶囊，显示倒计时、阶段和脉冲；展开成卡片后，有环形进度、周期圆点、开始/暂停/跳过/重置和设置。
- 专注 / 短休息 / 长休息循环（默认 25/5/15，每 4 个专注块后长休息）。
- 键盘：Space 开始/暂停，S 跳过，R 重置，Esc 收起，B 打开/关闭看板。
- 可选提示音、桌面通知和行内完成横幅。
- 时钟存的是绝对截止时间，所以刷新、标签页被节流、休眠都不会让它走偏。

任务看板（Trello 风格）

- 自定义列表（默认 To Do / Doing / Done）：新建、行内重命名、拖动排序、把某个列表标为完成列表、删除时把任务重新分配。
- 卡片带优先级（无/低/中/高）、彩色标签、截止日期、预估、备注、子任务、已记录时间和番茄数。
- 完整创建器（创建前可填所有字段和子任务行）和任务抽屉，创建后的一切都在这里，包括子任务清单和标签分配。
- 拖放卡片在列之间移动，带插入线；拖动列表把手可重排列。无障碍替代方案：卡片的「移动到列表」菜单，以及聚焦卡片上的 Alt+←/→/↑/↓。
- 侧栏里的智能分区带实时计数：全部任务、今天、已逾期、明天、本周、未来 7 天、高/中/低优先级、无截止日期、已完成。
- 每个分区四项指标：预估时间、待完成、已用时间、已完成——带预估范围开关（全部任务 / 仅未完成任务）。
- 搜索覆盖标题、备注、子任务和标签名（忽略重音符号），外加标签筛选，以及手动 / 截止日期 / 优先级 / 创建时间排序。
- 整个看板的 JSON 导出与导入，带校验过的确认步骤。

专注分钟会累加

- 在卡片上或抽屉里点专注，就把任务和计时器关联起来。
- 插件统计真实专注时间（暂停、重置、跳过、切换任务和阶段完成都会结算当前片段），记到任务上；完成一个专注阶段加一个番茄。
- 记录是幂等的（creditId），宿主不可达时先在本地排队，所以刷新或重试请求都不会重复计数。
- 应用关闭期间结束的阶段，下次加载时会补记。
| 今日区块与指标 | 任务抽屉 | 编写器 |
| 今日区块 | 任务抽屉 | 编写器 |

| 计时器聚焦的任务 | 看板菜单 | 导入确认 |
| 计时器聚焦到任务 | 看板菜单 | 导入 |

| 抽屉里的行内标签面板 | 标签管理器 |
| 行内标签选择器 | 标签管理器 |

计时器小组件和它的 Plugins 配置页没有变化：

| 收起 | 展开 | Plugins → Configure |
| 收起的胶囊 | 计时器卡片 | Plugins 配置页 |

启用、停用、配置 —— 都在 Plugins 页

Plugins（侧边栏）→ Installed plugins → dsh-plugin-pomodoro：

- 配置档层级 —— 包开关和 Component 开关（往配置档的 cordis.patch.yml 写入 - id: pomodoro / disabled: true，在开了 HMR 的配置档上实时卸载插件）。
- 插件层级 —— Configure 控制计时器小组件的显示与隐藏，并修改它的默认值。看板数据不受这些开关影响。

安装（本机已完成）

APP_CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$APP_CLI" plugin --profile desktop add "link:/path/to/pomodoro-plugin" --offline

dsh-plugin-pomodoro 声明了 dsh.bundle.patch，所以这条命令会同时加上依赖和 dsh.profile.bundles 条目。重启一次 DeepSeek Harness，插件就会在桌面窗口里加载。
完整步骤、回滚、各版本差异和日志位置见 docs/install.md。

存储

- 看板数据 → SQLite，位于 $DSH_HOME/pomodoro/board.sqlite（WAL；config.dbPath 可覆盖）。
每天轮换备份写入 board.sqlite.bak（以及 .bak.1 … .bak.7）。
- 每个窗口的展示状态（当前区块、搜索、标签筛选、排序）→ localStorage。
- 计时记录和小组件偏好 → localStorage（dsh-plugin-pomodoro:state:v1、 :prefs:v1、:ui:v1）；待入账的专注时长排在 :pending-credits:v1 里。

数据模型、HTTP 路由和限制见 docs/board.md。

验证

node scripts/build.mjs --check # lib/client.js is up to date with src/
node --test tests/*.test.js # 95 unit/integration tests (core, stores, host SQLite + API)
./scripts/verify-plugin.sh # isolated DSH 0.2.1: install → boot → bundle + board host
node scripts/verify-board.mjs --url "<authenticated-url>" # headless board E2E (22 checks)
当前验证结果：95/95 测试通过，verify-plugin.sh PASS（bundle 正常提供 + /api/pomodoro-board 返回 200 + SQLite 文件已创建），针对临时 DSH 0.2.1-rc.2 实例的 22/22 看板 E2E 检查通过。详情与命令见 docs/verification.md。

配置

loader 行支持可选配置：

- insert:
- id: pomodoro
name: dsh-plugin-pomodoro
config:
dbPath: /custom/path/board.sqlite # default: $DSH_HOME/pomodoro/board.sqlite
storageKey: dsh-plugin-pomodoro:state:v1
defaults: # timer defaults only (the user's UI wins afterwards)
focusMin: 25
shortBreakMin: 5
longBreakMin: 15
longBreakEvery: 4
autoStartBreaks: true
autoStartFocus: false
sound: true
notify: true

目录结构

lib/index.js host half: opens SQLite, registers the board routes in ctx.effect
lib/db.js schema v1, migrations, commands, export/import, rotating backup
lib/api.js authenticated board routes (state, revision, command, export, import)
lib/client.js GENERATED browser bundle (what the host serves)
src/timer-core.js pure timer state machine (deadlines, phases, focus accounting)
src/tasks-core.js pure board rules (sections, metrics, search, ordering)
src/board-store.js board API bridge, observable snapshots, credit queue, focus bridge
src/board-ui.js board overlay (columns, cards, stats, drawer, composer, menus)
src/board-styles.js board stylesheet (design tokens only)
src/locales.js en + zh dictionaries
src/client.js React widget, Plugins page + cordis client plugin body
scripts/build.mjs inlining build (local imports + require rewriting)
scripts/verify-plugin.sh isolated install/boot/bundle/board-host check
scripts/verify-ui.mjs CDP end-to-end for the timer widget and Plugins page
scripts/verify-board.mjs CDP end-to-end for the task board
tests/ node:test suites
docs/ client API spec, board guide, install recipe, verification evidence

设计说明

- 数据归宿主所有。 看板状态属于人的知识，不是会话状态：SQLite、WAL、事务化命令和幂等的时间入账共同保证数据持久且一致，浏览器始终只是薄薄一层可替换的视图。
- 只有一个鉴权入口。 五条精确路由都走 DSH 的连接载体：Web 应用里走 HTTP + cookie，Electron 里走桌面壳的 dsh-app:// 代理（同一个 cookie）。
- 手写 bundle。 lib/client.js 已提交进仓库，直接从包里提供，安装时不需要构建工具。scripts/build.mjs 只负责内联 src/ 下的模块，并把 react 的 import 改写成工厂函数的 require。
- 专注时长按实测算，不按名义值算。 时间段由实际时钟推导，每次状态切换时结算，creditId 保证重试安全。

已知限制

- 每个 DSH home 对应一块看板，不共享，也不支持多设备同步。要迁移看板，用 JSON 导出/导入。
- 数据存放在拥有该配置档的主机上：两个不同的 DSH 安装不会共享同一块看板。
- 拖放操作依赖指针；键盘/菜单操作是无障碍路径。
- 已在 macOS 上配合 DSH 0.2.1-rc.2 测试；Windows/Linux 尚未验证。

License

MIT — 见 LICENSE。