Reference OS v8 5 دقائق قراءة ٢٢ يوليو ٢٠٢٦ informational + تقييم أداة جديدة CodeAlmanac: دليل عملي لتحويل محادثاتك مع AI إلى ويكي كود مفتوح المصدر بعد قراءة هذا الدليل، ستتمكن من تثبيت CodeAlmanac…
Show HN: CodeAlmanac – Karpathy-style codebase wiki from your conversations
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن توثيق الكود يدوياً هو الطريقة الوحيدة، لكن هناك أداة جديدة تفعل ذلك تلقائياً من محادثاتك مع AI.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت مطوراً عربياً وتستخدم ChatGPT أو Claude أو GitHub Copilot لتوليد الكود، فأنت تعلم أن هذه المحادثات تحتوي على حلول قيمة، لكنها غالباً ما تضيع بين آلاف الرسائل. توثيق هذه المعرفة يدوياً مرهق وسرعان ما يصبح قديماً. هنا يأتي دور CodeAlmanac، أداة مفتوحة المصدر ظهرت على Hacker News من فريق Almanac (YC S26)، تهدف إلى تحويل محادثاتك مع مساعدي البرمجة إلى ويكي كود منظم ومتجدد تلقائياً.
في هذا الدليل، سنشرح لك ما هو CodeAlmanac، لمن يفيد، وكيف تثبته محلياً (مع الإشارة إلى أن README غير واضح والخطوات تقريبية)، وما هي حدوده حالياً. الهدف هو تمكينك من تجربة الأداة وتقييمها بنفسك، دون مبالغة أو وعود كاذبة.
المشكلة الأساسية: محادثاتك مع مساعدي البرمجة تحتوي على معرفة قيمة (كود، حلول، شروحات) لكنها غير منظمة وسهلة النسيان. التوثيق اليدوي يستغرق وقتاً ويصبح قديماً بسرعة. CodeAlmanac يحل هذه المشكلة بأتمتة عملية التوثيق.
لمن هذا: مطور عربي يستخدم ChatGPT/Claude بانتظام، يعمل على مشاريع صغيرة أو متوسطة، ويريد توثيق معرفته دون جهد إضافي. صاحب مشروع صغير في الخليج لديه قاعدة كود Laravel ويستخدم مساعدي AI. صانع محتوى تقني يشرح مشاريع GitHub ويحتاج توثيقاً سريعاً.
ليس له: من لا يستخدم مساعدي برمجة، أو يفضل التوثيق اليدوي الكامل، أو يحتاج توثيقاً فورياً لمشروع ضخم مع متطلبات CI/CD معقدة.
ملاحظة مهمة: README المشروع غير واضح حالياً، والخطوات التالية تقريبية بناءً على بنية المشروع. قد تختلف الخطوات الفعلية عند تحديث README.
git clone https://github.com/AlmanacCode/codealmanac.gitcd codealmanacnpm installnpm start أو node index.js (حسب هيكل المشروع)قم بإنشاء ملف .env في جذر المشروع بالمحتوى التالي:
OPENAI_API_KEY=your-openai-api-key-here
CODEALMANAC_PORT=3000
CODEALMANAC_WIKI_DIR=./wikiOPENAI_API_KEY: مفتاح API من OpenAI (ضروري لتحليل المحادثات). CODEALMANAC_PORT: المنفذ المحلي (اختياري، الافتراضي 3000). CODEALMANAC_WIKI_DIR: مسار حفظ ملفات الويكي.
بعد تثبيت الاعتماديات وإعداد .env، شغل الأمر npm start. ستظهر رسالة تفيد بأن الخادم يعمل على المنفذ المحدد. افتح المتصفح على http://localhost:3000 لرؤية الويكي. قد تحتاج لاستيراد محادثاتك السابقة (الطريقة غير موثقة بعد).
مثال 1: مطور سعودي يستخدم ChatGPT لكتابة كود API، ثم يستخدم CodeAlmanac لإنشاء صفحة wiki تشرح endpoints تلقائياً. يمكنه مشاركة الويكي مع فريقه دون الحاجة لكتابة يدوية.
مثال 2: صاحب مشروع صغير في الإمارات لديه قاعدة كود Laravel ويستخدم Claude لتعديلها. CodeAlmanac يوثق كل تغيير تلقائياً، مما يسهل تتبع التعديلات.
مثال 3: صانع محتوى تقني عربي يشرح مشروع GitHub، يستخدم CodeAlmanac لتوليد وثائق سريعة للمشاهدين.
CodeAlmanac فكرة واعدة، لكنه في مرحلة مبكرة جداً. README غير واضح، والتثبيت تقريبي. إذا كنت من عشاق التجارب المبكرة ولا تمانع بعض الصعوبات، جربه. أما إذا كنت تبحث عن حل مستقر وجاهز، فانتظر بضعة أشهر.
نعم، المشروع مفتوح المصدر ومجاني. لكن قد تحتاج لمفتاح API من OpenAI (مدفوع) إذا كنت تستخدم ChatGPT.
حالياً يدعم ChatGPT وClaude وGitHub Copilot، لكن قد يتطلب تعديلات بسيطة.
نعم، الويكي يعرض نصوصاً عربية إذا كانت المحادثات بالعربية.
RAM 4GB على الأقل، CPU متوسط. يعمل على معظم الأجهزة الحديثة.
يحتاج لتهيئة يدوية حالياً. يمكنك وضع ملفات الويكي في مجلد مشروعك.
نعم، يمكنك نشر مجلد الويكي على أي خدمة استضافة ثابتة (مثل GitHub Pages).
يمكنك تشغيل نسخ متعددة على منافذ مختلفة.
لم يذكر الفريق ذلك، لكنه ممكن في المستقبل.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ للحصول على الكود المصدري للأداة
كيف؟ git clone https://github.com/AlmanacCode/codealmanac.git
الناتج: مجلد codealmanac على جهازك
لماذا؟ لتجهيز بيئة التشغيل
كيف؟ cd codealmanac && npm install
الناتج: تثبيت جميع الحزم المطلوبة
لماذا؟ لتزويد الأداة بمفتاح API والإعدادات
كيف؟ أنشئ ملف .env بالمحتوى: OPENAI_API_KEY=your-key CODEALMANAC_PORT=3000 CODEALMANAC_WIKI_DIR=./wiki
الناتج: ملف تكوين جاهز
لماذا؟ لبدء الخادم المحلي
كيف؟ npm start
الناتج: خادم يعمل على http://localhost:3000
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=your-openai-api-key-here CODEALMANAC_PORT=3000 CODEALMANAC_WIKI_DIR=./wiki
اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت من عشاق التجارب المبكرة ولا تمانع صعوبات التثبيت
إذن: جرب CodeAlmanac الآن
إذا: إذا كنت تبحث عن حل مستقر وجاهز
إذن: انتظر بضعة أشهر أو استخدم بدائل مثل Docusaurus
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. مفتوح المصدر ومجاني بالكامل
2. يعمل محلياً على جهازك (خصوصية كاملة)
3. يتكامل مع ChatGPT، Claude، GitHub Copilot
4. يحدث الويكي تلقائياً مع كل محادثة
5. ينتج ملفات Markdown منظمة
6. يتطلب Node.js 18+ و npm
7. README غير واضح حالياً
8. يدعم اللغة العربية في الويكي
9. يمكن نشره على GitHub Pages
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
موقع ويب يسمح للمستخدمين بإضافة وتحرير المحتوى بشكل تعاوني، هنا يشير إلى مجموعة صفحات Markdown منظمة.
مفتاح سري يسمح للتطبيقات بالتواصل مع خدمة معينة، مثل OpenAI.
لغة تنسيق خفيفة تستخدم لكتابة النصوص بتنسيق بسيط، تتحول إلى HTML.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من مطور يضيع معرفته في محادثات AI إلى مطور يمتلك ويكي كود منظم ومتجدد تلقائياً.
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
CodeAlmanac فكرة واعدة، لكنه في مرحلة مبكرة. إذا كنت من عشاق التجارب المبكرة، جربه الآن. وإلا، تابع تطوره. على أي حال، أنت الآن تملك دليلاً عملياً يختصر عليك وقت التجربة. شاركنا تجربتك في التعليقات.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
