更新README信息

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

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)
```
## القيود