echoVic/orca-agent

什么是 Orca？

Orca 是一个本地运行的、基于终端的编码助手，与 DeepSeek 大语言模型进行交互。它能够读取、编辑和创建源文件，运行 shell 命令并验证结果——所有这些操作都可以在基于文本的 UI 中完成，或者在 CI 流水线中以无头“exec”模式运行。

如何使用

• 安装 – 通过 npm 全局包 (npm i -g @blade‑ai/orca) 或下载预构建的 Rust 二进制文件。
• 运行 – orca 打开交互式 TUI；orca exec "fix the failing test" 执行一次性任务而不显示 UI。会话可以保存、恢复或分叉。
• 下达任务 – 输入自然语言指令。Orca 将指令转化为计划，调用工具（文件编辑、shell 命令、图像处理等），展示模型的推理过程，并在需要时请求您的批准。
• 控制 – 快捷键允许您批准工具调用、中断、后台工作、查看子代理以及管理跨轮次持久化的“目标”。

核心功能 (来自 README)

功能	说明
DeepSeek 原生	使用 DeepSeek‑Flash 或 DeepSeek‑V4‑Pro 模型，支持流式输出和可选的图像视觉分析。
终端 UI	丰富的 TUI，支持提及 (@)、技能插入 ($)、命令菜单 (/) 和图像粘贴 (Ctrl+V)。
无头 / CI 模式	orca exec 可脚本化；它会打印恢复命令，以便后续运行可以继续同一会话。
工具沙盒	操作受模式限制 – suggest、auto‑edit、full‑auto、plan – 以及按文件夹的信任设置。
子代理与工作流	生成同步或异步的子代理，每个代理都有自己的对话和控制权。
持久化内存	在成功的轮次后学习项目特定的事实，并可在稍后回忆。
MCP / ACP 集成	连接到外部 “MCP” 服务器（例如 Pilion Browser），并为编辑器或其他工具暴露 Agent Client Protocol。
跨平台	提供 macOS、Linux、Windows (ARM & x64) 的二进制文件；也通过 npm 分发。
可配置	通过环境变量、CLI 标志或 ~/.orca/config.toml 进行设置。
可靠性	处理取消、检查点和恢复；将长时间运行的命令与 UI 隔离。

谁会觉得 Orca 有用？

• 开发者：希望拥有一个可以在本地机器上修改代码而无需将源代码发送到云端的 AI 助手。
• CI/CD 流水线：需要自动化的“修复”步骤 – orca exec 可以在容器中运行，并在达到预算限制时恢复。
• 高级用户：喜欢终端优先的工作流，但仍希望模型能够查看图像或与浏览器交互（通过 Pilion）。

了解更多

• 完整文档：https://orcaagent.dev/docs/
• 安装脚本和发布：https://github.com/echoVic/orca-agent/releases
• 社区聊天：QQ 群 472309526，Telegram 链接见 README。

---

以上所有信息均直接取自项目的 README；不作额外声明。