cli-anything-zoom 是做什么的?
CLI 控制工具,用于 Zoom — 通过命令行和 Zoom REST API 管理会议、参与者及录制文件。
安装
此 CLI 作为 cli-anything-zoom 包的一部分安装:
pip install cli-anything-zoom
前置条件:
- Python 3.10+
- 系统上必须安装 zoom
使用说明
基本命令
# 查看帮助
cli-anything-zoom --help
# 启动交互式 REPL 模式
cli-anything-zoom
# 创建新项目
cli-anything-zoom project new -o project.json
# 以 JSON 输出运行(供 AI 代理使用)
cli-anything-zoom --json project info -p project.json
REPL 模式
当不带子命令调用时,CLI 会进入交互式 REPL 会话:
cli-anything-zoom
# 以交互方式输入命令,支持 tab 补全和历史记录
命令组
Auth(认证)
认证和 OAuth2 设置。
| 命令 | 说明 |
|---|---|
setup | 配置 OAuth 应用凭据 |
login | 通过 OAuth2 浏览器流程登录 |
status | 检查认证状态 |
logout | 移除已保存的令牌 |
Meeting(会议)
会议管理命令。
| 命令 | 说明 |
|---|---|
create | 创建新的 Zoom 会议 |
list | 列出会议 |
info | 获取会议详细信息 |
update | 更新会议 |
delete | 删除会议 |
join | 在浏览器中打开会议加入链接 |
start | 在浏览器中打开会议开始链接(仅主持人) |
Participant(参与者)
参与者管理命令。
| 命令 | 说明 |
|---|---|
add | 为会议注册参与者 |
add-batch | 从 CSV 文件批量注册参与者 |
list | 列出已注册的参与者 |
remove | 取消参与者的注册 |
attended | 列出参加过过去会议的参与者 |
Recording(录制)
云端录制管理。
| 命令 | 说明 |
|---|---|
list | 列出云端录制文件 |
files | 列出特定会议的录制文件 |
download | 下载录制文件 |
delete | 删除会议的所有录制文件 |
示例
创建新项目
创建新的 zoom 项目文件。
cli-anything-zoom project new -o myproject.json
# 或者以 JSON 输出用于程序化使用
cli-anything-zoom --json project new -o myproject.json
交互式 REPL 会话
启动支持撤销/重做的交互式会话。
cli-anything-zoom
# 以交互方式输入命令
# 使用 'help' 查看可用命令
# 使用 'undo' 和 'redo' 进行历史导航
状态管理
CLI 会维护会话状态,包括:
- 撤销/重做:最多 50 层历史记录
- 项目持久化:将项目状态保存/加载为 JSON
- 会话跟踪:跟踪修改和变更
输出格式
所有命令均支持双输出模式:
- 人类可读(默认):表格、颜色、格式化文本
- 机器可读(
--json标志):供 AI 代理消费的结构化 JSON
# 人类输出
cli-anything-zoom project info -p project.json
# AI 代理使用的 JSON 输出
cli-anything-zoom --json project info -p project.json
供 AI 代理使用
以编程方式使用此 CLI 时:
- 始终使用
--json标志 以获得可解析的输出 - 检查返回码 - 0 表示成功,非零表示错误
- 解析 stderr 以获取失败时的错误信息
- 使用绝对路径 处理所有文件操作
- 验证输出是否存在 在导出操作之后
更多信息
- 完整文档:请参阅包内的 README.md
- 测试覆盖率:请参阅包内的 TEST.md
- 方法说明:请参阅 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0