kungfu-systems/kungfu

# Kungfu **当聊天结束时，你的 agent 不应该从头开始。** Kungfu 能帮助一个新的 agent 继续之前的工作，而无需你再次解释一切。它通过声明的项目源来实现，让缺失或冲突的 context 可见，并保留足够的结构以便继续工作，而无需从对话历史中重构一切。 首次发布计划的路径是： ``` cd your-project kungfu run agent ``` **状态：即将推出。** 首个公开的 CLI 正在根据下方的体验进行验证。该命令是目标入口，并不代表今天已有公开的 artifact 可用。 ## 可审计的精确输出演示 现在，一个选择性渲染的演示来自一个精确保留的 Linux 构建 artifact： 已安装的 `kungfu` 启动器生成了 transcript，所需的 Buildchain Gate 对其进行了验证，并且所有媒体仅从该通过的 Gate 渲染而来。 [](docs/qualification/auditable-demo-artifact-pipeline.md) [阅读方法与证据](docs/qualification/auditable-demo-artifact-pipeline.md) · [源码 `0c584fc0e644`](https://github.com/kungfu-systems/kungfu/commit/0c584fc0e6446a07a5bdb1462738ffab47dddadb) · [workflow 运行](https://github.com/kungfu-systems/kungfu/actions/runs/30230901970) [Gate bundle](https://github.com/kungfu-systems/kungfu/actions/runs/30230901970/artifacts/8640731842) `sha256:7587c9bc315f49f88e11152d5387ff13a4fe606ef6ba97be8f70c5995aebf2d6` · [媒体 bundle](https://github.com/kungfu-systems/kungfu/actions/runs/30230901970/artifacts/8640746864) `sha256:ee95e4c65effd4edea98a4355595fe8c9eb3291f1966cb6e46f6fad6a8caab21` · [Release Passport](https://github.com/kungfu-systems/kungfu/actions/runs/30230901970/artifacts/8640755422) `sha256:0c44a9618fd4114340ca460a6fd7e3a391ada4c7a540d76b4136c3173373391e` 这仅证明了精确的已安装 artifact 执行以及指定的 Gate/渲染路径。 它不代表关于连续性、provider 迁移、macOS、持久性、性能、FO10 或生产部署的声明。 ## 首次发布体验 一个合格的发布必须让 agent 能够： - 检查项目并解释它的理解； - 展示重要的遗漏、冲突和决定，而不是靠猜测； - 在全新的 context 和 agent 进程中保持当前工作的连贯性； - 记录发生的事情，以便进度和下一步行动不依赖于聊天历史。 第一个可见的价值应该在几分钟内体现出来。更深层的价值会在接下来的几天里显现，那时相同的工作能够挺过 context 丢失、理解改变、尝试失败、交接和重启。 查看[连续性交接](https://kungfu.tech/#continuity-demo)以及[它是如何被测试的](https://kungfu.tech/how-tested/continuity/)，或者检查[源协议与保留的证据](docs/qualification/continuity-pilot.md)。 当前的结果是准备性的 fixture 证据——不是 provider 比较、多日持久性或保留结果，也不是 FO10 验证。 ## 为什么它很重要 - **更少的 context 压力。** agent 可以选择已验证的项目 context，而不是重复加载整个 repository。 - **持久的工作连续性。** 在原始对话消失后，意图、当前理解、行动边界和结果仍然可用。 - **可检查的理解。** 来源、遗漏、不确定性和证据对人和 agent 都保持可见。 ## Agent 供应链中的 Kungfu Kungfu 也是开放 Agent 供应链的创始运行时证明： ``` KFD-3 discovery -> Buildchain artifact evidence -> KFD-2 assessment -> libkungfu / .kungfu durable work facts -> independent Agent Hubs ``` Kungfu 和 libkungfu 拥有第四层：记录、排序、查询、验证、导出和恢复持久的工作事实与 Episodes。应用程序仍然拥有其领域事实，而 JSON 是一个边缘投影，而不是第二权威。公开的 KFD Agent Hub profile 允许独立拥有的产品在该边缘携带受限的责任对象，同时每个接收者保留准入权。 目前的证明是精确源和第一方的：源构建的运行时切片、保留的验证，以及一个 OpenCode 形状的参考 adapter。它不宣称 OpenCode 背书、外部供应商采用、第二个独立的生产 Hub、公开的 Kungfu Cloud、稳定的跨平台兼容性或物理断电验证。阅读[架构与评估路线](docs/architecture/agent-supply-chain.md)。 如果安装了 Kungfu，请直接询问产品本身。第一条命令运行捆绑的固定 KFD Hub 20 套件并解释确切的结果；第二条命令独立复查保留的证据： ``` kungfu agent hub qualify --output-dir ./kungfu-agent-hub-check kungfu agent hub verify --qualification-dir ./kungfu-agent-hub-check ``` 当 reader 是 agent 时，请使用 `--json`。通过仅证明指定的本地 artifact、两个隔离的本地权威域以及固定的 KFD 包切片。它不代表 KFD 认证、安全评估、生产适用性、远程网络互操作性、外部采用或针对未观察到的平台的证据。 ## 在离开或升级时保留你的工作 Kungfu 将 Exit 和迁移视为产品契约。在同一个 `major.minor` 线上合格的稳定版本会保留注册的权威语义，而不是物理 provider 路径、缓存或呈现形式。当前的 v4 alpha 仍然是仅限精确证据的；它尚未承载该稳定承诺。 阅读 [Exit、迁移与版本兼容性策略](docs/guides/exit-and-version-compatibility.md)以了解支持边界、当前的验证矩阵和非声明。一个已安装的 artifact 在不初始化运行时的情况下就会暴露其确切的策略和协议清单： ``` kungfu exit verify --info --json ``` 公开的安装/更新声明仍然是关闭的。确切的当前矩阵、单命令行为、激活边界、回滚指南和明确的非声明都在[升级 Kungfu](docs/guides/upgrading.md)中；源 fixture 和准备好的包管理器 adapter 不是公开的发布 artifact。 ## 继续使用你现有的 agent `kungfu run agent` 是一条黄金路径，而不是 Codex、Claude Code、VS Code、终端或其他 agent 表面的强制替代品。当 agent 继续在其他地方运行时，必须通过 Kungfu CLI 和 API 保持相同的本地契约和工作状态可用。 ## 进一步探索 如果你的目标是了解 Kungfu 作为一个系统，不要一开始就将 repository 目录和当前模块进行并排比较。请从[演进图谱](docs/evolution/README.md)开始：它确立了产生当前横截面的历史压力、抽象压缩和权威过渡。然后使用其 reader 路线进入你的问题所对应的当前确切模块、契约和源权威。 如果你已经有一个受限制的实现或操作任务，请使用 [AGENTS.md](AGENTS.md)和特定于任务的 Xinfa 路线，而不是先加载全部历史记录。 - [从 Kungfu 的纵向演进图谱开始](docs/evolution/README.md) - [为什么 Kungfu 从一个最小的人类主权核心开始](docs/concepts/bootstrapping-agent-work.md) - [检查并重新分析受限的公开工作样本](https://kungfu.tech/about/bootstrapping/evidence/) - [完整的 Kungfu 系统是如何工作的](docs/concepts/system-overview.md) - [Agent 供应链架构与评估](docs/architecture/agent-supply-chain.md) - [文档指南](docs/README.md) - [文档图谱](docs/MAP.md) - [已知限制](docs/qualification/known-limits.md) - [构建并贡献](CONTRIBUTING.md) 使用源检出工作的 agent 应该从 [AGENTS.md](AGENTS.md)和[面向 Agent 的已验证 Context](docs/guides/xinfa-agent-context.md)开始。已安装的运行时带有其自己的本地 agent 简报： ``` kungfu agent brief ``` 要从源检出中发现确切的 Fact 和 Episode 不变量、它们的所有者、当前证据路线和残余风险，请运行： ``` ./shifu invariant:verify -- --list --json ``` 人类路线是[不变量验证](docs/qualification/invariant-verification.md)。 ## 从源构建 目前尚无公开的发布 artifact。要评估当前的源码树： ``` git clone https://github.com/kungfu-systems/kungfu.git cd kungfu ./shifu doctor ./shifu sync && ./shifu build ``` ## 项目状态 Kungfu v4 **即将推出**。源构建功能和验证切片已经存在，但除非有链接的证据另有说明，否则公开打包、跨平台证据、强断电持久性以及机构 profile 仍处于分阶段准备中。 UNGFU 是 Kungfu 的源识别签名，而不是第二个产品或运行时。 关于命名边界，请参阅[为什么是 Kungfu](docs/concepts/why-kungfu.md)。 首次公开 Alpha 版还受到一个有序激活事务的限制。Artifact 发布、Release Passport 密封、确切的站点发布、公开回读和已安装产品的验证必须全部绑定相同的产品/站点源 SHA、artifact 根、版本、tag 和 channel。发布的证据仅从这些收据中合成；准备文件无法做出已发布使用或首次使用的声明。请参阅[商标公开使用验证](docs/qualification/trademark-public-use.md)。 已安装的 Kungfu 会给人或 Agent 提供相同的直接答案： ``` kungfu release status kungfu release verify kungfu release explain ``` 人类结果说明了通过和未通过的内容；`--json` 返回稳定的 KFD-3 表面。在激活之前，真实的答案是 `VERIFIED, NOT AVAILABLE`。这些命令不做出商标注册、法律或首次使用日期的声明。 设计意图、已实现的行为、有保证的验证和已发布的 artifact 是有意区分的。在依赖某项声明之前，请检查[契约](docs/qualification/contracts.md)、[已知限制](docs/qualification/known-limits.md)以及适用的保留验证证据。 Kungfu 完整的 KFD-1 到 KFD-13 采用和声明边界发布在生成的 [KFD 支持矩阵](docs/qualification/kfd-support-matrix.md)中。 源实现、验证、Buildchain 门控和已发布的发布支持是分别报告的；声明的徽章不是发布验证。 在安装依赖项或初始化 Kungfu 运行时之前，请检查当前的检出： ``` ./shifu kfd status ./shifu kfd query KFD-3 --json ./shifu kfd check --json ``` 第一条命令给出即时的人类判定。JSON 格式向 Agent 暴露了相同的签入事实和非声明。它们验证的是源证据，而不是已安装的产品：对于已安装的 Agent Hub 路径，请使用 `kungfu agent hub qualify` 和 `kungfu agent hub verify`。 [](https://github.com/kungfu-systems/kungfu/releases/latest/download/buildchain.release.json) [](https://github.com/kungfu-systems/kungfu/releases/latest/download/buildchain.release.json) [](https://github.com/kungfu-systems/kungfu/releases/latest/download/buildchain.release.json) [](https://github.com/kungfu-systems/kungfu/releases/latest/download/buildchain.release.json) [](https://github.com/kungfu-systems/kungfu/releases/latest/download/buildchain.release.json) [](https://github.com/kungfu-systems/kungfu/blob/HEAD/LICENSE) [](https://github.com/kungfu-systems/kungfu/releases/latest/download/buildchain.release.json) [](https://github.com/kungfu-systems/kungfu/actions/workflows/source-acceptance.yml) [](https://github.com/kungfu-systems/kungfu/actions/workflows/buildchain-validate.yml) [](https://github.com/kungfu-systems/kungfu/actions/workflows/dco.yml) ## 项目链接 - 产品主页： - 开发者和 agent 表面： - 问题与疑问：[GitHub issue 表单](https://github.com/kungfu-systems/kungfu/issues/new/choose) - 安全报告：[SECURITY.md](SECURITY.md) - 许可证：[Apache License 2.0](LICENSE) ## 开放系统仓库 Kungfu 的协议、发布基础设施、构建环境和公开站点均在开放中开发： - [Buildchain](https://github.com/kungfu-systems/buildchain) — 具有可验证的 Release Passport 的可审计构建与发布基础设施。 - [KFD](https://github.com/kungfu-systems/kfd) — 用于在不确定性下实现可靠行动和连续性的开放工程标准。 - [Build Images](https://github.com/kungfu-systems/build-images) — 用于构建 Kungfu 系统 artifact 的可重现环境的源码。 - [kungfu.tech source](https://github.com/kungfu-systems/site-kungfu-tech) — 公开产品站点的源码。 - [libkungfu.dev source](https://github.com/kungfu-systems/site-libkungfu-dev) — 开发者和 agent 表面的源码。 - [所有公开仓库](https://github.com/kungfu-systems) — 完整的组织级源码图谱。

标签：AI智能体, Homebrew安装, SOC Prime, 上下文管理, 开发工具, 文档结构分析, 状态持久化