---
hide:
- toc
- navigation
---
<h1>
<img src="favicon.svg" style="height: 1.2em; vertical-align: middle; margin-right: 0.3em;">
phi-agent
</h1>
Rust 通用 AI Agent 框架 — 简单、纯粹、可预测。
<a href="guide/getting-started/" class="md-button md-button--primary" style="margin-right: 0.5rem">
:octicons-arrow-right-24: 快速开始
</a>
<a href="https://github.com/hibuka-labs/phi-agent" class="md-button" target="_blank">
:octicons-mark-github-16: GitHub
</a>
---
<div class="grid cards" markdown>
- :simple-rust:{ .lg .middle } **纯 Rust**
---
异步、类型安全、零成本抽象。一个二进制，从云端到边缘随处运行。
- :material-lightbulb-on-outline:{ .lg .middle } **简单**
---
无隐藏状态，无黑魔法。显式控制流 — 可读、可追踪、可信赖。
</div>
<div class="grid cards" markdown>
- :material-toy-brick-outline:{ .lg .middle } **你说了算**
---
零内置工具。实现 `Tool` trait，按需注册，能力由你掌控。
- :material-chart-line:{ .lg .middle } **可观测**
---
内置对话日志、指标采集、链路追踪。每个决策有记录，每次结果可度量。
</div>
---
## 架构
``` title="依赖链"
agent-base (运行时内核 + Tool trait)
↑
agent-works (MCP, Skills, Focus)
↑
phi-agent (lib) ← 框架层，不含工具
↑
你的应用 (CLI, Web 等) ← 在这里注册工具
```
每个 crate 都是 [hibuka-labs](https://github.com/hibuka-labs) 下的独立仓库。基于 Rust 异步运行时，通过 `Arc<dyn LlmClient>` 实现 LLM 提供商抽象。
## 链接
<div class="grid cards" markdown>
- [:octicons-mark-github-16: GitHub](https://github.com/hibuka-labs/phi-agent)
源码、Issues、讨论。
- [:simple-rust: crates.io](https://crates.io/crates/phi-agent)
`cargo add phi-agent` 即可引入。
- [:material-bookshelf: API 文档](https://docs.rs/phi-agent)
完整的 Rustdoc 文档。
</div>
---
:material-email-outline: **联系** [phiagent@hibuka.com](mailto:phiagent@hibuka.com)
