feishu2md

feishu2md

هذه أداة لتنزيل مستندات Feishu كملفات Markdown، ويتم تنفيذها باستخدام لغة Go.

يرجى الاطلاع هنا: قم بتوظيف المطورين ذوي الاحتياجات والاهتمامات لمناقشة التطوير والصيانة معًا. إذا كنت مهتمًا، فيرجى الاتصال بنا.

تحفيز

"مهارة واحدة في اليوم | هذه الأداة الصغيرة التي طورتها يمكن أن تساعدك بسهولة في تحويل مستندات Feishu إلى Markdown"

احصل على رمز API

يحتاج ملف التكوين إلى ملء معرف التطبيق ومعلومات التطبيق السرية، يرجى الرجوع إلى وثائق Feishu الرسمية للحصول عليه. الإعداد الموصى به هو

• أدخل الواجهة الخلفية لمطور Feishu
• أنشئ تطبيقًا ذاتيًا (نسخة شخصية) واملأ المعلومات كما تريد
• (مهم) افتح إدارة الأذونات وقم بتمكين الأذونات الضرورية التالية (يمكنك النقر فوق الرابط أدناه للإشارة إلى وحدة تحكم تصحيح أخطاء واجهة برمجة التطبيقات -> حقل تكوين الأذونات)
  • الحصول على المعلومات الأساسية للمستند، إذن "عرض نسخة جديدة من المستند" docx:document:readonly
  • احصل على كافة كتل المستند، إذن "عرض نسخة جديدة من المستند" docx:document:readonly
  • تنزيل المواد، docs:document.media:download
  • احصل على قائمة الملفات في المجلد، إذن "عرض جميع الملفات في المساحة السحابية والتعليق عليها وتحريرها وإدارتها" drive:file:readonly
  • الحصول على معلومات عقدة مساحة المعرفة، إذن "عرض قاعدة المعرفة" wiki:wiki:readonly
• افتح بيانات الاعتماد والمعلومات الأساسية للحصول على معرف التطبيق وسر التطبيق

كيفية الاستخدام

ملاحظة: تقرر عدم صيانة أداة تنزيل الإصدارات القديمة من مستندات Feishu بعد الآن، ولكن لا يزال من الممكن استخدام الفرع v1_support، والأرشيف المقابل هو الإصدار 1.4.0.

نسخة سطر الأوامر

باستخدام ميزة النظام الأساسي المشترك للغة Go، تم تجميع الملفات القابلة للتنفيذ للأنظمة الأساسية الرئيسية ويمكن تنزيلها في الإصدار، ويمكن وضع الملف القابل للتنفيذ feishu2md للنظام الأساسي المقابل في مسار PATH.

تحقق من وثائق المساعدة

$ feishu2md -h
NAME:
  feishu2md - Download feishu/larksuite document to markdown file

USAGE:
  feishu2md [global options] command [command options] [arguments...]

VERSION:
  v2-0e25fa5

COMMANDS:
  config        Read config file or set field(s) if provided
  download, dl  Download feishu/larksuite document to markdown file
  help, h       Shows a list of commands or help for one command

GLOBAL OPTIONS:
  --help, -h     show help (default: false)
  --version, -v  print the version (default: false)

$ feishu2md config -h
NAME:
   feishu2md config - Read config file or set field(s) if provided

USAGE:
   feishu2md config [command options] [arguments...]

OPTIONS:
   --appId value      Set app id for the OPEN API
   --appSecret value  Set app secret for the OPEN API
   --help, -h         show help (default: false)

$ feishu2md dl -h
NAME:
  feishu2md download - Download feishu/larksuite document to markdown file

USAGE:
  feishu2md download [command options] < url >

OPTIONS:
  --output value, -o value  Specify the output directory for the markdown files (default: " ./ " )
  --dump                    Dump json response of the OPEN API (default: false)
  --batch                   Download all documents under a folder (default: false)
  --wiki                    Download all documents within the wiki. (default: false)
  --help, -h                show help (default: false)

إنشاء ملف التكوين

يمكن إنشاء ملف تكوين الأداة من خلال الأمر feishu2md config --appId --appSecret .

يمكنك استخدام أمر feishu2md config للتحقق من مسار ملف التكوين وما إذا كان التكوين ناجحًا.

لمزيد من خيارات التكوين، يرجى فتح تغييرات ملف التكوين يدويًا.

قم بتنزيل مستند واحد كـ Markdown

قم بالتنزيل مباشرة من خلال feishu2md dl ، ويمكن الحصول على رابط المستند من خلال المشاركة > تشغيل مشاركة الارتباط > يمكن للأشخاص الذين يحصلون على الرابط على الإنترنت القراءة > نسخ الرابط .

مثال:

$ feishu2md dl " https://domain.feishu.cn/docx/docxtoken "

قم بتنزيل جميع المستندات دفعة واحدة في مجلد باسم Markdown

لا تدعم هذه الميزة حاليًا إصدارات Docker

قم بالتنزيل مباشرة من خلال feishu2md dl --batch يمكن الحصول على رابط المجلد من خلال المشاركة > تشغيل مشاركة الارتباط > يمكن للأشخاص الذين يحصلون على الرابط على الإنترنت القراءة > نسخ الرابط .

مثال:

$ feishu2md dl --batch -o output_directory " https://domain.feishu.cn/drive/folder/foldertoken "

قم بتنزيل جميع المستندات الخاصة بقاعدة المعرفة دفعة واحدة مثل Markdown

قم بالتنزيل مباشرة من خلال feishu2md dl --wiki ، ويمكن الحصول على رابط إعدادات wiki عن طريق فتح إعدادات قاعدة المعرفة.

مثال:

$ feishu2md dl --wiki -o output_directory " https://domain.feishu.cn/wiki/settings/123456789101112 "

نسخة عامل الميناء

صورة عامل الميناء: https://hub.docker.com/r/wwwsine/feishu2md

أمر Docker: docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID= -e FEISHU_APP_SECRET= -e GIN_MODE=release wwwsine/feishu2md

إنشاء عامل ميناء:

 # docker-compose.yml
version : ' 3 '
services :
  feishu2md :
    image : wwwsine/feishu2md
    environment :
      FEISHU_APP_ID : 
      FEISHU_APP_SECRET : 
      GIN_MODE : release
    ports :
      - " 8080:8080 "

ابدأ docker compose up -d

ثم قم بزيارة https://127.0.0.1:8080 والصق رابط المستند. يمكن الحصول على رابط المستند من خلال المشاركة > تمكين مشاركة الرابط > نسخ الرابط .

النسخة على الانترنت

لقد استخدمت اختبار API Token الخاص بي لنشر إصدار غير مستقر على نظام Render الأساسي. لن يحفظ هذا الإصدار أي وثائق وصور في الحاوية، وسيقوم بإرجاع ملف الحزمة المضغوط مباشرة من الذاكرة عبر HTTP، ولكن سجل نظام Render. قد يقوم بتسجيل بعض معلومات HTTP.

الإصدار الحالي مخصص للاستخدام المؤقت فقط من قبل المستخدمين الذين لا يهتمون بالخصوصية أو الذين يكونون كسالى جدًا بحيث لا يمكنهم تكوينه. ويمكن استخدامه أيضًا لاختبار ومقارنة ما إذا كانت هناك مشكلة في تكوين إذن الرمز المميز الخاص بهم. تستخدم منصة Render حصة مجانية وتحتوي على 512 مليونًا فقط من الذاكرة. لا يمكن ضمان التوفر العالي. تعتمد سلسلة الثقة بالكامل على كود مفتوح المصدر، لذا يرجى استخدامها وفقًا لتقديرك الخاص.

تفضل بزيارة https://feishu2md.onrender.com/ والصق رابط المستند. يمكن الحصول على رابط المستند من خلال المشاركة > تمكين مشاركة الرابط > نسخ الرابط .

شاكر

• شيروك/لارك
• chyroc/lark_docs_md