用途：通过 Mailcoach CLI 管理自托管 Mailcoach 实例的邮件营销，涵盖邮件列表、订阅者、活动（campaign）、事务邮件、模板、自动化、标签、分群与抑制名单。
前提：需先安装并认证 CLI。若命令返回 401，需先执行 mailcoach login 登录；可用 mailcoach list-email-lists 验证认证是否生效。
命令发现：命令由 Mailcoach OpenAPI 规范自动生成，应动态发现而非猜测。用 mailcoach list 列出全部命令，用 mailcoach <command-name> --help 查看某命令的全部选项。命令采用 kebab-case，如 list-email-lists、create-subscriber、send-campaign、send-transactional-mail、trigger-automation 等。
参数：路径参数如 {emailList} 变为必填选项 --email-list=<uuid>；查询参数如 filter[search] 变为可选选项 --filter-search=<value>；snake_case 与 camelCase 均转为 --kebab-case。
发送数据：创建/更新优先用 JSON 体 --input '{"name": "Newsletter"}'；也可用可重复的 --field name="Newsletter"；文件上传在路径前加 @，如 --field csv=@/path/to/subscribers.csv。--field 值默认按 JSON 发送，含文件时整个请求切换为 multipart/form-data。同一命令不能混用 --field 与 --input。
输出：默认人类可读表格，支持 --json、--yaml、--minify、--H（响应头）、--output-html。需要提取 UUID 供后续命令使用时务必加 --json。
筛选与分页：支持 --filter-search（模糊搜索）、--sort（字段名，前缀 - 表示降序）、--filter-per-page（每页最多 100，默认 15）、--filter-page。
错误处理：401 认证失败需重新登录；422 校验错误，响应体含无效字段详情；404 资源不存在，核对 UUID；缺少路径参数时 CLI 会提示所需 --option。所有错误以非零码退出，可用 && 串联命令。HTML 错误响应默认隐藏正文，加 --output-html 查看。
注意：Mailcoach 为自托管，每个用户在登录时配置唯一实例 URL；OpenAPI 规范缓存 24 小时，命令疑似过时可用 mailcoach clear-cache 强制刷新；API 全程以 UUID 标识资源。