CLI-Anything 入门：让 Agent 调用真正的软件
部署 CLI-Anything harness：命令、依赖与权限
把 Python 命令和原生应用作为一个可验证单元交付。
部署 CLI-Anything harness：命令、依赖与权限知识学习CN编辑简报更新 2026-09-26
你将学会
- 打包正确的东西
- 限定写入位置
- 区分预览与发布物
开始前需要
- Python 打包基础
- 具备实际后端的合法 GUI 软件
发布社区命令之前，先完成窄范围概念验证。
先看结论
- Python 安装不会自动带齐原生后端。
- 会话与导出目录都是运行状态。
- 预览元数据不是发布成果。
打包正确的东西
规范描述了带 console_scripts 入口的 Python 包及本地可编辑安装测试。凡是需要原生渲染器的命令，目标软件也必须安装。
记录可执行文件查找方式、系统要求和固定版本。pip 安装成功后，后端仍可能缺失。
限定写入位置
harness 可能生成原生工程、导出媒体文件并缓存预览。应指定输出根目录，并考虑多个会话同时写同一工程；指南要求对 JSON 会话保存加独占锁。
让 Agent 使用仅可访问工作区的账户。命令接受路径参数，并不意味着可以挂载共享生产目录。
区分预览与发布物
预览辅助脚本会在项目或用户目录下写清单和摘要。它们便于排障，但不能证明最终文档或视频已经正确导出。
本文没有构建分发包，也没有运行原生后端。每个目标应用和操作系统都要重新执行部署清单。
如何选择
| 比较维度 | 方案 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
固定 harness 与原生应用版本。
- 2
从另一个工作目录验证安装命令。
- 3
限制输出路径并测试并发会话写入。
可复制示例
text
Package + native backend + allowed workspace + operator review常见问题
能只部署包装层吗？
只有不依赖原生应用的命令才可能，需逐个检查。
pip install -e 就算正式发布吗？
它只是指南中的本地开发验证步骤。
资料来源
- CLI-Anything / cli-anything-plugin/HARNESS.md来源核查 2026-09-26
- CLI-Anything / cli-anything-plugin/commands/cli-anything.md来源核查 2026-09-26
- CLI-Anything / cli-anything-plugin/preview_bundle.py来源核查 2026-09-26