chore(i18n): refresh ar translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
2ccf6c6d36
commit
d7eea54180
@ -1,36 +1,36 @@
|
||||
---
|
||||
read_when:
|
||||
- أنت تريد فهم الغرض من الذاكرة النشطة
|
||||
- تريد تشغيل الذاكرة النشطة لوكيل محادثة
|
||||
- تريد ضبط سلوك الذاكرة النشطة من دون تفعيلها في كل مكان
|
||||
summary: وكيل فرعي لذاكرة الحظر مملوك للمكوّن الإضافي يحقن الذاكرة ذات الصلة في جلسات الدردشة التفاعلية
|
||||
- تريد أن تفهم الغرض من الذاكرة النشطة
|
||||
- تريد تفعيل الذاكرة النشطة لوكيل محادثة
|
||||
- تريد ضبط سلوك الذاكرة النشطة دون تفعيلها في كل مكان
|
||||
summary: وكيل فرعي للذاكرة الحاجزة مملوك للمكوّن الإضافي يحقن الذاكرة ذات الصلة في جلسات الدردشة التفاعلية
|
||||
title: الذاكرة النشطة
|
||||
x-i18n:
|
||||
generated_at: "2026-04-10T07:17:27Z"
|
||||
generated_at: "2026-04-11T07:13:45Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 6a51437df4ae4d9d57764601dfcfcdadb269e2895bf49dc82b9f496c1b3cb341
|
||||
source_hash: e8b0e6539e09678e9e8def68795f8bcb992f98509423da3da3123eda88ec1dd5
|
||||
source_path: concepts/active-memory.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# الذاكرة النشطة
|
||||
|
||||
الذاكرة النشطة هي وكيل فرعي اختياري لذاكرة الحظر مملوك للمكوّن الإضافي ويعمل
|
||||
الذاكرة النشطة هي وكيل فرعي اختياري للذاكرة الحاجزة مملوك للمكوّن الإضافي يعمل
|
||||
قبل الرد الرئيسي في جلسات المحادثة المؤهلة.
|
||||
|
||||
وهي موجودة لأن معظم أنظمة الذاكرة قادرة ولكنها تفاعلية. فهي تعتمد على
|
||||
الوكيل الرئيسي ليقرر متى يبحث في الذاكرة، أو على المستخدم ليقول أشياء
|
||||
مثل "تذكر هذا" أو "ابحث في الذاكرة". وبحلول ذلك الوقت، تكون اللحظة التي كان
|
||||
من الممكن أن تجعل فيها الذاكرة الرد يبدو طبيعيًا قد فاتت بالفعل.
|
||||
مثل "تذكّر هذا" أو "ابحث في الذاكرة". وعند تلك النقطة، تكون اللحظة التي كان
|
||||
يمكن أن تجعل فيها الذاكرة الرد يبدو طبيعيًا قد مرّت بالفعل.
|
||||
|
||||
تمنح الذاكرة النشطة النظام فرصة واحدة محدودة لإظهار الذاكرة ذات الصلة
|
||||
تمنح الذاكرة النشطة النظام فرصة واحدة محدودة لإبراز الذاكرة ذات الصلة
|
||||
قبل إنشاء الرد الرئيسي.
|
||||
|
||||
## الصق هذا في الوكيل الخاص بك
|
||||
## الصق هذا في وكيلك
|
||||
|
||||
الصق هذا في الوكيل الخاص بك إذا كنت تريد أن يفعّل الذاكرة النشطة باستخدام
|
||||
إعداد مكتفٍ ذاتيًا وآمن افتراضيًا:
|
||||
الصق هذا في وكيلك إذا كنت تريد منه تفعيل الذاكرة النشطة باستخدام إعداد
|
||||
مكتفٍ ذاتيًا وآمن افتراضيًا:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -56,18 +56,18 @@ x-i18n:
|
||||
}
|
||||
```
|
||||
|
||||
يؤدي هذا إلى تشغيل المكوّن الإضافي للوكيل `main`، وإبقائه مقصورًا افتراضيًا على
|
||||
الجلسات بأسلوب الرسائل المباشرة، ويسمح له أولًا بوراثة نموذج الجلسة الحالية،
|
||||
ومع ذلك يظل يسمح بالرجوع الاحتياطي البعيد المضمّن إذا لم يتوفر أي نموذج صريح
|
||||
أو موروث.
|
||||
يؤدي هذا إلى تشغيل المكوّن الإضافي لوكيل `main`، ويُبقيه مقصورًا افتراضيًا على
|
||||
الجلسات بنمط الرسائل المباشرة، ويجعله يرث نموذج الجلسة الحالية أولًا، مع
|
||||
السماح أيضًا بالرجوع الاحتياطي المدمج إلى النموذج البعيد إذا لم يتوفر أي نموذج
|
||||
صريح أو موروث.
|
||||
|
||||
بعد ذلك، أعد تشغيل البوابة:
|
||||
|
||||
```bash
|
||||
node scripts/run-node.mjs gateway --profile dev
|
||||
openclaw gateway
|
||||
```
|
||||
|
||||
لمعاينته مباشرة داخل محادثة:
|
||||
لفحصه مباشرة داخل محادثة:
|
||||
|
||||
```text
|
||||
/verbose on
|
||||
@ -75,7 +75,7 @@ node scripts/run-node.mjs gateway --profile dev
|
||||
|
||||
## تشغيل الذاكرة النشطة
|
||||
|
||||
أكثر إعدادات الأمان هي:
|
||||
أكثر إعداد أمانًا هو:
|
||||
|
||||
1. تفعيل المكوّن الإضافي
|
||||
2. استهداف وكيل محادثة واحد
|
||||
@ -109,18 +109,18 @@ node scripts/run-node.mjs gateway --profile dev
|
||||
ثم أعد تشغيل البوابة:
|
||||
|
||||
```bash
|
||||
node scripts/run-node.mjs gateway --profile dev
|
||||
openclaw gateway
|
||||
```
|
||||
|
||||
معنى هذا:
|
||||
ما يعنيه هذا:
|
||||
|
||||
- `plugins.entries.active-memory.enabled: true` يشغّل المكوّن الإضافي
|
||||
- `config.agents: ["main"]` يفعّل الذاكرة النشطة للوكيل `main` فقط
|
||||
- `config.allowedChatTypes: ["direct"]` يُبقي الذاكرة النشطة مفعّلة افتراضيًا فقط للجلسات بأسلوب الرسائل المباشرة
|
||||
- إذا لم يتم تعيين `config.model`، فإن الذاكرة النشطة ترث أولًا نموذج الجلسة الحالية
|
||||
- `config.modelFallbackPolicy: "default-remote"` يُبقي الرجوع الاحتياطي البعيد المضمّن هو الافتراضي عندما لا يتوفر نموذج صريح أو موروث
|
||||
- `config.agents: ["main"]` يفعّل الذاكرة النشطة لوكيل `main` فقط
|
||||
- `config.allowedChatTypes: ["direct"]` يُبقي الذاكرة النشطة مفعّلة افتراضيًا فقط للجلسات بنمط الرسائل المباشرة
|
||||
- إذا لم يتم تعيين `config.model`، فستَرِث الذاكرة النشطة نموذج الجلسة الحالية أولًا
|
||||
- `config.modelFallbackPolicy: "default-remote"` يُبقي الرجوع الاحتياطي المدمج إلى النموذج البعيد هو الخيار الافتراضي عندما لا يتوفر نموذج صريح أو موروث
|
||||
- `config.promptStyle: "balanced"` يستخدم نمط المطالبة الافتراضي للأغراض العامة لوضع `recent`
|
||||
- لا تزال الذاكرة النشطة تعمل فقط على جلسات الدردشة التفاعلية الدائمة المؤهلة
|
||||
- تظل الذاكرة النشطة تعمل فقط في جلسات الدردشة التفاعلية الدائمة المؤهلة
|
||||
|
||||
## كيفية رؤيتها
|
||||
|
||||
@ -130,7 +130,7 @@ node scripts/run-node.mjs gateway --profile dev
|
||||
## تبديل الجلسة
|
||||
|
||||
استخدم أمر المكوّن الإضافي عندما تريد إيقاف الذاكرة النشطة مؤقتًا أو استئنافها
|
||||
لجلسة الدردشة الحالية من دون تعديل الإعدادات:
|
||||
لجلسة الدردشة الحالية دون تعديل الإعدادات:
|
||||
|
||||
```text
|
||||
/active-memory status
|
||||
@ -138,12 +138,12 @@ node scripts/run-node.mjs gateway --profile dev
|
||||
/active-memory on
|
||||
```
|
||||
|
||||
هذا النطاق خاص بالجلسة. ولا يغيّر
|
||||
هذا النطاق خاص بالجلسة. وهو لا يغيّر
|
||||
`plugins.entries.active-memory.enabled` أو استهداف الوكيل أو أي إعداد
|
||||
عام آخر.
|
||||
|
||||
إذا كنت تريد أن يكتب الأمر الإعدادات ويوقف الذاكرة النشطة مؤقتًا أو يستأنفها
|
||||
لكل الجلسات، فاستخدم الصيغة العامة الصريحة:
|
||||
لجميع الجلسات، فاستخدم الصيغة العامة الصريحة:
|
||||
|
||||
```text
|
||||
/active-memory status --global
|
||||
@ -151,26 +151,26 @@ node scripts/run-node.mjs gateway --profile dev
|
||||
/active-memory on --global
|
||||
```
|
||||
|
||||
تكتب الصيغة العامة `plugins.entries.active-memory.config.enabled`. وهي تُبقي
|
||||
تكتب الصيغة العامة القيمة `plugins.entries.active-memory.config.enabled`. وهي تترك
|
||||
`plugins.entries.active-memory.enabled` مفعّلًا حتى يظل الأمر متاحًا
|
||||
لتشغيل الذاكرة النشطة مرة أخرى لاحقًا.
|
||||
|
||||
إذا كنت تريد معرفة ما الذي تفعله الذاكرة النشطة في جلسة مباشرة، ففعّل
|
||||
الوضع المطوّل لتلك الجلسة:
|
||||
إذا كنت تريد رؤية ما تفعله الذاكرة النشطة في جلسة مباشرة، فعّل الوضع المفصل
|
||||
لهذه الجلسة:
|
||||
|
||||
```text
|
||||
/verbose on
|
||||
```
|
||||
|
||||
عند تفعيل الوضع المطوّل، يمكن لـ OpenClaw إظهار:
|
||||
عند تفعيل الوضع المفصل، يمكن لـ OpenClaw عرض ما يلي:
|
||||
|
||||
- سطر حالة للذاكرة النشطة مثل `Active Memory: ok 842ms recent 34 chars`
|
||||
- ملخص تصحيح مقروء مثل `Active Memory Debug: Lemon pepper wings with blue cheese.`
|
||||
|
||||
هذه الأسطر مشتقة من نفس مرور الذاكرة النشطة الذي يغذي سياق
|
||||
هذه السطور مشتقة من نفس تمريرة الذاكرة النشطة التي تغذي سياق
|
||||
النظام المخفي، لكنها منسقة للبشر بدلًا من عرض ترميز المطالبة الخام.
|
||||
|
||||
افتراضيًا، يكون نص جلسة وكيل الذاكرة الفرعي للحظر مؤقتًا ويُحذف
|
||||
افتراضيًا، يكون نص وكيل الذاكرة الحاجزة الفرعي مؤقتًا ويُحذف
|
||||
بعد اكتمال التشغيل.
|
||||
|
||||
مثال على التدفق:
|
||||
@ -196,8 +196,8 @@ what wings should i order?
|
||||
1. **الاشتراك عبر الإعدادات**
|
||||
يجب تفعيل المكوّن الإضافي، ويجب أن يظهر معرّف الوكيل الحالي في
|
||||
`plugins.entries.active-memory.config.agents`.
|
||||
2. **أهلية وقت التشغيل الصارمة**
|
||||
حتى عند التفعيل والاستهداف، لا تعمل الذاكرة النشطة إلا مع
|
||||
2. **أهلية تشغيل صارمة**
|
||||
حتى عند التفعيل والاستهداف، لا تعمل الذاكرة النشطة إلا في
|
||||
جلسات الدردشة التفاعلية الدائمة المؤهلة.
|
||||
|
||||
القاعدة الفعلية هي:
|
||||
@ -214,11 +214,11 @@ eligible interactive persistent chat session
|
||||
active memory runs
|
||||
```
|
||||
|
||||
إذا فشل أي من ذلك، فلن تعمل الذاكرة النشطة.
|
||||
إذا فشل أي من هذه الشروط، فلن تعمل الذاكرة النشطة.
|
||||
|
||||
## أنواع الجلسات
|
||||
|
||||
تتحكم `config.allowedChatTypes` في أنواع المحادثات التي يمكن أن تشغّل الذاكرة
|
||||
يتحكم `config.allowedChatTypes` في أنواع المحادثات التي يمكن أن تشغّل الذاكرة
|
||||
النشطة أصلًا.
|
||||
|
||||
القيمة الافتراضية هي:
|
||||
@ -227,8 +227,8 @@ active memory runs
|
||||
allowedChatTypes: ["direct"]
|
||||
```
|
||||
|
||||
هذا يعني أن الذاكرة النشطة تعمل افتراضيًا في الجلسات بأسلوب الرسائل المباشرة،
|
||||
لكنها لا تعمل في جلسات المجموعات أو القنوات إلا إذا قمت بتفعيلها لها صراحةً.
|
||||
وهذا يعني أن الذاكرة النشطة تعمل افتراضيًا في الجلسات بنمط الرسائل المباشرة،
|
||||
ولكن ليس في جلسات المجموعات أو القنوات إلا إذا فعّلتها لها صراحة.
|
||||
|
||||
أمثلة:
|
||||
|
||||
@ -246,53 +246,53 @@ allowedChatTypes: ["direct", "group", "channel"]
|
||||
|
||||
## أين تعمل
|
||||
|
||||
الذاكرة النشطة ميزة لإثراء المحادثة، وليست ميزة استدلال
|
||||
على مستوى المنصة بالكامل.
|
||||
الذاكرة النشطة هي ميزة لإثراء المحادثة، وليست ميزة استدلال
|
||||
على مستوى المنصة كلها.
|
||||
|
||||
| السطح | هل تعمل الذاكرة النشطة؟ |
|
||||
| السطح | هل تعمل الذاكرة النشطة؟ |
|
||||
| ------------------------------------------------------------------- | ------------------------------------------------------- |
|
||||
| جلسات Control UI / web chat الدائمة | نعم، إذا كان المكوّن الإضافي مفعّلًا وكان الوكيل مستهدفًا |
|
||||
| جلسات القنوات التفاعلية الأخرى على نفس مسار الدردشة الدائم | نعم، إذا كان المكوّن الإضافي مفعّلًا وكان الوكيل مستهدفًا |
|
||||
| التشغيلات غير التفاعلية أحادية الاستخدام | لا |
|
||||
| تشغيلات نبضات الحياة/الخلفية | لا |
|
||||
| مسارات `agent-command` الداخلية العامة | لا |
|
||||
| تنفيذ الوكيل الفرعي/المساعد الداخلي | لا |
|
||||
| جلسات Control UI / دردشة الويب الدائمة | نعم، إذا كان المكوّن الإضافي مفعّلًا وكان الوكيل مستهدفًا |
|
||||
| جلسات القنوات التفاعلية الأخرى على مسار الدردشة الدائمة نفسه | نعم، إذا كان المكوّن الإضافي مفعّلًا وكان الوكيل مستهدفًا |
|
||||
| عمليات التشغيل الأحادية غير التفاعلية | لا |
|
||||
| عمليات heartbeat / الخلفية | لا |
|
||||
| مسارات `agent-command` الداخلية العامة | لا |
|
||||
| تنفيذ الوكلاء الفرعيين/المساعدات الداخلية | لا |
|
||||
|
||||
## لماذا تستخدمها
|
||||
|
||||
استخدم الذاكرة النشطة عندما:
|
||||
|
||||
- تكون الجلسة دائمة وموجّهة للمستخدم
|
||||
- يكون لدى الوكيل ذاكرة طويلة الأمد ذات معنى للبحث فيها
|
||||
- يمتلك الوكيل ذاكرة طويلة الأمد ذات معنى للبحث فيها
|
||||
- تكون الاستمرارية والتخصيص أهم من الحتمية الخام للمطالبة
|
||||
|
||||
وهي تعمل بشكل جيد خاصةً مع:
|
||||
وهي تعمل بشكل جيد خصوصًا مع:
|
||||
|
||||
- التفضيلات الثابتة
|
||||
- التفضيلات المستقرة
|
||||
- العادات المتكررة
|
||||
- سياق المستخدم طويل الأمد الذي ينبغي أن يظهر بشكل طبيعي
|
||||
- سياق المستخدم طويل الأمد الذي ينبغي أن يظهر بصورة طبيعية
|
||||
|
||||
وهي ليست مناسبة لـ:
|
||||
وهي غير مناسبة لـ:
|
||||
|
||||
- الأتمتة
|
||||
- العمال الداخليين
|
||||
- مهام API أحادية الاستخدام
|
||||
- الأماكن التي قد يكون فيها التخصيص المخفي مفاجئًا
|
||||
- العاملين الداخليين
|
||||
- مهام API الأحادية
|
||||
- الأماكن التي سيكون فيها التخصيص المخفي مفاجئًا
|
||||
|
||||
## كيف تعمل
|
||||
|
||||
شكل وقت التشغيل هو:
|
||||
شكل التشغيل هو:
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
U["User Message"] --> Q["Build Memory Query"]
|
||||
Q --> R["Active Memory Blocking Memory Sub-Agent"]
|
||||
R -->|NONE or empty| M["Main Reply"]
|
||||
R -->|relevant summary| I["Append Hidden active_memory_plugin System Context"]
|
||||
I --> M["Main Reply"]
|
||||
U["رسالة المستخدم"] --> Q["بناء استعلام الذاكرة"]
|
||||
Q --> R["وكيل الذاكرة الحاجزة الفرعي للذاكرة النشطة"]
|
||||
R -->|NONE or empty| M["الرد الرئيسي"]
|
||||
R -->|relevant summary| I["إلحاق سياق نظام active_memory_plugin مخفي"]
|
||||
I --> M["الرد الرئيسي"]
|
||||
```
|
||||
|
||||
يمكن لوكيل الذاكرة الفرعي للحظر استخدام ما يلي فقط:
|
||||
لا يمكن لوكيل الذاكرة الحاجزة الفرعي استخدام سوى:
|
||||
|
||||
- `memory_search`
|
||||
- `memory_get`
|
||||
@ -301,20 +301,20 @@ flowchart LR
|
||||
|
||||
## أوضاع الاستعلام
|
||||
|
||||
تتحكم `config.queryMode` في مقدار المحادثة التي يراها وكيل الذاكرة الفرعي للحظر.
|
||||
يتحكم `config.queryMode` في مقدار المحادثة الذي يراه وكيل الذاكرة الحاجزة الفرعي.
|
||||
|
||||
## أنماط المطالبة
|
||||
|
||||
يتحكم `config.promptStyle` في مدى حماس أو صرامة وكيل الذاكرة الفرعي للحظر
|
||||
يتحكم `config.promptStyle` في مدى الحماس أو الصرامة لدى وكيل الذاكرة الحاجزة الفرعي
|
||||
عند اتخاذ قرار ما إذا كان سيعيد ذاكرة أم لا.
|
||||
|
||||
الأنماط المتاحة:
|
||||
|
||||
- `balanced`: الافتراضي العام لوضع `recent`
|
||||
- `balanced`: الخيار الافتراضي العام لوضع `recent`
|
||||
- `strict`: الأقل حماسًا؛ الأفضل عندما تريد أقل قدر ممكن من التأثر بالسياق القريب
|
||||
- `contextual`: الأكثر ملاءمة للاستمرارية؛ الأفضل عندما يكون لتاريخ المحادثة أهمية أكبر
|
||||
- `recall-heavy`: أكثر استعدادًا لإظهار الذاكرة عند وجود تطابقات أخف لكنها لا تزال محتملة
|
||||
- `precision-heavy`: يفضّل `NONE` بقوة ما لم يكن التطابق واضحًا
|
||||
- `recall-heavy`: أكثر استعدادًا لإبراز الذاكرة عند وجود تطابقات أضعف لكنها لا تزال معقولة
|
||||
- `precision-heavy`: يفضّل `NONE` بشدة ما لم يكن التطابق واضحًا
|
||||
- `preference-only`: مُحسّن للمفضلات والعادات والروتين والذوق والحقائق الشخصية المتكررة
|
||||
|
||||
التعيين الافتراضي عندما لا يتم تعيين `config.promptStyle`:
|
||||
@ -325,7 +325,7 @@ recent -> balanced
|
||||
full -> contextual
|
||||
```
|
||||
|
||||
إذا قمت بتعيين `config.promptStyle` صراحةً، فستكون هذه القيمة المتجاوزة هي المعتمدة.
|
||||
إذا عيّنت `config.promptStyle` صراحة، فستكون لهذا التعيين أولوية.
|
||||
|
||||
مثال:
|
||||
|
||||
@ -335,7 +335,7 @@ promptStyle: "preference-only"
|
||||
|
||||
## سياسة الرجوع الاحتياطي للنموذج
|
||||
|
||||
إذا لم يتم تعيين `config.model`، فإن الذاكرة النشطة تحاول حل نموذج بهذا الترتيب:
|
||||
إذا لم يتم تعيين `config.model`، تحاول الذاكرة النشطة تحديد نموذج بهذا الترتيب:
|
||||
|
||||
```text
|
||||
explicit plugin model
|
||||
@ -344,7 +344,7 @@ explicit plugin model
|
||||
-> optional built-in remote fallback
|
||||
```
|
||||
|
||||
تتحكم `config.modelFallbackPolicy` في الخطوة الأخيرة.
|
||||
يتحكم `config.modelFallbackPolicy` في الخطوة الأخيرة.
|
||||
|
||||
الافتراضي:
|
||||
|
||||
@ -359,13 +359,13 @@ modelFallbackPolicy: "resolved-only"
|
||||
```
|
||||
|
||||
استخدم `resolved-only` إذا كنت تريد من الذاكرة النشطة تخطي الاسترجاع بدلًا من
|
||||
الرجوع إلى الافتراضي البعيد المضمّن عندما لا يتوفر نموذج صريح أو موروث.
|
||||
الرجوع إلى الافتراضي البعيد المدمج عندما لا يتوفر نموذج صريح أو موروث.
|
||||
|
||||
## منافذ هروب متقدمة
|
||||
## منافذ الهروب المتقدمة
|
||||
|
||||
هذه الخيارات ليست عمدًا جزءًا من الإعداد الموصى به.
|
||||
هذه الخيارات ليست جزءًا من الإعداد الموصى به عن قصد.
|
||||
|
||||
يمكن لـ `config.thinking` تجاوز مستوى التفكير لوكيل الذاكرة الفرعي للحظر:
|
||||
يمكن لـ `config.thinking` تجاوز مستوى التفكير الخاص بوكيل الذاكرة الحاجزة الفرعي:
|
||||
|
||||
```json5
|
||||
thinking: "medium"
|
||||
@ -377,18 +377,18 @@ thinking: "medium"
|
||||
thinking: "off"
|
||||
```
|
||||
|
||||
لا تفعّل هذا افتراضيًا. تعمل الذاكرة النشطة ضمن مسار الرد، لذلك فإن وقت
|
||||
التفكير الإضافي يزيد مباشرةً من زمن الاستجابة المرئي للمستخدم.
|
||||
لا تفعّل هذا افتراضيًا. تعمل الذاكرة النشطة في مسار الرد، لذا فإن وقت
|
||||
التفكير الإضافي يزيد مباشرة من زمن الاستجابة الذي يراه المستخدم.
|
||||
|
||||
يضيف `config.promptAppend` تعليمات إضافية للمشغّل بعد مطالبة الذاكرة النشطة
|
||||
الافتراضية وقبل سياق المحادثة:
|
||||
يضيف `config.promptAppend` تعليمات إضافية للمشغّل بعد مطالبة
|
||||
الذاكرة النشطة الافتراضية وقبل سياق المحادثة:
|
||||
|
||||
```json5
|
||||
promptAppend: "Prefer stable long-term preferences over one-off events."
|
||||
```
|
||||
|
||||
يستبدل `config.promptOverride` مطالبة الذاكرة النشطة الافتراضية. ولا يزال OpenClaw
|
||||
يضيف سياق المحادثة بعد ذلك:
|
||||
يستبدل `config.promptOverride` مطالبة الذاكرة النشطة الافتراضية. ويواصل OpenClaw
|
||||
إلحاق سياق المحادثة بعد ذلك:
|
||||
|
||||
```json5
|
||||
promptOverride: "You are a memory search agent. Return NONE or one compact user fact."
|
||||
@ -396,11 +396,11 @@ promptOverride: "You are a memory search agent. Return NONE or one compact user
|
||||
|
||||
لا يُنصح بتخصيص المطالبة إلا إذا كنت تختبر عمدًا
|
||||
عقد استرجاع مختلفًا. فالمطالبة الافتراضية مضبوطة لإرجاع `NONE`
|
||||
أو سياقًا مدمجًا لحقائق المستخدم للنموذج الرئيسي.
|
||||
أو سياق مضغوط لحقائق المستخدم للنموذج الرئيسي.
|
||||
|
||||
### `message`
|
||||
|
||||
يُرسل فقط أحدث رسالة من المستخدم.
|
||||
يتم إرسال أحدث رسالة للمستخدم فقط.
|
||||
|
||||
```text
|
||||
Latest user message only
|
||||
@ -409,16 +409,16 @@ Latest user message only
|
||||
استخدم هذا عندما:
|
||||
|
||||
- تريد أسرع سلوك
|
||||
- تريد أقوى انحياز نحو استرجاع التفضيلات الثابتة
|
||||
- تريد أقوى انحياز نحو استرجاع التفضيلات المستقرة
|
||||
- لا تحتاج المنعطفات اللاحقة إلى سياق المحادثة
|
||||
|
||||
المهلة الزمنية الموصى بها:
|
||||
المهلة الموصى بها:
|
||||
|
||||
- ابدأ من حوالي `3000` إلى `5000` مللي ثانية
|
||||
- ابدأ بحوالي `3000` إلى `5000` مللي ثانية
|
||||
|
||||
### `recent`
|
||||
|
||||
تُرسل أحدث رسالة من المستخدم بالإضافة إلى ذيل صغير من المحادثة الحديثة.
|
||||
يتم إرسال أحدث رسالة للمستخدم مع ذيل صغير من المحادثة الأخيرة.
|
||||
|
||||
```text
|
||||
Recent conversation tail:
|
||||
@ -435,13 +435,13 @@ Latest user message:
|
||||
- تريد توازنًا أفضل بين السرعة والارتكاز إلى المحادثة
|
||||
- تعتمد أسئلة المتابعة غالبًا على آخر بضع منعطفات
|
||||
|
||||
المهلة الزمنية الموصى بها:
|
||||
المهلة الموصى بها:
|
||||
|
||||
- ابدأ من حوالي `15000` مللي ثانية
|
||||
- ابدأ بحوالي `15000` مللي ثانية
|
||||
|
||||
### `full`
|
||||
|
||||
تُرسل المحادثة الكاملة إلى وكيل الذاكرة الفرعي للحظر.
|
||||
يتم إرسال المحادثة الكاملة إلى وكيل الذاكرة الحاجزة الفرعي.
|
||||
|
||||
```text
|
||||
Full conversation context:
|
||||
@ -454,32 +454,32 @@ user: ...
|
||||
استخدم هذا عندما:
|
||||
|
||||
- تكون أفضل جودة استرجاع أهم من زمن الاستجابة
|
||||
- تحتوي المحادثة على إعداد مهم في موضع بعيد من السلسلة
|
||||
- تحتوي المحادثة على إعداد مهم في موضع بعيد داخل السلسلة
|
||||
|
||||
المهلة الزمنية الموصى بها:
|
||||
المهلة الموصى بها:
|
||||
|
||||
- زِدها بدرجة كبيرة مقارنةً بـ `message` أو `recent`
|
||||
- ابدأ من حوالي `15000` مللي ثانية أو أكثر بحسب حجم السلسلة
|
||||
- زدها بشكل ملحوظ مقارنةً مع `message` أو `recent`
|
||||
- ابدأ بحوالي `15000` مللي ثانية أو أكثر حسب حجم السلسلة
|
||||
|
||||
بشكل عام، يجب أن تزداد المهلة الزمنية مع حجم السياق:
|
||||
بشكل عام، يجب أن تزداد المهلة مع زيادة حجم السياق:
|
||||
|
||||
```text
|
||||
message < recent < full
|
||||
```
|
||||
|
||||
## استمرارية النصوص
|
||||
## الاحتفاظ بالنصوص
|
||||
|
||||
تؤدي تشغيلات وكيل الذاكرة الفرعي للحظر الخاصة بالذاكرة النشطة إلى إنشاء
|
||||
نص `session.jsonl` حقيقي أثناء استدعاء وكيل الذاكرة الفرعي للحظر.
|
||||
تؤدي عمليات تشغيل وكيل الذاكرة الحاجزة الفرعي للذاكرة النشطة إلى إنشاء نص
|
||||
`session.jsonl` حقيقي أثناء استدعاء وكيل الذاكرة الحاجزة الفرعي.
|
||||
|
||||
افتراضيًا، يكون هذا النص مؤقتًا:
|
||||
|
||||
- يُكتب في دليل مؤقت
|
||||
- يُستخدم فقط لتشغيل وكيل الذاكرة الفرعي للحظر
|
||||
- تتم كتابته في دليل مؤقت
|
||||
- يُستخدم فقط لتشغيل وكيل الذاكرة الحاجزة الفرعي
|
||||
- يُحذف فورًا بعد انتهاء التشغيل
|
||||
|
||||
إذا كنت تريد الاحتفاظ بنصوص وكيل الذاكرة الفرعي للحظر على القرص لأغراض التصحيح أو
|
||||
الفحص، ففعّل الاستمرارية صراحةً:
|
||||
إذا كنت تريد الاحتفاظ بنصوص وكيل الذاكرة الحاجزة الفرعي على القرص لأغراض التصحيح أو
|
||||
الفحص، ففعّل الاستمرارية صراحة:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -499,10 +499,9 @@ message < recent < full
|
||||
```
|
||||
|
||||
عند التفعيل، تخزّن الذاكرة النشطة النصوص في دليل منفصل ضمن
|
||||
مجلد جلسات الوكيل المستهدف، وليس في
|
||||
مسار نص محادثة المستخدم الرئيسي.
|
||||
مجلد جلسات الوكيل المستهدف، وليس في مسار نص محادثة المستخدم الرئيسي.
|
||||
|
||||
يكون التخطيط الافتراضي من حيث المفهوم:
|
||||
يكون التخطيط الافتراضي من حيث المفهوم كما يلي:
|
||||
|
||||
```text
|
||||
agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jsonl
|
||||
@ -512,13 +511,13 @@ agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jso
|
||||
|
||||
استخدم هذا بحذر:
|
||||
|
||||
- يمكن أن تتراكم نصوص وكيل الذاكرة الفرعي للحظر بسرعة في الجلسات المزدحمة
|
||||
- يمكن أن تتراكم نصوص وكيل الذاكرة الحاجزة الفرعي بسرعة في الجلسات النشطة
|
||||
- يمكن لوضع الاستعلام `full` أن يكرر قدرًا كبيرًا من سياق المحادثة
|
||||
- تحتوي هذه النصوص على سياق مطالبة مخفي وذكريات مسترجعة
|
||||
|
||||
## الإعدادات
|
||||
|
||||
توجد جميع إعدادات الذاكرة النشطة ضمن:
|
||||
توجد جميع إعدادات الذاكرة النشطة تحت:
|
||||
|
||||
```text
|
||||
plugins.entries.active-memory
|
||||
@ -526,36 +525,36 @@ plugins.entries.active-memory
|
||||
|
||||
أهم الحقول هي:
|
||||
|
||||
| المفتاح | النوع | المعنى |
|
||||
| المفتاح | النوع | المعنى |
|
||||
| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
|
||||
| `enabled` | `boolean` | يفعّل المكوّن الإضافي نفسه |
|
||||
| `config.agents` | `string[]` | معرّفات الوكلاء الذين يمكنهم استخدام الذاكرة النشطة |
|
||||
| `config.model` | `string` | مرجع نموذج اختياري لوكيل الذاكرة الفرعي للحظر؛ وعند عدم تعيينه، تستخدم الذاكرة النشطة نموذج الجلسة الحالية |
|
||||
| `config.queryMode` | `"message" \| "recent" \| "full"` | يتحكم في مقدار المحادثة التي يراها وكيل الذاكرة الفرعي للحظر |
|
||||
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | يتحكم في مدى حماس أو صرامة وكيل الذاكرة الفرعي للحظر عند اتخاذ قرار ما إذا كان سيعيد ذاكرة |
|
||||
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | تجاوز متقدم لمستوى التفكير لوكيل الذاكرة الفرعي للحظر؛ الافتراضي هو `off` للسرعة |
|
||||
| `config.promptOverride` | `string` | استبدال كامل متقدم للمطالبة؛ غير موصى به للاستخدام العادي |
|
||||
| `config.promptAppend` | `string` | تعليمات إضافية متقدمة تُلحق بالمطالبة الافتراضية أو المستبدلة |
|
||||
| `config.timeoutMs` | `number` | مهلة زمنية قصوى صارمة لوكيل الذاكرة الفرعي للحظر |
|
||||
| `config.maxSummaryChars` | `number` | الحد الأقصى لإجمالي الأحرف المسموح بها في ملخص الذاكرة النشطة |
|
||||
| `config.logging` | `boolean` | يصدر سجلات الذاكرة النشطة أثناء الضبط |
|
||||
| `config.persistTranscripts` | `boolean` | يحتفظ بنصوص وكيل الذاكرة الفرعي للحظر على القرص بدلًا من حذف الملفات المؤقتة |
|
||||
| `config.transcriptDir` | `string` | دليل نصوص وكيل الذاكرة الفرعي للحظر النسبي ضمن مجلد جلسات الوكيل |
|
||||
| `enabled` | `boolean` | يفعّل المكوّن الإضافي نفسه |
|
||||
| `config.agents` | `string[]` | معرّفات الوكلاء التي يمكنها استخدام الذاكرة النشطة |
|
||||
| `config.model` | `string` | مرجع نموذج اختياري لوكيل الذاكرة الحاجزة الفرعي؛ عند عدم تعيينه، تستخدم الذاكرة النشطة نموذج الجلسة الحالية |
|
||||
| `config.queryMode` | `"message" \| "recent" \| "full"` | يتحكم في مقدار المحادثة الذي يراه وكيل الذاكرة الحاجزة الفرعي |
|
||||
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | يتحكم في مدى حماس أو صرامة وكيل الذاكرة الحاجزة الفرعي عند تقرير ما إذا كان سيعيد ذاكرة |
|
||||
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | تجاوز متقدم لمستوى التفكير لوكيل الذاكرة الحاجزة الفرعي؛ الافتراضي `off` من أجل السرعة |
|
||||
| `config.promptOverride` | `string` | استبدال كامل متقدم للمطالبة؛ غير موصى به للاستخدام العادي |
|
||||
| `config.promptAppend` | `string` | تعليمات إضافية متقدمة تُلحق بالمطالبة الافتراضية أو المستبدلة |
|
||||
| `config.timeoutMs` | `number` | مهلة قصوى صارمة لوكيل الذاكرة الحاجزة الفرعي |
|
||||
| `config.maxSummaryChars` | `number` | الحد الأقصى لإجمالي الأحرف المسموح بها في ملخص الذاكرة النشطة |
|
||||
| `config.logging` | `boolean` | يصدر سجلات الذاكرة النشطة أثناء الضبط |
|
||||
| `config.persistTranscripts` | `boolean` | يحتفظ بنصوص وكيل الذاكرة الحاجزة الفرعي على القرص بدلًا من حذف الملفات المؤقتة |
|
||||
| `config.transcriptDir` | `string` | دليل نسبي لنصوص وكيل الذاكرة الحاجزة الفرعي ضمن مجلد جلسات الوكيل |
|
||||
|
||||
حقول ضبط مفيدة:
|
||||
حقول مفيدة للضبط:
|
||||
|
||||
| المفتاح | النوع | المعنى |
|
||||
| المفتاح | النوع | المعنى |
|
||||
| ----------------------------- | -------- | ------------------------------------------------------------- |
|
||||
| `config.maxSummaryChars` | `number` | الحد الأقصى لإجمالي الأحرف المسموح بها في ملخص الذاكرة النشطة |
|
||||
| `config.recentUserTurns` | `number` | منعطفات المستخدم السابقة التي يجب تضمينها عندما تكون `queryMode` هي `recent` |
|
||||
| `config.recentAssistantTurns` | `number` | منعطفات المساعد السابقة التي يجب تضمينها عندما تكون `queryMode` هي `recent` |
|
||||
| `config.recentUserChars` | `number` | الحد الأقصى للأحرف لكل منعطف مستخدم حديث |
|
||||
| `config.recentAssistantChars` | `number` | الحد الأقصى للأحرف لكل منعطف مساعد حديث |
|
||||
| `config.cacheTtlMs` | `number` | إعادة استخدام ذاكرة التخزين المؤقت للاستعلامات المتطابقة المتكررة |
|
||||
| `config.maxSummaryChars` | `number` | الحد الأقصى لإجمالي الأحرف المسموح بها في ملخص الذاكرة النشطة |
|
||||
| `config.recentUserTurns` | `number` | منعطفات المستخدم السابقة التي يجب تضمينها عندما يكون `queryMode` هو `recent` |
|
||||
| `config.recentAssistantTurns` | `number` | منعطفات المساعد السابقة التي يجب تضمينها عندما يكون `queryMode` هو `recent` |
|
||||
| `config.recentUserChars` | `number` | الحد الأقصى للأحرف لكل منعطف مستخدم حديث |
|
||||
| `config.recentAssistantChars` | `number` | الحد الأقصى للأحرف لكل منعطف مساعد حديث |
|
||||
| `config.cacheTtlMs` | `number` | إعادة استخدام ذاكرة التخزين المؤقت للاستعلامات المتطابقة المتكررة |
|
||||
|
||||
## الإعداد الموصى به
|
||||
|
||||
ابدأ بـ `recent`.
|
||||
ابدأ باستخدام `recent`.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -583,19 +582,19 @@ plugins.entries.active-memory
|
||||
ثم انتقل إلى:
|
||||
|
||||
- `message` إذا كنت تريد زمن استجابة أقل
|
||||
- `full` إذا قررت أن السياق الإضافي يستحق وكيل الذاكرة الفرعي للحظر الأبطأ
|
||||
- `full` إذا قررت أن السياق الإضافي يستحق بطء وكيل الذاكرة الحاجزة الفرعي
|
||||
|
||||
## تصحيح الأخطاء
|
||||
|
||||
إذا لم تظهر الذاكرة النشطة حيث تتوقع:
|
||||
|
||||
1. تأكد من أن المكوّن الإضافي مفعّل ضمن `plugins.entries.active-memory.enabled`.
|
||||
2. تأكد من أن معرّف الوكيل الحالي مدرج في `config.agents`.
|
||||
3. تأكد من أنك تختبر من خلال جلسة دردشة تفاعلية دائمة.
|
||||
1. أكّد أن المكوّن الإضافي مفعّل ضمن `plugins.entries.active-memory.enabled`.
|
||||
2. أكّد أن معرّف الوكيل الحالي مدرج في `config.agents`.
|
||||
3. أكّد أنك تختبر من خلال جلسة دردشة تفاعلية دائمة.
|
||||
4. فعّل `config.logging: true` وراقب سجلات البوابة.
|
||||
5. تحقّق من أن البحث في الذاكرة نفسه يعمل باستخدام `openclaw memory status --deep`.
|
||||
|
||||
إذا كانت نتائج الذاكرة مليئة بالضجيج، فشدّد:
|
||||
إذا كانت نتائج الذاكرة كثيرة الضجيج، فشدّد:
|
||||
|
||||
- `maxSummaryChars`
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user