🧬 HCS: ملفات سياق للذكاء الاصطناعي تذكر مصادرها وتتحقق من نفسها

npm install -g @oufrid/hcs-cli
hcs check project.hcs

المشكلة

كل من يعمل مع وكلاء الذكاء الاصطناعي يكتب ملفات سياق: AGENTS.md وCLAUDE.md وملخّصات الجلسات وملاحظات المشاريع. وأنا أفعل ذلك بنفسي لهذا الموقع ولتطبيقاتي على أندرويد. ولهذه الملفات ثلاث نقاط عمياء.

1. لا أحد يعرف ما فقده الملخّص. نلخّص مشروعاً من عشرات آلاف الرموز (tokens) في بضع مئات من الأسطر، ولا يوجد رقم يقول ما الذي ضاع.
2. تتقادم في صمت. يتغيّر الكود ولا يتغيّر ملف السياق، فيصدّق النموذج شيئاً خاطئاً دون أن ينبّه أي شيء إلى ذلك.
3. لا يمكن تتبّعها. حين يؤكد الملف معلومة، لا شيء يدل على مصدرها ولا على المكان الذي يجب التحقق منه.

أتناول هذا بتفصيل، مع الحلول التي لا تحتاج إلى أي أداة، في دليل تحسين سياق الذكاء الاصطناعي. أما HCS فيعالج المشاكل الثلاث معاً.

كيف يعمل HCS

يحتوي ملف .hcs على معلومات قصيرة ومرقّمة عن المشروع، وكل معلومة مربوطة بمصدرها عبر مرساة (anchor) مع بصمة رقمية.

#c7 Shipping costs a base fee of 25 plus 4 per kg, and parcels over 30 kg are refused.
  > src/rates.ts::shippingFee #9c1e0f2a3b4d
#c8 Refunds are accepted within 14 days of delivery.
  > docs/policy.md::"Refund policy" #77aa01b2c3d4

ومن ذلك تنتج ثلاث خصائص:

• قابل للتتبّع. كل معلومة تذكر مصدرها: دالة أو صنف أو عنوان في وثيقة أو مجموعة أسطر. يعرف النموذج أين يقرأ بدل أن يخمّن، ويمكنه عبر MCP أن يفتح ذلك المصدر عند الحاجة.
• قابل للتحقق. كل إحالة تحمل بصمة رقمية. الأمر hcs check يكشف المعلومات المتقادمة دون أي نموذج، ويُستعمل في التكامل المستمر. يتجاهل إعادة التنسيق، ويتبع الكود الذي انتقل حتى إلى ملف آخر، ويفشل حين يكون المعنى قد تغيّر.
• مَقيس. يتضمن الملف أسئلة اختبار توجد أجوبتها حرفياً في المصدر. يعطي الأمر hcs score درجة أمانة السياق لنموذج معيّن، مع مجال ثقة، ومقارنة بغياب السياق، ونسبة الحالات التي ضلّل فيها السياقُ النموذج.

يطلب المُترجِم (compiler) من النموذج معلومات تستند كل واحدة منها إلى اقتباس حرفي، ثم يستبعد كل معلومة لا يوجد اقتباسها فعلاً في المصدر. إنه حاجز آلي ضد الملخّصات المختلَقة. ويمكن أيضاً كتابة معلومات يدوياً، وهي غالباً الأثمن: قاعدة مثل «لا تسجّل أبداً رقم بطاقة كاملاً» لا يمكن استنتاجها من الكود.

يعمل HCS مع أي مادة (كود بأي لغة، وثائق، ملاحظات، محادثات) ومع أي نموذج: OpenAI وAnthropic وGemini وGroq وOpenRouter وMistral، أو نموذج محلي عبر Ollama.

ماذا تُظهر القياسات

أردت أرقاماً لا انطباعات. البروتوكول الكامل والنتائج الخام موجودة في تقرير القياس. كل سياق حصل على الميزانية نفسها، أي 2000 رمز، وكُتبت أسئلة الاختبار بشكل منفصل، عبر استدعاءات لم ترَ سياق HCS قط.

• على المستودعات الثلاثة الجديدة (express وrequests وlogrus) سُجّل البروتوكول ومعيار النجاح قبل أي استدعاء للنموذج. الفارق مع الملخّص البسيط: +18,9 نقطة، ومجال الثقة عند 95 % كله فوق الصفر.
• مع نموذج ثانٍ من عائلة أخرى (ministral-14b من Mistral) بقي الفارق قائماً: +18,8 نقطة على المستودعات الخمسة الأولى، و+16,1 نقطة على الثلاثة الجديدة.
• قراءة المصدر أهم حتى من شكل الملخّص. حين يُسمح للنموذج بفتح المصدر الذي تذكره المعلومات، يبلغ HCS نسبة 58,3 % على المستودعات الخمسة الأولى و62,8 % على الثلاثة الجديدة.

وما لم ينجح، أو لم ينجح بعد، مذكور في التقرير نفسه:

• الأمر hcs refine، الذي يضيف معلومات لسدّ الأسئلة الفاشلة، لم يحسّن الأمانة على الأسئلة المحجوزة جانباً، بل أضعفها قليلاً على أحد المستودعات. هو موثّق باعتباره تجربة.
• تنبيهات التبعيات (seal --deps): على تاريخ المشروع نفسه، 17 تنبيهاً من أصل 18 لم تكن ضرورية. توقّع إنذارات كاذبة في الغالب.
• كشف حقن الأوامر (prompt injection) يلتقط 90 % من الهجمات في المجموعة التي ضُبط عليها، لكنه لا يلتقط سوى 47 % (7 من 15) على مجموعة محجوزة جانباً. إنه مرشِّح لا ضمانة.
• حدود البروتوكول: نموذج واحد ترجم الملفات وكتب الأسئلة، وجُرّبت ميزانية واحدة فقط، ومن 24 إلى 30 سؤالاً لكل مستودع.

جرّبه في 5 دقائق

تحتاج إلى Node.js بالإصدار 18.17 أو أحدث، دون أي تبعية تشغيل.

npm install -g @oufrid/hcs-cli          # يثبّت الأمر hcs
hcs init                                # ينشئ ملفاً فارغاً للمعلومات المكتوبة يدوياً
hcs check project.hcs                   # يتحقق من المراسي دون أي نموذج

لترجمة سياق انطلاقاً من مشروعك، يكفي مفتاح مجاني (Gemini أو Groq)، أو نموذج محلي:

export GEMINI_API_KEY=...               # أو GROQ_API_KEY، أو Ollama محلياً
hcs models gemini                       # يعرض النماذج المتاحة لمفتاحك
hcs compile --model gemini:<model> --rpm 8 -o project.hcs
hcs render project.hcs --decoder --budget 2000   # للصق في أي محادثة

يأخذك الدرس التطبيقي من التثبيت إلى سياق مُتحقَّق منه ومُقيَّم في نحو عشر دقائق، على مشروع مثال صغير. وتوجد أيضاً نسخة Python من النواة الحتمية: pip install hcs-format.

ربطه بـ Claude Code أو Cursor أو VS Code

الأمر hcs serve project.hcs خادم MCP (Model Context Protocol). يقرأ الوكيل أولاً بضع مئات من الرموز من المعلومات المُتحقَّق منها، ثم يفتح المصدر الدقيق وراء معلومة ما فقط حين يحتاج إليه، دون أن يضطر لقراءة المستودع كله.

مع Claude Code، داخل مجلد المشروع:

claude mcp add hcs -- hcs serve project.hcs

إعداد نموذجي لباقي العملاء:

{
  "mcpServers": {
    "hcs": { "command": "hcs", "args": ["serve", "project.hcs"] }
  }
}

لم يُختبر حتى الآن سوى Claude Code، مع جلسة مسجّلة. إعدادات Claude Desktop وCursor وVS Code موجودة في توثيق MCP. ولفهم MCP نفسه، راجع دليلي ربط الذكاء الاصطناعي بأدواتك.

الأمان والخصوصية

• ما لا يغادر جهازك أبداً: الأوامر check وseal وrender وstats وimpact وaudit والخادم MCP لا تستدعي أي نموذج ولا أي شبكة.
• ما يرسل نصاً إلى المزوّد الذي تختاره: compile وscore وcurve وcompare وsnapshot. بعض العروض المجانية قد تستعمل أوامرك لتحسين منتجاتها، فلا تترجم بها كوداً خاصاً، أو استعمل نموذجاً محلياً.
• العزل: لا يستطيع خادم MCP قراءة أي شيء خارج مجلد المشروع، بما في ذلك الروابط الرمزية.
• حقن الأوامر: النص الذي يشبه تعليمة موجّهة إلى ذكاء اصطناعي يوسَم suspect ولا يُعرض أبداً بشكل افتراضي. وكما ذُكر أعلاه، يعتمد الكشف على أنماط ويترك نحو نصف الهجمات الجديدة تمرّ.

نموذج التهديدات الكامل موجود في SECURITY.md.

ما ليس HCS

• ليس بلا فقد. لا يوجد ملخّص بلا فقد. HCS يقيس الفقد بدل أن يخفيه.
• ليس ضغطاً سحرياً. المعلومات جمل عادية، وما يوفّر الرموز هو اختيار ما نحتفظ به.
• ليس أصغر دائماً. في مشروع صغير جداً قد يكون السياق أطول من المصدر نفسه. تظهر فائدة HCS حين تكون المادة أكبر مما تريد وضعه في أمر واحد.
• ليس درجة بلا حَكَم. الأجوبة الحرفية تُقيَّم آلياً، والباقي يقيّمه نموذج حَكَم. استعمل حَكَماً من عائلة نماذج أخرى.
• ليس دليلاً على الصحة. الملف الصالح يثبت أن كل اقتباس كان موجوداً في المصدر وأن المصدر لم يتغيّر منذئذ. لا يثبت أن إعادة الصياغة أمينة، ولا أن المصدر نفسه صحيح.

الحالة وخارطة الطريق

• الصيغة مستقرة: SPEC 1.0، المنشورة في 22 أكتوبر 2026. الملفات المكتوبة اليوم ستبقى مقروءة طوال سلسلة الإصدارات 1.x.
• الأداة تجريبية: الإصدار 0.3.0، منشور على npm (@oufrid/hcs-cli) وعلى PyPI (hcs-format). وتجتاز نسخة ثانية مكتوبة بلغة Python مجموعة اختبارات المطابقة نفسها التي تجتازها نسخة TypeScript.
• خارطة الطريق تمر بأربع مراحل: الموثوقية، والتوحيد القياسي، وقدرات جديدة، والمنظومة. وهي منشورة في ROADMAP.md.

صمّمتُ HCS وأشرفتُ على تطويره، الذي أُنجز بمساعدة وكيل برمجة بالذكاء الاصطناعي (Claude Code). قصة المشروع وخياراته وقياساته أرويها في مقال ملفات سياق الذكاء الاصطناعي تتقادم في صمت.

المساهمة

الملاحظات مرحّب بها، وخاصة:

• نتائج قياس على مشاريع حقيقية ونماذج حقيقية؛
• حالات تحديد مواضع الرموز (symbols) للغات أخرى؛
• ملاحظات على المواصفة، التي تتطوّر عبر مسار RFC قصير.

كل شيء يجري على GitHub، مع دليل للمساهمة. وللإبلاغ عن ثغرة أمنية، استعمل زر الإبلاغ الخاص بالثغرات في GitHub، لا قضية (issue) عامة.

الأسئلة الشائعة

هل يعوّض HCS ملف AGENTS.md أو CLAUDE.md؟

لا، يمكن أن يتعايش معهما. الأمر hcs audit AGENTS.md يتحقق من المراجع المعطوبة في ملف موجود، بل ويمكنه قياس ما ينقله فعلاً إلى النموذج بالأسئلة المُتحقَّق منها نفسها.

هل يُرسَل الكود الخاص بي إلى أي مكان؟

فقط إذا شغّلت أمراً يستدعي نموذجاً (compile أو score أو compare أو snapshot)، وإلى المزوّد الذي تختاره وحده. التحقق والعرض وخادم MCP تعمل محلياً بالكامل، ومع Ollama لا يغادر جهازك أي شيء.

هل يجب أن أدفع مقابل نموذج لاستعماله؟

لا. جُرّبت السلسلة كاملة على العروض المجانية لـ Gemini وGroq، ومع نماذج محلية. وحين تنفد الحصة، تحتفظ عملية الترجمة بما أنجزته وتستأنف في التشغيل التالي. غير أن النماذج المحلية الصغيرة على المعالج أعطت نتائج ضعيفة.

إلى أي حد يمكن الوثوق بدرجة الأمانة؟

إنها قياس على عيّنة صغيرة، يُعرض دائماً مع مجال الثقة عند 95 %. مع دزينة من الأسئلة قد يمتد هذا المجال على 50 نقطة. وتتوقف الدرجة على النموذج المجيب والحَكَم والأسئلة: استعمل حَكَماً من عائلة أخرى وقارن دائماً بغياب السياق.

هل ستتغيّر الصيغة مرة أخرى؟

الصيغة مثبّتة في الإصدار 1.0: صياغة المراسي والبصمات وحالات التحقق. كما تقبل أدوات القراءة كل الإصدارات السابقة، وأي تطوير يمر عبر RFC علني. ما يبقى تجريبياً هو أداة سطر الأوامر في إصدارها 0.3.0.