Forge：本地优先的自主编码助手CLI，终端中的AI软件工程师

Forge是一款本地优先的自主编码助手CLI工具，定位为终端中的AI软件工程师。它采用创新的双模型架构：云端"Master Brain"（如Gemini）负责高级推理、项目规划与决策，本地"Local Worker"（如Qwen3.5-9B通过LM Studio运行）负责代码生成与快速迭代。该工具兼顾能力、速度与成本，提供自主开发、交互对话、任务执行等多种模式，核心优势包括数据隐私保护、离线能力、低延迟体验及成本优化。

传统AI编码工具常依赖云端模型，存在隐私风险、网络延迟或高成本问题。Forge的本地优先设计理念旨在解决这些痛点：

• 数据隐私：敏感代码保留本地，仅必要上下文发送云端；
• 离线能力：初始化后多数操作可离线进行；
• 成本优化：本地模型无API费用，云端调用仅用于高级推理；
• 低延迟：本地模型响应快速，避免网络延迟困扰。

双模型架构

• Master Brain（云端）：负责项目规划、架构设计、任务分解、决策制定与质量把控，利用云端大模型的强推理能力；
• Local Worker（本地）：通过LM Studio运行Qwen3.5-9B等模型，完成代码生成、迭代优化，保障快速响应与隐私。

技术栈

• 向量搜索：用FAISS索引项目文件，快速检索相关代码片段；
• 依赖图：用NetworkX构建模块关系图，支持架构分析与重构；
• 多模式工作流：自主模式（端到端构建）、交互模式（REPL对话）、任务模式（特定目标执行）。

安装与配置

• Linux/macOS：curl -fsSL https://raw.githubusercontent.com/Tushaarxr/forge/main/install.sh | bash
• Windows：irm https://raw.githubusercontent.com/Tushaarxr/forge/main/install.ps1 | iex
• 环境要求：Python3.10+、LM Studio、Gemini API key，通过forge setup完成初始化。

典型场景

• 快速原型：forge auto "创建React待办应用（TypeScript+Tailwind）"；
• 遗留代码理解：forge init后通过forge chat查询架构、代码逻辑；
• 自动化重构：forge auto "将回调改为async/await"；
• 代码审查：forge chat请求审查修改、检查安全问题。

使用Forge需注意：

• 模型限制：本地模型（如Qwen3.5-9B）处理复杂逻辑或罕见语言可能不足；
• 上下文窗口：大型项目需合理组织代码以避免超出模型能力；
• 安全审查：自动生成代码需人工审查，尤其是安全敏感部分；
• 版本控制：建议配合Git使用，增强变更追溯能力。

未来方向

• 增强智能：支持更多云端/本地模型（如Llama3 70B），提升代码理解能力；
• 生态扩展：开发IDE插件（VS Code/JetBrains）、CI/CD集成、团队协作功能；
• 专业化优化：针对React/Django/FastAPI等框架优化，支持领域特定语言。

社区贡献

• 本地开发：git clone https://github.com/Tushaarxr/forge.git → 安装依赖 → 测试；
• 贡献方向：支持更多本地模型、扩展语言、优化向量搜索与依赖图构建。