mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-25 08:26:21 +02:00
8954fa3ad7
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.
99 lines
5.3 KiB
Markdown
99 lines
5.3 KiB
Markdown
---
|
|
layout: default
|
|
title: "הצעה לשחזור תיקיית הסכימה"
|
|
parent: "Hebrew (Beta)"
|
|
---
|
|
|
|
# הצעה לשחזור תיקיית הסכימה
|
|
|
|
> **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.
|
|
|
|
## בעיות נוכחיות
|
|
|
|
1. **מבנה שטוח** - כל הסכימות במקום אחד מקשות על הבנת הקשרים
|
|
2. **שילוב דאגות** - סוגי ליבה, אובייקטים של תחום, וחוזים של API משולבים יחד
|
|
3. **שמות לא ברורים** - קבצים כמו "object.py", "types.py", "topic.py" לא מציינים בבירור את מטרתם
|
|
4. **ללא שכבות ברורות** - קשה לראות מה תלוי במה
|
|
|
|
## מבנה מוצע
|
|
|
|
```
|
|
trustgraph-base/trustgraph/schema/
|
|
├── __init__.py
|
|
├── core/ # סוגי ליבה בסיסיים המשמשים בכל מקום
|
|
│ ├── __init__.py
|
|
│ ├── primitives.py # שגיאה, ערך, טריפל, שדה, סכימת שורה
|
|
│ ├── metadata.py # רשומת מטא-דאטה
|
|
│ └── topic.py # כלי לטיפול בנושאים
|
|
│
|
|
├── knowledge/ # מודלים של תחום ידע ואיסוף
|
|
│ ├── __init__.py
|
|
│ ├── graph.py # EntityContext, EntityEmbeddings, Triples
|
|
│ ├── document.py # מסמך, TextDocument, חתיכה
|
|
│ ├── knowledge.py # סוגי איסוף ידע
|
|
│ ├── embeddings.py # כל סוגי הסתמכות הקשורים (הועברו מקבצים רבים)
|
|
│ └── nlp.py # סוגי הגדרה, נושא, קשר, עובדה
|
|
│
|
|
└── services/ # חוזים של בקשות/תגובות שירות
|
|
├── __init__.py
|
|
├── llm.py # TextCompletion, Embeddings, בקשות/תגובות של כלי
|
|
├── retrieval.py # שאילתות/תגובות של GraphRAG, DocumentRAG
|
|
├── query.py # בקשות/תגובות של GraphEmbeddings, DocumentEmbeddings
|
|
├── agent.py # בקשות/תגובות של סוכן
|
|
├── flow.py # בקשות/תגובות של זרימה
|
|
├── prompt.py # בקשות/תגובות של שירות בקשות
|
|
├── config.py # שירות תצורה
|
|
├── library.py # שירות ספרייה
|
|
└── lookup.py # שירות חיפוש
|
|
```
|
|
|
|
## שינויים מרכזיים
|
|
|
|
1. **ארגון היררכי** - הפרדה ברורה בין סוגים ליבה, מודלים של ידע, וחוזים של שירות
|
|
2. **שמות טובים יותר**:
|
|
- `types.py` → `core/primitives.py` (מטרה ברורה יותר)
|
|
- `object.py` → פירוק בין קבצים מתאימים בהתאם לתוכן
|
|
- `documents.py` → `knowledge/document.py` (יחיד, עקבי)
|
|
- `models.py` → `services/llm.py` (סוגי מודלים ברורים יותר)
|
|
- `prompt.py` → פירוק: חלקי שירות ל- `services/prompt.py`, סוגי נתונים ל- `knowledge/nlp.py`
|
|
|
|
3. **קבוצות לוגיות**:
|
|
- כל סוגי ההסתמכות הועברו ל- `knowledge/embeddings.py`
|
|
- כל חוזי השירות הקשורים ל-LLM ב- `services/llm.py`
|
|
- הפרדה ברורה של זוגות בקשות/תגובות בספריית השירותים
|
|
- סוגי איסוף ידע מקובצים עם מודלים אחרים של תחום ידע
|
|
|
|
4. **בהירות תלות**:
|
|
- סוגים ליבה אין תלות
|
|
- מודלים של ידע תלויים רק בסוגים ליבה
|
|
- חוזי שירות יכולים להיות תלויים בשני סוגים ליבה ומודלים של ידע
|
|
|
|
## יתרונות המעבר
|
|
|
|
1. **ניווט קל יותר** - מפתחים יכולים למצוא במהירות את מה שהם צריכים
|
|
2. **מודולריות טובה יותר** - גבולות ברורים בין דאגות שונות
|
|
3. **ייבוא פשוט יותר** - מסלולי ייבוא אינטואיטיביים יותר
|
|
4. **עתידי** - קל להוסיף סוגי ידע חדשים או שירותים ללא בלבול
|
|
|
|
## שינויים דוגמה לייבוא
|
|
|
|
```python
|
|
# לפני
|
|
from trustgraph.schema import Error, Triple, GraphEmbeddings, TextCompletionRequest
|
|
|
|
# אחרי
|
|
from trustgraph.schema.core import Error, Triple
|
|
from trustgraph.schema.knowledge import GraphEmbeddings
|
|
from trustgraph.schema.services import TextCompletionRequest
|
|
```
|
|
|
|
## הערות ליישום
|
|
|
|
1. שמירה על תאימות אחורה על ידי שמירה על ייבוא ב- `__init__.py`
|
|
2. העברת קבצים בהדרגה, תוך עדכון ייבוא לפי הצורך
|
|
3. שקול להוסיף קובץ `legacy.py` שיבוא הכל עבור תקופת המעבר
|
|
4. עדכון תיעוד כדי לשקף את המבנה החדש
|
|
|
|
<function_calls>
|
|
<invoke name="TodoWrite">
|
|
<parameter name="todos">[{"id": "1", "content": "להעריך את מבנה תיקיית הסכימה הנוכחי", "status": "completed", "priority": "high"}, {"id": "2", "content": "לנתח את הקבצים של הסכימה ולמטרות שלהם", "status": "completed", "priority": "high"}, {"id": "3", "content": "להציע מבנה ושמות טובים יותר", "status": "completed", "priority": "high"}]
|