الوصف
دفتر عمل الوكلاء هو وكيل محلي يجلس بين وكيل البرمجة، Claude Code أو Codex، والنموذج الأساسي. يضيف استدعاء أداة إضافية لكل طلب: مكان للنموذج للتفكير بصوت عالٍ قبل أن يجيب، حيث يكتب القرار الذي يتخذه، والبدائل التي اعتبرها، وما كان سيكلفه كل خيار. الهدف المعلن للمشروع هو السماح للمطور بالتحقق مما إذا كانت خطة الوكيل المعلنة تتطابق مع ما يفعله فعليًا.
قراءة المزيد
يعمل الوكيل محليًا من خلال Docker Compose ويعرض لوحة تحكم على 127.0.0.1:8080، حيث تتدفق كل ملاحظة أثناء كتابتها، مع الاحتفاظ بجلسات CLI منفصلة في صفوف منفصلة. يشير Claude Code إلى الوكيل عن طريق تعيين ANTHROPIC_BASE_URL إلى العنوان المحلي؛ يتم تكوين Codex من خلال مزود نموذج مخصص. وضع الاستمرارية الاختياري يحتفظ بالملاحظات السابقة متاحة عبر استدعاءات الأدوات ضمن نفس الدور (مفعل بشكل افتراضي لـ Codex، ومفعل لـ Claude Code مع علامة بيئية صريحة بمجرد التحقق منها ضد إصدار Claude Code المثبت)، مع حدود قابلة للتكوين على عدد الجلسات، والذاكرة، ووقت الخمول.
يوثق المشروع تكاليفه بوضوح. لأنه يقوم بإجراء استدعاء إضافي للنموذج في كل دور، وما يصل إلى أربعة عندما يستمر النموذج في كتابة الملاحظات، فإنه يضاعف تقريبًا استخدام الرموز المدخلة ويضيف مئات إلى آلاف الرموز الناتجة في كل دور، ولا يبدأ تدفق الرد حتى تنتهي مكالمة الملاحظة المخفية، حتى 60 ثانية. كما يحذر من أن ملاحظة دفتر العمل هي مخرجات نموذج عادية، لذا يمكن أن تظهر مفتاح API أو سر تم لصقه في واحدة.
لا يقرأ دفتر عمل الوكلاء أو يكشف عن تفكير نموذج محمي داخلي؛ يتم إنتاج الملاحظات من خلال استدعاء أداة عادية، مثل أي حجة أداة أخرى يمكن أن يكتبها النموذج. لا يتم كتابة أي شيء على القرص ما لم يقم المشغل بتعيين مسار الأرشيف، ويطلب توثيق المشروع صراحة من المستخدمين عدم استخدامه لجمع أو التدريب على آثار التفكير من نماذج Anthropic أو OpenAI. تم إصداره بموجب ترخيص Apache 2.0 ويذكر أنه غير مرتبط بأي من الشركتين.
إنه مشروع صغير مفتوح المصدر، يطوره مطور واحد، يهدف إلى المطورين الذين يستخدمون Claude Code أو Codex ويرغبون في رؤية تفكير الوكيل أثناء جلسة البرمجة، بدلاً من كونه منتجًا للمستخدمين غير التقنيين.
- الفئةأدوات بناء وكلاء الذكاء الاصطناعي
- نموذج التسعيرمفتوح المصدر
- النشراستضافة ذاتية
- المنصاتالويب
الميزات الأساسية لـ دفتر عمل الوكلاء
وكيل محلي يضيف استدعاء أداة "التفكير بصوت عالٍ" لكل طلب من Claude Code / Codex
لوحة تحكم مباشرة (127.0.0.1:8080) تتدفق كل ملاحظة أثناء كتابتها
صفوف منفصلة لكل جلسة CLI على لوحة التحكم
استمرارية اختيارية عبر الطلبات تحتفظ بالملاحظات السابقة متاحة ضمن نفس الدور
حدود استمرارية قابلة للتكوين (عدد الجلسات، حجم الذاكرة، وقت الخمول)
يعمل مع كل من Claude Code (عبر ANTHROPIC_BASE_URL) وCodex (عبر إعداد مزود مخصص)
يعمل بالكامل محليًا عبر Docker Compose؛ لا يتم كتابة أي شيء على القرص ما لم يتم تكوينه
ترخيص مفتوح المصدر Apache 2.0
البدء مع دفتر عمل الوكلاء
استنساخ المستودع: احصل على المشروع من GitHub (softcane/agents-workbook).
بدء الوكيل: قم بتشغيل docker compose up -d --build.
فتح لوحة التحكم: قم بزيارة 127.0.0.1:8080 واترك علامة التبويب مفتوحة.
توجيه CLI الخاص بك إلى الوكيل: تعيين ANTHROPIC_BASE_URL لـ Claude Code، أو تكوين إعدادات مزود نموذج Codex.
العمل كالمعتاد: استخدم Claude Code أو Codex، وراقب تدفق تفكيره إلى لوحة التحكم.
تفعيل الاستمرارية (اختياري): تعيين WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true للاحتفاظ بالملاحظات متاحة عبر استدعاءات الأدوات لـ Claude Code.
حالات استخدام دفتر عمل الوكلاء
- تدقيق الخطة مقابل العمل
- مراجعة جلسة البرمجة
- تصحيح محلي
