SuperAPI AI 工具集

orca-agent

Orca 是一个面向终端的 DeepSeek 原生编程智能体,使用 Rust 构建,本地运行,MIT 许可。用户给出任务后,Orca 会读取代码、编辑文件、运行命令、验证结果,并持续工作直到任务完成或需要用户介入。它提供交互式 TUI 和用于脚本与 CI 的 orca exec 两种使用方式,支持通过 npm 或原生二进制安装,并可与 Pilion Browser 等 ACP 客户端集成。

访问官网

工具介绍

Orca 是一个面向终端的 DeepSeek 原生编程智能体(coding agent),使用 Rust 构建,本地运行,采用 MIT 许可证。用户向 Orca 下达任务后,它会读取代码、编辑文件、运行命令、验证结果,并持续工作直到任务完成或需要用户介入。

主要能力

  • 代码操作:读取、搜索、编辑和写入代码,运行 shell 命令,并可用用户指定的命令验证结果。bash 是唯一的命令入口点,每个命令归属于任务而非工具调用,长时间构建、CI 监控或交互式 PTY 会话在调用返回后仍会继续运行。
  • 交互式 TUI:在项目目录中运行 orca 即可启动。首次运行会询问是否信任该文件夹;信任后 Orca 可加载项目配置、指令、技能、智能体和 workflows,但不会启用或绕过操作系统沙箱。支持 @ 提及文件、技能、插件和 MCP 资源,$ 插入技能,/ 打开命令菜单,? 列出所有按键,Ctrl+V 附加剪贴板图片。
  • 任务控制:Esc 中断,Enter 排队下一轮跟进,Ctrl+Enter 将跟进发送到正在运行的轮次,Ctrl+B 将轮次移至后台。工具调用需要批准时会出现审批面板,可选择允许一次、允许此精确调用、允许该工具用于本次会话或拒绝。Shift+Tab 在 suggest → auto-edit → full-auto → plan 模式间循环。
  • 后台工作:/tasks 显示任务坞,/agents 打开 Agent 工作区,/workflows 保留 workflow 运行树。后台智能体在用户空闲时完成,Orca 会继续处理其结果。
  • MCP 服务器:配置中的服务器在 TUI 打开时后台连接,/mcp 显示状态、工具和提示,并支持重连、登录或登出。每个 MCP 提示可作为斜杠命令运行。
  • 计划、目标与回顾:/plan 只读调查并以计划结束,/goal 设置持久目标,/recap 总结会话,/side 打开侧边对话。
  • 会话管理:/new、/resume、/fork、/rename、/model、/config、/copy 等命令。模型和推理强度选择保存到用户 config.toml。
  • 项目记忆:录制的会话自动启用项目记忆,/remember 用于显式记录用户或项目事实。
  • 子智能体与工作流:支持同步子智能体、异步子智能体和 workflow 子智能体,具有运行时拥有的延续 ID,可通过 resume_from 追加新提示到同一持久子对话。
  • 持久目标模式:无固定轮次上限运行持久目标,可选 [budget] 限制(--max-turns、--max-tool-calls、--max-cost-usd、--max-wall-time-secs)。
  • 接口契约:提供稳定的 JSONL、app-server 和 Agent Client Protocol (ACP) 契约,供编辑器、测试框架和 CI 使用。

使用方式 安装:可通过 npm 安装,npm 包支持 macOS、Linux 和 Windows 的 ARM64 与 x64;也可从 GitHub Releases 获取预构建归档,或直接安装原生二进制。Windows PowerShell 上可设置 $env:DEEPSEEK_API_KEY = "sk-..."。

从项目目录运行 orca 启动 TUI,或使用 orca exec 用于脚本和 CI。配置优先级为环境变量、CLI 参数、配置文件、默认值。用户配置位于 ~/.orca/config.toml;受信任项目还可提供 .orca/config.toml、AGENTS.md、规则、技能和 workflows。

模型:未设置或 auto 模型使用 deepseek-flash(DeepSeek-V4.1-Flash)。可通过 /model、--model 或 config.toml 中的 model = "deepseek-v4-pro" 选择 deepseek-v4-pro。两个模型均使用 1M token 上下文窗口,允许最多 384K 输出 token。已退役的 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 名称仍被接受并规范化为 deepseek-flash。DeepSeek 思考需显式启用:在 config.toml 中设置 reasoning_effort 为 low、high 或 max(默认),或使用 ORCA_REASONING_EFFORT。

图像输入:接受 JPEG、PNG、GIF 和 WebP,来自 ACP 客户端和 TUI。Flash 直接消费图像;Pro 使用 Flash 进行任务感知的视觉分析后再继续。TUI 中可用 Ctrl+V 附加剪贴板图片,或拖拽/粘贴图像路径和 file:// URL,或通过 @file 选择图像。内联附件共享 5 MiB 总限制。

适用场景

  • 终端内的交互式编程任务。
  • 脚本和 CI 中的自动化编程任务(orca exec)。
  • 需要长时间运行、后台执行或并行子任务的工作。
  • 与支持 ACP 的编辑器或浏览器(如 Pilion Browser)集成。

限制

  • 需要 DeepSeek API 密钥。
  • 在最小 Linux 系统(如 slim 容器镜像)上需要 ca-certificates 包,否则无法发起任何网络请求,包括纯 HTTP。
  • Windows 上优先使用 PowerShell 7,受限会话在 PowerShell 7 不可用时回退到 cmd.exe;Windows PowerShell 5.1 仅在不要求 AppContainer 隔离的模式下作为显式选项。
  • 计算机使用(Computer Use)功能仅在 macOS 14 或更高版本上可用。
  • 共享 ACP 会话(orca daemon、orca attach、orca acp-bridge)仅在 Unix 上提供。
  • 延续恢复采用故障关闭策略,仅恢复经过摘要验证的对话检查点,不恢复 Rust future 或进程栈。
  • 其他未在资料中明确的功能、收费、价格、平台或效果暂未提供。