# 港大-CLI-Anything 项目
## 1. 项目介绍
港大-CLI-Anything 是由香港大学开发的一个创新性工具，旨在为各种软件创建命令行界面，使它们能够与AI代理无缝集成。项目的核心价值在于构建AI代理与现有软件之间的桥梁，让明天的AI代理用户能够轻松使用今天为人类设计的软件。
### 为什么选择CLI作为接口？
– **结构化且可组合**：文本命令匹配LLM格式，可链式组合实现复杂工作流
– **轻量且通用**：开销最小，无依赖，跨所有系统工作
– **自描述性**：–help标志提供代理可发现的自动文档
– **已验证的成功**：Claude Code每天通过CLI运行数千个真实工作流
– **代理优先设计**：结构化JSON输出消除了解析复杂性
– **确定性和可靠性**：一致的结果实现可预测的代理行为
## 2. 使用方式
### 前提条件
– Python 3.10+
– 已安装目标软件（如GIMP、Blender、LibreOffice或您自己的应用程序）
– 支持的AI编码代理：Claude Code | OpenCode | Codex | 更多平台
### 通过Claude Code使用
1. **添加市场**
“`bash
/plugin marketplace add HKUDS/CLI-Anything
“`
2. **安装插件**
“`bash
/plugin install cli-anything
“`
3. **一键构建CLI**
“`bash
# 为GIMP生成完整CLI（所有7个阶段）
/cli-anything:cli-anything ./gimp
“`
这将运行完整流程：
– 🔍 分析 — 扫描源代码，将GUI操作映射到API
– 📐 设计 — 架构命令组、状态模型、输出格式
– 🔨 实现 — 构建带有REPL、JSON输出、撤销/重做的Click CLI
– 📋 计划测试 — 创建包含单元+端到端测试计划的TEST.md
– 🧪 编写测试 — 实现全面的测试套件
– 📝 文档 — 更新TEST.md并记录结果
– 📦 发布 — 创建setup.py，安装到PATH
4. **（可选）优化和改进CLI**
“`bash
# 广泛优化 — 代理分析所有功能的差距
/cli-anything:refine ./gimp
# 集中优化 — 针对特定功能领域
/cli-anything:refine ./gimp “I want more CLIs on image batch processing and filters”
“`
### 替代安装方式
如果您不想使用市场：
“`bash
# 克隆仓库
git clone https://github.com/HKUDS/CLI-Anything.git
# 将插件复制到Claude Code插件目录
cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything
# 重新加载插件
/reload-plugins
“`
### 其他平台支持
– **OpenCode**（实验性）：将命令和HARNESS.md复制到OpenCode命令目录
– **Codex**（实验性社区）：运行捆绑的安装程序
## 3. 项目价值
港大-CLI-Anything 项目通过为现有软件创建标准化的命令行接口，极大地扩展了AI代理的能力范围。它不仅简化了AI与软件的交互过程，还为开发者提供了一种快速为其应用程序添加AI兼容性的方法。
该项目的设计理念是面向未来的，认识到AI代理将成为软件的重要用户群体。通过CLI这一通用接口，项目为软件的发展开辟了新的可能性，使其能够更好地适应即将到来的AI时代。