简介
教育时钟（Education Clock） 是一款致力于帮助学习者科学规划学习时间、提高学习效率的开源工具。由 Return-Log 团队开发，适配多平台（Windows、Mac、Linux），界面简洁直观，操作便捷。通过设置合理的学习与休息提醒，帮助用户养成良好的学习习惯。
核心特色
-
科学的时间提醒机制
支持用户自定义学习时长和休息时间，结合时间管理理念（如番茄钟），高效提醒。 -
多平台兼容
Windows、macOS 和 Linux 系统，使用无缝衔接。 -
高度个性化定制
支持更换界面主题、背景图片，以及自定义提醒参数。 -
丰富的统计分析
提供学习时长、休息频次、习惯培养等数据，让你更全面掌握学习状态。 -
免费开源
任何人都可以免费使用、修改、贡献代码。
功能说明
设置
信息存储在./data下，修改设置会自动保存，操作不可逆，请注意进行数据备份
课程表
显示课程表
到达设定时间后对应课程加粗并使用高亮边框
主界面可以选择显示其它时间课程表以适应调休
更改课程表
[!WARNING]
修改项后务必点击表格空白处以保存，直接关闭窗口可能会导致数据丢失
插入课程表
对应日期为空时，点插入行按钮会自动添加一行
不为空时需选择一行，点击插入按钮会在选中行下方插入一行
删除课程表
选中要删除的行点击删除按钮即可删除
更改课程表
双击需更改的单元格即可进行更改
日期须符合HH:MM格式
倒计时
设置
事件最多4个字符，也不要设置过长的倒计时(大于9999天)，否则会导致窗口显示超出范围
天气预报
使用和风天气的格点天气服务
API可在和风天气开发平台自行注册获得
[!CAUTION]
注意经纬度不要填反
通知栏
信息显示规则
-
以时间倒序显示近7天数据
-
最新消息以弹幕形式在屏幕上滚动
-
支持markdown格式
-
当过滤群组名字包含“管理组”关键字时，对应群组信息头用黄色显示
[!WARNING]
通知栏信息编码为base64加密存储，只能在设置界面更改
本地公告板设置
公告板现支持md格式解析，图片解析，视频、文档等文件保存与快速打开
按设置界面提示填写远程数据库信息
过滤设置
- 可选机器人名称，发件人昵称，群聊名字进行过滤
- 有多个过滤项时使用逗号分隔
- 过滤项间彼此互不干扰
使用指南
-
下载安装
访问项目页面，下载对应平台的安装包或源码，安装使用。 -
配置设置
进入设置界面，自定义时间、界面背景、提醒方式。 -
开始使用
点击“开始”计时，系统在到点自动提醒，养成良好习惯。
服务端设置
数据库设置
数据库中构建如下表
CREATE TABLE IF NOT EXISTS `messages` (`id` INT AUTO_INCREMENT PRIMARY KEY, -- 自增主键`robot_name` VARCHAR(255) NOT NULL, -- 机器人名称`sender_name` VARCHAR(255) NOT NULL, -- 发送者名称`message_content` TEXT NOT NULL, -- 消息内容`timestamp` DATETIME NOT NULL, -- 时间戳`conversationTitle` VARCHAR(255) NOT NULL -- 群聊标题
);
[!IMPORTANT]
记得放行 3306 MySQL服务默认端口
添加数据
可以使用你自己的程序执行如下语句进行插入
INSERT INTO `messages` (`robot_name`, `sender_name`, `message_content`, `timestamp`, `conversationTitle`) VALUES
('机器人名字', '发送者名称', '展示的消息内容', '时间戳(2024-11-04 15:00:04)', '群聊名称');
在钉钉中创建机器人
需自建一个组织，机器人每月有3000次调用限制
开放平台: https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Frobot#/corp/robot
在自建组织中创建一个机器人应用，将应用凭证中三个项记下来
对应机器人开发管理中添加服务器出口IP，和消息接收地址
服务器配置
python版本: 3.10.14 使用flask框架
./dingtalk-service/app.py 为服务端需运行软件
将app.py中以下部分改为你自己的配置信息
"""以省略上方代码"""# 数据库配置
db_config = { # 数据库配置"host": "localhost","user": "","password": "","database": ""
}# 钉钉机器人配置（多个机器人）
robots = { # 机器人应用凭证"": { # ""中填写AppKey"agent_id": "", # AgentId"app_secret": "" # AppSecret}# 可以继续增加更多的机器人配置
}"""中间部分已省略"""if __name__ == '__main__':app.run(host='0.0.0.0', port=20000, debug=True) # 改为自己的端口
宝塔面板网站管理：
添加一个python项目
所需的库，装最新版即可
flask # 用于创建 Web 应用程序
pymysql # 用于连接和操作 MySQL 数据库
alibabacloud-dingtalk # 用于调用钉钉的 API
alibabacloud-tea-openapi # 钉钉 SDK 依赖的 Alibaba Cloud TEA OpenAPI 库
alibabacloud-tea-util # 钉钉 SDK 依赖的 TEA 工具库
最后重启项目
使用机器人
在自建组织下添加一个内部群，添加上自定义机器人，@机器人 即可发送信息，一切顺利话此时数据库中已有这条信息
自动关机
一天中多个关机时间使用逗号分隔
到达时间会弹出确认倒计时窗口，点取消即可终止关机
新闻联播
到达7:30会自动使用默认浏览器访问央视网，根据是否有声音播放模拟鼠标双击进行全屏操作，到达7:30自动关闭浏览器窗口
模块默认为关闭状态
悬浮球
点击小猫悬浮球可打开工具栏，目前有随机点名、通知消息本地发送功能
API调用（新闻看板）
显示效果
设置
目前只能解析文本类API（需要显示的项都在"data"下）
使用md格式，api中的内容显示需加{}，如上图所示
【我的更新汇总】
点击下载此项目
关注我的CDDN博客
更多资源可以查看我的CSDN博客
