wecomcli-schedule 是企业微信命令行程序 wecom-cli 中的日程管理技能，所有操作通过执行 wecom-cli 命令完成，交互方式为 wecom-cli schedule <接口名> '<json入参>'。
一、用途 该技能面向企业微信日程的各类管理需求，主要覆盖五个方面：查询指定时间范围内的日程列表或获取日程详细信息（标题、时间、地点、参与者等）；创建新日程并设置提醒、参与人；修改已有日程的标题、时间、地点等信息或取消日程；添加或移除日程参与人；查询闲忙等。
二、主要能力（接口列表）
- get_schedule_list_by_range：查询日程 ID 列表。入参为 start_time 和 end_time（格式 YYYY-MM-DD HH:mm:ss），返回 schedule_id_list 数组。仅支持当日前后 30 天。
- get_schedule_detail：获取日程详情。入参为 schedule_id_list 数组，支持 1~50 个 ID，返回日程标题、时间、地点、参与者等。
- create_schedule：创建日程。入参包含 schedule 对象，可设置 start_time、end_time、summary（日程标题）、attendees（含 userid）、reminders（如 is_remind、remind_before_event_secs、timezone）。
- update_schedule：修改日程。只需传入需修改的字段，未传字段保持不变，入参包含 schedule_id 及待修改字段。
- cancel_schedule：取消日程。入参为 schedule_id。
- add_schedule_attendees / del_schedule_attendees：管理参与人。入参为 schedule_id 与 attendees 数组（含 userid），分别用于添加和移除。
- check_availability：查询闲忙。入参为 check_user_list（支持 1~10 个用户）、start_time、end_time，返回各用户的忙碌时段列表。
三、使用方式与注意事项
- 时间格式：接口入参使用字符串格式（如 YYYY-MM-DD HH:mm:ss），但返回值多为 Unix 时间戳（秒），使用时需进行格式转换。
- 日程列表查询仅支持当日前后 30 天。
- 涉及参与者 userid 时，需先使用 wecomcli-contact 技能获取；存在同名时展示候选让用户选择，禁止暴露 userid。
- 创建/修改/取消前，先确认目标日程和参与者信息。
- errcode 不等于 0 时展示错误信息。
四、适用场景与典型工作流
- 查询日程：如“我今天有哪些日程？”“帮我看看这周三下午有没有会议”。流程为根据意图计算时间范围，调用 get_schedule_list_by_range 获取 ID 列表，再调用 get_schedule_detail 批量获取详情并转换时间戳；若用户提到关键词则在 summary 中匹配筛选，未找到则逐步扩大范围至前后 30 天上限。
- 创建日程：如“帮我创建一个明天下午 2 点到 3 点的会议，标题叫需求评审”。流程为解析时间、标题、地点、参与人、提醒等信息；涉及参与人先通过 wecomcli-contact 查询 userid；若用户未指定提醒，默认提前 15 分钟提醒（remind_before_event_secs: 900）；若为“全天”，设置 is_whole_day: 1，时间设为当天 00:00:00 至 23:59:59；确认后调用 create_schedule。
- 修改日程：如“把明天的需求评审改到后天下午 3 点”。流程为先定位目标日程，匹配到多个时展示候选让用户确认，确认修改字段与目标值后调用 update_schedule，只传入需修改字段。
- 取消日程：如“取消明天下午的需求评审”。流程为先定位日程，向用户确认日程信息避免误操作，确认后调用 cancel_schedule。
- 管理参与人：如“把张三加到明天的需求评审会议里”。流程为通过 wecomcli-contact 获取 userid，定位目标日程，调用 add_schedule_attendees 或 del_schedule_attendees。
- 查询闲忙并安排会议：如“帮我看看张三和李四明天下午有没有空”。流程为获取相关人员 userid，调用 check_availability 查询忙碌时段，分析并推荐共同空闲时段，用户确认后调用 create_schedule 创建会议并添加参与人。
五、限制 日程列表查询有时间范围限制（仅当日前后 30 天）；时间格式在入参与返回值之间存在字符串与 Unix 时间戳的差异，需要转换；官方资料中未提供关于收费、价格、平台或更多效果的信息，暂未提供。