wehub-resource-sync
190 lines
8.4 KiB
Markdown
190 lines
8.4 KiB
Markdown
<!-- 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.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) |
|