# @calliopelabs/cli 中文文档

规范地址：https://npmcn.com/package/%40calliopelabs/cli/

版本：3\.8\.0
npm 元数据更新时间：2026-11-04T19:55:07.847Z
中文译文更新时间：2026-11-09T00:17:07.881Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40calliopelabs/cli
原文对照：https://npmcn.com/package/%40calliopelabs/cli/?lang=original
项目主页：https://github.com/calliopeai/calliope-cli#readme
源码仓库：https://github.com/calliopeai/calliope-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.1 MB，1378 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：16 个
- 首次发布：2026-01-09T17:23:49.320Z
- 最新版本发布：2026-11-04T19:55:07.429Z
- 近 30 天下载量：2137（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：90（近 12 个月 90 个）

## 中文简介

私人AI代理CLI - 一个终端代理 任何型号后端,包括你自己运行的

## 安装

```sh
npm install @calliopelabs/cli
```

也可以使用：`pnpm add @calliopelabs/cli`、`yarn add @calliopelabs/cli`、`bun add @calliopelabs/cli`

## README

# 卡里欧普CLI

**私人AI特工CLI.** 任何型号后端都有一个终端代理 包括你自己运行的 麻省理工学院有执照,有小核,没有锁入.

```bash
npm install -g @calliopelabs/cli
calliope
```

单二进制安装通过Homebrew和a `curl` 安装器, 不需要节点 [安装为单个二进制](https://npmcn.com/package/%40calliopelabs/cli/docs/getting-started.md#install-as-a-single-binary)。 。 。 .

## 为什么是Calliope

-   **任何后端,现场发现.** 主机供应商,本地运行时间,与OpenAI兼容的服务器共享相同的工作流程. 从提供者API中发现了模型和能力;不支持或未知的行为保持清晰. 见 [供应商矩阵和实线证据](https://npmcn.com/package/%40calliopelabs/cli/docs/provider-conformance.md)。 。 。 .
-   **为你自己运行的模型而建.** Ollama和自办OpenAI兼容服务器是一等目标,而不是复选框. 运行全空加载.
-   **沙盒第一处决.** 壳和代码工具运行在macOS Seatbelt或多克沙盒内(`auto`编号 :`native`编号 :`docker`编号 :`off`) (中文(简体) ). 块状是咨询;沙盒是边界.
-   **在长会期内存活下来的安全道.** 断路器、重复预算、基站检查站 `/restore`上下文自动收缩.
-   **治理建设在.** Tamper不言自明的审计记录(默认),a `replay` 命令检查和验证它们,在运行超时停止运行的预算上限,以及外部允许/拒绝引擎的预工具策略钩。 见 [文件/施政](https://npmcn.com/package/%40calliopelabs/cli/docs/governance.md)。 。 。 .
-   **排版判决.** `calliope judge` 对照 noul/choice/core 问题评价一个状态,返回您的代码可以从任何后端(包括本地 Ollama)或本地TypeSafe 引擎上分支的概率和信心。 见 [文件/判断](https://npmcn.com/package/%40calliopelabs/cli/docs/judgments.md)。 。 。 .
-   **专注指挥表面.** 23个命令,加上可选的舰队模式. 这个 [命令引用](https://npmcn.com/package/%40calliopelabs/cli/docs/commands.md) 记录可用的工作流程和子命令.
-   **被测试为基础设施.** 3500个测试,93分线覆盖 强制90%的地板.

## 3.2里有什么新鲜事

3.2 将提供者基金会转变为项目工作中心:现场提供者保健和 模型发现, `/doctor` 诊断、健康意识的路径、可复诊、, 流式安全复试,以及 `auto` 允许模式来自同一区域 终端和无头接口。 它还增加了经过审查的与规划者的协调, 工人和核查者的角色、孤立地执行、有限度的重新试验/重新规划监督, 可审核的文物,以及当地脑/KG的出处-了解出处的项目记忆.

发布内容包括本土贝德洛克推理保存,Google的 `@google/genai` 适配器,扩展了DeepSeek/Cerebras和OpenAI兼容的覆盖,以及真线 提供证据。 见 [3.2.0 发行说明](https://npmcn.com/package/%40calliopelabs/cli/docs/releases/3.2.0.md) 联 合 国 完整的特性和验证细节.

## 快开始

```bash
calliope --setup        # pick a provider, paste a key (or point at Ollama)
calliope                # start a session in the current directory
```

在会场内:

```
/mode plan              think first — the agent proposes, you approve
/mode auto              execute without per-tool approval prompts this session
/model list             see live-discovered models for your provider
/defaults save          save the current provider/model for this project
/scope add ../lib       widen file access deliberately
/compact                compress context when it grows
/restore                list git checkpoints; /restore <path> to roll back
/help                   everything else — it fits on one screen
```

无头 CI 和脚本:

```bash
calliope --headless --json "run the tests and summarize failures"
```

在固定预算范围内规划项目目标,然后核准退回的散列提案:

```bash
calliope orchestrate "Inspect the parser and propose a focused fix" --cost 1 --json
calliope orchestrate approve GOAL_ID PROPOSAL_HASH --allow-mutations --json
```

规划出口5供审查 [目标工作流程](https://npmcn.com/package/%40calliopelabs/cli/docs/goal-planning.md) 文档 范围限制、批准、追回和JSON合同. `/orchestrate` 提交 (a) 恢复方案的拟议计划和核准对话.

添加 [`--supervise --isolation-image sha256:ID`](https://npmcn.com/package/%40calliopelabs/cli/docs/continuous-supervision.md#start-from-a-goal) (b) 提出一项孤立的工作; 选择分开 控制器、工人和可选执行审查器模型; 现有高级UD显示 角色、任务尝试和有限度的监督回合。 规划仍只读 而执行则需要批准确切的计划.

执行经审查的项目任务图,并配有限定的代理:

```bash
calliope run plan.json --dry-run --json
calliope run plan.json --allow-mutations --json
```

独立任务与每个代理人的许可和共享预算同时进行. 记录文物检查确定完成情况;未经核实的标准要求人为 验收。 见 [协调员执行](https://npmcn.com/package/%40calliopelabs/cli/docs/coordinator-execution.md) 计划 合同、供应商要求、取消和收回.

本地记录和查询项目知识, 不要求模型 :

```bash
calliope brain init --allow-mutations
calliope brain ingest docs/design.md --allow-mutations
calliope brain search "storage decision" --json
calliope kg graph
```

这个 [项目大脑](https://npmcn.com/package/%40calliopelabs/cli/docs/project-brain.md) 保存源代码, 支持 人文审查与倒置, 跟踪已失效的文件, 和链接 核实运行的证据. 使用 `/brain` 财务报告和审定财务报表 `/kg` 用于REPL中相同的控制.

## 配置

一个文件,16个钥匙。 证书以每张提供方地图的形式提供,并附有环境可变倒数:

```jsonc
{
  "defaultProvider": "anthropic",
  "providers": {
    "anthropic": { "apiKey": "sk-ant-..." },
    "ollama":    { "baseUrl": "http://localhost:11434" }
  },
  "sandboxMode": "auto",
  "routing": { "enabled": false, "costSensitivity": 0.3 }
}
```

`ANTHROPIC_API_KEY`, (中文(简体) ), `OPENAI_API_KEY`, (中文(简体) ), `OLLAMA_BASE_URL`朋友和以前一样工作 v2 配置在第一次运行时自动迁移 .

文档 : [开始中](https://npmcn.com/package/%40calliopelabs/cli/docs/getting-started.md) • 妇女 [命令](https://npmcn.com/package/%40calliopelabs/cli/docs/commands.md) • 妇女 [配置](https://npmcn.com/package/%40calliopelabs/cli/docs/configuration.md) • 妇女 [模式偏好](https://npmcn.com/package/%40calliopelabs/cli/docs/model-preferences.md) • 妇女 [供应商](https://npmcn.com/package/%40calliopelabs/cli/docs/providers.md) • 妇女 [特性](https://npmcn.com/package/%40calliopelabs/cli/docs/features.md) • 妇女 [舰队模式](https://npmcn.com/package/%40calliopelabs/cli/docs/fleet.md)

### ChatGPT 计划访问

运行 `calliope auth chatgpt login` 以选择订阅支持的 OpenAI 访问. 使用 `calliope auth chatgpt status` 检查账户,以及 `api-key` 返回到 API收费平台. 见 [ChatGPT 计划访问](https://npmcn.com/package/%40calliopelabs/cli/docs/chatgpt-plan.md) 账户 管理、产出/预算限制和现场核证要求.

## 编辑器

以 Calliope 身份运行 [代理客户协议](https://agentclientprotocol.com/) 代理人(`calliope acp`) 在Zed,JetBrains,Neovim等ACP编辑器内部——客户端文件编辑,每个工具权限,以及相同的审计线索. 见 [文件/附录](https://npmcn.com/package/%40calliopelabs/cli/docs/acp.md)。 。 。 .

### 当地克劳德计划进入

运行 `calliope claude status`,则 `calliope claude -- <prompt>` 代表你们 已经安装了 克劳德探员 Claude在此拥有权限和计划用途 模式。 见 [当地克劳德代表团](https://npmcn.com/package/%40calliopelabs/cli/docs/claude-plan.md)。 。 。 .

## 舰队模式

协调一支由特工和人类操作员组成的舰队,覆盖一个自我托管的IRC频道,该频道作为审计线索翻了一番. 默认关闭, 禁用时为零 。 见 [文件/传单,md](https://npmcn.com/package/%40calliopelabs/cli/docs/fleet.md)。 。 。 .

## 项目内存

使用 `AGENTS.md` 用于便携式寄存器指令和 `CALLIOPE.md` 用于项目内存。 信任指令从检查出根加载到工作目录,并带有源路径和目录优先级 . `/memory sources` 显示适用文件; `/memory reload` 刷新他们。 见 [仓库指令](https://npmcn.com/package/%40calliopelabs/cli/docs/instructions.md)。 。 。 .

## 3⁄4 ̄ ̧漯b

v3是一种故意的减少:84个指令,40个配置键,和~20k行的投机特征(主题包,伴奏,多代理管弦乐,嵌入式API服务器等)被移除,使核心快速,可预见,可维护. 完整清单和理由 [变动情况](https://npmcn.com/package/%40calliopelabs/cli/CHANGELOG.md) 编辑 [v3.0 路线图](https://github.com/calliopeai/calliope-cli/issues/195)。 。 。 .

单二进制安装,强制执行性能预算,治理,ACP编辑器集成,以及由v3.0. 见 [文件/施政](https://npmcn.com/package/%40calliopelabs/cli/docs/governance.md) 财务报告和审定财务报表 [文件/当地模型](https://npmcn.com/package/%40calliopelabs/cli/docs/local-models.md)。 。 。 .

这个 [下一版路线图](https://github.com/calliopeai/calliope-cli/issues/254) 优先考虑各提供者之间一致的执行、便携式会话和指示,以及衡量任务可靠性。 这个 [首次执行](https://github.com/calliopeai/calliope-cli/issues/255) 通过供应商请求、复试和当地程序增加取消,加上范围 `AGENTS.md` 支助。 见 [取消行为](https://npmcn.com/package/%40calliopelabs/cli/docs/features.md#cancellation)。 。 。 .

## 捐款

问题和PR欢迎—— [捐款额](https://npmcn.com/package/%40calliopelabs/cli/CONTRIBUTING.md)编码库是带有反应/墨水的TypeScript无害环境管理; `npm test` 必须保持绿色,覆盖必须超过90%.

## 许可证

麻省理工学院 Calliope实验室公司

## 代码迁移工具包

包装 [迁移游戏本](https://npmcn.com/package/%40calliopelabs/cli/docs/migration-playbook.md) 提供版本 初步清单、基线、评估和核查的协助者 JavaScript-to-TypeScript CLI适配器. 发现他们离线 `calliope migration capabilities --json`; 本地审查的处决仍然是 授权工人指挥、预算和档案范围.

## 常见问题

### @calliopelabs/cli 是什么？

私人AI代理CLI - 一个终端代理 任何型号后端,包括你自己运行的

### 如何安装 @calliopelabs/cli？

在项目目录运行 npm install @calliopelabs/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 calliope，可以用 npx calliope 直接运行。

### @calliopelabs/cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @calliopelabs/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @calliopelabs/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @calliopelabs/cli 可以商用吗？

@calliopelabs/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @calliopelabs/cli 的下载量有多少？

根据 npm 官方下载统计，@calliopelabs/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,137 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @calliopelabs/cli 还在维护吗？

最新版本 3\.8\.0 发布于 2026/11/05（4 天前）；至今共发布 90 个版本，其中过去 12 个月发布了 90 个；首次发布于 2026/01/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。