核心用法
workday-calendar 是一款面向个人与团队的智能周历管理系统，核心能力覆盖三大模块：
1. 工作日计算与周历生成
- 法定假日区间管理：以区间形式存储国家法定节假日，支持AI批量导入
- 补班日管理：单独记录调休上班日期，优先级高于节假日
- 周末规则可配置：支持双休、单休、大小周等灵活工时制度
- 年度工作日计算：自动统计年度总工日，生成周历视图
2. 个人日程管理（CRUD完整）
- 添加日程：指定日期、起止时间、标题、分类（工作/个人/会议/其他）
- 查询功能：按日期查询、日期范围查询、空闲时段自动查找
- 修改与删除：支持更新标题、时间、状态（待完成/已完成/已取消）
- 日程列表生成：自动生成未来N天文本化日程表
3. 容灾备份机制（自动）
每次添加日程前，系统自动创建 .bat 备份文件（编号01-09循环覆盖），使用 certutil -decode 自解码技术，意外情况下可一键回退。
显著优点
1. AI友好设计：提供完整的Python调用接口与CLI命令，便于AI Agent集成
2. 数据本地存储：纯JSON格式，无云端依赖，隐私可控
3. 灵活工时支持：打破固定双休假设，适配大小周、单休等实际场景
4. 智能优先级：补班 > 节假日 > 周末 > 工作日，逻辑清晰
5. 自动化备份：无需手动干预的容灾机制，降低数据丢失风险
6. 开源透明：数据格式、存储位置、计算逻辑完全公开
潜在局限
1. 数据同步依赖：年度节假日数据需手动或AI辅助导入，存在更新延迟风险
2. 无跨平台同步：纯本地存储，多设备使用需自行解决同步问题
3. CLI门槛：非图形界面，对普通用户有一定学习成本
4. 备份容量限制：仅保留9个备份，高频操作场景可能覆盖有用历史
5. 官方数据源：节假日准确性依赖外部输入，建议每年核对官方发布
适合人群
- 需要精确计算工作日的HR、行政、项目经理
- 追求数据本地化的隐私敏感型用户
- 希望AI辅助日程管理的效率工具使用者
- 采用非标准工时制度（大小周/单休）的职场人士
常规风险
- 配置错误风险：初始化后务必执行
rules命令核对节假日配置 - 数据丢失风险：虽有机自备份，仍建议定期导出JSON文件异地保存
- 时区/时间格式错误：24小时制输入，跨午夜时段需分段处理
- 备份覆盖风险：高频添加操作可能导致早期备份被循环覆盖
- 依赖Python环境：需确保Python运行环境及依赖库正常