DeepOrca 是一个 AI 驱动的下一代编码助手,专为 deepseek-v4 模型优化,以 Electron 桌面客户端为唯一形态,由两个包组成:
| 包 | 说明 |
|---|---|
@deeporca/core |
核心引擎:LLM 会话循环、内置工具、Skills/MCP 扩展、会话持久化 |
@deeporca/desktop |
Electron 桌面客户端:完整 GUI,Monaco 编辑器、多面板、多主题 |
DeepOrca 起源于 Deep Code(@vegamo/deepcode)的 fork,已发展为一个独立项目。我们保留了 Deep Code 优秀的核心引擎架构(LLM 会话循环、内置工具、Skills/MCP 扩展、权限控制),并在此基础上进行了大量扩展——包括桌面客户端 GUI、内置插件系统、GitMCP 模块、Monaco Editor 集成等,并移除了终端 CLI 与 VSCode 插件形态。
Deep Code 基于 MIT 协议开源,本项目依照协议要求完整保留了其原始版权声明(见 LICENSE),并在此向原作者致谢。
DeepOrca 提供三种并列的扩展能力:
| 扩展类型 | 说明 | 管理方式 |
|---|---|---|
| Skills(技能) | SKILL.md 驱动的 Agent 能力扩展 | 放入 .deeporca/skills/ 目录 |
| MCP 服务器 | 通过 Model Context Protocol 连接外部服务 | 在 settings.json 中配置 |
| 内置插件 | 随 DeepOrca 一起发布的核心能力扩展 | 自动加载,不可卸载 |
当前内置插件:
- browser-skill — 浏览器自动化(访问页面、填写表单、抓取数据、UI 回归测试)
- open-code-review — AI 代码审查(读取 Git diff 生成行级精度的结构化审查意见)
- git-mcp — 本地 GitMCP 模块(索引 GitHub 仓库,语义搜索文档和代码)
- Monaco Editor 集成 — 专业代码编辑器,支持语法高亮、智能提示
- GitMCP 面板 — 管理 GitHub 仓库索引,语义搜索文档和代码
- 代码审查面板 — 一键审查工作区变更或分支对比,流式输出 + 结构化评论展示
- 代码索引面板 — CodeGraph 代码图谱可视化
- 源码管理面板 — Git 操作(stage/commit/diff/branch)
- 多主题系统 — Aqua 原生 / Glass Prism 玻璃拟态 / Punk 2077 赛博朋克
- 6 语言国际化 — en / zh / ja / ko / zh-HK / zh-TW
| 能力域 | 功能 | 状态 |
|---|---|---|
| 核心引擎 | LLM 会话循环、7 内置工具、上下文压缩 | ✅ |
| 桌面客户端 | Electron GUI、多面板、多主题 | ✅ |
| 扩展系统 | Skills / MCP / 内置插件 | ✅ |
| 代码编辑器 | Monaco Editor 集成 | ✅ |
| 代码索引 | CodeGraph MCP Server + 索引面板 | ✅ |
| 代码审查 | Open Code Review 内置插件 + 审查面板 | ✅ |
| GitMCP | 本地 GitMCP 模块 + 仓库索引面板 | ✅ |
| 浏览器自动化 | browser-skill 内置插件 | ✅ |
| 源码管理 | Git 面板(stage/commit/diff/branch) | ✅ |
| 权限控制 | 细粒度 scope 策略 | ✅ |
| 会话持久化 | 跨会话恢复、归档、导出 | ✅ |
| 联网搜索 | 内置 WebSearch 工具 | ✅ |
| 多模态 | 图片粘贴/拖拽输入 | ✅ |
| # | 特性 | 说明 | 状态 |
|---|---|---|---|
| 1 | 远程插件中心 | 在线插件市场,支持一键安装/更新社区 Skills 和 MCP 服务器 | 🔨 规划中 |
| 2 | 自定义 CLI 与指令 | 用户可注册自定义斜杠命令和 CLI 子命令,扩展 Agent 工作流 | 🔨 规划中 |
| 3 | 项目图谱与沉浸式 Wiki | 代码知识图谱可视化 + 项目级知识沉淀(类似 Qoder 知识中心) | 📐 设计中 |
| 4 | Designer 能力 | AI 驱动的 UI 设计生成,从自然语言描述到可预览的界面原型 | 🔨 规划中 |
DeepOrca 计划集成 9 个优秀的开源项目,构建更强大的编码助手生态:
| # | 项目 | 集成形态 | 核心价值 | 优先级 | 状态 |
|---|---|---|---|---|---|
| 1 | flutter/agent-plugins | 构建时内置 Skills | Flutter/Dart 开发能力包 | P0 | ✅ 已集成 |
| 2 | code-review-graph | 内置 MCP Server | 代码图谱 + 爆炸半径 + 简化架构图 | P0 | 📋 规划中 |
| 3 | serena | 内置 MCP Server | 符号级重构/导航/编辑 | P1 | 📋 规划中 |
| 4 | mem0 | core 层 SDK | 跨会话长期记忆 | P1 | 📋 规划中 |
| 5 | openwiki | 内置 CLI 工具 | 项目 Wiki 自动生成与维护 | P1 | ✅ 已集成 |
| 6 | opencli | 内置插件 | 100+ 网站适配器 + CLI Hub | P2 | 📋 规划中 |
| 7 | CLI-Anything | 内置 Skill | 万能 CLI 生成(Agent 驱动任意软件) | P2 | 📋 规划中 |
| 8 | open-design | MCP Server(设计+展示) | AI 设计生成 + 文件交付给 coding agent | P2 | 📋 规划中 |
| 9 | obscura | MCP Server + 内置 Skill | 轻量级无头浏览器(大规模数据获取) | P2 | 📋 规划中 |
已集成项目说明:
- ✅ flutter/agent-plugins:构建脚本
scripts/install-flutter-skills.js,已内置 26 个 Flutter/Dart Skills - ✅ openwiki:vendored CLI + 内置 Skill + 桌面端 Wiki 面板集成
- ✅ codegraph:vendored CLI + 桌面端代码图谱面板(额外项目)
📋 详细路线图:查看 docs/features/feature-roadmap.md 了解完整的集成方案、技术选型和实施计划。
以下能力已完成前期调研,列入后期功能层面:
| 特性 | 参考项目 | 方向 |
|---|---|---|
| 代码审查图谱 | code-review-graph | 将审查意见与代码依赖图关联,可视化影响范围 |
| 语义代码导航 | serena | 基于语义的代码理解与导航引擎 |
| AI 记忆层 | mem0 | 跨会话长期记忆,让 Agent 积累项目知识 |
| 代码知识图谱 | Understand-Anything | Tree-sitter + LLM 混合分析,生成可交互知识图谱 |
📊 调研报告:查看 docs/research/ 了解详细的技术调研和可行性分析。
# 克隆仓库
git clone https://github.com/asdshuaishuai/deepcode-cli.git
cd deepcode-cli
# 安装依赖
npm install创建 ~/.deeporca/settings.json 文件(若本机已有 ~/.deepcode 配置目录则会直接沿用,无需迁移):
{
"env": {
"MODEL": "deepseek-v4-pro",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "sk-..."
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}📖 完整配置说明:查看 docs/configuration.md
# 开发模式
npm run desktop:dev
# 构建
npm run desktop:build
# 运行
npm run desktop:start| 文档 | 说明 |
|---|---|
| CHANGELOG.md | 更新日志和提交历史 |
| docs/architecture.md | 架构设计和核心流程 |
| docs/configuration.md | 配置文件详解 |
| docs/mcp.md | MCP 服务器配置指南 |
| docs/agent-skills.md | Skills 开发指南 |
| docs/permission.md | 权限控制说明 |
| docs/features/feature-roadmap.md | Feature 集成路线图 |
| docs/research/ | 技术调研报告 |
欢迎贡献代码!以下是参与方式:
# 克隆仓库
git clone https://github.com/asdshuaishuai/deepcode-cli.git
cd deepcode-cli
# 安装依赖
npm install
# 运行测试
npm test
# core 构建
npm run build
# 桌面客户端本地开发
npm run desktop:dev提交前检查:
- 确保
npm run check通过(类型检查 + lint + 格式检查) - 建议先执行
npm run format自动格式化代码
- 仓库 Issues:https://github.com/asdshuaishuai/deepcode-cli/issues
- 文档:查看 docs/ 目录
本项目采用 MIT License 开源。
- DeepOrca 源自 Deep Code(Copyright (c) 2026 lessweb,MIT License)。
- 根据 MIT 协议条款,本仓库完整保留原始版权声明与许可声明;你在使用、修改或分发本项目(及其实质部分)时,也需保留 LICENSE 中的版权声明与许可声明。
- 软件按“原样”提供,不附带任何形式的担保,详见协议全文。
如果你觉得 DeepOrca 对你有帮助,请考虑:
- ⭐ 在仓库给我们一个 Star
- 🐛 提交 Bug 报告和功能建议
- 📢 分享给你的朋友和同事
- 🤝 贡献代码和文档