> ## Documentation Index
> Fetch the complete documentation index at: https://forgekit-docs-mintlify-fa544438.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 概览

> 所有 forge 命令按 Core、Memory、Substrate、Quality、Config 五组组织，并列出控制强制策略、命令输出与秘密再编辑的环境变量，包括 FORGE_ENFORCE、FORGE_GUARD_STRICT 与 FORGE_VERBOSE 的说明。

`forge` 命令面以数据形式定义 (`src/commands.js`),并通过 `forge docs check` 与文档对账,因此任何命令的加入或消失都逃不过文档的注意。命令被组织成五个组。

<CardGroup cols={2}>
  <Card title="Core" icon="gear" href="/zh-CN/cli/core">
    引导与维护:`init`、`sync`、`doctor`、`catalog`、`docs`、`update`。
  </Card>

  <Card title="Memory" icon="brain" href="/zh-CN/cli/memory">
    跨会话与团队记忆:`cortex`、`recall`、`remember`、`brain`、`ledger`、`reuse`、`handoff`、`decide`。
  </Card>

  <Card title="Substrate" icon="diagram-project" href="/zh-CN/cli/substrate">
    预动作门及其各阶段:`substrate`、`preflight`、`route`、`impact`、`scope`、`context`、`anchor`、`diagnose`、`imagine`、`lean`。
  </Card>

  <Card title="Quality" icon="shield-check" href="/zh-CN/cli/quality">
    验证与安全:`verify`、`scan`、`spec`、`taste`、`uicheck`、`harden`。
  </Card>

  <Card title="Config" icon="sliders" href="/zh-CN/cli/config">
    提供商、成本、看板、品牌、atlas、技术栈:`config`、`cost`、`dash`、`brand`、`atlas`、`stack`。
  </Card>
</CardGroup>

## 约定

* **默认建议模式。** 设置 `FORGE_ENFORCE=1` 可让基座把最强的信号(空洞的 prompt、无法组装的必需上下文、爆炸半径超过默认的 25 文件阈值)变为硬阻断。
* **默认安静。** 每个命令的 `Forge <cmd> — …` 标题只是品牌装饰,藏在 `--verbose` / `FORGE_VERBOSE` 后面;命令会先输出结果。
* **管道友好输出。** 管道下是纯文本;TTY 下加上品牌调色板颜色和置信度进度条。`NO_COLOR` 关闭颜色,`FORCE_COLOR=1` 强开。
* **`--json`** 在基座和大多数分析命令上可用,便于脚本化。

## 环境变量

| 变量                        | 作用                                                                                                                                                         |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FORGE_ENFORCE=1`         | 把基座最强的建议信号转为硬阻断。                                                                                                                                           |
| `FORGE_GUARD_STRICT=1`    | 把 secret 脱敏器的 `DEGRADED` 警告升级为阻断式退出。默认情况下,脱敏失败会向 stderr 打印 `secret redaction DEGRADED` 并放行输出;严格模式则拒绝输出任何脱敏器无法完全清洗的内容。适用于 CI 或共享机器 —— 那里一行未脱敏的内容比一条失败的命令更糟。 |
| `FORGE_NO_UPDATE_CHECK=1` | 静默 `forge doctor` 中的 "commits behind upstream" 提示。                                                                                                         |
| `FORGE_NO_HINT=1`         | 静默一次性提示你运行 `forge init` 的初始化提示。                                                                                                                            |
| `FORGE_VERBOSE=1`         | 显示默认隐藏的每命令横幅 (`Forge <cmd> — …`)。                                                                                                                          |
| `FORGE_EMBED=1`           | 为记忆召回开启 embedding 层(MinHash 仍是零依赖默认)。                                                                                                                      |

<Note>
  运行 `forge --help` 获取始终最新的列表,或运行 `forge catalog` 查看每个工具、crew 和护栏并附一行原因说明的 Start-Here 索引。
</Note>

## v0.19+ 新增

一批命令与参数正在 v0.19 系列陆续落地。它们记录在各自的组页面并在文中标注:

| 命令 / 参数               | 组       | 作用                      |
| --------------------- | ------- | ----------------------- |
| `forge know`          | Memory  | 把一条事实路由到它正确的存储归宿。       |
| `forge deja`          | Memory  | 类似过往工作查找。               |
| `forge precommit`     | Quality | 提交级验证门。                 |
| `forge radar`         | Quality | 依赖时效性同心圆。               |
| `forge report`        | Config  | 仓库 Forge 状态的静态 HTML 报告。 |
| `forge tools`         | Config  | 主工具选择 + gitignore 接线。   |
| `forge verify --deep` | Quality | 多镜头共识验证。                |
| `forge update --to`   | Core    | 锁定或回退到指定版本。             |