ليس مشروعاً رسمياً من Frappe. ولا ارتباط له بشركة Frappe Technologies.
ماذا يفعل
يتصل ffc بموقع Frappe أو ERPNext عبر واجهة REST API. يمكنكم قراءة المستندات وإنشاؤها وتحديثها واعتمادها وإلغاؤها من الطرفية. هو للمسؤولين والمطورين ولكل من يريد أن يعمل مساعد ذكاء اصطناعي مثل Claude على نظام ERP لديه.
يعمل دائماً بصلاحيات مستخدم Frappe الذي سجّلتم الدخول به. ولا يستطيع أن يفعل أكثر مما يستطيعه هذا المستخدم في Desk.
الميزات
- المستندات:
list-docsوget-docوcreate-docوupdate-docوsubmit-docوcancel-docوbulk-update. - سير العمل:
workflow apply. - البحث والطباعة:
searchوpdf. - الملفات:
files uploadوfiles download. - الإعداد:
initينشئ ملف تعريف للموقع، وwhoamiيعرض من سجّلتم الدخول باسمه. - أعلام الأمان:
--dry-runيعرض ما كان سيتغيّر. و--read-onlyيمنع كل كتابة. - خادم MCP:
ffc mcpيشغّل خادم Model Context Protocol لمساعدي الذكاء الاصطناعي. ويُوزَّع أيضاً كحزمة.mcpbومدرج في سجل MCP باسمio.github.nasroykh/ffc. استعملواffc mcp installوffc mcp uninstallلإعداد العملاء المدعومين. - تطبيق سطح المكتب:
ffc desktop installوffc desktop status. تطبيق سطح المكتب يعمل على Windows وmacOS. وهو إصدار تجريبي مسبق (0.11.x) وغير موقَّع. - التحديثات:
ffc update.
التثبيت
Linux وmacOS:
curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.sh | sh
Windows PowerShell:
irm https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.ps1 | iex
Homebrew:
brew install nasroykh/tap/ffc
Scoop:
scoop bucket add foxmayn https://github.com/nasroykh/scoop-bucket
scoop install ffc
ثم اربطوا موقعكم الأول:
ffc init
ffc whoami
تغطي الإصدارات Linux وmacOS (amd64 وarm64) وWindows (amd64 وarm64). مجاميع التحقق موقَّعة بـ Ed25519، ويتحقق منها سكربت التثبيت عند وجود OpenSSL 3. ويشغّل CI الأمرين go vet وgo test قبل كل إصدار، ويصدر سير عمل الإصدار شهادة منشأ (provenance attestation).
لماذا بنيناه
نعمل على مواقع Frappe كل يوم. التنقل في Desk لفحص سجل واحد أو تحديث خمسين سجلاً بطيء. وسطر الأوامر القابل للبرمجة أسرع، ويندرج في سكربتات الصدفة ومهام CI.
يجعل مساعدو الذكاء الاصطناعي هذا أنفع، وأخطر أيضاً. يمنحهم خادم MCP وصولاً حقيقياً إلى الموقع، لكن بصلاحيات مستخدم واحد فقط، ويتيح وضع --read-only أن تبدأوا بالقراءة وحدها. نستعمل ffc في عملنا بالذكاء الاصطناعي على ERPNext.
الأداة مكتوبة بلغة Go ومنشورة برخصة MIT. اطلعوا على الشيفرة المصدرية والإصدارات والمشكلات على GitHub. أدوات ذات صلة: Foxmayn Frappe Manager للبيئات (benches) وFoxmayn Frappe Types لـ TypeScript.