apunkt/trustgraph
1
0
Fork 0
mirror of https://github.com/trustgraph-ai/trustgraph.git synced 2026-04-25 16:36:21 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
trustgraph/docs/cli-changes-v1.8-to-v2.1.ar.md
Alex Jenkins 8954fa3ad7 Feat: TrustGraph i18n & Documentation Translation Updates (#781) 
Native CLI i18n: The TrustGraph CLI has built-in translation support
that dynamically loads language strings. You can test and use
different languages by simply passing the --lang flag (e.g., --lang
es for Spanish, --lang ru for Russian) or by configuring your
environment's LANG variable.

Automated Docs Translations: This PR introduces autonomously
translated Markdown documentation into several target languages,
including Spanish, Swahili, Portuguese, Turkish, Hindi, Hebrew,
Arabic, Simplified Chinese, and Russian.
2026-04-14 12:08:32 +01:00

9.2 KiB
Raw Blame History

layout title parent
default تغييرات واجهة سطر الأوامر: من v1.8 إلى v2.1 Arabic (Beta)

تغييرات واجهة سطر الأوامر: من v1.8 إلى v2.1

Beta Translation: This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.

ملخص

تمت إضافة العديد من الميزات إلى واجهة سطر الأوامر (trustgraph-cli)، مع التركيز على ثلاثة مجالات: القابلية للتفسير/الأصل، الوصول إلى التضمينات، و استعلامات الرسم البياني. تم إزالة أدوات قديمة، وتم تغيير اسم أداة واحدة، وحصلت العديد من الأدوات الموجودة على قدرات جديدة.

أدوات واجهة سطر الأوامر الجديدة

القابلية للتفسير والأصل

الأمر الوصف
tg-list-explain-traces يسرد جميع جلسات القابلية للتفسير (GraphRAG و Agent) في المجموعة، مع عرض معرفات الجلسة ونوعها ونص السؤال وتوقيتات الإصدار.
tg-show-explain-trace يعرض مسار القابلية للتفسير الكامل لجلسة. لـ GraphRAG: مرحلة السؤال، والبحث/التنقيب، والتركيز، والتوليف. لـ Agent: مرحلة الجلسة، والتكرارات (فكر/عمل/ملاحظة)، والإجابة النهائية. يكتشف تلقائيًا نوع المسار. يدعم الخيارات --show-provenance لتتبع الحواف مرة أخرى إلى المستندات المصدر.
tg-show-extraction-provenance بالنظر إلى معرف المستند، فإنه يتتبع سلسلة الأصل: المستند -> الصفحات -> القطع -> الحواف، باستخدام علاقات prov:wasDerivedFrom. يدعم الخيارات --show-content و --max-content.

التضمينات

الأمر الوصف
tg-invoke-embeddings يحول النص إلى تضمين متجه عبر خدمة التضمينات. يقبل إدخالات نصية واحدة أو أكثر، ويعيد المتجهات كمصفوفات من الأرقام العشرية.
tg-invoke-graph-embeddings يستعلم عن الكيانات في الرسم البياني باستخدام التضمينات النصية. يعيد الكيانات المطابقة مع درجات التشابه.
tg-invoke-document-embeddings يستعلم عن قطع المستند باستخدام التضمينات النصية. يعيد معرّفات القطع المطابقة مع درجات التشابه.
tg-invoke-row-embeddings يستعلم عن صفوف البيانات المهيكلة باستخدام التشابه النصي على الحقول الفهرسية. يعيد الصفوف المطابقة مع قيم الفهرس ودرجاتها. يتطلب --schema-name ويدعم --index-name.

استعلام الرسم البياني

الأمر الوصف
tg-query-graph استعلام مخزن ثلاثي يعتمد على الأنماط. على عكس tg-show-graph (الذي يعرض كل شيء)، فإنه يسمح بالاستعلامات الانتقائية باستخدام أي مجموعة من الموضوع والصفة والكائن والرسم البياني. يكتشف تلقائيًا أنواع القيم: IRIs (http://..., urn:..., <...>)، ثلاثيات مُقتبسة (<<s p o>>)، والمفردات.
tg-get-document-content يسترجع محتوى المستند من المكتبة بمعرف المستند. يمكن إخراجها إلى ملف أو stdout، ويدعم كلًا من المحتوى النصي والمحتوى الثنائي.

أدوات واجهة سطر الأوامر المحذوفة

الأمر الملاحظات
tg-load-pdf تم حذفه. يتم الآن التعامل مع تحميل المستند من خلال المكتبة/مسار المعالجة.
tg-load-text تم حذفه. يتم الآن التعامل مع تحميل المستند من خلال المكتبة/مسار المعالجة.

تغيير أسماء أدوات واجهة سطر الأوامر

الاسم القديم الاسم الجديد الملاحظات
tg-invoke-objects-query tg-invoke-rows-query يعكس تغيير التسمية من "الكائنات" إلى "الصفوف" للبيانات المهيكلة.

تغييرات كبيرة في الأدوات الموجودة

tg-invoke-graph-rag

  • دعم القابلية للتفسير: يدعم الآن مسار قابلية تفسير مكون من 4 مراحل (السؤال، والبحث/التنقيب، والتركيز، والتوليف) مع عرض متكامل للأحداث المتعلقة بالأصل.
  • الاستمرارية: يستخدم بث WebSocket لإخراج في الوقت الفعلي.
  • تتبع الأصل: يمكن تتبع الحواف المحددة مرة أخرى إلى المستندات المصدر من خلال إعادة التشكيل و سلاسل prov:wasDerivedFrom.
  • زادت من حوالي 30 سطرًا إلى 760 سطرًا لاستيعاب مسار القابلية للتفسير الكامل.

tg-invoke-document-rag

  • دعم القابلية للتفسير: أضاف وضع question_explainable() الذي يخرج استجابات RAG للمستند مع أحداث الأصل المتداخلة (مراحل السؤال، والبحث، والتنقيب، والتوليف).

tg-invoke-agent

  • دعم القابلية للتفسير: أضاف وضع question_explainable() الذي يعرض أحداث الأصل المتداخلة أثناء تنفيذ الوكيل (مراحل السؤال، والتحليل، والاستنتاج، و AgentThought، و AgentObservation، و AgentAnswer).
  • يظهر الوضع التفصيلي سلاسل فكر/ملاحظة مع بادئات رموز تعبيرية.

tg-show-graph

  • وضع الاستمرارية: يستخدم الآن triples_query_stream() مع أحجام دفع قابلة للتكوين للحصول على النتيجة الأولى في أدنى وقت وتقليل الحمل الزائد للذاكرة.
  • دعم الرسم البياني المسمى: خيار جديد --graph. يكتشف الرسوم البيانية المسماة:
    • الرسم البياني الافتراضي (فارغ): حقائق المعرفة الأساسية.
    • urn:graph:source: الأصل لاستخراج
    • urn:graph:retrieval: استعلام في وقت التشغيل للقابلية للتفسير
  • عرض عمود الرسم البياني: علامة جديدة --show-graph لعرض الرسم البياني المسماة لكل ثلاثي.
  • حدود قابلة للتكوين: خيارات جديدة --limit و --batch-size.

tg-graph-to-turtle

  • دعم RDF-star: يتعامل الآن مع الثلاثيات المقتبسة (إعادة تشكيل RDF-star).
  • وضع الاستمرارية: يستخدم الاستمرارية للتحقيق في وقت المعالجة في أدنى وقت.
  • معالجة تنسيق الكابل: تم تحديثه لاستخدام تنسيق الكابل الجديد ({"t": "i", "i": uri} لـ IRIs، و {"t": "l", "v": value} للمفردات، و {"t": "r", "r": {...}} للاثلاثيات المقتبسة).
  • دعم الرسم البياني المسمى: خيار جديد --graph.

tg-set-tool

  • نوع أداة جديد: row-embeddings-query للبحث الدلالي عن فهارس البيانات المهيكلة.
  • خيارات جديدة: --schema-name و --index-name و --limit لتكوين أدوات استعلام تضمينات الصفوف.

tg-show-tools

  • يعرض نوع الأداة الجديد row-embeddings-query مع حقول schema-name و index-name و limit.

tg-load-knowledge

  • إعداد التقارير عن التقدم: الآن يحسب ويسجل عدد ثلاثيات وسياقات الكيانات التي تم تحميلها لكل ملف بشكل إجمالي.
  • تحديث تنسيق المصطلح: تتضمن سياقات الكيانات الآن تنسيق المصطلح الجديد ({"t": "i", "i": uri}) بدلاً من تنسيق القيمة القديم ({"v": entity, "e": True}).

تغييرات مدمرة

  • تغيير التسمية: تم تغيير اسم مخطط Value إلى Term في جميع أنحاء النظام (PR #622). وهذا يؤثر على الأدوات التي تتفاعل مع مخزن الرسم البياني والتي تستخدم تنسيق الكابل الجديد. يستخدم التنسيق الجديد {"t": "i", "i": uri} لـ IRIs و {"t": "l", "v": value} للمفردات، بدلاً من التنسيق القديم {"v": ..., "e": ...}.
  • tg-invoke-objects-query تم تغيير الاسم إلى tg-invoke-rows-query.
  • تم حذف tg-load-pdf و tg-load-text.