如何使用 CLI-Anything 为软件服务生成 CLI

# 如何使用 CLI-Anything 为软件服务生成 CLI

## 核心要求

要使用 CLI-Anything 为软件服务生成 CLI，你需要准备以下材料：

### 1. 软件源码
– **本地源码路径**：如 `./gimp` 或 `/home/user/software`
– **GitHub 仓库链接**：如 `https://github.com/blender/blender`
– **重要**：CLI-Anything 的 7 阶段流程依赖于源码分析，闭源软件（仅提供编译二进制）可能会导致生成的 CLI 质量和覆盖范围下降。

### 2. 目标软件已安装
– 生成的 CLI 会调用实际的软件进行渲染、导出等操作（如 LibreOffice 生成 PDF、Blender 渲染 3D 场景）
– 因此需要确保目标软件已在系统中安装并可访问

### 3. 支持的 AI 编码代理
– **Claude Code**（推荐）：通过插件市场安装
– **OpenCode**（实验性）：复制命令文件到对应目录
– **Codex**（实验性）：安装技能包

## 生成 CLI 的步骤

### 方法一：通过 Claude Code 插件（推荐）

1. **添加 CLI-Anything 插件市场**
“`bash
/plugin marketplace add HKUDS/CLI-Anything
“`

2. **安装 cli-anything 插件**
“`bash
/plugin install cli-anything
“`

3. **生成 CLI**
– 从本地源码生成：
“`bash
/cli-anything ./path/to/software
“`
– 从 GitHub 仓库生成：
“`bash
/cli-anything https://github.com/username/repository
“`

4. **生成过程**
CLI-Anything 会自动执行 7 个阶段的流程：
– 🔍 **分析**：扫描源码，映射 GUI 操作到 API
– 📐 **设计**：架构命令组、状态模型、输出格式
– 🔨 **实现**：构建带有 REPL、JSON 输出、撤销/重做的 Click CLI
– 📋 **计划测试**：创建包含单元和端到端测试计划的 TEST.md
– 🧪 **编写测试**：实现全面的测试套件
– 📝 **文档**：更新 TEST.md 并添加结果
– 📦 **发布**：创建 `setup.py`，安装到 PATH

### 方法二：使用 OpenCode（实验性）

1. **安装命令**
“`bash
# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 全局安装
cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/

# 或项目级安装
cp CLI-Anything/opencode-commands/*.md .opencode/commands/
cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/
“`

2. **生成 CLI**
“`bash
/cli-anything ./path/to/software
“`

### 方法三：使用 Codex（实验性）

1. **安装技能**
“`bash
# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git

# 安装技能
bash CLI-Anything/codex-skill/scripts/install.sh
“`

2. **生成 CLI**
“`text
Use CLI-Anything to build a harness for ./path/to/software
“`

## 特殊情况处理

### 1. Web 服务/API 类软件
– 如果目标是 Web 服务（如 Zoom），CLI-Anything 会分析 API 文档或 SDK，生成封装 API 调用的 CLI
– 例如 Zoom CLI 通过 Zoom REST API 实现功能

### 2. 无源码软件
– 对于无源码的闭源软件，CLI-Anything 可能需要反编译或基于文档生成 CLI，但效果会大幅下降
– 建议优先使用开源替代软件，再为其生成 CLI

## 使用生成的 CLI

生成完成后，进入 `software/agent-harness` 目录安装并使用：

“`bash
# 安装到 PATH
cd software/agent-harness && pip install -e .

# 验证安装
which cli-anything-software

# 使用示例
cli-anything-software –help
cli-anything-software project new –width 1920 –height 1080 -o project.json
cli-anything-software –json layer add -n “Background” –type solid –color “#1a1a2e”

# 进入交互式 REPL
cli-anything-software
“`

## 示例：为 GIMP 生成 CLI

“`bash
# 通过 Claude Code 生成
/cli-anything ./gimp

# 安装生成的 CLI
cd gimp/agent-harness && pip install -e .

# 使用示例
cli-anything-gimp project new –width 1920 –height 1080 -o poster.json
cli-anything-gimp layer add -n “Background” –type solid –color “#1a1a2e”
cli-anything-gimp –json export render output.png -p png –overwrite
“`

## 常见问题

### 1. 生成的 CLI 缺少某些功能
– 使用 `refine` 命令扩展覆盖范围：
“`bash
/cli-anything:refine ./software “需要添加的功能”
“`

### 2. 依赖问题
– 安装生成的 CLI 时可能需要安装额外依赖：
“`bash
pip install numpy pillow # 例如 GIMP CLI 需要的依赖
“`

### 3. 软件未安装
– 确保目标软件已安装且可在命令行中访问
– 例如 `gimp –version`、`blender –version` 等命令应能正常执行

## 总结

– **核心要求**：软件源码（本地或 GitHub）+ 目标软件已安装
– **生成工具**：Claude Code 插件（推荐）或其他支持的 AI 代理
– **生成流程**：自动 7 阶段流程，从源码分析到 CLI 发布
– **使用方式**：pip 安装后通过命令行或 REPL 交互

通过以上步骤，你可以为任何具有源码的软件生成完整的、代理友好的 CLI 接口，使 AI 能够使用专业软件的全部功能。