# @cairnkeep/cli 中文文档

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

版本：2\.28\.0
npm 元数据更新时间：2026-10-31T12:21:45.921Z
中文译文更新时间：2026-11-09T18:38:22.574Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：4 MB，492 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-07-13T20:08:33.252Z
- 最新版本发布：2026-10-31T12:21:45.610Z
- 近 30 天下载量：1896（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：58（近 12 个月 58 个）

## 中文简介

为编码代理和MCP客户端提供可持久,可支配的可知内存+上下文层.

## 安装

```sh
npm install @cairnkeep/cli
```

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

## README

# 凯恩克普

[![CI](https://github.com/cairnkeep/cairnkeep/actions/workflows/ci.yml/badge.svg)](https://github.com/cairnkeep/cairnkeep/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/@cairnkeep/cli)](https://www.npmjs.com/package/@cairnkeep/cli) [![license](https://img.shields.io/npm/l/@cairnkeep/cli)](https://npmcn.com/package/%40cairnkeep/cli/LICENSE)

> 持久,本地第一的内存和编码代理的上下文.

Cairnkeep 帮助编码代理在会话中传送项目背景 绳子。 它将决策、限制、模式和经验教训储存在 然后给代理商一个查找和 在不将记忆变成权威或权威的情况下,验证上下文 自动代理运行时间 .

## 为什么是凯恩克普?

-   **各届会议的连续性.** 回顾项目决定和经常性 失败而不是从头开始重新发现它们.
-   **驾驭独立.** 通过 Claude Code, OpenCode, 使用同样的内存 , Codex CLI,Kimi代码,Quen代码,Pi,或另一个MCP客户端.
-   **默认为本地 .** 默认 stdio 服务器存储您计算机上的数据; 远程访问、嵌入、捕捉和外部环境是明确的 选入.
-   **受约束的特工指导.** 管理 `AGENTS.md` 指令和项目 游戏本告诉兼容的代理何时检索上下文以及检查哪个 申请,但绝不执行工作或批准.
-   **权力最小.** 完成 MCP 说明,只读/客户工具配置, 和不可改变的上下文包保持观察与 行动.

## 快开始

凯恩克普需要22号节点或更新. 在一个交互式终端, 引导 设置显示可选择的 Git 和内存选择以及每个选项的复选框 已支持的编码工具 :

```bash
npm install --global @cairnkeep/cli
cairn setup /path/to/project
cd /path/to/project
cairn doctor
./.ai/start-codex.sh                 # Windows: .\.ai\start-codex.cmd
```

在此路由的带状检查表中选择 Codex CLI 。 审查 `.codex/config.toml` 并接受 Codex 项目信任的第一使用提示. 自动化可以明确提供每个选项;快速启动文档: 决取之形.

见 [快速启动](https://npmcn.com/package/%40cairnkeep/cli/docs/quickstart.md) 克劳德代码,第一个 记忆/召回周期、恢复和设置所有权。 见 [牵引兼容性](https://npmcn.com/package/%40cairnkeep/cli/docs/harness-compatibility.md) 准确的表面 由每个客户端支持.

核心循环是故意小的:存储一个简洁的,经过核实的项目事实, 关闭会话,并在后期任务需要时检索。 克劳德代码和 打开代码曝光 `/remember` 财务报告和审定财务报表 `/recall`; 任何兼容的 MCP 客户端都可以使用 `memory_write` 财务报告和审定财务报表 `memory_search` 直接说.

## 编码代理

设置一个管理下的项目指令块, 并设置一个小的 协议 :

1.  对于可能取决于先前项目知识的非三角任务,请制作 任务产生的项目范围 `memory_search` 第一个工具或命令.
2.  将结果视为定位器,而不是真理;验证所维护的存储器 他们提到的消息来源.
3.  如果内存不存在或有,继续正常的仓库检查 没有相关结果.
4.  除非用户或一个用户 经审查的工作流程明确要求这样做.

Cairnkiep游戏本可以建议或要求现有的审查、核实、, 安全、文件和学习步骤。 他们不运行这些步骤, 激活技能,启用能力,或授权破坏性工作.

读取 [编码代理的 Cairnkeep](https://npmcn.com/package/%40cairnkeep/cli/docs/agents.md) 全部合同, 权威模式,控制行为, 优雅的回落.

## 信任边界

凯恩克普不是主机 遥测服务或自动遥控器 知识收集者。 记忆是耐久的背景,不是真相的来源 文档。 已配置 Claude 代码和 OpenCode 钩子可以从本地获取 记忆候选人; 持久晋升和每个联网或敏感抓取 路径继续单独控制。 一般的未安装保留耐用数据 除非要求明确清洗.

开始 [隐私和数据流动](https://npmcn.com/package/%40cairnkeep/cli/docs/privacy-and-data-flow.md), (中文(简体) ), [内存存储和部署](https://npmcn.com/package/%40cairnkeep/cli/docs/storage.md),以及 [安全保证和威胁模式](https://npmcn.com/package/%40cairnkeep/cli/docs/security-assurance.md) 在此之前 允许远程 HTTP、嵌入、轨迹、文物、工作证据或 上下文包.

## 文档

这个 [文件枢纽](https://npmcn.com/package/%40cairnkeep/cli/docs/README.md) 是设置的索引,代理, 行动、可选特征、部署、学习路径和贡献者 向导。 特别是:

-   [快速启动](https://npmcn.com/package/%40cairnkeep/cli/docs/quickstart.md)
-   [编码代理](https://npmcn.com/package/%40cairnkeep/cli/docs/agents.md)
-   [二. 背景情报](https://npmcn.com/package/%40cairnkeep/cli/docs/context-intelligence.md)
-   [操作指南](https://npmcn.com/package/%40cairnkeep/cli/docs/operating.md)
-   [调和兼容性](https://npmcn.com/package/%40cairnkeep/cli/docs/harness-compatibility.md)
-   [隐私和数据流动](https://npmcn.com/package/%40cairnkeep/cli/docs/privacy-and-data-flow.md)
-   [安全保证和威胁模式](https://npmcn.com/package/%40cairnkeep/cli/docs/security-assurance.md)
-   [指导学习路径和视频脚本](https://npmcn.com/package/%40cairnkeep/cli/docs/learning/README.md)

该寄存器支持了Linux,macOS,原生Windows x64,WSL,Node.js 22/24/26, 和真实的Bash 3.2在兼容性指南所记录的边界内.

## 捐助和支助

见 [捐款额](https://npmcn.com/package/%40cairnkeep/cli/CONTRIBUTING.md) 促进发展和拉动要求 准则, [支助](https://npmcn.com/package/%40cairnkeep/cli/SUPPORT.md) 帮助,和 [警卫](https://npmcn.com/package/%40cairnkeep/cli/SECURITY.md) 页:1 私人脆弱性报告.

## 许可证

Apache-2.0 2026 斯特凡诺·通多

## 常见问题

### @cairnkeep/cli 是什么？

为编码代理和MCP客户端提供可持久,可支配的可知内存\+上下文层\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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