عن المشروع

Plumb هو خادم MCP يُوزَّع كملف Go تنفيذي واحد بموجب رخصة MIT، ويمنح وكلاء البرمجة طبقة ذكاء على نمط محررات الأكواد داخل ضوابط أمنية. يذكر ملف README أربعة أعمدة بالترتيب: موثوقية الكتابة، وتنسيق العمل بين الوكلاء المتعددين، والذكاء الدلالي، وكفاءة السياق. أمان الكتابة. تُخزَّن كل عملية كتابة مؤقتاً في ملف مؤقت ثم تُعاد تسميتها إلى مكانها، وهي مصممة لتدعم الروابط الرمزية وتتحمّل تنسيقات CR/LF. قفلٌ على مستوى المسار في المشغّل يُرتّل الكتابات المتزامنة على الملف نفسه عبر الجلسات ونوافذ الدردشة. تطبّق المعاملات متعددة الملفات التعديلات عبر ملفات عديدة مع التراجع الذري إذا فشل خطوة ما، وترفض حوافظ mtime/sha التعديلات المتقادمة قبل أن تفرط في التغييرات الأحدث. أمراً serve هو وسيط stdio متكافح: إذا تعثّر المشغّل أو تعليق، يُعاد تشغيله ويُعاد تأدية المصافحة، ويقول ملف README إن عمليات الكتابة الجاري تنفيذها لا تُعاد بتشغيل صامت. التنسيق. لأن مشغّلاً واحداً يخدم جميع الوكلاء، يمكن للجلسات رؤية بعضها البعض وإرسال الرسائل. الوعي بالزملاء مفعّل افتراضياً: يسمّي workspace_sessions الجلسات النشطة والكتابات التي سجلها المشغّل لها، مميزاً الكتابات الفاشلة أو المرفوضة. صندوق بريد بين الوكلاء (leave_note, check_messages) مفعّل افتراضياً ضمن نفس مساحة العمل، مع توصيل الرسائل عبر نتائج الأدوات العادية بدلاً من الاستجداء. النوايا الإرشادية (share_intent, opt-in under [collol] intents) تُعلّن عند لمس كتابة الزميل للمسار المُدّعى، وهي مُوسومة صراحةً كبيانات غير مؤكدة لا تحجب أي شيء أبداً. الاكتشافات الدائمة (share_findings, opt-in) تحوّل تعلّمات الجلسة إلى ذاكرة مشروع قابلة للبحث ومنزوعة الأسرار. يؤكد ملف README أن أمان الكتابة لا يعتمد على تعاون الوكلاء. الذكاء الدلالي. أدوات إعادة الهيكلة المدعومة بـ LSP تشمل rename_symbol وreplace_symbol_body وsafe_delete_symbol. تُضاف التشخيصات من خوادم اللغات الحقيقية مثل gopls وpyright إلى كل كتابة. بحث الرموز مقتصر على المشروع، باستثناء مكتبة المعيار وضوضاء التبعيات. تحكمات السياق تسمح للوكيل بقراءة الرموز أو نطاقات الأسطر بدلاً من الملفات كاملة، ويهيئ session_start مساحة العمل، والفرع، وال committing الأخيرة، والتشخيصات، وذاكرة المشروع في رحلة ذهاب واحدة. التحكم بالوصول يحكمه قائمة سماح للمسارات على كل اتصال مع جذور مقروءة ومقروءة-مكتوبة، بالإضافة إلى تصعيد git; عمليات git المدمّرة والشبكية معطّلة افتراضياً. ينشر ملف README أرقاماً مقاسة في docs/use-cases.md، يُعاد توليدها بواسطة نص برمجي، كما يوثق فقداناً: قراءة_multiple_files تكلف حوالي 1.31 مرة أكثر من قراءة الملفات بشكل أصلي. دعم اللغات موصوف بمستويات وليس بعدد واحد. Go (gopls) وPython (pyright) من الدرجة الأولى، مع اختبار CI ضد ملفات تنفيذية حقيقية مع أدوات LSP والكتابة الكاملة. Java وRust وSwift وTypeScript/JavaScript وZig وKotlin وHTML مُدرجة كمُختبرة بشرط وجود خوادمها في PATH; HTML مذكور كغير قادر على الوصول لل文件系统. فهرس tree-sitter المدمج يغطي 31 لغة وأكثر للبحث المصنّف والمخططات واستكشاف رسم_topology دون خادم لغة..validation الملفات التنفيذية الحقيقية مذكور لمنصتي macOS وLinux; Windows قيد المتابعة لكنه غير مدعوم بعد لأن المشغّل يستخدم sockets Unix. البنية. plumb serve يوكل عبر plumb.sock إلى مشغّل خلفي مشترك يبقي خوادم اللغات دافئة عبر المحادثات. SQLite يخزّن stats.db عالمي لإحصائيات الأدوات وملخصات episodic، بالإضافة إلى topology.db وmemory.db لكل مشروع تحت .plumb/ في كل مساحة عمل. يذكر ملف README أن 58 أداة مُعرَّضة؛ الأكثر استخداماً تشمل session_start وworkspace_symbols وget_definition وfind_references وrename_symbol وedit_file وtransaction_apply وdiagnostics، والباقي يغطي وصول النظام الملفات وهيرارحيات LSP وgit متعدد المستويات وفهرس Topology محلي اختياري والذاكرة. تشغيل plumb بدون وسائط يفتح لوحة TUI تعرض مكالمات الأدوات وصحة المشغّل وإحصائيات كل أداة وسجلات streamable. التثبيت والإعداد. التثبيت عبر Homebrew أو go install أو ملفات التنفيذية الصادرة مسبقاً؛ ملفات macOS التنفيذية الصادرة مسبقاً غير مصرّحة بعد. plumb setup يكتب إعداد MCP للعملاء مثل claude-code وclaude-desktop وcodex وgemini وcursor. الإعداد يستخدم config.toml عالمي أو لكل مشروع أو متغيرات بيئية، مع plumb config show للإبلاغ عن القيم المحلولة وأصلها; خيارات نموذجية تشمل strict edits التي تتطلب قراءة سابقة وlimit معدل لكل دقيقة لحلقات الخروج عن السيطرة. الحالة. Plumb ما قبل الإصدار 1.0، مع أمان الكتابة والمشغّل المقاوم وفهرس topology والذاكرة Projekتية مُوصوفة بأنها قيد الاستخدام اليومي. خارطة الطريق تذكر إصدارات موضوعية من 0.10 إلى 0.19، مع 0.19.x كأخير إصدار 0.x قبل 1.0، وتأجيل دعم Windows الأصلي إلى 1.1. إرشادات المساهمة وAGENTS.md وقاعدة السلوك ورخصة MIT مذكورة، والنص يتبع الإنجليزية الأسترالية.