عن المشروع

كاكو (書く، وتعني "الكتابة" باليابانية) هو محاكي طرفية لنظام macOS مصمم للبرمجة بمساعدة الذكاء الاصطناعي، مبني فوق WezTerm. يهدف إلى توفير تجربة مصقولة وجاهزة للاستخدام مع إعدادات افتراضية معقولة، مما يلغي الحاجة إلى إعداد يدوي مكثف. المشروع جزء من ثلاثية للمؤلف، إلى جانب Waza (لتدريب العادات) وKami (لإصدار المستندات). **الميزات الرئيسية:** - **تجربة جاهزة للاستخدام:** تتضمن خط JetBrains Mono، وسمات داكنة/فاتحة تلقائية، والنسخ عند التحديد، واختصارات Mac مألوفة. - **التبويبات والأجزاء:** يدعم تقسيم مساحة العمل، والتنقل بين الأجزاء باستخدام Tab Navigator، واستعادة النوافذ والأجزاء وأدلة العمل عند إعادة التشغيل. - **قائمة النقر بزر الفأرة الأيمن:** توفر وصولًا سريعًا إلى اللصق والبحث وفتح محادثة AI وتقسيم/إغلاق الأجزاء دون الحاجة إلى تذكر الاختصارات. - **روابط قابلة للنقر:** Cmd+Click يفتح عناوين URL ومسارات الملفات، مع التفاف تلقائي لعناوين URL للحفاظ على العناوين الكاملة. - **ملائم للذكاء الاصطناعي:** يتكامل مع أدوات البرمجة ويوفر مساعد AI اختياري لاقتراحات الأوامر وتحويل اللغة الطبيعية إلى أوامر والمحادثة. يمكن للمستخدمين تكوين خدمة AI الخاصة بهم عبر `kaku ai`. - **أدوات shell:** تتضمن إكمال zsh، وإبراز الصيغة، والانتقال بين الأدلة، مع اختصارات لتثبيتات اختيارية لـ Lazygit وYazi. - **تكوين Lua:** يسمح بتخصيص الخطوط والسمات والاختصارات وسلوك الطرفية باستخدام نظام تكوين Lua الخاص بـ WezTerm. **التثبيت:** - نزّل DMG من صفحة الإصدارات واسحبه إلى Applications، أو استخدم Homebrew: `brew install --cask kaku`. - بعد الفتح، شغّل `kaku init` لإعداد تكامل shell وتثبيت الأدوات الاختيارية. تحقق من الإصدار باستخدام `kaku --version`. **الاستخدام:** يوفر README جدولًا بالاختصارات الشائعة، بما في ذلك تبويب جديد (Cmd+T)، تقسيم جزء (Cmd+D / Cmd+Shift+D)، لوحة AI (Cmd+Shift+A)، محادثة AI (Cmd+L)، تطبيق اقتراح AI (Cmd+Shift+E)، فتح Lazygit (Cmd+Shift+G)، مدير ملفات Yazi (Cmd+Shift+Y أو y)، مسح الشاشة (Cmd+K)، وفتح قائمة السياق (النقر بزر الفأرة الأيمن). المرجع الكامل لربط المفاتيح موجود في docs/keybindings.md. **مساعد AI:** - كوّنه عبر `kaku ai`؛ لا يوفر Kaku خدمة AI أو يمررها. - اقتراحات الأوامر: عندما يفشل أمر ما، يمكن للمساعد اقتراح إصلاح؛ اضغط Cmd+Shift+E للصقه. - اللغة الطبيعية إلى أمر: اكتب `# <description>` واضغط Enter لإنشاء أمر. - المحادثة: اضغط Cmd+L لمناقشة مخرجات الطرفية أو العمل مع ملفات المشروع؛ `kaku chat` من shell آخر يصل إلى نفس مخزن المحادثات. - تكوين أدوات AI: إدارة الإعدادات لـ Claude Code وCodex وGemini CLI وCopilot CLI وKimi Code والمزيد. **أبرز الأسئلة الشائعة:** - لنظام macOS فقط؛ لا يوجد إصدار Windows أو Linux حاليًا. - مختلف عن iTerm2 أو Warp أو Ghostty أو WezTerm؟ راجع kaku.fun/compare. - النوافذ الشفافة: اضبط `config.window_background_opacity` في `~/.config/kaku/kaku.lua`. - إذا كان أمر `kaku` مفقودًا، شغّل `/Applications/Kaku.app/Contents/MacOS/kaku init --update-only && exec zsh -l`، ثم `kaku doctor`. **التوثيق:** - الموقع: kaku.fun (وثائق بالإنجليزية/الصينية) - المقارنة: kaku.fun/compare - Keybindings وFeatures وConfiguration وCLI Reference وFAQ متاحة في مجلد docs. **الخلفية:** أنشأ المؤلف، وهو مستخدم مكثف لواجهة سطر الأوامر، Kaku بعد سنوات مع Alacritty واستكشاف Kitty وGhostty وWarp وiTerm2، بحثًا عن توازن بين الأداء والإعدادات الافتراضية والتحكم. كانت متانة WezTerm وقابليته للتعديل بمثابة الأساس. **الدعم والترخيص:** - الدعم عبر Mole for Mac (تطبيق مدفوع)، أو وضع نجمة/مشاركة، أو رعاية قطط المؤلف. - رخصة MIT؛ الإسناد لـ WezTerm والخطوط المضمنة في NOTICE.md.