养生模式 - 嘉立创EDA专业版插件

为 PCB 设计工程师打造的护眼与健康管理插件，提供一键配色和时间健康管理两大核心功能。

功能特性

一键配色

• 网络颜色：批量设置 PCB 网络（如 GND、VCC 等）的显示颜色
• 图层颜色：批量调整 PCB 图层的颜色（如顶层、底层等）
• 自定义方案：自由添加、编辑、保存颜色配置方案，支持导入导出
• 快速换色：菜单栏「养生模式 → 快速换色」一键应用默认方案（GND #CCCCCC、顶层 #3399FF）

时间健康管理

• 待办事项：简易 TODO 清单，支持添加、完成、删除
• 番茄钟：可自定义的番茄工作法计时器
  • 工作时长（默认 25 分钟）、短休息（默认 5 分钟）、长休息（默认 15 分钟）
    • 长休息间隔（默认每 4 个番茄钟）
  • 自动进入下一时段
• 喝水提醒：定时弹窗提醒（默认间隔 45 分钟，可开关自定义）
• 久坐提醒：定时弹窗提醒起身活动（默认间隔 30 分钟，可开关自定义）

界面预览

颜色配置	待办事项

番茄钟	提醒设置

安装

从扩展商店安装（推荐）

1. 打开嘉立创EDA专业版
2. 顶部菜单栏 → 高级 → 扩展管理器
3. 搜索「养生模式」并安装

手动安装

cd health-mode-extension
npm install
npm run build

构建后在 build/dist/ 目录下获得 .eext 文件，通过扩展管理器的「导入扩展」安装。

使用

主界面分为两个标签页：

• 颜色配置：管理配色方案，点击「应用配置」将颜色写入当前 PCB
• 时间管理：待办 / 番茄钟 / 提醒设置三个子标签页

颜色值使用标准 HEX 格式（如 #CCCCCC），插件内部自动转换为 EDA API 所需的 { r, g, b, alpha }（0~1 浮点数）。

项目结构

health-mode-extension/
├── src/index.ts              # 扩展入口：激活、RPC 服务、配色应用逻辑
├── iframe/
│   ├── index.html            # 主界面（含内联样式与交互）
│   ├── css/style.css         # 样式文件
│   └── js/
│       ├── app.js            # 主逻辑 & 标签页切换
│       ├── color-config.js   # 颜色配置（增删改、导入导出）
│       ├── todo.js           # 待办事项
│       ├── pomodoro.js       # 番茄钟
│       ├── reminder.js       # 喝水 & 久坐提醒
│       └── common.js         # 公共工具函数
├── extension.json            # 插件清单（菜单、入口、UUID 等）
├── package.json              # 依赖 & 构建脚本
├── CHANGELOG.md              # 版本更新日志
└── LICENSE                   # Apache-2.0

技术栈

• 运行时：Node.js ≥ 20.5.0
• SDK：@jlceda/pro-api-types（嘉立创EDA专业版扩展 API）
• 语言：TypeScript（后台） + 原生 JS/HTML/CSS（iframe 前端）
• 构建：ESBuild → .eext 扩展包

开发

# 1. 克隆 SDK 模板
git clone --depth=1 https://gitee.com/jlceda/pro-api-sdk.git

# 2. 安装依赖
cd health-mode-extension
npm install

# 3. 修改 extension.json / package.json 后开始写代码

# 4. 构建 .eext 扩展包
npm run build

# 5. 在 EDA 专业版中导入 build/dist/*.eext 进行测试

通信方式

插件后台（src/index.ts）与 iframe 前端通过两种方式通信：

1. RPC：iframe 通过 eda.sys_MessageBus.rpcCall() 调用后台 rpcService
2. PostMessage（备用）：window.postMessage + window.addEventListener('message')

主要 EDA API

API 文档

• 扩展开发指南：https://prodocs.lceda.cn/cn/api/guide/
• 扩展广场：https://jlc-ext.com/
• SDK 仓库：https://github.com/easyeda/pro-api-sdk

许可证

Apache License 2.0