番茄钟 · Pomodoro Clock

嘉立创EDA（EasyEDA Pro）专业版扩展 — 嵌入式番茄工作法计时器，支持自定义时长方案。

简介

pomodoro-clock 是一个运行在嘉立创EDA专业版编辑器内的番茄钟扩展。它以轻量 iframe 的形式嵌入到 EDA 的 home、sch、pcb 三个工作区顶部菜单，让你在画原理图或 PCB 的间隙也能专注节奏。

功能特性

• 三段式计时：工作 / 短休 / 长休，默认 25 / 5 / 15 分钟，支持自定义方案
• 方案管理：可新建、编辑、删除多套时长方案，内置「经典番茄」只读
• 自动循环：每完成 4 个工作番茄自动进入长休
• 主题切换：跟随系统 / 日间 / 夜间三种模式
• 持久化存储：方案、主题、累计专注时长均写入 localStorage
• 结束提示：三声提示音 + 桌面通知（需授予权限）
• 键盘快捷键：Space 开始/暂停 · R 重置 · S 跳过 · 1/2/3 切换模式
• 细节体验：SVG 圆环进度动画、深浅主题切换动画、尊重 prefers-reduced-motion

使用

安装后重启 EDA 编辑器，点击顶部菜单 高级 → 番茄钟 入口：

• 在 首页 / 原理图 / PCB 任一工作区均可打开
• 窗口尺寸 360 × 480，支持最小化、不支持最大化

开发

环境要求

• Node.js >= 20.5.0
• npm

本地构建

# 安装依赖
npm install

# 代码风格修正
npm run fix

# 编译并打包扩展包（产物在 ./build/dist/）
npm run build

打包完成后，将 ./build/dist/ 下的 .zip 在 EDA 专业版「扩展」面板中导入即可加载。

项目结构

pomodoro-clock/
├── extension.json        # 扩展清单（菜单、entry、图标等）
├── src/
│   └── index.ts          # 扩展入口，导出 pomodoro() 打开 iframe
├── iframe/
│   └── pomodoro.html     # 单文件实现的番茄钟 UI（含全部样式与脚本）
├── images/
│   ├── logo.png          # 扩展图标
│   └── UI.png            # UI 预览图
├── config/               # 构建配置（esbuild）
├── build/                # 打包脚本
└── package.json

修改 UI

计时器界面整体在 iframe/pomodoro.html 单文件内（HTML + CSS + 原生 JS），不依赖任何前端框架，修改后重新 npm run build 即可。

修改入口逻辑

src/index.ts 中导出的 pomodoro() 是菜单点击后的回调，默认调用：

eda.sys_IFrame.openIFrame('/iframe/pomodoro.html', 360, 480, 'pomodoro-clock', {
	maximizeButton: false,
	minimizeButton: true,
	grayscaleMask: true,
});

如需自定义行为，可在此函数内追加逻辑。更多 API 见 嘉立创EDA专业版扩展开发文档。

反馈与贡献

• 问题反馈：GitHub Issues

开源许可

本项目使用 Apache License 2.0 开源许可协议。