FollowAgents AI AGENTS 目录
首页 / 全部 Agents / Loki Mode
开发与工程 spec-driven-developmentcode-reviewquality-gatesevidence-receiptsmcp-serverlegacy-modernizationdocker-compose

Loki Mode

把规格转为经验证代码与可复核交付凭证。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
asklokesh/loki-mode
Star 数
★ 1.1k
最近更新
今天
License
NOASSERTION
主语言
Shell
FA 评分
57/100 · 缺口较多

30 秒速览

运行形态
命令行工具MCP 服务器Agent 插件 / 技能
可在哪里用
兼容但需适配Claude Code · Claude APICodex · OpenAI API（部分支持）
费用
软件免费，模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Python 3.10+Git 2.x已认证的提供方 CLI 或 Anthropic API 凭据用于捆绑 Claude SDK 模式的 Bun 1.3.0+Shell / 命令行网络访问本地文件系统MCP Server
典型场景
需要把一份 PRD 或一句产品需求交给 CLI，并希望最终获得代码、测试和可复核 diff 证据的小型产品团队。
不适合
  • 希望使用 Claude Code 之外提供商进行生产构建的团队：只有 Claude Code 是端到端验证的一级提供商，其余均为实验性。
  • 需要宽松开源许可证的商业用户：代码采用 BUSL-1.1，2030 年才转为 Apache 2.0。
源码审查
57/100 · 缺口较多

这个 Agent 能做什么，适合哪些场景？

Loki Mode 是一个从需求规格驱动的软件构建与验证 CLI。它接受 PRD、GitHub Issue、OpenAPI/JSON/YAML、纯文本 brief 等输入，通过 Bash 编排的 RARV 循环执行 Reason、Act、Reflect、Verify。运行会生成 Git 仓库中的源代码、测试、配置、Docker Compose 文件、CI/CD 配置、审计日志及 .loki/proofs/<run_id>/ 下的 Evidence Receipt。该项目提供 loki CLI、Python 仪表盘、跨项目记忆系统，以及可由 loki mcp 启动的 MCP server。它可以生成部署配置，但文档明确说明 loki deploy 只输出部署命令，不会自行执行云端 CLI 或 git push。

使用 loki start <spec> 读取并标准化 Markdown、JSON、YAML/OpenAPI、GitHub Issue、Jira、GitLab 或 Azure DevOps issue 等规格输入，再由 autonomy/run.sh 的 run_autonomous() 执行 RARV 循环。它按复杂度组合 41 个角色规格，运行静态分析、测试、盲审、反迎合检查、mock 完整性、测试变异、文档覆盖和 Magic Modules 辩论等 8 个质量门。完成时，Loki 将 diff 的 base/head SHA、diff_sha256、测试和构建命令及退出码、门禁结果写入 Evidence Receipt；可通过 loki proof list、loki proof show <id> 与 loki proof verify <id> 检查。loki verify 还能对任意分支或 PR diff 运行构建、测试、静态分析、密钥扫描和依赖审计，并将机器可读证据写入 .loki/verify/evidence.json。对已有代码库，loki modernize heal <path> --assess 会先以只读方式产出语言、成熟度、技术债和按爆炸半径排序的建议。

  1. 需要把一份 PRD 或一句产品需求交给 CLI，并希望最终获得代码、测试和可复核 diff 证据的小型产品团队。
  2. 维护多年旧仓库的工程团队，可先运行 loki modernize heal ./repo --assess 评估技术债而不修改文件。
  3. 需要把 OpenAPI、GraphQL 或 Postman 合约拆成逐操作检查项的 API 团队。
  4. 希望在 PR 审查中附带测试、diff 哈希和门禁结果，而不只依赖代理自述完成状态的代码审查者。
  5. 使用 Claude Code 为主、但需在 Cline、Codex、Aider 或 opencode 间保留切换和故障转移路径的开发者。

如何安装或部署这个 Agent？

快速查看离线示例：npx loki-mode tour。推荐全局安装：bun install -g loki-mode；随后运行 loki doctor 检查环境。常规运行需要 Python 3.10+、Git 2.x、curl，以及已安装并认证的 provider CLI；README 将 Claude Code 列为 Tier 1。也可使用内置 Claude Agent SDK：设置 ANTHROPIC_API_KEY=sk-...，并执行 LOKI_SDK_MODE=full loki start prd.md，此路径要求 Bun 在 PATH 中。

如何使用这个 Agent？

首次可执行 loki quickstart，按提示完成环境检查、输入想法、选择模板并审阅计划。脚本化流程可用：loki init my-app --template simple-todo-app，然后 cd my-app && loki start prd.md。运行完成后用 loki proof list 找到凭证，并用 loki proof verify <id> 重新计算哈希和 diff；对现有分支可运行 loki verify。若需要本地仪表盘与预览，使用 loki dashboard 或 loki preview。

这个 Agent 有哪些优点和局限？

优点
  • Evidence Receipt 将 diff 哈希、实际测试命令与退出码、构建结果和门禁结论写为可重新验证的文件，并明确区分确定性事实与 AI 判断。
  • loki verify 可独立检查任意分支或 PR diff，并使用 0、1、2 作为 VERIFIED、CONCERNS、BLOCKED 的 CI 退出码。
  • 支持从多种规格来源启动，包括 PRD、OpenAPI/JSON/YAML、GitHub Issue、Jira 和 GitLab/Azure DevOps issue。
  • 既支持新项目构建，也提供带 archaeology、stabilize、isolate、modernize、validate 阶段的旧系统修复流程。
  • 提供 Claude Code、Cline、Codex、Aider、opencode 的 provider 路径，以及本地 MCP server、Docker Compose 输出和本地仪表盘。
局限
  • Claude Code 是唯一标注为 Tier 1 且端到端验证的 provider；Cline、Codex、Aider 和 opencode 均为实验性且顺序执行。
  • 实际构建需要已认证的模型提供商 CLI 或 Anthropic 凭据；tour 和离线 demo 只是历史样例回放，不能验证你的项目。
  • 凭证未签名时，README 明确承认攻击者若同时重写事实、标题并重算哈希，仍可能通过验证；GPG 签名需自行配置。
  • 项目采用 Bash 与 Bun 双运行时，部分命令由 Bun 路由；文档还提示后续大版本可能终止 Bash 运行时，带来迁移风险。
  • 许可证信息存在不一致：提供的仓库元数据标为 NOASSERTION，README 则声明 BUSL-1.1，并称 2030 年转换为 Apache 2.0。

这个 Agent 与同类方案有什么区别？

README 将 Loki Mode 与 bolt.new、Replit 和 Lovable 对比，主张其具备自托管、自带密钥、多 provider 故障转移、8 个质量门和盲审。该比较仅针对表中列出的产品，README 也明确表示并未覆盖整个市场。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Loki Mode 当前 57 · 缺口较多 命令行工具免费 + 模型费 ★ 1.1k 今天 Shell Claude Code · Claude API
MoAI 开发编排器 66 · 存在缺口 命令行工具免费 + 模型费 ★ 1.3k 4 天前 Go Claude Code
Flow-Next 工程流水线 62 · 存在缺口 Agent 插件 / 技能免费 + 模型费 ★ 718 今天 Python Codex · Claude Code
Pilot Shell 53 · 缺口较多 命令行工具付费 ★ 2.1k 1 天前 Shell Claude Code

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
缺口较多
57/ 100 五分制 2.9 / 5
本评测基于 2026年8月9日 的源码；此后该项目发布了 167 个正式版本，尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 13/29
可靠稳定 8/14
适用触发 12/18
规范维护 11/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

证据显示：README 强调只读评估模式（--assess）、用户确认（--strict 阻止所有行为变更）、证据收据分离事实与 AI 评估、GPG 签名可选、secret-leak 门禁。扣分：未提供权限最小化的具体实现细节（如文件系统访问范围），敏感数据处理（如 API 密钥存储）未详细说明，依赖安全（如漏洞扫描）仅提及，回滚机制未明确，发布者身份未验证。

可靠稳定8 / 14 · 2.9/5

证据显示：README 声称有 8 个质量门禁、确定性验证、失败时明确报告（NOT VERIFIED），测试文件展示了对等价性报告和评分器的自检。扣分：依赖可用性（如 Bun、Python）未在文档中明确保证，失败消息的具体内容未展示。

适用触发12 / 18 · 3.3/5

证据显示：README 描述了多种使用场景（新项目、遗留代码、不同 spec 类型）、能力边界（如不支持某些模型）、触发条件（如 --assess 只读）、环境适配（跨平台、Docker）。扣分：未提供详细的配置选项文档，环境要求（如 Bun 版本）未明确。

规范维护11 / 18 · 3.1/5

证据显示：README 结构清晰，包含安装、使用、文档链接、变更日志、许可证（BUSL-1.1）、版本号（v9.16.0）。扣分：已知限制未单独列出，维护责任（如贡献指南）未明确，发布者身份未验证。

有效结果9 / 13 · 3.5/5

证据显示：README 强调输出为可验证的 Git 仓库、证据收据、成本估算，边际价值（如验证完成）和成本效益（如免费使用）有说明。扣分：未提供实际使用案例或性能数据。

证据核验4 / 8 · 2.5/5

证据显示：README 提供可运行的验证命令（loki proof verify）、测试文件展示自检，并明确区分事实与 AI 评估。扣分：跨来源佐证不足（仅依赖自身文档），部分声明（如“8 个质量门禁”）未在代码中直接验证。

风险与缓解建议
  • 发布者身份未验证，需谨慎对待来源。
  • 依赖安全仅提及，未提供具体漏洞扫描结果或依赖清单。
  • 敏感数据处理细节不足，如 API 密钥存储方式。
  • 回滚机制未明确，需确认在失败时如何恢复。
证据充分度：低 评估于 2026年8月9日 审查版本 9d7a13697242 评估后仓库已有新提交，评分可能未覆盖最新改动
评估证据 README.mdLICENSEpackage.jsonworkflows/arm64-runtime.ymlworkflows/bun-parity.ymltests/test_equivalence_report.pytests/test_grader_discrimination.pytests/test_iteration_source.py
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. v11.137.4 Loki Mode v11.137.4
    发布说明摘录
    Loki on Haiku finishes tasks about 14% faster with the same outcomes. Changed - The executable-spec call now starts during intake and is reused when its request is unchanged (LOKI_E10_EXEC_SPEC_PREFETCH=0 opts out). - The Go no-regression differential runs alongside verify instead of after implement (LOKI_E10_NRD_OVERLAP=0 opts out). - npm, pnpm and yarn running the same root test script share one base run (LOKI_BASELINE_SCRIPT_ALIAS=0 opts out). - Paired on 6 benchmark tasks against v11.137.2: median 343.5 s to 295.5 s per task, identical outcomes on all 6.
    在 GitHub 查看 ↗
  2. v11.137.3 Loki Mode v11.137.3
    发布说明摘录
    Loki now runs on the latest Claude Code and Anthropic SDKs, and its safety hooks fail closed. Changed - Agent SDK 0.3.316 -> 0.3.318, Anthropic SDK 1.3.0 -> 1.6.0, bundled Claude Code 2.1.316 -> 2.1.318, Python anthropic 2.3.0 -> 2.6.0, pinned together everywhere including the Docker image (which had been left at 0.3.314). - On the SDK route, the host-guard and config-fence hooks now block a tool call when the hook itself fails, instead of letting it run. - The dependency freshness check also covers the bundled Claude Code and reports how many releases each pin is behind.
    在 GitHub 查看 ↗
  3. v11.137.2 Loki Mode v11.137.2
    发布说明摘录
    Loki on Haiku no longer short-cuts implement with a one-call patch, which raised merge-ready from 9 to 14 of 20 on the benchmark. Changed - The implement patch step (LOKI_E10_PATCH) is now off by default; LOKI_E10_PATCH=1 opts in. On the v11.137.1 Haiku benchmark it finished 9 of 20 runs without the agentic session and cost 5 merge-ready tasks (9 vs 14 of 20; judge pass 10 vs 18) at the same median time per task.
    在 GitHub 查看 ↗

常见问题

不安装或不配置 API key 能试用吗？
可以运行 npx loki-mode tour 或 loki demo --offline 查看历史 Evidence Receipt；两者均为回放样例，不会对你的代码给出结论。
它会自动部署或推送我的代码吗？
不会。文档说明它可生成 Dockerfile、CI/CD 和部署配置，但 loki deploy 只打印部署命令，不执行云端 CLI 或 git push。
“VERIFIED” 是否代表代码没有缺陷？
不代表。它表示非空 diff、实际执行并通过的测试以及已记录的检查满足凭证条件；README 明确不将其视为代码无 bug 的证明。
可以不用 Claude Code 吗？
可以选择 Cline、Codex、Aider 或 opencode，或以 Anthropic API 凭据使用内置 SDK；但 README 将这些非 Claude Code provider 标为实验性，并说明它们顺序执行。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审，横向比较这个 Agent 所属的短名单。

Claude Code Agent 横向对比

完整兼容 Claude Code 的 agent，按 FARS 评审排序——兼容性取自各 agent 自己的 AGENTS.md 与文档，不做推测。

MCP Agent 横向对比

提供或调用 Model Context Protocol 服务的 agent，按 FARS 评审排序，并列出许可证、维护状态与信任分。

相关 Agents

开发与工程

MoAI 开发编排器

为 Claude Code 增加可验证的 SPEC 工作流、质量门禁与成本控制。
开发与工程

Flow-Next 工程流水线

把 AI 编程任务转为可审查的规格、任务、跨模型评审与完成凭据。
开发与工程

Pilot Shell

为 Claude Code 与 Codex CLI 加入规格驱动开发、TDD 和质量门禁。
开发与工程

Aegis 方法包

让编程智能体先核对架构基线，再安全修改并用新证据验证结果。