CodeDeeper 组织介绍

一、组织概述

CodeDeeper 是一个专注于 AI 驱动开发工具的开放技术组织，致力于将前沿的大语言模型（LLM）能力深度集成到开发者日常工作流中。我们的旗舰产品是一款面向 VSCode 的 AI 驱动开发助手插件，将完整的 AI 代理团队带入编辑器内部。

二、项目定位与愿景

2.1 项目定位

CodeDeeper 是一款集成在编辑器中的 AI 代理团队，而非简单的代码补全工具。它通过多模式 AI 代理系统、20+ 开发工具集、30+ 模型提供商支持和深度 VSCode 集成，覆盖软件开发的完整生命周期。

2.2 核心差异

2.3 技术愿景

• 全栈 AI 代理：从需求分析到架构设计、编码实现、调试测试、打包发布的全链路 AI 辅助
• 开放生态：支持任意 LLM 提供商、MCP 协议标准、自定义工具扩展
• 开发者优先：所有功能围绕开发者实际工作流设计，不离开编辑器完成一切
• 国际原生：从第一天起支持 18+ 语言，降低全球开发者使用门槛

三、核心功能矩阵

3.1 🧠 多模式 AI 代理系统

CodeDeeper 提供 9 种专业工作模式，覆盖软件开发全生命周期：

模式系统架构详见：交互模式定义体系

3.2 🤖 AI 模型提供商生态

集成业界最广泛的 AI 模型提供商，覆盖云端与本地：

海外提供商：

• Anthropic — Claude Opus / Sonnet / Haiku 全系列
• OpenAI — GPT-4o / o1 / o3 / GPT-4.1 系列 + OpenAI Codex
• Google — Gemini 全系列（含 Vertex AI）
• AWS Bedrock — 通过 AWS 调用各类基础模型
• Mistral / xAI(Grok) / Fireworks / Together / Sambanova
• OpenRouter — 统一模型路由网关
• Requesty / Unbound / Poe / Baseten

国内提供商：

• 阿里云百炼 (Qwen) — 通义千问系列
• 智谱 (Zhipu) — GLM 系列
• Moonshot — 月之暗面
• Minimax
• DeepSeek（火山引擎） — 通过 Vercel AI Gateway

本地推理：

• Ollama — 本地运行开源模型
• LM Studio — 本地模型推理
• VSCode LM — VSCode 内置语言模型 API

3.3 🛠️ 20+ 工具系统

3.4 🧩 MCP 协议支持

全面支持 Model Context Protocol 标准：

• MCP 服务端集成 — 无缝接入任意 MCP 服务器，扩展 AI 工具能力边界
• MCP 客户端管理 — 通过 McpServerManager 管理多服务器连接
• Webview 管理界面 — 可视化配置和管理 MCP 服务器（启停/编辑/新增/删除）
• 传输模式 — 支持 stdio 和 SSE 两种通信模式

3.5 📸 检查点系统

基于 Git 的任务检查点机制，提供完整的变更追踪与恢复能力：

• 自动快照 — 每个关键操作自动创建 Git 检查点
• 时间旅行 — 回滚到任意历史检查点
• 差异对比 — 检查点间的文件变更对比（VSCode 原生 Diff View）
• 导航控制 — 检查点时间轴中的向前/向后导航
• 实现位于 src/core/checkpoints/index.ts

3.6 🌳 Git 工作树集成

内置 Git Worktree 管理能力，实现并行任务隔离：

• 为每个任务创建独立的工作树
• 自动切换和打开工作树
• 与任务检查点系统深度集成
• 实现位于 packages/core/src/worktree

3.7 🔍 代码索引与智能搜索

基于向量嵌入和 Tree-sitter 的高效代码理解：

• 代码索引 — 多线程代码索引管道，支持增量更新和文件监听
• 向量搜索 — 基于 Qdrant 的语义代码搜索，支持自然语言查询
• 嵌入引擎 — 支持多种嵌入模型提供商
• Tree-sitter 解析 — 精确的 AST 级代码结构分析
• 实现位于 src/services/code-index 和 src/services/tree-sitter

3.8 📝 智能上下文管理

• @ 引用系统 — 在对话中引用文件、终端输出、问题面板和 URL
• 上下文追踪 — 自动追踪文件变更和访问历史
• 上下文窗口管理 — 智能处理上下文窗口超限，支持自动压缩
• 历史压缩 — 长对话的历史消息自动分级压缩（3 层策略）

3.9 🔒 安全与审批控制

• 精细化权限控制 — 可配置允许/禁止执行的命令列表（全局/项目级）
• 自动审批 — 选择性启用工具自动批准，支持按天频次限制
• 命令超时保护 — 可配置的命令执行超时机制（默认 300s）
• 文件保护 — .codedeeperignore 文件忽略规则，防止 AI 修改关键文件
• 提示保护 — 敏感操作保护和确认机制

3.10 🌍 国际化

支持 18+ 语言 的完整国际化：

国际化架构：

• 扩展端 — 基于 i18next，locale 文件位于 src/i18n/locales/{lang}/{namespace}.json
• WebView 端 — 基于 react-i18next，locale 文件位于 webview-ui/src/i18n/locales/{lang}/{namespace}.json
• 每个语言包含 8 个 namespace：common, chat, settings, mcp, history, welcome, worktrees, prompts

3.11 🧩 Webview UI

基于 React 18 + Tailwind CSS + Vite 构建的现代化单页应用：

3.12 ⚡ 自定义工具系统

允许扩展自定义工具，拓展 AI 代理能力：

• 工具注册表 — 通过 CustomToolRegistry 注册运行时自定义工具
• Esbuild 运行时 — 使用 esbuild 打包和运行自定义工具（支持 ts/js）
• 类型安全 — 完整的 TypeScript 类型定义，含 Zod schema 校验
• 多文件支持 — 支持单文件工具和依赖多文件工具的复杂工具

3.13 🖥️ 终端深度集成

• 终端内容添加 — 将终端输出添加到 AI 对话上下文
• 命令修复 — AI 自动分析和修复错误命令
• 命令解释 — 解释终端命令的含义和作用
• 终端注册 — 统一的终端会话管理

四、技术架构

4.1 工程架构概览

codedeeper-vscode (monorepo)
├── src/               ← VSCode 扩展主包（esbuild 构建）
│   ├── activate/      ── 激活模块（命令注册/Provider/CodeAction）
│   ├── core/          ── 核心业务逻辑（不依赖 VSCode API）
│   ├── services/      ── 后端服务（MCP/检查点/代码索引/Tree-sitter）
│   ├── integrations/  ── VSCode API 适配层
│   ├── api/           ── 外部 API 提供者（LLM 提供商封装）
│   ├── i18n/          ── 扩展端国际化（i18next）
│   ├── workers/       ── Web Worker（token 计数等耗时计算）
│   ├── utils/         ── 无状态工具函数
│   └── shared/        ── 跨模块共享（模式查询/工具组定义）
│
├── webview-ui/        ← React SPA（Vite + Tailwind CSS）
│   └── src/
│       ├── components/  ── UI 组件（历史/模式/工作树/设置/对话）
│       ├── context/     ── 状态管理（ExtensionStateContext）
│       ├── hooks/       ── 自定义 Hooks
│       ├── i18n/        ── 前端国际化（react-i18next）
│       └── utils/       ── 工具函数（vscode.ts/ipc.ts/docLinks.ts）
│
├── packages/          ← 共享库
│   ├── types/         ── 共享 TypeScript 类型 + Zod schemas（含 20+ 模型提供商定义）
│   ├── core/          ── 平台无关核心逻辑（工作树/自定义工具/消息工具）
│   ├── ipc/           ── IPC 通信协议封装（请求/响应 + 事件推送）
│   ├── vscode-shim/   ── VSCode API 轻量模拟（单元测试用）
│   └── build/         ── 构建工具复用（copy-assets.mjs）
│
├── apps/              ← 附加应用
│   ├── cli/           ── CLI 命令行工具
│   └── vscode-e2e/    ── E2E 端到端测试（Playwright）
│
└── schemas/           ← JSON Schema（自动从 Zod Schema 生成）

4.2 构建体系

4.3 通信架构

┌───────────────────────────────────────────┐
│                VSCode Extension            │
│  ┌─────────┐  ┌──────────┐  ┌──────────┐  │
│  │ activate │→│  core/   │→│ services/ │  │
│  │ 模块注册  │  │ 业务逻辑  │  │ MCP/检查点   │  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  │
│       │             │             │         │
│       ▼             ▼             ▼         │
│  ┌──────────────────────────────────────┐   │
│  │           integrations/              │   │
│  │  VSCode API 适配层 (window/workspace) │   │
│  └──────────────┬───────────────────────┘   │
│                 │                           │
│         postMessage (IPC)                   │
│                 │                           │
│                 ▼                           │
│  ┌──────────────────────────────────────┐   │
│  │       Webview (React SPA)            │   │
│  │  ┌────────┐ ┌────────┐ ┌──────────┐ │   │
│  │  │ 对话面板 │ │ 设置    │ │ MCP/历史  │ │   │
│  │  └────────┘ └────────┘ └──────────┘ │   │
│  └──────────────────────────────────────┘   │
│                                             │
│  ┌──────────────────────────────────────┐   │
│  │      API Providers (30+)             │   │
│  │  Anthropic/OpenAI/Google/DeepSeek... │   │
│  └──────────────────────────────────────┘   │
└───────────────────────────────────────────┘

4.4 依赖方向铁律

webview-ui ← packages/types
    ↓ (postMessage)
src/activate → src/services → src/core
src/activate → src/integrations → VSCode API
src/activate → src/workers (Worker 线程)
packages/ipc → packages/types

⚠️ 核心约束：src/core/ 不依赖 vscode 模块，src/integrations/ 封装 VSCode API 供上层调用。

五、配置与自定义

5.1 模式自定义

支持两层自定义模式来源：

项目级：.codedeeper/modes/（YAML/JSON，位于项目根目录）
    ↓（优先级高）
全局级：~/.codedeeper/codedeeper-settings.json → customModes 数组

自定义模式支持：

• 自定义角色定义（roleDefinition）
• 自定义工具组和文件访问规则
• 项目级自定义指令（.codedeeper/modes/{slug}/）
• 模式配置导出/导入

5.2 工具自定义

通过 CustomToolRegistry 扩展 AI 代理的工具能力，支持 esbuild 运行时编译执行。

5.3 MCP 工具自定义

通过 MCP 协议标准扩展任意外部工具，支持 stdio 和 SSE 传输模式。

5.4 安全规则自定义

支持配置：

• 允许/禁止的命令列表（通配符支持）
• 自动审批白名单
• 文件保护规则（.codedeeperignore）
• 命令执行超时时间

六、国际化与社区

6.1 国际化策略

• 核心语言：英语（源语言）+ 简体中文
• 全量翻译语言：日语、韩语、法语、德语、西班牙语、葡萄牙语（巴西）、俄语
• 社区贡献语言：意大利语、波兰语、荷兰语、土耳其语、越南语、加泰罗尼亚语、印地语、印尼语、繁体中文
• 每语言 8 个 namespace：common, chat, settings, mcp, history, welcome, worktrees, prompts

6.2 社区贡献

• 翻译资源完全开源，支持社区 PR 贡献
• 文档站点托管于 GitHub Pages，支持多语言文档
• Issue 和 PR 流程通过 GitHub 管理

七、开源与许可

• 开源协议：Apache 2.0
• 源码地址：https://github.com/CodeDeeper/CodeDeeper
• Issue 跟踪：https://github.com/CodeDeeper/CodeDeeper/issues
• Evals 评测：https://github.com/CodeDeeper/CodeDeeper-Evals

致谢

CodeDeeper 衍生自 Roo Code，在此向 Roo Code 开发团队致以最诚挚的敬意。随着原项目的遗憾关停，我们希望通过 CodeDeeper 延续其技术愿景。

同时推荐关注 Zoo Code — 作为 Roo Code 关停后的社区接力项目，秉承原项目的初心与方向，继续为开发者社区注入新的活力。

八、版本历史

详见 CHANGELOG.md

文档版本: 1.0.0
最后更新: 2026-06-30
维护者: CodeDeeper Team