diff --git a/README.md b/README.md index 095b0f4..2f78a5c 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,20 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/stablyai/orca) · [上游 README](https://github.com/stablyai/orca/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 +

Orca Orca

GitHub stars - Total downloads across all releases - License - Join the Orca Discord - Follow Orca on X - Supported platforms: macOS, Windows, and Linux + 所有版本累计下载量 + 许可证 + 加入 Orca Discord + 在 X 上关注 Orca + 支持的平台：macOS、Windows 和 Linux

@@ -16,129 +22,129 @@

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

-

Download Orca

+

下载 Orca

- Orca desktop app running agents in parallel worktrees, with the Orca mobile companion app in the corner + Orca 桌面应用在并行 worktree 中运行 Agent，角落显示 Orca 移动伴侣应用

-## Features +## 功能特性 @@ -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)
-### 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) - Orca desktop with the mobile companion app + Orca 桌面端与移动伴侣应用
-### 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) - Parallel worktree orchestration + 并行 worktree 编排
-### 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) - Terminal splits + 终端分屏
-### 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) - Embedded browser and Design Mode + 嵌入式浏览器与设计模式
-### GitHub & 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) - GitHub and Linear task workflows in Orca + Orca 中的 GitHub 与 Linear 任务工作流
-### 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) - Remote worktrees over SSH + 通过 SSH 的远程 worktree
-### 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) - Annotate AI-generated diffs + 标注 AI 生成的 diff
-### 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) - Drag files and images into an agent prompt + 将文件和图片拖入 Agent 提示词
- Script Orca from the CLI + 通过 CLI 编写 Orca 脚本
-**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 & 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 中运行。

Claude Code logo Claude Code   @@ -202,20 +208,20 @@ Works with **any CLI agent** — if it runs in a terminal, it runs in Orca. Mistral Vibe logo Mistral Vibe   Qwen Code logo Qwen Code   Rovo Dev logo Rovo Dev   - + any CLI agent + + 任意 CLI Agent

--- -## 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 & 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：** 扫描二维码加入社区。若第一个群已满，请使用备用群。 - WeChat QR code for the Orca community - Backup WeChat QR code for the Orca community + Orca 社区微信群二维码 + Orca 社区微信群备用二维码 -- **Feedback & Ideas:** We ship fast. Missing something? [Request a new feature](https://github.com/stablyai/orca/issues). -- **Privacy:** See the [privacy & 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) 指南。 Orca contributors

- GitHub star history chart for stablyai/orca + stablyai/orca 的 GitHub Star 历史图表

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