From d95e660ed14c1bf202301ab35c2c59e4e289258a Mon Sep 17 00:00:00 2001 From: wehub-resource-sync Date: Mon, 13 Jul 2026 10:42:59 +0000 Subject: [PATCH] docs: make Chinese README the default --- README.md | 154 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 80 insertions(+), 74 deletions(-) diff --git a/README.md b/README.md index c4e4563..08e22d8 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ + +> [!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 文件为准。 +

@@ -7,7 +13,7 @@ Leon -_

Your open-source personal AI assistant.

_ +_

你的开源个人 AI 助手。

_

@@ -15,73 +21,73 @@ _

Your open-source personal AI assistant.

_

- I share Leon progress most regularly on X / @grenlouis + 我最常在 X / @grenlouis 上分享 Leon 的进展

- Follow progress on X / @grenlouis · - Website · + 在 X / @grenlouis 关注进展 · + 网站 · Newsletter · - Roadmap · - Story + 路线图 · + 故事

--- -## ⚠️ Important Notice (as of 2026-03-29) +## ⚠️ 重要通知（截至 2026-03-29） > [!IMPORTANT] -> Leon is currently focused on the **2.0 Developer Preview** on the `develop` branch. +> Leon 目前专注于 `develop` 分支上的 **2.0 Developer Preview（2.0 开发者预览版）**。 > -> - The new documentation is **not ready yet**. -> - The current docs site and older guides mostly reflect the legacy architecture. -> - If you want the legacy, more stable pre-agentic version of Leon, use the `master` branch. -> - If you want to explore or contribute to Leon's new core, `develop` is the right place. +> - 新文档**尚未就绪**。 +> - 当前文档站点和旧版指南大多反映的是旧版架构。 +> - 如果你想要旧版、更稳定的非智能体式（pre-agentic）Leon，请使用 `master` 分支。 +> - 如果你想探索或参与 Leon 新核心的开发，`develop` 是合适的选择。 -The most accurate high-level references for Leon's current state are: +关于 Leon 当前状态最准确的高层参考是： - [`core/context/LEON.md`](./core/context/LEON.md) - [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md) -## 👋 Introduction +## 👋 简介 -**Leon** is **your open-source personal AI assistant** built around **tools, context, memory, and agentic execution**. +**Leon** 是一款围绕**工具、上下文、记忆和智能体式执行（agentic execution）**构建的**开源个人 AI 助手**。 -Leon is designed to stay practical, privacy-aware, and grounded in your real environment. It can operate locally, use dedicated tools instead of relying on free-form guessing, and complete tasks from start to finish across deterministic workflows and agent-style execution. +Leon 的设计注重实用性、隐私保护，并扎根于你的真实环境。它可以在本地运行，使用专用工具而非依赖自由形式的猜测，并能在确定性工作流和智能体式执行中从头到尾完成任务。 -## 🧠 What Leon Is Today +## 🧠 Leon 如今的定位 -Leon is no longer just a classic intent-classification assistant like it was for its first release in 2019. +Leon 不再像 2019 年首次发布时那样，只是一个经典的意图分类助手。 -Today, Leon is being built as a more capable assistant that can understand a goal, choose how to handle it, use tools, remember useful information, and recover when something goes wrong. +如今，Leon 正被打造为能力更强的助手，能够理解目标、选择处理方式、使用工具、记住有用信息，并在出现问题时进行恢复。 -- Leon can run in different ways depending on the task: `smart` mode chooses for you, `controlled` mode follows deterministic native skills and actions, and `agent` mode can plan step by step. -- Leon supports native skills for controlled actions and agent skills for `SKILL.md`-backed workflows. -- Leon can use real tools to get work done instead of only replying with plain text. -- Leon can use context about your environment so answers stay grounded in what is actually happening on your machine and setup. -- Leon keeps layered memory so it can remember durable preferences, day-to-day context, and recent discussion context. -- Leon supports both local and remote AI providers, which helps balance privacy, control, and capability. -- Under the hood, Leon-native skills follow `Skills -> Actions -> Tools -> Functions (-> Binaries)`. +- Leon 可根据任务以不同方式运行：`smart` 模式会替你选择，`controlled` 模式遵循确定性的原生技能和操作，`agent` 模式可以逐步规划。 +- Leon 支持用于受控操作的原生技能，以及用于 `SKILL.md` 支持的工作流的智能体技能。 +- Leon 可以使用真实工具完成任务，而不仅限于纯文本回复。 +- Leon 可以利用你环境中的上下文，使回答始终立足于你机器和配置上的实际情况。 +- Leon 保持分层记忆，能够记住持久偏好、日常上下文以及近期讨论上下文。 +- Leon 同时支持本地和远程 AI 提供商，有助于在隐私、控制与能力之间取得平衡。 +- 在底层，Leon 原生技能遵循 `Skills -> Actions -> Tools -> Functions (-> Binaries)`。 -Leon also keeps a compact self-model and a bounded proactive pulse system so it can stay more consistent over time without flooding itself with unnecessary context. +Leon 还维护紧凑的自我模型和有边界的主动脉冲（proactive pulse）系统，使其能够长期保持一致，而不会用不必要的上下文淹没自身。 -## Why? +## 为什么？ -- **Privacy matters**: Leon can work with local models and local context instead of forcing everything through third-party services. -- **Grounded behavior matters**: Leon prefers explicit tools, context, and memory over vague model-only responses. -- **Extensibility matters**: skills, toolkits, bridges, and binaries make it possible to keep Leon modular. -- **Open source matters**: anyone can inspect the architecture, build on top of it, and help shape where it goes next. +- **隐私很重要**：Leon 可以使用本地模型和本地上下文，而无需将所有内容强制经由第三方服务。 +- **立足现实的行为很重要**：Leon 更倾向于使用明确的工具、上下文和记忆，而非模糊的纯模型回复。 +- **可扩展性很重要**：技能、工具包、桥接和二进制组件使 Leon 能够保持模块化。 +- **开源很重要**：任何人都可以审查架构、在其基础上构建，并帮助塑造其未来方向。 -## 🚀 Getting Started +## 🚀 快速开始 -### Prerequisites +### 前置条件 - [Node.js](https://nodejs.org/) >= 24.0.0 -- Supported OSes: Linux, macOS, and Windows +- 支持的操作系统：Linux、macOS 和 Windows -Recommended: manage Node.js with [Volta](https://volta.sh/). +推荐：使用 [Volta](https://volta.sh/). 管理 Node.js -### Installation +### 安装 ```sh # Clone the repository @@ -97,86 +103,86 @@ npm install --global pnpm@latest pnpm install ``` -### Run Leon +### 运行 Leon ```sh # Run Leon pnpm start ``` -### Check Your Setup +### 检查你的环境 ```sh # Check the setup went well pnpm run check ``` -By default, Leon runs locally and the app is available on `http://localhost:5366`. +默认情况下，Leon 在本地运行，应用可通过 `http://localhost:5366` 访问。 -## 🏗️ Architecture Snapshot +## 🏗️ 架构概览 -At a high level, Leon currently consists of: +从高层来看，Leon 目前由以下部分组成： -- `server/`: the main runtime, routing, memory, context management, HTTP API, and agent/controlled execution -- `app/`: the web application -- `aurora/`: UI components and preview environment -- `skills/`: built-in capabilities, split between `native/` skills and `agent/` skills -- `bridges/`: Node.js and Python bridges plus toolkit definitions and tool runtimes -- `tcp_server/`: Python services used by parts of the runtime stack -- `core/context/`: generated identity and architecture context documents that describe Leon's current behavior +- `server/`：主运行时、路由、记忆、上下文管理、HTTP API，以及智能体/受控执行 +- `app/`：Web 应用 +- `aurora/`：UI 组件和预览环境 +- `skills/`：内置能力，分为 `native/` 技能和 `agent/` 技能 +- `bridges/`：Node.js 和 Python 桥接，以及工具包定义和工具运行时 +- `tcp_server/`：运行时栈部分组件使用的 Python 服务 +- `core/context/`：描述 Leon 当前行为的生成式身份与架构上下文文档 -This repository already includes skills and toolkits for areas such as search, productivity, system utilities, media workflows, coding assistance, memory-backed interactions, and voice/audio features. +本仓库已包含搜索、生产力、系统工具、媒体工作流、编程辅助、记忆支持交互以及语音/音频功能等领域的技能和工具包。 -## 📚 Documentation Status +## 📚 文档状态 -The new docs for Leon 2.0 are not ready yet. +Leon 2.0 的新文档尚未就绪。 -For now: +目前： -- treat this repository as the source of truth for the **2.0 Developer Preview** -- use [`core/context/LEON.md`](./core/context/LEON.md) for Leon's current identity and behavior -- use [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md) for the current architecture overview -- expect the public docs site to lag behind the new core until the updated documentation is published +- 将此仓库视为 **2.0 Developer Preview** 的权威来源 +- 使用 [`core/context/LEON.md`](./core/context/LEON.md) 了解 Leon 当前的身份与行为 +- 使用 [`core/context/ARCHITECTURE.md`](./core/context/ARCHITECTURE.md) 了解当前架构概览 +- 在更新后的文档发布之前，公开文档站点预计会滞后于新核心 -## ❤️ Contributing +## ❤️ 参与贡献 -We are starting to progressively onboard contributors for the **2.0 Developer Preview**. +我们正在逐步为 **2.0 Developer Preview** 引入贡献者。 -If you want to follow the project or express interest in joining that onboarding: +如果你想关注该项目或表达加入该引导流程的意向： -- [2.0 Developer Preview contributor form](https://forms.gle/6PCG2D5rYo1q8tKMA) -- [Roadmap](http://roadmap.getleon.ai) +- [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) -### Why is there a small amount of contributors? +### 为什么贡献者数量较少？ -Leon has been evolving for a long time, but the current 2.0 work is a major transition period. +Leon 已经演进了很长时间，但当前的 2.0 工作正处于重大转型期。 -For a long time, Leon was a smaller assistant project with a simpler architecture. Today, the core is being rebuilt into a much more capable system around tools, memory, context, and agent-style execution. That means a lot of things are still moving, and it makes contribution harder than it will be once the new docs and architecture settle down. +长期以来，Leon 是一个架构更简单的小型助手项目。如今，核心正在围绕工具、记忆、上下文和智能体式执行重建为能力更强的系统。这意味着许多内容仍在变动，在全新文档和架构稳定下来之前，参与贡献会比之后更加困难。 -Another important reason is simply time: Leon is still developed largely during spare time. So progress can be uneven, and opening the project more broadly has to be balanced with keeping the direction coherent while the 2.0 Developer Preview is still taking shape. +另一个重要原因仅仅是时间：Leon 的开发仍主要在业余时间进行。因此进展可能不均衡，在 2.0 Developer Preview 仍在成形之际，更广泛地开放项目必须与保持方向连贯性之间取得平衡。 -## 📖 The Story Behind Leon +## 📖 Leon 背后的故事 -Leon started in 2017 and has been active since 2019. If you want the longer backstory, read [the story behind Leon](https://blog.getleon.ai/the-story-behind-leon/). +Leon 始于 2017 年，自 2019 年以来一直活跃。如果你想了解更完整的故事，请阅读 [Leon 背后的故事](https://blog.getleon.ai/the-story-behind-leon/). -## 🔔 Stay Tuned +## 🔔 保持关注 -- [X / Twitter](https://x.com/grenlouis) is the main place where I share Leon progress updates +- [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) -## 👨 Author +## 👨 作者 **Louis Grenard** ([@grenlouis](https://x.com/grenlouis)) -## 👍 Sponsors +## 👍 赞助商 -You can also contribute by [sponsoring Leon](http://sponsor.getleon.ai). +你也可以通过[赞助 Leon](http://sponsor.getleon.ai). 来参与贡献 -## Thanks +## 致谢 | ![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) | | --- | --- | --- |