用途：通过命令行与 Google Chat 交互，支持读取与写入消息、管理空间和私信。需要 Google Workspace 账号，个人 Gmail 账号不支持。所有操作以已认证用户身份发出，写入命令属于对外操作，发送前应与用户确认文本，且不要向用户未指定的频道发送。
首次设置：pip install -r requirements.txt；python scripts/auth.py login（打开浏览器）；python scripts/auth.py status 验证；python scripts/auth.py logout 退出。
主要能力：所有操作通过 scripts/chat.py 完成，首次使用未登录时自动认证。读取类包括 get-messages、get-message、list-threads、list-spaces、find-space、list-members，默认输出紧凑格式，约比原始 API 负载小 14 倍，需要完整 JSON 时加 --raw。写入类包括 send-message、send-dm、reply-in-thread、send-media、edit-message、delete-message、add-reaction、setup-space、find-dm。任意写入命令可加 --dry-run 只打印请求而不实际发送。
编辑与删除：send-message、send-dm、send-media 会返回所创建消息的名称（spaces/X/messages/Y），供 edit-message、delete-message、add-reaction 使用。只能编辑或删除自己发送的消息；修改较早消息需先用 get-messages 找到其名称。
附件：send-media 支持可重复的 --file。仅当所有附件都是媒体（图片或视频）时，Google Chat 才允许一条消息带多个附件；混合批次会自动拆分为每个文件一条消息，说明文字放在第一条。--attachment 仍可作为单个 --file 的别名。
可选别名：可将 directory.example.json 复制为 directory.json，映射短名称（users 与 spaces），使 send-message team "..." 和 send-dm alex "..." 在本地解析，无需 API 调用。directory.json 为个人文件且被 gitignore，完全可选；无法解析的别名会立即报错并列出有效别名。
消息格式：支持 粗体、斜体、~删除线~、代码、三反引号代码块和 <url|label> 链接；不支持 Markdown 标题、表格和 链接，会按字面渲染。
令牌管理：令牌通过系统钥匙串安全存储（macOS Keychain、Windows Credential Locker、Linux Secret Service API），服务名为 google-chat-skill-oauth，过期令牌自动刷新。