Files
codeg/docs/readme/README.zh-CN.md
2026-03-17 15:50:28 +08:00

4.3 KiB
Raw Blame History

Codeg

Release License Tauri Next.js

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Deutsch | Français | Português | العربية

CodegCode Generation是一个企业级多 Agent 编码工作台。 它将本地 AI 编码代理Claude Code、Codex CLI、OpenCode、Gemini CLI、 OpenClaw 等)统一到一个桌面应用中,支持会话聚合、并行 git worktree 开发、MCP/Skills 管理,以及集成的 Git/文件/终端工作流。

主界面

Codeg Light Codeg Dark

会话平铺显示

Codeg Light Codeg Dark

当前状态:v0.1.x(快速迭代中,适合早期使用者)

核心亮点

  • 同一项目中的多 Agent 统一工作台
  • 本地会话解析与结构化渲染
  • 内置 git worktree 并行开发流程
  • MCP 管理(本地扫描 + 市场搜索/安装)
  • Skills 管理(全局与项目级)
  • 集成工程闭环文件树、Diff、Git 变更、提交、终端)

支持范围

1) 会话解析(历史会话)

Agent 环境变量优先路径 macOS / Linux 默认路径 Windows 默认路径
Claude Code $CLAUDE_CONFIG_DIR/projects ~/.claude/projects %USERPROFILE%\\.claude\\projects
Codex CLI $CODEX_HOME/sessions ~/.codex/sessions %USERPROFILE%\\.codex\\sessions
OpenCode $XDG_DATA_HOME/opencode/opencode.db ~/.local/share/opencode/opencode.db %USERPROFILE%\\.local\\share\\opencode\\opencode.db
Gemini CLI $GEMINI_CLI_HOME/.gemini ~/.gemini %USERPROFILE%\\.gemini
OpenClaw ~/.openclaw/agents %USERPROFILE%\\.openclaw\\agents

注意:环境变量的优先级高于默认路径。

2) ACP 实时会话

内置注册表包含 20+ 适配器,如 Claude Code、Codex CLI、 Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code 等。

3) Skills 设置支持

  • 已支持:Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw
  • 更多适配器将持续补齐

4) MCP 目标应用

当前可写入的目标:

  • Claude Code
  • Codex
  • OpenCode

快速开始

环境要求

  • Node.js >=22(推荐)
  • pnpm >=10
  • Rust stable2021 edition
  • Tauri 2 构建依赖

LinuxDebian/Ubuntu示例

sudo apt-get update
sudo apt-get install -y \
  libwebkit2gtk-4.1-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  patchelf

开发命令

pnpm install

# 完整桌面应用Tauri + Next.js
pnpm tauri dev

# 仅前端
pnpm dev

# 前端静态导出到 out/
pnpm build

# 桌面应用构建
pnpm tauri build

# Lint
pnpm eslint .

# Rust 检查(在 src-tauri/ 下执行)
cargo check
cargo clippy
cargo build

架构

Next.js 16 (Static Export) + React 19
        |
        | invoke()
        v
Tauri 2 Commands (Rust)
  |- ACP Manager
  |- Parsers (local session ingestion)
  |- Git / File Tree / Terminal runtime
  |- MCP marketplace + local config writer
  |- SeaORM + SQLite
        |
        v
Local Filesystem / Local Agent Data / Git Repos

开发约束

  • 前端使用静态导出(output: "export"
  • 不使用 Next.js 动态路由([param]),统一使用查询参数
  • Tauri 命令参数:前端 camelCaseRust snake_case
  • TypeScript strict 模式

隐私与安全

  • 默认本地优先:解析、存储、项目操作均在本地完成
  • 仅在用户主动触发时才访问网络
  • 支持系统代理,适配企业网络环境

许可证

Apache-2.0,详见 LICENSE