简介

你是否好奇自己完成一个 PCB 项目究竟花了多少时间？是否想知道自己每天有多少时间在全神贯注设计，又有多少时间在“摸鱼”？

本插件是一个基于行为分析的工时统计系统。它包含一个后台运行的记录脚本和一个基于 ECharts 的可视化仪表盘。插件通过监听鼠标在 PCB 和原理图编辑器中的活动，自动区分有效工作时间和闲置（摸鱼）时间，并将数据持久化存储在本地。用户可以通过仪表盘查看每日趋势、项目耗时排行以及详细到每 15 分钟的时间分布。

使用方法

安装扩展插件后，打开EDA软件自动运行
- 脚本每 2 秒检测一次鼠标活动。
- 若鼠标在 PCB 或原理图画布上移动，计为工作时间。
- 若超过 20 秒无操作，计为闲置（摸鱼）时间。
- 数据每 60 秒自动保存一次到本地存储。
查看报表：
- 在菜单栏打开 工作时间统计
- 总趋势：查看近 7 天或 30 天的工作/摸鱼时长对比。
- 详情分析：点击曲线图的某一天，下方会显示当天的 24 小时时间轴，精确显示哪个时间段在工作。
- 排行榜：查看所有经手项目的累计耗时排名。
消息提醒：在“消息提醒”页签，可以设置规则（例如：“今日工作满 60 分钟提醒休息”），插件会通过消息吐司提示。

8696875605805658112

解决了哪些痛点

项目管理混乱：同时进行多个项目时，不知道时间都去哪了。排行榜功能帮你理清每个项目的实际投入成本。
健康管理：长时间沉浸式画板容易忘记休息。内置的提醒功能基于实际工作时长触发，比简单的定时闹钟更人性化（摸鱼时间不计入疲劳累积）。
多窗口数据冲突：嘉立创 EDA 允许同时打开多个工程窗口。本插件实现了多窗口并发锁机制，确保多个窗口同时记录数据时不会互相叠加、覆盖或丢失。

技术要点

去中心化存储策略：不依赖外部数据库，利用 sys_Storage 将数据分散存储为按日期的键值对 (STATS_YYYY_MM_DD)，既保证了读取速度，又方便进行长周期的数据回溯。
防冲突算法：在写入数据时，采用“读取-计算剩余槽位-合并写入”的逻辑，并配合简单的并发锁，解决了多开 EDA 客户端时的数据竞争问题。
防挂机干扰：引入 SESSION_START_TIME 校验，防止电脑休眠或后台挂机苏醒后，脚本错误地回溯填充休眠期间的时间，确保数据纯净。
可视化图表：前端集成了 ECharts 库，实现了暗色系的高级仪表盘，支持交互式点击（Drill-down），从月度视图下钻到小时视图。
时间切片算法：将全天划分为 96 个 15 分钟的时间片（Slot），每个时间片独立记录各工程的 Work/Idle 占比，实现了极高的时间分辨率。

使用API接口

API接口	描述
`eda.sys_Storage.getExtensionUserConfig(key)`	读取持久化的统计数据和用户配置。
`eda.sys_Storage.setExtensionUserConfig(key, val)`	将计算后的工时数据写回存储。
`eda.dmt_Project.getCurrentProjectInfo()`	获取当前激活工程的 UUID 和名称，用于归类统计数据。
`eda.pcb_SelectControl.getCurrentMousePosition()`	获取 PCB 画布鼠标位置，用于判定用户是否活跃。
`eda.sch_SelectControl.getCurrentMousePosition()`	获取原理图画布鼠标位置，用于判定用户是否活跃。
`eda.sys_Message.showToastMessage(...)`	触发工时达标后的提醒弹窗。

适用EDA版本

v2.2.43 API缺陷，仅支持PCB页面检测
v3.2.69 完全支持

本工具基于 v2.2.43 客户端开发，但对 v3 版本支持更好

#工时统计# #ECharts可视化# #行为分析# #嘉立创EDA# #扩展API# #扩展插件# #狼黑工具#

嘉立创EDA扩展插件 - 工作时间统计工具 置顶 精 活动

嘉立创EDA扩展插件 - 工作时间统计工具

置顶

精

活动