技能介绍

要解决的问题

腾讯会议原生 CLI（tmeet）已经覆盖了会议管理、录制、报告、通讯录与会中控制，但它回答不了「人」的问题：这场会应到 12 人、实到几？入会显示名为什么和通讯录对不上？谁迟到了、谁早退了？散会后还要把签到表导出来发群里。二创版 tmeet-people 就是补这条缝。

工作原理

技能从 tmeet-skill@1.0.6 分叉而来，原生命令一行未动，新增能力全部由确定性脚本 scripts/tmeet_people.py 驱动（仅用 Python 标准库），提供 discover / attendance / roster / config 四个子命令。核心链路分三层：

出勤推导：拉取 meeting invitees-list（应到）与 report participants（实到）比对，输出考勤记录。
姓名映射：入会显示名解析为通讯录真实名；匹配不上的保留入会名并标注 [未匹配通讯录]，末尾附校正清单供人工补全。
迟到 / 早退判定：以 meeting get 返回的预定时间为准，宽限期可配置，默认 5 分钟。
导出与通知：roster 生成 Markdown / CSV / HTML 签到看板，含出勤率、迟到早退汇总与校正清单；配置一个 Webhook URL 后，可向企微群机器人推送带会议卡片的通知。
首次校准：正式使用前必须跑一次 python3 scripts/tmeet_people.py discover --meeting-id ...，确认 report participants 的实际字段名。

会中还可轮询 report participants / report waiting-room-log，回答「还有谁没入会」这类实时问题。

边界与注意点

展示会议信息一律用会议号，meeting_id 只作命令行参数，不得暴露给用户。
所有写操作（取消会议、踢人、移除受邀成员等）必须二次确认；control kick 的成员只能来自 report participants，严禁拿通讯录查询结果当来源。
contact search 仅限四类场景，不能当通用人员信息接口。
认证是阻塞命令，需后台运行并把授权 URL 完整展示给用户；时间参数必须是带时区的 ISO 8601 格式。
分页只用 --page-token / --page-size，旧参数已弃用；导出 CSV / HTML 前要告知路径并确认，避免误覆盖。