English | @@ -16,57 +18,139 @@ العربية
-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/الملفات/الطرفية. ## الواجهة الرئيسية -   ## عرض الجلسات كبلاطات -   -> الإصدار الحالي: `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`. diff --git a/docs/readme/README.de.md b/docs/readme/README.de.md index 93be0f0..b4896e7 100644 --- a/docs/readme/README.de.md +++ b/docs/readme/README.de.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/)English | @@ -16,58 +18,141 @@ العربية
-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 -   ## Sitzungskachelansicht -   -> 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`. diff --git a/docs/readme/README.es.md b/docs/readme/README.es.md index 2d3ab9a..3228645 100644 --- a/docs/readme/README.es.md +++ b/docs/readme/README.es.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/)English | @@ -16,58 +18,141 @@ العربية
-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 -   ## Vista de mosaico de sesiones -   -> 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`. diff --git a/docs/readme/README.fr.md b/docs/readme/README.fr.md index 1a7b0c6..895ceed 100644 --- a/docs/readme/README.fr.md +++ b/docs/readme/README.fr.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/)English | @@ -16,58 +18,139 @@ العربية
-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 -   ## Affichage en tuiles des sessions -   -> 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`. diff --git a/docs/readme/README.ja.md b/docs/readme/README.ja.md index ef0e6b1..8b848f4 100644 --- a/docs/readme/README.ja.md +++ b/docs/readme/README.ja.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/)English | @@ -16,75 +18,138 @@ العربية
-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/ファイル/ターミナル連携ワークフローを提供します。 ## メインインターフェース -   ## セッションタイル表示 -   -> 現在のバージョン: `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` を参照してください。 diff --git a/docs/readme/README.ko.md b/docs/readme/README.ko.md index db0f4e9..942e7b2 100644 --- a/docs/readme/README.ko.md +++ b/docs/readme/README.ko.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/)English | @@ -16,66 +18,138 @@ العربية
-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/파일/터미널 통합 워크플로를 제공합니다. ## 메인 인터페이스 -   ## 세션 타일 표시 -   -> 현재 버전: `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` 참고. diff --git a/docs/readme/README.pt.md b/docs/readme/README.pt.md index 37c2609..ea5557c 100644 --- a/docs/readme/README.pt.md +++ b/docs/readme/README.pt.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/)English | @@ -16,57 +18,139 @@ العربية
-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 -   -## Exibição em mosaico de sessões - +## Exibição em mosaico das sessões   -> 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`. diff --git a/docs/readme/README.zh-CN.md b/docs/readme/README.zh-CN.md index 0019055..fef699b 100644 --- a/docs/readme/README.zh-CN.md +++ b/docs/readme/README.zh-CN.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/) -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/文件/终端工作流。 ## 主界面 -   ## 会话平铺显示 -   -> 当前版本：`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 模式 ## 隐私与安全 -- 默认本地优先 -- 仅在用户触发时访问网络 -- 支持系统代理 +- 默认本地优先：解析、存储、项目操作均在本地完成 +- 仅在用户主动触发时才访问网络 +- 支持系统代理，适配企业网络环境 ## 许可证 diff --git a/docs/readme/README.zh-TW.md b/docs/readme/README.zh-TW.md index d8436af..cfc8eb2 100644 --- a/docs/readme/README.zh-TW.md +++ b/docs/readme/README.zh-TW.md @@ -2,6 +2,8 @@ [](https://github.com/xintaofei/codeg/releases) [](../../LICENSE) +[](https://tauri.app/) +[](https://nextjs.org/) -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/檔案/終端工作流。 ## 主介面 -   ## 會話平鋪顯示 -   -> 目前版本：`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 模式 ## 隱私與安全 -- 預設本地優先 -- 僅在使用者觸發時連網 -- 支援系統代理 +- 預設本地優先：解析、儲存、專案操作均在本地完成 +- 僅在使用者主動觸發時才存取網路 +- 支援系統代理，適配企業網路環境 ## 授權