دليل قراءة متعدد اللغات للمهارة
xlsxالغرض والاستخدام والمصدر
استخدم هذه الميزة كلما كان ملف جدول البيانات هو المدخل أو المخرج الرئيسي. وهذا يعني أي مهمة يرغب المستخدم فيها في: فتح أو قراءة أو تعديل أو إصلاح ملف موجود بصيغة .xlsx أو .xlsm أو .xltx أو .csv أو .tsv (مثل إضافة أعمدة، أو حساب الصيغ، أو التنسيق، أو إنشاء الرسوم البيانية، أو تنظيف البيانات غير المنظمة)؛ أو إنشاء جدول بيانات جديد من الصفر أو من مصادر بيانات أخرى؛ أو التحويل بين صيغ الملفات الجدولية. يُفعّل هذا الخيار تحديدًا عندما يشير المستخدم إلى ملف جدول بيانات بالاسم أو المسار - حتى بشكل عابر (مثل "ملف xlsx في تنزيلاتي") - ويريد إجراء تعديلات عليه أو استخراج بيانات منه. يُفعّل هذا الخيار أيضًا لتنظيف أو إعادة هيكلة ملفات البيانات الجدولية غير المنظمة (الصفوف غير الصحيحة، والعناوين في غير موضعها، والبيانات غير المرغوب فيها) وتحويلها إلى جداول بيانات منظمة. يجب أن يكون الناتج ملف جدول بيانات. لا تُفعّل هذه الميزة عندما يكون الناتج الرئيسي مستند Word أو تقرير HTML أو برنامج Python مستقل أو مسار قاعدة بيانات أو تكامل مع واجهة برمجة تطبيقات Google Sheets، حتى لو كانت البيانات جدولية.
تم استرجاع المصدر:
- مستودع المصدر
- anthropics/skills
- SKILL.md
skills/xlsx/SKILL.md- نجوم المستودع
- 185,373
- آخر تحديث للمستودع
- 2026-10-29
- تصنيف القدرات
- بيانات
- وقت التجميع الأخير
الترخيص: ملف الترخيص بحاجة إلى التحقق
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
استخدم هذه الميزة كلما كان ملف جدول البيانات هو المدخل أو المخرج الرئيسي. وهذا يعني أي مهمة يرغب المستخدم فيها في: فتح أو قراءة أو تعديل أو إصلاح ملف موجود بصيغة .xlsx أو .xlsm أو .xltx أو .csv أو .tsv (مثل إضافة أعمدة، أو حساب الصيغ، أو التنسيق، أو إنشاء الرسوم البيانية، أو تنظيف البيانات غير المنظمة)؛ أو إنشاء جدول بيانات جديد من الصفر أو من مصادر بيانات أخرى؛ أو التحويل بين صيغ الملفات الجدولية. يُفعّل هذا الخيار تحديدًا عندما يشير المستخدم إلى ملف جدول بيانات بالاسم أو المسار - حتى بشكل عابر (مثل "ملف xlsx في تنزيلاتي") - ويريد إجراء تعديلات عليه أو استخراج بيانات منه. يُفعّل هذا الخيار أيضًا لتنظيف أو إعادة هيكلة ملفات البيانات الجدولية غير المنظمة (الصفوف غير الصحيحة، والعناوين في غير موضعها، والبيانات غير المرغوب فيها) وتحويلها إلى جداول بيانات منظمة. يجب أن يكون الناتج ملف جدول بيانات. لا تُفعّل هذه الميزة عندما يكون الناتج الرئيسي مستند Word أو تقرير HTML أو برنامج Python مستقل أو مسار قاعدة بيانات أو تكامل مع واجهة برمجة تطبيقات Google Sheets، حتى لو كانت البيانات جدولية.
طريقة الاستخدام وفق المستند الأصلي
إنشاء ملفات XLSX وتحريرها وتحليلها
>openpyxl،pandas، وmarkitdownمثبتة مسبقًا - لا تقم بتشغيلهاpip installأولاً، اكتب البرنامج النصي واستورده مباشرةً. فقط في حالة فشل الاستيراد (أوmarkitdownالأمر مفقود):pip installالحزمة المفقودة. > مسارات البرامج النصية أدناه نسبية إلى دليل هذه المهارة.
اختيار الصيغ التي تصمد أمام التحقق
يُنفذ برنامج LibreOffice وظائف أقل من برنامج Excel، والوظيفة التي لا يستطيع تقييمها تصبح حرفية.#NAME?مُضمّنة في الملف الذي تُسلّمه. يُفضّل استخدام برنامج Excel.2007وظائف العصر -SUMIFS،INDEX،MATCH،IFERROR،SUMPRODUCT— والتي لا تحتاج إلى بادئة.
مشاكل Openpyxl
قراءة النموذج تتطلب عمليتي تحميل.data_only=Trueيُنتج هذا الخيار القيم المخزنة مؤقتًا بدون الصيغ؛ بينما يُنتج الخيار الافتراضي سلاسل الصيغ بدون قيم. لا يمكن لعملية واحدة أن تُعطيك كلا الخيارين.data_only=Trueيُعدّ الحفظ عمليةً مُدمّرة. لم يتبقَّ في هذا المصنّف أيّ صيغ، لذا فإنّ الحفظ يستبدل كلّ صيغة بصيغة حرفية - بشكلٍ دائم.
python scripts/recalc.py output.xlsx [timeout_seconds] # default 30المتطلبات والإعداد
متطلبات كل مخرج
يُستخدم خط احترافي (Arial، Times New Roman) في جميع أنحاء المنتج، ما لم يحدد المستخدم خلاف ذلك. لا توجد أخطاء في الصيغة. لا يتم الشحن أثناءrecalc.pyتقريرerrors_foundإذا كنت تعتقد أن الخطأ أقدم منك، فأثبت ذلك: حمّل الملف الأصلي باستخدامdata_only=Trueانظر إلى تلك الخلية. خطأ أدخلته يشبه تماماً خطأً ورثته.
التبعيات
openpyxl،pandas،markitdown(pip، مثبت مسبقًا - قم بالتثبيت فقط في حالة فشل الاستيراد أو عدم وجود الأمر) · LibreOffice (soffice، مُهيأة تلقائيًا للبيئات المعزولة عبرscripts/office/soffice.py)
الحدود وفحوصات الجودة
إعادة الحساب (إلزامي كلما احتوى الملف على صيغ)
يكتب openpyxl الصيغ كسلاسل نصية بدون قيم مخزنة مؤقتًا. إلى أن تعيد الحساب، تُقرأ كل خلية صيغة كـNoneلأي شيء يقرأ القيم المخزنة مؤقتًا —pandas،load_workbook(data_only=True)ومعظم برامج المعاينة. يقوم LibreOffice بحساب كل صيغة، ويتم إعادة كتابة الملف في مكانه، وستحصل على JSON:status(success|errors_found)total_formulas،total_errorsوerror_summaryتسمية حتى100الخلايا لكل نوع من أنواع الأخطاء (locations_truncatedيذكر عدد الأشخاص الذين احتجزهم - الثقةtotal_errors(وليس طول القائمة). أصلح ما يُسمّيه وأعد تشغيله. JSON معerrorمفتاح بدلاً من أstatusيعني ذلك أنه لم تتم إعادة حساب أي شيء، وأن هذه الحالة فقط هي التي تخرج بقيمة غير صفرية.errors_foundمخارج0لذا لا تتعامل أبدًا مع الخروج النظيف على أنه دفتر عمل نظيف.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
ca45fc496a3436251f191354091d557da31c15b5- المصدر SHA-256
6712b39718fe815054abca9c3ee72f989613e6f771c8a5c58f30a65a6c905622