一、项目概述
CLI-Anything 是由香港大学数据科学实验室(HKUDS)开发的开源项目,核心目标是让所有软件都能被 AI Agent 原生调用。
| 项目指标 | 数值 |
|---|---|
| Stars | 1.1k |
| Forks | 110 |
| Watchers | 7 |
| 主要语言 | Python (99.7%) |
| 测试通过率 | 100% (1,436 tests) |
二、核心问题与解决方案
2.1 现有痛点
| 痛点 | 具体表现 |
|---|---|
| AI 无法使用真实工具 | 现有方案要么是脆弱的 UI 自动化,要么是功能阉割的重新实现 |
| UI 自动化不可靠 | 截图、点击、RPA 等方式容易崩溃 |
| Agent 需要结构化数据 | 缺乏标准化的输出格式 |
| 定制集成成本高 | 每个软件都需要单独开发接口 |
| 原型与生产差距大 | 缺乏真实软件验证 |
2.2 CLI-Anything 的解决思路
核心洞察:CLI(命令行界面)是人类和 AI Agent 的通用接口
- ✅ 结构化且可组合 — 文本命令匹配 LLM 格式,可链式组合复杂工作流
- ✅ 轻量且通用 — 最小开销,跨系统无依赖
- ✅ 自描述 —
--help标志提供自动文档,Agent 可自动发现 - ✅ 已验证成功 — Claude Code 每天通过 CLI 运行数千个真实工作流
- ✅ Agent 优先设计 — 结构化 JSON 输出消除解析复杂性
- ✅ 确定且可靠 — 一致结果实现可预测的 Agent 行为
三、技术架构
3.1 七阶段全自动流水线
/cli-anything <software-path-or-repo>
↓
1. 🔍 Analyze(分析)— 扫描源代码,映射 GUI 动作到 API
2. 📐 Design(设计)— 架构命令组、状态模型、输出格式
3. 🔨 Implement(实现)— 构建 Click CLI,含 REPL、JSON 输出、撤销/重做
4. 📋 Plan Tests(规划测试)— 创建 TEST.md,含单元测试+E2E 测试计划
5. 🧪 Write Tests(编写测试)— 实现全面测试套件
6. 📝 Document(文档)— 更新 TEST.md 结果
7. 📦 Publish(发布)— 创建 setup.py,安装到 PATH

