Skip to content

文档

安装指南

Windows

  1. Gitee Releases 下载 forge-shell.exe
  2. 双击运行,或放入 PATH 目录中从终端启动
  3. 设置环境变量 DEEPSEEK_API_KEY

Linux

bash
# 下载静态二进制
wget https://gitee.com/forgemaster/forge-shell/releases/download/v0.1.0/forge-shell

# 添加执行权限
chmod +x forge-shell

# 移动到 PATH
sudo mv forge-shell /usr/local/bin/forge

# 启动
forge

鸿蒙 PC

鸿蒙 PC 端通过"融合开发引擎"直接运行 Linux 静态二进制,与 Linux 安装方式相同。

从源码编译

bash
git clone https://gitee.com/forgemaster/forge-shell.git
cd forge-shell
cargo build --release
./target/release/forge-shell

使用教程

三种工作模式

模式快捷键说明
规划Ctrl+P只分析代码,不做任何修改
助手Ctrl+AAI 逐步执行,每步需要你确认
极速Ctrl+YAI 自动执行全部操作,事后汇总

Web UI 模式

bash
forge --web

自动在 http://localhost:9527 打开浏览器界面,支持:

  • 流式对话(SSE)
  • 项目监控面板
  • 费用看板
  • 三栏布局

快捷键一览

快捷键功能
Ctrl+P切换到规划模式
Ctrl+A切换到助手模式
Ctrl+Y切换到极速模式
F1项目监控面板
F2费用看板
Ctrl+Shift+C社区大厅
Ctrl+S分享复盘
切换标签页
滚动对话
Ctrl+C / Esc退出

配置

配置文件位于 ~/.config/forge-shell/config.toml(Linux)或 %APPDATA%/forge-shell/config.toml(Windows)。

toml
[ai]
default_model = "deepseek-v4-pro"
flash_model = "deepseek-v4-flash"
api_base = "https://api.deepseek.com"

[engine]
max_parallel_agents = 8
cache_target_rate = 0.97

[ui]
default_mode = "assist"

治理章程

熔炉是一个社区驱动的开源项目。详见 GOVERNANCE.md

锻师会层级

  • 大锻师:最终决策权和否决权
  • 锻师(合并 10+ PR 或 SOP 帮助超 500 次):PR 投票权、路线图提议
  • 学徒(有被采纳的 PR/SOP):参与讨论

悬赏机制

  • ¥500 以下免服务费,¥500 以上统一 5%
  • 锻师会审核完成后赏金自动发放

隐私承诺

  • 复盘上传仅含脱敏策略
  • 不上传代码、路径、变量名、API Key

以意为炉,以语为锤,铸代码之剑