CodeNomad/docs/help/he/desktop.md
Pascal André 5994944f84
feat(settings): manage desktop data profiles and drop the startup question (#1123)
Choosing a desktop data profile needed `CODENOMAD_PROFILE` or, on a first
packaged launch with several restorable profiles, a native question that
blocked startup. Settings only named a non-default profile and offered to
delete all the other profiles at once.

Settings > General > Restore previous state now ends with one folded line,
"Data profile: <name>". Unfolded, it lists every profile on the computer,
the open one first and the others by last use, each with its size, creation
date and last use. A radio chooses the profile the next launch opens (any
profile of this configuration; choosing the open one again cancels), "New
profile" creates one by name, "Restart in <name>" restarts into the choice,
and each other profile has its own delete button with a confirmation. A
launch pinned by `CODENOMAD_PROFILE`, its alias or a development run shows
the profiles without letting the user choose; deletion still works.

Without a remembered choice, a packaged launch no longer asks: it opens the
most recently used of the default, `dev` and `dev-v2` profiles (ties go in
that order) and remembers it, as it already did with zero or one candidate.
A launch that finds the selection lock held opens the detected profile
without remembering it instead of waiting.

Implementation: the existing host listing gains the open profile, creation
(folder birth time, links not followed) and last-use (newest client-state
write) dates, the remembered next-launch profile and whether the launch is
pinned. Two host operations are added on both hosts, granted to local and
Preferences windows only and serialized with list and delete: choosing the
next launch's profile (validated with the `CODENOMAD_PROFILE` grammar,
written under the selection lock, overwriting this configuration's entry,
creating a new profile's scope folder inside the lock and removing it again
if the write fails) and restarting through the graceful developer-mode
relaunch. Electron's throwaway question storage, relaunch and private
hand-offs are removed; it still sweeps leftover question folders and drops
the two hand-off variables an older build's relaunch can carry. Tauri keeps
only the invalid-profile error dialog. `CODENOMAD_DESKTOP_PROFILE` and the
server's `desktopProfile` meta field are removed, since nothing displays them.

Only a profile whose name leads back to its own folder can be chosen, so a
folder the deprecated alias made under another profile's name (such as
default-<hash>) is listed under its stored name but not offered. The
listing reports the next launch's profile only when the launch would open
it (the launch's own remembered-profile check), and Restart in <name> lists
again first and restarts only while that still names the shown profile.
Choosing with the keyboard keeps focus on the chosen radio.

Validation: UI browser tests for the manager (listing, choose and restart,
new profile and name validation, single deletion, macOS note, pinned
launches, plain browser), Electron native tests (listing dates, current,
next launch, pinned, set-next-launch outcomes, relaunch wiring, preload,
automatic choice, lock and sweep) and Tauri tests (the same cases, grants
and command wiring). Developer doc and help (10 languages) updated.
2026-10-24 09:46:30 +02:00

11 KiB
Raw Permalink Blame History

חלונות ונתונים בשולחן העבודה

חלונות, לשוניות והשירות המשותף

  1. השתמשו ב־מופע חדש לפתיחת לשונית פרויקט/בית נוספת בחלון הנוכחי.
  2. השתמשו בתפריט המקורי חלון → חלון חדש (Ctrl+Shift+N או Cmd+Shift+N) לחלון יישום נפרד.
  3. ב־הגדרות → מתקדם, הפעילו מיקוד חלון קיים בהפעלה שנייה אם הפעלה נוספת אמורה למקד את החלון האחרון שהיה בשימוש במקום לפתוח חדש.

לשוניות פרויקטים, שיחות נבחרות ופריסה שייכות לחלון. סשנים/הודעות של OpenCode שייכים לשירות OpenCode המקורי המשותף: חלון אחר יכול לראות אותה שיחה. סגירת לשונית פרויקט סוגרת את הפרויקט ב־CodeNomad, לא את סשני OpenCode שלו; פתחו אותו מחדש כדי למצוא אותם שוב. חלון אחר המציג את אותו חיבור פרויקט סוגר גם הוא את הלשונית שלו ומציג התראה; לשוניות של אותה תיקייה שנפתחו בנפרד אינן מושפעות. סגירת חלון שלם, יציאה או טעינה מחדש משמרות את חיבורי הפרויקטים לשחזור; ראו פרויקטים. אל תסתמכו על סגירת חלונות כהוכחה שסוכן או משימה מתוזמנת נעצרו.

תפריטי היישום המקוריים משתמשים בשפת הממשק של CodeNomad לאחר שחלון נטען; עד אז הם מוצגים באנגלית. עזרה → אודות CodeNomad (גם בתפריט היישום ב־macOS) פותח את הגדרות → מידע עם הגרסה, העדכונים והאבחון.

העדפות ושחזור בהפעלה

  1. פתחו הגדרות מהחלון שברצונכם להגדיר. נקודות כניסה מקומיות בשולחן העבודה ממקדות את חלון ההעדפות המקורי היחיד עם הפרויקט/ה־Location של החלון שפתח אותו.
  2. ב־כללי, הפעילו או כבו את שחזור המצב הקודם.
  3. כדי לשכוח את הפריסה השמורה של אותו חלון, השתמשו ב־ניקוי מצב ההפעלה השמור. הפעולה חלה מיד, ללא אישור.

שחזור יכול לפתוח מחדש לשוניות סביבת עבודה/SideCar וסשנים פעילים, טקסט שלא נשלח, מיקומי גלילה, לוחות, מיקום חלון וזום. זהו מצב לקוח לכל חלון, לא עותק של מסד נתוני השיחות המקורי. ניקויו מסיר לשוניות, טיוטות ופריסה שמורות; הוא אינו מוחק תצורת CodeNomad או שיחות OpenCode. שמרו תחילה כל טיוטה חשובה שלא נשלחה במקום אחר.

לחלון ההעדפות אין מצב שחזור נפרד משלו: פקדים אלה מכוונים לחלון שפתח אותו. אם אותו חלון נסגר, או אינו ידוע כי ההעדפות נפתחו מחדש בהפעלה, הם עוברים לחלון שהיה בשימוש לאחרונה; שינוי שהוכן עבור חלון אחר לעולם אינו מוחל, והפקדים מציגים תחילה את הערך של החלון החדש. כדי להגדיר חלון מסוים, פתחו את ההעדפות ממנו. גם הגדרות ברמת פרויקט משתמשות ב־Location של החלון הפותח; הן אינן זמינות בלעדיו. כשההעדפות נפתחות מחדש בהפעלה, הן מתחברות מחדש לאחר שפתיחת אותו פרויקט הסתיימה; כל עוד התיקייה עדיין מופעלת, או פתוחה בכמה לשוניות, הן נשארות לא זמינות עד שתפתחו את ההעדפות מהחלון הרצוי.

הגדרות דפדפן ולקוחות מרוחקים מוטמעות במקום ליצור בעלות נוספת על העדפות מקוריות. שגיאה בפתיחת ההעדפות המקוריות מדווחת; היא אינה סיבה להניח שנפתח במקום זאת מסך הגדרות מוטמע ונסתר.

פרופילי נתונים לשולחן העבודה

  1. ב־הגדרות → כללי המקוריות, תחת שחזור המצב הקודם, הרחיבו את פרופיל נתונים. מוצגים בו כל הפרופילים במחשב זה עם הגודל, תאריך היצירה והשימוש האחרון של כל אחד, כשהפרופיל הפתוח ראשון.
  2. בחרו את הפרופיל שההפעלה הבאה תפתח, או בחרו פרופיל חדש והזינו שם בן 1–64 אותיות לטיניות קטנות, ספרות, נקודות, מקפים או קווים תחתונים, המתחיל באות או בספרה.
  3. בחרו הפעלה מחדש ב-… כדי לעבור מיד; אחרת הפרופיל שנבחר נפתח בהפעלה הבאה. בחירה חוזרת בפרופיל הפתוח מבטלת את השינוי.

פרופילים מתצורה אחרת מוצגים ברשימה, אך אי אפשר לבחור בהם כאן. ללא בחירה זכורה, הפעלה של יישום ארוז בודקת בפרופיל ברירת המחדל, ב־dev וב־dev-v2 אם יש עבודה לשחזור, ופותחת את זה שהיה בשימוש לאחרונה, או את ברירת המחדל כשאין עבודה כזו באף אחד מהם. בחירת פרופיל אינה מעבירה, ממזגת או מוחקת נתוני פרופיל.

CODENOMAD_PROFILE שהוגדר לפני הפעלת קובץ ההרצה גובר על הבחירה; פרופיל נתונים מציג אז את הפרופילים בלי לאפשר לבחור באחד מהם. default או stable בוחרים בפרופיל ברירת המחדל, ושם לא תקין מונע הפעלה במקום לבחור בפרופיל אחר. לדוגמה, ב־PowerShell, לפני הפעלת קובץ ההרצה הרצוי לשולחן העבודה:

$env:CODENOMAD_PROFILE = "review"

לתצורת שרת עצמאית, הגדירו לפני ההפעלה גם CLI_CONFIG לקובץ תצורה נפרד. ברירת המחדל היא ~/.config/codenomad/config.yaml. שם פרופיל לבדו אינו משנה את הקובץ או את שירות OpenCode המשותף.

מבודד באמצעות פרופיל נתונים לשולחן העבודה אינו מבודד אוטומטית
מצב שחזור חלונות/לשוניות, טיוטות שלא נשלחו והיקף המופע היחיד/שרת הקצה בשולחן העבודה סשנים, הודעות, פרטי התחברות לספקים והרצה של OpenCode
אחסון Chromium/WebView מקורי המשויך לפרופיל, בכפוף למגבלות הפלטפורמה תצורת/העדפות CodeNomad, מפתחות קול, SideCars והפעלת הרחבות כאשר התצורה משותפת
אחסון תצוגה מקדימה מקורית במארח/בפרופיל שלה קבצים בפרויקטים פתוחים; נתוני שרתים מרוחקים

ב־Tauri ב־macOS, פרופילים תחומים חולקים אחסון WebKit של המערכת, התחברויות ומטמון; אל תשתמשו בשמות פרופילים כבידוד אבטחתי של חשבונות. Electron שומר נתוני דפדפן בפרופיל שלו. הגרסה המותקנת ו־ערוץ עדכונים לעולם אינם בוחרים בפרופיל נתונים אחר. הפעלות פיתוח לא ארוזות משתמשות בפרופיל dev אלא אם נבחר פרופיל מפורשות.

מחיקת פרופיל שמור

  1. הרחיבו את פרופיל נתונים כמתואר למעלה, ורעננו את הרשימה לפי הצורך.
  2. בחרו בכפתור המחיקה של הפרופיל שברצונכם להסיר. לפרופיל הפתוח אין כפתור כזה.
  3. אשרו רק לאחר ששמרתם כל טיוטה/התחברות נחוצה. בדקו כל דוח הסרה חלקית לפני ניסיון חוזר.

המחיקה מסירה לשוניות, טיוטות, פריסה ואחסון דפדפן/מטמון/התחברויות השייכים לאותו פרופיל, גם כשזהו פרופיל ברשימה מתצורה אחרת. היא משמרת את הפרופיל הפתוח, שיחות OpenCode וקובצי פרויקט. אי אפשר למחוק פרופיל פתוח או פרופיל שמצבו לא ידוע; סגרו את חלונות CodeNomad הרלוונטיים, רעננו את הרשימה ונסו שוב. תוכן לא מוכר נשמר ומדווח במקום להימחק באופן גורף.

אחסון WebKit המשותף של Tauri ב־macOS נשמר, כי מחיקתו תשפיע על פרופילים אחרים. זה אינו ניקוי שניתן לבטל: שיחה מקורית שנותרה אינה משחזרת טיוטה שלא נשלחה ונמחקה. ניקוי מצב ההפעלה השמור היא הפעולה המצומצמת יותר אם רצונכם רק לאפס את החלון הנוכחי.

זום וגאומטריית לוחות

  1. השתמשו בתפריט המקורי תצוגה → הגדלה, ב־הקטנה או ב־גודל אמיתי; קלט מקלדת/גלגלת פועל גם בהתאם לתמיכת המארח.
  2. השתמשו ב־חלונית שמאלית וב־חלונית ימנית בפינות החיצוניות הקבועות של הכותרת להצגה/הסתרה של לוחות. הצמידו/בטלו הצמדה של מגירות כאשר הפריסה מאפשרת זאת.
  3. אם פקדים כבר אינם נכנסים, הקטינו זום או הרחיבו את החלון; פריסות צרות מעבירות פקדים לתפריטים ולוחות לשכבות צפות.

חלונות שולחן עבודה ראשיים, מקומיים ומרוחקים, שומרים לפחות 390 × 600 פיקסלי CSS, בהתאם לזום היישום ובגבולות שטח העבודה של הצג. הגדלת זום יכולה להגדיל חלון קטן מדי; הקטנת זום אינה מקטינה חלון שכבר גדול יותר. לחלון ההעדפות ולחלונות־בת של תצוגת דפדפן יש כללי גודל נפרדים.

לוחות משאירים רוחב מינימלי לשיחה לפני שהם צפים. מתחת לרוחב שיחה של 420 פיקסלי CSS, ציר הזמן מוסתר ופעולות הכותרת עוברות לתפריט הנוסף שלהן; העדפת ציר הזמן השמורה נשמרת. שינויי גאומטריה אלה אינם משנים את טיוטת הקלט או את הסשן המקורי. ראו הגדרות ופריסה ו־תצוגות דפדפן ו־SideCars.