docs: make Chinese README the default

2026-07-13 10:14:11 +00:00
parent 968151ea1b
commit 709dfecfbc
1 changed files with 85 additions and 79 deletions
@@ -1,14 +1,20 @@
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/stablyai/orca) · [上游 README](https://github.com/stablyai/orca/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
 <h1 align="center">
  <a href="https://onOrca.dev"><img src="resources/build/icon.png" alt="Orca" width="64" valign="middle" /></a> Orca
 </h1>

 <p align="center">
  <a href="https://github.com/stablyai/orca/stargazers"><img src="https://badgen.net/github/stars/stablyai/orca?label=%E2%98%85" alt="GitHub stars" /></a>
-  <a href="https://github.com/stablyai/orca/releases"><img src="docs/assets/readme-downloads.svg" alt="Total downloads across all releases" /></a>
-  <img src="https://badgen.net/github/license/stablyai/orca" alt="License" />
-  <a href="https://discord.gg/fzjDKHxv8Q"><img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white" alt="Join the Orca Discord" /></a>
-  <a href="https://x.com/orca_build"><img src="https://img.shields.io/badge/X-000000?logo=x&logoColor=white" alt="Follow Orca on X" /></a>
-  <img src="https://img.shields.io/badge/macOS%20%7C%20Windows%20%7C%20Linux-4493F8?style=flat-square" alt="Supported platforms: macOS, Windows, and Linux" />
+  <a href="https://github.com/stablyai/orca/releases"><img src="docs/assets/readme-downloads.svg" alt="所有版本累计下载量" /></a>
+  <img src="https://badgen.net/github/license/stablyai/orca" alt="许可证" />
+  <a href="https://discord.gg/fzjDKHxv8Q"><img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white" alt="加入 Orca Discord" /></a>
+  <a href="https://x.com/orca_build"><img src="https://img.shields.io/badge/X-000000?logo=x&logoColor=white" alt="在 X 上关注 Orca" /></a>
+  <img src="https://img.shields.io/badge/macOS%20%7C%20Windows%20%7C%20Linux-4493F8?style=flat-square" alt="支持的平台：macOS、Windows 和 Linux" />
 </p>

 <p align="center">
@@ -16,129 +22,129 @@
 </p>

 <p align="center">
-  <strong>The AI Orchestrator for 100x builders.</strong><br/>
-  Run Codex, ClaudeCode, OpenCode or Pi side-by-side — each in its own worktree, tracked in one place.
+  <strong>面向 100x 构建者的 AI 编排器（Orchestrator）。</strong><br/>
+  并排运行 Codex、ClaudeCode、OpenCode 或 Pi —— 每个都在独立的 worktree 中，统一在一处追踪。
 </p>

-<h3 align="center"><a href="https://onorca.dev/download"><ins>Download Orca</ins></a></h3>
+<h3 align="center"><a href="https://onorca.dev/download"><ins>下载 Orca</ins></a></h3>

 <p align="center">
-  <img src="docs/assets/readme-hero.jpg" alt="Orca desktop app running agents in parallel worktrees, with the Orca mobile companion app in the corner" width="960" />
+  <img src="docs/assets/readme-hero.jpg" alt="Orca 桌面应用在并行 worktree 中运行 Agent，角落显示 Orca 移动伴侣应用" width="960" />
 </p>

-## Features
+## 功能特性

 <table>
 <tr>
 <td width="50%" valign="middle">

-### Mobile Companion
+### 移动伴侣应用

-Monitor and steer your agents from your phone — get notified when an agent finishes and send follow-ups from anywhere.
+在手机上监控并引导你的 Agent —— Agent 完成时收到通知，随时随地发送后续指令。

-[iOS App Store](https://apps.apple.com/us/app/orca-ide/id6766130217) · [TestFlight](https://testflight.apple.com/join/YjeGMQBA) · [Android APK 0.0.27](https://github.com/stablyai/orca/releases/download/mobile-android-v0.0.27/app-release.apk) · [Docs →](https://www.onorca.dev/docs/mobile)
+[iOS App Store](https://apps.apple.com/us/app/orca-ide/id6766130217) · [TestFlight](https://testflight.apple.com/join/YjeGMQBA) · [Android APK 0.0.27](https://github.com/stablyai/orca/releases/download/mobile-android-v0.0.27/app-release.apk) · [文档 →](https://www.onorca.dev/docs/mobile)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/mobile"><picture><source srcset="docs/assets/feature-wall/mobile-companion-app-showcase.gif" type="image/gif"><img src="docs/assets/feature-wall/mobile-companion-app-showcase.jpg" alt="Orca desktop with the mobile companion app" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/mobile"><picture><source srcset="docs/assets/feature-wall/mobile-companion-app-showcase.gif" type="image/gif"><img src="docs/assets/feature-wall/mobile-companion-app-showcase.jpg" alt="Orca 桌面端与移动伴侣应用" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### Parallel Worktrees
+### 并行 Worktree

-Fan one prompt across five agents, each in its own isolated git worktree — compare the results and merge the winner.
+将一个提示分发给五个 Agent，每个在各自隔离的 git worktree 中运行 —— 对比结果并合并最优方案。

-[Docs →](https://www.onorca.dev/docs/model/worktrees)
+[文档 →](https://www.onorca.dev/docs/model/worktrees)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/model/worktrees"><picture><source srcset="docs/assets/feature-wall/parallel-worktrees.gif" type="image/gif"><img src="docs/assets/feature-wall/parallel-worktrees.jpg" alt="Parallel worktree orchestration" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/model/worktrees"><picture><source srcset="docs/assets/feature-wall/parallel-worktrees.gif" type="image/gif"><img src="docs/assets/feature-wall/parallel-worktrees.jpg" alt="并行 worktree 编排" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### Terminal Splits
+### 终端分屏

-Ghostty-class terminals with WebGL rendering, infinite splits, and scrollback that survives restarts.
+Ghostty 级终端，支持 WebGL 渲染、无限分屏，以及重启后仍保留的滚动历史。

-[Docs →](https://www.onorca.dev/docs/terminal)
+[文档 →](https://www.onorca.dev/docs/terminal)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/terminal"><picture><source srcset="docs/assets/feature-wall/terminal-splits.gif" type="image/gif"><img src="docs/assets/feature-wall/terminal-splits.jpg" alt="Terminal splits" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/terminal"><picture><source srcset="docs/assets/feature-wall/terminal-splits.gif" type="image/gif"><img src="docs/assets/feature-wall/terminal-splits.jpg" alt="终端分屏" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### Design Mode
+### 设计模式

-Click any UI element in a real Chromium window to send its HTML, CSS, and a cropped screenshot straight into your agent's prompt.
+在真实的 Chromium 窗口中点击任意 UI 元素，将其 HTML、CSS 和裁剪截图直接发送到 Agent 的提示词中。

-[Docs →](https://www.onorca.dev/docs/browser/design-mode)
+[文档 →](https://www.onorca.dev/docs/browser/design-mode)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/browser/design-mode"><picture><source srcset="docs/assets/feature-wall/design-mode.gif" type="image/gif"><img src="docs/assets/feature-wall/design-mode.jpg" alt="Embedded browser and Design Mode" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/browser/design-mode"><picture><source srcset="docs/assets/feature-wall/design-mode.gif" type="image/gif"><img src="docs/assets/feature-wall/design-mode.jpg" alt="嵌入式浏览器与设计模式" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### GitHub &amp; Linear, Native
+### GitHub 与 Linear 原生集成

-Browse PRs, issues, and project boards in-app — open a worktree from any task and review without a context switch.
+在应用内浏览 PR、Issue 和项目看板 —— 从任意任务打开 worktree，无需切换上下文即可审查。

-[Docs →](https://www.onorca.dev/docs/review/linear)
+[文档 →](https://www.onorca.dev/docs/review/linear)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/review/linear"><picture><source srcset="docs/assets/feature-wall/github-linear.gif" type="image/gif"><img src="docs/assets/feature-wall/github-linear.jpg" alt="GitHub and Linear task workflows in Orca" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/review/linear"><picture><source srcset="docs/assets/feature-wall/github-linear.gif" type="image/gif"><img src="docs/assets/feature-wall/github-linear.jpg" alt="Orca 中的 GitHub 与 Linear 任务工作流" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### SSH Worktrees
+### SSH Worktree

-Run agents on a beefy remote box with full file editing, git, and terminals — auto-reconnect and port forwarding included.
+在高性能远程机器上运行 Agent，支持完整的文件编辑、git 和终端 —— 内置自动重连与端口转发。

-[Docs →](https://www.onorca.dev/docs/ssh)
+[文档 →](https://www.onorca.dev/docs/ssh)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/ssh"><picture><source srcset="docs/assets/feature-wall/ssh-worktrees.gif" type="image/gif"><img src="docs/assets/feature-wall/ssh-worktrees.jpg" alt="Remote worktrees over SSH" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/ssh"><picture><source srcset="docs/assets/feature-wall/ssh-worktrees.gif" type="image/gif"><img src="docs/assets/feature-wall/ssh-worktrees.jpg" alt="通过 SSH 的远程 worktree" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### Annotate AI Diffs
+### 标注 AI Diff

-Drop comments on any diff line and ship them back to the agent — review, edit, and commit without leaving Orca.
+在任意 diff 行上添加评论并回传给 Agent —— 在 Orca 内完成审查、编辑和提交，无需离开应用。

-[Docs →](https://www.onorca.dev/docs/review/annotate-ai-diff)
+[文档 →](https://www.onorca.dev/docs/review/annotate-ai-diff)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/review/annotate-ai-diff"><picture><source srcset="docs/assets/feature-wall/annotate-diff.gif" type="image/gif"><img src="docs/assets/feature-wall/annotate-diff.jpg" alt="Annotate AI-generated diffs" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/review/annotate-ai-diff"><picture><source srcset="docs/assets/feature-wall/annotate-diff.gif" type="image/gif"><img src="docs/assets/feature-wall/annotate-diff.jpg" alt="标注 AI 生成的 diff" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
 <td width="50%" valign="middle">

-### Drag Files to Agents
+### 拖拽文件到 Agent

-VS Code's editor with autosave everywhere — drag files or images straight into an agent prompt.
+随处自动保存的 VS Code 编辑器 —— 将文件或图片直接拖入 Agent 提示词。

-[Docs →](https://www.onorca.dev/docs/editing/file-explorer)
+[文档 →](https://www.onorca.dev/docs/editing/file-explorer)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/editing/file-explorer"><picture><source srcset="docs/assets/feature-wall/file-drag.gif" type="image/gif"><img src="docs/assets/feature-wall/file-drag.jpg" alt="Drag files and images into an agent prompt" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/editing/file-explorer"><picture><source srcset="docs/assets/feature-wall/file-drag.gif" type="image/gif"><img src="docs/assets/feature-wall/file-drag.jpg" alt="将文件和图片拖入 Agent 提示词" width="100%" /></picture></a>
 </td>
 </tr>
 <tr>
@@ -146,31 +152,31 @@ VS Code's editor with autosave everywhere — drag files or images straight into

 ### Orca CLI

-Agents drive Orca too — script every workflow with `orca worktree create`, `snapshot`, `click`, and `fill`.
+Agent 也能驱动 Orca —— 使用 `orca worktree create`、`snapshot`、`click` 和 `fill` 编写脚本，自动化每个工作流。

-[Docs →](https://www.onorca.dev/docs/cli/overview)
+[文档 →](https://www.onorca.dev/docs/cli/overview)

 </td>
 <td width="50%">
-  <a href="https://www.onorca.dev/docs/cli/overview"><picture><source srcset="docs/assets/feature-wall/orca-cli.gif" type="image/gif"><img src="docs/assets/feature-wall/orca-cli.jpg" alt="Script Orca from the CLI" width="100%" /></picture></a>
+  <a href="https://www.onorca.dev/docs/cli/overview"><picture><source srcset="docs/assets/feature-wall/orca-cli.gif" type="image/gif"><img src="docs/assets/feature-wall/orca-cli.jpg" alt="通过 CLI 编写 Orca 脚本" width="100%" /></picture></a>
 </td>
 </tr>
 </table>

-**Also in the box:**
+**此外还包括：**

- **[Quick open](https://www.onorca.dev/docs/model/quick-open)** — Search across worktrees, files, agents, commands, and repo context without leaving your flow.
- **[Account switcher &amp; usage tracking](https://www.onorca.dev/docs/agents/usage-tracking)** — See Claude and Codex usage and rate-limit resets, and hot-swap accounts without re-logging in.
- **[Rich repo previews](https://www.onorca.dev/docs/editing/markdown)** — Preview Markdown, images, PDFs, and repo docs in the workspace.
- **[Computer Use](https://www.onorca.dev/docs/cli/computer-use)** — Let agents operate desktop apps and visible UI when a workflow needs real interaction.
- **[Notifications and unread state](https://www.onorca.dev/docs/notifications)** — Know when an agent finishes or needs attention, then mark threads unread to come back later.
- **And many, many more** — we ship daily, so this list is perpetually behind. The [changelog](https://github.com/stablyai/orca/releases) is the real feature list.
+- **[快速打开](https://www.onorca.dev/docs/model/quick-open)** — 在工作流中搜索 worktree、文件、Agent、命令和仓库上下文，无需打断节奏。
+- **[账号切换与用量追踪](https://www.onorca.dev/docs/agents/usage-tracking)** — 查看 Claude 和 Codex 用量及速率限制重置时间，热切换账号无需重新登录。
+- **[丰富的仓库预览](https://www.onorca.dev/docs/editing/markdown)** — 在工作区预览 Markdown、图片、PDF 和仓库文档。
+- **[Computer Use](https://www.onorca.dev/docs/cli/computer-use)** — 当工作流需要真实交互时，让 Agent 操作桌面应用和可见 UI。
+- **[通知与未读状态](https://www.onorca.dev/docs/notifications)** — Agent 完成或需要关注时及时获知，并将线程标为未读以便稍后回来处理。
+- **还有更多、更多功能** — 我们每天都在发布更新，因此这份列表永远滞后。[更新日志](https://github.com/stablyai/orca/releases) 才是真正的功能清单。

 ---

-## Supported Agents
+## 支持的 Agent

-Works with **any CLI agent** — if it runs in a terminal, it runs in Orca.
+支持**任意 CLI Agent** —— 只要能在终端中运行，就能在 Orca 中运行。

 <p>
  <a href="https://docs.anthropic.com/claude/docs/claude-code"><kbd><img src="docs/assets/claude-logo.svg" alt="Claude Code logo" width="16" valign="middle" /> Claude Code</kbd></a> &nbsp;
@@ -202,20 +208,20 @@ Works with **any CLI agent** — if it runs in a terminal, it runs in Orca.
  <a href="https://github.com/mistralai/mistral-vibe"><kbd><img src="https://www.google.com/s2/favicons?domain=mistral.ai&sz=64" alt="Mistral Vibe logo" width="16" valign="middle" /> Mistral Vibe</kbd></a> &nbsp;
  <a href="https://github.com/QwenLM/qwen-code"><kbd><img src="https://www.google.com/s2/favicons?domain=qwenlm.github.io&sz=64" alt="Qwen Code logo" width="16" valign="middle" /> Qwen Code</kbd></a> &nbsp;
  <a href="https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/"><kbd><img src="https://www.google.com/s2/favicons?domain=atlassian.com&sz=64" alt="Rovo Dev logo" width="16" valign="middle" /> Rovo Dev</kbd></a> &nbsp;
-  <kbd>+ any CLI agent</kbd>
+  <kbd>+ 任意 CLI Agent</kbd>
 </p>

 ---

-## Install
+## 安装

-### Desktop — macOS, Windows, Linux
+### 桌面版 — macOS、Windows、Linux

- **[Download from onOrca.dev](https://onorca.dev/download)**
- Or grab a build directly: [macOS Apple Silicon](https://github.com/stablyai/orca/releases/latest/download/orca-macos-arm64.dmg) · [macOS Intel](https://github.com/stablyai/orca/releases/latest/download/orca-macos-x64.dmg) · [Windows (.exe)](https://github.com/stablyai/orca/releases/latest/download/orca-windows-setup.exe) · [Linux AppImage](https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage) · [All builds](https://github.com/stablyai/orca/releases/latest)
- Running `orca serve` on a headless Linux server? See the [headless Linux server guide](docs/reference/headless-linux-server.md).
+- **[从 onOrca.dev 下载](https://onorca.dev/download)**
+- 或直接获取构建版本：[macOS Apple Silicon](https://github.com/stablyai/orca/releases/latest/download/orca-macos-arm64.dmg) · [macOS Intel](https://github.com/stablyai/orca/releases/latest/download/orca-macos-x64.dmg) · [Windows (.exe)](https://github.com/stablyai/orca/releases/latest/download/orca-windows-setup.exe) · [Linux AppImage](https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage) · [全部构建](https://github.com/stablyai/orca/releases/latest)
+- 在无图形界面的 Linux 服务器上运行 `orca serve`？请参阅[无图形界面 Linux 服务器指南](docs/reference/headless-linux-server.md)。

-_Or via a package manager:_
+_或通过包管理器：_

 ```bash
 # macOS (Homebrew)
@@ -225,42 +231,42 @@ brew install --cask stablyai/orca/orca
 yay -S stably-orca-bin
 ```

-### Mobile Companion — iOS, Android
+### 移动伴侣应用 — iOS、Android

-Pair with your desktop app to monitor and steer your agents from your phone.
+与桌面应用配对，在手机上监控并操控你的 agents。

- **iOS:** [Download on the App Store](https://apps.apple.com/us/app/orca-ide/id6766130217) or [join TestFlight](https://testflight.apple.com/join/YjeGMQBA)
- **Android:** [Download APK 0.0.27](https://github.com/stablyai/orca/releases/download/mobile-android-v0.0.27/app-release.apk)
+- **iOS：** [在 App Store 下载](https://apps.apple.com/us/app/orca-ide/id6766130217) 或 [加入 TestFlight](https://testflight.apple.com/join/YjeGMQBA)
+- **Android：** [下载 APK 0.0.27](https://github.com/stablyai/orca/releases/download/mobile-android-v0.0.27/app-release.apk)

 ---

-## Community &amp; Support
+## 社区与支持

- **Discord:** Join the community on **[Discord](https://discord.gg/fzjDKHxv8Q)**.
- **Twitter / X:** Follow **[@orca_build](https://x.com/orca_build)** for updates and announcements.
- **WeChat:** Scan the QR code to join the community. If the first group is full, use the backup group.
+- **Discord：** 在 **[Discord](https://discord.gg/fzjDKHxv8Q)**. 加入社区
+- **Twitter / X：** 关注 **[@orca_build](https://x.com/orca_build)** 获取更新与公告。
+- **WeChat：** 扫描二维码加入社区。若第一个群已满，请使用备用群。

-  <img src="docs/assets/wechat-qr.png" alt="WeChat QR code for the Orca community" width="160" />
-  <img src="docs/assets/wechat-qr-backup.jpg" alt="Backup WeChat QR code for the Orca community" width="160" />
+  <img src="docs/assets/wechat-qr.png" alt="Orca 社区微信群二维码" width="160" />
+  <img src="docs/assets/wechat-qr-backup.jpg" alt="Orca 社区微信群备用二维码" width="160" />

- **Feedback &amp; Ideas:** We ship fast. Missing something? [Request a new feature](https://github.com/stablyai/orca/issues).
- **Privacy:** See the [privacy &amp; telemetry docs](https://www.onorca.dev/docs/telemetry) for what anonymous usage data Orca collects and how to opt out.
- **Show Support:** [Star](https://github.com/stablyai/orca) this repo to follow along with our daily ships.
+- **反馈与建议：** 我们迭代很快。缺少什么功能？[提交新功能请求](https://github.com/stablyai/orca/issues).
+- **隐私：** 查看[隐私与遥测文档](https://www.onorca.dev/docs/telemetry)，了解 Orca 收集哪些匿名使用数据以及如何退出。
+- **支持我们：** [Star](https://github.com/stablyai/orca) 本仓库，关注我们的每日发布。

 ---

-## Developing
+## 开发

-Want to contribute or run locally? See our [CONTRIBUTING.md](.github/CONTRIBUTING.md) guide.
+想要贡献代码或在本地运行？请参阅我们的 [CONTRIBUTING.md](.github/CONTRIBUTING.md) 指南。

 <a href="https://github.com/stablyai/orca/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=stablyai/orca" alt="Orca contributors" />
 </a>

 <p align="center">
-  <img src="docs/assets/star-history.png" alt="GitHub star history chart for stablyai/orca" width="880" />
+  <img src="docs/assets/star-history.png" alt="stablyai/orca 的 GitHub Star 历史图表" width="880" />
 </p>

-## License
+## 许可证

-Orca is free and open source under the [MIT License](LICENSE).
+Orca 在 [MIT License](LICENSE) 下免费开放源代码。