نسخة Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Hy Memory 2.0 يمنح الوكلاء ثلاث طرق للاحتفاظ بالسياق

> تفصل حزمة SDK المسماة Hy Memory 2.0.1 من Tencent بين استرجاع ذاكرة الدردشة والعمل والبرمجة. لتطبيق MemHub شيفرة مصدرية، لكن لا ملفات إصدار متاحة للجمهور بعد؛ ولا يزال الدمج يتطلب نقاط نهاية للنماذج وحدود وصول صريحة.

By BIG CHANGE Editorial

Published: 2026-10-16T14:13:14.740Z
Updated: 2026-10-16T14:13:14.740Z
Canonical: https://bigchange.ai/blog/hy-memory-2-sdk-chat-work-coding-context

![Conceptual charcoal illustration of a three-drawer cabinet: blank conversation slips, tool tokens and layered revision strips sit in separate drawers.](https://bigchange.ai/api/media/file/hy-memory-three-scopes-v1.png)
AI-generated conceptual illustration by BIG CHANGE; not a Hy Memory product interface or tested result.

نشرت Tencent حزمة `hy-memory==2.0.1`، وهي SDK بلغة Python للاحتفاظ بالسياق واسترجاعه من جلسات الدردشة والعمل والبرمجة. الشيفرة عامة؛ أما تطبيق MemHub المرافق فلا يزال شيفرة مصدرية تنتظر ملفات إصدار متاحة للجمهور. يستطيع المطورون الذين يقيّمون طبقة ذاكرة مشتركة استخدام SDK الآن، لكن عليهم توفير نقاط نهاية للنماذج والتضمين وتحديد سجلات الجلسات التي يجوز لكل وكيل قراءتها.

يؤرّخ [سجل تغييرات المشروع](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) إصدار Hy Memory 2.0.1 في 16 أكتوبر 2026. ويسجل [PyPI](https://pypi.org/project/hy-memory/2.0.1/) رفع الحزمة في 15 أكتوبر، كما قُدّمت [الورقة البحثية للنموذج](https://arxiv.org/abs/2610.22196) المرتبطة به في اليوم نفسه. هذه سجلات نشر منفصلة، وليست دليلاً على طرح منتج سطح المكتب.

## التغيير الكبير

- **ما الذي تغيّر:** تتيح SDK المنشورة مسارات ذاكرة منفصلة للدردشة والعمل والبرمجة عبر `add()` و `search()`، مع مرشحات للمصدر ومساحة العمل يمكن للتطبيق الذي يدمجها استخدامها.
- **كيف تعمل:** تنظّم الدردشة المحادثات في طبقات ذاكرة. ويستخرج مسار العمل حقيقة واحدة عن الجلسة، وعند الحاجة خبرات قابلة لإعادة الاستخدام، من سجل تنفيذ الأدوات. وتضيف البرمجة سلسلة إصدارات لتغييرات الشيفرة. وتوفّر الجهة المستدعية المادة المصدرية والهويات وإعدادات التخزين وخدمات النماذج.
- **لماذا يهم ذلك:** تستطيع البيئة المضيفة للوكيل استرجاع سجل مختصر لمحادثات سابقة أو قرارات تخص المهام بدلاً من تمرير التاريخ كله إلى كل جلسة جديدة. وتظل دقة السجل وكونه مصرّحاً به وفائدته معتمدة على ما ترسله البيئة المضيفة والذكريات التي تسمح بإعادتها إلى الموجّه.

## اختر مسار العمل قبل الدمج

يصف [README الخاص بحزمة SDK](https://github.com/Tencent-Hunyuan/Hy-Memory) ثلاث قيم للمعامل `scene`. ويقبل `chat` نصاً عادياً أو مصفوفات رسائل، ثم يعيد قنوات الاسترجاع `profile` و `normal` و `proactive`. وفي وضع `lite` يخزّن النص الخام للبحث بالتضمين من دون استخلاص بواسطة LLM. ويضيف `pro` الاستخلاص والتوفيق بين المعلومات؛ أما `ultra` فيمكنه إجراء جولة تطوير إضافية عبر `evolve()`.

بالنسبة إلى `working`، يجب أن يتضمن الإدخال سجلاً لاستدعاءات الأدوات. وتنتج الجلسة حقيقة واحدة عن المهمة والمنهج والنتيجة، إضافة إلى صفر أو أكثر من الخبرات القابلة لإعادة الاستخدام التي تتجاوز عتبة القيمة لدى المحرك. ويستخدم `coding` الطبقتين نفسيهما ويضيف سلسلة تطوّر إصدارات للشيفرة التي جرى تعديلها. ويقول README إن السلسلة يمكن أن تستخدم فروق Git المحلية إذا ضُبط `MEMORY_CODING_CHAIN_REPO_ROOT`، أو إجراءات استبدال حتمية في سجل الأدوات. وفي وضع `lite` تتجاهل SDK التمييز بين سيناريوَي العمل والبرمجة وتخزّن الذاكرة الخام.

تخدم بُنى المخرجات هذه أسئلة مختلفة. فتفضيل ظهر في محادثة مكانه `chat`؛ والمهمة المكتملة مع نتائج أدوات مكانها `working`؛ وتغيير الشيفرة الذي قد تهم مراجعته السابقة مكانه `coding`. هذا تمييز توجيه موثّق، وليس اختبار أداء أجرته BIG CHANGE.

## مسار موثّق لاستخدام SDK

يستند التسلسل التالي إلى [دليل البدء السريع في المستودع](https://github.com/Tencent-Hunyuan/Hy-Memory) و[دليل إعداد SDK في MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md). لم تشغّل BIG CHANGE الحزمة ولم تجرِ استدعاءات للنماذج.

استخدم Python 3.9 أو أحدث وثبّت إصدار SDK المحدد:

```bash
pip install hy-memory==2.0.1
```

تندرج ChromaDB وKuzu ضمن الاعتماديات الأساسية؛ أما Qdrant وFAISS وNeo4j وذاكرة MySQL المؤقتة ونموذج إعادة الترتيب المحلي فلها إضافات منفصلة. وتختلف بيئة تطوير الشيفرة المصدرية لـMemHub: فهي تتطلب Node.js 24 وpnpm 11 وPython 3.12 وuv.

اضبط نقطة نهاية LLM ونقطة نهاية للتضمين قبل تهيئة العميل. يسرد README المعاملات `MEMORY_LLM_API_KEY` و `MEMORY_LLM_BASE_URL` و `MEMORY_LLM_MODEL`، ومتغيرات `MEMORY_EMBEDDER_*` المقابلة، إضافة إلى `MEMORY_EMBEDDING_DIMS`؛ ويوثّق أيضاً استخدام `OPENAI_API_KEY` افتراضياً. وفّر عناوين URL لنقاط النهاية وأسماء النماذج والمفاتيح وأبعاد التضمين المتوافقة الخاصة بك. هذه واجهات متوافقة مع OpenAI، وليست اشتراطاً لاستخدام نموذج Tencent المنفصل Hy-Memory-30B. أبقِ بيانات الاعتماد خارج السجلات التي تُخزَّن.

يستخدم مثال الدردشة التالي واجهات API الموثّقة `MemoryConfig.from_env()` و `HyMemoryClient` و `add()` و `search()`. ويجب أن يوفّر التطبيق المستدعي `authorized_messages` كنص عادي أو رسائل بصيغة OpenAI، ومعرّف `user_id` ثابتاً ومصرّحاً به، إضافة إلى `query`. ويعرض المثال القيمة المعادة من دون الادعاء بتحقيق نتيجة بعينها:

```python
from hy_memory import HyMemoryClient, MemoryConfig

def write_and_recall(authorized_messages, user_id, query):
    config = MemoryConfig.from_env()  # Caller supplies LLM and embedding settings.
    client = HyMemoryClient(config=config, mode="pro")
    try:
        client.add(authorized_messages, user_id=user_id)
        return client.search(query, user_ids=[user_id], limit=10)
    finally:
        client.close()
```

للعمل أو البرمجة، مرّر سجل رسائل يتضمن استدعاء أداة أو إدخالاً من نوع `role="tool"` واضبط `scene` صراحة. واضبط `workspace_id` لعزل مواد المشروع؛ إذ يتطلبه `branch`. واضبط `source` عند الكتابة، و `include_sources` أو `exclude_sources` عند البحث حين تكون حدود التطبيق المستدعي مهمة. يعيد بحث الدردشة قنوات ذاكرة؛ ويعيد بحث العمل أو البرمجة `facts` و `experiences`، مع `chain_block` للبرمجة. افحص السجلات المعادة قبل تسليمها إلى البيئة المضيفة للوكيل. وتوفّر `list_memories` و `get` و `update` و `delete` إدارة على مستوى السجل الواحد.

يفترض في الدمج الناجح وجود سجل محفوظ من إدخال مصرّح به ونتيجة بحث محددة النطاق تجيب عن سؤال الاسترجاع المقصود. يوثّق README حقول الإرجاع، لكننا لم نشاهد تشغيلاً يتيح لنا الادعاء بنجاح الاستخلاص أو الاسترجاع. إذا كان بحث العمل أو البرمجة فارغاً، فتحقق أولاً من أن الكتابة تضمنت نتائج أدوات واستخدمت `pro` أو `ultra`، ثم تحقق من استخدام القيم نفسها للمعاملات `user_id` و `workspace_id` و `branch` ومرشحات المصدر. وإذا غيّرت نموذج التضمين أو أبعاده، فإن [دليل إعداد MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) يحذّر من أن المجموعة القائمة لا يمكن ببساطة إعادة استخدامها بعرض متجه مختلف.

## MemHub والنموذج خياران منفصلان

MemHub هو منتج سطح المكتب وCLI المقترح المبني على SDK. ويصف [README](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md) الخاص به بيئة تشغيل محلية مُدارة وموصلات للمصادر وتكاملات مع البيئات المضيفة. أما [سجل التغييرات](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) فهو أدق بشأن الإتاحة: توجد الشيفرة المصدرية للإصدار 1.0.0، البناء 4، لكن النشر على npm وملفات إصدار GitHub لا يزالان قيد الانتظار. ويحدد [دليل التثبيت](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) Linux وmacOS منصتين مستهدفتين للإصدار، ويقول إن Windows غير مدعوم؛ وتسلسل التثبيت عبر npm مشروط بنشر تلك الملفات. تعامل معه حالياً باعتباره مسار تثبيت مخططاً له.

ولا يعني التخزين المحلي أن كل خطوة معالجة تبقى محلية. تفصل [وثيقة الخصوصية](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) في MemHub بين الإذن بقراءة مصدر محادثة، والإذن بإرسال مادة مصرّح بها إلى خدمة نماذج خارجية مختارة، والإذن للبيئة المضيفة للوكيل باسترجاع الذاكرة. وتقول إن الأدلة المصدرية الخام تُخزَّن في مجلد البيانات المحلي، وإن خدمة النموذج الخارجية، عند اختيارها، تتلقى المحتوى المصرّح به اللازم للمهمة المختارة. وعلى من يدمج SDK مباشرة تطبيق ضوابطه الخاصة للموافقة على المصادر والوصول إلى النماذج والاسترجاع لدى المضيف؛ ويقول [دليل الدمج](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) في MemHub إن جسر المنتج يضيف خطوات الحوكمة هذه بدلاً من مجرد استدعاء SDK.

أصدرت Tencent أيضاً [Hy-Memory-30B-A3B](https://huggingface.co/tencent/Hy-Memory-30B-A3B)، وهو نموذج مدرَّب على كتابة الذاكرة، مع [تقرير تقني](https://arxiv.org/abs/2610.22196) قُدّم في 15 أكتوبر. ويدّعي التقرير التفوق على الأنظمة المقارنة ضمن عينات فرعية ثابتة من الاختبارات المعيارية. هذا تقييم للنموذج يورده المورّد، وليس دليلاً مستقلاً على أن SDK أو MemHub يحسّنان إجابات وكيل منشور للاستخدام. وتقبل SDK خدمات نماذج متوافقة أخرى.

يشير [ملف ترخيص المستودع الحالي](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/LICENSE) وبيانات المشروع الوصفية إلى Apache-2.0. ويقول سجل التغييرات إن هذا الترخيص اعتُمد بعد رفع 2.0.1، الذي لا تزال [بياناته الوصفية غير القابلة للتغيير على PyPI](https://pypi.org/project/hy-memory/2.0.1/) تشير إلى MIT. تنزيل الحزمة مجاني، لكن خدمة النماذج أو التضمين المختارة قد تفرض رسوماً على الطلبات؛ ولا توثّق مواد الإصدار سعراً تشغيلياً موحّداً للجميع. لذا فالقرار العملي هو مسار الذاكرة وحدّ التفويض اللذان سيجري دمجهما، مع قياس رسوم المزوّد وجودة الاسترجاع في إعداد المطور نفسه.

## المصادر وقراءات إضافية

- [مستودع Hy-Memory ودليل البدء السريع](https://github.com/Tencent-Hunyuan/Hy-Memory) — سيناريوهات SDK الحالية وأمثلة API والأوضاع وخيارات التخزين ومرشحات المصادر.
- [سجل تغييرات الإصدارات](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) و [PyPI 2.0.1](https://pypi.org/project/hy-memory/2.0.1/) — تواريخ نشر SDK المنفصلة ومتطلبات الحزمة وحالة MemHub واختلاف بيانات الترخيص الوصفية.
- [README الخاص بـMemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md)، و [دليل دمج SDK](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) و [وثيقة الخصوصية](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) — بنية المنتج في مرحلة الشيفرة المصدرية وإعداداته وحدود التفويض.
- [دليل تثبيت MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) — المنصات المقصودة ومسار ملفات الإصدار المشروط.
- [تقرير Hy-Memory-30B-A3B](https://arxiv.org/abs/2610.22196) — مسودة بحثية وتقييم للنموذج يورده المؤلفون؛ لا يتحقق من هذا الدمج في الاستخدام الفعلي.

## Sources

- [مستودع Hy-Memory وREADME](https://github.com/Tencent-Hunyuan/Hy-Memory) — سيناريوهات SDK وأوضاعها وأمثلة API والتخزين والمرشحات؛ إعلان الإصدار في README يذكر الشهر فقط.
- [سجل تغييرات Hy-Memory](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/CHANGELOG.md) — يؤرّخ SDK 2.0.1 ويذكر افتقار MemHub إلى ملفات إصدار عامة؛ ويشرح بيانات ترخيص PyPI الوصفية غير القابلة للتغيير.
- [hy-memory 2.0.1 على PyPI](https://pypi.org/project/hy-memory/2.0.1/) — الحزمة المنشورة ومتطلب Python وتواريخ ملفات الإصدار وبيانات MIT الوصفية عند الرفع.
- [README الخاص بـMemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/README.md) — بنية مصدر المنتج ومتطلبات التطوير، لا دليل على إصدار التطبيق للجمهور.
- [دليل دمج الذاكرة في MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/MEMORY.md) — إعداد SDK وعرض التضمين وحدود جسر المنتج.
- [وثيقة خصوصية MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/PRIVACY.md) — أذونات منفصلة للمصدر ومعالجة النماذج واسترجاع الذاكرة لدى المضيف.
- [دليل تثبيت MemHub](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/memhub/docs/INSTALLATION.md) — مسار تثبيت الحزمة المشروط والمنصات المستهدفة.
- [المسودة البحثية لـHy-Memory-30B-A3B](https://arxiv.org/abs/2610.22196) — نموذج منفصل ومنهج تدريب واختبار معياري يورده المورّد؛ لم يُتحقق منه بصورة مستقلة.
- [ملف LICENSE الحالي في المستودع](https://github.com/Tencent-Hunyuan/Hy-Memory/blob/main/LICENSE) — نص المصدر الحالي بترخيص Apache-2.0؛ تحتفظ PyPI 2.0.1 ببيانات MIT الوصفية.