智能时间锁定系统 - 合理管理使用时间，养成良好习惯
TimeLock是一款专业的智能时间管理工具，基于Python开发，支持Windows和Linux双平台，通过自动化的时间锁定机制帮助用户有效管理电脑使用时间。系统能够根据预设的时间范围自动锁定和解锁电脑，实现工作与休息时间的科学分配，支持跨日时间范围判断，确保锁定逻辑准确可靠。
核心价值在于帮助用户养成良好的时间使用习惯，提高工作和学习效率，适用于企业、个人、学生等各类用户群体。
- 智能时间管理：根据配置的时间范围自动锁定系统，支持跨夜锁定
- 跨平台支持：支持 Windows 和 Linux 平台，提供不同的锁定方式
- 全屏休息模式：提供美观的全屏休息界面，支持壁纸和诗词显示
- 灵活配置：通过配置文件自定义时间范围、提醒设置和界面样式
- 关机功能：可设置自动关机时间，确保按时休息
- 提醒功能：在锁定前提供提醒，让用户有时间保存工作
- Python 3.6 或更高版本
- Windows 或 Linux 操作系统
- 克隆或下载项目到本地
- 确保已安装 Python 3.6+
- 需要安装PyQt5（用于提醒界面）：
pip install PyQt5为了帮助您更好地理解系统的运行原理，以下是 TimeLock System 的运行逻辑流程图：
在项目目录中运行以下命令：
python main.pyw系统会自动检查当前时间是否在允许范围内，如果不在，则立即锁定系统。
- 创建 main.pyw 的快捷方式
- 将快捷方式复制到启动文件夹（Win+R 输入 shell:startup）
- 创建启动脚本：
- 在项目目录中创建
timelock.sh文件，内容如下：
- 在项目目录中创建
#!/bin/bash
# TimeLock System 启动脚本
cd /path/to/timelock-system # 此处路径请更换为实际路径
python3 main.pyw- 添加执行权限：
chmod +x timelock.sh- 创建 Desktop 文件：
- 创建
timelock.desktop文件，内容如下：
- 创建
[Desktop Entry]
Type=Application
Name=TimeLock System
Exec=/path/to/timelock-system/timelock.sh
Comment=智能时间锁定系统
Terminal=false
Categories=Utility;
X-GNOME-Autostart-enabled=true
- 将 Desktop 文件放入自启动目录：
mkdir -p ~/.config/autostart
cp timelock.desktop ~/.config/autostart/注意：请将 /path/to/timelock-system 替换为您实际的项目路径。
系统通过 config.json 文件进行配置，以下是完整的配置项解释：
设置允许使用计算机的时间范围，格式为 24 小时制：
{
"time_ranges": [
{"start": "08:30", "end": "09:55"},
{"start": "10:15", "end": "11:45"},
{"start": "12:50", "end": "15:55"},
{"start": "16:15", "end": "17:30"},
{"start": "18:25", "end": "21:30"}
]
}time_ranges- 时间范围数组，每个元素包含：start- 允许使用的开始时间（24小时制，格式：HH:MM）end- 允许使用的结束时间（24小时制，格式：HH:MM）
shutdown_time- 自动关机时间（24小时制，格式：HH:MM）
"reminder": {
"show_before_minutes": 2
}reminder.show_before_minutes- 锁定前提醒时间（分钟），系统会在锁定前的指定分钟数显示提醒
"break_ui": {
"wallpaper_path": "/mnt/DATA/Administrator/图片/横屏壁纸/",
"wallpaper_path_windows": "D:\Administrator\图片\横屏壁纸\",
"opacity": 0.75,
"blur_effect": true,
"blur_radius": 3,
"show_poem": true,
"poem_api": "https://v1.jinrishici.com/all.json",
"font_color": "#fffdf8",
"font_color_options": [
"#fffdf8",
"#fff",
"#ffd700",
"#00ff00",
"#ff6b6b"
]
}break_ui.wallpaper_path- Linux 系统下的壁纸目录路径break_ui.wallpaper_path_windows- Windows 系统下的壁纸目录路径break_ui.opacity- 休息界面的透明度（0.0-1.0）break_ui.blur_effect- 是否启用模糊效果（true/false）break_ui.blur_radius- 模糊效果的半径（像素）break_ui.show_poem- 是否显示诗词（true/false）break_ui.poem_api- 诗词 API 地址break_ui.font_color- 文字颜色（十六进制颜色码）break_ui.font_color_options- 可选的文字颜色列表
use_fullscreen_lock- 是否使用全屏锁定模式（true/false），设置为true时将使用全屏休息界面作为锁定方式，false时使用系统默认锁定方式
以下是完整的配置文件示例：
{
"time_ranges": [
{"start": "08:30", "end": "09:55"},
{"start": "10:15", "end": "11:45"},
{"start": "12:50", "end": "15:55"},
{"start": "16:15", "end": "17:30"},
{"start": "18:25", "end": "21:30"}
],
"shutdown_time": "21:30",
"reminder": {
"show_before_minutes": 2
},
"break_ui": {
"wallpaper_path": "/path/to/wallpapers/",
"wallpaper_path_windows": "C:\path\to\wallpapers\",
"opacity": 0.75,
"blur_effect": true,
"blur_radius": 3,
"show_poem": true,
"poem_api": "https://v1.jinrishici.com/all.json",
"font_color": "#fffdf8",
"font_color_options": [
"#fffdf8",
"#fff",
"#ffd700",
"#00ff00",
"#ff6b6b"
]
},
"use_fullscreen_lock": false
}除了作为完整系统运行外，您还可以单独运行某些组件来测试或使用特定功能：
功能：显示全屏休息界面，支持壁纸和诗词显示
运行方式：
# 运行指定分钟数的休息界面
python fullscreen_break.pyw <分钟数>
# 示例：运行5分钟的休息界面
python fullscreen_break.pyw 5说明：
- 会显示一个全屏的休息界面
- 从配置的壁纸目录中随机选择壁纸
- 如果启用了诗词功能，会显示随机诗词
- 界面会在指定的分钟数后自动关闭
功能：测试系统的锁定和解锁功能，验证时间范围设置是否正确生效
运行方式：
python test_lock.pyw详细逻辑：
- 加载配置：读取 config.json 文件并保存原始配置
- 修改时间范围：
- 设置第一个时间范围：当前时间-1分钟 到 当前时间+show_before_minutes+1分钟
- 设置第二个时间范围：当前时间+show_before_minutes+2分钟 到 当前时间-2分钟（跨夜）
- 启动测试：运行 main.pyw 进行测试
- 等待过程：等待4分钟让锁定和解锁过程完成
- 清理：终止 main.pyw 进程并恢复原始配置
测试结果说明：
- 系统应该在计算的锁定时间自动锁定
- 系统应该在计算的解锁时间后自动解锁
- 解锁后系统不应该重新锁定
- 测试完成后配置文件已恢复为原始状态
注意：测试过程中会修改配置文件，但测试完成后会自动恢复原始配置，不会影响系统的正常使用。
- Windows：使用系统内置锁定功能
- Linux：优先使用全屏休息模式，其次尝试系统锁定命令
欢迎对项目提出建议和改进。如果您发现问题或有新功能想法，请提交 issue 或 pull request。
© 2026 TimeLock System. All rights reserved.