关于 cli-anything-anygen
cli-anything-anygen 是用于 AnyGen OpenAPI 的有状态命令行工具,可根据自然语言提示词生成幻灯片、文档、网站、图表等内容。它面向 AI Agent 和高级用户,提供任务工作流、参考文件上传以及会话撤销和重做。
主要功能
- 01创建并跟踪生成任务
- 02轮询任务、下载文件和缩略图
- 03上传参考文件
- 04通过多轮交互梳理需求
- 05以 JSON 保存项目状态
- 06交互式 REPL 支持撤销和重做
适用场景
- 01根据提示词生成文档或幻灯片
- 02为生成任务上传参考资料
- 03跟踪任务并下载完成后的输出
- 04在交互式项目会话中撤销或重做更改
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hkuds/ cli-anything --skill cli-anything-anygen安装后在 Claude Code 中输入/cli-anything-anygen确认已加载。
详细介绍
cli-anything-anygen
AnyGen OpenAPI 的有状态命令行界面——通过自然语言提示词生成专业的幻灯片、文档、网站、图表等。专为 AI Agent 和高级用户设计。
安装
此 CLI 作为 cli-anything-anygen 包的一部分安装:
pip install cli-anything-anygen
前置条件:
- Python 3.10+
- 系统中必须安装 anygen
用法
基本命令
# Show help
cli-anything-anygen --help
# Start interactive REPL mode
cli-anything-anygen
# Create a new project
cli-anything-anygen project new -o project.json
# Run with JSON output (for agent consumption)
cli-anything-anygen --json project info -p project.json
REPL 模式
不带子命令调用时,CLI 会进入交互式 REPL 会话:
cli-anything-anygen
# Enter commands interactively with tab-completion and history
命令组
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
# Or with JSON output for programmatic use
cli-anything-anygen --json project new -o myproject.json
交互式 REPL 会话
启动支持撤销/重做的交互式会话。
cli-anything-anygen
# Enter commands interactively
# Use 'help' to see available commands
# Use 'undo' and 'redo' for history navigation
状态管理
CLI 通过以下方式维护会话状态:
- 撤销/重做:最多 50 级历史记录
- 项目持久化:将项目状态保存/加载为 JSON
- 会话跟踪:跟踪修改和变更
输出格式
所有命令都支持双输出模式:
- 人类可读(默认):表格、颜色、格式化文本
- 机器可读(
--json标志):供 Agent 使用的结构化 JSON
# Human output
cli-anything-anygen project info -p project.json
# JSON output for agents
cli-anything-anygen --json project info -p project.json
面向 AI Agent
以编程方式使用此 CLI 时:
- 始终使用
--json标志以获得可解析的输出 - 检查返回码——0 表示成功,非零表示错误
- 解析 stderr 以获取失败时的错误消息
- 对所有文件操作使用绝对路径
- 在导出操作后验证输出是否存在
更多信息
- 完整文档:参见包中的 README.md
- 测试覆盖率:参见包中的 TEST.md
- 方法论:参见 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0
评论
支持 Markdown