اللغة: العربيةFilePulse المحلي HTTP واجهة برمجة التطبيقات
يسمح للذكاء الاصطناعي والبرامج النصية والمشغلات والأدوات الداخلية باستدعاء إمكانات البحث والمعاينة الخاصة بـ FilePulse من خلال واجهة الويب HTTP API المحلية التي تستخدمها واجهة الويب FilePulse.
http://127.0.0.1:80يستخدم المثال المنفذ الافتراضي HTTP رقم 80 في config_default.json. أثناء النشر الفعلي، يرجى الرجوع إلى المنفذ في ملف config.json المحلي الخاص بالمستخدم.
ابدأ هنا
استكشف أولاً، ثم قم بتسجيل الدخول للحصول على الرمز المميز، ثم ضع الرمز المميز الذي تم إرجاعه مباشرةً في رأس التفويض. لا تقم بإضافة البادئة Bearer.
/api/verإصدار الإرجاع والخطة. قد تعرض الإصدارات المتوفرة عبر الإنترنت أيضًا المعرف الفريد (uid) والرخصة_المتبقية_الساعات. هذه الواجهة لا تتطلب رمزًا مميزًا.
curl http://127.0.0.1:80/api/ver/api/loginأرسل اسم المستخدم وكلمة المرور باستخدام JSON. تحتوي الاستجابة على اسم الخادم ورمز الوصول.
curl -X POST http://127.0.0.1:80/api/login \
-H "Content-Type: application/json" \
-d '{"username":"root","password":"root"}'Authorization: <access_token>تضع الطلبات اللاحقة الرمز المميز مباشرة في رأس التفويض، أو في معلمة استعلام التفويض.
curl http://127.0.0.1:80/api/search_scope_targets \
-H "Authorization: $FILEPULSE_TOKEN"الواجهات الأساسية
تلائم هذه الواجهات سير العمل المدعوم بالذكاء الاصطناعي: اكتشاف النطاق والبحث والمعاينة والتنزيل، مع فتح الملفات فقط بعد تأكيد المستخدم.
/api/search_scope_targetsيعرض أهداف البحث المفهرسة. عندما تحتاج إلى تحديد نطاق البحث، ضع فهرس محرك الأقراص الذي تم إرجاعه في Drive_scope.
curl http://127.0.0.1:80/api/search_scope_targets \
-H "Authorization: $FILEPULSE_TOKEN"/api/searchالبحث حسب البيانات التعريفية للملف/المجلد، ودعم أحرف البدل أو الأنماط العادية، والتصفية والفرز والترحيل.
curl -X POST 'http://127.0.0.1:80/api/search' \
-H 'Content-Type: application/json' \
-H "Authorization: $FILEPULSE_TOKEN" \
--data-raw '{
"search_content": "a",
"mode": "wildcard",
"case_sensitive": false,
"search_by": "name",
"sort_by": "modified",
"sort_asc": false,
"content_plugin": [""],
"kind": 0,
"pin_priority": false,
"use_groups": false,
"start": 0,
"end": 13,
"inline_icon": {
"size": 32
}
}'/api/content_searchنص مستند البحث، ونص OCR، والمحتوى المفهرس لمعالجات المحتوى التي تم تكوينها. يوصى بتشغيل المقتطف عندما يحتاج الذكاء الاصطناعي إلى الوصول إلى السياق.
curl -X POST 'http://127.0.0.1:80/api/content_search' \
-H 'Content-Type: application/json' \
-H "Authorization: $FILEPULSE_TOKEN" \
--data-raw '{
"linear": false,
"search_content": "a",
"mode": "regular",
"fuzzy_distance": 2,
"score_top_k": 100,
"sort_by": "score",
"sort_asc": false,
"snippet": false,
"snippet_radius": 100,
"pin_priority": false,
"use_groups": false,
"start": 0,
"end": 13,
"inline_icon": {
"size": 32
}
}'/api/visual_statusيعرض ما إذا كان البحث المرئي ممكنًا، وتقدم الفهرسة، وعدد الملفات القابلة للبحث، وعدد الخطوط المتجهة، ومدى توفر ffmpeg.
curl http://127.0.0.1:80/api/visual_status \
-H "Authorization: $FILEPULSE_TOKEN"/api/visual_searchاستخدم بيانات النماذج متعددة الأجزاء لإرسال الصور أو لقطات الشاشة أو مقاطع الفيديو، أو FilePulse مسار الاستعلام المطلق على المضيف.
curl -X POST 'http://127.0.0.1:80/api/visual_search' \
-H "Authorization: $FILEPULSE_TOKEN" \
-F 'file=@query.jpg' \
-F 'top_k=20' \
-F 'drive_indices=[0]' \
-F 'fast_mode=true'/api/download/{encodedPath}يُرجع البث مسارات الملفات الأصلية أو الوكيل. برجاء وضع المسار الكامل في المسار بعد تشفير URL وحمل التفويض. تدعم خدمة الملفات الأساسية طلبات النطاق.
curl 'http://127.0.0.1:80/api/download/D%3A%5Cdocs%5Creport.pdf' \
-H "Authorization: $FILEPULSE_TOKEN" \
--output report.pdf/api/folder_previewإرجاع قائمة صغيرة ومرتبة من المجلدات لتجنب سحب جميع المجلدات الفرعية مرة واحدة.
curl -X POST http://127.0.0.1:80/api/folder_preview \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{"path":"D:\\docs","limit":50}'/api/content_match_previewاحصل على سياق HTML/نص لنتيجة بحث محتوى معينة، حتى يتمكن الذكاء الاصطناعي من التحقق من موقع النتيجة قبل طلب ذلك افتح الملف.
curl -X POST http://127.0.0.1:80/api/content_match_preview \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{
"path": "D:\\docs\\report.pdf",
"modified": 1717113600,
"search_content": "invoice",
"mode": "regular",
"linear": false,
"fuzzy_distance": 2
}'/api/openfileقم بتشغيل الملف أو البرنامج القابل للتنفيذ على الجهاز الذي يوجد به FilePulse. هذه العملية لها آثار جانبية، ويجب أن تطلب أدوات الذكاء الاصطناعي من المستخدمين التأكيد بشكل صريح أولاً.
curl -X POST http://127.0.0.1:80/api/openfile \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{"path":"D:\\docs\\report.pdf","work_folder":"","admin":false}'/api/quick_launcherالبحث عن التطبيقات والمجلدات والاختصارات القابلة للتشغيل، ويتبع نص الطلب بشكل أساسي بنية /api/search.
curl -X POST http://127.0.0.1:80/api/quick_launcher \
-H "Content-Type: application/json" \
-H "Authorization: $FILEPULSE_TOKEN" \
-d '{
"search_content": "chrome",
"mode": "wildcard",
"case_sensitive": false,
"search_by": "full_path",
"sort_by": "modified",
"sort_asc": false,
"content_plugin": [""],
"kind": 0,
"start": 0,
"end": 9
}'توصيات استدعاء الذكاء الاصطناعي
احتفظ بالنموذج في مسار ضيق: المصادقة والبحث والفحص ثم طلب تأكيد المستخدم قبل فتح الملف أو تغييره.
يوصى بأن يقوم المستخدم أو البرنامج المضيف بتوفير رمز مميز لجلسة قصيرة. لا تقم بحفظ كلمات المرور في ذاكرة النموذج أو السجلات الطويلة أو الكلمات السريعة القابلة لإعادة الاستخدام.
قد يؤدي فتح ملف إلى بدء تشغيل برنامج أو كشف البيانات المحلية. يجب أن يُظهر الذكاء الاصطناعي المسار الدقيق وينتظر موافقة المستخدم.
يوصى باستخدام الطرف 9 أو الطرف 19 أولاً، والتحقق من اسم الملف والملخص، ثم طلب المزيد من النتائج حسب الحاجة.
لا تغطي هذه الصفحة
لم يتم تضمين الواجهات التالية عمدًا في صفحة الإدخال العامة، لأنها تنتمي إلى الاتصالات الداخلية أو العمليات التدميرية أو واجهات الإدارة أو أكثر ملاءمة لكتابة المستندات المتقدمة بشكل منفصل.