docs: make Chinese README the default

2026-07-13 10:36:32 +00:00
parent 1d531f7a50
commit 592f8f5ac7
1 changed files with 67 additions and 61 deletions
@@ -1,81 +1,87 @@
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/RasaHQ/rasa) · [上游 README](https://github.com/RasaHQ/rasa/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
 <h1 align="center">Rasa Open Source</h1>

 <div align="center">

-[![Join the Agent Engineering Community](https://img.shields.io/badge/Community-Join%20the%20Discussion-blueviolet)](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=)
-[![Try Hello Rasa](https://img.shields.io/badge/Playground-Try%20Hello%20Rasa-ff69b4)](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=)
-[![PyPI version](https://badge.fury.io/py/rasa.svg)](https://badge.fury.io/py/rasa)
-[![Supported Python Versions](https://img.shields.io/pypi/pyversions/rasa.svg)](https://pypi.python.org/pypi/rasa)
-[![Build Status](https://github.com/RasaHQ/rasa/workflows/Continuous%20Integration/badge.svg)](https://github.com/RasaHQ/rasa/actions)
-[![Documentation Status](https://img.shields.io/badge/docs-stable-brightgreen.svg)](https://rasa.com/docs)
+[![加入 Agent Engineering 社区](https://img.shields.io/badge/Community-Join%20the%20Discussion-blueviolet)](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=)
+[![试用 Hello Rasa](https://img.shields.io/badge/Playground-Try%20Hello%20Rasa-ff69b4)](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=)
+[![PyPI 版本](https://badge.fury.io/py/rasa.svg)](https://badge.fury.io/py/rasa)
+[![支持的 Python 版本](https://img.shields.io/pypi/pyversions/rasa.svg)](https://pypi.python.org/pypi/rasa)
+[![构建状态](https://github.com/RasaHQ/rasa/workflows/Continuous%20Integration/badge.svg)](https://github.com/RasaHQ/rasa/actions)
+[![文档状态](https://img.shields.io/badge/docs-stable-brightgreen.svg)](https://rasa.com/docs)

 </div>

 <br />

 <div align="center">
-  <h3>🚧 <b>Note: Maintenance Mode</b> 🚧</h3>
+  <h3>🚧 <b>注意：维护模式</b> 🚧</h3>
  <p>
-    Rasa Open Source is currently in maintenance mode. 
+    Rasa Open Source 目前处于维护模式。
    <br />
-    The future of building AI agents with Rasa is <b>Hello Rasa</b> and <b>CALM</b>.
+    使用 Rasa 构建 AI agent 的未来方向是 <b>Hello Rasa</b> 与 <b>CALM</b>。
  </p>
 </div>

 <hr />

-## 🚀 The Future of Rasa: Hello Rasa
+## 🚀 Rasa 的未来：Hello Rasa

-**Building reliable AI agents just got easier.**
+**构建可靠的 AI agent 变得更容易了。**

-[**Hello Rasa**](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=) is our new interactive playground for prototyping AI agents. It combines LLM fluency with the reliability of business logic using our **CALM** (Conversational AI with Language Models) engine.
+[**Hello Rasa**](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=) 是我们全新的交互式 playground，用于原型化 AI agent。它将 LLM 的流畅表达能力与我们 **CALM**（Conversational AI with Language Models，基于语言模型的对话式 AI）引擎的可靠性相结合。

-### Why switch to Hello Rasa?
+### 为什么切换到 Hello Rasa？

-* **No setup required:** Open the playground, pick a template (Banking, Telecom, Support), and start building in your browser.
-* **No NLU training:** We have moved beyond intents. The LLM handles dialogue understanding while you define the business flows.
-* **Built-in copilot:** A specialized AI assistant helps you generate code, debug flows, and expand your agent instantly.
-* **Production ready:** Hello Rasa is not just a toy. Export your agent to the Rasa Platform when you are ready to scale.
+* **无需设置：** 打开 playground，选择一个模板（Banking、Telecom、Support），即可在浏览器中开始构建。
+* **无需 NLU 训练：** 我们已超越 intents。LLM 负责理解对话，而你定义业务流。
+* **内置 copilot：** 专用 AI 助手可帮助你生成代码、调试流程，并即时扩展 agent。
+* **可用于生产：** Hello Rasa 不只是玩具。准备扩展时，可将 agent 导出到 Rasa Platform。

-### Core concepts
+### 核心概念

-* **CALM:** Combines LLM flexibility with strict business logic. The LLM understands the user; the code enforces the rules.
-* **Flows:** Describe logical steps (e.g., collect money, transfer funds) rather than rigid dialogue trees.
-* **Inspector:** See real-time decision-making. No black boxes.
+* **CALM：** 将 LLM 的灵活性与其严格的业务逻辑相结合。LLM 理解用户；代码强制执行规则。
+* **Flows（流程）：** 描述逻辑步骤（例如收款、转账），而非僵化的对话树。
+* **Inspector（检查器）：** 查看实时决策过程。没有黑箱。

-👉 **[Start building for free at Hello Rasa](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=)**
+👉 **[在 Hello Rasa 免费开始构建](https://hello.rasa.ai/?utm_source=github&utm_medium=website&utm_campaign=)**

 ---

-## 🧠 Join the Agent Engineering Community
+## 🧠 加入 Agent Engineering 社区

-We are building a home for people shipping real-world AI agents. 
+我们正在为交付真实世界 AI agent 的人们打造一个家园。

-Agent Engineering is evolving faster than any single framework. This is a vendor-neutral space to discuss architectures, memory, orchestration, and safety with builders across the industry.
+Agent Engineering 的演进速度超过任何单一框架。这是一个厂商中立的场所，可与行业内的构建者一起讨论架构、记忆、编排与安全。

-### What you get:
-* **Network:** Meet engineers building production agents
-* **Learn:** Discuss practical patterns, not just theory
-* **Access:** Direct influence on the Hello Rasa roadmap and early access to features
+### 你能获得什么：
+* **人脉：** 结识正在构建生产级 agent 的工程师
+* **学习：** 讨论实用模式，而不仅是理论
+* **权限：** 直接影响 Hello Rasa 路线图，并抢先体验新功能

-| Channel | Purpose |
+| 频道 | 用途 |
 | :--- | :--- |
-| **#agent-design** | Architectures, reasoning, memory, testing |
-| **#showcase** | Show your builds, demos, and repos |
-| **#ask-anything** | Debugging and workflow questions |
+| **#agent-design** | 架构、推理、记忆、测试 |
+| **#showcase** | 展示你的构建成果、演示与仓库 |
+| **#ask-anything** | 调试与工作流问题 |

-👉 **[Join the Community](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=)**
+👉 **[加入社区](https://info.rasa.com/community?utm_source=github&utm_medium=website&utm_campaign=)**

 ---

 <br>
 <br>

-# Rasa Open Source (Legacy)
+# Rasa Open Source（旧版）

-> **Note:** The documentation and installation instructions below apply to the classic Rasa Open Source framework. For the latest CALM-based experience, see the [Hello Rasa](#-the-future-of-rasa-hello-rasa) section above.
+> **注意：** 以下文档与安装说明适用于经典 Rasa Open Source 框架。如需最新的基于 CALM 的体验，请参阅上方的 [Hello Rasa](#-the-future-of-rasa-hello-rasa) 章节。

-Rasa is an open source machine learning framework for automating text and voice-based conversations. With Rasa, you can build contextual assistants on:
+Rasa 是一个用于自动化文本与语音对话的开源机器学习框架。借助 Rasa，你可以在以下渠道上构建上下文助手：

 - Facebook Messenger
 - Slack
@@ -86,32 +92,32 @@ Rasa is an open source machine learning framework for automating text and voice-
 - Mattermost
 - Telegram
 - Twilio
- Your own custom conversational channels
+- 你自己的自定义对话渠道

-Rasa helps you build contextual assistants that can handle layered conversations with lots of back-and-forth. 
+Rasa 帮助你构建能够处理大量来回交互、具备多层上下文的助手。

-### 📚 Resources
- 🤓 [Read the docs](https://rasa.com/docs/rasa/)
- 😁 [Install Rasa](https://rasa.com/docs/rasa/installation/environment-set-up)
- 🚀 [Learn all about Conversational AI](https://learning.rasa.com/)
- 🏢 [Explore the enterprise platform](https://rasa.com/product/rasa-platform/)
+### 📚 资源
+- 🤓 [阅读文档](https://rasa.com/docs/rasa/)
+- 😁 [安装 Rasa](https://rasa.com/docs/rasa/installation/environment-set-up)
+- 🚀 [全面了解 Conversational AI](https://learning.rasa.com/)
+- 🏢 [探索企业平台](https://rasa.com/product/rasa-platform/)

-## Development Internals & Contributing
+## 开发内部机制与贡献

-We are happy to receive contributions. Please review our [Contribution Guidelines](CONTRIBUTING.md) before getting started.
+我们欢迎贡献。开始前请先阅读我们的 [贡献指南](CONTRIBUTING.md)。

-### Installation for Development
-Rasa uses **Poetry** for packaging and dependency management.
+### 开发环境安装
+Rasa 使用 **Poetry** 进行打包与依赖管理。

-1.  **Install Poetry**: Follow the [official guide](https://python-poetry.org/docs/#installation).
-2.  **Build from source**:
+1.  **安装 Poetry**：请遵循[官方指南](https://python-poetry.org/docs/#installation).
+2.  **从源码构建**：
    ```bash
    make install
    ```
-    *Note for macOS users*: If you run into compiler issues, try `export SYSTEM_VERSION_COMPAT=1` before installation.
+    *macOS 用户注意*：若遇到编译器问题，请在安装前尝试 `export SYSTEM_VERSION_COMPAT=1`。

-### Running Tests
-Make sure you have development requirements installed:
+### 运行测试
+请确保已安装开发依赖：

 ```bash
 make prepare-tests-ubuntu # Ubuntu/Debian
@@ -119,16 +125,16 @@ make prepare-tests-macos  # macOS
 make test                 # Run tests
 ```

-### Releases
+### 发布版本

-Rasa follows Semantic Versioning.
+Rasa 遵循语义化版本（Semantic Versioning）。

-  * **Major**: Incompatible API changes
-  * **Minor**: Backward-compatible functionality
-  * **Patch**: Backward-compatible bug fixes
+  * **Major（主版本）**：不兼容的 API 变更
+  * **Minor（次版本）**：向后兼容的功能新增
+  * **Patch（补丁版本）**：向后兼容的缺陷修复

-For full details on our release cadence and maintenance policy, visit our [Product Release and Maintenance Policy](https://rasa.com/rasa-product-release-and-maintenance-policy/).
+有关发布节奏与维护政策的完整详情，请访问我们的 [产品发布与维护政策](https://rasa.com/rasa-product-release-and-maintenance-policy/).

-## License
+## 许可证

-Licensed under the Apache License, Version 2.0. Copyright 2022 Rasa Technologies GmbH. [Copy of the license](https://www.google.com/search?q=LICENSE.txt).
+根据 Apache License, Version 2.0 授权。Copyright 2022 Rasa Technologies GmbH。[许可证副本](https://www.google.com/search?q=LICENSE.txt).