diff --git a/README.md b/README.md
index f6f0522..5913871 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,14 @@
+
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
+> [English](./README.en.md) · [原始项目](https://github.com/aaif-goose/goose) · [上游 README](https://github.com/aaif-goose/goose/blob/HEAD/README.md)
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
# goose
-_your native open source AI agent — desktop app, CLI, and API — for code, workflows, and everything in between_
+_你的原生开源 AI 智能体 — 桌面应用、CLI 和 API — 适用于代码、工作流及其间的一切_
-goose is a general-purpose AI agent that runs on your machine. Not just for code — use it for research, writing, automation, data analysis, or anything you need to get done.
+goose 是一款运行在你本机上的通用 AI 智能体。不仅适用于代码 — 还可用于研究、写作、自动化、数据分析,或任何你需要完成的工作。
-A native desktop app for macOS, Linux, and Windows. A full CLI for terminal workflows. An API to embed it anywhere. Built in Rust for performance and portability.
+面向 macOS、Linux 和 Windows 的原生桌面应用。面向终端工作流的完整 CLI。可随处嵌入的 API。使用 Rust 构建,兼具性能与可移植性。
-goose works with 15+ providers — Anthropic, OpenAI, Google, Ollama, OpenRouter, Azure, Bedrock, and more. Use API keys or your existing Claude, ChatGPT, or Gemini subscriptions via [ACP](https://goose-docs.ai/docs/guides/acp-providers). Connect to 70+ extensions via the [Model Context Protocol](https://modelcontextprotocol.io/) open standard.
+goose 支持 15+ 家提供商 — Anthropic、OpenAI、Google、Ollama、OpenRouter、Azure、Bedrock 等。可通过 [ACP](https://goose-docs.ai/docs/guides/acp-providers). 使用 API 密钥,或通过现有 Claude、ChatGPT 或 Gemini 订阅。通过 [Model Context Protocol(模型上下文协议)](https://modelcontextprotocol.io/) 开放标准连接 70+ 个扩展。
-goose is part of the [Agentic AI Foundation (AAIF)](https://aaif.io/) at the Linux Foundation.
+goose 是 Linux Foundation 旗下 [Agentic AI Foundation (AAIF)](https://aaif.io/) 的一部分。
-# Get started
+# 快速开始
-**[Download the desktop app](https://goose-docs.ai/docs/getting-started/installation)** for macOS, Linux, and Windows.
+**[下载桌面应用](https://goose-docs.ai/docs/getting-started/installation)****,适用于 macOS、Linux 和 Windows。
-Or install the CLI:
+或安装 CLI:
```bash
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
```
-# Quick links
-- [Quickstart](https://goose-docs.ai/docs/quickstart)
-- [Installation](https://goose-docs.ai/docs/getting-started/installation)
-- [Tutorials](https://goose-docs.ai/docs/category/tutorials)
-- [Documentation](https://goose-docs.ai/docs/category/getting-started)
-- [Governance](https://github.com/aaif-goose/goose/blob/main/GOVERNANCE.md)
-- [Custom Distributions](https://github.com/aaif-goose/goose/blob/main/CUSTOM_DISTROS.md) — build your own goose distro with preconfigured providers, extensions, and branding
+# 快速链接
+- [快速入门](https://goose-docs.ai/docs/quickstart)
+- [安装](https://goose-docs.ai/docs/getting-started/installation)
+- [教程](https://goose-docs.ai/docs/category/tutorials)
+- [文档](https://goose-docs.ai/docs/category/getting-started)
+- [治理](https://github.com/aaif-goose/goose/blob/main/GOVERNANCE.md)
+- [自定义发行版](https://github.com/aaif-goose/goose/blob/main/CUSTOM_DISTROS.md) — 构建你自己的 goose 发行版,预配置提供商、扩展和品牌
-## Need help?
-- [Diagnostics & Reporting](https://goose-docs.ai/docs/troubleshooting/diagnostics-and-reporting)
-- [Known Issues](https://goose-docs.ai/docs/troubleshooting/known-issues)
+## 需要帮助?
+- [诊断与报告](https://goose-docs.ai/docs/troubleshooting/diagnostics-and-reporting)
+- [已知问题](https://goose-docs.ai/docs/troubleshooting/known-issues)
-# a little goose humor 🪿
+# 一点 goose 幽默 🪿
-> Why did the developer choose goose as their AI agent?
+> 开发者为什么选择 goose 作为他们的 AI 智能体?
>
-> Because it always helps them "migrate" their code to production! 🚀
+> 因为它总能帮助他们把代码「迁移」到生产环境!🚀
-# goose around with us
+# 与我们一起 goose around
- [Discord](https://discord.gg/goose-oss)
- [YouTube](https://www.youtube.com/@goose-oss)
- [LinkedIn](https://www.linkedin.com/company/goose-oss)