Skip to content

تفكيك وكلاء برمجة مفتوحة المصدر: Codex وOpenCode وgoose ​

هذا القسم يقرأ شيفرة المصدر. المشاريع الثلاثة كلها وكلاء برمجة مفتوحة المصدر للطرفية أو سطح المكتب: Codex CLI من OpenAI (Rust، Apache-2.0)، وOpenCode (TypeScript، MIT، والقراءة كانت للبنية الجديدة في 2.3.0)، وgoose (Rust، Apache-2.0، 1.60.0، وهو الآن مشروع تحت AAIF التابعة لمؤسسة Linux). استنسخناها في 20/11/2026، ومسارات الملفات وأرقام الأسطر أدناه تقابل تلك النسخة.

ستكتشف: الحلقة الأساسية شبه مطابقة تمامًا لما كتبته أنت، والفروق كلها في «الفرامل» و«تفاصيل الهندسة».

1. الحلقة: كلها «ما دامت هناك حاجة إلى أدوات فاستمر» ​

حلقة Codex (codex-rs/core/src/session/turn.rs) تستخدم متغيرًا واحدًا لتحديد ما إذا كانت هناك حاجة إلى جولة أخرى:

rust
let needs_follow_up = model_needs_follow_up || has_pending_input;

إذا أراد النموذج استدعاء أداة، أو أدخل المستخدم كلامًا جديدًا في المنتصف، فاستمر؛ وإلا break. هذا هو نفس الأمر الذي يفعله if not msg.tool_calls: return في myagent.

OpenCode يسميها needsContinuation (تكون صحيحة إذا كانت هناك استدعاءات أدوات نُفِّذت محليًا في هذه الخطوة)، وgoose يسميها ends_turn (تنتهي إذا كانت آخر رسالة ردًّا بلا طلبات أدوات).

الفرق في الفرامل:

حد الخطواتماذا يحدث عند بلوغ الحد
myagent12 خطوةتوقف مباشر، مع رد بجملة «تم تجاوز الحد الأقصى للخطوات»
OpenCodeلا حد افتراضيًا، ويمكن تعيين steps لكل Agentإيقاف الأدوات (toolChoice: "none")، مع إضافة جملة «تم بلوغ الحد الأقصى للخطوات»، لإجبار النموذج على تلخيص التقدم الحالي بالكلمات
gooseGOOSE_MAX_TURNS الافتراضي 1000تسليم التحكم وسؤال المستخدم عما إذا كان يريد المتابعة
Codexلم نجد في شيفرة المصدر حدًا للخطوات—

نهج OpenCode أفضل من نهجنا: القطع المباشر يُفقد التقدم، أما جعل النموذج يكتب ملخصًا في الخطوة الأخيرة فيعرف المستخدم على الأقل إلى أين وصل.

2. الصلاحيات: من y/N إلى «جدول قواعد + مراجعة + صندوق رمل» ​

ابحثصلاحياتها…

انقر على واحد لترى.

smart_approve في goose ونموذج المراجعة لدى Grok Bot في القسم السابق ومستوى auto لدى OpenClaw هي الفكرة نفسها: ما يمكن الحكم عليه تلقائيًا يُحكم عليه تلقائيًا، وما هو غير مؤكد يُسأل عنه الإنسان.

3. الضغط: الفكرة نفسها مثل compact() عندك، مع ثلاثة أمور إضافية ​

متى يبدأ الضغط
myagentعندما يتجاوز الحوار 24000 حرفًا
Codex90% من نافذة السياق
OpenCodeنافذة السياق مطروح منها max(15%, 16k token)
gooseعند 0.8 من النافذة
OpenClawيبدأ الضغط عند حوالي 75%

النهج الجاهز للإنتاج يضيف ثلاثة أمور إضافية:

  1. الحساب بالـ token وليس بعدد الأحرف.
  2. كتابة الملخص كـ"ورقة تسليم". الجملة الأولى في موجه الضغط لدى Codex (codex-rs/prompts/templates/compact/prompt.md):
text
You are performing a CONTEXT CHECKPOINT COMPACTION. Create a handoff summary for another LLM that will resume the task.

Include:
- Current progress and key decisions made
- Important context, constraints, or user preferences
- What remains to be done (clear next steps)
- Any critical data, examples, or references needed to continue

OpenCode يطلب أيضًا أن يكون الملخص "جاهزًا لتسليمه إلى Agent آخر يتابع العمل"، ويحدد أقسامًا ثابتة مثل الأهداف والقرارات والخطوة التالية.

  1. عدم فصل استدعاءات الأدوات عن نتائجها. مثل حلقة while في compact() لدينا، كل المشاريع تعالج هذا.

4. ملفات التعليمات والمهارات: AGENTS.md و load_skill ​

جميعها تقريبًا تقرأ AGENTS.md (وصف المشروع المكتوب ليقرأه الـ Agent):

  • Codex: يقرأ الملفات طبقةً طبقة من جذر git حتى الدليل الحالي ويجمعها، بحد أقصى إجمالي 32 KiB؛ وإذا وُجد AGENTS.override.md في نفس الطبقة فيقرأه أولًا.
  • OpenCode: يبحث عن AGENTS.md، وإذا لم يوجد في نفس الدليل يتراجع لقراءة CLAUDE.md.
  • goose: يقرأ .goosehints و AGENTS.md.

أما المهارات، فاسم الأداة في goose مطابق تمامًا لما لدينا، وهو load_skill (crates/oi-kit-agent/src/skills/operation.rs):

rust
fn load_skill_tool() -> Tool {
    Tool::new(
        LOAD_SKILL_TOOL_NAME,
        "Load a skill's full content into your context so you can follow its instructions.\n\n\
         Skills are listed in your system instructions. When you need to use one, \
         load it first to get the detailed instructions.",
        schema_for_type::<LoadSkillParams>(),
    )
}

ما كتبته في الفصل الثاني هو الممارسة السائدة في المجال.

5. MCP: المقبس المشترك للجميع ​

المشاريع الثلاثة كلها تدعم MCP: Codex يُضبط تحت config.toml في [mcp_servers.名字]؛ OpenCode يُضبط في opencode.json بوضع local / remote؛ أما goose فهو الأكثر شمولًا، جميع الأدوات تمر عبر MCP، وكل امتداد هو عميل MCP، ويُسبق اسم الأداة بـ"اسم الامتداد__اسم الأداة".

تطبيق عملي: أضف ثلاثة أمور إلى myagent على هذا النحو ​

رتّبهامن الأسهل إلى الأصعب، أضف إلى myagent……
  1. 1?
  2. 2?
  3. 3?

اضغط عليها واحدة تلو الأخرى حسب الترتيب.

طريقة مرجعية للأمر الأول:

python
agents_md = Path("AGENTS.md")
if agents_md.exists():
    SYSTEM += "\n\n项目说明(AGENTS.md):\n" + agents_md.read_text(encoding="utf-8")[:8000]

اختبر معرفتكبعد قراءة شيفرة المصدر للمشاريع الثلاثة، كيف تبدو الحلقة الأساسية للـ Agent مقارنة بـ myagent الذي كتبته؟

تحقق من ذلك ​

  • أستطيع أن أشرح كيف يعالج كل من المشاريع الثلاثة "الوصول إلى حد الخطوات"
  • أستطيع أن أذكر عتبات الضغط لديها، ولماذا يُكتب الملخص كـ"ورقة تسليم"
  • أضفت إلى myagent ميزة واحدة على الأقل مما تعلمته

عد إلى الأسئلة الشائعة، أو اذهب إلى درس OpenClaw ودرس Grok Bot لتطبيق هذه التصاميم.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.