核心用法
gws-chat 是 Google Workspace CLI (gws) 的 Chat 管理模块，提供对 Google Chat API v1 的完整命令行封装。用户可通过 gws chat <resource> <method> 范式操作六大资源类型：spaces（空间管理）、messages（消息操作）、members（成员管理）、customEmojis（自定义表情）、media（媒体上传下载）及 spaceEvents（空间事件）。
关键功能路径：
- 空间生命周期：创建 (
create)、配置 (setup)、更新 (patch)、删除 (delete)、搜索 (search) - 消息交互：依赖子命令
+send快速发送，或调用完整 API 进行线程管理 - 媒体处理：支持附件上传 (
upload) 与下载 (download)，适配文件分享场景 - 企业级功能：自定义表情管理（需管理员开启权限）、导入模式空间 (
completeImport)、管理员空间搜索 (use_admin_access)
认证要求：必须预配置 Google Workspace OAuth 凭据，参考 gws-shared/SKILL.md 完成认证流程。
显著优点
1. 原生 Workspace 集成：直接调用官方 Chat API，操作结果与 Web 客户端实时同步，无同步延迟
2. 管理员能力覆盖：唯一支持 search 空间、completeImport 等企业级功能的 CLI 工具，适合 IT 自动化
3. 链式工作流：通过 gws schema 动态发现 API 结构，配合 --params/--json 实现脚本化批量操作
4. 导入迁移支持：完整支持历史数据导入流程（Import mode → completeImport），助力 Slack/Mattermost 迁移
潜在局限
- 功能依赖组织策略：customEmojis、管理员搜索等核心功能需 Workspace 管理员显式开启权限
- 冷启动限制：群聊和私聊 (
list) 在首次消息发送前不可见，影响新空间枚举 - 命名冲突风险：空间显示名 (
displayName) 全局唯一，更新时可能触发ALREADY_EXISTS错误 - 权限粒度粗：删除空间强制级联删除所有子资源（消息、成员），无软删除或回收站机制
适合人群
- Workspace 管理员：批量管理空间成员、审计空间合规性、执行数据迁移
- DevOps/SRE 团队：将 Chat 操作集成到 CI/CD 通知、事故响应自动化脚本
- 企业集成开发者：构建 Chat 机器人、同步外部系统消息到 Workspace
常规风险
- 数据不可恢复：空间删除为不可逆级联操作，生产环境需前置备份验证
- 权限越界：管理员凭据 (
use_admin_access) 可遍历全组织空间，需遵循最小权限原则 - API 配额限制：频繁调用
search或list可能触发 Chat API 配额上限