أفكار ثالثة

مشروع بحثي من Lightless Labs يدرس سلوك العامل الذكي (AI agent) على نطاق واسع من خلال تحليل متعدد التخصصات للمجموعات النصية (ببساطة، رمي الأشياء على الحائط ورؤية ما يلتصق).

سُمّي على اسم مفهوم Tiffany Aching من عالم Discworld: الأفكار الأولى (تفكير العوامل)، الأفكار الثانية (تحليل العوامل لتفكيرهم)، الأفكار الثالثة (هذا المشروع يحلل ذلك).

ما في هذا المستودع

أفكار ثالثة يتكون من نصفين يشتركان في مجموعة نصية ومنهجية:

1. middens/ — واجهة سطر أوامر بلغة Rust لاستخراج الأنماط السلوكية من سجلات جلسات العامل الذكي. يحلل النصوص من Claude Code و Codex و OpenClaw وجلسات Pi لبرمجة العوامل (إصدار Gemini)، ويصنف الرسائل والجلسات، ويُجري مجموعة من 23 تقنية تحليلية (6 تقنيات أصلية بلغة Rust + 17 بلغة Python، مُجمّعة عبر جسر Python مدمج). تحتوي الواجهة على ثلاثة أوامر أساسية: analyze (تشغيل التقنيات → تخزين Parquet)، interpret (سرد مدعوم بالذكاء الاصطناعي عبر التقنيات المختلفة)، و export (دفتر Jupyter). انظر middens/README.md.
2. المخرجات البحثية — كتالوج المنهجيات، المواصفات باللغة الطبيعية، دراسات إعادة الإنتاج، والنتائج المُوثقة في docs/. هنا تعيش الادعاءات العلمية.

المجموعة النصية نفسها (corpus/، experiments/) موجودة في ملف gitignore — الجلسات تحتوي على بيانات خاصة ولا يمكن إعادة توزيعها. الأدوات والمنهجية مفتوحة؛ البيانات الأولية ليست كذلك.

النتائج الرئيسية

قاعدة النطاق المركبة: أي نتيجة رئيسية حول التفكير أو السلوك النصي يجب أن تصمد عبر أربعة محاور — session_type، thinking_visibility، language، ونافذة زمنية. النتيجة التي لا تصمد عبر الأربعة جميعها ليست نتيجة. مزيد من السياق في CLAUDE.md و docs/HANDOFF.md.

هيكل المستودع

middens/              واجهة Rust — المُحلل، المصنفات، التقنيات، جسر Python
docs/
  HANDOFF.md          مستند استمرارية الجلسة، اقرأ هذا أولاً
  methods-catalog.md  20 عائلة تقنية، أكثر من 80 مرجعاً
  examples/           أمثلة تطبيقية لسير عمل الثلاثي للواجهة
  nlspecs/            مواصفات باللغة الطبيعية (لماذا / ماذا / كيف / تم)
  reports/            تقارير بحثية
  reviews/            مراجعات أقران متعددة النماذج
  brainstorms/        مستندات المتطلبات
  plans/              خطط التنفيذ
  solutions/          المعرفة المؤسسية — الدروس المُوثقة
scripts/              حزمة Python التحليلية (26 سكريبت، معظمها تجاوزتها middens)
todos/                ملفات مهام فردية بواجهة YAML

ملفات gitignore: corpus/، corpus-full/، corpus-split/، corpus-frozen/، experiments/، data/labeled-messages.json.

البدء

قم بتثبيت الواجهة باستخدام Homebrew على macOS أو Linux:

brew install lightless-labs/tap/middens
middens --help

على Linux بدون Homebrew، احصل على حزمة الإصدار مباشرة:

# x86_64 Linux
curl -LO https://github.com/Lightless-Labs/third-thoughts/releases/download/v0.0.1-beta.4/middens-0.0.1-beta.4-x86_64-unknown-linux-gnu.tar.gz
tar xzf middens-0.0.1-beta.4-x86_64-unknown-linux-gnu.tar.gz
./middens-0.0.1-beta.4-x86_64-unknown-linux-gnu/middens --help

middens توفر حالياً ملفات ثنائية لـ Apple Silicon macOS و x86_64 Linux و arm64 Linux. Homebrew هو أسهل مسار إذا كنت تستخدمه بالفعل؛ حزم الإصدار والبناء من المصدر موثقة في middens/README.md.

إذا كنت ترغب في تشغيل الواجهة على سجلات جلساتك الخاصة، توجه إلى middens/. إذا كنت تريد القراءة عن المنهجية والنتائج، ابدأ بـ docs/methods-catalog.md والتقارير ضمن docs/reports/.

أرشفة جلسات العامل

middens archive ينسخ سجلات JSONL المحلية للعامل إلى أرشيف خاص مبني على المحتوى قبل أن يقوم البائعون، سياسات الاحتفاظ، أو نزعات التنظيف الليلية الخاصة بك بحذفها. يخزن النصوص الأولية، لذا عالج جذر الأرشيف كبيانات خاصة:

middens archive --to ~/agent-session-archive --dry-run
middens archive --to ~/agent-session-archive --yes

المكونات الإضافية الآلية المستقلة موجودة تحت integrations/ ولا تتطلب وجود الملف الثنائي middens في PATH:

• integrations/pi/middens-archive/ — إضافة Pi مع /middens-archive-now و /middens-archive-status.
• integrations/claude-code/middens-archive/ — خطافات Claude Code بالإضافة إلى /middens-archive-now.
• integrations/codex/middens-archive/ — خطافات Codex بالإضافة إلى مهارات الأرشفة.

جميعها تتطلب MIDDENS_ARCHIVE_ROOT صريحاً؛ لا يوجد مسار أرشيف افتراضي مُختار لك، لأن مجلدات النصوص الأولية المفاجئة غير مهذبة.

الترخيص

AGPL-3.0-or-later. انظر LICENSE.