更新Readme文件

2026-03-17 15:50:28 +08:00
parent f517f4fcbb
commit db4ff9d1ae
10 changed files with 803 additions and 174 deletions
--- a/docs/readme/README.ar.md
+++ b/docs/readme/README.ar.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,57 +18,139 @@
  <strong>العربية</strong>
 </p>

-Codeg (Code Generation) هو مساحة عمل مؤسسية لتوليد الشفرة باستخدام عدة
-وكلاء Agent.
-يوحّد الوكلاء المحليين مثل Claude Code وCodex CLI وOpenCode وGemini CLI داخل
-تطبيق سطح مكتب واحد، مع تجميع الجلسات، وتطوير متوازي عبر `git worktree`،
-وإدارة MCP/Skills، وسير عمل متكامل لـ Git/الملفات/الطرفية.
+Codeg (Code Generation) هو مساحة عمل مؤسسية متعددة الوكلاء للبرمجة.
+يوحّد وكلاء البرمجة المحليين بالذكاء الاصطناعي (Claude Code، Codex CLI، OpenCode، Gemini CLI،
+OpenClaw، وغيرها) في تطبيق سطح مكتب واحد مع تجميع الجلسات، والتطوير المتوازي
+عبر `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)

 ## عرض الجلسات كبلاطات
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> الإصدار الحالي: `v0.1.x` (تطوير سريع)
+> الحالة الحالية: `v0.1.x` (تكرار سريع، مناسب للمتبنين الأوائل)

 ## أبرز المزايا

- مساحة عمل موحّدة لعدة Agent
- تجميع محلي للجلسات مع عرض منظّم
- تطوير متوازي باستخدام `git worktree`
- إدارة MCP (فحص محلي + بحث/تثبيت)
- إدارة Skills (عام وعلى مستوى المشروع)
+- مساحة عمل موحّدة متعددة الوكلاء في نفس المشروع
+- استيعاب محلي للجلسات مع عرض منظّم
+- تطوير متوازي مع تدفقات `git worktree` مدمجة
+- إدارة MCP (فحص محلي + بحث/تثبيت من السجل)
+- إدارة Skills (نطاق عام ونطاق المشروع)
+- حلقة هندسية متكاملة (شجرة الملفات، الفروقات، تغييرات git، الإيداع، الطرفية)
+
+## النطاق المدعوم
+
+### 1) استيعاب الجلسات (الجلسات التاريخية)
+
+| الوكيل | مسار متغير البيئة | الافتراضي في 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`
+- Node.js `>=22` (مُوصى به)
 - pnpm `>=10`
 - Rust stable (2021 edition)
 - تبعيات بناء Tauri 2

-### الأوامر
+مثال على Linux (Debian/Ubuntu):
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### التطوير

 ```bash
 pnpm install
+
+# تطبيق سطح المكتب الكامل (Tauri + Next.js)
 pnpm tauri dev
+
+# الواجهة الأمامية فقط
 pnpm dev
+
+# تصدير ثابت للواجهة الأمامية إلى out/
 pnpm build
+
+# بناء تطبيق سطح المكتب
 pnpm tauri build
+
+# فحص الأكواد
 pnpm eslint .

-# شغّل داخل src-tauri/
+# فحوصات Rust (تنفيذ في 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 (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: `camelCase` في الواجهة الأمامية، `snake_case` في Rust
+- TypeScript في الوضع الصارم
+
+## الخصوصية والأمان
+
+- محلي أولاً بشكل افتراضي للتحليل والتخزين وعمليات المشروع
+- الوصول إلى الشبكة يحدث فقط عند الإجراءات التي يبدأها المستخدم
+- دعم بروكسي النظام لبيئات المؤسسات
+
 ## الترخيص

 Apache-2.0. راجع `LICENSE`.
--- a/docs/readme/README.de.md
+++ b/docs/readme/README.de.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,58 +18,141 @@
  <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 (Code Generation) ist ein unternehmenstauglicher Multi-Agent-Workspace
+für die Programmierung.
+Es vereint lokale KI-Coding-Agenten (Claude Code, Codex CLI, OpenCode,
+Gemini CLI, OpenClaw usw.) in einer Desktop-App mit Sitzungsaggregation,
+paralleler `git worktree`-Entwicklung, MCP/Skills-Verwaltung und integrierten
+Git/Datei/Terminal-Workflows.

 ## Hauptoberfläche
-
 ![Codeg Light](../images/main-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)

 ## Sitzungskachelansicht
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> Aktuelle Version: `v0.1.x` (schnelle Iteration)
+> Aktueller Status: `v0.1.x` (schnelle Iteration, geeignet für Early Adopters)

 ## Highlights

- Einheitlicher Multi-Agent-Workspace
- Lokale Sitzungsaggregation mit strukturierter Darstellung
- Parallele Entwicklung mit `git worktree`
- MCP-Verwaltung (lokaler Scan + Suche/Installation)
+- Einheitlicher Multi-Agent-Workspace im selben Projekt
+- Lokale Sitzungserfassung mit strukturierter Darstellung
+- Parallele Entwicklung mit integrierten `git worktree`-Abläufen
+- MCP-Verwaltung (lokaler Scan + Registry-Suche/Installation)
 - Skills-Verwaltung (global und projektbezogen)
+- Integrierter Engineering-Kreislauf (Dateibaum, Diff, Git-Änderungen, Commit, Terminal)
+
+## Unterstützter Umfang
+
+### 1) Sitzungserfassung (historische Sitzungen)
+
+| Agent | Umgebungsvariablen-Pfad | macOS / Linux Standard | Windows Standard |
+| --- | --- | --- | --- |
+| 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` |
+
+> Hinweis: Umgebungsvariablen haben Vorrang vor Fallback-Pfaden.
+
+### 2) ACP-Echtzeitsitzungen
+
+Das integrierte Registry enthält über 20 Adapter, darunter Claude Code, Codex CLI,
+Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code und weitere.
+
+### 3) Skills-Einstellungen
+
+- Unterstützt: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
+- Weitere Adapter werden schrittweise hinzugefügt
+
+### 4) MCP-Zielanwendungen
+
+Aktuelle beschreibbare Ziele:
+
+- Claude Code
+- Codex
+- OpenCode

 ## Schnellstart

 ### Voraussetzungen

- Node.js `>=22`
+- Node.js `>=22` (empfohlen)
 - pnpm `>=10`
 - Rust stable (2021 edition)
 - Tauri-2-Build-Abhängigkeiten

-### Befehle
+Linux-Beispiel (Debian/Ubuntu):
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### Entwicklung

 ```bash
 pnpm install
+
+# Vollständige Desktop-App (Tauri + Next.js)
 pnpm tauri dev
+
+# Nur Frontend
 pnpm dev
+
+# Frontend-Statikexport nach out/
 pnpm build
+
+# Desktop-Build
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# In src-tauri/ ausführen
+# Rust-Prüfungen (in src-tauri/ ausführen)
 cargo check
 cargo clippy
 cargo build
 ```

+## Architektur
+
+```text
+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
+```
+
+## Einschränkungen
+
+- Frontend verwendet statischen Export (`output: "export"`)
+- Keine dynamischen Next.js-Routen (`[param]`); stattdessen Query-Parameter verwenden
+- Tauri-Befehlsparameter: `camelCase` im Frontend, `snake_case` in Rust
+- TypeScript im strikten Modus
+
+## Datenschutz und Sicherheit
+
+- Standardmäßig lokal für Analyse, Speicherung und Projektoperationen
+- Netzwerkzugriff erfolgt nur bei benutzergesteuerten Aktionen
+- Systemproxy-Unterstützung für Unternehmensumgebungen
+
 ## Lizenz

 Apache-2.0. Siehe `LICENSE`.
--- a/docs/readme/README.es.md
+++ b/docs/readme/README.es.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,58 +18,141 @@
  <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 (Code Generation) es un espacio de trabajo empresarial para codificación
+con múltiples agentes.
+Integra agentes locales de codificación con IA (Claude Code, Codex CLI, OpenCode,
+Gemini CLI, OpenClaw, etc.) en una sola aplicación de escritorio, con agregación
+de sesiones, desarrollo paralelo con `git worktree`, gestión de MCP/Skills y
+flujos integrados de Git/archivos/terminal.

 ## Interfaz principal
-
 ![Codeg Light](../images/main-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)

 ## Vista de mosaico de sesiones
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> Versión actual: `v0.1.x` (iteración rápida)
+> Estado actual: `v0.1.x` (iteración rápida, adecuado para early adopters)

-## Puntos clave
+## Puntos destacados

- 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)
+- Espacio de trabajo unificado para múltiples agentes en el mismo proyecto
+- Ingesta local de sesiones con renderizado estructurado
+- Desarrollo paralelo con flujos integrados de `git worktree`
+- Gestión de MCP (escaneo local + búsqueda/instalación desde registro)
+- Gestión de Skills (ámbito global y por proyecto)
+- Ciclo de ingeniería integrado (árbol de archivos, diff, cambios git, commit, terminal)
+
+## Alcance soportado
+
+### 1) Ingesta de sesiones (sesiones históricas)
+
+| Agente | Ruta de variable de entorno | Ruta por defecto en macOS / Linux | Ruta por defecto en 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` |
+
+> Nota: las variables de entorno tienen prioridad sobre las rutas de respaldo.
+
+### 2) Sesiones en tiempo real con ACP
+
+El registro integrado incluye más de 20 adaptadores, como Claude Code, Codex CLI,
+Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, entre otros.
+
+### 3) Configuración de Skills
+
+- Soportados: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
+- Se añadirán más adaptadores progresivamente
+
+### 4) Aplicaciones destino de MCP
+
+Destinos de escritura actuales:
+
+- Claude Code
+- Codex
+- OpenCode

 ## Inicio rápido

 ### Requisitos

- Node.js `>=22`
+- Node.js `>=22` (recomendado)
 - pnpm `>=10`
 - Rust stable (2021 edition)
- Dependencias de build para Tauri 2
+- Dependencias de compilación de Tauri 2

-### Comandos
+Ejemplo para Linux (Debian/Ubuntu):
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### Desarrollo

 ```bash
 pnpm install
+
+# Aplicación de escritorio completa (Tauri + Next.js)
 pnpm tauri dev
+
+# Solo frontend
 pnpm dev
+
+# Exportación estática del frontend a out/
 pnpm build
+
+# Compilación de escritorio
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# Ejecutar en src-tauri/
+# Verificaciones de Rust (ejecutar en src-tauri/)
 cargo check
 cargo clippy
 cargo build
 ```

+## Arquitectura
+
+```text
+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
+```
+
+## Restricciones
+
+- El frontend usa exportación estática (`output: "export"`)
+- Sin rutas dinámicas de Next.js (`[param]`); se usan parámetros de consulta en su lugar
+- Parámetros de comandos Tauri: `camelCase` en frontend, `snake_case` en Rust
+- TypeScript en modo estricto
+
+## Privacidad y seguridad
+
+- Enfoque local por defecto para análisis, almacenamiento y operaciones de proyecto
+- El acceso a la red solo ocurre mediante acciones iniciadas por el usuario
+- Soporte de proxy del sistema para entornos empresariales
+
 ## Licencia

 Apache-2.0. Ver `LICENSE`.
--- a/docs/readme/README.fr.md
+++ b/docs/readme/README.fr.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,58 +18,139 @@
  <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 (Code Generation) est un workspace de codage multi-agents de niveau entreprise.
+Il unifie les agents de codage IA locaux (Claude Code, Codex CLI, OpenCode, Gemini CLI,
+OpenClaw, etc.) dans une seule application de bureau avec agrégation de sessions, développement
+parallèle via `git worktree`, gestion MCP/Skills et workflows intégrés Git/fichiers/terminal.

 ## Interface principale
-
 ![Codeg Light](../images/main-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)

 ## Affichage en tuiles des sessions
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> Version actuelle : `v0.1.x` (itération rapide)
+> Statut actuel : `v0.1.x` (itération rapide, adapté aux utilisateurs précoces)

 ## 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)
+- Workspace multi-agents unifié dans le même projet
+- Ingestion locale des sessions avec rendu structuré
+- Développement parallèle avec flux `git worktree` intégré
+- Gestion MCP (scan local + recherche/installation depuis le registre)
+- Gestion des Skills (portée globale et projet)
+- Boucle d'ingénierie intégrée (arborescence de fichiers, diff, changements git, commit, terminal)
+
+## Périmètre pris en charge
+
+### 1) Ingestion de sessions (sessions historiques)
+
+| Agent | Chemin via variable d'environnement | Défaut macOS / Linux | Défaut 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` |
+
+> Remarque : les variables d'environnement ont priorité sur les chemins par défaut.
+
+### 2) Sessions temps réel ACP
+
+Le registre intégré comprend plus de 20 adaptateurs, tels que Claude Code, Codex CLI,
+Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, et d'autres.
+
+### 3) Prise en charge des paramètres Skills
+
+- Pris en charge : `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
+- D'autres adaptateurs seront ajoutés progressivement
+
+### 4) Applications cibles MCP
+
+Cibles en écriture actuelles :
+
+- Claude Code
+- Codex
+- OpenCode

 ## Démarrage rapide

 ### Prérequis

- Node.js `>=22`
+- Node.js `>=22` (recommandé)
 - pnpm `>=10`
 - Rust stable (2021 edition)
 - Dépendances de build Tauri 2

-### Commandes
+Exemple Linux (Debian/Ubuntu) :
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### Développement

 ```bash
 pnpm install
+
+# Application de bureau complète (Tauri + Next.js)
 pnpm tauri dev
+
+# Frontend uniquement
 pnpm dev
+
+# Export statique du frontend vers out/
 pnpm build
+
+# Build de l'application de bureau
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# Exécuter dans src-tauri/
+# Vérifications Rust (exécuter dans src-tauri/)
 cargo check
 cargo clippy
 cargo build
 ```

+## Architecture
+
+```text
+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
+```
+
+## Contraintes
+
+- Le frontend utilise l'export statique (`output: "export"`)
+- Pas de routes dynamiques Next.js (`[param]`) ; utiliser les paramètres de requête à la place
+- Paramètres des commandes Tauri : `camelCase` côté frontend, `snake_case` côté Rust
+- TypeScript en mode strict
+
+## Confidentialité et sécurité
+
+- Local-first par défaut pour l'analyse, le stockage et les opérations sur le projet
+- L'accès réseau ne se produit que lors d'actions déclenchées par l'utilisateur
+- Prise en charge du proxy système pour les environnements d'entreprise
+
 ## Licence

 Apache-2.0. Voir `LICENSE`.
--- a/docs/readme/README.ja.md
+++ b/docs/readme/README.ja.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,75 +18,138 @@
  <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（Code Generation）は、エンタープライズ級のマルチ Agent コーディングワークスペースです。
+Claude Code、Codex CLI、OpenCode、Gemini CLI、OpenClaw などのローカル 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)

 ## セッションタイル表示
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> 現在のバージョン: `v0.1.x`（高速に改善中）
+> 現在のステータス: `v0.1.x`（高速イテレーション中、アーリーアダプター向け）

-## 主な特長
+## ハイライト

 - 同一プロジェクトでのマルチ Agent 統合ワークスペース
- ローカルセッションの集約と構造化表示
- `git worktree` による並列開発
- MCP 管理（ローカルスキャン + 検索/インストール）
- Skills 管理（グローバル/プロジェクト）
- ファイルツリー、Diff、Git、コミット、ターミナルの一体化
+- ローカルセッションの取り込みと構造化レンダリング
+- 内蔵 `git worktree` フローによる並列開発
+- MCP 管理（ローカルスキャン + レジストリ検索/インストール）
+- Skills 管理（グローバルおよびプロジェクトスコープ）
+- 統合エンジニアリングループ（ファイルツリー、Diff、Git 変更、コミット、ターミナル）

 ## 対応範囲

-### 1) セッション取り込み（履歴）
+### 1) セッション取り込み（履歴セッション）

-| Agent | 環境変数優先パス | macOS / Linux 既定 | Windows 既定 |
+| 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 以上の Agent アダプターを内蔵（Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw など）。
+内蔵レジストリには、Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code など 20 以上のアダプターが含まれています。

-### 3) Skills 設定対応
+### 3) Skills 設定サポート

 - 対応済み: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
- 他 Agent は順次追加予定
+- 他のアダプターは順次追加予定
+
+### 4) MCP ターゲットアプリ
+
+現在の書き込み対象:
+
+- Claude Code
+- Codex
+- OpenCode

 ## クイックスタート

-### 要件
+### 必要条件

- Node.js `>=22`
+- Node.js `>=22`（推奨）
 - pnpm `>=10`
 - Rust stable（2021 edition）
- Tauri 2 のビルド依存
+- Tauri 2 ビルド依存パッケージ

-### 開発コマンド
+Linux（Debian/Ubuntu）の例:
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### 開発

 ```bash
 pnpm install
+
+# デスクトップアプリ全体（Tauri + Next.js）
 pnpm tauri dev
+
+# フロントエンドのみ
 pnpm dev
+
+# フロントエンド静的エクスポート（out/ へ）
 pnpm build
+
+# デスクトップビルド
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# src-tauri/ で実行
+# Rust チェック（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 (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 コマンドパラメータ: フロントエンドは `camelCase`、Rust は `snake_case`
+- TypeScript strict モード
+
+## プライバシーとセキュリティ
+
+- 解析、ストレージ、プロジェクト操作はデフォルトでローカルファースト
+- ネットワークアクセスはユーザーが明示的に操作した場合のみ発生
+- エンタープライズ環境向けのシステムプロキシサポート
+
 ## ライセンス

 Apache-2.0。`LICENSE` を参照してください。
--- a/docs/readme/README.ko.md
+++ b/docs/readme/README.ko.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,66 +18,138 @@
  <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(Code Generation)는 엔터프라이즈급 멀티 Agent 코딩 워크스페이스입니다.
+Claude Code, Codex CLI, OpenCode, Gemini CLI, OpenClaw 등 로컬 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)

 ## 세션 타일 표시
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> 현재 버전: `v0.1.x` (빠르게 개선 중)
+> 현재 상태: `v0.1.x` (빠른 반복 개발 중, 얼리 어답터에 적합)

-## 핵심 기능
+## 하이라이트

- 하나의 프로젝트에서 멀티 Agent 통합 사용
- 로컬 세션 집계 및 구조화 표시
- 내장 `git worktree` 병렬 개발
- MCP 관리(로컬 스캔 + 검색/설치)
- Skills 관리(전역/프로젝트)
- 파일 트리, Diff, Git, 커밋, 터미널 통합
+- 동일 프로젝트에서 멀티 Agent 통합 워크스페이스
+- 로컬 세션 수집 및 구조화 렌더링
+- 내장 `git worktree` 플로를 통한 병렬 개발
+- MCP 관리 (로컬 스캔 + 레지스트리 검색/설치)
+- Skills 관리 (글로벌 및 프로젝트 범위)
+- 통합 엔지니어링 루프 (파일 트리, Diff, Git 변경사항, 커밋, 터미널)

 ## 지원 범위

-### 1) 세션 수집(히스토리)
+### 1) 세션 수집 (히스토리 세션)

-| Agent | 환경 변수 우선 경로 | macOS / Linux 기본 경로 | Windows 기본 경로 |
+| 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 실시간 세션
+
+내장 레지스트리에는 Claude Code, Codex CLI, Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code 등 20개 이상의 어댑터가 포함되어 있습니다.
+
+### 3) Skills 설정 지원
+
+- 지원: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
+- 추가 어댑터는 순차적으로 추가 예정
+
+### 4) MCP 대상 앱
+
+현재 쓰기 가능한 대상:
+
+- Claude Code
+- Codex
+- OpenCode

 ## 빠른 시작

 ### 요구 사항

- Node.js `>=22`
+- Node.js `>=22` (권장)
 - pnpm `>=10`
 - Rust stable (2021 edition)
 - Tauri 2 빌드 의존성

-### 개발 명령
+Linux (Debian/Ubuntu) 예시:
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### 개발

 ```bash
 pnpm install
+
+# 전체 데스크톱 앱 (Tauri + Next.js)
 pnpm tauri dev
+
+# 프론트엔드만
 pnpm dev
+
+# 프론트엔드 정적 내보내기 (out/)
 pnpm build
+
+# 데스크톱 빌드
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# src-tauri/ 에서 실행
+# Rust 검사 (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 (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 명령 파라미터: 프론트엔드 `camelCase`, Rust `snake_case`
+- TypeScript strict 모드
+
+## 개인정보 보호 및 보안
+
+- 파싱, 저장, 프로젝트 작업은 기본적으로 로컬 우선
+- 네트워크 접근은 사용자가 명시적으로 작업을 실행할 때만 발생
+- 엔터프라이즈 환경을 위한 시스템 프록시 지원
+
 ## 라이선스

 Apache-2.0. `LICENSE` 참고.
--- a/docs/readme/README.pt.md
+++ b/docs/readme/README.pt.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,57 +18,139 @@
  <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 (Code Generation) é um workspace de codificação multi-agentes de nível empresarial.
+Ele unifica agentes de codificação IA locais (Claude Code, Codex CLI, OpenCode, Gemini CLI,
+OpenClaw, etc.) em um único aplicativo desktop com agregação de sessões, desenvolvimento
+paralelo via `git worktree`, gerenciamento de MCP/Skills e fluxos integrados de Git/arquivos/terminal.

 ## Interface principal
-
 ![Codeg Light](../images/main-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main-dark.png#gh-dark-mode-only)

-## Exibição em mosaico de sessões
-
+## Exibição em mosaico das sessões
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> Versão atual: `v0.1.x` (iteração rápida)
+> Status atual: `v0.1.x` (iteração rápida, adequado para adotantes iniciais)

 ## 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)
+- Workspace multi-agentes unificado no mesmo projeto
+- Ingestão local de sessões com renderização estruturada
+- Desenvolvimento paralelo com fluxos `git worktree` integrados
+- Gerenciamento de MCP (varredura local + busca/instalação no registro)
+- Gerenciamento de Skills (escopo global e por projeto)
+- Ciclo de engenharia integrado (árvore de arquivos, diff, alterações git, commit, terminal)
+
+## Escopo suportado
+
+### 1) Ingestão de sessões (sessões históricas)
+
+| Agente | Caminho por variável de ambiente | Padrão macOS / Linux | Padrão 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` |
+
+> Nota: as variáveis de ambiente têm prioridade sobre os caminhos padrão.
+
+### 2) Sessões em tempo real ACP
+
+O registro integrado inclui mais de 20 adaptadores, como Claude Code, Codex CLI,
+Gemini CLI, OpenCode, OpenClaw, GitHub Copilot, Cline, Qwen Code, entre outros.
+
+### 3) Suporte a configurações de Skills
+
+- Suportado: `Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
+- Mais adaptadores serão adicionados progressivamente
+
+### 4) Aplicativos alvo MCP
+
+Alvos de escrita atuais:
+
+- Claude Code
+- Codex
+- OpenCode

 ## Início rápido

 ### Requisitos

- Node.js `>=22`
+- Node.js `>=22` (recomendado)
 - pnpm `>=10`
 - Rust stable (2021 edition)
 - Dependências de build do Tauri 2

-### Comandos
+Exemplo Linux (Debian/Ubuntu):
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
+### Desenvolvimento

 ```bash
 pnpm install
+
+# Aplicativo desktop completo (Tauri + Next.js)
 pnpm tauri dev
+
+# Apenas frontend
 pnpm dev
+
+# Exportação estática do frontend para out/
 pnpm build
+
+# Build do aplicativo desktop
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# Executar em src-tauri/
+# Verificações Rust (executar em src-tauri/)
 cargo check
 cargo clippy
 cargo build
 ```

+## Arquitetura
+
+```text
+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
+```
+
+## Restrições
+
+- O frontend usa exportação estática (`output: "export"`)
+- Sem rotas dinâmicas do Next.js (`[param]`); use parâmetros de consulta em vez disso
+- Parâmetros de comandos Tauri: `camelCase` no frontend, `snake_case` no Rust
+- TypeScript em modo strict
+
+## Privacidade e segurança
+
+- Local-first por padrão para análise, armazenamento e operações do projeto
+- O acesso à rede ocorre apenas em ações iniciadas pelo usuário
+- Suporte a proxy do sistema para ambientes corporativos
+
 ## Licença

 Apache-2.0. Veja `LICENSE`.
--- a/docs/readme/README.zh-CN.md
+++ b/docs/readme/README.zh-CN.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,29 +18,29 @@
  <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（Code Generation）是一个企业级多 Agent 编码工作台。
+它将本地 AI 编码代理（Claude Code、Codex CLI、OpenCode、Gemini CLI、
+OpenClaw 等）统一到一个桌面应用中，支持会话聚合、并行 `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)

 ## 会话平铺显示
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> 当前版本：`v0.1.x`（快速迭代中）
+> 当前状态：`v0.1.x`（快速迭代中，适合早期使用者）

 ## 核心亮点

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

 ## 支持范围

@@ -50,46 +52,75 @@ Codeg（Code Generation）是一个面向多 Agent 的企业级代码生成工
 | 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+ Agent 适配器（如 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 等）。
+内置注册表包含 20+ 适配器，如 Claude Code、Codex CLI、
+Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code 等。

-### 3) Skills 设置页支持
+### 3) Skills 设置支持

 - 已支持：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
- 其他代理将持续补齐
+- 更多适配器将持续补齐

 ### 4) MCP 目标应用

-当前支持写入：Claude Code、Codex、OpenCode。
+当前可写入的目标：
+
+- Claude Code
+- Codex
+- OpenCode

 ## 快速开始

 ### 环境要求

- Node.js `>=22`
+- Node.js `>=22`（推荐）
 - pnpm `>=10`
 - Rust stable（2021 edition）
 - Tauri 2 构建依赖

+Linux（Debian/Ubuntu）示例：
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
 ### 开发命令

 ```bash
 pnpm install
+
+# 完整桌面应用（Tauri + Next.js）
 pnpm tauri dev
+
+# 仅前端
 pnpm dev
+
+# 前端静态导出到 out/
 pnpm build
+
+# 桌面应用构建
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# 在 src-tauri/ 下执行
+# Rust 检查（在 src-tauri/ 下执行）
 cargo check
 cargo clippy
 cargo build
 ```

-## 架构概览
+## 架构

 ```text
 Next.js 16 (Static Export) + React 19
@@ -98,24 +129,27 @@ Next.js 16 (Static Export) + React 19
        v
 Tauri 2 Commands (Rust)
  |- ACP Manager
-  |- Parsers
-  |- Git / File Tree / Terminal
+  |- 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"`）
- 不使用动态路由（`[param]`），统一查询参数
- 前端参数 `camelCase`，Rust 参数 `snake_case`
- TypeScript strict
+- 前端使用静态导出（`output: "export"`）
+- 不使用 Next.js 动态路由（`[param]`），统一使用查询参数
+- Tauri 命令参数：前端 `camelCase`，Rust `snake_case`
+- TypeScript strict 模式

 ## 隐私与安全

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

 ## 许可证

--- a/docs/readme/README.zh-TW.md
+++ b/docs/readme/README.zh-TW.md
@@ -2,6 +2,8 @@

 [![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)
+[![Tauri](https://img.shields.io/badge/Tauri-2.x-24C8DB)](https://tauri.app/)
+[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)

 <p>
  <a href="../../README.md">English</a> |
@@ -16,29 +18,29 @@
  <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（Code Generation）是一個企業級多 Agent 編碼工作台。
+它將本地 AI 編碼代理（Claude Code、Codex CLI、OpenCode、Gemini CLI、
+OpenClaw 等）整合到一個桌面應用中，支援會話彙整、並行 `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)

 ## 會話平鋪顯示
-
 ![Codeg Light](../images/main2-light.png#gh-light-mode-only)
 ![Codeg Dark](../images/main2-dark.png#gh-dark-mode-only)

-> 目前版本：`v0.1.x`（快速迭代中）
+> 目前狀態：`v0.1.x`（快速迭代中，適合早期使用者）

 ## 核心亮點

- 多 Agent 統一工作台
- 本地會話彙整與結構化顯示
- 內建 `git worktree` 並行開發
+- 同一專案中的多 Agent 統一工作台
+- 本地會話解析與結構化渲染
+- 內建 `git worktree` 並行開發流程
 - MCP 管理（本地掃描 + 市場搜尋/安裝）
 - Skills 管理（全域與專案級）
- 檔案樹、Diff、Git、提交、終端一體化
+- 整合工程閉環（檔案樹、Diff、Git 變更、提交、終端）

 ## 支援範圍

@@ -50,46 +52,75 @@ Codeg（Code Generation）是面向多 Agent 的企業級程式碼生成工作
 | 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+ Agent 適配器（如 Claude Code、Codex CLI、Gemini CLI、OpenCode、OpenClaw 等）。
+內建註冊表包含 20+ 適配器，如 Claude Code、Codex CLI、
+Gemini CLI、OpenCode、OpenClaw、GitHub Copilot、Cline、Qwen Code 等。

-### 3) Skills 設定頁支援
+### 3) Skills 設定支援

 - 已支援：`Claude Code / Codex / OpenCode / Gemini CLI / OpenClaw`
- 其他代理持續補齊
+- 更多適配器將持續補齊

 ### 4) MCP 目標應用

-目前支援寫入：Claude Code、Codex、OpenCode。
+目前可寫入的目標：
+
+- Claude Code
+- Codex
+- OpenCode

 ## 快速開始

 ### 環境需求

- Node.js `>=22`
+- Node.js `>=22`（建議）
 - pnpm `>=10`
 - Rust stable（2021 edition）
 - Tauri 2 建置依賴

+Linux（Debian/Ubuntu）範例：
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+  libwebkit2gtk-4.1-dev \
+  libayatana-appindicator3-dev \
+  librsvg2-dev \
+  patchelf
+```
+
 ### 開發命令

 ```bash
 pnpm install
+
+# 完整桌面應用（Tauri + Next.js）
 pnpm tauri dev
+
+# 僅前端
 pnpm dev
+
+# 前端靜態匯出到 out/
 pnpm build
+
+# 桌面應用建置
 pnpm tauri build
+
+# Lint
 pnpm eslint .

-# 在 src-tauri/ 下執行
+# Rust 檢查（在 src-tauri/ 下執行）
 cargo check
 cargo clippy
 cargo build
 ```

-## 架構概覽
+## 架構

 ```text
 Next.js 16 (Static Export) + React 19
@@ -98,24 +129,27 @@ Next.js 16 (Static Export) + React 19
        v
 Tauri 2 Commands (Rust)
  |- ACP Manager
-  |- Parsers
-  |- Git / File Tree / Terminal
+  |- 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"`）
- 不使用動態路由（`[param]`），改用查詢參數
- 前端參數 `camelCase`，Rust 參數 `snake_case`
- TypeScript strict
+- 前端使用靜態匯出（`output: "export"`）
+- 不使用 Next.js 動態路由（`[param]`），改用查詢參數
+- Tauri 命令參數：前端 `camelCase`，Rust `snake_case`
+- TypeScript strict 模式

 ## 隱私與安全

- 預設本地優先
- 僅在使用者觸發時連網
- 支援系統代理
+- 預設本地優先：解析、儲存、專案操作均在本地完成
+- 僅在使用者主動觸發時才存取網路
+- 支援系統代理，適配企業網路環境

 ## 授權