核心用法
gws-chat 是 Google Workspace CLI (gws) 的 Chat 模块，提供对 Google Chat API 的完整命令行访问。采用标准 RESTful 资源操作模式：
gws chat <resource> <method> [flags]
主要功能模块
空间管理 (spaces)：创建/删除/更新命名空间、设置初始成员 (setup)、完成数据导入 (completeImport)、查找私信 (findDirectMessage)、搜索组织内空间（需管理员权限）。
消息操作 (messages)：通过子资源或辅助命令 +send 发送消息，支持富媒体附件上传下载。
成员管理 (members)：空间成员增删改查，支持批量设置。
自定义表情 (customEmojis)：仅限 Workspace 账户，需管理员开启权限后可创建、删除、列举组织级自定义表情。
媒体处理 (media)：支持附件上传与下载流式操作。
辅助工具
gws schema chat.<resource>.<method>：预检 API 参数结构+send快捷命令：简化单条消息发送流程
显著优点
1. 官方背书：Google Workspace 原生工具链，API 覆盖率完整，与 Workspace Admin Console 权限体系无缝衔接
2. 企业级管控：支持管理员级操作（use_admin_access），满足合规审计需求
3. 导入模式支持：独有的 completeImport 流程，支持从 Slack/Mattermost 等企业 IM 迁移历史数据
4. 基础设施即代码友好：CLI 输出结构化，便于集成到 CI/CD 或运维脚本
潜在缺点与局限性
1. 权限门槛极高：自定义表情、空间搜索等核心功能强制要求 Workspace 付费账户 + 管理员显式开启开关
2. 私信冷启动限制：Group chats 和 DMs 在首条消息发送前无法通过 list 查询（API 设计限制）
3. 名称冲突风险：空间 displayName 组织级唯一，ALREADY_EXISTS 错误需人工重试
4. 认证依赖复杂：依赖 gws-shared 模块的 OAuth2/OIDC 配置，个人 Gmail 账户基本不可用
适合人群
- Workspace 管理员：批量管理组织级 Chat 资源、执行数据迁移
- 企业 DevOps/SRE：将 Chat 空间管理纳入 IaC 工作流
- 集成开发者：调试 Chat API、生成结构化调用模板
常规风险
- 级联删除不可逆：
spaces delete会连带清除所有消息和成员关系，无回收站机制 - 管理员权限放大：
use_admin_access标志可跨空间访问数据，需严格审计 CLI 调用日志 - 数据驻留合规：导入模式涉及历史消息迁移，需确认符合组织数据主权要求（Google 支持 EU/US/Asia 多区域）
版本信息
当前版本：v0.22.3，属于早期迭代版本，建议关注 gws 主版本更新以获取安全补丁。