

شنو كايحلّ هاد المشروع؟
Gongwen GB/T 9704-2012 Skill هو أداة مفتوحة المصدر موجهة للوثائق الرسمية بالصينية. ماشي غير كايعيّن خط أسود للعناوين وخط仿宋 للنص، بل كايتكلف، حسب المتطلبات القابلة للتنفيذ ديال GB/T 9704-2012، بتنسيق صفحات A4، منطقة الكتابة، العناوين، النص، المستويات، الصفحة الأولى، اسم المؤسسة، رقم الوثيقة، التوقيع، التاريخ وترقيم الصفحات، وكيخرج ملفات DOCX قابلة للتعديل من بعد.
المشروع مناسب للتقارير العادية، المشاريع والعروض، وكايدعم حتى إصدار الوثائق الرسمية، الطباعة فوق أوراق رسمية فيها الرأس والخط الأحمر مطبوعين من قبل، الرأس الرسمي الإلكتروني الكامل، المراسلات، الأوامر والبيانات. من بعد التوليد، يمكن تكملة تعديل الوثيقة فـ Word أو WPS، وإضافة الجداول والمرفقات وصور الأختام، أو ترتيب الختم الفعلي.

GB/T 9704-2012 كايتطبق على الوثائق الرسمية اللي كاتصدرها أجهزة الحزب والحكومة، ويمكن للمؤسسات والوحدات الأخرى تعتمد عليه كمرجع. README كايذكر بلي هاد المعيار بقى ساري المفعول من بعد المراجعة ديالو نهار 30 ماي 2025.
الوظائف الأساسية وحدود الاستعمال
- المواد العادية: الاستعمال الافتراضي هو
ordinary، وحتى إلا تعطات تسمية المؤسسة، ماكايتمش إنشاء رأس رسمي بشكل تلقائي. - الإصدار الرسمي: خاص اختيار
formalبشكل صريح. وضعية الورق الرسمي المطبوع من قبل غير كاتخلي البلاصة للرأس والخط الأحمر الموجودين فالورق، وماكاتعاودش ترسمهم داخل DOCX. - الرأس الإلكتروني: غير ملي كايتحدد
formal --letterhead digital، المولّد كايرسم جميع عناصر الرأس الرسمي. - اسم المؤسسة ورقم الوثيقة: كاايتعطاو باستعمال
--orgو--doc-no. التنسيق الرسمي كاايرفض أرقام الوثائق اللي باينة ماكاتحترمش قواعد السنة، الأقواس السداسية، الرقم الترتيبي وحرف “号”. - العناوين والفهرس: العناوين من المستوى الرابع كاايتكتبو بأنماط “العنوان1” حتى “العنوان4” ديال Word/WPS، ومع مستويات المخطط المناسبة، وبهاد الطريقة يمكن إدراج فهرس تلقائي.
- ترقيم الصفحات: كاايدعم التوسيط، الصفحات الفردية والزوجية، وعدم إظهار الترقيم. خاص اعتماد المعاملات المحددة فـ
SKILL.mdديال المشروع. - المرفقات ومعلومات الإصدار: يمكن توليد المرفقات فصفحات مستقلة مع الحفاظ على استمرارية الترقيم الرسمي؛ ويمكن تثبيت معلومات النسخ أو الإرسال فأسفل منطقة الكتابة فالصفحة الأخيرة.
- المعالجة اليدوية: الأختام، أختام التوقيع، محتوى المرفقات ومواقع الختم الفعلية خاصها تبقى تتزاد أو تتراجع يدوياً فـ DOCX حسب الاستعمال.

تحضير المشروع وبيئة التشغيل
فالأول جيب المستودع من عنوان المشروع على GitHub، ودخل للمجلد الرئيسي ديال المشروع. المولّد وأداة التحقق كاايتشغلو بواسطة node، وهادشي كاايتطلب تكون عندك بيئة Node.js خدامة فالجهاز؛ README ماحددش إصدار معيّن، لذلك خاص الاعتماد على السكريبتات والاختبارات الحالية ديال المستودع.
إلا كنت باغي غير تولّد DOCX مباشرة، تقدر تشغّل السكريبت من داخل المستودع. وإلا بغيتي أداة برمجة بالذكاء الاصطناعي تقرا هاد Skill تلقائياً، تقدر تستعمل المثبّت متعدد المنصات.
macOS وLinux
scripts/install.sh --allWindows
.\scripts\install.ps1 -Allالمثبّت كاايربط نفس مجلد المصدر مع مجلدات المهارات الخاصة بالمستخدم فكل منصة. Windows كاايستعمل النسخ افتراضياً لتفادي مشاكل الصلاحيات ديال الروابط الرمزية. المنصات المدعومة هي Codex وClaude Code وOpenCode وTrae Code وTrae CLI وKimi Code CLI وKimi Code وWorkBuddy وZCode. TraeWork كاايدخل حزمة الاستيراد الموجودة فـ dist/traework-gongwen-skill.zip.

توليد أول مادة عادية
المشروع كاايوفر ملف الإدخال التجريبي tests/fixture.md. الأمر التالي كاايحوّلو لتنسيق المواد العادية وكيكتب النتيجة فمجلد مؤقت:
node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/gongwen.docx --format ordinary --title "اختبار تراجعي لتنسيق الوثائق الرسمية"المعاني الأساسية ديال المعاملات هي:
--input: ملف المحتوى المدخل.--output: مسار ملف DOCX المولّد.--format ordinary: استعمال تنسيق التقرير أو المشروع أو العرض العادي.--title: تحديد عنوان الوثيقة.
من بعد ما يكمل التوليد، استعمل أداة التحقق باش تفحص بنية DOCX وعناصر التنسيق اللي كاايتكفل بها البرنامج:
node scripts/verify_gongwen_docx.mjs --input /tmp/gongwen.docx --profile ordinaryنجاح التحقق ماكايعنيش أنه يمكن تجاوز المراجعة النهائية. قبل التسليم الرسمي، خاص تفتح الملف فـ Word أو WPS على الحاسوب المستهدف، وتراجع الالتفاف، تقسيم الصفحات، الخطوط، المرفقات ومواقع الختم حسب ظروف الطباعة الفعلية.
توليد نسخة للطباعة فوق ورق رسمي مطبوع من قبل
إلا كانت المادة غادي تطبع فوق ورق فيه من قبل الشعار الأحمر ديال المؤسسة والخط الأحمر، خاص اختيار التنسيق الرسمي ووضعية الورق الرسمي المطبوع من قبل بوضوح:
node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal.docx --format formal --letterhead preprinted --letterhead-reserve-mm 72 --org "وثيقة المؤسسة النموذجية" --doc-no "مثال发〔2026〕1号" --title "اختبار تراجعي لتنسيق الوثائق الرسمية"--letterhead-reserve-mm 72 كاايعني تخصيص 72 ميليمتراً فالصفحة الأولى للمنطقة ديال الرأس الرسمي الموجودة فالورق. 72 ميليمتراً هي القيمة الافتراضية، ولكن فالاستعمال الفعلي خاص قياس الورق الرسمي ديال المؤسسة، والتعديل داخل المجال المدعوم من 37 حتى 130 ميليمتراً. هاد الوضعية ماكاتعاودش ترسم الشعار الأحمر والخط الأحمر داخل DOCX.
من بعد استعمل إعدادات التنسيق الرسمي المناسبة للتحقق:
node scripts/verify_gongwen_docx.mjs --input /tmp/formal.docx --profile formal --letterhead preprintedتوليد رأس رسمي إلكتروني كامل
غير إلا كان ضروري فعلاً ترسم جميع عناصر الرأس الرسمي داخل DOCX، استعمل --letterhead digital:
node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal-digital.docx --format formal --letterhead digital --org "وثيقة المؤسسة النموذجية" --doc-no "مثال发〔2026〕1号" --title "اختبار تراجعي لتنسيق الوثائق الرسمية"الرأس الإلكتروني حساس أكثر لبيئة الخطوط. خاص الرأس والعنوان يستعملو خط Xiaobiao Song المثبّت فعلياً فالحاسوب المستهدف، والنصوص الأخرى خاصها خط FangSong المعياري. إلا ما لقاهمش المولّد، غااينبّه فالمحطة وغاايسجل الخط البديل اللي تستعمل.

منع تعويض الخطوط
فحالات التسليم اللي ماكاتقبلش تعويض الخطوط، زيد --require-standard-fonts للمولّد وأداة التحقق بجوج. إلا كان الحاسوب ناقصو خط Xiaobiao Song أو خط FangSong المعياري، الأمر غاايتوقف وغااايعرض الخطوط الناقصة، بلا ما يكمل ويخرج نسخة بخطوط بديلة.
node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/strict.docx --format formal --letterhead digital --org "وثيقة المؤسسة النموذجية" --doc-no "مثال发〔2026〕1号" --title "اختبار تراجعي لتنسيق الوثائق الرسمية" --require-standard-fonts
node scripts/verify_gongwen_docx.mjs --input /tmp/strict.docx --profile formal --letterhead digital --require-standard-fontsالفهرس والمرفقات والتنسيقات الخاصة
إنشاء الفهرس فـ Word أو WPS
المولّد كااايكتب العناوين الأربعة فأنماط العناوين المعيارية ومستويات المخطط. من بعد فتح الوثيقة، يمكن اختيار “مراجع ← جدول المحتويات” فـ Word/WPS لإنشاء أو تحديث الفهرس التلقائي. إظهار العناوين من المستوى الرابع كااايتحدد من إعدادات الفهرس.
إضافة المرفقات
باستعمال --attachment-file أكثر من مرة، يمكن إضافة عدة مرفقات فصفحات مستقلة. المولّد كااايرتب تسمية “مرفق”، عنوان السطر الثالث والنص، وكيحافظ على استمرارية ترقيم الوثيقة الرسمية. بنية الإدخال بالتفصيل خاصها تتراجع فـ SKILL.md الموجود فالمستودع.
اختيار فرع التوليد الخاص
- المراسلة
letter: توليد خطين أحمرين علوي وسفلي بالحجم المحدد، مع وضع الخط السفلي فالتذييل وإيقاف ترقيم الصفحات. - الأمر
command: تطبيق متطلبات التنسيق بحذف سطرين تحت شعار المؤسسة وسطرين تحت رقم الأمر، وغير ذلك. - المحضر
minutes: جعل تسميات “الحاضرون” و“المعتذرون” و“الحاضرون بصفة مراقب” بالخط الأسود، ولائحة الأسماء بخط FangSong.
هاد الأنواع ماشي غير تبديل بسيط للنص داخل التنسيق العادي، بل كل نوع كااايدخل لفرع توليد خاص به. قبل الاختيار خاص التأكد من نوع الوثيقة.
نصائح للاستعمال المتقدم
- ماتخمّنش نوع الرأس الرسمي من اسم المؤسسة. المواد العادية خاصها دائماً تستعمل
ordinaryبشكل واضح، والإصدار الرسمي خاصو يستعملformalبشكل صريح. - أكد على الورق قبل ما تضبط المساحة الفارغة للطباعة فوقه. القياس الفعلي للورق الرسمي المطبوع من قبل يقدر يختلف حسب قالب المؤسسة، وماخاصش استعمال 72 ميليمتراً بشكل آلي.
- ثبّت الخطوط وتحقق منها فبيئة التعديل النهائية. نفس الخط يقدر يكون عندو اسم مختلف فأنظمة مختلفة أو فـ Word وWPS، والخط البديل يقدر يبدل حجم الخط، تباعد الأسطر والالتفاف.
- استعمل أنماط العناوين لتدبير الوثائق الطويلة. ماتحاولش تقلد مستويات الفهرس يدوياً، واستعمل أنماط العناوين من العنوان1 حتى العنوان4 اللي كااايكتبها المولّد.
- جمع بين التحقق التلقائي والمراجعة اليدوية. يمكن الرجوع إلى
references/gbt9704-audit-matrix.mdوreferences/formal-checklist.mdفالمستودع، والتمييز بين العناصر اللي يمكن فحصها آلياً والعناصر اللي خاصها مراجعة بشرية. - ردّ بالك للمنطق الخاص بالتنسيق. الرأس الرسمي الإلكتروني كااايستعمل أسطر فارغة محددة بوضوح بحجم 28 نقطة لضبط المسافة بين العنوان تحت الخط الأحمر وشعار المؤسسة ورقم الوثيقة؛ وفالوثائق الموجهة للأعلى، كااايتحط رقم الوثيقة واسم الموقّع فالسطر نفسه.
تشغيل اختبارات المشروع
فبيئة macOS أو Linux، يمكن تشغيل اختبارات التراجع اللي كااايوفرها المستودع:
tests/run_tests.shالاختبارات كاتغطي توليد ترقيم الصفحات فالوسط وفالصفحات الفردية والزوجية، وبنية حزمة DOCX والتحقق من التحويل إلى PDF، باش تبيّن بلي المولّد وأداة التحقق ومسار الملف القابل للطباعة خدامين. ويمكن حتى التحقق من التثبيت متعدد المنصات باستعمال tests/test-install.sh داخل بيئة معزولة، بما فيها مجلد المهارات المحلي وحزمة الاستيراد ديال TraeWork.
الخلاصة
Gongwen Skill كيجمع قواعد المراسلات الإدارية اللي كتكون غالباً مفرّقة بين التعليمات، وقوالب Word، والسكريبتات المؤقتة، فمسار واحد قابل للصيانة. أحسن طريقة للاستعمال هي: تختار أولاً التنسيق العادي ولا الرسمي المناسب، ومن بعد تنشئ DOCX، وتشغّل أداة التحقّق، وفالأخير تدير المراجعة اليدوية فـ Word/WPS المستهدف، ومع الخطوط المتوفرة وظروف الطباعة. المشروع مرخّص برخصة MIT، ولكن النصوص المعيارية وقوالب الإدارات خاصها تبقى خاضعة للقواعد الخاصة بالحقوق والتدبير ديال كل جهة.
