mirrors / leon-ai--leon

项目文件夹

leon-ai--leon
文件
main
T
wehub-resource-sync d95e660ed1 docs: make Chinese README the default
2026-07-13 10:42:59 +00:00

190 行
8.4 KiB
Markdown
原始文件 永久链接 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的，可以安全地忽略该警告。 使用 Escape 按钮显示他们。
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/leon-ai/leon) · [上游 README](https://github.com/leon-ai/leon/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
<p align="center">
<a href="https://getleon.ai"><img width="800" src="https://getleon.ai/img/hero-animation.gif" /></a>
</p>
<h1 align="center">
<a href="https://getleon.ai"><img width="96" src="https://getleon.ai/img/logo.svg" alt="Leon"></a><br>
Leon
</h1>
_<p align="center">你的开源个人 AI 助手。</p>_
<p align="center">
<a href="https://discord.gg/MNQqqKg"><img src="https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white" /></a>
<a href="https://github.com/leon-ai/leon/blob/develop/LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-1c75db?style=for-the-badge" /></a>
</p>
<p align="center">
我最常在 <a href="https://x.com/grenlouis"><strong>X / @grenlouis</strong></a> 上分享 Leon 的进展
</p>
<p align="center">
<a href="https://x.com/grenlouis">在 X / @grenlouis 关注进展</a> ·
<a href="https://getleon.ai">网站</a> ·
<a href="https://leonai.substack.com/subscribe">Newsletter</a> ·
<a href="http://roadmap.getleon.ai">路线图</a> ·
<a href="https://blog.getleon.ai/the-story-behind-leon/">故事</a>
</p>
---
## ⚠️ 重要通知（截至 2026-03-29）
> [!IMPORTANT]
> Leon 目前专注于 `develop` 分支上的 **2.0 Developer Preview（2.0 开发者预览版）**。
>
> - 新文档**尚未就绪**。
> - 当前文档站点和旧版指南大多反映的是旧版架构。
> - 如果你想要旧版、更稳定的非智能体式（pre-agentic）Leon，请使用 `master` 分支。
> - 如果你想探索或参与 Leon 新核心的开发，`develop` 是合适的选择。
关于 Leon 当前状态最准确的高层参考是：
- [`core/context/LEON.md`](./core/context/LEON.md)
- [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md)
## 👋 简介
**Leon** 是一款围绕**工具、上下文、记忆和智能体式执行（agentic execution）**构建的**开源个人 AI 助手**。
Leon 的设计注重实用性、隐私保护，并扎根于你的真实环境。它可以在本地运行，使用专用工具而非依赖自由形式的猜测，并能在确定性工作流和智能体式执行中从头到尾完成任务。
## 🧠 Leon 如今的定位
Leon 不再像 2019 年首次发布时那样，只是一个经典的意图分类助手。
如今，Leon 正被打造为能力更强的助手，能够理解目标、选择处理方式、使用工具、记住有用信息，并在出现问题时进行恢复。
- Leon 可根据任务以不同方式运行：`smart` 模式会替你选择，`controlled` 模式遵循确定性的原生技能和操作，`agent` 模式可以逐步规划。
- Leon 支持用于受控操作的原生技能，以及用于 `SKILL.md` 支持的工作流的智能体技能。
- Leon 可以使用真实工具完成任务，而不仅限于纯文本回复。
- Leon 可以利用你环境中的上下文，使回答始终立足于你机器和配置上的实际情况。
- Leon 保持分层记忆，能够记住持久偏好、日常上下文以及近期讨论上下文。
- Leon 同时支持本地和远程 AI 提供商，有助于在隐私、控制与能力之间取得平衡。
- 在底层，Leon 原生技能遵循 `Skills -> Actions -> Tools -> Functions (-> Binaries)`。
Leon 还维护紧凑的自我模型和有边界的主动脉冲（proactive pulse）系统，使其能够长期保持一致，而不会用不必要的上下文淹没自身。
## 为什么？
- **隐私很重要**：Leon 可以使用本地模型和本地上下文，而无需将所有内容强制经由第三方服务。
- **立足现实的行为很重要**：Leon 更倾向于使用明确的工具、上下文和记忆，而非模糊的纯模型回复。
- **可扩展性很重要**：技能、工具包、桥接和二进制组件使 Leon 能够保持模块化。
- **开源很重要**：任何人都可以审查架构、在其基础上构建，并帮助塑造其未来方向。
## 🚀 快速开始
### 前置条件
- [Node.js](https://nodejs.org/) >= 24.0.0
- 支持的操作系统：Linux、macOS 和 Windows
推荐：使用 [Volta](https://volta.sh/). 管理 Node.js
### 安装
```sh
# Clone the repository
git clone https://github.com/leon-ai/leon.git
# Go to the project root
cd leon
# Install pnpm
npm install --global pnpm@latest
# Install dependencies
pnpm install
```
### 运行 Leon
```sh
# Run Leon
pnpm start
```
### 检查你的环境
```sh
# Check the setup went well
pnpm run check
```
默认情况下，Leon 在本地运行，应用可通过 `http://localhost:5366` 访问。
## 🏗️ 架构概览
从高层来看，Leon 目前由以下部分组成：
- `server/`：主运行时、路由、记忆、上下文管理、HTTP API，以及智能体/受控执行
- `app/`：Web 应用
- `aurora/`：UI 组件和预览环境
- `skills/`：内置能力，分为 `native/` 技能和 `agent/` 技能
- `bridges/`：Node.js 和 Python 桥接，以及工具包定义和工具运行时
- `tcp_server/`：运行时栈部分组件使用的 Python 服务
- `core/context/`：描述 Leon 当前行为的生成式身份与架构上下文文档
本仓库已包含搜索、生产力、系统工具、媒体工作流、编程辅助、记忆支持交互以及语音/音频功能等领域的技能和工具包。
## 📚 文档状态
Leon 2.0 的新文档尚未就绪。
目前：
- 将此仓库视为 **2.0 Developer Preview** 的权威来源
- 使用 [`core/context/LEON.md`](./core/context/LEON.md) 了解 Leon 当前的身份与行为
- 使用 [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md) 了解当前架构概览
- 在更新后的文档发布之前，公开文档站点预计会滞后于新核心
## ❤️ 参与贡献
我们正在逐步为 **2.0 Developer Preview** 引入贡献者。
如果你想关注该项目或表达加入该引导流程的意向：
- [2.0 Developer Preview 贡献者表单](https://forms.gle/6PCG2D5rYo1q8tKMA)
- [路线图](http://roadmap.getleon.ai)
- [Discord](https://discord.gg/MNQqqKg)
- [GitHub issues](https://github.com/leon-ai/leon/issues)
### 为什么贡献者数量较少？
Leon 已经演进了很长时间，但当前的 2.0 工作正处于重大转型期。
长期以来，Leon 是一个架构更简单的小型助手项目。如今，核心正在围绕工具、记忆、上下文和智能体式执行重建为能力更强的系统。这意味着许多内容仍在变动，在全新文档和架构稳定下来之前，参与贡献会比之后更加困难。
另一个重要原因仅仅是时间：Leon 的开发仍主要在业余时间进行。因此进展可能不均衡，在 2.0 Developer Preview 仍在成形之际，更广泛地开放项目必须与保持方向连贯性之间取得平衡。
## 📖 Leon 背后的故事
Leon 始于 2017 年，自 2019 年以来一直活跃。如果你想了解更完整的故事，请阅读 [Leon 背后的故事](https://blog.getleon.ai/the-story-behind-leon/).
## 🔔 保持关注
- [X / Twitter](https://x.com/grenlouis) 是我分享 Leon 进展更新的主要渠道
- [Newsletter](https://leonai.substack.com/subscribe)
- [Blog](https://blog.getleon.ai)
- [YouTube](https://www.youtube.com/channel/UCW6mk6j6nQUzFYY97r47emQ)
## 👨 作者
**Louis Grenard** ([@grenlouis](https://x.com/grenlouis))
## 👍 赞助商
你也可以通过[赞助 Leon](http://sponsor.getleon.ai). 来参与贡献
## 致谢
| ![OpenAI logo.](./.github/assets/thanks/openai-logo-light-mode.svg?v=2#gh-light-mode-only)![OpenAI logo.](./.github/assets/thanks/openai-logo-dark-mode.svg?v=2#gh-dark-mode-only) | ![JetBrains logo.](./.github/assets/thanks/jetbrains-mono-black.svg?v=2#gh-light-mode-only)![JetBrains logo.](./.github/assets/thanks/jetbrains-mono-white.svg?v=2#gh-dark-mode-only) | ![MacStadium logo.](./.github/assets/thanks/macstadium-logo-light-mode.svg?v=2#gh-light-mode-only)![MacStadium logo.](./.github/assets/thanks/macstadium-logo-dark-mode.svg?v=2#gh-dark-mode-only) |
| --- | --- | --- |
| [openai.com/form/codex-for-oss](https://openai.com/form/codex-for-oss/) | [jb.gg/OpenSource](https://jb.gg/OpenSource) | [macstadium.com/company/opensource](https://macstadium.com/company/opensource) |
在新工单中引用 查看 Git Blame 复制永久链接