# @codedology/code-forge 中文文档

规范地址：https://npmcn.com/package/%40codedology/code-forge/

版本：0\.21\.0
npm 元数据更新时间：2026-11-10T04:27:16.421Z
中文译文更新时间：2026-11-10T06:33:01.047Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：28.8 MB，272 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：3 个
- 首次发布：2026-09-26T17:08:59.446Z
- 最新版本发布：2026-11-10T04:27:16.256Z
- 近 30 天下载量：3592（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

计划/harden/code/审查协调性CLI和Agent Skill,用于跨模型、平行和有证据的特性交付.

## 安装

```sh
npm install @codedology/code-forge
```

也可以使用：`pnpm add @codedology/code-forge`、`yarn add @codedology/code-forge`、`bun add @codedology/code-forge`

## README

# @ codedology/ code- forge (帮助)

一个CLI和Agent Skill用于跨型,平行,有证据特征的提供.

最近:0.21.0 - 见 [变动情况](https://npmcn.com/package/%40codedology/code-forge/CHANGELOG.md)

## 问题

一个特工可以快速地写出代码,但你仍然需要决定构建什么以及如何检查. 长的任务会失去上下文,并行编辑会碰撞,而绿色测试会错过预定的行为. 代码-forge将工作分割成自有块,给每个更改一个新审查,并记录证明. 你批准计划 并控制预算,许可, 并着陆结果.

## 安装

需要节点.js \\\\\\ 22和git。 用 CLI 安装 CLI `npm install -g @codedology/code-forge`。 。 。 . macOS: 工作树默认为 `.noindex` 文件夹,所以 Spotlight 不索引它们. 范围 npm 名称只用于安装; 命令是 `code-forge`。 。 。 . 未瞄准的 npm 包 `code-forge` 是一个无关的工具.

运行设置向导 :

```bash
code-forge init
```

按 Enter 为工具、 工具、 工具、 提供者、 多模式审查、 密钥和引擎等默认设置. 向导检测出门和证明设置,标记空白,并允许您使用、自定义或推迟 他们。 写着 `.code-forge.yml` 并将技能与检测到的绳子联系起来。 重新运行它 保留它已经写的。 对于没有System-1(Jev)密钥的第一次尝试:

```bash
code-forge init --no-interaction --no-jev
```

准备时使用 `--jev-ref <1Password item ID|link|op://vault/item/field>` 或者说 `--jev-env MY_JEV_KEY` 改为 `--no-jev`。见 [设置细节](https://npmcn.com/package/%40codedology/code-forge/docs/getting-started.md)。 。 。 .

### 什么样的船

-   这个 `code-forge` CLI 和一个只讲道的人 [特工技能](https://npmcn.com/package/%40codedology/code-forge/skill/SKILL.md),带有支持 [参考文献](https://npmcn.com/package/%40codedology/code-forge/skill/references/)。模型标识、努力、命令、阈值和路径来自 配置或CLI.
-   一个JSON Schema为 `.code-forge.yml` 及其产生的 [配置参考](https://npmcn.com/package/%40codedology/code-forge/docs/reference/config.md)。 。 。 .
-   一个 [示例存储器](https://npmcn.com/package/%40codedology/code-forge/examples/) (单位:千美元) [块形地图](https://npmcn.com/package/%40codedology/code-forge/docs/reference/blocks.json)。 。 。 .

## 5分钟快速启动

设置后, 检查配置、 选定模型和安装的链接 :

```bash
code-forge validate
code-forge resolve L1
code-forge doctor --quick
code-forge list
code-forge keys list
code-forge models
code-forge --help
code-forge version
```

`resolve` 打印一个级别的提供者、模型、努力、倒计时和CLI. `doctor --quick` 检查配置、链接和关键解析度; `keys list` 打印源和过期, 永远不值, 警告者,临终不到一小时.

写一个简短的描述 变化和如何你知道它的工作。 在你的经纪人,请引用 `/code-forge full path/to/brief.md`它计划,硬化, 让你批准计划,然后代码. 使用 `/code-forge plan|harden|code <file>` 一次一个阶段. 设置每个运行 `budget.usd` 在开始付费会话之前:一次警告为80%,没有一次警告为100%. 这个 [初试辅导](https://npmcn.com/package/%40codedology/code-forge/docs/tutorial-first-test.md) - 通过完整的分娩; [简短模式](https://npmcn.com/package/%40codedology/code-forge/docs/brief-mode.md) 包括一个没有计划的小任务.

### 仅审查

对于您已经写的代码, 请在仓库中运行 :

```bash
code-forge review
```

它对照与默认分支合并基数审查分支,或未承诺的工作 默认分支,使用新的闭页会话。 它没有计划员 编码员 也没有证据. 缩小 `--files <paths…>`选择 `--base <ref>`解释 `--intent "<text>"`,或使用 `--json`。退出 0 是指所有批准或无任何审查; 1 是指发现、停止或无法审查 审查; 2 表示使用。 见 [仅审查的细节](https://npmcn.com/package/%40codedology/code-forge/docs/review-only.md)。 。 。 .

## 如何运作

```text
plan -> code -> review -> proof -> land
  ^       |       |
  |       +<--fix-+
  +-- human approval after hardening
```

技术检查和强化计划 在你批准之前。 编译者在区块中工作 拥有文件和接受条款; 独立的块可以平行运行。 一个工人跑来跑去 编辑器沙盒外的审阅会 固定回合被限制;未解决的工作停止. 检验和红色-绿色证明证明,在关闭之前,更改符合其接受条款. 您控制了最后的合并和发布权限; 代码器无法按下或打开 PR 草稿 默认。 见 [工作流程](https://npmcn.com/package/%40codedology/code-forge/docs/how-it-works.md) 财务报告和审定财务报表 [概念](https://npmcn.com/package/%40codedology/code-forge/docs/concepts.md)。 。 。 .

## 密钥命令

| 命令 | 用它来 |
| --- | --- |
| `code-forge init` | 配置工程并安装技能 |
| `code-forge doctor --quick` | 检查配置、链接和密钥 |
| `code-forge review` | 没有编码程序审查已有更改 |
| `code-forge run start|status|reload|end` | 管理运行并检查其开支 |
| `code-forge block open|close|stop` | 跟踪自有工作并强制执行其验收门 |
| `code-forge review-file` | 进行文件审查或等待票单 |
| `code-forge proof tier|red-green` | 选择证明力并证明测试在修复前失败 |
| `code-forge gates detect|run` | 发现并运行项目检查 |
| `code-forge keys list|set|test|remove` | 不打印机密而管理密钥引用 |
| `code-forge report` | 检查记录的结果和费用 |
| `code-forge outcome seal|check` | 在呼叫者使用前封住一个专家结果并检查其文件 |
| `code-forge pipeline status|next` | 见专家步骤和下一个准备步骤 |
| `code-forge logs` | 检查本地错误; `logs report` 预览公有问题 |
| `code-forge upgrade` | 更新软件包后刷新已安装的技能副本 |
| `code-forge --help` | 列出每个动词; 每个动词在不良参数上打印自己的用法 |

技术通常叫 `run`, (中文(简体) ), `block`, (中文(简体) ), `worker`, (中文(简体) ), `spawn`, (中文(简体) ), `s2`, (中文(简体) ), `author`, (中文(简体) ), `facts`,以及 `review-file` 给你的 见 [工作流程](https://npmcn.com/package/%40codedology/code-forge/docs/how-it-works.md) 这些低级业务. 升级,运行 `npm install -g @codedology/code-forge@latest`,则 `code-forge upgrade` 用于版本摘要和发布注释; 添加 `--plain` 只是安装线.

### 配置参考

[计划/代码-forge.schema.json](https://npmcn.com/package/%40codedology/code-forge/schema/code-forge.schema.json) 是真理的来源. 参考文献列出了每个密钥,类型和默认,包括预算,升级,编码器地板, 审查风险、多模式、货币和超时设置. `review.routes` 向另一个模型发送大文件,并带有自己的超时和二级. 见 [路由和倒置示例](https://npmcn.com/package/%40codedology/code-forge/docs/how-it-works.md) 上面的长文审查者 400行和倒数列表 `{provider, model}` 对象(可选) `effort`永远不要弦. `block open --kind code|docs|contract` 覆盖从文件名中推断出来的类型. 重现引用 `node scripts/gen-config-doc.mjs`; 添加 `--check` 检查它.

## 支助代理人

使用克洛德代码(Claude Code), Codex, 或Grok作为代理吊带,或Solo作为执行引擎. 双子座克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克星克克星克星克星克星克星克星克星克星克星克星克星克星克星克星克克星克星克星克星克星克星克星克星克星克星克星克星克星克星克克星克星克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克. 见 [代理支持和限制](https://npmcn.com/package/%40codedology/code-forge/docs/overview.md) 适用于适配器和已退化模式. 封闭图书角色限制说明如下.

## 安保模式

审查和大门行由HMAC签署: `signer: same-user boundary only`进程为 您可以读取签名密钥; 无法针对此进程进行防御. `doctor` 说明限制. 提供方和Jev键只在工人或管弦乐手中解决:环境 → OS键链 → 1Password (默认时间为8小时,最多24小时) – 设置快取. 密钥永远无法到达编码器; 键命令打印无值,输出被编辑。 提供者拒绝列表会限制编码器动作.

评论员、法官、系统2和计划作者只看到他们的包:克劳德没有工具 Grok拒绝所有工具 Codex总是有一个外壳,所以这些角色默认被拒绝; `review.allow_open_book_codex: true` 选择带有警告的风险. 错误会停留在本地的被清理的日志中 . `logs report` 清理两次,检查密钥,预览 发出,只发出你的同意; `CODE_FORGE_NO_ERROR_LOG=1` 禁用日志 . 证明使用单位/地貌测试和红地-绿色,没有突变测试或手突变. 见 [安全细节](https://npmcn.com/package/%40codedology/code-forge/skill/references/security.md) 财务报告和审定财务报表 [隐私](https://npmcn.com/package/%40codedology/code-forge/docs/privacy.md)。 。 。 .

## 链接

-   [文档](https://npmcn.com/package/%40codedology/code-forge/docs/):设置,概念,教程,和参考页.
-   [变动情况](https://npmcn.com/package/%40codedology/code-forge/CHANGELOG.md):所有per-version发布历史.
-   路线图 : [公共特色思想](https://claude.ai/artifact/BmeWyqRxZYsWr7eH5vBtdF)

### 发展

一揽子船舶普通无害环境管理 `.mjs` 没有构建步骤的文件。 在一次离职中,运行 `npm install`, (中文(简体) ), `npm test`,以及 `npm run typecheck`。在释放前检查生成的配置引用. 记录更改为 `npm run changelog -- <type> "<text>"`; 记录固定错误报告 `npm run known-fix -- add <fp> <version> "<summary>"`。 。 。 . `npm run release -- <bump> [--dry-run]` 凸起版本,发布 ChangeGELOG, 更新可选的最新行, 检查, 承诺,以及 标签。 发布方式 `npm publish`,然后按下标记;CI创建了 GitHub 发布. 见 [释放](https://npmcn.com/package/%40codedology/code-forge/docs/releasing.md)。 。 。 .

## 常见问题

### @codedology/code-forge 是什么？

计划/harden/code/审查协调性CLI和Agent Skill,用于跨模型、平行和有证据的特性交付\.

### 如何安装 @codedology/code-forge？

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

### @codedology/code-forge 支持 TypeScript 吗？

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

### @codedology/code-forge 支持 ESM 还是 CommonJS？

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

### @codedology/code-forge 需要什么版本的 Node\.js？

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

### @codedology/code-forge 可以商用吗？

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

### @codedology/code-forge 的下载量有多少？

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

### @codedology/code-forge 还在维护吗？

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