工作原理： 你提供一份产品需求文档（PRD）。洛基模式会根据复杂度进行分类，从8个集群中的41种专业类型中组建一个代理团队，并运行具有9道质量关卡的自主RARV循环（推理 - 行动 - 反思 - 验证）。只有通过自动化验证后，代码才算“完成”。最终输出是一个包含源代码、测试、配置文件和审计日志的Git仓库。

为什么选择洛基模式？

• 真正自主 -- 描述你的需求，然后离开，回来时就能看到带有测试的可运行代码
• 内置生产级质量 -- 9道质量关卡、盲选三审代码评审、反溜须拍马检查
• 自托管且私密 -- 你的密钥、你的基础设施，数据不会离开你的网络
• 5家AI供应商 -- Claude、Codex、Gemini、Cline、Aider，支持自动故障转移
• 全栈输出 -- 源代码、测试、Docker配置、CI/CD流水线、审计日志
• 开源 -- 个人、内部及学术用途免费。无厂商锁定。

30秒快速上手

npm install -g loki-mode
loki doctor                        # 检查环境
loki init my-app --template simple-todo-app
cd my-app
loki start prd.md                  # 自主构建开始

或者跳过脚手架直接进行快速任务：

loki quick "构建一个带有注册表单的着陆页"

你可以构建什么

你会得到什么

架构

Purple Lab

托管开发平台。类似Replit的Web界面，用于可视化PRD到代码的工作流，并配备AI聊天功能，支持迭代式开发。

loki web                           # 在http://localhost:57375启动

洛基模式与替代方案对比

洛基模式是唯一一个完全自托管、开源，并包含自动化质量验证的平台。你的代码、你的密钥、你的基础设施。

多提供商支持

Claude 提供完整功能（子代理、并行化、MCP、任务工具）。其他提供商按顺序运行。自动故障转移会在被限流时切换提供商。请参阅提供商指南。

CLI 参考

运行 loki --help 查看所有选项。完整参考：CLI 参考 | 配置：config.example.yaml

loki start --bmad-project ./my-project

export LOKI_TLS_ENABLED=true
export LOKI_OIDC_PROVIDER=google
export LOKI_AUDIT_ENABLED=true
loki enterprise status

局限性

“自主”的含义： 系统无需提示即可运行 RARV 循环。它不会访问您的云账户、支付系统或外部服务，除非您提供凭据。部署、API 密钥和关键决策仍需人工监督。

研究基础

贡献

git clone https://github.com/asklokesh/loki-mode.git && cd loki-mode
npm install && npm test              # 683 个测试
python3 -m pytest                    # 631 个测试

请参阅 CONTRIBUTING.md 获取贡献指南。

许可证

商业源码许可证 1.1——个人、内部、学术及非商业用途免费。2030 年 3 月 19 日将转换为 Apache 2.0。商业许可请联系 founder@autonomi.dev。

Loki Mode 快速上手指南

Loki Mode 是一款开源的自主 AI 开发工具，能够根据产品需求文档（PRD）自动生成包含源代码、测试、配置和审计日志的生产级代码库。它支持本地自托管，确保数据隐私，并提供多模型故障转移机制。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS, 或 Windows (WSL2 推荐)
• Node.js：版本 18.0 或更高（用于运行 CLI）
• AI 提供商凭证：需至少配置以下任一模型的 API Key 或本地访问权限：
  • Claude Code (推荐，支持并行代理)
  • OpenAI Codex
  • Google Gemini
  • Cline
  • Aider
• Git：已安装并配置好用户信息
• Docker (可选)：用于运行容器化版本或生成的部署配置

注意：Loki Mode 完全在本地运行，不会将您的代码或数据发送到外部服务器（除非您配置的 AI 提供商需要）。

安装步骤

您可以选择以下任意一种方式进行安装。推荐使用 npm 全局安装以获得最佳体验。

方式一：使用 npm (推荐)

npm install -g loki-mode

方式二：使用 Homebrew (macOS/Linux)

brew tap asklokesh/tap && brew install loki-mode

方式三：使用 Docker

docker pull asklokesh/loki-mode

验证安装

安装完成后，运行以下命令检查环境依赖和配置状态：

loki doctor

如果显示所有检查项通过，即可开始使用。

基本使用

Loki Mode 的核心工作流是：提供需求 -> 自动构建 -> 产出代码。

1. 快速构建简单任务

如果您想快速生成一个小型功能（如落地页），无需创建项目结构，可直接使用 quick 命令：

loki quick "build a landing page with a signup form"

系统将自动分析需求、编写代码、运行测试，并在当前目录生成文件。

2. 完整项目开发流程

对于更复杂的项目，建议按照标准流程操作：

第一步：初始化项目 选择一个模板来启动项目（例如一个简单的待办事项应用）：

loki init my-app --template simple-todo-app
cd my-app

第二步：准备需求文档 (PRD) 在项目根目录下创建一个 prd.md 文件，详细描述您的需求。

• 提示：描述越清晰，生成的代码质量越高。包含功能列表、技术栈偏好和数据模型等信息。

第三步：启动自主构建 运行以下命令启动 AI 代理团队：

loki start prd.md

构建过程说明：

• RARV 循环：系统会自动执行“推理 (Reason) - 行动 (Act) - 反思 (Reflect) - 验证 (Verify)"循环。
• 质量门禁：代码必须通过 9 道质量网关（包括盲审、反阿谀奉承检查、自动化测试等）才会被视为完成。
• 输出结果：构建完成后，您将获得一个完整的 Git 仓库，包含源码、测试用例、Docker 配置、CI/CD 流水线及审计日志。

3. 监控构建进度

在构建过程中，您可以打开本地仪表盘实时查看代理状态、任务队列和日志：

loki dashboard

或者启动 Purple Lab Web UI 获得类似 Replit 的可视化开发体验：

loki web

(默认访问地址：http://localhost:57375)

下一步：构建完成后，请人工审查关键业务逻辑和部署配置，然后即可进行部署。