OrcaCode

OrcaCode 是一款本地优先的桌面开发智能体平台，目标是把 Codex / Claude Code 一类工作流做成可自托管、可扩展、可适配多模型 API 的桌面控制台。

界面采用 Command Deck（命令指挥台）v3 设计系统：深蓝石墨表面 + 鸢尾紫信号强调、深色优先、顶部全宽命令中心 + 底部全局状态甲板。设计规范见 design/DESIGN_SYSTEM.md。

当前能力

• 桌面端：Electron + Express 本地服务，默认监听 127.0.0.1:19090。
• 前端：Vite + React（Command Deck 外壳），包含聊天工作区、项目侧栏、右侧检查器、设置页、模型配置、日志、终端、文件与任务视图。
• 多 API：内置 DeepSeek、通义千问、智谱、月之暗面、百川、零一万物、豆包、硅基流动、小米 MiMo、MiniMax、腾讯混元、阶跃星辰、OpenAI、Anthropic、Gemini、Groq、OpenRouter 等预设。
• 自定义 API：支持 OpenAI-compatible 供应商，自定义 baseUrl、API Key 环境变量、模型列表、chat/models 路径。
• 协议转换：支持 OpenAI Chat Completions、OpenAI Responses 转换、Anthropic Messages 转换。
• Agent：支持工具调用、并行只读工具、工作区文件读取/写入、终端命令、技能脚本、MCP 工具接入、长上下文压缩和工具调用配对保护。
• 平台扩展：技能(Skills)、自动化(Automations)、记忆(Memory)、插件市场(Marketplace)、Hook、Profile、快照、工作树、环境、浏览器、Computer Use、审查、成本限制与审计日志。
• 运行观测：请求统计、token/费用估算、日志缓冲、模型发现、健康检查。

快速开始

npm install
cd frontend
npm install
cd ..
npm start

开发模式：

npm run dev
cd frontend
npm run dev

测试与构建：

npm test
npm run build

打包 Windows 桌面版：

npm run package

产物位于：

release-v6/win-unpacked/OrcaCode.exe

API Key 配置

可以在设置页写入 API Key，也可以使用环境变量，例如：

$env:DEEPSEEK_API_KEY="..."
$env:OPENAI_API_KEY="..."
$env:ANTHROPIC_API_KEY="..."
$env:GEMINI_API_KEY="..."
$env:OPENROUTER_API_KEY="..."

自定义供应商推荐使用 OpenAI-compatible API。如果服务商路径不是标准 /v1/chat/completions 或 /v1/models，可在设置页填写自定义路径。

高价值改造方向

• 更强的工具权限策略：为写文件、终端命令、网络访问提供可视化审批和策略模板。
• 更完整的 provider 诊断：一键测试连通性、模型列表、上下文长度、费用与流式输出能力。
• 更强的 agent 记忆与任务恢复：保存计划、工具轨迹、失败原因和下一步建议。
• 更细的前端性能治理：持续拆分重资源，增加页面级 smoke test 和可视化回归截图。
• 更稳的桌面发布链路：增加签名、安装包、自动更新和崩溃日志采集。