CLI-Anything 入门：让 Agent 调用真正的软件
CLI-Anything 架构：命令、后端、文件与预览
把主命令路径和视觉反馈路径分开理解。
CLI-Anything 架构：命令、后端、文件与预览知识学习CN编辑简报更新 2026-09-26
你将学会
- 主命令路径
- 预览路径
- 正确性归属原生文件
开始前需要
- Python 打包基础
- 具备实际后端的合法 GUI 软件
发布社区命令之前，先完成窄范围概念验证。
先看结论
- 主命令和预览有不同职责。
- 需要回放时会话历史应只追加。
- 最终证据是原生文件。
主命令路径
harness 解析参数、验证状态、建立或修改工程文件，再调用真实应用导出。指南偏好给 Agent 使用 JSON 输出，并要求缺少依赖时明确报错。
有状态 REPL 可以跨命令保留上下文，一次性 CLI 则更利于确定性输出。应根据应用特性选择，而不是只看提示词偏好。
预览路径
已检查的辅助脚本计算缓存键、建立 bundle 路径、写清单，还能追加实时操作轨迹。它区分可变会话头和只追加的历史记录。
预览捕获负责生产数据，CLI-Hub 等查看器负责消费。预览操作不应暗中改写源工程。
正确性归属原生文件
原生文件必须能被 GUI 重新打开，导出的结果还要检查内容。缩略图好看或进程退出码为零，都只是较弱的证据。
这张图解释规范与辅助脚本，没有把某个实际 harness 的运行轨迹伪装成已验证结果。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
从命令追踪到原生工程文件。
- 2
确认哪个后端进程负责最终渲染。
- 3
找到预览清单并与导出物对照。
可复制示例
text
Command -> project file -> backend export; preview -> separate manifest常见问题
预览 bundle 就是成品吗？
不是，它围绕工程记录预览文件与元数据。
每个 harness 都要 REPL 吗？
不用，指南允许一次性命令和有状态设计。
资料来源
- CLI-Anything / cli-anything-plugin/HARNESS.md来源核查 2026-09-26
- CLI-Anything / cli-anything-plugin/preview_bundle.py来源核查 2026-09-26