hashSTACS-Global feishu-calendar
模块兼容：所有脚本均提供
.js和.mjs两个版本。优先使用.js，若报require is not defined错误则改用同名.mjs文件。
直接用 exec 执行，不要检查文件或环境。
日历
node ./calendar.js --open-id "ou_xxx" --action list_calendars
node ./calendar.js --open-id "ou_xxx" --action get_primary
日程 CRUD
node ./calendar.js --open-id "ou_xxx" --action create_event --summary "标题" --start-time "ISO8601" --end-time "ISO8601" --attendees "ou_yyy,ou_zzz"
# 重复会议（早会/周会/月会等）— 默认自动创建会议群
node ./calendar.js --open-id "ou_xxx" --action create_event --summary "早会" --start-time "ISO8601" --end-time "ISO8601" --repeat daily --attendees "ou_xxx,ou_yyy"
node ./calendar.js --open-id "ou_xxx" --action create_event --summary "周会" --start-time "ISO8601" --end-time "ISO8601" --repeat weekly --attendees "ou_xxx,ou_yyy"
node ./calendar.js --open-id "ou_xxx" --action create_event --summary "月会" --start-time "ISO8601" --end-time "ISO8601" --repeat monthly --attendees "ou_xxx,ou_yyy"
# 重复会议但不创建会议群
node ./calendar.js --open-id "ou_xxx" --action create_event --summary "早会" --start-time "ISO8601" --end-time "ISO8601" --repeat daily --no-meeting-chat
# 开启自动录制
node ./calendar.js --open-id "ou_xxx" --action create_event --summary "标题" --start-time "ISO8601" --end-time "ISO8601" --auto-record
# 查询日程（不传时间范围则默认查今天，已取消的日程默认隐藏）
node ./calendar.js --open-id "ou_xxx" --action list_events
# 查询指定日期范围
node ./calendar.js --open-id "ou_xxx" --action list_events --start-min "ISO8601" --start-max "ISO8601"
# 显示已取消日程（用户说"显示已取消日程"时使用）
node ./calendar.js --open-id "ou_xxx" --action list_events --show-cancelled
node ./calendar.js --open-id "ou_xxx" --action get_event --event-id "ID" --need-attendee
node ./calendar.js --open-id "ou_xxx" --action update_event --event-id "ID" --summary "新标题"
node ./calendar.js --open-id "ou_xxx" --action delete_event --event-id "ID"
node ./calendar.js --open-id "ou_xxx" --action search_events --query "关键词"
可选：--description --location --all-day（全天时时间用日期格式） --auto-record（自动录制）
--auto-record：开启后会议开始时自动录制- 重复会议（
--repeat或--recurrence）默认自动创建会议群，群内包含所有参与人。传--no-meeting-chat可跳过 - 创建会议群要求：日程至少 2 个参与人且不隐藏参与人列表。不满足条件时静默跳过
--chat-id仅用于忙闲查询按姓名匹配群成员
--repeat 可选值：daily（每天）、weekly（每周）、monthly（每月）、workdays（工作日）
也可用 --recurrence 传原始 RRULE，如 FREQ=WEEKLY;BYDAY=MO,WE,FR
参与者
node ./calendar.js --open-id "ou_xxx" --action add_attendees --event-id "ID" --attendees "ou_yyy"
node ./calendar.js --open-id "ou_xxx" --action list_attendees --event-id "ID"
node ./calendar.js --open-id "ou_xxx" --action remove_attendees --event-id "ID" --attendees "attendee_id"
忙闲
# 按 open_id 查询
node ./calendar.js --open-id "ou_xxx" --action check_freebusy --user-ids "ou_yyy,ou_zzz" --start-time "ISO8601" --end-time "ISO8601"
# 按姓名查询（从当前群成员中匹配，需要 --chat-id）
node ./calendar.js --open-id "ou_xxx" --action check_freebusy --names "张三,李四" --chat-id "oc_xxx" --start-time "ISO8601" --end-time "ISO8601"
--names 和 --user-ids 可混用。按名字查询时必须提供 --chat-id（当前群的 chat_id）。
创建日程的必填参数（create_event）
执行 create_event 前，以下三项必须全部已知。缺少任意一项必须先追问用户，不得跳过或填占位符。
多项缺失时合并成一条消息同时追问，不要分多轮。
| 参数 | 说明 | 缺失时追问 |
|---|---|---|
--summary |
会议主题 | "请问这次会议的主题是什么？" |
--start-time / --end-time |
会议时间 | "请问会议的开始时间和结束时间（或时长）是什么时候？" |
--attendees |
参会人 open_id，逗号分隔 | "请问哪些人需要参加这次会议？" |
处理规则：
- 创建者自动加入参会人：
--attendees中必须包含SENDER_OPEN_ID（当前用户），即使用户未提及自己也要自动添加 - 用户提供姓名而非 open_id → 先执行
node ../feishu-search-user/search-user.js --open-id "SENDER_OPEN_ID" --action search --query "姓名"取得 open_id 再创建 - 时间支持自然语言（"明天下午3点到4点"、"今天16:00开始1小时"），转为
YYYY-MM-DDTHH:mm:ss+08:00格式传入 - 未说明结束时间但说明了时长 → 自动计算
--end-time - 未说明时长也未说明结束时间 → 追问"会议大概开多久？"
授权
若返回 {"error":"auth_required"} 或 {"error":"permission_required"}，不要询问用户是否授权，直接立即执行以下命令发送授权链接：
- 若返回 JSON 中包含
required_scopes字段，将其数组值用空格拼接后传入--scope参数：
node ../feishu-auth/auth.js --auth-and-poll --open-id "SENDER_OPEN_ID" --chat-id "CHAT_ID" --timeout 60 --scope "<required_scopes 用空格拼接>"
若返回中不包含
required_scopes，则不加--scope参数（使用默认权限）。{"status":"authorized"}→ 重新执行原始命令{"status":"polling_timeout"}→ 立即重新执行此 auth 命令（不会重复发卡片）CHAT_ID不知道可省略
权限不足时（应用级）
若返回中包含 "auth_type":"tenant"，说明需要管理员在飞书开放平台开通应用权限，必须将 reply 字段内容原样发送给用户。