cli-anything-anygen 是做什麼的？
一個狀態化的命令列介面，適用於 AnyGen OpenAPI——透過自然語言提示產生專業簡報、文件、網站、圖表等。專為 AI 代理與進階使用者設計。
安裝
此 CLI 是作為 cli-anything-anygen 套件的一部分安裝的：
pip install cli-anything-anygen
必要條件：
- Python 3.10+
- 系統上必須安裝 anygen
使用方式
基本指令
# 顯示幫助
cli-anything-anygen --help
# 啟動互動式 REPL 模式
cli-anything-anygen
# 建立新專案
cli-anything-anygen project new -o project.json
# 以 JSON 輸出執行（供代理使用）
cli-anything-anygen --json project info -p project.json
REPL 模式
在不帶子指令的情況下叫用時，CLI 會進入互動式 REPL 工作階段：
cli-anything-anygen
# 使用標籤補全和歷史記錄以互動方式輸入指令
指令群組
Task（任務）
任務管理——建立、輪詢、下載和執行任務。
| 指令 | 說明 |
|---|---|
create | 建立生成任務 |
status | 查詢任務狀態（非阻塞） |
poll | 輪詢任務直到完成（阻塞） |
download | 下載已完成任務的生成檔案 |
thumbnail | 下載已完成任務的縮圖影像 |
run | 完整工作流程：建立、輪詢、下載 |
list | 列出本地快取的任務記錄 |
prepare | 在建立任務前進行多輪需求分析 |
File（檔案）
檔案操作——上傳參考檔案。
| 指令 | 說明 |
|---|---|
upload | 上傳參考檔案以取得 file_token |
Config（設定）
組態管理——API 金鑰與設定。
| 指令 | 說明 |
|---|---|
set | 設定組態值 |
get | 取得組態值（或顯示所有） |
delete | 刪除組態值 |
path | 顯示設定檔路徑 |
Session（工作階段）
工作階段管理——歷史記錄、復原、重做。
| 指令 | 說明 |
|---|---|
status | 顯示工作階段狀態 |
history | 顯示指令歷史記錄 |
undo | 復原上一個指令 |
redo | 重做上一個復原的指令 |
範例
建立新專案
建立新的 anygen 專案檔案。
cli-anything-anygen project new -o myproject.json
# 或用 JSON 輸出供程式化使用
cli-anything-anygen --json project new -o myproject.json
互動式 REPL 工作階段
啟動支援復原/重做的互動式工作階段。
cli-anything-anygen
# 以互動方式輸入指令
# 使用 'help' 檢視可用指令
# 使用 'undo' 和 'redo' 進行歷史記錄導覽
狀態管理
CLI 會維護工作階段狀態，包含：
- 復原/重做：最多 50 層級的歷史記錄
- 專案持久化：將專案狀態儲存/載入為 JSON
- 工作階段追蹤：追蹤修改與變更
輸出格式
所有指令都支援雙重輸出模式：
- 人類可讀（預設）：表格、顏色、格式化文字
- 機器可讀（
--json標誌）：結構化 JSON，供代理使用
# 人類輸出
cli-anything-anygen project info -p project.json
# 供代理使用的 JSON 輸出
cli-anything-anygen --json project info -p project.json
給 AI 代理的注意事項
以程式化方式使用此 CLI 時：
- 始終使用
--json標誌 以取得可解析的輸出 - 檢查回傳碼 - 0 表示成功，非零表示錯誤
- 解析 stderr 以取得失敗時的錯誤訊息
- 使用絕對路徑 進行所有檔案操作
- 驗證輸出是否存在 在匯出操作後
更多資訊
- 完整文件：請參閱套件中的 README.md
- 測試覆蓋率：請參閱套件中的 TEST.md
- 方法論：請參閱 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0