1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
8.7 KiB
שילובים מקוריים
CodeNomad מציג את חיבורי MCP, הפעלת התוספים, המיומנויות והפקודות המותאמות המקוריים של OpenCode. אלה רצים במארח ההרצה. הם נפרדים מ־הרחבות לוח מוגבלות בארגז חול ומ־SideCars.
בחירת הפקד המתאים
| שילוב | היכן לפעול | מה הפקד משנה |
|---|---|---|
| שרת MCP | סטטוס → שרתי MCP | חיבור מקורי ב־Location המוצג; אינו מתקין שרת. |
| תוסף מקורי | סטטוס → תוספים | כלל הפעלה קבוע כללי או של פרויקט; עבור תוסף מחבילה, בדיקה או עדכון מפורשים של אותה חבילה. אינו מתקין או מסיר חבילות. |
| מיומנות | תפריט @ בשדה הקלט |
צירוף מפורש לקלט הבא ב־Location של השיחה. |
| פקודה מותאמת | תפריט / בשדה הקלט |
מריצה פקודה ש־OpenCode חושף עבור אותו Location. |
הגדירו/התקינו תחילה את השילוב באמצעות התצורה וה־CLI הנתמכים של OpenCode. התקנת חבילה, הכרזה על המקור שלה, הפעלת הכלל שלה, חיבור שירות והפיכת הכלים שלו לזמינים הם שלבים נפרדים. לשילובים מקוריים יש הרשאות תהליך המארח שלהם, בכפוף לאישורי OpenCode; הם אינם לוחות HTML בארגז חול.
חיבור או ניתוק MCP
- הגדירו את שרת MCP במארח ההרצה של OpenCode באמצעות תיעוד MCP של OpenCode.
- פתחו סטטוס → שרתי MCP עבור הפרויקט.
- השתמשו במתג לצד השרת לחיבור או לניתוק. המתינו להתייצבות מחוון החיבור.
המתג קורא ל־API החיבור המקורי עבור ה־Location המדווח, לא למתקין מקומי למכשיר או להעדפת נראות לכל חלון. לקוחות אחרים המשתמשים באותו Location יכולים לראות את שינוי החיבור. ניתוק אינו מסיר את הכרזת השרת או את קובץ ההרצה שלו.
אם לא מופיע שרת, אמתו את ה־Location הפעיל והתצורה המקורית שלו. אם החיבור נכשל, בדקו את תצורת השרת, הסביבה הדרושה וזרימת האימות המקורית; אל תניחו שהמתג משלים OAuth. בדקו מצב שוב לאחר חיבור מחדש. השתמשו בטעינת תצורה מפורשת מחדש רק כשצריך, עם ההפרעות המתוארות ב־הגדרת OpenCode.
הפעלת תוספים בהיקף כללי או פרויקט
- התקינו/הכריזו על התוסף המקורי ב־OpenCode; ואז פתחו סטטוס → תוספים.
- רחפו מעל שמו או מקדו אותו לבדיקת המקור, כשל זמן הריצה ופרטי יעד התצורה.
- שנו במכוון את כללי או פרויקט. המתינו לכתיבה והשתמשו ב־רענון פקדי התוספים אם המצב אינו ברור.
- לתוסף שהותקן מחבילה, השתמשו בסמל שלצד שמו. התפריט שלו מציין את הפעולה המדויקת: בדוק עדכונים עבור החבילה, או עדכן את החבילה לאחר שנמצאה גרסה חדשה יותר.
כללי מכוון לתצורה הגלובלית שהתגלתה בדמון המחובר. פרויקט מכוון לתצורה בתוך ה־Location הפעיל, לא לקובץ אב שממנו יורשים. כלל פרויקט מאוחר יותר יכול לגבור על כללי; המתג הכללי עדיין מציג את הכלל הגלובלי במקום להתחזות למצב הפרויקט הסופי. ללא כלל פרויקט, פרויקט יורש את המצב הכללי הפתור.
מתגים אלה מוסיפים כללי הפעלה מדויקים תוך שימור הכרזות מקור ותצורה לא קשורה. הם אינם עורכים אפשרויות תוסף, מתקינים חבילות או מסירים קבצים. תוספים מובנים של OpenCode אינם מוצעים כמתגי הפעלה למשתמש. פרויקט מושבת כשאי אפשר להפריד בבטחה את היעד שלו מכללי או כשהוא יחרוג מה־Location הפעיל.
עדכון חבילה משנה את אותה חבילה במטמון המשותף של OpenCode עבור כל Location שמשתמש בה, כפי שמציין תיאור הכלי שלה; הוא אינו משנה כללי הפעלה, מפעיל מחדש את OpenCode או טוען מחדש את התצורה. לתוספים מקומיים, מובנים או כאלה שמסופקים על ידי ה־SDK אין פעולת חבילה. חבילה שנכשלת לפני שהיא מדווחת על מזהה התוסף שלה מופיעה לפי שם החבילה, עם הכשל בתיאור הכלי שלה ועם פעולות בדיקה/עדכון אך ללא מתגי הפעלה. בדיקה או עדכון שנכשלו מדווחים ולעולם אינם מנוסים שוב אוטומטית.
הממשק שומר את תמונת המצב האחרונה שלו כשהוא מוסתר ומאמת מחדש כשהוא מוצג, בשינויים מקוריים/חיבור מחדש וברענון מפורש. כלל שמור וזמינות חיה בזמן ריצה עשויים להיות שונים לזמן קצר. אם תוסף נשאר לא זמין, בדקו את העצה שלו ואת התצורה המקורית לפני בחירת טעינה מחדש של תצורת OpenCode; הפעולה משפיעה על כל ה־Locations הטעונים, לא רק על התוסף הזה. תצורה פגומה או עריכה מקבילה אינן נדרסות בשקט: פתרו זאת, רעננו ונסו שוב במפורש.
צירוף מיומנויות
- הקלידו
@בשדה הקלט, חפשו במיומנויות הזמינות של ה־Location ובחרו אחת. - בדקו את הצירוף הניתן להסרה לצד קבצים/סוכנים; הסירו אותו לפני שליחה אם אינו רצוי.
- שלחו את הקלט. תוויות המיומנויות נשארות עם ההודעה שנשלחה.
בחירה מצרפת את מזהה המיומנות המקורי ומסירה את האסימון @query; היא אינה מדביקה את ההוראות בטיוטה הגלויה. שליחה מנקה את הבחירה בשדה הקלט, לא הוראות שכבר נשמרו ב־OpenCode עם ההודעה. הסרת צירוף אינה יכולה לבטל שליחה קודמת.
זמינות מיומנויות מגיעה מה־Location של השיחה, לא מקטלוג מיומנויות גלובלי של CodeNomad. אם הרשימה אינה נטענת, סגרו ופתחו מחדש את הבורר לניסיון חוזר; אם היא ריקה, בדקו גילוי/תצורה מקוריים. ראו תיעוד מיומנויות OpenCode ו־שיחות.
הרצת פקודות מותאמות
- הקלידו
/בשדה הקלט ובחרו פקודה מקורית זמינה. - ספקו את הארגומנטים שלה ובדקו סוכן, מודל ו־חשיבה לפני שליחה, לפי המתאים לפקודה.
- בדקו את השיחה שנוצרה במקום לשלוח שוב ושוב אם אישור הקבלה אינו ברור.
פקודות מתגלות מ־OpenCode עבור ה־Location הפעיל. ההגדרה המקורית שלהן יכולה לבחור התנהגות הרצה; התפריט אינו מתקין חבילות או עורך תצורה ללא הגבלה. CodeNomad מחיל את סביבת הסשן של הפרופיל לפני שליחת פקודה מותאמת מקורית; כשל בעדכון הסביבה חוסם את השליחה. /btw הוא זרימת שאלה ארעית נפרדת של CodeNomad, לא פקודה מותאמת רגילה.
להגדרות פקודות ולירושת תצורה מקורית, השתמשו ב־תיעוד פקודות OpenCode. לאחר שינויי תצורה, רעננו/פתחו מחדש תחילה את הממשק הרלוונטי; השתמשו בטעינת תצורה מפורשת מחדש רק אם סביבת הריצה עדיין דורשת אותה. לעולם אל תחזרו על פקודה שאולי התקבלה להרצה רק כדי לרענן את תצוגתה.