wuxu/codeg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新README信息

Browse Source
This commit is contained in:
xintaofei
2026-03-31 17:30:21 +08:00
parent 4f051715bf
commit 2d5bd6454c
10 changed files with 414 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
docs/readme/README.ar.md
View File

@@ -21,8 +21,8 @@
Codeg (Code Generation) هو مساحة عمل مؤسسية متعددة الوكلاء للبرمجة.
يوحّد وكلاء البرمجة المحليين بالذكاء الاصطناعي (Claude Code، Codex CLI، OpenCode، Gemini CLI،
OpenClaw، وغيرها) في تطبيق سطح مكتب أو خادم مستقل أو حاوية Docker — مما يتيح التطوير عن بُعد من أي متصفح — مع تجميع الجلسات، والتطوير المتوازي
عبر `git worktree`، وإدارة MCP/Skills، وسير عمل متكامل لـ Git/الملفات/الطرفية.
OpenClaw، وغيرها) في تطبيق سطح مكتب أو خادم مستقل أو حاوية Docker — مما يتيح التطوير عن بُعد من أي متصفح — مع تجميع المحادثات، والتطوير المتوازي
عبر `git worktree`، وإدارة MCP/Skills، والتفاعل عبر قنوات الدردشة (Telegram وLark وغيرها)، وسير عمل متكامل لـ Git/الملفات/الطرفية.
## الواجهة الرئيسية
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -36,15 +36,16 @@ OpenClaw، وغيرها) في تطبيق سطح مكتب أو خادم مستق
## أبرز المزايا
- مساحة عمل موحّدة متعددة الوكلاء في نفس المشروع
- استيعاب محلي للجلسات مع عرض منظّم
- استيعاب محلي للمحادثات مع عرض منظّم
- تطوير متوازي مع تدفقات `git worktree` مدمجة
- **مُنشئ المشروع** — إنشاء مشاريع جديدة بصريًا مع معاينة حية
- **قنوات الدردشة** — ربط Telegram وLark (Feishu) والمزيد بوكلاء البرمجة للحصول على إشعارات فورية وأوامر تفاعلية
- إدارة MCP (فحص محلي + بحث/تثبيت من السجل)
- إدارة Skills (نطاق عام ونطاق المشروع)
- إدارة حسابات Git البعيدة (GitHub وخوادم Git الأخرى)
- وضع خدمة الويب — الوصول إلى Codeg من أي متصفح للعمل عن بُعد
- **نشر خادم مستقل** — شغّل `codeg-server` على أي خادم Linux/macOS، والوصول عبر المتصفح
- **دعم Docker** — صورة بناء متعددة المراحل، تدعم `docker compose up` أو `docker run`، مع رمز مصادقة ومنفذ قابلين للتخصيص، واستمرارية البيانات وتحميل مجلدات المشاريع
- **دعم Docker** — `docker compose up` أو `docker run`، مع رمز مصادقة ومنفذ قابلين للتخصيص، واستمرارية البيانات وتحميل مجلدات المشاريع
- حلقة هندسية متكاملة (شجرة الملفات، الفروقات، تغييرات git، الإيداع، الطرفية)
## مُنشئ المشروع
@@ -64,9 +65,38 @@ OpenClaw، وغيرها) في تطبيق سطح مكتب أو خادم مستق
يدعم حاليًا إنشاء مشاريع **shadcn/ui**، مع تصميم قائم على علامات التبويب جاهز لدعم المزيد من أنواع المشاريع في المستقبل.
## قنوات الدردشة
اربط تطبيقات المراسلة المفضلة لديك — Telegram وLark (Feishu) والمزيد — بوكلاء البرمجة بالذكاء الاصطناعي. استقبل إشعارات فورية عند إكمال الوكلاء للمهام أو مواجهة أخطاء، واستعلم عن سجل المحادثات من هاتفك، واحصل على تقارير يومية تلقائية — كل ذلك دون مغادرة تطبيق الدردشة.
### القنوات المدعومة
| القناة | البروتوكول | الحالة |
| --- | --- | --- |
| Telegram | Bot API (HTTP long-polling) | مدمج |
| Lark (Feishu) | WebSocket + REST API | مدمج |
> يُخطَّط لدعم المزيد من القنوات (Discord وSlack وWeChat وDingTalk وغيرها) في الإصدارات المستقبلية.
### الميزات الرئيسية
- **إشعارات الأحداث** — يتم دفع إتمام أدوار الوكلاء والأخطاء إلى جميع القنوات المُفعَّلة في الوقت الفعلي
- **أوامر تفاعلية** — أرسل أوامر (`/recent`، `/search`، `/detail`، `/today`، `/status`، `/help`) من تطبيق الدردشة واحصل على ردود فورية؛ بادئة الأمر قابلة للتكوين. الأوامر المتعلقة بالمحادثات (البدء، الإيقاف، الموافقة) مخططة للإصدارات القادمة
- **التقارير اليومية** — ملخص يومي تلقائي في وقت مجدول، يشمل عدد المحادثات وتوزيع أنواع الوكلاء ونشاط المشروع
- **متعدد اللغات** — قوالب رسائل بـ 10 لغات (الإنجليزية، الصينية المبسطة/التقليدية، اليابانية، الكورية، الإسبانية، الألمانية، الفرنسية، البرتغالية، العربية)
- **بيانات اعتماد آمنة** — يتم تخزين الرموز في حلقة مفاتيح نظام التشغيل، ولا تُكشف أبدًا في ملفات التكوين أو السجلات
- **رسائل غنية** — تنسيق Markdown لـ Telegram، تخطيط قائم على البطاقات لـ Lark؛ احتياطي بالنص العادي لجميع المنصات
### الإعداد
1. أنشئ قناة في **الإعدادات → قنوات الدردشة** (اختر Telegram أو Lark)
2. أدخل رمز البوت (Telegram) أو بيانات اعتماد التطبيق (Lark) — مخزّنة بأمان في حلقة مفاتيح نظام التشغيل
3. قم بتكوين مرشحات الأحداث وجدول التقرير اليومي الاختياري
4. اتصل — تبدأ الرسائل بالتدفق عندما يصدر الوكلاء أحداثًا
## النطاق المدعوم
### 1) استيعاب الجلسات (الجلسات التاريخية)
### 1) استيعاب المحادثات (المحادثات التاريخية)
| الوكيل | مسار متغير البيئة | الافتراضي في macOS / Linux | الافتراضي في Windows |
| --- | --- | --- | --- |
@@ -263,13 +293,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## القيود

51
docs/readme/README.de.md
View File

@@ -23,9 +23,9 @@ 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, einem Standalone-Server oder
Docker-Container — Remote-Entwicklung von jedem Browser aus — mit Sitzungsaggregation,
paralleler `git worktree`-Entwicklung, MCP/Skills-Verwaltung und integrierten
Git/Datei/Terminal-Workflows.
Docker-Container — Remote-Entwicklung von jedem Browser aus — mit Konversationsaggregation,
paralleler `git worktree`-Entwicklung, MCP/Skills-Verwaltung, Chat-Kanal-Integration
(Telegram, Lark usw.) und integrierten Git/Datei/Terminal-Workflows.
## Hauptoberfläche
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -39,15 +39,16 @@ Git/Datei/Terminal-Workflows.
## Highlights
- Einheitlicher Multi-Agent-Workspace im selben Projekt
- Lokale Sitzungserfassung mit strukturierter Darstellung
- Lokale Konversationserfassung mit strukturierter Darstellung
- Parallele Entwicklung mit integrierten `git worktree`-Abläufen
- **Projekt-Starter** — neue Projekte visuell erstellen mit Live-Vorschau
- **Chat-Kanäle** — Telegram, Lark (Feishu) und mehr mit Ihren Coding-Agenten verbinden für Echtzeit-Benachrichtigungen und interaktive Befehle
- MCP-Verwaltung (lokaler Scan + Registry-Suche/Installation)
- Skills-Verwaltung (global und projektbezogen)
- Git-Remote-Kontoverwaltung (GitHub und andere Git-Server)
- Webdienst-Modus — Zugriff auf Codeg über jeden Browser für Remote-Arbeit
- Standalone-Server-Bereitstellung — codeg-server auf jedem Linux/macOS-Server ausführen, Zugriff über den Browser
- **Docker-Unterstützung** — Multi-Stage-Build-Image, unterstützt `docker compose up` oder `docker run`, benutzerdefinierter Token/Port, Datenpersistenz und Projektverzeichnis-Mounts
- **Docker-Unterstützung** — `docker compose up` oder `docker run`, mit benutzerdefiniertem Token/Port, Datenpersistenz und Projektverzeichnis-Mounts
- Integrierter Engineering-Kreislauf (Dateibaum, Diff, Git-Änderungen, Commit, Terminal)
## Projekt-Starter
@@ -67,9 +68,38 @@ Erstellen Sie neue Projekte visuell mit einer geteilten Oberfläche: links konfi
Unterstützt derzeit **shadcn/ui**-Projekt-Scaffolding, mit einem Tab-basierten Design für zukünftige Projekttypen.
## Chat-Kanäle
Verbinden Sie Ihre bevorzugten Messaging-Apps — Telegram, Lark (Feishu) und mehr — mit Ihren KI-Coding-Agenten. Erhalten Sie Echtzeit-Benachrichtigungen, wenn Agenten Aufgaben abschließen oder auf Fehler stoßen, fragen Sie den Konversationsverlauf von Ihrem Smartphone ab und erhalten Sie automatisierte Tagesberichte — alles ohne Ihre Chat-App zu verlassen.
### Unterstützte Kanäle
| Kanal | Protokoll | Status |
| --- | --- | --- |
| Telegram | Bot API (HTTP Long-Polling) | Integriert |
| Lark (Feishu) | WebSocket + REST API | Integriert |
> Weitere Kanäle (Discord, Slack, WeChat, DingTalk usw.) sind für zukünftige Releases geplant.
### Hauptfunktionen
- **Ereignisbenachrichtigungen** — Agenten-Rundenvervollständigungen und Fehler werden in Echtzeit an alle aktivierten Kanäle gepusht
- **Interaktive Befehle** — senden Sie Befehle (`/recent`, `/search`, `/detail`, `/today`, `/status`, `/help`) aus Ihrer Chat-App und erhalten Sie sofortige Antworten; konfigurierbarer Befehlspräfix. Konversationsbezogene Befehle (Start, Stopp, Genehmigung) sind für kommende Releases geplant
- **Tagesberichte** — automatisierte tägliche Zusammenfassung zu einer geplanten Zeit, einschließlich Konversationszählung, Aufschlüsselung nach Agent-Typ und Projektaktivität
- **Mehrsprachig** — Nachrichtenvorlagen in 10 Sprachen (Englisch, vereinfachtes/traditionelles Chinesisch, Japanisch, Koreanisch, Spanisch, Deutsch, Französisch, Portugiesisch, Arabisch)
- **Sichere Anmeldedaten** — Token werden im OS-Schlüsselbund gespeichert, nie in Konfigurationsdateien oder Logs exponiert
- **Rich-Nachrichten** — Markdown-Formatierung für Telegram, kartenbasiertes Layout für Lark; Klartext-Fallback für alle Plattformen
### Einrichtung
1. Erstellen Sie einen Kanal unter **Einstellungen → Chat-Kanäle** (wählen Sie Telegram oder Lark)
2. Geben Sie Ihren Bot-Token (Telegram) oder App-Anmeldedaten (Lark) ein — sicher im OS-Schlüsselbund gespeichert
3. Konfigurieren Sie Ereignisfilter und optionalen Tagesberichtsplan
4. Verbinden — Nachrichten beginnen zu fließen, sobald Agenten Ereignisse aussenden
## Unterstützter Umfang
### 1) Sitzungserfassung (historische Sitzungen)
### 1) Konversationserfassung (historische Konversationen)
| Agent | Umgebungsvariablen-Pfad | macOS / Linux Standard | Windows Standard |
| --- | --- | --- | --- |
@@ -266,13 +296,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## Einschränkungen

49
docs/readme/README.es.md
View File

@@ -24,8 +24,8 @@ con múltiples agentes.
Integra agentes locales de codificación con IA (Claude Code, Codex CLI, OpenCode,
Gemini CLI, OpenClaw, Cline, etc.) en una aplicación de escritorio, servidor independiente
o contenedor Docker — permitiendo el desarrollo remoto desde cualquier navegador — con agregación
de sesiones, desarrollo paralelo con `git worktree`, gestión de MCP/Skills y
flujos integrados de Git/archivos/terminal.
de conversaciones, desarrollo paralelo con `git worktree`, gestión de MCP/Skills,
interacción con canales de chat (Telegram, Lark, etc.) y flujos integrados de Git/archivos/terminal.
## Interfaz principal
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -39,15 +39,16 @@ flujos integrados de Git/archivos/terminal.
## Puntos destacados
- Espacio de trabajo unificado para múltiples agentes en el mismo proyecto
- Ingesta local de sesiones con renderizado estructurado
- Ingesta local de conversaciones con renderizado estructurado
- Desarrollo paralelo con flujos integrados de `git worktree`
- **Inicio de Proyecto** — crea nuevos proyectos visualmente con vista previa en tiempo real
- **Canales de Chat** — conecta Telegram, Lark (Feishu) y más a tus agentes de codificación para notificaciones en tiempo real y comandos interactivos
- Gestión de MCP (escaneo local + búsqueda/instalación desde registro)
- Gestión de Skills (ámbito global y por proyecto)
- Gestión de cuentas remotas de Git (GitHub y otros servidores Git)
- Modo de servicio web — accede a Codeg desde cualquier navegador para trabajo remoto
- Despliegue como servidor independiente — ejecuta codeg-server en cualquier servidor Linux/macOS, accede desde el navegador
- **Soporte Docker** — imagen con compilación multi-etapa, compatible con `docker compose up` o `docker run`, token/puerto personalizables, persistencia de datos y montaje de directorios de proyecto
- **Soporte Docker** — `docker compose up` o `docker run`, con token/puerto personalizables, persistencia de datos y montaje de directorios de proyecto
- Ciclo de ingeniería integrado (árbol de archivos, diff, cambios git, commit, terminal)
## Inicio de Proyecto
@@ -67,9 +68,38 @@ Crea nuevos proyectos visualmente con una interfaz de panel dividido: configura
Actualmente soporta scaffolding de proyectos **shadcn/ui**, con un diseño basado en pestañas preparado para más tipos de proyectos en el futuro.
## Canales de Chat
Conecta tus aplicaciones de mensajería favoritas — Telegram, Lark (Feishu) y más — a tus agentes de codificación IA. Recibe notificaciones en tiempo real cuando los agentes completen tareas o encuentren errores, consulta el historial de conversaciones desde tu teléfono y obtén informes diarios automatizados — todo sin salir de tu aplicación de chat.
### Canales soportados
| Canal | Protocolo | Estado |
| --- | --- | --- |
| Telegram | Bot API (HTTP long-polling) | Integrado |
| Lark (Feishu) | WebSocket + REST API | Integrado |
> Se planean más canales (Discord, Slack, WeChat, DingTalk, etc.) para futuras versiones.
### Características principales
- **Notificaciones de eventos** — las finalizaciones de turno y errores de los agentes se envían a todos los canales habilitados en tiempo real
- **Comandos interactivos** — envía comandos (`/recent`, `/search`, `/detail`, `/today`, `/status`, `/help`) desde tu app de chat y obtén respuestas instantáneas; prefijo de comando configurable. Los comandos relacionados con conversaciones (inicio, parada, aprobación) están planificados para próximas versiones
- **Informes diarios** — resumen diario automatizado a una hora programada, incluyendo recuento de conversaciones, desglose por tipo de agente y actividad del proyecto
- **Multi-idioma** — plantillas de mensajes en 10 idiomas (inglés, chino simplificado/tradicional, japonés, coreano, español, alemán, francés, portugués, árabe)
- **Credenciales seguras** — los tokens se almacenan en el llavero del SO, nunca se exponen en archivos de configuración ni logs
- **Mensajes enriquecidos** — formato Markdown para Telegram, diseño basado en tarjetas para Lark; respaldo en texto plano para todas las plataformas
### Configuración
1. Crea un canal en **Configuración → Canales de Chat** (elige Telegram o Lark)
2. Introduce tu token de bot (Telegram) o credenciales de la app (Lark) — almacenados de forma segura en el llavero del SO
3. Configura los filtros de eventos y la programación opcional del informe diario
4. Conecta — los mensajes empiezan a fluir cuando los agentes emiten eventos
## Alcance soportado
### 1) Ingesta de sesiones (sesiones históricas)
### 1) Ingesta de conversaciones (conversaciones históricas)
| Agente | Ruta de variable de entorno | Ruta por defecto en macOS / Linux | Ruta por defecto en Windows |
| --- | --- | --- | --- |
@@ -266,13 +296,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## Restricciones

50
docs/readme/README.fr.md
View File

@@ -22,8 +22,9 @@
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, Cline, etc.) dans une application de bureau, un serveur autonome ou un conteneur
Docker — permettant le développement à distance depuis n'importe quel navigateur — avec agrégation de sessions, développement
parallèle via `git worktree`, gestion MCP/Skills et workflows intégrés Git/fichiers/terminal.
Docker — permettant le développement à distance depuis n'importe quel navigateur — avec agrégation de conversations, développement
parallèle via `git worktree`, gestion MCP/Skills, interaction avec les canaux de chat (Telegram, Lark, etc.)
et workflows intégrés Git/fichiers/terminal.
## Interface principale
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -37,15 +38,16 @@ parallèle via `git worktree`, gestion MCP/Skills et workflows intégrés Git/fi
## Points forts
- Workspace multi-agents unifié dans le même projet
- Ingestion locale des sessions avec rendu structuré
- Ingestion locale des conversations avec rendu structuré
- Développement parallèle avec flux `git worktree` intégré
- **Lanceur de projet** — créez visuellement de nouveaux projets avec aperçu en temps réel
- **Canaux de chat** — connectez Telegram, Lark (Feishu) et plus à vos agents de codage pour des notifications en temps réel et des commandes interactives
- Gestion MCP (scan local + recherche/installation depuis le registre)
- Gestion des Skills (portée globale et projet)
- Gestion des comptes distants Git (GitHub et autres serveurs Git)
- Mode service web — accédez à Codeg depuis n'importe quel navigateur pour le travail à distance
- Déploiement en serveur autonome — exécutez codeg-server sur n'importe quel serveur Linux/macOS, accédez via le navigateur
- **Support Docker** — image multi-stage build, compatible `docker compose up` ou `docker run`, token/port personnalisables, persistance des données et montage de répertoires de projets
- **Support Docker** — `docker compose up` ou `docker run`, avec token/port personnalisables, persistance des données et montage de répertoires de projets
- Boucle d'ingénierie intégrée (arborescence de fichiers, diff, changements git, commit, terminal)
## Lanceur de projet
@@ -65,9 +67,38 @@ Créez visuellement de nouveaux projets avec une interface à panneaux divisés
Prend actuellement en charge le scaffolding de projets **shadcn/ui**, avec un design à onglets prêt pour d'autres types de projets à l'avenir.
## Canaux de chat
Connectez vos applications de messagerie préférées — Telegram, Lark (Feishu) et plus — à vos agents de codage IA. Recevez des notifications en temps réel lorsque les agents terminent des tâches ou rencontrent des erreurs, consultez l'historique des conversations depuis votre téléphone et obtenez des rapports quotidiens automatisés — le tout sans quitter votre application de chat.
### Canaux pris en charge
| Canal | Protocole | Statut |
| --- | --- | --- |
| Telegram | Bot API (HTTP long-polling) | Intégré |
| Lark (Feishu) | WebSocket + REST API | Intégré |
> D'autres canaux (Discord, Slack, WeChat, DingTalk, etc.) sont prévus pour de futures versions.
### Fonctionnalités clés
- **Notifications d'événements** — les complétions de tour et les erreurs des agents sont poussées vers tous les canaux activés en temps réel
- **Commandes interactives** — envoyez des commandes (`/recent`, `/search`, `/detail`, `/today`, `/status`, `/help`) depuis votre application de chat et obtenez des réponses instantanées ; préfixe de commande configurable. Les commandes liées aux conversations (démarrage, arrêt, approbation) sont prévues pour les prochaines versions
- **Rapports quotidiens** — résumé quotidien automatisé à une heure programmée, incluant le nombre de conversations, la répartition par type d'agent et l'activité du projet
- **Multi-langue** — modèles de messages en 10 langues (anglais, chinois simplifié/traditionnel, japonais, coréen, espagnol, allemand, français, portugais, arabe)
- **Identifiants sécurisés** — les tokens sont stockés dans le trousseau du système d'exploitation, jamais exposés dans les fichiers de configuration ou les logs
- **Messages enrichis** — format Markdown pour Telegram, mise en page par cartes pour Lark ; repli en texte brut pour toutes les plateformes
### Configuration
1. Créez un canal dans **Paramètres → Canaux de chat** (choisissez Telegram ou Lark)
2. Entrez votre token de bot (Telegram) ou les identifiants de l'application (Lark) — stockés en toute sécurité dans le trousseau du SO
3. Configurez les filtres d'événements et la planification optionnelle du rapport quotidien
4. Connectez — les messages commencent à circuler dès que les agents émettent des événements
## Périmètre pris en charge
### 1) Ingestion de sessions (sessions historiques)
### 1) Ingestion de conversations (conversations historiques)
| Agent | Chemin via variable d'environnement | Défaut macOS / Linux | Défaut Windows |
| --- | --- | --- | --- |
@@ -264,13 +295,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## Contraintes

49
docs/readme/README.ja.md
View File

@@ -21,8 +21,8 @@
Codeg（Code Generation）は、エンタープライズ級のマルチ Agent コーディングワークスペースです。
Claude Code、Codex CLI、OpenCode、Gemini CLI、OpenClaw などのローカル AI コーディング Agent を
デスクトップアプリ、スタンドアロンサーバー、または Docker コンテナに統合し——ブラウザからどこでもリモート開発が可能——セッション集約、並列 `git worktree` 開発、MCP/Skills 管理、
Git/ファイル/ターミナル連携ワークフローを提供します。
デスクトップアプリ、スタンドアロンサーバー、または Docker コンテナに統合し——ブラウザからどこでもリモート開発が可能——会話集約、並列 `git worktree` 開発、MCP/Skills 管理、
チャットチャンネル連携（Telegram、Lark など）、Git/ファイル/ターミナル連携ワークフローを提供します。
## メインインターフェース
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -36,15 +36,16 @@ Git/ファイル/ターミナル連携ワークフローを提供します。
## ハイライト
- 同一プロジェクトでのマルチ Agent 統合ワークスペース
- ローカルセッションの取り込みと構造化レンダリング
- ローカル会話の取り込みと構造化レンダリング
- 内蔵 `git worktree` フローによる並列開発
- **プロジェクトブート** — ビジュアル設定とライブプレビューで新規プロジェクトを作成
- **チャットチャンネル** — Telegram、Lark（Feishu）などをコーディング Agent に接続し、リアルタイム通知やインタラクティブコマンドを利用
- MCP 管理（ローカルスキャン + レジストリ検索/インストール）
- Skills 管理（グローバルおよびプロジェクトスコープ）
- Git リモートアカウント管理（GitHub およびその他の Git サーバー）
- Web サービスモード — ブラウザから Codeg にアクセスでき、リモートワークに対応
- **スタンドアロンサーバーデプロイ** — 任意の Linux/macOS サーバーで `codeg-server` を実行し、ブラウザからアクセス
- **Docker サポート** — マルチステージビルドイメージ、`docker compose up` または `docker run` に対応、カスタムトークン・ポート設定、データ永続化およびプロジェクトディレクトリのマウントをサポート
- **Docker サポート** — `docker compose up` または `docker run` に対応、カスタムトークン・ポート設定、データ永続化およびプロジェクトディレクトリのマウントをサポート
- 統合エンジニアリングループ（ファイルツリー、Diff、Git 変更、コミット、ターミナル）
## プロジェクトブート
@@ -64,9 +65,38 @@ Git/ファイル/ターミナル連携ワークフローを提供します。
現在 **shadcn/ui** プロジェクトのスキャフォールディングをサポートしており、タブベースの設計で将来のプロジェクトタイプ追加に対応しています。
## チャットチャンネル
お気に入りのメッセージングアプリ — Telegram、Lark（Feishu）など — を AI コーディング Agent に接続。Agent がタスクを完了したりエラーが発生した際にリアルタイム通知を受信し、スマートフォンから会話履歴を検索し、自動日次レポートを取得 — チャットアプリを離れることなくすべて対応可能。
### 対応チャンネル
| チャンネル | プロトコル | 状態 |
| --- | --- | --- |
| Telegram | Bot API（HTTP ロングポーリング） | 内蔵 |
| Lark（Feishu） | WebSocket + REST API | 内蔵 |
> その他のチャンネル（Discord、Slack、WeChat、DingTalk など）は今後のリリースで対応予定。
### 主な機能
- **イベント通知** — Agent のターン完了やエラーがすべての有効なチャンネルにリアルタイムでプッシュ
- **インタラクティブコマンド** — チャットアプリからコマンド（`/recent`、`/search`、`/detail`、`/today`、`/status`、`/help`）を送信し即座に応答を取得。コマンドプレフィックスの設定が可能。会話関連コマンド（開始、停止、承認など）は今後のリリースで対応予定
- **日次レポート** — 予定された時刻に自動日次サマリーを生成（会話数、Agent タイプ別内訳、プロジェクトアクティビティを含む）
- **多言語対応** — メッセージテンプレートは 10 言語に対応（英語、簡体字/繁体字中国語、日本語、韓国語、スペイン語、ドイツ語、フランス語、ポルトガル語、アラビア語）
- **セキュアな認証情報** — トークンは OS キーリングに保存され、設定ファイルやログに公開されません
- **リッチメッセージ** — Telegram では Markdown フォーマット、Lark ではカードベースレイアウト。すべてのプラットフォームでプレーンテキストフォールバックに対応
### セットアップ
1. **設定 → チャットチャンネル** でチャンネルを作成（Telegram または Lark を選択）
2. ボットトークン（Telegram）またはアプリ認証情報（Lark）を入力 — OS キーリングに安全に保存
3. イベントフィルターとオプションの日次レポートスケジュールを設定
4. 接続 — Agent がイベントを発行するとメッセージが流れ始めます
## 対応範囲
### 1) セッション取り込み（履歴セッション）
### 1) 会話取り込み（履歴会話）
| Agent | 環境変数パス | macOS / Linux デフォルト | Windows デフォルト |
| --- | --- | --- | --- |
@@ -263,13 +293,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## 制約事項

49
docs/readme/README.ko.md
View File

@@ -21,8 +21,8 @@
Codeg(Code Generation)는 엔터프라이즈급 멀티 Agent 코딩 워크스페이스입니다.
Claude Code, Codex CLI, OpenCode, Gemini CLI, OpenClaw 등 로컬 AI 코딩 Agent를
데스크톱 앱, 독립형 서버 또는 Docker 컨테이너로 통합하여 — 브라우저만으로 어디서든 원격 개발이 가능하며 — 세션 집계, 병렬 `git worktree` 개발, MCP/Skills 관리,
Git/파일/터미널 통합 워크플로를 제공합니다.
데스크톱 앱, 독립형 서버 또는 Docker 컨테이너로 통합하여 — 브라우저만으로 어디서든 원격 개발이 가능하며 — 대화 집계, 병렬 `git worktree` 개발, MCP/Skills 관리,
채팅 채널 연동(Telegram, Lark 등), Git/파일/터미널 통합 워크플로를 제공합니다.
## 메인 인터페이스
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -36,15 +36,16 @@ Git/파일/터미널 통합 워크플로를 제공합니다.
## 하이라이트
- 동일 프로젝트에서 멀티 Agent 통합 워크스페이스
- 로컬 세션 수집 및 구조화 렌더링
- 로컬 대화 수집 및 구조화 렌더링
- 내장 `git worktree` 플로를 통한 병렬 개발
- **프로젝트 부트** — 시각적 설정과 실시간 미리보기로 새 프로젝트 생성
- **채팅 채널** — Telegram, Lark(Feishu) 등을 코딩 에이전트에 연결하여 실시간 알림 및 대화형 명령 사용
- MCP 관리 (로컬 스캔 + 레지스트리 검색/설치)
- Skills 관리 (글로벌 및 프로젝트 범위)
- Git 원격 계정 관리 (GitHub 및 기타 Git 서버)
- Web 서비스 모드 — 브라우저에서 Codeg에 접속하여 원격 작업 가능
- **독립형 서버 배포** — 모든 Linux/macOS 서버에서 `codeg-server`를 실행하고 브라우저로 접속
- **Docker 지원** — 멀티 스테이지 빌드 이미지, `docker compose up` 또는 `docker run` 지원, 사용자 정의 토큰/포트, 데이터 영속화 및 프로젝트 디렉토리 마운트 지원
- **Docker 지원** — `docker compose up` 또는 `docker run` 지원, 사용자 정의 토큰/포트, 데이터 영속화 및 프로젝트 디렉토리 마운트 지원
- 통합 엔지니어링 루프 (파일 트리, Diff, Git 변경사항, 커밋, 터미널)
## 프로젝트 부트
@@ -64,9 +65,38 @@ Git/파일/터미널 통합 워크플로를 제공합니다.
현재 **shadcn/ui** 프로젝트 스캐폴딩을 지원하며, 탭 기반 디자인으로 향후 더 많은 프로젝트 유형을 지원할 준비가 되어 있습니다.
## 채팅 채널
즐겨 사용하는 메신저 앱 — Telegram, Lark(Feishu) 등 — 을 AI 코딩 에이전트에 연결하세요. 에이전트가 작업을 완료하거나 오류가 발생하면 실시간 알림을 받고, 스마트폰에서 대화 기록을 조회하고, 자동화된 일일 리포트를 받을 수 있습니다 — 채팅 앱을 떠나지 않고도 모든 것이 가능합니다.
### 지원 채널
| 채널 | 프로토콜 | 상태 |
| --- | --- | --- |
| Telegram | Bot API (HTTP 롱폴링) | 내장 |
| Lark (Feishu) | WebSocket + REST API | 내장 |
> 추가 채널(Discord, Slack, WeChat, DingTalk 등)은 향후 릴리스에서 지원 예정입니다.
### 주요 기능
- **이벤트 알림** — 에이전트의 턴 완료 및 오류가 활성화된 모든 채널에 실시간으로 푸시
- **대화형 명령** — 채팅 앱에서 명령(`/recent`, `/search`, `/detail`, `/today`, `/status`, `/help`)을 보내고 즉시 응답을 받을 수 있으며, 명령 접두사 설정 가능. 대화 관련 명령(시작, 중지, 승인 등)은 향후 릴리스에서 지원 예정
- **일일 리포트** — 예약된 시간에 자동 일일 요약 생성(대화 수, 에이전트 유형별 분석, 프로젝트 활동 포함)
- **다국어 지원** — 10개 언어의 메시지 템플릿(영어, 간체/번체 중국어, 일본어, 한국어, 스페인어, 독일어, 프랑스어, 포르투갈어, 아랍어)
- **보안 자격증명** — 토큰은 OS 키링에 저장되며 설정 파일이나 로그에 노출되지 않음
- **리치 메시지** — Telegram은 Markdown 포맷, Lark은 카드 기반 레이아웃; 모든 플랫폼에서 일반 텍스트 폴백 지원
### 설정
1. **설정 → 채팅 채널**에서 채널 생성(Telegram 또는 Lark 선택)
2. 봇 토큰(Telegram) 또는 앱 자격증명(Lark) 입력 — OS 키링에 안전하게 저장
3. 이벤트 필터 및 선택적 일일 리포트 일정 설정
4. 연결 — 에이전트가 이벤트를 발생시키면 메시지가 흐르기 시작
## 지원 범위
### 1) 세션 수집 (히스토리 세션)
### 1) 대화 수집 (히스토리 대화)
| Agent | 환경 변수 경로 | macOS / Linux 기본값 | Windows 기본값 |
| --- | --- | --- | --- |
@@ -263,13 +293,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## 제약 사항

50
docs/readme/README.pt.md
View File

@@ -22,8 +22,9 @@
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, Cline, etc.) em um aplicativo desktop, servidor standalone ou contêiner
Docker — possibilitando o desenvolvimento remoto a partir de qualquer navegador — com agregação de sessões, desenvolvimento
paralelo via `git worktree`, gerenciamento de MCP/Skills e fluxos integrados de Git/arquivos/terminal.
Docker — possibilitando o desenvolvimento remoto a partir de qualquer navegador — com agregação de conversas, desenvolvimento
paralelo via `git worktree`, gerenciamento de MCP/Skills, interação com canais de chat (Telegram, Lark, etc.)
e fluxos integrados de Git/arquivos/terminal.
## Interface principal
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -37,15 +38,16 @@ paralelo via `git worktree`, gerenciamento de MCP/Skills e fluxos integrados de
## Destaques
- Workspace multi-agentes unificado no mesmo projeto
- Ingestão local de sessões com renderização estruturada
- Ingestão local de conversas com renderização estruturada
- Desenvolvimento paralelo com fluxos `git worktree` integrados
- **Inicializador de Projeto** — crie novos projetos visualmente com pré-visualização em tempo real
- **Canais de Chat** — conecte Telegram, Lark (Feishu) e mais aos seus agentes de codificação para notificações em tempo real e comandos interativos
- Gerenciamento de MCP (varredura local + busca/instalação no registro)
- Gerenciamento de Skills (escopo global e por projeto)
- Gerenciamento de contas remotas Git (GitHub e outros servidores Git)
- Modo de serviço web — acesse o Codeg de qualquer navegador para trabalho remoto
- **Implantação de servidor standalone** — execute `codeg-server` em qualquer servidor Linux/macOS, acesse via navegador
- **Suporte a Docker** — imagem com build multi-stage, compatível com `docker compose up` ou `docker run`, token/porta personalizáveis, persistência de dados e montagem de diretórios de projetos
- **Suporte a Docker** — `docker compose up` ou `docker run`, com token/porta personalizáveis, persistência de dados e montagem de diretórios de projetos
- Ciclo de engenharia integrado (árvore de arquivos, diff, alterações git, commit, terminal)
## Inicializador de Projeto
@@ -65,9 +67,38 @@ Crie novos projetos visualmente com uma interface de painel dividido: configure
Atualmente suporta scaffolding de projetos **shadcn/ui**, com um design baseado em abas preparado para mais tipos de projetos no futuro.
## Canais de Chat
Conecte seus aplicativos de mensagens favoritos — Telegram, Lark (Feishu) e mais — aos seus agentes de codificação IA. Receba notificações em tempo real quando os agentes concluírem tarefas ou encontrarem erros, consulte o histórico de conversas pelo celular e receba relatórios diários automatizados — tudo sem sair do seu app de chat.
### Canais suportados
| Canal | Protocolo | Status |
| --- | --- | --- |
| Telegram | Bot API (HTTP long-polling) | Integrado |
| Lark (Feishu) | WebSocket + REST API | Integrado |
> Mais canais (Discord, Slack, WeChat, DingTalk, etc.) estão planejados para versões futuras.
### Recursos principais
- **Notificações de eventos** — conclusões de turno e erros dos agentes são enviados a todos os canais habilitados em tempo real
- **Comandos interativos** — envie comandos (`/recent`, `/search`, `/detail`, `/today`, `/status`, `/help`) do seu app de chat e receba respostas instantâneas; prefixo de comando configurável. Comandos relacionados a conversas (iniciar, parar, aprovar) estão planejados para próximas versões
- **Relatórios diários** — resumo diário automatizado em um horário programado, incluindo contagem de conversas, divisão por tipo de agente e atividade do projeto
- **Multi-idioma** — templates de mensagens em 10 idiomas (inglês, chinês simplificado/tradicional, japonês, coreano, espanhol, alemão, francês, português, árabe)
- **Credenciais seguras** — tokens armazenados no chaveiro do SO, nunca expostos em arquivos de configuração ou logs
- **Mensagens ricas** — formatação Markdown para Telegram, layout baseado em cartões para Lark; fallback em texto simples para todas as plataformas
### Configuração
1. Crie um canal em **Configurações → Canais de Chat** (escolha Telegram ou Lark)
2. Insira seu token de bot (Telegram) ou credenciais do app (Lark) — armazenados com segurança no chaveiro do SO
3. Configure filtros de eventos e programação opcional do relatório diário
4. Conecte — as mensagens começam a fluir assim que os agentes emitem eventos
## Escopo suportado
### 1) Ingestão de sessões (sessões históricas)
### 1) Ingestão de conversas (conversas históricas)
| Agente | Caminho por variável de ambiente | Padrão macOS / Linux | Padrão Windows |
| --- | --- | --- | --- |
@@ -264,13 +295,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## Restrições

49
docs/readme/README.zh-CN.md
View File

@@ -21,8 +21,8 @@
Codeg（Code Generation）是一个企业级多 Agent 编码工作台。
它将本地 AI 编码代理（Claude Code、Codex CLI、OpenCode、Gemini CLI、
OpenClaw、Cline 等）统一到桌面应用、独立服务器或 Docker 容器中——通过浏览器即可远程开发——支持会话聚合、
并行 `git worktree` 开发、MCP/Skills 管理，以及集成的 Git/文件/终端工作流。
OpenClaw、Cline 等）统一到桌面应用、独立服务器或 Docker 容器中——通过浏览器即可远程开发——支持对话聚合、
并行 `git worktree` 开发、MCP/Skills 管理、消息渠道交互（Telegram、飞书等），以及集成的 Git/文件/终端工作流。
## 主界面
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -36,15 +36,16 @@ OpenClaw、Cline 等）统一到桌面应用、独立服务器或 Docker 容器
## 核心亮点
- 同一项目中的多 Agent 统一工作台
- 本地会话解析与结构化渲染
- 本地对话解析与结构化渲染
- 内置 `git worktree` 并行开发流程
- **项目启动器** — 可视化创建新项目，实时预览效果
- **消息渠道** — 连接 Telegram、飞书等即时通讯应用到编码代理，实时接收通知并进行交互式命令操作
- MCP 管理（本地扫描 + 市场搜索/安装）
- Skills 管理（全局与项目级）
- Git 远程账号管理（支持 GitHub 及其它 Git 服务器）
- Web 服务模式 — 开启后可在浏览器中访问 Codeg，支持远程工作
- **独立服务器部署** — 在任意 Linux/macOS 服务器上运行 `codeg-server`，通过浏览器访问
- **Docker 支持** — 多阶段构建镜像，支持 `docker compose up` 或 `docker run`，可自定义令牌、端口，支持数据持久化及项目目录挂载
- **Docker 支持** — `docker compose up` 或 `docker run`，可自定义令牌、端口，支持数据持久化及项目目录挂载
- 集成工程闭环（文件树、Diff、Git 变更、提交、终端）
## 项目启动器
@@ -64,9 +65,38 @@ OpenClaw、Cline 等）统一到桌面应用、独立服务器或 Docker 容器
目前支持 **shadcn/ui** 项目脚手架，选项卡式设计为未来支持更多项目类型做好了准备。
## 消息渠道
连接你喜爱的即时通讯应用——Telegram、飞书等——到 AI 编码代理。当代理完成任务或遇到错误时接收实时通知，通过手机查询对话历史，获取自动化日报——无需离开聊天应用。
### 支持的渠道
| 渠道 | 协议 | 状态 |
| --- | --- | --- |
| Telegram | Bot API（HTTP 长轮询） | 内置 |
| 飞书 | WebSocket + REST API | 内置 |
> 更多渠道（Discord、Slack、微信、钉钉等）计划在未来版本中支持。
### 主要功能
- **事件通知** — 代理的回合完成和错误事件实时推送到所有已启用的渠道
- **交互式命令** — 从聊天应用发送命令（`/recent`、`/search`、`/detail`、`/today`、`/status`、`/help`）并获得即时响应；支持自定义命令前缀。对话相关命令（如启动、停止、审批）将在后续版本中支持
- **每日报告** — 在预设时间自动生成每日摘要，包括对话数量、代理类型分布和项目活跃度
- **多语言** — 消息模板支持 10 种语言（英语、简体中文/繁体中文、日语、韩语、西班牙语、德语、法语、葡萄牙语、阿拉伯语）
- **安全凭据** — 令牌存储在操作系统密钥环中，不会暴露在配置文件或日志中
- **富文本消息** — Telegram 使用 Markdown 格式，飞书使用卡片布局；所有平台均支持纯文本回退
### 设置
1. 在 **设置 → 消息渠道** 中创建渠道（选择 Telegram 或飞书）
2. 输入 Bot Token（Telegram）或应用凭据（飞书）——安全存储在操作系统密钥环中
3. 配置事件过滤器和可选的每日报告计划
4. 连接——当代理发出事件时，消息将开始流转
## 支持范围
### 1) 会话解析（历史会话）
### 1) 对话解析（历史对话）
| Agent | 环境变量优先路径 | macOS / Linux 默认路径 | Windows 默认路径 |
| --- | --- | --- | --- |
@@ -263,13 +293,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## 开发约束

49
docs/readme/README.zh-TW.md
View File

@@ -21,8 +21,8 @@
Codeg（Code Generation）是一個企業級多 Agent 編碼工作台。
它將本地 AI 編碼代理（Claude Code、Codex CLI、OpenCode、Gemini CLI、
OpenClaw、Cline 等）整合到桌面應用、獨立伺服器或 Docker 容器中——透過瀏覽器即可遠端開發——支援會話彙整、並行 `git worktree`
開發、MCP/Skills 管理，以及整合的 Git/檔案/終端工作流。
OpenClaw、Cline 等）整合到桌面應用、獨立伺服器或 Docker 容器中——透過瀏覽器即可遠端開發——支援對話彙整、並行 `git worktree`
開發、MCP/Skills 管理、訊息渠道互動（Telegram、飛書等），以及整合的 Git/檔案/終端工作流。
## 主介面
![Codeg Light](../images/main-light.png#gh-light-mode-only)
@@ -36,15 +36,16 @@ OpenClaw、Cline 等）整合到桌面應用、獨立伺服器或 Docker 容器
## 核心亮點
- 同一專案中的多 Agent 統一工作台
- 本地會話解析與結構化渲染
- 本地對話解析與結構化渲染
- 內建 `git worktree` 並行開發流程
- **專案啟動器** — 視覺化建立新專案，即時預覽效果
- **訊息渠道** — 連接 Telegram、飛書等即時通訊應用到編碼代理，即時接收通知並進行互動式命令操作
- MCP 管理（本地掃描 + 市場搜尋/安裝）
- Skills 管理（全域與專案級）
- Git 遠端帳號管理（支援 GitHub 及其他 Git 伺服器）
- Web 服務模式 — 開啟後可在瀏覽器中存取 Codeg，支援遠端工作
- **獨立伺服器部署** — 在任意 Linux/macOS 伺服器上執行 `codeg-server`，透過瀏覽器存取
- **Docker 支援** — 多階段建置映像，支援 `docker compose up` 或 `docker run`，可自訂令牌、連接埠，支援資料持久化及專案目錄掛載
- **Docker 支援** — `docker compose up` 或 `docker run`，可自訂令牌、連接埠，支援資料持久化及專案目錄掛載
- 整合工程閉環（檔案樹、Diff、Git 變更、提交、終端）
## 專案啟動器
@@ -64,9 +65,38 @@ OpenClaw、Cline 等）整合到桌面應用、獨立伺服器或 Docker 容器
目前支援 **shadcn/ui** 專案腳手架，分頁式設計為未來支援更多專案類型做好了準備。
## 訊息渠道
連接你喜愛的即時通訊應用——Telegram、飛書等——到 AI 編碼代理。當代理完成任務或遇到錯誤時接收即時通知，透過手機查詢對話歷史，取得自動化日報——無需離開聊天應用。
### 支援的渠道
| 渠道 | 協定 | 狀態 |
| --- | --- | --- |
| Telegram | Bot API（HTTP 長輪詢） | 內建 |
| 飛書 | WebSocket + REST API | 內建 |
> 更多渠道（Discord、Slack、微信、釘釘等）計劃在未來版本中支援。
### 主要功能
- **事件通知** — 代理的回合完成和錯誤事件即時推送到所有已啟用的渠道
- **互動式命令** — 從聊天應用發送命令（`/recent`、`/search`、`/detail`、`/today`、`/status`、`/help`）並獲得即時回應；支援自訂命令前綴。對話相關命令（如啟動、停止、審批）將在後續版本中支援
- **每日報告** — 在預設時間自動產生每日摘要，包括對話數量、代理類型分佈和專案活躍度
- **多語言** — 訊息範本支援 10 種語言（英語、簡體中文/繁體中文、日語、韓語、西班牙語、德語、法語、葡萄牙語、阿拉伯語）
- **安全憑據** — 令牌儲存在作業系統密鑰環中，不會暴露在設定檔或日誌中
- **豐富訊息** — Telegram 使用 Markdown 格式，飛書使用卡片佈局；所有平台均支援純文字回退
### 設定
1. 在 **設定 → 訊息渠道** 中建立渠道（選擇 Telegram 或飛書）
2. 輸入 Bot Token（Telegram）或應用憑據（飛書）——安全儲存在作業系統密鑰環中
3. 設定事件篩選器和可選的每日報告排程
4. 連接——當代理發出事件時，訊息將開始流轉
## 支援範圍
### 1) 會話解析（歷史會話）
### 1) 對話解析（歷史對話）
| Agent | 環境變數優先路徑 | macOS / Linux 預設路徑 | Windows 預設路徑 |
| --- | --- | --- | --- |
@@ -263,13 +293,16 @@ Next.js 16 (Static Export) + React 19
Shared Rust Core
|- AppState
|- ACP Manager
|- Parsers (session ingestion)
|- Parsers (conversation ingestion)
|- Chat Channels
|- Git / File Tree / Terminal
|- MCP marketplace + config
|- SeaORM + SQLite
|
v
Local Filesystem / Git Repos
┌───────┼───────┐
v v v
Local Filesystem Git Chat Channels
/ Git Repos Repos (Telegram, Lark)
```
## 開發約束