⚒️ Forge：AI增强型终端开发环境

一个将AI能力与您的开发环境无缝集成的全面编码助手

curl -fsSL https://forgecode.dev/cli | sh

快速入门

要开始使用Forge，请运行以下命令：

curl -fsSL https://forgecode.dev/cli | sh

首次运行时，Forge会引导您通过交互式登录流程设置AI提供商的凭据。或者，您也可以提前配置提供商：

# 交互式配置提供商凭据
forge provider login

# 然后启动Forge
forge

就是这样！Forge现在已准备好协助您完成开发任务。

使用示例

Forge可以根据您的需求以不同方式使用。以下是一些常见的使用场景：

> 能否解释一下这个代码库中的认证系统是如何工作的？

> 我需要为我们的React应用添加一个暗黑模式切换开关。我应该怎样入手呢？

> 我遇到了这个错误：“TypeError: Cannot read property 'map' of undefined”。这可能是什么原因造成的？

> 请审查src/components/UserProfile.js中的代码，并提出改进建议。

> 我想将GraphQL集成到这个Express应用中。你能告诉我如何开始吗？

> 我需要为一个包含用户、文章、评论和分类的博客设计数据库模式。

> 帮我将这个基于类的组件重构为使用React Hooks的形式。

> 我需要将分支‘feature/user-profile’合并到main分支，但存在冲突。

为什么选择Forge？

Forge专为希望在保持对开发环境完全控制的同时，利用AI辅助提升工作效率的开发者而设计。

• 零配置——只需添加API密钥即可开始使用
• 无缝集成——直接在您常用的终端中工作
• 多提供商支持——支持OpenAI、Anthropic等LLM提供商
• 安全设计——受限的shell模式限制了文件系统的访问，防止意外更改
• 开源——透明、可扩展且由社区驱动

Forge助您更快地编写代码、解决复杂问题以及学习新技术，同时无需离开终端。

Forge的工作原理：三种模式

Forge提供了三种不同的使用方式。提前了解这些区别将帮助您避免混淆。

交互模式（TUI）

不带任何参数运行 forge 会启动交互式终端界面，这是一个持久会话，您可以在其中输入提示，AI 会以对话循环的方式进行响应。这是执行多步骤工作的主要方式。

forge                              # 启动一个新的交互式会话
forge conversation resume <id>     # 在交互模式下恢复特定的已保存对话
forge --conversation-id <id>       # 同上：通过 ID 恢复对话
forge --agent <agent-id>           # 使用特定代理启动交互式会话
forge -C /path/to/project          # 在指定目录下启动
forge --sandbox experiment-name    # 创建一个隔离的 Git 工作树 + 分支，然后在此处启动

进入交互模式后，输入您的提示并按 Enter 键。Forge 会读取文件、生成补丁、运行命令，并在整个会话中保持上下文。

一次性 CLI 模式

传递 -p（或 --prompt）来运行单个提示并退出。Forge 完成工作后会返回到您的 shell。这对于脚本、输出管道或快速任务非常有用。

forge -p "解释 src/main.rs 的作用"
forge -p "在 lib.rs 中的 parse() 函数中添加错误处理"
echo "这是做什么的？" | forge    # 将输入作为提示传递
forge commit                         # 生成 AI 提交信息并提交（完成后退出）
forge commit --preview               # 生成提交信息，打印出来后退出
forge suggest "查找大型日志文件" # 将自然语言翻译为 Shell 命令，然后退出

注意： forge conversation resume <id> 会打开交互式 TUI。它不会只是打印一条消息就退出。如果您运行该命令后看到光标在等待输入，说明您已经进入了交互式会话。您可以输入提示，或者按 Ctrl+C 退出。

ZSH 插件模式（: 前缀）

使用 forge setup 安装一次 ZSH 插件后，您就可以直接在 shell 提示符下使用 : 命令，而无需每次都输入 forge。这是日常开发中最快速的模式：发送提示、切换对话、提交代码以及建议命令，全程无需离开 shell。

: 重构认证模块      # 向当前活跃的代理发送提示
:commit                         # AI 驱动的 Git 提交
:suggest "查找大型日志文件" # 将描述转换为 Shell 命令并插入到您的缓冲区
:conversation                   # 使用 fzf 预览浏览已保存的对话

有关所有命令和别名，请参阅下方的完整 ZSH 插件参考。

ZSH 插件：: 前缀系统

当您安装 ZSH 插件（forge setup）后，您的 shell 提示符上就会出现 : 前缀命令系统。这是在正常开发过程中使用 Forge 的最快方式；您始终无需离开 shell。

工作原理： 以 : 开头的行会在 shell 处理之前被截获，并路由到 Forge。其余内容则按正常方式执行。

: <prompt>         # 向当前活跃的代理发送提示
:sage <prompt>     # 向特定名称的代理发送提示（sage、muse、forge 或任何自定义代理）
:agent <name>      # 切换当前活跃的代理；如果未指定名称，则打开 fzf 选择器

代理

Forge 自带三个内置代理，每个代理都有不同的角色：

发送提示

: 将认证模块重构为使用新的中间件
:sage 缓存层是如何工作的？    # sage = 只读研究代理
:muse 设计一个部署策略        # muse = 规划代理（写入 plans/ 目录）
:ask X 是如何工作的？                     # :sage 的别名
:plan 制定一个迁移计划             # :muse 的别名

代理上下文是持久化的。单独输入 :sage（没有提示文本）会将当前活跃的代理切换为 sage，后续的所有 : <prompt> 命令都会使用 sage 代理。

附加文件

在提示中输入 @，然后按 Tab 键进行模糊搜索并选择文件。路径会被插入为 @[filename]，并作为上下文附加给 AI。

: 审查这段代码 @[src/auth.rs] @[tests/auth_test.rs]

对话管理

Forge 会保存每一次对话。您可以像切换目录一样在不同对话之间切换。

:new                      # 开始一个新的对话（保存当前对话以便于 :conversation - 使用）
:new <initial prompt>     # 开始一个新的对话并立即发送提示
:conversation             # 打开 fzf 选择器：浏览并切换对话，带有预览
:conversation <id>        # 直接通过 ID 切换到某个对话
:conversation -           # 在当前对话和上一个对话之间切换（类似于 cd -）
:clone                    # 分支当前对话（尝试不同的方向）
:clone <id>               # 通过 ID 克隆特定对话
:rename <name>            # 重命名当前对话
:conversation-rename      # 通过 fzf 选择器重命名对话
:retry                    # 重试上次的提示（当 AI 理解有误时很有用）
:copy                     # 将上次 AI 的回复复制到剪贴板，格式为 Markdown
:dump                     # 将对话导出为 JSON 格式
:dump html                # 将对话导出为格式化的 HTML
:compact                  # 手动压缩上下文，以释放 token 预算

Git 集成

:commit                   # AI 读取您的 diff，生成提交信息并立即提交
:commit <context>         # 同上，但可以传递额外的上下文：:commit 修复 README 中的拼写错误
:commit-preview           # AI 生成提交信息，并将 "git commit -m '...'" 放入您的缓冲区
                          # 这样您可以在按下 Enter 键前先查看或编辑提交信息

Shell 命令工具

:suggest <description>    # 将自然语言翻译为 Shell 命令并放入您的缓冲区
:edit                     # 打开 $EDITOR 编写复杂的多行提示，然后发送

会话与配置

有些命令仅更改当前会话的设置，而另一些则会持久化到您的配置文件（~/forge/.forge.toml）。这两者是有区别的：

# 仅限会话（关闭终端时重置，不会保存到配置文件）
:model <model-id>              # 仅为此会话更改模型
:reasoning-effort <level>      # 设置推理力度：无/极低/低/中/高/极高/最大
:agent <id>                    # 为此会话切换活跃代理

# 持久化（保存到配置文件）
:config-model <model-id>       # 全局设置默认模型  (别名: :cm)
:config-provider               # 全局切换提供商    (别名: :provider, :p)
:config-reasoning-effort <lvl> # 全局设置默认推理力度 (别名: :cre)
:config-commit-model <id>      # 设置用于 :commit 的模型  (别名: :ccm)
:config-suggest-model <id>     # 设置用于 :suggest 的模型 (别名: :csm)
:config-reload                 # 将会话覆盖重置为全局配置 (别名: :cr)

# 查看与编辑配置
:info                          # 显示当前会话信息（模型、代理、对话 ID）
:config                        # 以 TOML 格式显示生效的解析后配置
:config-edit                   # 在 $EDITOR 中打开配置文件 (别名: :ce)
:tools                         # 列出当前代理可用的工具
:skill                         # 列出可用技能

技能

技能是 AI 可以作为工具调用的可复用工作流。Forge 预装了三种内置技能：

• create-skill：搭建一个新的自定义技能
• execute-plan：执行 plans/ 目录下的计划文件
• github-pr-description：根据你的代码差异生成 PR 描述

使用 :skill 可以列出可用技能。AI 会在相关时自动调用这些技能，你也可以明确请求：: 使用 github-pr-description 技能生成 PR 描述。

自定义技能 存在于带有 YAML 前言的 SKILL.md 文件中。优先级（最高优先）如下：

项目本地技能会覆盖全局技能，而全局技能又会覆盖内置技能。要搭建新技能，请输入：: 创建一个新技能。

自定义代理行为

AGENTS.md： 在你的项目根目录下创建此文件（或在 ~/forge/AGENTS.md 全局范围内），为所有代理提供持久化的指令，例如编码规范、提交信息风格以及需要避免的内容。Forge 会在每次对话开始时自动读取该文件。

自定义代理： 将带有 YAML 前言的 .md 文件放置在 .forge/agents/（项目级别）或 ~/forge/agents/（全局级别），以定义具有各自模型、工具和系统提示的额外代理。项目级别的代理会覆盖全局代理。位于 crates/forge_repo/src/agents/ 的内置代理文件是该格式的良好示例。

自定义命令： 将 YAML 文件放置在 .forge/commands/（项目级别）或 ~/forge/commands/（全局级别），以定义可通过 :commandname 调用的快捷命令。命令也可以直接在 forge.yaml 的 commands: 键下内联定义。

语义搜索（工作区）

:sync                     # 为语义搜索索引你的代码库
:workspace-init           # 初始化工作区以进行索引
:workspace-status         # 显示索引状态
:workspace-info           # 显示工作区详情

运行 :sync 后，AI 可以根据语义而非精确文本匹配来搜索你的代码库。索引过程会将文件内容发送到工作区服务器，默认地址为 https://api.forgecode.dev。如果选择自托管，可以设置 FORGE_WORKSPACE_SERVER_URL 来覆盖此默认值。

快速参考：所有 : 命令

命令行选项

以下是 Forge 命令行选项的快速参考：

子命令

# 对话
forge conversation list                  # 列出所有已保存的对话
forge conversation resume <id>           # 以交互模式恢复对话
forge conversation new                   # 创建一个新的对话 ID（并打印）
forge conversation dump <id>             # 将对话导出为 JSON 格式
forge conversation compact <id>          # 精简对话上下文
forge conversation retry <id>            # 重试上一条消息
forge conversation clone <id>            # 克隆一个对话
forge conversation rename <id> <name>    # 重命名对话
forge conversation delete <id>           # 永久删除对话
forge conversation info <id>             # 显示对话详情
forge conversation stats <id>            # 显示 token 使用统计
forge conversation show <id>             # 显示最后一条助手消息

# 提交
forge commit                             # 生成 AI 提交信息并提交
forge commit --preview                   # 仅生成提交信息（并打印）
forge commit fix the auth bug            # 为提交信息传递额外上下文

# Shell 命令建议
forge suggest "list files by size"       # 将描述转换为 shell 命令

# 供应商
forge provider login                     # 添加或更新供应商凭据（交互式）
forge provider logout                    # 移除供应商凭据
forge list provider                      # 列出支持的供应商

# 模型与代理
forge list model                         # 列出可用模型
forge list agent                         # 列出可用代理

# 工作区 / 语义搜索
forge workspace sync                     # 为语义搜索索引当前目录
forge workspace init                     # 初始化工作区
forge workspace status                   # 显示索引状态
forge workspace query <text>             # 查询语义索引

# MCP 服务器
forge mcp list                           # 列出已配置的 MCP 服务器
forge mcp import                         # 从 JSON 添加服务器
forge mcp show                           # 显示服务器配置
forge mcp remove                         # 移除服务器
forge mcp reload                         # 重新加载所有服务器并重建缓存

# 其他
forge info                               # 显示配置、当前使用的模型和环境
forge list tool --agent <id>             # 列出特定代理可用的工具
forge doctor                             # 运行 shell 环境诊断
forge update                             # 更新 forge 到最新版本
forge setup                              # 安装 ZSH 插件（更新 .zshrc）

高级配置

供应商配置

Forge 支持多个 AI 供应商。推荐使用交互式登录命令来配置供应商：

forge provider login

该命令会执行以下操作：

1. 显示可用的供应商列表
2. 引导您输入所需的凭据

管理供应商凭据

# 登录供应商（添加或更新凭据）
forge provider login

# 移除供应商凭据
forge provider logout

# 列出支持的供应商
forge provider list

已弃用：环境变量

⚠️ 已弃用：使用 .env 文件进行供应商配置已被弃用，并将在未来版本中移除。请改用 forge provider login。

出于向后兼容性考虑，Forge 仍支持环境变量。首次运行时，任何在环境变量中找到的凭据都会自动迁移到基于文件的存储中。

# .env
OPENROUTER_API_KEY=<your_openrouter_api_key>

# .env
REQUESTY_API_KEY=<your_requesty_api_key>

# .env
XAI_API_KEY=<your_xai_api_key>

# .env
ZAI_API_KEY=<your_zai_api_key>

# 或者用于编码计划订阅
ZAI_CODING_API_KEY=<your_zai_coding_api_key>

# .env
CEREBRAS_API_KEY=<your_cerebras_api_key>

# .env
IO_INTELLIGENCE_API_KEY=<your_io_intelligence_api_key>

# forge.yaml
model: meta-llama/Llama-3.3-70B-Instruct

# .env
OPENAI_API_KEY=<your_openai_api_key>

# forge.yaml
model: o3-mini-high

# .env
ANTHROPIC_API_KEY=<your_anthropic_api_key>

# forge.yaml
model: claude-3.7-sonnet

# .env
PROJECT_ID=<your_project_id>
LOCATION=<your_location>
VERTEX_AI_AUTH_TOKEN=<your_auth_token>

# forge.yaml
model: google/gemini-2.5-pro

# .env
OPENAI_API_KEY=<your_provider_api_key>
OPENAI_URL=<your_provider_url>

# forge.yaml
model: <供应商特定的模型>

# .env
OPENAI_API_KEY=<your_groq_api_key>
OPENAI_URL=https://api.groq.com/openai/v1

# forge.yaml
model: deepseek-r1-distill-llama-70b

# .env
OPENAI_API_KEY=<your_bedrock_gateway_api_key>
OPENAI_URL=<your_bedrock_gateway_base_url>

# forge.yaml
model: anthropic.claude-3-opus

# .env
FORGE_API_KEY=<your_forge_api_key>

# forge.yaml
model: claude-3.7-sonnet

forge.yaml 配置选项

环境变量

Forge 支持多个环境变量，用于高级配置和微调。这些变量可以在您的 .env 文件或系统环境中设置。

# .env
FORGE_RETRY_INITIAL_BACKOFF_MS=1000    # 初始退避时间，单位为毫秒（默认值：1000）
FORGE_RETRY_BACKOFF_FACTOR=2           # 退避时间的倍数因子（默认值：2）
FORGE_RETRY_MAX_ATTEMPTS=3             # 最大重试次数（默认值：3）
FORGE_SUPPRESS_RETRY_ERRORS=false      # 是否抑制重试错误信息（默认值：false）
FORGE_RETRY_STATUS_CODES=429,500,502   # 需要重试的 HTTP 状态码（默认值：429、500、502、503、504）

# .env
FORGE_HTTP_CONNECT_TIMEOUT=30              # 连接超时时间，单位为秒（默认值：30）
FORGE_HTTP_READ_TIMEOUT=900                # 读取超时时间，单位为秒（默认值：900）
FORGE_HTTP_POOL_IDLE_TIMEOUT=90            # 池空闲超时时间，单位为秒（默认值：90）
FORGE_HTTP_POOL_MAX_IDLE_PER_HOST=5        # 每个主机的最大空闲连接数（默认值：5）
FORGE_HTTP_MAX_REDIRECTS=10                # 最大可跟随的重定向次数（默认值：10）
FORGE_HTTP_USE_HICKORY=false               # 是否使用 Hickory DNS 解析器（默认值：false）
FORGE_HTTP_TLS_BACKEND=default             # TLS 后端：“default” 或 “rustls”（默认值：“default”）
FORGE_HTTP_MIN_TLS_VERSION=1.2             # 最低 TLS 版本：“1.0”、“1.1”、“1.2”、“1.3”
FORGE_HTTP_MAX_TLS_VERSION=1.3             # 最高 TLS 版本：“1.0”、“1.1”、“1.2”、“1.3”
FORGE_HTTP_ADAPTIVE_WINDOW=true            # 是否启用 HTTP/2 自适应窗口（默认值：true）
FORGE_HTTP_KEEP_ALIVE_INTERVAL=60          # 长连接保持活动的时间间隔，单位为秒（默认值：60；使用“none”或“disabled”可禁用）
FORGE_HTTP_KEEP_ALIVE_TIMEOUT=10           # 长连接保持活动的超时时间，单位为秒（默认值：10）
FORGE_HTTP_KEEP_ALIVE_WHILE_IDLE=true      # 在空闲时保持长连接（默认值：true）
FORGE_HTTP_ACCEPT_INVALID_CERTS=false      # 是否接受无效证书（默认值：false）——请谨慎使用
FORGE_HTTP_ROOT_CERT_PATHS=/path/to/cert1.pem,/path/to/cert2.crt  # 根证书文件路径（PEM、CRT、CER 格式），多个路径用逗号分隔

# .env
FORGE_API_URL=https://api.forgecode.dev  # 自定义 Forge API URL（默认值：https://api.forgecode.dev）
FORGE_WORKSPACE_SERVER_URL=http://localhost:8080  # 索引服务器的 URL（默认值：https://api.forgecode.dev/）

# .env
FORGE_TOOL_TIMEOUT=300         # 工具执行的最大时间限制，超过该时间将终止工具运行，以防止会话卡死。（默认值：300 秒）
FORGE_MAX_IMAGE_SIZE=10485760  # read_image 操作允许的最大图片文件大小，单位为字节（默认值：10485760 字节，即 10 MB）
FORGE_DUMP_AUTO_OPEN=false     # 是否自动在浏览器中打开转储文件（默认值：false）
FORGE_DEBUG_REQUESTS=/path/to/debug/requests.json  # 将调试 HTTP 请求文件写入指定路径（支持绝对路径和相对路径）

# .env
FORGE_BIN=forge                    # 用于执行 Forge 操作的命令（默认值：“forge”）

# .env
FORGE_CURRENCY_SYMBOL="$"         # ZSH 主题中成本显示的货币符号（默认值：“$”）
FORGE_CURRENCY_CONVERSION_RATE=1.0  # 货币转换率（默认值：1.0）
NERD_FONT=1                       # 在 ZSH 主题中启用 Nerd Font 图标（默认值：自动检测；设置为“1”或“true”启用，设置为“0”或“false”禁用）
USE_NERD_FONT=1                   # 启用 Nerd Font 图标的替代变量（与 NERD_FONT 行为相同）

# .env
FORGE_CONFIG=/custom/config/dir        # 所有 Forge 配置文件的基础目录（默认：~/.forge）
FORGE_MAX_SEARCH_RESULT_BYTES=10240   # 搜索结果的最大字节数（默认：10240 - 10 KB）
FORGE_HISTORY_FILE=/path/to/history    # Forge 历史文件的自定义路径（默认：使用系统默认位置）
FORGE_BANNER="Your custom banner text" # 启动时显示的自定义横幅文本（默认：Forge ASCII 艺术）
FORGE_MAX_CONVERSATIONS=100            # 列表中最多显示的对话数量（默认：100）
FORGE_MAX_LINE_LENGTH=2000             # 文件读取操作每行的最大字符数（默认：2000）
FORGE_STDOUT_MAX_LINE_LENGTH=2000      # shell 输出每行的最大字符数（默认：2000）
SHELL=/bin/zsh                         # 用于执行命令的 shell（Unix/Linux/macOS）
COMSPEC=cmd.exe                        # 用于执行命令的处理器（Windows）

# .env
FORGE_SEM_SEARCH_LIMIT=200            # 初始向量搜索返回的最大结果数（默认：200）
FORGE_SEM_SEARCH_TOP_K=20             # 语义搜索过程中用于相关性过滤的 top-k 参数（默认：20）

# .env
FORGE_LOG=forge=info                  # 日志筛选级别（默认：跟踪关闭时为 forge=debug，开启时为 forge=info）

# .env
FORGE_TRACKER=false                   # 禁用跟踪增强元数据（默认：true）

forge.yaml 文件支持多个高级配置选项，允许您自定义 Forge 的行为。

# forge.yaml
custom_rules: |
  1. 您编写的任何代码都必须始终包含全面的错误处理。
  2. 所有新函数都应包含单元测试。
  3. 遵循我们团队的命名规范：变量使用驼峰命名法，类使用帕斯卡命名法。

# forge.yaml
commands:
  - name: "refactor"
    description: "重构选定的代码"
    prompt: "请重构这段代码以提高可读性和性能"

# forge.yaml
model: "claude-3.7-sonnet"

# forge.yaml
max_walker_depth: 3 # 将目录遍历限制在 3 层深度

# forge.yaml
temperature: 0.7 # 平衡创造性和专注度

# forge.yaml
max_tool_failure_per_turn: 3 # 允许每个工具在强制完成前最多失败 3 次

# forge.yaml
max_requests_per_turn: 50 # 每轮最多允许 50 次请求

# 列出所有 MCP 服务器
forge mcp list

# 从 JSON 导入服务器
forge mcp import

# 显示服务器配置详情
forge mcp show

# 移除服务器
forge mcp remove

# 重新加载服务器并重建缓存
forge mcp reload

{
  "mcpServers": {
    "server_name": {
      "command": "command_to_execute",
      "args": ["arg1", "arg2"],
      "env": { "ENV_VAR": "value" }
    },
    "another_server": {
      "url": "http://localhost:3000/events"
    }
  }
}

文档

有关所有功能和特性的完整文档，请访问 文档网站。

安装

# YOLO
curl -fsSL https://forgecode.dev/cli | sh

# 包管理器
nix run github:tailcallhq/forgecode # 获取最新开发分支

社区

加入我们活跃的Discord社区，与其他Forge用户和贡献者交流互动，获取项目帮助、分享创意并提供反馈吧！

支持我们

您的支持是Forge持续发展的动力！通过给我们的GitHub仓库点星，您将：

• 帮助更多人发现这款强大的工具 🔍
• 激励我们的开发团队 💪
• 让我们能够优先开发新功能 🛠️
• 巩固我们的开源社区 🌱

Forge 快速上手指南

Forge 是一款增强型终端开发环境，它将 AI 能力无缝集成到您的工作流中，帮助您在终端内直接进行代码理解、功能实现、调试和重构。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：macOS 或 Linux (Windows 用户建议使用 WSL2)。
• Shell 环境：推荐使用 zsh 以启用高效的 : 前缀命令系统（也支持 bash）。
• 网络环境：需要能够访问外部 API（如 OpenAI, Anthropic 等）。
  • 提示：国内用户若遇到安装脚本下载缓慢，可尝试配置代理或使用国内镜像源下载脚本后本地执行。
• API 密钥：准备好您常用的 LLM 提供商（如 OpenAI, Anthropic）的 API Key。

安装步骤

1. 一键安装

打开终端，运行以下命令下载安装脚本并执行：

curl -fsSL https://forgecode.dev/cli | sh

注意：如果下载速度慢，您可以先手动下载脚本内容，保存为 install.sh，然后运行 sh install.sh。

2. 配置 AI 提供商

安装完成后，首次运行时 Forge 会引导您进行交互式登录。您也可以手动配置：

# 交互式配置提供商凭证
forge provider login

# 或者直接在启动时配置
forge

按照屏幕提示输入您的 API Key 即可完成设置。

3. (可选) 启用 ZSH 插件

为了获得最佳体验（使用 : 快捷命令），建议初始化 ZSH 插件：

forge setup

执行后请重启终端或运行 source ~/.zshrc 使插件生效。

基本使用

Forge 提供三种主要使用模式，您可以根据需求灵活切换。

模式一：交互式终端界面 (TUI)

这是最常用的模式，适合多轮对话、复杂任务处理和上下文保持。

启动命令：

forge

使用示例： 进入界面后，直接输入自然语言指令：

• Can you explain how the authentication system works in this codebase? (解释认证系统)
• I need to add a dark mode toggle to our React application. (添加深色模式)
• Review the code in src/components/UserProfile.js (代码审查)

模式二：单次命令行模式 (One-Shot CLI)

适合脚本集成、快速查询或生成一次性结果。

使用命令：

# 直接执行提示词并退出
forge -p "Explain the purpose of src/main.rs"

# 生成 AI 提交信息并自动提交
forge commit

# 将自然语言转换为 Shell 命令（仅打印，不执行）
forge suggest "find large log files"

模式三：ZSH 插件模式 (: 前缀)

如果您完成了 forge setup，可以直接在 Shell 提示符下使用 : 开头命令，无需输入 forge，效率极高。

常用命令：

• 发送指令：

  : refactor the auth module
  

• 切换智能体 (Agent)：
  • :ask 或 :sage：切换到研究模式（只读，分析架构）。
  • :plan 或 :muse：切换到规划模式（生成实施计划）。
  • :agent：通过菜单选择智能体。
• 附加文件上下文： 在指令中输入 @ 并按 Tab 键，可模糊搜索并附加文件：

  : review this code @[src/auth.rs]
  

• Git 操作：

  :commit          # AI 生成提交信息并提交
  :conversation    # 浏览历史对话记录
  

小贴士：

• Forge 默认包含三个智能体：forge (默认，负责编码和修改文件)、sage (负责研究和阅读)、muse (负责规划)。
• 所有对话会自动保存，您可以随时通过 :conversation 回溯上下文。