# @canra/cli 中文文档

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

版本：0\.9\.0
npm 元数据更新时间：2026-11-05T19:13:15.341Z
中文译文更新时间：2026-11-09T18:32:44.687Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40canra/cli
原文对照：https://npmcn.com/package/%40canra/cli/?lang=original
项目主页：https://canra.dev/docs/api
源码仓库：https://github.com/canra-dev/canra

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

- 包体积（解压后）：35.7 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-10-26T07:01:12.794Z
- 最新版本发布：2026-11-05T19:13:15.195Z
- 近 30 天下载量：1920（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

Canra的 CLI,机器可读光谱的注册:获取,搜索,并发布光谱.

## 安装

```sh
npm install @canra/cli
```

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

## README

# @canra/ cli (英语)

命令行客户端 [坎拉语Name](https://canra.dev/),用于记录机器可读规格(图书馆API,协议,数据格式). 获取一个 spec, 用任意语言生成一个执行, 并对照 spec 的测试向量检查 .

在20+节点或Bun上运行. 不需要安装 :

```sh
npx @canra/cli search json
npx @canra/cli info canra/json
npx @canra/cli fetch canra/json
```

## 图标

或者安装它来得到 `canra` 命令 :

```sh
npm install -g @canra/cli
canra search json
```

| 命令 | 它会做什么 |
| --- | --- |
| `canra search <query>` | 搜索登记册 |
| `canra info <owner>/<name>` | 显示 spec 的元数据 |
| `canra fetch <owner>/<name>[@version]` | 下载一个光谱(最新版本或被绑定版本),验证其SHA-256,并将其保存到 `.canra/specs/<owner>/<name>/` |
| `canra outdated [--json]` | 检查获取的新版本的规格; 如果有已过时或已隔离, 则退出 1 |
| `canra update [<owner>/<name>]` | 重排每个已过时光谱的最新版本( 或命名的光谱); 如果任何光谱被隔离或无法更新, 则退出 1 |
| `canra remove <owner>/<name>` | 删除从中获取的光谱 `.canra/specs/` |
| `canra login` | 保存注册 URL 和 API 令牌 |
| `canra whoami` | 显示您保存的令牌所属的账户 |
| `canra publish <file.spec.md> [--accepts <suggestion-id>]` | 发布 spec( 需要一个符号) ; `--accepts` 标出所接受类别的建议 |
| `canra suggest <owner>/<name> --title "..." [--body "..."] [--file <path.spec.md>]` | 提议更改您没有的规格( 需要一个符号); `--file` 附上编辑的完整规格, 所有者作为 diff 加以审查 |
| `canra logout` | 删除已保存的证书 |
| `canra version` 编号 : `canra help` | 版本和使用 |

`<owner>` 在任何情况下均为用户或组织名称: `Canra/json` 财务报告和审定财务报表 `canra/json` 是同一个 spec, 保存在小写所有者在 `.canra/specs/`。 。 。 .

## 销售规格

提交 `.canra/` 到源控件。 保存的光谱是您项目执行的光谱版本的记录( 一个版本是准确的和不可改变的) 。 之后 `canra update`, (中文(简体) ), `git diff .canra/` 显示每个规格中的变化.

## 出版

在 **cara.dev – 账户 – API 令牌**,选择其权限并过期(`canra publish` 需求 **发布规格**),然后:

```sh
npx @canra/cli login        # paste the token when asked
npx @canra/cli publish my-spec.spec.md
```

全权证书存于 `~/.canra/config.json`。 。 。 .

## 对于特工

您可能根本不需要CLI :

-   原始光谱下标记 : `https://canra.dev/specs/{owner}/{name}.md`
-   LLMs 的站点索引 : `https://canra.dev/llms.txt`
-   远程 MCP 服务器( 无认证) : `https://canra.dev/mcp`,比如说. `claude mcp add --transport http canra https://canra.dev/mcp`

API 文档 : [https://canra.dev/docs/api (英语)](https://canra.dev/docs/api)

## 许可证

麻省理工学院

## 常见问题

### @canra/cli 是什么？

Canra的 CLI,机器可读光谱的注册:获取,搜索,并发布光谱\.

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

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

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

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/canra\_\_cli 是否存在。

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

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

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

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

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

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

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

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

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

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