Orca
DeepSeek 原生的终端编码智能体:读代码、改文件、跑命令、自行验证,直到任务完成或需要你介入。
证据显示沙盒设计较完整:SECURITY.md 描述了能力解析器/执行代理、拒绝时不回退到宿主 shell、项目配置不具权威性,依赖中有 landlock/seccompiler;README 提供 suggest/auto-edit/full-auto/plan 分级与 /trust 按文件夹信任。扣分点:full-auto 全盘访问模式存在但风险边界仅在文档层面描述;未见文件编辑回滚机制;版权署名为 'blade-deepseek' 而发布者身份未验证,来源归属薄弱。
Cargo workspace 依赖统一版本、部分精确锁版本(=0.10.4 等)并使用 rustls,可用性管理尚可。扣分点:命名自相矛盾——crate 名 'blade-deepseek'、npm 包 '@blade-ai/orca'、SECURITY.md 指向 blade-deepseek 仓库,说明历史改名痕迹且未完全统一;所给文件中未见错误信息与失败路径的具体设计。
README 明确多平台(macOS/Linux/Windows、ARM64/x64)、TUI 与 exec/CI 两种用法、ACP 协议,环境适配证据充分可得满分;有 /plan 只读与验证命令体现能力边界。扣分点:触发精度(何时建议何种模式)与目标受众/场景描述较浅,无失败场景指导。
信息架构良好:多语言 README、文档链接、SECURITY/CONTRIBUTING/SUPPORT 模板齐全,MIT 许可证与 Cargo.toml 一致可得满分。扣分点:仓库内未见 CHANGELOG,版本仅见于 Cargo.toml 0.4.24;命名不稳定(blade-deepseek vs Orca vs @blade-ai/orca);已知局限与注意事项文档缺失;curl | sh 管道安装未提供校验和说明。
价值主张清晰(DeepSeek 原生、本地运行、前缀缓存、会话压缩/恢复),对 DeepSeek 生态有边际价值;成本方面未见 token 成本控制的具体证据,输出可用性仅文档层面可评估。扣分点:所有性能与效果声明均无仓库内基准或数据支撑。
README 声明可通过 Cargo.toml(版本、许可证、workspace 结构)、SECURITY.md(安全边界)部分交叉印证。扣分点:多语言 README 之间的一致性只能抽查一份(es-419);关键声明(沙盒强制、npm 发布)在所给文件中缺少代码级证据;声明与推断基本分离,未见编造测试或证明书的迹象。
- curl | sh 与 PowerShell 远程脚本安装方式在静态审查中无法验证其校验和与完整性,建议改用带签名校验的安装方式。
- full-auto 模式授予宿主全访问权限;SECURITY.md 自述其为 advisory 而非沙盒化,使用前请确认理解其风险。
- 命名不一致(blade-deepseek / Orca / @blade-ai/orca)提示包来源链条复杂,供应链验证(npm provenance、发布签名)需自行确认。
- 未验证发布者身份,且无响应 SLA 承诺;生产使用请评估自身支持需求。
- 仓库内未提供 CHANGELOG 与已知局限说明,升级前请查阅外部 changelog 与 release notes。
这个 Agent 能做什么,适合哪些场景?
Orca(GitHub 仓库 echoVic/orca-agent)是一个用 Rust 编写、在本地运行的 DeepSeek 原生编码智能体,MIT 许可。给它一个任务,它会读取代码、编辑文件、执行 shell 命令并验证结果,持续工作直到完成或需要人工介入。它直接使用 DeepSeek 的推理与工具调用语义,包括 SSE 流式输出、前缀缓存友好的提示、自动上下文管理和重试逻辑。提供交互式 TUI(orca)、无头执行(orca exec)、JSONL/app-server 以及 Agent Client Protocol (ACP) 等稳定接口,覆盖编辑器、测试框架和 CI 场景。支持会话恢复(--resume/--fork)、子智能体、持久目标模式(/goal)、自动项目记忆,以及 suggest、auto-edit、full-auto、plan 四种权限模式和按目录的信任设置。
安装后通过 DEEPSEEK_API_KEY 连接 DeepSeek 模型,直接采用其推理与工具调用协议并完整回放 reasoning_content。Orca 读取、搜索、编辑和写入代码文件,执行 shell 命令;运行时拥有的 exec_command 会话可跨工具调用存活、分配 PTY 并通过 write_stdin 接收输入,以支持编辑器、REPL 和终端程序;后台监督器管理已退出的会话并在下一轮模型调用前注入有界的完成通知。交互式 TUI 会话可提出 1–4 个结构化澄清问题(含选项、预览和多选)。可用 orca exec --verifier "cargo test" 在结束前验证结果,用 orca exec resume SESSION_ID 恢复无头会话。支持同步/异步子智能体和 JavaScript 工作流,并可通过 resume_from 续接子会话;/tasks 工作区提供实时转录和停止/恢复/重试控制。成功提交后会学习有界的持久项目事实(/remember),后续只检索相关事实。模型方面显式启用 DeepSeek V4 思考(reasoning_effort 可设 low/high/max),deepseek-v4 系列(含 Flash、Vision-exp、Pro)具备 1M 上下文与最高 384K 输出,支持 JPEG/PNG/GIF/WebP 图片输入,TUI 中可 Ctrl+V 粘贴剪贴板图片并按终端协议渲染像素级预览。配置优先级为环境变量、CLI 参数、配置文件、默认值;用户配置在 ~/.orca/config.toml,受信任项目可提供 .orca/config.toml、AGENTS.md、规则、技能和工作流。
- 终端里用 DeepSeek 模型做日常编码的开发者,希望智能体直接读改本地代码并跑测试验证
- CI/流水线维护者,用 orca exec 无头运行任务(如 "fix the failing test")并以 JSONL 输出和退出码集成
- 使用 ACP 兼容编辑器的工程师,通过 orca --mode=acp 接入编辑器内智能体体验
- 需要并行或长任务的团队,用子智能体和 JavaScript 工作流拆分工作并用 /goal 持久推进目标
- Windows/macOS/Linux 多平台用户,依赖统一的沙盒权限模式(suggest/auto-edit/full-auto/plan)和按目录信任控制
- 需要会话可恢复的工作流,使用 --resume/--fork 或 orca exec resume 在消息边界续接历史对话
这个 Agent 有哪些优点和局限?
- DeepSeek 原生:直接使用其推理与工具调用语义,保留 Chat Completions 传输并在工具轮次间完整回放 reasoning_content,可发挥 1M 上下文与最高 384K 输出窗口
- 接口面完整:同一运行时支撑 TUI、无头、JSONL、app-server 和 ACP 四类稳定契约,适合编辑器、测试框架与 CI 集成
- 可靠性设计细致:会话切换先启后关、转义驱动的取消提交终态、fail-closed 的续接恢复(只恢复经摘要校验的检查点)、预算停止产生带类型的终态并退出码 4
- 权限模型精细:suggest、沙盒 auto-edit、full-auto、只读 plan 四种模式加按目录信任,Windows 支持 AppContainer 隔离与受限会话
- 多平台支持完善:npm 包覆盖 macOS/Linux/Windows 的 ARM64 与 x64,Windows 对 PowerShell 7/5.1/cmd.exe 有明确策略
- 模型锁定 DeepSeek:核心运行依赖 DEEPSEEK_API_KEY 与 DeepSeek 语义(如 reasoning_content 回放),没有文档化的其他模型提供商适配路径
- 文档声明 deepseek-v4 系列(Flash、Vision-exp、Pro)与 V4 思考能力,采用前需确认这些模型对你可用的实际供给与定价
- 高级能力(沙盒、子智能体续接、工作流、记忆、MCP)需在受信任项目并提供 .orca/config.toml 等配置后启用,初始配置有学习成本
- Windows 场景存在分支行为:首选 PowerShell 7,缺失时受限会话回退 cmd.exe,5.1 仅限不需 AppContainer 隔离的模式
- 图片附件有 5 MiB 总限制;无图形剪贴板的 SSH 会话需粘贴或引用远程主机路径,终端无图像协议时预览退化为低分辨率色块
如何安装或部署这个 Agent?
通过 npm 全局安装(支持 macOS/Linux/Windows 的 ARM64 与 x64):npm install -g @blade-ai/orca。或直接安装原生二进制:macOS/Linux 运行 curl -fsSL https://orcaagent.dev/install.sh | sh;Windows PowerShell 运行 irm https://orcaagent.dev/install.ps1 | iex。Windows 项目目录下可用 & ([scriptblock]::Create((irm https://orcaagent.dev/install.ps1))) -SetupSandbox 配置受限沙盒能力。也可从 GitHub Releases 下载预构建压缩包。
如何使用这个 Agent?
1) 设置密钥:export DEEPSEEK_API_KEY=sk-...(Windows PowerShell 用 $env:DEEPSEEK_API_KEY = "sk-...")。2) 运行 orca 打开 TUI;或 orca exec "fix the failing test" 无头执行;或 orca exec --verifier "cargo test" "fix it" 在结束前验证。3) 用 orca --resume [SESSION_ID] 恢复会话、--fork SESSION_ID 分叉、orca exec resume SESSION_ID "continue" 续接无头会话(可用 --last 取最近一次、--resume-at MID 续到消息边界)。4) TUI 内 @ 搜索文件/技能/插件/MCP 资源,/plan 只读规划、/goal 设定持久目标、/tasks 管理子智能体与后台命令、/trust 管理沙盒权限、/config 打开设置面板。5) 配置写在 ~/.orca/config.toml,可通过 config.toml 的 reasoning_effort 或 ORCA_REASONING_EFFORT 调整思考强度。