用途：读取、解析并汇总 iCalendar（.ics）文件，适用于 Google Calendar、Apple Calendar 及类似提供商，可用于提取即将到来的事件或按时间范围筛选事件。
主要能力：通过 scripts/read_ics.py 解析 .ics，而不是手工解析文本；支持 JSON 或文本输出；可按 --after、--before、--limit 筛选事件；远程 ICS URL 默认缓存 900 秒。
使用方式：先设置 ICS_URLS 环境变量（多个 URL 用逗号分隔），示例：export ICS_URLS="https://example.com/a.ics,https://example.com/b.ics"。密钥/默认值文件位于 ~/.config/stu-skills/ics-calendar-reader/.env，脚本会自动读取该路径。常用命令：python3 scripts/read_ics.py /path/to/calendar.ics --format json；python3 scripts/read_ics.py --after now --limit 20 --format json；python3 scripts/read_ics.py /path/to/calendar.ics --format text。
输出字段包括 summary、start、end、all_day、location、description、status、uid、organizer、attendees。缓存可用 --cache-ttl 或 ICS_CACHE_TTL_SECONDS 调整，--cache-ttl 0 可禁用缓存；---cache-dir 或 ICS_CACHE_DIR 可改缓存位置。
限制与注意：解析器拒绝 --url 输入，要求从 .env 读取 ICS_URLS；webcal:// 与 webcals:// 会自动规范化为 https://；ICS_URLS 缺失且未提供 ics_path 时脚本会退出并提示向用户询问；不要将私密日历 URL 粘贴到提示词或命令行中；保留带时区的日期时间偏移，不要剥离；面向用户展示时默认使用本地时区与格式 Sat 7 Feb 2026 16:43；重复事件按文件中出现的每个 VEVENT 记录视为一个解析项。其他详细字段语义可参考 references/ics-fields.md。