# @cinatra-ai/cinatra 中文文档

规范地址：https://npmcn.com/package/%40cinatra-ai/cinatra/

版本：0\.1\.8
npm 元数据更新时间：2026-07-08T07:55:57.258Z
中文译文更新时间：2026-11-09T16:14:27.167Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.5 MB，121 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：5 个
- 首次发布：2026-06-22T07:38:05.973Z
- 最新版本发布：2026-07-08T07:55:56.994Z
- 近 30 天下载量：2958（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

命令行工具用于安装,运行,并维护Cinatra实例——为团队提供开源AI工作空间.

## 安装

```sh
npm install @cinatra-ai/cinatra
```

也可以使用：`pnpm add @cinatra-ai/cinatra`、`yarn add @cinatra-ai/cinatra`、`bun add @cinatra-ai/cinatra`

## README

# 锡那拉语name

命令行工具用于 [锡纳特拉](https://cinatra.ai/) ——团队的开源AI工作空间,人们,AI助手,以及自主代理在持久工作流程上合作.

用它来站起你自己的Cinatra实例,并保持它运行——从一个本地的dev setup到生产.

## 快开始

```
npx @cinatra-ai/cinatra install
```

从零开始设置 Cinatra 实例:检查您的前提条件,获取 Cinatra , 创建您的环境, 启动本地服务, 并运行首次设置 。 之后,从你的Cinatra目录中运行其他命令.

## 安装

根据要求,不需要安装 :

```
npx @cinatra-ai/cinatra <command>
```

或者在全球安装( 那么命令就是 `cinatra`:

```
npm install -g @cinatra-ai/cinatra
```

需要节点.js >= 24.

## 尽你所能

```
cinatra install --mode dev       # set up OR reconcile a dev instance (single entrypoint)
cinatra install --mode prod      # set up OR reconcile a production instance
cinatra status                   # check an instance's status
cinatra doctor                   # diagnose your local setup
cinatra agents install <name>    # add an agent to your instance
cinatra create-extension <kind>  # scaffold a new extension to author
```

`cinatra install --mode dev|prod` 是单一的同位素命令 实例存在或使其健康:用干净的机器运行,从 抓取, 或重新运行到已有的取出中以调节它( 它跳过克隆) 并重新运行 收买供给阶段—— 没有单独的 `setup` 命令要记住).

另一个本地主机/Monorepo靴子 命令您从 Cinatra 内部运行 退房现场 `cinatra instance …`数字 :

```
cinatra instance db migrate           # apply schema updates (works when the app is down)
cinatra instance branch setup         # provision an isolated env for the current worktree
cinatra instance branch teardown --yes  # drop that worktree's isolated schema
cinatra instance clone new <name>     # create an isolated deep-fork clone
cinatra instance refresh              # reconcile deps + dev DB to your checkout
cinatra instance tunnel start         # manage the dev Tailscale Funnel
cinatra instance backup create        # take a local backup bundle
cinatra instance reset --yes          # reset the development environment
```

运行 `cinatra --help` 用于顶级命令列表,或 `cinatra instance --help` 用于完整本地波茨图指令列表.

## 运行不止一个实例

如果你已经有一个 Cinatra 实例运行 `cinatra install` 发现它的 在使用的港口,它不仅停止——它告诉你谁拥有港口和提议 为你设立二审 在它问的终端上,您也可以选择 选项前方有标记 :

```
cinatra install --on-conflict=isolated   # a second, fully separate instance
                                          # on its own ports + app port
cinatra install --on-conflict=stop-existing  # stop the existing one first,
                                              # then install on the default ports
cinatra install --on-conflict=attach     # re-use / update the existing checkout
cinatra install --on-conflict=co-use     # share the running instance's services
                                         # (separate database + queue; no 2nd stack)
cinatra install --infra=external \       # point at your own database/cache
    --db-url <url> --redis-url <url> --nango-url <url> --graphiti-url <url> \
    --external-db-disposable             # confirm the external DB is disposable
                                         # (setup may write to it; required for --db-url)
```

有用的额外项目 :

```
cinatra install --instance <name>        # name the instance (default: the folder name)
cinatra install --app-port <n>           # pick the app port for an isolated instance
cinatra install --port-offset auto|<n>   # how far to shift an isolated instance's ports
cinatra install --dry-run                # show what would happen, change nothing
cinatra install --list-instances         # list the instances you have set up
cinatra install --status [--dir <path>]  # show one checkout's instance state
cinatra install --resume                 # finish an install that was interrupted
```

`--list-instances` 编号 : `--status` 只读。 停止或擦去已有的 案例总是首先要求确认; `--yes` 单独从不删除数据 (并指自己外部数据库中的设置) `--db-url` 同样需要 明确 `--external-db-disposable` 承认——一无所有 `--yes` 不会的 它,因为设置可以写到数据库.

> **合用(共享一集服务).** `--on-conflict=co-use` 编号 : `--infra=share` 运行一个二审 针对第一个运行的服务 ——它自己的应用端口和自己的数据库,但相同的Postgres服务器Redis, 和南戈(没有第二个多克堆)。 仅在安装的应用程序时启用 每个实例隔离登录 cookie( 否则两例在 `localhost` 将分享一会,所以 `cinatra install` 以精确的应用程序更改拒绝 需要并标注 `--on-conflict=isolated`) (中文(简体) ). 当捐助方设定 图形 URL, 添加 `--allow-shared-graphiti` 接受分享(这是 org-classed, not per-instance.)),是一款有眼力的活体.

## 作者扩展名

脚手架 即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用即用 类型(`agent`, (中文(简体) ), `connector`, (中文(简体) ), `artifact`, (中文(简体) ), `skill`, (中文(简体) ), `workflow`:

```
cinatra create-extension agent invoice-extractor
```

它产生一个完整、独立的回波(明显、README、CI、等同门和 特定种类的有效载荷。 生成的包针 `@cinatra-ai/sdk-extensions` 作为可选的对等点;没有为您安装任何设备。 运行 `cinatra create-extension --help` 对于种类和选择.

## Repo 结构

```
bin/              Entry-point script (cinatra.mjs)
src/              CLI source modules
  authoring/      Extension scaffolding core (create-extension)
templates/        Scaffold templates for each extension kind
  agent/
  artifact/
  connector/
  skill/
  workflow/
  _shared/        Shared files copied into every generated extension
tests/            Vitest test suite
```

这回波是 **薄的中央液态** 只有这个 没有 `@cinatra-ai/*` 运行时间 依赖性——这些依赖性通过操作员的Cinatra检查解决 运行时间。 迁移跑者, dev-app 运算表和第一党 SDK 包 都来自离职,不是这个包.

## 发展

复制并安装依赖性 :

```
git clone https://github.com/cinatra-ai/cinatra-cli.git
cd cinatra-cli
npm ci
```

运行测试套件 :

```
npm test
```

这套套房由 [维特](https://vitest.dev/) 并盖住电流, 克隆/登记逻辑、扩展脚手架、命令调度和启动 合同。 需要Cinatra检查的测试使用合成假检查 国家 `tests/helpers/setup-fake-checkout.mjs`; 没有真实实例 需要运行测试.

在当地检查CLI:

```
node bin/cinatra.mjs --help
node bin/cinatra.mjs --version
```

CI管道`.github/workflows/ci.yml`在每个 拉出请求:依赖性断言,全Vitest套房,两种烟雾 检查,和干燥包 验证公布的有效载荷.

投稿时,要铭记薄的CLI约束:不要添加 `@cinatra-ai/*` 软件包到 `dependencies`, (中文(简体) ), `devDependencies`,或 `peerDependencies`。如果出现任何第一党包,CI将拒绝 PR 在表里或经结的依附树上.

## 解决问题

**`cinatra: command not found` 全局安装后** 请检查npm的全球 `bin` 目录在您的 `PATH`数字 :

```
npm prefix -g       # prints the global prefix (e.g. /usr/local)
echo $PATH          # verify <prefix>/bin appears here
```

如果缺少,请添加 `$(npm prefix -g)/bin` 切入到您的外壳配置 (例如:. `~/.zshrc` 或者说 `~/.bashrc`) (中文(简体) ).

**`cinatra install` 表示正在使用端口** 另一个 Cinatra 实例( 或另一种服务) 已经在使用默认 端口。 使用 `--list-instances` 以查看运行中的内容 :

```
cinatra install --list-instances
```

然后选择一个决议: `--on-conflict=isolated` 启动二审 自己的港口乐队, `--on-conflict=attach` 重新附在现有的结账, 或者说 `--on-conflict=stop-existing` 在安装前停止现有堆栈.

**`cinatra doctor` 诊断破损实例** 如果你的行为不端, `cinatra doctor` 检查您的本地设置 报告什么是错。 在提交一个问题之前先运行它.

**节点.js 版本错误** CLI要求节点.js 24或后. 检查您的版本 `node --version` 并在需要时升级.

## 更改日志

见 [变动情况](https://npmcn.com/package/%40cinatra-ai/cinatra/CHANGELOG.md) 以完整的历史释放.

## 许可证

[阿帕奇 - 2.0](https://npmcn.com/package/%40cinatra-ai/cinatra/LICENSE)

## 常见问题

### @cinatra-ai/cinatra 是什么？

命令行工具用于安装,运行,并维护Cinatra实例——为团队提供开源AI工作空间\.

### 如何安装 @cinatra-ai/cinatra？

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

### @cinatra-ai/cinatra 支持 TypeScript 吗？

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

### @cinatra-ai/cinatra 支持 ESM 还是 CommonJS？

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

### @cinatra-ai/cinatra 需要什么版本的 Node\.js？

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

### @cinatra-ai/cinatra 可以商用吗？

@cinatra-ai/cinatra 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cinatra-ai/cinatra 的下载量有多少？

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

### @cinatra-ai/cinatra 还在维护吗？

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