更新README文件

2026-03-09 12:18:10 +08:00
parent 2c350866e1
commit 32fbafa1fe
10 changed files with 777 additions and 133 deletions
--- a/docs/readme/README.ar.md
+++ b/docs/readme/README.ar.md
@@ -0,0 +1,65 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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/الملفات/الطرفية.
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> الإصدار الحالي: `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`.
--- a/docs/readme/README.de.md
+++ b/docs/readme/README.de.md
@@ -0,0 +1,66 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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.
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 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`.
--- a/docs/readme/README.es.md
+++ b/docs/readme/README.es.md
@@ -0,0 +1,66 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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.
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 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`.
--- a/docs/readme/README.fr.md
+++ b/docs/readme/README.fr.md
@@ -0,0 +1,66 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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.
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 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`.
--- a/docs/readme/README.ja.md
+++ b/docs/readme/README.ja.md
@@ -0,0 +1,83 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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/ファイル/ターミナル連携を提供します。
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 現在のバージョン: `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` を参照してください。
--- a/docs/readme/README.ko.md
+++ b/docs/readme/README.ko.md
@@ -0,0 +1,74 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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/파일/터미널 통합 워크플로를 제공합니다.
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 현재 버전: `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` 참고.
--- a/docs/readme/README.pt.md
+++ b/docs/readme/README.pt.md
@@ -0,0 +1,65 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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.
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 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`.
--- a/docs/readme/README.zh-CN.md
+++ b/docs/readme/README.zh-CN.md
@@ -0,0 +1,115 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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/文件/终端一体化工作流。
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 当前版本：`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`。
--- a/docs/readme/README.zh-TW.md
+++ b/docs/readme/README.zh-TW.md
@@ -0,0 +1,115 @@
+# Codeg
+
+[![Release](https://img.shields.io/github/v/release/xintaofei/codeg)](https://github.com/xintaofei/codeg/releases)
+[![License](https://img.shields.io/github/license/xintaofei/codeg)](../../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/檔案/終端整合流程。
+
+![Codeg Light](../images/main-light.png#gh-light-mode-only)
+![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)
+
+> 目前版本：`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`。