cli-anything-zoom 是做什麼的？
用於 Zoom 的 CLI 工具 — 從命令列透過 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 輸出執行（供代理程式使用）
cli-anything-zoom --json project info -p project.json
REPL 模式
當不帶子指令呼叫時，CLI 會進入互動式 REPL 階段：
cli-anything-zoom
# 以互動方式輸入指令，支援 Tab 補全和歷史記錄
指令群組
驗證
身分驗證與 OAuth2 設定。
| 指令 | 說明 |
|---|---|
setup | 設定 OAuth 應用程式憑證 |
login | 透過 OAuth2 瀏覽器流程登入 |
status | 檢查驗證狀態 |
logout | 移除已儲存的權杖 |
會議
會議管理指令。
| 指令 | 說明 |
|---|---|
create | 建立新的 Zoom 會議 |
list | 列出會議 |
info | 取得會議詳細資訊 |
update | 更新會議 |
delete | 刪除會議 |
join | 在瀏覽器中開啟會議加入網址 |
start | 在瀏覽器中開啟會議開始網址（僅限主持人） |
參與者
參與者管理指令。
| 指令 | 說明 |
|---|---|
add | 為會議註冊參與者 |
add-batch | 從 CSV 檔案批次註冊參與者 |
list | 列出已註冊的參與者 |
remove | 取消參與者的註冊 |
attended | 列出參加過往會議的參與者 |
錄製
雲端錄製管理。
| 指令 | 說明 |
|---|---|
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標記）：結構化 JSON，供代理程式使用
# 人類輸出
cli-anything-zoom project info -p project.json
# 供代理程式使用的 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