من البث المباشر إلى تسجيل يمكن البحث فيه وفهمه.
منصة محلية لمساحات X: اكتشاف، تسجيل صوت وصورة، تفريغ، تحليل، ومراجعة داخل استوديو واحد.
شاهد التسجيل · ابدأ التشغيل · استكشف الواجهة · كل الميزات
الصور توضيحية من اختبار معزول. لا يحتوي المستودع على حسابات مراقَبة أو تسجيلات فعلية أو جلسة X أو أسرار. تظهر هوية XSpace Analyzer في بعض لقطات الواجهة الحالية؛ «مدار» اسم المشروع المنشور.
| 04 · راجع | 03 · عالج | 02 · سجّل | 01 · اكتشف |
|---|---|---|---|
| ابحث في المكتبة، وافتح المشغل والنص المرتبط بالتوقيت والشواهد. | جهّز ملف التشغيل، وفرّغ الكلام، وأنشئ التحليل عند توفر العامل. | تحقق من البث والمضيف، ثم التقط الصوت والصورة في جلسة مستقلة. | راقب الحسابات التي تضيفها أو أدخل رابط مساحة مباشرة. |
الحالة واضحة في كل مرحلة: يعرض النظام حالة الالتقاط، جودة الوسائط، التفريغ، والتحليل بصورة منفصلة، مع سبب الانتظار أو الفشل والإجراء التالي عند توفره.
لقطة مركزة من نافذة التسجيل الفعلية في المنصة. الرابط والمضيف وحالة الطلب في الصورة بيانات اختبار؛ الحالة الظاهرة قيد التحقق ولا تعني أن الالتقاط بدأ.
- افتح تسجيل بالرابط والصق رابطًا مثل
https://x.com/i/spaces/SPACE_ID. - اختر ابدأ التسجيل لطلب التحقق الآن، أو ضعه في الانتظار لحفظ الطلب. يتحقق النظام من المساحة ومضيفها قبل تخصيص الالتقاط.
- راقب الطلب في النافذة نفسها. يمكن إلغاؤه قبل البدء، ويظهر خيار الإيقاف عند وجود تسجيل نشط.
- بعد اكتمال الالتقاط، افتح مكتبة التسجيلات لمراجعة حالة الملف، ثم الاستوديو لتشغيله ومراجعة النص والتحليل إن اكتملت مهامهما.
| معناها | الحالة المعروضة |
|---|---|
| الطلب سُجّل؛ يجري التأكد من حالة البث والمضيف. | محفوظ وقيد التحقق |
| يجري إعداد الالتقاط. | تجهيز جلسة التسجيل |
| بدأت محاولة الالتقاط؛ راقب الحالة والملف الناتج. | بدأت محاولة التسجيل |
| انتهى الالتقاط ويمكن مراجعة الوسائط. | اكتمل التسجيل |
| راجع السبب الظاهر في الصفحة؛ لا تفترض وجود ملف مكتمل. | فشلت المحاولة أو المساحة منتهية |
إضافة رابط مساحة لا تضيف مضيفها تلقائيًا إلى الحسابات المراقَبة. قد تتأخر المعالجة أو تتوقف وفق حالة X والمتصفح والعامل؛ اعتمد على الحالة المعروضة لكل مرحلة.
ابحث وفرز التسجيلات، ثم اعرف حالة الملف والصوت والتفريغ والتحليل قبل فتح أي مساحة.
الاستوديو: المشغل والنص المرتبط بالوقت
انتقل من جملة في التفريغ إلى موضعها في التسجيل، وراجع خط الزمن والملفات المتاحة.
الحسابات المراقَبة ومشغل الجوال
أضف الحسابات التي تختارها بنفسك، وتابع موعد الفحص والمساحات المكتشفة.
المتطلبات: Windows وDocker Desktop ومساحة تخزين محلية للوسائط. يحتاج اكتشاف مساحات X وتسجيلها إلى تسجيل دخولك إلى X داخل المتصفح المرفق. يبدأ المستودع دون حسابات مراقَبة.
من جذر المشروع:
Copy-Item .env.example .env
# عدّل XSA_DATA_DIR في .env إلى مسار موجود على جهازك خارج OneDrive.
docker compose up -d --buildبعد تشغيل الحاويات:
- افتح متصفح المشروع وسجّل الدخول إلى X بنفسك.
- افتح الواجهة. أضف من الحسابات المراقَبة المعرّفات التي تريد متابعة مساحاتها.
- استخدم نافذة التسجيل لمساحة محددة، أو راقب المساحات المكتشفة تلقائيًا.
- افتح المكتبة لمراجعة الالتقاط والملف والتفريغ والتحليل.
وثائق API: http://localhost:8765/docs · فحص الصحة: http://localhost:8765/health
docker compose downملف .env وجلسة المتصفح وقاعدة البيانات والتسجيلات محلية وخارج Git. لا تضع كلمة مرور X أو رموز الجلسة داخل المشروع. احترم حقوق المشاركين وشروط الخدمة والقوانين المطبقة عند التسجيل أو مشاركة النتائج.
flowchart LR
X[مساحة X] --> B[متصفح ومراقب]
B --> R[التقاط الصوت والصورة]
R --> M[ملف المصدر ونسخة التشغيل]
M --> T[تفريغ الكلام]
T --> A[تحليل مدعوم بالشواهد]
M --> UI[المكتبة والاستوديو]
A --> UI
T -. إعداد اختياري .-> D[فصل المتحدثين]
D --> UI
تُحفظ الوسائط محليًا، بينما تُعرض حالات تجهيزها والتفريغ والتحليل بصورة مستقلة. فصل المتحدثين اختياري ويحتاج عاملًا منفصلًا وإعداد النموذج؛ وجود مهمة في الطابور لا يعني أن العامل بدأ تنفيذها.
| وظيفته | المسار |
|---|---|
| API، مراقبة المساحات، الالتقاط، مهام الوسائط، التفريغ والتحليل. | backend/xsa |
| ملفات واجهة العمل والمشغل. | backend/xsa/api/assets |
| اختبارات السلوك والحدود الحرجة. | backend/tests |
| الخدمات المحلية والعوامل الاختيارية. | docker وdocker-compose.yml |
| توثيق الميزات والخصوصية وصور العرض التجريبية. | docs |
cd backend
uv run --extra dev pytest -q
uv run --extra dev ruff check .
uv run --extra dev ruff format --check xsa tests scripts
uv run --extra dev python scripts/verify_local_workspace.py ../artifacts/fixture-checkنتيجة التحقق عند تحديث هذا الدليل: 287 اختبارًا برمجيًا و23 حالة متصفح ببيانات مؤقتة معزولة. سكربت لقطات التوثيق لا يشغّل متصفح X أو المراقب أو الالتقاط؛ حالة طلب التسجيل فيه محاكاة للواجهة فقط.
- التحقق من هوية المتحدث يعتمد على الأدلة الصوتية المتاحة؛ ظهور حساب في المساحة لا يثبت هوية الصوت.
- فصل المتحدثين يحتاج عامل Docker منفصلًا وشروط وصول إلى النموذج. تبقى المهام محفوظة في الانتظار إلى أن يكتمل الإعداد.
- الواجهة الحالية ما زالت في مرحلة إعادة التصميم؛ الملفات فُصلت إلى HTML وCSS وJavaScript لتسهيل التطوير.
- التطبيق مهيأ للاستضافة المحلية. لا تنشر منفذي الواجهة والمتصفح على الإنترنت دون طبقة مصادقة وشبكة مناسبة.
تفاصيل البنية والخصوصية: الميزات · الخصوصية والبيانات.








