Files
orca/docs/readme
Neil 45f3512a33 feat(agents): add first-class DeepSeek Harness (dsh) support (#22468)
* feat(agents): add first-class DeepSeek Harness (dsh) support

Register DSH as a supervised Orca agent: catalog entry and detection for its
dsh-tui profile, status/question hooks through DeepSeek's own Claude-Code hook
bridge, composer-ready prompt delivery, session resume, headless Source Control
AI, and title identity that no longer collides with Gemini's.

* fix(dsh): reach Orca through DSH's credential scrub and stop reading its title as Gemini

DSH runs command hooks through its own shell executor, which drops every env var whose
name contains KEY, TOKEN, SECRET or PASSWORD — taking ORCA_PANE_KEY and
ORCA_AGENT_LAUNCH_TOKEN with it, so every hook exited without posting. Mirror both onto
scrub-safe aliases at spawn and restore them at the top of the DSH hook script.

Its title collided too: DSH rests on the same glyph Gemini works on, so a resting DSH
pane was relabelled Gemini CLI and reported working forever. Defer both the Gemini
classifier and the title status detector on DSH's whale, in the base module both copies
of that classifier read.

* test(mobile): repin the session-route closure for the DSH agent icon

* fix(dsh): address review — never splice user rows, cover remote panes, keep the diff off argv

- findManagedDshPatchRegion paired an orphan start marker with a later block's end, so a
  truncated write made install/remove delete the user's own rows. Pair each end with the
  nearest preceding start; regression test fails without the fix.
- The relay PTY env builder never applied the scrub-safe aliases, so remote DSH status
  silently never appeared even with the remote hook installed.
- Source Control AI sent the whole diff on argv; send it over stdin with DSH's '-' marker.
- dsh-tui/dst already chose the interactive profile, so a workspace folder named 'web' or
  'plugin' no longer marks a live agent pane non-interactive.
- Isolate USERPROFILE as well as HOME so a Windows run cannot edit the real home.
- Drop the duplicate README badge and revert an incidental doc reformat.

* refactor(dsh): share the managed-hooks reader and tighten the new modules

Reuse before reimplementing: readManagedDshHookEvents was a near-verbatim copy of Muse's,
with byte-identical private helpers. Both now call one readManagedHookEventsFromJson.

Also: one readTextOrAbsent instead of two spellings of the same read (dropping an
existsSync TOCTOU), one status() builder instead of four inline literals, rmSync(force)
instead of exists-then-unlink, and a redundant empty-string guard before JSON.parse.
The patch-file transforms lose their index juggling for a predicate plus a filter.

* fix(dsh): refuse a flow-style patch file, keep its mode, and stop the relay inheriting a pane

- applyManagedDshPatch matched only an exact `[]`, so `[] # keep empty` or a non-empty
  flow sequence got a block entry appended after it — invalid YAML that would leave DSH
  unable to load the user's own patch layer either. It now strips the token from an empty
  sequence (keeping a trailing comment) and returns null for a non-empty one; install
  reports that and changes nothing.
- The patch rewrite dropped an owner-only file to the umask default (CWE-732); pass
  preserveMode.
- The relay PTY env never dropped inherited pane identity the way the local and daemon
  builders do, so a spawn that specified none could inherit the relay's own and every
  agent's hook would report against that pane.

* fix(dsh): keep the flow-style refusal in every status read, and scope the mode test to POSIX

A refused patch file carries no managed region, so getStatus() fell through to a bare
not_installed with detail null — the actionable 'rewrite it as a block sequence' message
only ever reached the one-shot install() return. Export the predicate and check it first,
behind one shared message constant.

The owner-only mode assertion cannot hold on Windows, where chmod only toggles the
read-only attribute and mode & 0o777 reads 0o666 for any writable file.

* docs(readme): restore the DeepSeek Harness badge lost in the rebase

* test(mobile): repin the session-route closure to the measured 4221

Measured, not derived: 4220 without the DSH icon entry, 4221 with it. Two of the three
modules above main's 4218 pin are not this change's — they arrived with the mobile work
after #22570 and were never repinned; the changelog records that split explicitly.

* fix(dsh): settle tui-idle on the agent's own hook, so supervised workers see it ready

Reported by a tester on the adhoc build: `terminal wait --for tui-idle` ran to its 90s
timeout against an already-ready DSH composer, so a supervised worker never sees the agent
as ready.

Every existing tier reads the title, and DSH deliberately carries no title status: its rest
prefix is Gemini's working glyph, so the detector reports none. A fresh first-party `done`
is better evidence than any title anyway — it is the agent's own account of its own turn,
and normalizeDshEvent drops subagent events, so it is the lead's. Scoped to DSH: for agents
whose hooks report child turns, a mid-turn `done` is the #6011 class this file prevents.

* test(daemon): record the DSH transcript's true-colour I2 divergences

Adding the dsh-tui capture to __fixtures__ enrolled it in the serialize replay sweep, where
it reports 10 I2 divergences and failed the unlisted-transcript default of 0.

Every one is the same shape — visible-grid row=0, a 24-bit background the round trip does
not restore to default — which is DSH's whale intro painting whole rows of true colour.
Verified as an upstream limitation rather than a regression by replaying against the
previous build (build-serialize-addon-at-ref.mjs --ref origin/main): I1 and I3 both hold.

* fix(dsh): return the new tui-idle verdict from the first-party done lane

Main refactored isTuiIdleSatisfied into evaluateTuiIdle, which returns a verdict rather
than a boolean. The DSH lane still returned `true`; it is tier-1 positive evidence, so it
returns READY_STRONG like the title/body lane above it. Re-verified the regression test
still fails without the lane.

* test(relay): pin the scrub-safe pane-identity aliases on the relay spawn path

The relay builds a remote pane's env itself, so the alias mirroring there had no
test: removing the call left every suite green while remote DSH status silently
vanished. Both cases fail without it.

* docs(dsh): point the hook service at the integration reference

The reference doc had no inbound link from anywhere in the repo.
2026-09-27 22:44:18 -07:00
..

Orca Orca

GitHub Star 数 所有版本的总下载量 许可证: MIT 加入 Orca Discord 在 X 上关注 Orca 支持的平台:macOS、Windows 和 Linux

English · 日本語 · 한국어 · Español · Français · Português

面向 100x 构建者的 AI 编排器。
并排运行 Codex、Claude Code、OpenCode 或 Pi — 每个都在自己的 worktree 中运行,并在一个地方统一跟踪。

下载 Orca

Orca 桌面应用在并行 worktree 中运行智能体,角落里是 Orca 移动 companion 应用

特性

移动 Companion 应用

用手机监控并指挥你的智能体 — 智能体完成时收到通知,随时随地发送后续指令。

iOS App Store · Android APK · 文档 →

Orca 桌面端与移动 companion 应用

并行 Worktree

把一个提示同时分发给五个智能体,每个都在自己隔离的 git worktree 中运行 — 比较结果,合并最佳方案。

文档 →

并行 worktree 编排

终端分屏

Ghostty 级终端,支持 WebGL 渲染、无限分屏,以及重启后依然保留的滚动历史。

文档 →

终端分屏

设计模式

在真实的 Chromium 窗口中点击任意 UI 元素,把它的 HTML、CSS 和裁剪好的截图直接发送到智能体的提示中。

文档 →

内置浏览器与设计模式

GitHub & Linear 原生集成

在应用内浏览 PR、issue 和项目看板 — 从任意任务打开 worktree,无需切换上下文即可完成评审。

文档 →

Orca 中的 GitHub 与 Linear 任务工作流

SSH Worktree

在高性能远程机器上运行智能体,完整支持文件编辑、git 和终端 — 自动重连与端口转发一应俱全。

文档 →

通过 SSH 使用远程 worktree

标注 AI Diff

在任意 diff 行上添加评论并发回给智能体 — 评审、编辑、提交,全程无需离开 Orca。

文档 →

标注 AI 生成的 diff

拖文件给智能体

VS Code 的编辑器,处处自动保存 — 把文件或图片直接拖入智能体提示。

文档 →

将文件和图片拖入智能体提示

Orca CLI

智能体也能驱动 Orca — 用 orca worktree create、snapshot、click 和 fill 把每个工作流脚本化。

文档 →

从 CLI 脚本化 Orca

开箱即用的还有:

  • 快速打开 — 在 worktree、文件、智能体、命令和仓库上下文之间搜索,不打断你的心流。
  • 账号切换与用量追踪 — 查看 Claude 和 Codex 的用量与限额重置时间,并且无需重新登录即可热切换账号。
  • 丰富仓库预览 — 在工作区中预览 Markdown、图片、PDF 和仓库文档。
  • Computer Use — 当工作流需要真实交互时,让智能体操作桌面应用和可见 UI。
  • 通知与未读状态 — 第一时间知道智能体何时完成或需要关注,并可将会话标记为未读,稍后再回来处理。
  • 还有很多很多 — 我们每天发布新功能,这个列表永远跟不上。更新日志才是真正的功能列表。

支持的智能体

适配任何 CLI 智能体 — 只要能在终端里运行,就能在 Orca 里运行。

Claude Code logo Claude Code   Codex logo Codex   Grok logo Grok   Cursor logo Cursor   GitHub Copilot logo GitHub Copilot   Muse logo Muse   DeepSeek Harness logo DeepSeek Harness   ZCode logo ZCode   OpenCode logo OpenCode   Amp logo Amp   OpenClaude logo OpenClaude   Antigravity logo Antigravity   Pi logo Pi   oh-my-pi logo oh-my-pi   Hermes Agent logo Hermes Agent   Goose logo Goose   Auggie logo Auggie   Autohand Code logo Autohand Code   Charm logo Charm   Cline logo Cline   Codebuff logo Codebuff   Command Code logo Command Code   Continue logo Continue   Droid logo Droid   Kilocode logo Kilocode   Kimi logo Kimi   Kiro logo Kiro   Mistral Vibe logo Mistral Vibe   Qwen Code logo Qwen Code   Rovo Dev logo Rovo Dev   + 任何 CLI 智能体


安装

桌面端 — macOS、Windows、Linux

也可以通过包管理器安装:

# macOS (Homebrew)
brew install --cask stablyai/orca/orca

# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin

移动 Companion 应用 — iOS、Android

与桌面应用配对,用手机监控并指挥你的智能体。


社区与支持

  • Discord: 加入 Discord 社区。

  • Twitter / X: 关注 @orca_build 获取更新和公告。

  • 微信: 扫码加入 Orca 社区微信第 10 群。

    Orca 社区微信第 10 群二维码
  • 反馈与想法: 我们发布很快。缺少什么功能?提交功能请求。

  • 隐私: 查看隐私与遥测文档,了解 Orca 收集哪些匿名使用数据以及如何退出。

  • 支持我们: 给这个仓库点 Star,关注我们的日常发布。


开发

想要贡献代码或在本地运行?请参阅我们的 CONTRIBUTING.md 指南。

Orca 贡献者

许可证

Orca 是自由且开源的软件,遵循 MIT 许可证。