核心用法
gws-calendar-insert 是 gws CLI 工具的子命令，专用于在 Google Calendar 中创建新事件。通过 OAuth 认证后，用户可通过命令行快速创建日程，支持设置标题、时间、地点、描述、参会者及自动生成 Google Meet 链接。
基本命令结构：
gws calendar +insert --summary <标题> --start <ISO 8601开始时间> --end <ISO 8601结束时间> [可选参数]
关键参数：
--calendar: 指定日历 ID（默认 primary）--location: 地点信息--description: 事件详细描述--attendee: 可多次使用添加参会者邮箱--meet: 自动附加 Google Meet 视频会议链接
显著优点
1. CLI 原生集成：深度嵌入 gws 工具链，与 gws-calendar 其他命令形成完整工作流
2. 时间格式标准化：强制使用 ISO 8601/RFC3339 格式，避免时区歧义
3. 会议自动化：--meet 标志一键生成 Meet 链接，无需手动操作
4. 批量参会者支持：--attendee 可重复调用，适合快速创建多人会议
潜在缺点与局限性
1. 时间格式门槛：要求严格的 RFC3339 格式（如 2026-06-17T09:00:00-07:00），对用户不友好
2. 无交互式向导：纯命令行工具，无 TUI 或向导辅助输入
3. 依赖预认证：必须提前完成 gws-shared 中的 OAuth 配置
4. 功能边界清晰：仅支持创建事件，不支持修改或删除（需调用其他子命令）
5. 会议链接限制：仅支持 Google Meet，无法指定 Zoom/Teams 等其他平台
适合人群
- 开发者/运维人员：习惯终端操作，需自动化日历管理
- 远程团队：频繁创建带视频会议的团队日程
- Google Workspace 重度用户：已完整配置 gws 工具链
- 脚本自动化场景：CI/CD 或定时任务中自动创建会议
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| **误写风险** | 命令直接写入用户主日历，无二次确认 | 文档明确标记 `[!CAUTION]`，要求执行前用户确认 |
| **权限扩散** | OAuth token 可能具有广泛 Calendar 权限 | 遵循 `gws-shared` 安全规则，定期审查 token 范围 |
| **时区错误** | RFC3339 格式复杂，手动输入易出错 | 建议使用脚本生成时间字符串 |
| **参会者隐私** | `--attendee` 直接发送邀请，可能误触外部人员 | 执行前核对邮箱地址 |
版本与生态
- 当前版本：0.22.5
- 依赖：gws CLI 工具、有效的 Google OAuth 认证
- 关联模块：
gws-shared（认证）、gws-calendar（完整日历管理）