核心功能
智能周历系统是一款专注于中国职场场景的时间管理工具，核心能力围绕「法定假日管理」与「个人日程安排」两大模块展开。
法定假日与工作日计算
系统以区间形式存储国家法定节假日，支持AI批量导入新年份数据。通过四级优先级规则（补班日>法定假日>周末规则>工作日）精确计算年度总工日，兼容双休、单休、大小周等灵活工时制度。提供calculate_total_workdays()、generate_weekly_calendar()等API，可一键生成2026年全年247个工作日的统计报告，或导出完整的52周周历数据。
个人日程管理
支持完整的CRUD操作：添加日程时自动检测时间冲突，查询某日空闲时段（find_free_slots），生成未来N天的文本化日程列表。数据采用JSON本地存储，并内置9层循环覆盖的容灾备份机制——每次保存前自动生成.bat自解码备份脚本，意外时可一键回滚。
安全与可靠性
- 数据本地化：所有日程与假日数据存储于用户目录
~/.workbuddy/skills/，无云端传输 - 强制确认机制：初始化新年份后必须通过
rules命令核对配置，避免节假日数据错误导致排程失误 - 备份冗余：9个历史版本循环覆盖，采用
certutil -decode自解码技术，不依赖外部文件
局限性
1. 数据依赖人工初始化：法定假日需每年手动导入或同步，无法自动获取国务院最新放假通知
2. 仅支持中国法定假日：不兼容海外节假日或企业自定义假别
3. 本地化存储风险：无多端同步，设备损坏可能导致数据丢失（虽有备份但需手动恢复）
4. 冲突检测粒度较粗：仅检测时间重叠，不支持会议室资源冲突、人员忙闲等复杂场景
适合人群
- HR/行政人员：年度工作日统计、排班计算
- 项目经理：团队会议安排、空闲时段协调
- 自由职业者/远程工作者：自定义工时制度下的日程规划
- 个人效率管理：习惯用命令行/脚本自动化日程的极客用户
使用建议
每年12月底执行sync或init同步新年份假日数据，务必运行rules命令核对补班日与调休安排——这是避免「以为放假实际补班」尴尬的关键步骤。