xlsx: التعامل مع جدول البيانات كمُخرج رئيسي

لمن يناسب

عندما يكون جدول البيانات هو المدخل أو المخرج الرئيسي، استخدم دليل xlsx هذا. يغطي فتح أو قراءة أو تحرير أو إصلاح ملفات .xlsx أو .xlsm أو .xltx أو .csv أو .tsv القائمة. يجب أن يكون المُخرج ملف جدول بيانات.

لا تشغّل هذا عندما يكون المُخرج الرئيسي مستند Word أو تقرير HTML أو سكربت Python مستقل أو مسار قاعدة بيانات أو تكامل Google Sheets API، حتى إن وُجدت بيانات جدولية في الوسط. لا تقدم المادة قائمة بمنتجات وكلاء؛ لا تعتبره حكرًا على برنامج بعينه. صفحة الدليل الرسمية هي

https://raw.githubusercontent.com/anthropics/skills/main/skills/xlsx/SKILL.md

أكمل أول محاولة في 3 دقائق

المسار الموصى به: openpyxl و pandas و markitdown مثبتة مسبقًا كلها. لا تشغّل pip install أولاً؛ اكتب سكربتًا واستوردها مباشرة.

الشرط المسبق: البيئة الحالية تستطيع استيراد هذه المكتبات الثلاث مباشرة. أول محاولة منخفضة المخاطر هي نظرة للقراءة فقط؛ لا تكتب إلى القرص بعد. لملف جدول محلي موجود مسبقًا، استورد markitdown لمعاينة سريعة. إذا لم يوجد الملف، توقف عند فشل الفتح؛ لا تنشئ جدول عيّنة غير مسمّى.

إشارة النجاح: ينجح الاستيراد وترى نظرة نصية عامة لذلك الملف. ليست إصلاحًا ولا استبدالًا. إن لم يوجد ملف جاهز وطلب المستخدم صراحة إنتاج جدول، فانتقل إلى الإنشاء بـ openpyxl، لكن أكّد اسم الملف وخطر الاستبدال قبل الكتابة إلى القرص.

عند الإنشاء تذكّر: استخدم صيغًا؛ لا تكتب نتائج ثابتة حسبها Python مسبقًا. مثال المادة يكتب الخلية كـ =SUM(B2:B9) حتى يعيد الورقة الحساب عندما تتغير المدخلات.

حالات الاستخدام

الحالة الأولى: إنشاء أو تعديل ورقة تعيد الحساب. اكتب سكربتًا بـ openpyxl المثبت مسبقًا. بعد الاستيراد اكتب المجاميع كصيغ — مثلًا يستخدم B10 =SUM(B2:B9) — بدل الجمع في Python ثم كتابة رقم. معيار الإكمال: الملف يحتوي صيغًا والورقة تستطيع إعادة الحساب بعد تغيّر المدخلات. يترك الملخص pandas للقراءة/الكتابة الدفعية و markitdown للمعاينة السريعة؛ تغطي هذه الحالة كتابة الصيغ فقط. لا يعطي المقتطف واجهة أنماط كاملة؛ لا تخترع دوال تنسيق لم تظهر.

الحالة الثانية: الملف الذي يحتوي صيغًا يجب إعادة حسابه قبل قراءة القيم. تقول المادة: كلما احتوى الملف صيغًا، إعادة الحساب خطوة إلزامية. يكتب openpyxl الصيغ كنصوص ولا يملك قيمًا مخزّنة؛ إلى أن تعيد الحساب تُقرأ كل خلية صيغة كـ None. هذا فحص قابل للعكس: افتح الملف الذي كتبته للتو واقرأ خلية صيغة؛ إن حصلت على None فإعادة الحساب لم تتم بعد — توقف هناك، أكمل إعادة الحساب ثم اعتبر القيمة المقروءة نتيجة. لا تفسّر None على أنه مجموع صفر.

حدود الاستخدام

استخدم هذا فقط عندما يكون جدول البيانات نفسه هو المُخرج الرئيسي. Word وHTML والسكربتات المستقلة ومسارات قواعد البيانات و Google Sheets API لا تسلك هذا المسار حتى إن احتوت جداول. المكتبات الثلاث مثبتة مسبقًا؛ افتراضيًا لا تشغّل pip install أولاً. يجب أن تستطيع الصيغ إعادة الحساب مع تغيّر المدخلات؛ بعد الكتابة يجب إعادة الحساب وإلا تعود القراءة None.

لا تكتب مسار مستودع لم يظهر كأمر تثبيت. لا تمرّر أرقامًا ثابتة على أنها مجاميع. قبل الكتابة إلى القرص أو استبدال الورقة الأصلية أكّد مسار الوجهة والآثار الجانبية ثم نفّذ. ما يتجاوز أنواع الملفات وطريقة الاستيراد ومتطلبات إعادة الحساب المكتوبة هنا خارج تغطية هذا الدليل.