项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-17 · 当前星标 ★ 4541
使用教程
ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。
环境要求
- macOS 或 Linux 系统（README 当前仅说明这两个平台）
- 能访问 https://kungfu.tech 下载安装脚本
- 无需 sudo 权限，安装脚本不会修改 shell 配置文件
- 运行内置 Mock Agent 不需要任何模型 provider 凭证
安装与启动步骤
-
1安装 Kungfu 命令
用官方提供的 per-user 安装脚本安装，不需要 sudo，也不会自动修改 shell 配置。
curl -fsSL https://kungfu.tech/install.sh | sh -
2按提示配置 PATH
安装完成后脚本会打印需要执行的 PATH 步骤，请严格照它输出的内容操作，然后重开终端。
-
3进入你的项目目录
切换到任意一个本地项目目录，作为 Kungfu 的工作目录。
cd your-project -
4跑恢复场景验证
内置 Mock Agent 会依次经历断连、崩溃、恢复交付三次 Attempt，全程确定性、不依赖模型。
KUNGFU_MOCK_AGENT_SCENARIO=recovery-story kungfu -
5跑多步引导场景
更快的上手检查：在同一次 Attempt 中经过提问、审批、可评审结果三个阶段。
KUNGFU_MOCK_AGENT_SCENARIO=multi-step kungfu
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
KUNGFU_MOCK_AGENT_SCENARIO | 否 | 选择内置 Mock Agent 的演示场景，用于验证本地连续性与恢复能力 | recovery-story |
如何确认成功
终端里三个连续 Attempt 依次跑完：先断连、再崩溃、最后成功恢复交付，即说明本地连续性正常。
常见问题
Q：运行演示需要配置模型 API Key 吗？
A：不需要。内置 Mock Agent 无需任何 provider 凭证，场景是确定性的，只验证 Kungfu 的本地连续性与恢复路径。
Q：安装脚本会用 sudo 或改我的 shell 配置吗？
A：不会。脚本为 reviewed per-user 安装，不使用 sudo，也不编辑 shell profile，PATH 需要你按它打印的步骤手动设置。
Q：Windows 可以用吗？
A：README 目前的安装说明只覆盖 macOS 或 Linux，Windows 未给出安装方式，需查阅官方安装指南。
Q：两个演示场景有什么区别？
A：recovery-story 用三次 Attempt 演示断连、崩溃、恢复；multi-step 则在一次 Attempt 内走完提问、审批、可评审结果。
注意事项
- Kungfu 当前处于 Alpha 阶段，功能和接口可能变化，不建议直接用于生产环境。
- 安装脚本输出的 PATH 步骤必须照做并重开终端，否则 kungfu 命令不可用。
- 更多安装细节见 README 中提到的 docs/guides/installing-cli.md 安装指南。
核心亮点
- 跨平台智能体适配，一套代码对接Codex、Claude等，降低集成成本
- 内置工作记忆机制，任务切换时保留状态，避免重复劳动
- C++核心实现，性能开销低，适合高并发编排场景
不足之处
- 文档/社区待观察
- C++技术栈对非系统级开发者有一定上手门槛
适用场景
- 多AI工具协同完成复杂软件开发任务
- 需要持久化上下文的长期运行自动化流程
- 构建自定义智能体编排平台或内部工具链
替代项目
LangChain、AutoGen、CrewAI
上一篇：sandbase-harness
下一篇：yao-meta-skill
同类项目推荐
OpenDAN-Personal-AI-OS
开源
把散落的AI装进一个操作系统，统一管理你的智能代理
OpenDAN is an open source Personal AI OS , which consolidates various AI modules in ···
teammate-skill
开源
把同事的工作经验自动变成 AI 技能，让团队智慧不流失。
Distill a teammate into an AI Skill. Auto-collect Slack/Teams/GitHub data, generate ···
Aetox-Harness
开源
本地优先的 Windows AI 工作台，助手加开发者双入口
Aetox harness: a local-first Windows AI environment - model, skills, team and memory···
sample-agentic-platform
开源
照着搭，把本地 Agent 工作流一键搬到 AWS 跑起来
A sample agentic ai platform to run agentic workflows on AWS using either EKS or Bed···
agent-teams-ai
开源
当AI老板，让代理团队自动协作干活
You're the boss, agents are your team. They handle tasks on their own, message each ···
palot
开源
把 AI 编程从终端搬到桌面，可视化管会话、看 diff、实时流。
Just another desktop client for OpenCode 2. Manage projects, sessions, parallel agen···
Starmoon
开源
用 ESP32 打造你的 AI 语音助手，快速落地对话硬件
A conversational, AI device + software framework for companionship, entertainment, e···
astron-agent
开源
用 Java 搭建企业级智能体工作流，快速构建复杂 AI 应用。
Enterprise-grade, commercial-friendly agentic workflow platform for building next-ge···
pentest-harness
开源
本地跑 AI 打授权渗透，自带模型 API 不泄露数据
Pentest Harness — Heaven for Hackers. A self-hosted AI agent harness for authorized···