273 lines
17 KiB
Markdown
273 lines
17 KiB
Markdown
<!-- 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="所有版本累计下载量" /></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">
|
||
<sub><a href="docs/readme/README.es.md">Español</a> · <a href="docs/readme/README.pt.md">Português</a> · <a href="docs/readme/README.zh-CN.md">中文</a> · <a href="docs/readme/README.ja.md">日本語</a> · <a href="docs/readme/README.ko.md">한국어</a></sub>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<strong>面向 100x 构建者的 AI 编排器(Orchestrator)。</strong><br/>
|
||
并排运行 Codex、ClaudeCode、OpenCode 或 Pi —— 每个都在独立的 worktree 中,统一在一处追踪。
|
||
</p>
|
||
|
||
<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 桌面应用在并行 worktree 中运行 Agent,角落显示 Orca 移动伴侣应用" width="960" />
|
||
</p>
|
||
|
||
## 功能特性
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### 移动伴侣应用
|
||
|
||
在手机上监控并引导你的 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) · [文档 →](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 桌面端与移动伴侣应用" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### 并行 Worktree
|
||
|
||
将一个提示分发给五个 Agent,每个在各自隔离的 git worktree 中运行 —— 对比结果并合并最优方案。
|
||
|
||
[文档 →](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="并行 worktree 编排" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### 终端分屏
|
||
|
||
Ghostty 级终端,支持 WebGL 渲染、无限分屏,以及重启后仍保留的滚动历史。
|
||
|
||
[文档 →](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="终端分屏" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### 设计模式
|
||
|
||
在真实的 Chromium 窗口中点击任意 UI 元素,将其 HTML、CSS 和裁剪截图直接发送到 Agent 的提示词中。
|
||
|
||
[文档 →](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="嵌入式浏览器与设计模式" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### GitHub 与 Linear 原生集成
|
||
|
||
在应用内浏览 PR、Issue 和项目看板 —— 从任意任务打开 worktree,无需切换上下文即可审查。
|
||
|
||
[文档 →](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="Orca 中的 GitHub 与 Linear 任务工作流" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### SSH Worktree
|
||
|
||
在高性能远程机器上运行 Agent,支持完整的文件编辑、git 和终端 —— 内置自动重连与端口转发。
|
||
|
||
[文档 →](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="通过 SSH 的远程 worktree" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### 标注 AI Diff
|
||
|
||
在任意 diff 行上添加评论并回传给 Agent —— 在 Orca 内完成审查、编辑和提交,无需离开应用。
|
||
|
||
[文档 →](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="标注 AI 生成的 diff" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### 拖拽文件到 Agent
|
||
|
||
随处自动保存的 VS Code 编辑器 —— 将文件或图片直接拖入 Agent 提示词。
|
||
|
||
[文档 →](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="将文件和图片拖入 Agent 提示词" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%" valign="middle">
|
||
|
||
### Orca CLI
|
||
|
||
Agent 也能驱动 Orca —— 使用 `orca worktree create`、`snapshot`、`click` 和 `fill` 编写脚本,自动化每个工作流。
|
||
|
||
[文档 →](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="通过 CLI 编写 Orca 脚本" width="100%" /></picture></a>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
**此外还包括:**
|
||
|
||
- **[快速打开](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) 才是真正的功能清单。
|
||
|
||
---
|
||
|
||
## 支持的 Agent
|
||
|
||
支持**任意 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>
|
||
<a href="https://github.com/openai/codex"><kbd><img src="https://www.google.com/s2/favicons?domain=openai.com&sz=64" alt="Codex logo" width="16" valign="middle" /> Codex</kbd></a>
|
||
<a href="https://x.ai/cli"><kbd><img src="https://www.google.com/s2/favicons?domain=x.ai&sz=64" alt="Grok logo" width="16" valign="middle" /> Grok</kbd></a>
|
||
<a href="https://cursor.com/cli"><kbd><img src="https://www.google.com/s2/favicons?domain=cursor.com&sz=64" alt="Cursor logo" width="16" valign="middle" /> Cursor</kbd></a>
|
||
<a href="https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli"><kbd><img src="https://www.google.com/s2/favicons?domain=github.com&sz=64" alt="GitHub Copilot logo" width="16" valign="middle" /> GitHub Copilot</kbd></a>
|
||
<a href="https://opencode.ai/docs/cli/"><kbd><img src="https://www.google.com/s2/favicons?domain=opencode.ai&sz=64" alt="OpenCode logo" width="16" valign="middle" /> OpenCode</kbd></a>
|
||
<a href="https://mimo.xiaomi.com/coder"><kbd><img src="https://www.google.com/s2/favicons?domain=mimo.xiaomi.com&sz=64" alt="MiMo Code logo" width="16" valign="middle" /> MiMo Code</kbd></a>
|
||
<a href="https://ampcode.com/manual#install"><kbd><img src="https://www.google.com/s2/favicons?domain=ampcode.com&sz=64" alt="Amp logo" width="16" valign="middle" /> Amp</kbd></a>
|
||
<a href="https://openclaude.gitlawb.com/"><kbd><img src="resources/openclaude-logo.png" alt="OpenClaude logo" width="16" valign="middle" /> OpenClaude</kbd></a>
|
||
<a href="https://antigravity.google/docs/cli-overview"><kbd><img src="https://www.google.com/s2/favicons?domain=antigravity.google&sz=64" alt="Antigravity logo" width="16" valign="middle" /> Antigravity</kbd></a>
|
||
<a href="https://pi.dev"><kbd><img src="https://pi.dev/favicon.svg" alt="Pi logo" width="16" valign="middle" /> Pi</kbd></a>
|
||
<a href="https://omp.sh"><kbd><img src="https://omp.sh/favicon.svg" alt="oh-my-pi logo" width="16" valign="middle" /> oh-my-pi</kbd></a>
|
||
<a href="https://hermes-agent.nousresearch.com/docs/"><kbd><img src="https://www.google.com/s2/favicons?domain=nousresearch.com&sz=64" alt="Hermes Agent logo" width="16" valign="middle" /> Hermes Agent</kbd></a>
|
||
<a href="https://devin.ai/cli"><kbd><img src="https://www.google.com/s2/favicons?domain=devin.ai&sz=64" alt="Devin logo" width="16" valign="middle" /> Devin</kbd></a>
|
||
<a href="https://block.github.io/goose/docs/quickstart/"><kbd><img src="https://www.google.com/s2/favicons?domain=goose-docs.ai&sz=64" alt="Goose logo" width="16" valign="middle" /> Goose</kbd></a>
|
||
<a href="https://docs.augmentcode.com/cli/overview"><kbd><img src="https://www.google.com/s2/favicons?domain=augmentcode.com&sz=64" alt="Auggie logo" width="16" valign="middle" /> Auggie</kbd></a>
|
||
<a href="https://github.com/autohandai/code-cli"><kbd><img src="https://www.google.com/s2/favicons?domain=autohand.ai&sz=64" alt="Autohand Code logo" width="16" valign="middle" /> Autohand Code</kbd></a>
|
||
<a href="https://github.com/charmbracelet/crush"><kbd><img src="https://www.google.com/s2/favicons?domain=charm.sh&sz=64" alt="Charm logo" width="16" valign="middle" /> Charm</kbd></a>
|
||
<a href="https://docs.cline.bot/cline-cli/overview"><kbd><img src="https://www.google.com/s2/favicons?domain=cline.bot&sz=64" alt="Cline logo" width="16" valign="middle" /> Cline</kbd></a>
|
||
<a href="https://www.codebuff.com/docs/help/quick-start"><kbd><img src="https://www.google.com/s2/favicons?domain=codebuff.com&sz=64" alt="Codebuff logo" width="16" valign="middle" /> Codebuff</kbd></a>
|
||
<a href="https://commandcode.ai/docs/quickstart"><kbd><img src="https://www.google.com/s2/favicons?domain=commandcode.ai&sz=64" alt="Command Code logo" width="16" valign="middle" /> Command Code</kbd></a>
|
||
<a href="https://docs.continue.dev/guides/cli"><kbd><img src="https://www.google.com/s2/favicons?domain=continue.dev&sz=64" alt="Continue logo" width="16" valign="middle" /> Continue</kbd></a>
|
||
<a href="https://docs.factory.ai/cli/getting-started/quickstart"><kbd><img src="docs/assets/droid-logo.svg" alt="Droid logo" width="16" valign="middle" /> Droid</kbd></a>
|
||
<a href="https://kilo.ai/docs/cli"><kbd><img src="https://raw.githubusercontent.com/Kilo-Org/kilocode/main/packages/kilo-vscode/assets/icons/kilo-light.svg" alt="Kilocode logo" width="16" valign="middle" /> Kilocode</kbd></a>
|
||
<a href="https://www.kimi.com/code/docs/en/kimi-code-cli/getting-started.html"><kbd><img src="https://www.google.com/s2/favicons?domain=moonshot.cn&sz=64" alt="Kimi logo" width="16" valign="middle" /> Kimi</kbd></a>
|
||
<a href="https://kiro.dev/docs/cli/"><kbd><img src="https://www.google.com/s2/favicons?domain=kiro.dev&sz=64" alt="Kiro logo" width="16" valign="middle" /> Kiro</kbd></a>
|
||
<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>
|
||
<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>
|
||
<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>
|
||
<kbd>+ 任意 CLI Agent</kbd>
|
||
</p>
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
### 桌面版 — macOS、Windows、Linux
|
||
|
||
- **[从 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)。
|
||
|
||
_或通过包管理器:_
|
||
|
||
```bash
|
||
# macOS (Homebrew)
|
||
brew install --cask stablyai/orca/orca
|
||
|
||
# Arch Linux (AUR) — or stably-orca-git to build from source
|
||
yay -S stably-orca-bin
|
||
```
|
||
|
||
### 移动伴侣应用 — iOS、Android
|
||
|
||
与桌面应用配对,在手机上监控并操控你的 agents。
|
||
|
||
- **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)
|
||
|
||
---
|
||
|
||
## 社区与支持
|
||
|
||
- **Discord:** 在 **[Discord](https://discord.gg/fzjDKHxv8Q)**. 加入社区
|
||
- **Twitter / X:** 关注 **[@orca_build](https://x.com/orca_build)** 获取更新与公告。
|
||
- **WeChat:** 扫描二维码加入社区。若第一个群已满,请使用备用群。
|
||
|
||
<img src="docs/assets/wechat-qr.png" alt="Orca 社区微信群二维码" width="160" />
|
||
<img src="docs/assets/wechat-qr-backup.jpg" alt="Orca 社区微信群备用二维码" width="160" />
|
||
|
||
- **反馈与建议:** 我们迭代很快。缺少什么功能?[提交新功能请求](https://github.com/stablyai/orca/issues).
|
||
- **隐私:** 查看[隐私与遥测文档](https://www.onorca.dev/docs/telemetry),了解 Orca 收集哪些匿名使用数据以及如何退出。
|
||
- **支持我们:** [Star](https://github.com/stablyai/orca) 本仓库,关注我们的每日发布。
|
||
|
||
---
|
||
|
||
## 开发
|
||
|
||
想要贡献代码或在本地运行?请参阅我们的 [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="stablyai/orca 的 GitHub Star 历史图表" width="880" />
|
||
</p>
|
||
|
||
## 许可证
|
||
|
||
Orca 在 [MIT License](LICENSE) 下免费开放源代码。
|