# @coryparry/codekeeper 中文文档

规范地址：https://npmcn.com/package/%40coryparry/codekeeper/

版本：0\.5\.3
npm 元数据更新时间：2026-08-25T11:54:24.902Z
中文译文更新时间：2026-11-10T20:20:47.393Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：19.8 MB，4798 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-08-20T19:12:55.646Z
- 最新版本发布：2026-08-25T11:54:24.582Z
- 近 30 天下载量：4406（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

GitHub Actions的仓库拥有的AI维护者,包括拉力请求审查、分批、审计和经核实的修理

## 安装

```sh
npm install @coryparry/codekeeper
```

也可以使用：`pnpm add @coryparry/codekeeper`、`yarn add @coryparry/codekeeper`、`bun add @coryparry/codekeeper`

## README

# 代码管理员

代码管理器是一个向导的CLI,它安装一个总是可用的维护器在一个 GitHub.com 仓库. 它审查拉动请求、三分法问题、审计 从 GitHub 动作中准备经过验证的小型修复 你拥有.

您不会手写工作流程 。 CLI帮助你选择模型, 能力、验证命令和 GitHub App 权限,然后打开一个 设置拉动请求供您审查 。 它从不合并拉动请求.

要求数 **22号节点或更新**, Git, 一个认证 [GitHub 缩写](https://cli.github.com/),并允许管理目标 仓库.

## 安装

从寄存器默认分支的清理取出 :

```bash
npx @coryparry/codekeeper@0.2.0 init
```

安装器 :

1.  检查节点、 Git、 GitHub CLI 认证、 管理员访问和退出状态;
2.  让你选择 **建议** (自动PR审查和人工维护) 或者说 **自定义**· ;
3.  帮助您创建一个被收养者拥有的 GitHub App , 并获得所需的权限;
4.  上传供应商证书和 App 私密密钥到 GitHub;以及
5.  打开一个设置拉动请求。 它不会合并它.

在您合并了拉动请求后, 从默认分支的清理检出 :

```bash
npx @coryparry/codekeeper@0.2.0 verify
```

打开一个小的同一存储器拉取请求, 确认 App- authored 在您需要复议门之前进行复议.

## 安装者写的

选定的工作流程决定确切的集. 通常推荐安装 包括:

-   `.github/codekeeper.json` 政策、模式和安全界限
-   `.github/codekeeper-release.json` ——已安装的包裹身份和收件
-   `.github/codekeeper/README.md` ——已安装文件的所有权
-   `.github/codekeeper/actions/acquire-package/action.yml` —— 准确的软件包获取
-   `.github/workflows/codekeeper.yml` ——每个已安装模式都有一个静态呼叫器
-   `.github/workflows/codekeeper-runtime.yml` ——共享计算,验证,发布,以及证明性工作

可选 `.github/codekeeper/agents/*.md` 文件超过已包装代理 配置文件合并到默认分支后 .

## GitHub 应用程序和秘密

安装者创建或更新寄存器的秘密和变量. 没有 打印他们的值.

典型名称 :

| 名称 | 仁爱 | 目的 |
| --- | --- | --- |
| `CODEKEEPER_ENABLED` | 变量 | 启动开关; 最后一个设置 |
| `CODEKEEPER_APP_CLIENT_ID` | 变量 | GitHub App 客户端 ID |
| `CODEKEEPER_AUTOMATION_BOT_LOGIN` | 变量 | 信任的 App 机器人登录 |
| `CODEKEEPER_APP_PRIVATE_KEY` | 隐藏 | App PEM 应用程序 |
| `OPENAI_API_KEY` | 隐藏 | 选中时 OpenAI 模型调用 |
| `DEEPSEEK_API_KEY` | 隐藏 | 选中时深搜索 |
| `OPENROUTER_API_KEY` | 隐藏 | 选中时打开路透器 |
| `OPENAI_TRACE_API_KEY` | 隐藏 | 可选追踪; 不重用模式密钥 |

只在选定的寄存器上安装 App 。 不要粘贴 PEM 到 终端; 选择安装器中下载的文件.

## 国 际

```text
npx @coryparry/codekeeper@0.2.0 init
npx @coryparry/codekeeper@0.2.0 update
npx @coryparry/codekeeper@0.2.0 update --to X.Y.Z
npx @coryparry/codekeeper@0.2.0 update --check
npx @coryparry/codekeeper@0.2.0 rollback --to X.Y.Z
npx @coryparry/codekeeper@0.2.0 doctor [--json]
npx @coryparry/codekeeper@0.2.0 verify [--json] [--controlled]
```

`init` 还重新打开用于现有安装的被引导设置. `update` 移动到更新验证的释放. `rollback --to` 要求提前释放 打开一个普通的更新拉取请求; 它从不强制-pushes.

要将这个源检出打包到本地的 tarball 而不是使用 npm, 请查看 [总部](https://github.com/coryparrry/Codekeeper/blob/main/INSTALL.md)。 。 。 .

## 支持的表面

-   GitHub.com 仓库. GitHub 企业服务器不被支持 .
-   审查:同存,非草案牵引请求.
-   自动修复和自动合并仅限配置的默认 树枝.
-   叉,草稿,和合并队列都在被支持的表面外.
-   已安装的运行时间使用由 GitHub 托管的 Ubuntu 跑道。 持久性 共享的自控跑者不支持.
-   更改代码的能力需要确定仓库验证命令 外加 `git diff --check`。 。 。 .

建议从修复、执行、重复关闭、, 计划维护、追踪和自动合并 **关**。 。 。 .

## 文档

-   [源寄存器](https://github.com/coryparrry/Codekeeper)
-   [配置](https://github.com/coryparrry/Codekeeper/blob/main/docs/CONFIGURATION.md)
-   [权力、数据和费用](https://github.com/coryparrry/Codekeeper/blob/main/docs/authority-data-cost.md)
-   [建筑](https://github.com/coryparrry/Codekeeper/blob/main/docs/ARCHITECTURE.md)
-   [支助](https://github.com/coryparrry/Codekeeper/blob/main/SUPPORT.md)

安装者记录生成的软件包构建中的确切 Git 承诺 资产元数据。 不要手动编辑它的承诺.

## 警卫

不要输入提供者密钥、 GitHub App 私人密钥、 令牌或活的痕迹 . 通过 GitHub 私人脆弱性报告报告脆弱性 说明 [警卫](https://github.com/coryparrry/Codekeeper/blob/main/SECURITY.md)。 。 。 .

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://github.com/coryparrry/Codekeeper/blob/main/LICENSE)。 。 。 .

## 常见问题

### @coryparry/codekeeper 是什么？

GitHub Actions的仓库拥有的AI维护者,包括拉力请求审查、分批、审计和经核实的修理

### 如何安装 @coryparry/codekeeper？

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

### @coryparry/codekeeper 支持 TypeScript 吗？

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

### @coryparry/codekeeper 支持 ESM 还是 CommonJS？

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

### @coryparry/codekeeper 需要什么版本的 Node\.js？

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

### @coryparry/codekeeper 可以商用吗？

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

### @coryparry/codekeeper 的下载量有多少？

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

### @coryparry/codekeeper 还在维护吗？

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