> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl: שורת הפקודה הניהולית והאייג'נטית של Symphony

> qxctl הוא ה-CLI הניהולי של Symphony הכתוב ב-Go. למדו על 373 הפקודות הניתנות להרצה שלו, על רישום קישורי המנועים v2 ועל מודל ההפעלה הבטוח עבור מנועים.

`qxctl` הוא ה-CLI הניהולי ולשאילתות של Symphony, מבוסס Go ומתוכנן בראש ובראשונה לסוכנים (agentic-first). הוא מדבר בפקודות; וקטורי התחום הם הבעלים של הפעולות והמשמעויות שמאחוריהן. הרישום שלו, השמור במאגר, מקשר כל עלה פקודה ניתן להרצה לזהות מכונה יציבה ולראיות סקורות של ניהול תכונות.

## מה qxctl מכסה

qxctl מממש ניהול עבור:

* בדיקת מאגר וחוזים
* ניהול validator, אזהרות, אינווריאנטים, תכונות, מחזור חיים, סשנים, התאמה, קישורים ו-Maestro
* ניהול זהות SSIAG, ביקורת STAV ומפיקי Accordare
* דקדוק מנועי וקטורים ממומשים (`skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, וכן משטחי SCV ו-SHV)

הרישום הנוכחי מכיל **373** פקודות ניתנות להרצה.

## מודל הפעלה בטוח

qxctl מפעיל התקנות מדויקות המאומתות בקבלות (receipts) באמצעות תתי-תהליכים מוגבלים, מועדים קשיחים, בדיקות זהות ו-digest של התגובה, טרנזקציות של מצב צפוי ושחזור עמיד. הוא לעולם אינו מקבל נתיבי adapter או גרסאות גולמיות במקום קבלות.

## רישום קישורי המנועים v2

רישום קישורי המנועים v2 תומך בשמונה תפקידי המנוע המבוססים ובזהויות תפקיד עתידיות מוגבלות. מצב v1 מדור קודם נקרא בקריאה כפולה; העברה ל-v2 דורשת compare-and-swap מפורש הקשור ל-digest דרך qxctl, ולעולם אינה פעולת בחירת גרסה.

## פקודות הרישום

הפיקו ואמתו את הרישום הצפוי מתוך `tools/qxctl`:

```bash Registry generation and verification theme={null}
go run ./cmd/qxctl commands expected --json > COMMANDS.json
go run ./cmd/qxctl commands verify --input COMMANDS.json --json
```

לקוח מותקן יכול לפלוט ראיות הקשורות לקובץ ההרצה:

```bash Manifest from installed qxctl theme={null}
qxctl commands manifest --json
```

לראיות הצפויות יש גרסת לקוח, digest של קובץ ההרצה ו-digest של הקבלה בערך null. ראיות נצפות קשורות לגרסת הלקוח המדויקת ול-digest של קובץ ההרצה, וכן ל-digest של הקבלה כאשר הוא זמין. שתי הצורות משתמשות ב-`symphony.qxctl.command-registry.v1`.

> [!NOTE]
>
> qxctl הוא הבעלים של דקדוק הפקודות ושל ההצגה. הוא אינו הבעלים של הסמנטיקה של הווקטורים או של אמת הידע הקנונית. רק שינויי מקור סקורים מאשררים זהות `qxcmd` חדשה, ללא קשר למחלקת הקורא.

## קבוצות פקודות

> [card] [knowledge](https://docs.quanux.org/symphony/he/qxctl/knowledge.md)
>
> ניהול מחזור חיים חוצה-וקטורים וסשנים מתמשכים של SSFV.

> [card] [lifecycle](https://docs.quanux.org/symphony/he/qxctl/lifecycle.md)
>
> פרופיל, בעלות, observe, report, boot, apply ושחזור.

> [card] [engines](https://docs.quanux.org/symphony/he/qxctl/engines.md)
>
> רישום קישורי המנועים והעברה.

> [card] [reconcile](https://docs.quanux.org/symphony/he/qxctl/reconcile.md)
>
> התאמת worktree של המתאם.

> [card] [session](https://docs.quanux.org/symphony/he/qxctl/session.md)
>
> סשנים מאומתים וזרמי תחזוקה של SSFV.

> [card] [maestro](https://docs.quanux.org/symphony/he/qxctl/maestro.md)
>
> מלאי רצפטורים נגזר וראיות עגינה.

> [card] [validate](https://docs.quanux.org/symphony/he/qxctl/validate.md)
>
> מדיניות אזהרות מוגנת וניהול ה-validator.

> [card] [פקודות וקטורים](https://docs.quanux.org/symphony/he/qxctl/vector-commands.md)
>
> `skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, `shv`, ודקדוק accord/evolution עתידי.


## Related topics

- [qxctl knowledge session: סשנים מאומתים של Symphony](https://docs.quanux.org/symphony/he/qxctl/session.md)
- [הארכיטקטורה של Symphony](https://docs.quanux.org/symphony/he/concepts/architecture.md)
- [qxctl validate: מדיניות האזהרות של Symphony Validator](https://docs.quanux.org/symphony/he/qxctl/validate.md)
- [qxctl maestro: קריאת מלאי נוכחות הרצפטורים של Symphony](https://docs.quanux.org/symphony/he/qxctl/maestro.md)
- [התיעוד של QuanuX Symphony](https://docs.quanux.org/symphony/he/index.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.