# @giamme/forge 中文文档

规范地址：https://npmcn.com/package/%40giamme/forge/

版本：0\.19\.0
npm 元数据更新时间：2026-11-15T17:50:44.644Z
中文译文更新时间：2026-11-16T08:19:26.678Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：5.8 MB，248 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-21T09:14:32.371Z
- 最新版本发布：2026-11-15T17:50:44.335Z
- 近 30 天下载量：3109（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

多模式编码与阅读代码的审阅员:计划,在平行的工作树上建造,审查每个真实的diff,只合并通过的内容.

## 安装

```sh
npm install @giamme/forge
```

也可以使用：`pnpm add @giamme/forge`、`yarn add @giamme/forge`、`bun add @giamme/forge`

## README

# 伪造

**多模式编码与阅读代码的审阅员:计划,在平行的工作树上建造,审查每个真实的diff,只合并通过的内容.**

Claude Code, Codex, OpenCode, OpenClaude, Antigravity和Grok的一门技能.

[![npm version](https://img.shields.io/npm/v/@giamme/forge?label=npm)](https://www.npmjs.com/package/@giamme/forge) [![Latest release](https://img.shields.io/github/v/release/Giamme/forge?label=release)](https://github.com/Giamme/forge/releases) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://npmcn.com/package/%40giamme/forge/LICENSE) [![Changelog](https://img.shields.io/badge/changelog-what's%20new-blue)](https://npmcn.com/package/%40giamme/forge/CHANGELOG.md)

[安装](https://npmcn.com/package/%40giamme/forge/#readme-install) • 妇女 [快开始](https://npmcn.com/package/%40giamme/forge/#readme-quick-start) • 妇女 [如何运作](https://npmcn.com/package/%40giamme/forge/#readme-how-it-works) • 妇女 [伪造的](https://npmcn.com/package/%40giamme/forge/#readme-forge-ui) • 妇女 [网站](https://giamme.github.io/forge/) • 妇女 [文档](https://npmcn.com/package/%40giamme/forge/docs/README.md) • 妇女 [更改日志](https://npmcn.com/package/%40giamme/forge/CHANGELOG.md)

![A decomposed run in forge-ui's 3D view: eight tasks on a plate in their planned waves, five merged in green and two running in amber, with a mark over each block for every review finding, then the same run on wall-clock time, where two first attempts that failed review show in red beside the retries that passed.](https://npmcn.com/package/%40giamme/forge/ui/docs/media/hero.webp)

从 [快开始](https://npmcn.com/package/%40giamme/forge/#readme-quick-start) 内 [伪造的](https://npmcn.com/package/%40giamme/forge/#readme-forge-ui):它的任务在波浪中 计划给了他们, 然后当他们真正运行, 失败的尝试 和他们的复试。 德摩数据.

* * *

你用手做一个编码目标 然后挑选模型. **矮子们** 执行。 A 类 **qa 语** 审查者 读每个侏儒真正的diff, 从来没有侏儒总结自己的作品。 自己定级的模型 作业不是检查:第二阶段值得,因为它看到了代码,而不是要求.

-   **任何型号,任何CLI.** `--dwarf sol:xhigh --qa opus` 通过 Codex 和 Claude Opus 运行 GPT 通过一个指令中的克洛德代码, 从任何你所在的CLI。 → [模型](https://npmcn.com/package/%40giamme/forge/docs/models.md)
-   **当欲相并.** `--decompose-level` 将目标分割成任务、 路径到 a 并同时运行在与世隔绝的树上. → [已分解运行](https://npmcn.com/package/%40giamme/forge/docs/decomposed-runs.md)
-   **只有被审查的工作合并.** 每项任务都由自己负责审查。 失败的任务保留它 分支用于重试审查者的结论,并且只传递任务合并. → [审查](https://npmcn.com/package/%40giamme/forge/docs/reviews.md)
-   **由你来决定什么是花钱,什么是土地.** 分解的运行显示任务表和 在任何发送前停止。 孤零零的改变 保持不承诺, 腐烂的工作土地 在你的分支 只有通过 `integrate --approved`永远不要推 → [安全问题](https://npmcn.com/package/%40giamme/forge/docs/safety.md)
-   **它学习你的回扣.** 跑步的发现会变成一个小 `.forge/memory.md`和每个 以后的运行是给它的。 → [项目内存](https://npmcn.com/package/%40giamme/forge/docs/memory.md)
-   **你可以看它现场直播.** 伪造 ui 用 3D 绘制每个运行, 有 diffs 、 发现和一个模型 领导板。 → [伪造的](https://npmcn.com/package/%40giamme/forge/docs/forge-ui.md)

## 安装

```bash
npm install -g @giamme/forge
forge install                  # links forge into every agent CLI it finds
```

更新方式 `npm install -g @giamme/forge@latest && forge install`。或者从基特安装 退出 :

```bash
git clone https://github.com/Giamme/forge.git ~/.claude/skills/forge
bash ~/.claude/skills/forge/scripts/forge-install.sh
```

伪造运行在macOS和Linux。 它需要击打,出击,Python 3.9 或以后, 代理CLIs 路由模型通过; [医生](https://npmcn.com/package/%40giamme/forge/docs/install.md#check-what-forge-can-reach) 显示 它可以达到。 铸币局的 `forge` 共享名称:见 [铸币局](https://npmcn.com/package/%40giamme/forge/docs/install.md#from-npm)。 。 。 .

→ [安装和更新](https://npmcn.com/package/%40giamme/forge/docs/install.md)

## 快开始

在装有伪造物的CLI中:

```text
/forge "add retry with exponential backoff to the HTTP client" --dwarf sol:high
```

这是整个最低. `sol` 盖起它 `high` 在Codex上的努力, `opus` 检查 diff 时 `high` (默认的审查者),你得到一个摘要 变化加qa的调查结果.

```text
# pick both sides
/forge "fix the off-by-one in the pagination cursor" --dwarf luna:max --qa sol:xhigh

# the same model, through a different CLI
/forge "port the config loader to TOML" --dwarf sol:high:openclaude --qa opus

# let the dwarf leave the sandbox to install deps and run the suite
/forge "add integration tests against a real Postgres container" --dwarf sol:xhigh --yolo-dwarf

# several dwarves in parallel, routed by difficulty
/forge "add auth: middleware, token model, login route, and docs" \
  --decompose-level medium \
  --dwarf-high sol:xhigh --dwarf-low gemini:low:antigravity --dwarf luna:high
```

一个分解的运行计划 任务,费率和路线,每个,然后 **给你看桌子和 停下来** 在花钱之前 在交互运行前, 伪造还询问是否使用 [分形](https://npmcn.com/package/%40giamme/forge/docs/fractal.md) 是否打开 [伪造的](https://npmcn.com/package/%40giamme/forge/docs/forge-ui.md)。 。 。 .

→ [每面旗帜都有更多例子](https://npmcn.com/package/%40giamme/forge/docs/commands.md)

## 如何运作

```mermaid
flowchart LR
    goal(["your goal"]) --> plan["plan: tasks and models,<br/>then you read the table"] --> dwarf["each task: a dwarf<br/>implements it in<br/>its own worktree"] --> qa["qa reads<br/>the real diff"]
    qa -. "FAIL: retry with<br/>the findings" .-> dwarf
    qa -- PASS --> merge["merged into<br/>integration"] --> deliver(["verification, final review,<br/>integrate --approved"])
```

无 `--decompose-level`,整个目标是一个任务: 一个侏儒, 和一个它的diff的回顾. 带有可选 [分形执行](https://npmcn.com/package/%40giamme/forge/docs/fractal.md),实施者可以委托受约束的儿童 任务在它拥有的路径中。 伪造还检视综合diff.

每个模型都由一个规格命名, `alias:effort:harness`。别名之后的每个字段可选:

| 光谱 | 手段 |
| --- | --- |
| `sol` | `sol` 在其默认的 CLI( codex) 中 |
| `sol:xhigh` | 同一型号在 `xhigh` 努力 |
| `sol:xhigh:openclaude` | 同样的模式和努力,贯穿 `openclaude` |

任何一种角色都可以通过六个代理人的CLI进行:

|  | 代码 | 克劳德 | 打开claude | 打开代码 | 反重力 | 线条 |
| --- | --- | --- | --- | --- | --- | --- |
| 二进制 | `codex` | `claude` | `openclaude` | `opencode` | `agy` | `grok` |

→ [努力的梯子、夹子、沙盒和添加模型](https://npmcn.com/package/%40giamme/forge/docs/models.md)

## 伪造的

form-ui是一款选入,只读的本地页面,可以观看任何运行的活页,被绘制为3D映射. 这个 显示每一跑步在一个板块上, 任务在他们的波浪和 当他们真的跑, 和迅速,模型, 每个步骤背后的时间和P0-P3结果。 在每一次新赛事开始时 伪造报价 从来没有打开它没有同意.

![The run cloud: about seventy runs as blocks in five project spirals, orbited, then laid out as galaxies and as a timeline with one lane per project.](https://npmcn.com/package/%40giamme/forge/ui/docs/media/cloud.webp)

<table><tbody><tr><td><img alt="forge-ui's window: the runs list, a run's eight tasks on a 3D plate in their planned waves with dependency cables, finding marks and the finish nodes, and the run's inspector." src="https://npmcn.com/package/%40giamme/forge/ui/docs/media/run.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><b>按计划跑.</b> 以依赖电缆在波中执行任务,以整合、核查和最后审查结束。 单击任务打开其尝试,矮人和评论.</td><td><img alt="The same run on wall-clock time: one block per attempt, failed attempts in red with their finding marks, a plane marking now, the concurrency strip, and the inspector's timeline and critical path." src="https://npmcn.com/package/%40giamme/forge/ui/docs/media/execution.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><b>并随所出.</b> 在它走的道上每一次尝试一个街区 红色的失败者,反对 <code>--max-parallel</code>; 检查员指定关键路径.</td></tr><tr><td><img alt="The diff a reviewer read, with a P1 finding pinned under the line comparing token digests and a P2 finding under the revoke function." src="https://npmcn.com/package/%40giamme/forge/ui/docs/media/diff.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><b>调查结果.</b> 任务的任何 diff, 或确切的 diff 一个审查器读取, 每个 P0 – P3 发现在它命名的行下 .</td><td><img alt="The model leaderboard: per implementer, tasks, first-attempt pass rate with a 95% interval bar, retries, escalations, timeouts, accepts, median model time and tokens." src="https://npmcn.com/package/%40giamme/forge/ui/docs/media/models.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><b>模型,在你的运行量.</b> 初试通过率,有信心间隔,复试,升级,时间和道具;审查员判决和影子协议.</td></tr><tr><td><img alt="The files heatmap: files grouped by directory against tasks grouped by wave, with planned, touched, drift and same-wave overlap marks." src="https://npmcn.com/package/%40giamme/forge/ui/docs/media/files.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><b>谁碰了哪个文件.</b> 计划,改变,漂入或相冲突,一波一波;一个单元格打开文件的diff.</td><td><img alt="The map of every run: one block per run in a district per repo, green when done, amber while running, red with failures." src="https://npmcn.com/package/%40giamme/forge/ui/docs/media/map.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><b>每跑一跑,由Repo.</b> 每跑一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站一站.</td></tr></tbody></table>

在你第一次跑步前四处看看, 在化妆跑道上打开它(这里所描绘的跑道) git 报到 :

```sh
python3 ui/tools/demo_runs.py /tmp/forge-demo
(cd ui && python3 -m forge_ui --no-registry --root /tmp/forge-demo --open)
```

→ [伪造的](https://npmcn.com/package/%40giamme/forge/docs/forge-ui.md)

## 文档

| 页次 | 里面有什么东西 |
| --- | --- |
| [安装和更新](https://npmcn.com/package/%40giamme/forge/docs/install.md) | npm 或 git 检查出, 医生, 安装者每个 CLI 会做什么, 更新 |
| [命令参考](https://npmcn.com/package/%40giamme/forge/docs/commands.md) | 每个 `/forge` 带有示例的旗帜 `forge` 命令、 运行脚本及其退出代码 |
| [模式、努力和利用](https://npmcn.com/package/%40giamme/forge/docs/models.md) | 页:1 `alias:effort:harness` 光谱、工作梯子和夹克、 yolo 模式、模型登记册 |
| [已分解运行](https://npmcn.com/package/%40giamme/forge/docs/decomposed-runs.md) | 分解水平和难度、路径、波浪、胶囊、规划、恢复、分解和结合, `tasks.tsv` |
| [审查、复审和追回](https://npmcn.com/package/%40giamme/forge/docs/reviews.md) | 判决、复审、基础设施停止、严重程度阈值、接受、全程和影子审查、警卫、核查、故障第一 |
| [分形执行](https://npmcn.com/package/%40giamme/forge/docs/fractal.md) | 可选的嵌入式执行后端:安装、运行、检查、界限和恢复 |
| [项目内存](https://npmcn.com/package/%40giamme/forge/docs/memory.md) | `.forge/memory.md` 和分类账,每个角色被告知, 是否承诺,花费 |
| [伪造的](https://npmcn.com/package/%40giamme/forge/docs/forge-ui.md) | 运行的查看器:命令、共享服务器、环境变量、隐私 |
| [运行数据集](https://npmcn.com/package/%40giamme/forge/docs/dataset.md) | 用于培训决策模式 |
| [运行文物](https://npmcn.com/package/%40giamme/forge/docs/artifacts.md) | 运行目录、计划文件、工作树和分支 |
| [安全问题](https://npmcn.com/package/%40giamme/forge/docs/safety.md) | 伪造的东西永远不会影响你的分支 先决条件 执行的完整性 |
| [皮线和捷夫](https://npmcn.com/package/%40giamme/forge/docs/add-ons.md) | 可选存储处背景和咨询判决 |
| [解决问题](https://npmcn.com/package/%40giamme/forge/docs/troubleshooting.md) | 症状、原因和修复 |
| [发展](https://npmcn.com/package/%40giamme/forge/docs/development.md) | 仓库布局、离线检查、运行时间测量 |

## 许可证

伪造在 [MIT 许可证](https://npmcn.com/package/%40giamme/forge/LICENSE)。伪造 - i 的 三维视图端口代码 所有麻省理工学院的许可证均在 [ui/ Third PARTY NOTICES.md (中文(简体) )](https://npmcn.com/package/%40giamme/forge/ui/THIRD_PARTY_NOTICES.md)。 。 。 .

## 常见问题

### @giamme/forge 是什么？

多模式编码与阅读代码的审阅员:计划,在平行的工作树上建造,审查每个真实的diff,只合并通过的内容\.

### 如何安装 @giamme/forge？

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

### @giamme/forge 支持 TypeScript 吗？

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

### @giamme/forge 可以商用吗？

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

### @giamme/forge 的下载量有多少？

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

### @giamme/forge 还在维护吗？

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

