عن المشروع

DeckTools هو مستودع أحادي (monorepo) مبني على pnpm لأتمتة مهام Deckflow، مصمم لمعالجة ملفات العروض التقديمية على نطاق واسع في السحابة. يحتوي المستودع على ثلاثة حزم رئيسية: حزمة TypeScript SDK (`@deckflow/decktools-sdk`) لرفع الملفات وواجهات برمجة التطبيقات في Node.js والمتصفحات، وحزمة Go SDK لنفس الواجهات، وواجهة سطر أوامر Node.js (`decktools`) للاستخدام عبر الطرفية. التثبيت والبناء سهلان باستخدام pnpm: قم بتشغيل `pnpm install` و`pnpm build` و`pnpm typecheck` و`pnpm test` لإعداد مساحة العمل. يمكن بناء واجهة سطر الأوامر وتشغيلها محليًا عبر `pnpm --filter decktools build` يتبعه `node apps/node-cli/dist/cli.js --help`. تدعم واجهة سطر الأوامر تسجيل الدخول وإدارة الإعدادات وأوامر تحويل الملفات. للبدء السريع، قم بتشغيل `decktools login` و`decktools config show` و`decktools convert slides.pptx --to pdf` لتحويل ملفات PowerPoint إلى PDF. توفر حزمة TypeScript SDK دالة `createDeck` تقبل رمزًا (token) ومعرف مساحة (space ID) وعنوان جذر اختياري للواجهة (الافتراضي `https://app.deckflow.com/v1`). تتم المصادقة عبر ترويسة `X-Auth-Token` للرموز أو `Authorization: Bearer` للمفاتيح. تكشف الحزمة عن طرق مثل `convertPptToPdf` لتحويل الملفات و`tasks.wait` للاستعلام عن اكتمال المهمة. تم تنظيم مساحة العمل لدعم إضافات مستقبلية لحزم SDK تحت `sdks/python` أو `sdks/java` أو `sdks/rust`، مما يشير إلى خطط لتغطية لغات أوسع. تحتوي كل حزمة على ملف README خاص بها مع توثيق مفصل للتثبيت والإعداد وأمثلة الاستخدام.