核心功能
workday-calendar 是一套本地化智能周历管理技能,主打中国法定假日与工作日计算场景。核心能力覆盖四大模块:
1. 工作日计算引擎
- 假日区间管理:以区间形式存储法定节假日,支持AI批量导入,避免逐日维护的繁琐
- 补班日独立追踪:调休上班日期单独记录,与假日数据解耦
- 周末规则可配置:支持双休、单休、大小周等灵活工时制度
- 优先级计算:补班日 > 法定假日 > 周末规则 > 普通工作日,确保复杂调休场景正确计算
2. 日程管理系统
- 完整CRUD:添加、查询、更新、删除日程事件
- 智能空闲查询:在指定时间段内自动识别≥N分钟的连续空闲时段
- 冲突检测:添加日程时自动校验时间重叠
- 批量生成:支持未来N天日程文本一键导出
3. 容灾备份机制
每次保存前自动生成 .bat 自解码备份脚本(最多9个循环覆盖),意外情况下可双击恢复,无需外部依赖。
4. CLI工具链
提供 rules/calculate/calendar/sync/add/list/free/delete/update/schedule/today 等完整命令集,支持脚本化调用。
显著优点
- 本土化深度:针对中国调休/补班制度设计,非通用日历方案可比
- 数据主权:纯本地JSON存储,无云端依赖
- 渐进式文档:核心入口≤230行,详细内容按需加载
- 自动化友好:CLI设计便于定时任务集成
潜在局限
- 手动初始化负担:每年需人工核对假日安排并执行
rules确认 - 无多用户/同步能力:纯本地单用户设计
- 外部日历隔离:明确不接入Google/Outlook,生态封闭
- 备份仅限Windows:
.bat格式限制跨平台恢复
适合人群
- 需要精确计算年度工作日的HR/行政人员
- 关注本土假日安排的个人效率管理者
- 偏好本地数据、拒绝云端日历的隐私敏感用户
- 需要通过脚本自动化日程报告的技术用户
常规风险
- 数据准确性依赖人工输入:官方假日调整需及时手动更新
- 跨年同步非智能:
sync命令仅复制区间,需人工校验新年度差异 - 备份循环覆盖:高频操作下旧备份可能被覆盖,重要变更建议手动另存
- 路径硬编码:
../.standardization相对路径在特定部署场景可能失效