Localforge 有哪些主要功能?

Localforge 是一个免费、开源、MIT 许可的本地桌面 AI 编程代理，核心能力是让代理直接在你的代码仓库里自主编辑文件、运行测试、执行 shell 命令，同时提供图形界面来管理任务和模型。它适合希望代码不出本机、又想用代理式编程处理多文件大任务的开发者；前提是你需要自备所选模型提供商的 API Key。

代理能做什么

Localforge 的代理不是只给建议的聊天窗口，而是直接在本地仓库中操作：

• 编辑文件：代理直接修改代码，你可以与它并排编辑，也可以让多个代理同时处理同一个代码库。
• 运行测试：代理会执行测试来验证改动。
• 执行 shell 命令：以本地磁盘速度运行命令，不经过云端往返。
• 任务跟踪：内置任务跟踪器显示每一步操作以及为什么这样做，方便你判断代理的决策是否合理。
• Expert Mode：遇到复杂问题时开启，让更聪明的模型审查并提升结果。

这些能力组合起来，适合“大任务、多文件”的场景，而不是单文件补全。

模型接入与切换

Localforge 是代理无关（agent-agnostic）的，官方列出的可接入提供商包括：

OpenAI、Azure、Claude、Gemini、Vertex AI、Ollama、OpenRouter、Groq、DeepSeek、Mistral、Perplexity、Anyscale、Fireworks、Together，以及 qwen3。

切换方式是“一键切换提供商”，没有厂商锁定。费用模式是自带 Key（Bring Your Own Keys）：软件本身免费开源，你只需向所选模型提供商付费。

界面与工作流

• Electron 桌面 GUI：带标签页、多项目支持、可视化 diff，减少在终端里反复操作。
• 提示模板：可以保存、调整、复用提示词，官方提到可共享的模板市场即将推出。
• 多项目：同一个工作区管理多个代码库。

本地运行意味着什么

所有操作都在你的机器上、在你的仓库内完成。官方强调代码、密钥和 git 历史不会离开本机，因此没有 SaaS 层面的窥探、厂商锁定或合规负担。代价是模型推理本身仍取决于你接入的提供商——如果用的是云端模型，请求仍会发往该提供商；只有接入 Ollama 等本地模型时才是完全离线。

版本与支持

免费版即可获得本地执行和无限仓库，付费主要买的是更新期限、优先支持和团队支持。

安装入口

官方提供 macOS 和 Windows 下载，也可以通过 npm 全局安装：

npm i -g @rockbite/localforge

安装后按页面上的 Setup Instructions 配置你的模型 API Key 即可开始使用。

如果你的日常开发涉及跨多个文件的改动、希望代理真正动手改代码而不是只给建议，并且在意代码留在本机，Localforge 的功能组合基本覆盖了这类需求；如果你只需要单文件补全或不想自己管理 API Key，它的价值会小很多。