kungfu-systems/kungfu

Kungfu – LLM-代理的持久化工作层

是什么

• Kungfu 是一个命令行工具（可选 TUI/GUI），可与任何基于 LLM 的编码或推理代理（如 GitHub Copilot Codex、Anthropic Claude、OpenCode、Amp 或自托管模型）并行运行。它将 Work（目标、证据、决策和状态）记录在聊天会话之外，使同一 Work 能够在代理交接、崩溃或断开连接时依然存活。

核心概念

概念	含义
Project	用于分组相关 Work 项的文件夹。Kungfu 在此处创建隐藏的 .kungfu/ 目录以存储状态。
Work	单个持久化任务（例如“准备发布说明”）。它保存当前真相、进度和所需证据。
Attempt	代理执行一次 Work 的尝试。每次尝试都会被记录，即使失败也不会覆盖 Work。

如何工作

1. 通过 Kungfu 启动代理 – kungfu run codex "Prepare the release notes"。Kungfu 启动所选代理，传递提示，并将代理执行的每一步记录为一次 Attempt。
2. 自由切换代理 – 由于 Work 存在于 .kungfu/ 中，您之后可以运行 kungfu run claude 并继续同一任务，无需重新解释上下文。
3. 故障恢复 – 如果代理崩溃或连接中断，下一次 Attempt 会继续同一 Work，保留先前的证据和决策。
4. 独立完成 – 代理可以提出结果，但 Kungfu 需要单独的审查/确认步骤才能将 Work 标记为完成，防止代理自我批准。

主要特性

• 代理无关：适用于任何可运行本地命令的 CLI 兼容 LLM 代理。
• 确定性模拟代理：内置代理（KUNGFU_MOCK_AGENT_SCENARIO）可在无需任何 API 密钥的情况下演示连续性和故障恢复。
• 侧车 UI：可选的终端 UI（kungfu）和图形化 UI，用于可视化 Projects、Work 和 Attempts。
• 可审计证据：每次 Attempt 都会存储提示、响应和生成的任何工件，支持检查和合规性。
• 安全防护：防止两个代理同时写入同一 Work。
• 开源标准：附带 KFD 工程标准和 Buildchain，可生成可验证的发布护照。

安装（macOS / Linux / Windows）

# 一行安装器（无需 sudo，无需修改 shell 配置）
curl -fsSL https://kungfu.tech/install.sh | sh

脚本输出 PATH 添加后，将其添加到您的 shell（或遵循 Windows 指南）。安装程序会拉取最新的 Alpha 版本。

快速开始

# 在任意项目文件夹内
KUNGFU_MOCK_AGENT_SCENARIO=recovery-story kungfu   # 运行确定性的三步演示
# 或运行真实代理
kungfu run codex "Write the changelog for v2.3"

隐藏的 .kungfu/ 目录将出现；请勿将其纳入版本控制。

典型用例

• 长时间运行的开发任务，您可能需要在更便宜和更强大的 LLM 之间切换。
• 团队环境，多个工程师（或机器人）需要协作处理同一 AI 生成的工作，且不丢失上下文。
• 合规/审计 场景，需要完整且不可变的日志记录模型生成内容及其原因。

成熟度

• 项目处于 Alpha（v4）阶段。可在 macOS、Linux 和 Windows 上运行，但 API 和 UI 仍可能更改。README 警告该版本为预发布渠道，并指向“Alpha 状态”和“已知限制”文档以获取详细信息。

许可证

• Apache-2.0（参见 LICENSE）。

了解更多

• 系统概览：docs/concepts/system-overview.md
• 代理-工作实验室教程：docs/guides/agent-work-lab.md
• 完整文档地图：docs/MAP.md
• 发布制品：https://github.com/kungfu-systems/kungfu/releases/latest

---

Kungfu 本质上是 LLM 驱动代理的连续性层，让您将 AI 生成的工作视为可抵御崩溃、交接和模型变更的常规软件资产。