文档
安装指南
Windows
- 下载
forge-shell.exe，双击打开浏览器 - 首次输入 DeepSeek API Key，自动保存
- 开始对话
powershell
.\forge-shell.exe # Web UI（默认）
.\forge-shell.exe --tui # TUI 终端模式
.\forge-shell.exe --key sk-xxx # 命令行传 Key使用教程
两种工作模式
| 模式 | 图标 | 行为 |
|---|---|---|
| 互动 | 💬 | 智能路由 Pro/Flash，兼顾深度与成本，适合分析、设计、重构 |
| 速办 | ⚡ | 强制 Flash 模型（¥0.1/M），自动执行无需确认，适合写文件、搜索 |
Web UI 界面
┌──────────┬────────────────────┬──────────┐
│ 左栏 │ 中栏 │ 右栏 │
│ │ │ │
│ 📁 文件树 │ 对话区域 │ 📋 任务 │
│ (默认) │ (流式 + diff) │ 💰 费用 │
│ │ │ 📊 项目 │
│ 💬 会话 │ │ 🩺 诊断 │
│ (折叠) │ │ 🧬 进化 │
│ │ │ │
├──────────┴────────────────────┴──────────┤
│ [💬 互动] [⚡ 速办] ↩ 回退 💰 ¥0.0032 │
└──────────────────────────────────────────┘架构流程
大型文件创建任务自动走三阶段架构：Pro 生成（无工具、无 thinking）→ 后端语法校验 → 检测到错误时 Flash 分段修复（>300 行自动按 200 行切段）。≥3 文件任务自动激活 Coordinator/Worker 模式，Coordinator(Pro) 拆解任务 → Worker(Flash) 逐文件独立生成。
16 个工具
| 工具 | 用法 | 说明 |
|---|---|---|
| exec | [TOOL:exec:cargo test] | 沙箱命令执行 |
| read | [TOOL:read:路径:10:50] | 读文件，支持行范围 |
| search | [TOOL:search:关键字] | ripgrep 全项目搜索 |
| web | [TOOL:web:关键词] | GitHub+Gitee+DDG 三层搜索 |
| lsp | [TOOL:lsp] | cargo check 错误 |
| lsp-rich | [TOOL:lsp-rich:函数名] | 符号定义+所有引用 |
| auto-fix | [TOOL:auto-fix] | 根因分析→修复→重跑 |
| edit | [TOOL:edit:文件:行:行::内容] | 行级增量编辑 |
| snap | [TOOL:snap] | 文件快照列表/回滚 |
| rollback | [TOOL:rollback] | 全会话回滚 |
| save | [TOOL:save:内容] | 跨会话记忆 |
| explore | [TOOL:explore] | 项目探查 |
| parallel | [TOOL:parallel:f1,f2] | 并行读多文件 |
| infer | [TOOL:infer:函数名] | 调用链/复杂度 |
| structure | [TOOL:structure] | 项目结构图 |
| mcp | /api/mcp | MCP 协议端点 |
成本优化机制
| 层 | 策略 | 效果 |
|---|---|---|
| Prefix Cache | 系统提示词+工具定义永远不变 | 每次对话前缀 Token 免费 |
| 项目指纹 | 目录不变则不发项目信息 | 节省 500-2000 Token/轮 |
| 会话压缩 | 5轮后旧轮自动摘要 | 长对话不膨胀 |
| 模型路由 | 简单→Flash ¥0.1/M，复杂→Pro ¥1/M | 平均降 60% |
| Tool-Call Repair | API 失败自动重试 2 次 | 减少中断 |
进化引擎
每轮对话匿名采集策略记录，反思引擎每 5 轮触发一次 SOP 提炼。天工阁下次相似任务时自动匹配推荐最佳流程。
数据全部存储在本地 %LOCALAPPDATA%/forge-shell/evolution/。
配置文件
toml
[ai]
api_key = "sk-xxx"
default_model = "deepseek-v4-pro"
flash_model = "deepseek-v4-flash"
api_base = "https://api.deepseek.com"
[engine]
max_parallel_agents = 8
session_cache_rounds = 5社区
- 官网：https://forgeshell.cn
- 仓库：https://gitee.com/forgemaster/forge-shell
- 许可证：AGPLv3（代码）+ CC BY-SA 4.0（数据）
- 治理：锻师会（大锻师→锻师→学徒）