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