更新README文件
This commit is contained in:
xintaofei
195
README.md
195
README.md
@@ -5,86 +5,79 @@
|
|||||||
[](https://tauri.app/)
|
[](https://tauri.app/)
|
||||||
[](https://nextjs.org/)
|
[](https://nextjs.org/)
|
||||||
|
|
||||||
Codeg（Code Generation）是一个面向多 Agent 的企业级代码生成工作台。
|
<p>
|
||||||
它把不同 AI 编码代理（Claude Code、Codex CLI、OpenCode、Gemini CLI 等）统一到一个桌面应用里，支持会话聚合、并行 worktree 开发、MCP 与 Skills 管理，以及 Git/文件/终端一体化操作。
|
<strong>English</strong> |
|
||||||
|
<a href="./docs/readme/README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./docs/readme/README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./docs/readme/README.ja.md">日本語</a> |
|
||||||
|
<a href="./docs/readme/README.ko.md">한국어</a> |
|
||||||
|
<a href="./docs/readme/README.es.md">Español</a> |
|
||||||
|
<a href="./docs/readme/README.de.md">Deutsch</a> |
|
||||||
|
<a href="./docs/readme/README.fr.md">Français</a> |
|
||||||
|
<a href="./docs/readme/README.pt.md">Português</a> |
|
||||||
|
<a href="./docs/readme/README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg (Code Generation) is an enterprise-grade multi-agent coding workspace.
|
||||||
|
It unifies local AI coding agents (Claude Code, Codex CLI, OpenCode, Gemini CLI,
|
||||||
|
etc.) in one desktop app with session aggregation, parallel `git worktree`
|
||||||
|
development, MCP/Skills management, and integrated Git/file/terminal workflows.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
> 当前版本：`v0.0.x`（快速迭代中，适合早期体验与共建）
|
> Current status: `v0.0.x` (fast iteration, suitable for early adopters)
|
||||||
|
|
||||||
## 项目定位
|
## Highlights
|
||||||
|
|
||||||
Codeg 的目标不是“又一个聊天窗口”，而是：
|
- Unified multi-agent workspace in the same project
|
||||||
|
- Local session ingestion with structured rendering
|
||||||
|
- Parallel development with built-in `git worktree` flows
|
||||||
|
- MCP management (local scan + registry search/install)
|
||||||
|
- Skills management (global and project scope)
|
||||||
|
- Integrated engineering loop (file tree, diff, git changes, commit, terminal)
|
||||||
|
|
||||||
- 面向真实研发场景的企业级代码生成工作台
|
## Supported Scope
|
||||||
- 统一多代理协作入口
|
|
||||||
- 支持多分支 / worktree 并发任务开发
|
|
||||||
- 在单个项目上下文中聚合会话、变更、提交与执行链路
|
|
||||||
- 逐步演进为稳定高效的 Agent Code Generation Workspace
|
|
||||||
|
|
||||||
## 核心亮点
|
### 1) Session Ingestion (historical sessions)
|
||||||
|
|
||||||
- 多 Agent 统一工作台：同一项目内可同时使用不同代理并行对话
|
| Agent | Environment Variable Path | macOS / Linux Default | Windows Default |
|
||||||
- 本地会话聚合：导入并查看本机历史会话，统一结构化渲染（消息、工具调用、Token、上下文窗口）
|
|
||||||
- Worktree 并发开发：内置 `git worktree` 流程，支持多窗口并行任务
|
|
||||||
- MCP 管理中心：扫描本地 MCP，支持官方 Registry 与 Smithery 搜索/安装
|
|
||||||
- Skills 管理：支持全局 / 项目级 Skills 的查看、编辑、保存与删除
|
|
||||||
- 工程操作闭环：文件树、Diff、Git 变更、Git Log、提交窗口、内置终端、项目命令
|
|
||||||
|
|
||||||
## 能力矩阵
|
|
||||||
|
|
||||||
| 模块 | 当前状态 | 说明 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 本地会话解析与导入 | ✅ | 已支持 Claude Code / Codex / OpenCode / Gemini CLI |
|
|
||||||
| ACP 实时连接与对话 | ✅ | 已支持 20+ Agent 适配（npx/uvx/二进制） |
|
|
||||||
| Worktree 并发开发 | ✅ | 分支管理 + `git_worktree_add` + 多文件夹窗口 |
|
|
||||||
| MCP 管理 | ✅ | 本地扫描 + Marketplace 搜索/安装（Official + Smithery） |
|
|
||||||
| Skills 管理 | ✅ | 已支持 Claude/Codex/OpenCode/Gemini/OpenClaw |
|
|
||||||
| 文件工作区 | ✅ | 预览、编辑、Diff、保存、冲突对比 |
|
|
||||||
|
|
||||||
## 支持范围
|
|
||||||
|
|
||||||
### 1) 会话解析（历史会话聚合）
|
|
||||||
|
|
||||||
| Agent | 环境变量优先路径 | macOS / Linux 默认路径 | Windows 默认路径 |
|
|
||||||
| --- | --- | --- | --- |
|
| --- | --- | --- | --- |
|
||||||
| Claude Code | `$CLAUDE_CONFIG_DIR/projects` | `~/.claude/projects` | `%USERPROFILE%\\.claude\\projects` |
|
| Claude Code | `$CLAUDE_CONFIG_DIR/projects` | `~/.claude/projects` | `%USERPROFILE%\\.claude\\projects` |
|
||||||
| Codex CLI | `$CODEX_HOME/sessions` | `~/.codex/sessions` | `%USERPROFILE%\\.codex\\sessions` |
|
| 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` |
|
| 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` |
|
| Gemini CLI | `$GEMINI_CLI_HOME/.gemini` | `~/.gemini` | `%USERPROFILE%\\.gemini` |
|
||||||
|
|
||||||
> 说明：以上默认路径按当前实现的回退逻辑整理，实际以环境变量为准。
|
> Note: environment variables take precedence over fallback paths.
|
||||||
|
|
||||||
### 2) ACP 连接（实时 Agent 会话）
|
### 2) ACP real-time sessions
|
||||||
|
|
||||||
当前注册表内置：
|
Built-in registry includes 20+ adapters, such as Claude Code, Codex CLI,
|
||||||
|
Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, and others.
|
||||||
|
|
||||||
`Auggie, Autohand, Claude Code, Cline, Codebuddy Code, Codex CLI, Corust Agent, Factory Droid, Gemini CLI, GitHub Copilot, goose, Junie, Kimi CLI, Minion Code, Mistral Vibe, OpenClaw, OpenCode, Qoder CLI, Qwen Code, Stakpak`
|
### 3) Skills settings support
|
||||||
|
|
||||||
### 3) Skills 设置页支持
|
- Supported: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||||
|
- More adapters will be added incrementally
|
||||||
|
|
||||||
- 已支持：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
### 4) MCP target apps
|
||||||
- 其他代理：后续逐步补齐
|
|
||||||
|
|
||||||
### 4) MCP 目标应用
|
Current writable targets:
|
||||||
|
|
||||||
当前可写入配置：
|
|
||||||
|
|
||||||
- Claude Code
|
- Claude Code
|
||||||
- Codex
|
- Codex
|
||||||
- OpenCode
|
- OpenCode
|
||||||
|
|
||||||
## 快速开始
|
## Quick Start
|
||||||
|
|
||||||
### 环境要求
|
### Requirements
|
||||||
|
|
||||||
- Node.js `>=22`（推荐）
|
- Node.js `>=22` (recommended)
|
||||||
- pnpm `>=10`
|
- pnpm `>=10`
|
||||||
- Rust stable（2021 edition）
|
- Rust stable (2021 edition)
|
||||||
- Tauri 2 构建依赖（参考官方文档）
|
- Tauri 2 build dependencies
|
||||||
|
|
||||||
Linux（Debian/Ubuntu）常见依赖示例：
|
Linux (Debian/Ubuntu) example:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo apt-get update
|
sudo apt-get update
|
||||||
@@ -95,44 +88,33 @@ sudo apt-get install -y \
|
|||||||
patchelf
|
patchelf
|
||||||
```
|
```
|
||||||
|
|
||||||
### 安装与开发
|
### Development
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pnpm install
|
pnpm install
|
||||||
|
|
||||||
# 启动完整桌面应用（Tauri + Next.js）
|
# Full desktop app (Tauri + Next.js)
|
||||||
pnpm tauri dev
|
pnpm tauri dev
|
||||||
|
|
||||||
# 仅启动前端
|
# Frontend only
|
||||||
pnpm dev
|
pnpm dev
|
||||||
|
|
||||||
# 前端构建（静态导出到 out/）
|
# Frontend static export to out/
|
||||||
pnpm build
|
pnpm build
|
||||||
|
|
||||||
# 构建桌面应用
|
# Desktop build
|
||||||
pnpm tauri build
|
pnpm tauri build
|
||||||
|
|
||||||
# Lint
|
# Lint
|
||||||
pnpm lint .
|
pnpm eslint .
|
||||||
|
|
||||||
# Rust 检查（在 src-tauri/ 目录）
|
# Rust checks (run in src-tauri/)
|
||||||
cargo check
|
cargo check
|
||||||
cargo clippy
|
cargo clippy
|
||||||
cargo build
|
cargo build
|
||||||
```
|
```
|
||||||
|
|
||||||
> 当前仓库尚未配置完整自动化测试框架（已有部分 Rust 单元测试）。
|
## Architecture
|
||||||
|
|
||||||
## 使用流程（建议）
|
|
||||||
|
|
||||||
1. 在欢迎页打开本地目录，或 Clone 仓库。
|
|
||||||
2. 进入 `Settings > Agents`，执行 Preflight、安装/配置代理。
|
|
||||||
3. 在分支菜单创建分支或 Worktree，启动并行任务窗口。
|
|
||||||
4. 新建会话并选择 Agent 开始编码。
|
|
||||||
5. 在右侧面板查看会话文件改动、Git Changes、Git Log。
|
|
||||||
6. 使用提交窗口完成选择文件、编辑提交信息与提交。
|
|
||||||
|
|
||||||
## 架构概览
|
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Next.js 16 (Static Export) + React 19
|
Next.js 16 (Static Export) + React 19
|
||||||
@@ -140,81 +122,28 @@ Next.js 16 (Static Export) + React 19
|
|||||||
| invoke()
|
| invoke()
|
||||||
v
|
v
|
||||||
Tauri 2 Commands (Rust)
|
Tauri 2 Commands (Rust)
|
||||||
|- ACP Manager (agent lifecycle, streaming events, permissions)
|
|- ACP Manager
|
||||||
|- Parsers (local session ingestion)
|
|- Parsers (local session ingestion)
|
||||||
|- Git / File Tree / Terminal runtime
|
|- Git / File Tree / Terminal runtime
|
||||||
|- MCP marketplace + local config writer
|
|- MCP marketplace + local config writer
|
||||||
|- SeaORM + SQLite (folders, conversations, settings)
|
|- SeaORM + SQLite
|
||||||
|
|
|
|
||||||
v
|
v
|
||||||
Local Filesystem / Local Agent Data / Git Repos
|
Local Filesystem / Local Agent Data / Git Repos
|
||||||
```
|
```
|
||||||
|
|
||||||
## 目录结构
|
## Constraints
|
||||||
|
|
||||||
```text
|
- Frontend uses static export (`output: "export"`)
|
||||||
src/ # Next.js 前端
|
- No Next.js dynamic routes (`[param]`); use query params instead
|
||||||
app/ # 页面与布局（静态导出模式）
|
- Tauri command params: frontend `camelCase`, Rust `snake_case`
|
||||||
components/ # 业务组件 + UI 组件
|
- TypeScript strict mode
|
||||||
contexts/ # 全局状态（会话、终端、工作区等）
|
|
||||||
lib/ # Tauri 调用封装、类型与工具
|
|
||||||
|
|
||||||
src-tauri/src/ # Rust 后端
|
## Privacy & Security
|
||||||
acp/ # Agent Connection Protocol 连接管理
|
|
||||||
commands/ # 暴露给前端的 Tauri 命令
|
|
||||||
parsers/ # 各代理会话解析器
|
|
||||||
db/ # SQLite/SeaORM 与迁移
|
|
||||||
terminal/ # PTY 终端管理
|
|
||||||
network/ # 代理等网络设置
|
|
||||||
```
|
|
||||||
|
|
||||||
## 开发约束
|
- Local-first by default for parsing, storage, and project operations
|
||||||
|
- Network access happens only on user-triggered actions
|
||||||
- 前端为静态导出模式（`next.config.ts` 中 `output: "export"`）
|
- System proxy support for enterprise environments
|
||||||
- 不使用 Next.js 动态路由（`[param]`），统一使用查询参数
|
|
||||||
- Tauri 命令参数：前端 `camelCase`，Rust 端 `snake_case`
|
|
||||||
- TypeScript 严格模式（`strict` + noUnused）
|
|
||||||
|
|
||||||
## 本地数据存储
|
|
||||||
|
|
||||||
- 应用数据库：`appDataDir/codeg.db`（SQLite + WAL）
|
|
||||||
- 会话原始数据：直接读取各 Agent 本地目录/文件，不做云端中转
|
|
||||||
- 可导入会话：按“支持范围”中的路径规则扫描并写入本地数据库索引
|
|
||||||
|
|
||||||
## 产品路线图
|
|
||||||
|
|
||||||
### Near-term
|
|
||||||
|
|
||||||
- 会话解析扩展到更多代理格式（统一抽象与插件化注册）
|
|
||||||
- MCP 安装管理（版本锁定、配置模板、环境校验）
|
|
||||||
- Skills 模板中心（可复用模板、项目级分发）
|
|
||||||
|
|
||||||
### Mid-term
|
|
||||||
|
|
||||||
- 多 Agent 协同编排（任务拆分、角色分工、结果合并）
|
|
||||||
- Worktree 任务面板（任务状态、上下游依赖、可视化流转）
|
|
||||||
- 团队级配置同步（Agent/MCP/Skills 配置分发）
|
|
||||||
|
|
||||||
### Long-term
|
|
||||||
|
|
||||||
- 插件化扩展机制（Parser / MCP / Skills 生态）
|
|
||||||
- 指标看板增强（Token/成本/时延/成功率）
|
|
||||||
- 组织级知识沉淀：会话资产化、检索、复盘与最佳实践沉淀
|
|
||||||
|
|
||||||
## 隐私与安全
|
|
||||||
|
|
||||||
- 默认以本地数据为主：会话解析、数据库与项目操作均在本机执行
|
|
||||||
- 仅在你主动使用时访问网络（如 Agent 安装、MCP 市场搜索、Git 远程操作）
|
|
||||||
- 支持系统代理配置，便于企业网络环境接入
|
|
||||||
|
|
||||||
## 贡献
|
|
||||||
|
|
||||||
欢迎通过 Issue / PR 共建，建议优先从以下方向参与：
|
|
||||||
|
|
||||||
- 新代理会话解析器
|
|
||||||
- MCP 兼容层与配置适配
|
|
||||||
- Worktree 并行开发体验优化
|
|
||||||
- 会话可视化与指标面板优化
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|||||||
65
docs/readme/README.ar.md
Normal file
65
docs/readme/README.ar.md
Normal file
@@ -0,0 +1,65 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<strong>العربية</strong>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg (Code Generation) هو مساحة عمل مؤسسية لتوليد الشفرة باستخدام عدة
|
||||||
|
وكلاء Agent.
|
||||||
|
يوحّد الوكلاء المحليين مثل Claude Code وCodex CLI وOpenCode وGemini CLI داخل
|
||||||
|
تطبيق سطح مكتب واحد، مع تجميع الجلسات، وتطوير متوازي عبر `git worktree`،
|
||||||
|
وإدارة MCP/Skills، وسير عمل متكامل لـ Git/الملفات/الطرفية.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> الإصدار الحالي: `v0.0.x` (تطوير سريع)
|
||||||
|
|
||||||
|
## أبرز المزايا
|
||||||
|
|
||||||
|
- مساحة عمل موحّدة لعدة Agent
|
||||||
|
- تجميع محلي للجلسات مع عرض منظّم
|
||||||
|
- تطوير متوازي باستخدام `git worktree`
|
||||||
|
- إدارة MCP (فحص محلي + بحث/تثبيت)
|
||||||
|
- إدارة Skills (عام وعلى مستوى المشروع)
|
||||||
|
|
||||||
|
## البدء السريع
|
||||||
|
|
||||||
|
### المتطلبات
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable (2021 edition)
|
||||||
|
- تبعيات بناء Tauri 2
|
||||||
|
|
||||||
|
### الأوامر
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# شغّل داخل src-tauri/
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## الترخيص
|
||||||
|
|
||||||
|
Apache-2.0. راجع `LICENSE`.
|
||||||
66
docs/readme/README.de.md
Normal file
66
docs/readme/README.de.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<strong>Deutsch</strong> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg (Code Generation) ist ein Enterprise-Workspace für Code-Generierung mit
|
||||||
|
mehreren Agenten.
|
||||||
|
Lokale KI-Coding-Agenten wie Claude Code, Codex CLI, OpenCode und Gemini CLI
|
||||||
|
werden in einer Desktop-App zusammengeführt: mit Sitzungsaggregation,
|
||||||
|
paralleler `git worktree`-Entwicklung, MCP/Skills-Verwaltung und integriertem
|
||||||
|
Git/Datei/Terminal-Workflow.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> Aktuelle Version: `v0.0.x` (schnelle Iteration)
|
||||||
|
|
||||||
|
## Highlights
|
||||||
|
|
||||||
|
- Einheitlicher Multi-Agent-Workspace
|
||||||
|
- Lokale Sitzungsaggregation mit strukturierter Darstellung
|
||||||
|
- Parallele Entwicklung mit `git worktree`
|
||||||
|
- MCP-Verwaltung (lokaler Scan + Suche/Installation)
|
||||||
|
- Skills-Verwaltung (global und projektbezogen)
|
||||||
|
|
||||||
|
## Schnellstart
|
||||||
|
|
||||||
|
### Voraussetzungen
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable (2021 edition)
|
||||||
|
- Tauri-2-Build-Abhängigkeiten
|
||||||
|
|
||||||
|
### Befehle
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# In src-tauri/ ausführen
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## Lizenz
|
||||||
|
|
||||||
|
Apache-2.0. Siehe `LICENSE`.
|
||||||
66
docs/readme/README.es.md
Normal file
66
docs/readme/README.es.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<strong>Español</strong> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg (Code Generation) es un espacio de trabajo empresarial para generación de
|
||||||
|
código con múltiples Agent.
|
||||||
|
Integra agentes locales como Claude Code, Codex CLI, OpenCode y Gemini CLI en
|
||||||
|
una sola aplicación de escritorio, con agregación de sesiones, desarrollo
|
||||||
|
paralelo con `git worktree`, gestión de MCP/Skills y flujo integrado de
|
||||||
|
Git/archivos/terminal.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> Versión actual: `v0.0.x` (iteración rápida)
|
||||||
|
|
||||||
|
## Puntos clave
|
||||||
|
|
||||||
|
- Espacio de trabajo unificado para múltiples Agent
|
||||||
|
- Agregación local de sesiones con vista estructurada
|
||||||
|
- Desarrollo paralelo con `git worktree`
|
||||||
|
- Gestión MCP (escaneo local + búsqueda/instalación)
|
||||||
|
- Gestión de Skills (global y por proyecto)
|
||||||
|
|
||||||
|
## Inicio rápido
|
||||||
|
|
||||||
|
### Requisitos
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable (2021 edition)
|
||||||
|
- Dependencias de build para Tauri 2
|
||||||
|
|
||||||
|
### Comandos
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# Ejecutar en src-tauri/
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## Licencia
|
||||||
|
|
||||||
|
Apache-2.0. Ver `LICENSE`.
|
||||||
66
docs/readme/README.fr.md
Normal file
66
docs/readme/README.fr.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<strong>Français</strong> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg (Code Generation) est un workspace de génération de code multi-Agent de
|
||||||
|
niveau entreprise.
|
||||||
|
Il unifie des agents locaux comme Claude Code, Codex CLI, OpenCode et Gemini
|
||||||
|
CLI dans une application desktop avec agrégation des sessions, développement
|
||||||
|
parallèle via `git worktree`, gestion MCP/Skills et workflow intégré
|
||||||
|
Git/fichiers/terminal.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> Version actuelle : `v0.0.x` (itération rapide)
|
||||||
|
|
||||||
|
## Points forts
|
||||||
|
|
||||||
|
- Workspace unifié pour plusieurs Agent
|
||||||
|
- Agrégation locale des sessions avec affichage structuré
|
||||||
|
- Développement parallèle avec `git worktree`
|
||||||
|
- Gestion MCP (scan local + recherche/installation)
|
||||||
|
- Gestion des Skills (global et projet)
|
||||||
|
|
||||||
|
## Démarrage rapide
|
||||||
|
|
||||||
|
### Prérequis
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable (2021 edition)
|
||||||
|
- Dépendances de build Tauri 2
|
||||||
|
|
||||||
|
### Commandes
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# Exécuter dans src-tauri/
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## Licence
|
||||||
|
|
||||||
|
Apache-2.0. Voir `LICENSE`.
|
||||||
83
docs/readme/README.ja.md
Normal file
83
docs/readme/README.ja.md
Normal file
@@ -0,0 +1,83 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<strong>日本語</strong> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg（Code Generation）は、複数 Agent 向けのエンタープライズ級コード生成ワークスペースです。
|
||||||
|
Claude Code、Codex CLI、OpenCode、Gemini CLI などのローカル AI コーディング Agent を 1 つのデスクトップアプリに統合し、セッション集約、並列 `git worktree` 開発、MCP/Skills 管理、Git/ファイル/ターミナル連携を提供します。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> 現在のバージョン: `v0.0.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` |
|
||||||
|
|
||||||
|
### 2) ACP リアルタイムセッション
|
||||||
|
|
||||||
|
20 以上の Agent アダプターを内蔵（Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw など）。
|
||||||
|
|
||||||
|
### 3) Skills 設定対応
|
||||||
|
|
||||||
|
- 対応済み: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||||
|
- 他 Agent は順次追加予定
|
||||||
|
|
||||||
|
## クイックスタート
|
||||||
|
|
||||||
|
### 要件
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable（2021 edition）
|
||||||
|
- Tauri 2 のビルド依存
|
||||||
|
|
||||||
|
### 開発コマンド
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# src-tauri/ で実行
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## ライセンス
|
||||||
|
|
||||||
|
Apache-2.0。`LICENSE` を参照してください。
|
||||||
74
docs/readme/README.ko.md
Normal file
74
docs/readme/README.ko.md
Normal file
@@ -0,0 +1,74 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<strong>한국어</strong> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg(Code Generation)는 멀티 Agent를 위한 엔터프라이즈급 코드 생성 워크스페이스입니다.
|
||||||
|
Claude Code, Codex CLI, OpenCode, Gemini CLI 등 로컬 AI 코딩 Agent를 하나의 데스크톱 앱으로 통합하여 세션 집계, 병렬 `git worktree` 개발, MCP/Skills 관리, Git/파일/터미널 통합 워크플로를 제공합니다.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> 현재 버전: `v0.0.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` |
|
||||||
|
|
||||||
|
## 빠른 시작
|
||||||
|
|
||||||
|
### 요구 사항
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable (2021 edition)
|
||||||
|
- Tauri 2 빌드 의존성
|
||||||
|
|
||||||
|
### 개발 명령
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# src-tauri/ 에서 실행
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## 라이선스
|
||||||
|
|
||||||
|
Apache-2.0. `LICENSE` 참고.
|
||||||
65
docs/readme/README.pt.md
Normal file
65
docs/readme/README.pt.md
Normal file
@@ -0,0 +1,65 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<strong>Português</strong> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg (Code Generation) é um workspace empresarial para geração de código com
|
||||||
|
múltiplos Agent.
|
||||||
|
Ele unifica agentes locais como Claude Code, Codex CLI, OpenCode e Gemini CLI
|
||||||
|
em um único app desktop com agregação de sessões, desenvolvimento paralelo com
|
||||||
|
`git worktree`, gestão de MCP/Skills e fluxo integrado de Git/arquivos/terminal.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> Versão atual: `v0.0.x` (iteração rápida)
|
||||||
|
|
||||||
|
## Destaques
|
||||||
|
|
||||||
|
- Workspace unificado para múltiplos Agent
|
||||||
|
- Agregação local de sessões com visualização estruturada
|
||||||
|
- Desenvolvimento paralelo com `git worktree`
|
||||||
|
- Gestão de MCP (varredura local + busca/instalação)
|
||||||
|
- Gestão de Skills (global e por projeto)
|
||||||
|
|
||||||
|
## Início rápido
|
||||||
|
|
||||||
|
### Requisitos
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable (2021 edition)
|
||||||
|
- Dependências de build do Tauri 2
|
||||||
|
|
||||||
|
### Comandos
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# Executar em src-tauri/
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## Licença
|
||||||
|
|
||||||
|
Apache-2.0. Veja `LICENSE`.
|
||||||
115
docs/readme/README.zh-CN.md
Normal file
115
docs/readme/README.zh-CN.md
Normal file
@@ -0,0 +1,115 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<strong>简体中文</strong> |
|
||||||
|
<a href="./README.zh-TW.md">繁體中文</a> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg（Code Generation）是一个面向多 Agent 的企业级代码生成工作台。
|
||||||
|
它把 Claude Code、Codex CLI、OpenCode、Gemini CLI 等本地 AI 编码代理统一到一个桌面应用中，支持会话聚合、并行 `git worktree` 开发、MCP/Skills 管理，以及 Git/文件/终端一体化工作流。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> 当前版本：`v0.0.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` |
|
||||||
|
|
||||||
|
### 2) ACP 实时会话
|
||||||
|
|
||||||
|
内置 20+ Agent 适配器（如 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 等）。
|
||||||
|
|
||||||
|
### 3) Skills 设置页支持
|
||||||
|
|
||||||
|
- 已支持：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||||
|
- 其他代理将持续补齐
|
||||||
|
|
||||||
|
### 4) MCP 目标应用
|
||||||
|
|
||||||
|
当前支持写入：Claude Code、Codex、OpenCode。
|
||||||
|
|
||||||
|
## 快速开始
|
||||||
|
|
||||||
|
### 环境要求
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable（2021 edition）
|
||||||
|
- Tauri 2 构建依赖
|
||||||
|
|
||||||
|
### 开发命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# 在 src-tauri/ 下执行
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## 架构概览
|
||||||
|
|
||||||
|
```text
|
||||||
|
Next.js 16 (Static Export) + React 19
|
||||||
|
|
|
||||||
|
| invoke()
|
||||||
|
v
|
||||||
|
Tauri 2 Commands (Rust)
|
||||||
|
|- ACP Manager
|
||||||
|
|- Parsers
|
||||||
|
|- Git / File Tree / Terminal
|
||||||
|
|- MCP marketplace + local config writer
|
||||||
|
|- SeaORM + SQLite
|
||||||
|
```
|
||||||
|
|
||||||
|
## 开发约束
|
||||||
|
|
||||||
|
- 前端静态导出（`output: "export"`）
|
||||||
|
- 不使用动态路由（`[param]`），统一查询参数
|
||||||
|
- 前端参数 `camelCase`，Rust 参数 `snake_case`
|
||||||
|
- TypeScript strict
|
||||||
|
|
||||||
|
## 隐私与安全
|
||||||
|
|
||||||
|
- 默认本地优先
|
||||||
|
- 仅在用户触发时访问网络
|
||||||
|
- 支持系统代理
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
|
||||||
|
Apache-2.0，详见 `LICENSE`。
|
||||||
115
docs/readme/README.zh-TW.md
Normal file
115
docs/readme/README.zh-TW.md
Normal file
@@ -0,0 +1,115 @@
|
|||||||
|
# Codeg
|
||||||
|
|
||||||
|
[](https://github.com/xintaofei/codeg/releases)
|
||||||
|
[](../../LICENSE)
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="../../README.md">English</a> |
|
||||||
|
<a href="./README.zh-CN.md">简体中文</a> |
|
||||||
|
<strong>繁體中文</strong> |
|
||||||
|
<a href="./README.ja.md">日本語</a> |
|
||||||
|
<a href="./README.ko.md">한국어</a> |
|
||||||
|
<a href="./README.es.md">Español</a> |
|
||||||
|
<a href="./README.de.md">Deutsch</a> |
|
||||||
|
<a href="./README.fr.md">Français</a> |
|
||||||
|
<a href="./README.pt.md">Português</a> |
|
||||||
|
<a href="./README.ar.md">العربية</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Codeg（Code Generation）是面向多 Agent 的企業級程式碼生成工作台。
|
||||||
|
它將 Claude Code、Codex CLI、OpenCode、Gemini CLI 等本地 AI 編碼代理整合到一個桌面應用，支援會話彙整、並行 `git worktree` 開發、MCP/Skills 管理，以及 Git/檔案/終端整合流程。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
> 目前版本：`v0.0.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` |
|
||||||
|
|
||||||
|
### 2) ACP 即時會話
|
||||||
|
|
||||||
|
內建 20+ Agent 適配器（如 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 等）。
|
||||||
|
|
||||||
|
### 3) Skills 設定頁支援
|
||||||
|
|
||||||
|
- 已支援：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
|
||||||
|
- 其他代理持續補齊
|
||||||
|
|
||||||
|
### 4) MCP 目標應用
|
||||||
|
|
||||||
|
目前支援寫入：Claude Code、Codex、OpenCode。
|
||||||
|
|
||||||
|
## 快速開始
|
||||||
|
|
||||||
|
### 環境需求
|
||||||
|
|
||||||
|
- Node.js `>=22`
|
||||||
|
- pnpm `>=10`
|
||||||
|
- Rust stable（2021 edition）
|
||||||
|
- Tauri 2 建置依賴
|
||||||
|
|
||||||
|
### 開發命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pnpm install
|
||||||
|
pnpm tauri dev
|
||||||
|
pnpm dev
|
||||||
|
pnpm build
|
||||||
|
pnpm tauri build
|
||||||
|
pnpm eslint .
|
||||||
|
|
||||||
|
# 在 src-tauri/ 下執行
|
||||||
|
cargo check
|
||||||
|
cargo clippy
|
||||||
|
cargo build
|
||||||
|
```
|
||||||
|
|
||||||
|
## 架構概覽
|
||||||
|
|
||||||
|
```text
|
||||||
|
Next.js 16 (Static Export) + React 19
|
||||||
|
|
|
||||||
|
| invoke()
|
||||||
|
v
|
||||||
|
Tauri 2 Commands (Rust)
|
||||||
|
|- ACP Manager
|
||||||
|
|- Parsers
|
||||||
|
|- Git / File Tree / Terminal
|
||||||
|
|- MCP marketplace + local config writer
|
||||||
|
|- SeaORM + SQLite
|
||||||
|
```
|
||||||
|
|
||||||
|
## 開發約束
|
||||||
|
|
||||||
|
- 前端靜態匯出（`output: "export"`）
|
||||||
|
- 不使用動態路由（`[param]`），改用查詢參數
|
||||||
|
- 前端參數 `camelCase`，Rust 參數 `snake_case`
|
||||||
|
- TypeScript strict
|
||||||
|
|
||||||
|
## 隱私與安全
|
||||||
|
|
||||||
|
- 預設本地優先
|
||||||
|
- 僅在使用者觸發時連網
|
||||||
|
- 支援系統代理
|
||||||
|
|
||||||
|
## 授權
|
||||||
|
|
||||||
|
Apache-2.0，詳見 `LICENSE`。
|
||||||
Reference in New Issue
Block a user