📘 תיעוד 30

ערכות נושא והתאמה אישית של המראה

Grok Build שואב את כל צבעי ה-TUI מערכת נושא מרכזית. באפשרותך להחליף ערכות נושא בזמן ש-Grok פועל, לעקוב אחר מראה בהיר או כהה של מערכת ההפעלה שלך, ולהתאים את פריסת היסטוריית הגלילה (scrollback), אנימציות וסגנון בלוקים באמצעות קובצי הגדרות.

#ערכות נושא זמינות

Grok כולל שש ערכות נושא מובנות, בנוסף לאפשרות auto שעוקבת אחר מראה המערכת:

שמות ערכות הנושא אינם רגישים לאותיות גדולות וקטנות. האפשרות auto (כינוי: system) מתועדת תחת ערכת נושא אוטומטית (מראה המערכת).

#ערכת הנושא Terminal

הערכה terminal אינה צובעת רקעי משטחים ואינה מגדירה כמעט צבעים משל עצמה, הכל מגיע מפרופיל המסוף שלך. היסטוריית הגלילה (scrollback), עורך ההודעה (composer), חלונות מודאליים ושורת המצב משאירים את משטח המסוף גלוי (חלון שקוף למחצה או בעל תמונת רקע נראה דרך Grok כפי שהוא נראה דרך המעטפת שלך), גוף הטקסט משתמש בצבע הקדמי של ברירת המחדל של המסוף, והדגשות (שגיאות, diffs, קישורים, תחביר) מגיעות מפלטת 16 צבעי ה-ANSI של הפרופיל שלך. מכיוון שהיא שואלת את צבעי הפרופיל במקום להניח מראש רקע בהיר או כהה, היא נשארת קריאה בכל פרופיל ללא צורך בזיהוי מראה, והיא מוצגת באופן זהה בכל עומק צבע.

ערכת הנושא אינה צובעת רקעים כלל: ההודעות שלך מוצגות בכתב מודגש במקום על גבי פס צבע, תפריטים ולוחות הנחיות יושבים ישירות על משטח המסוף, והשורה שנבחרה או שהסמן מרחף מעליה בכל תפריט משתמשת בווידאו הפוך (היפוך בין צבע הרקע לצבע הקדמי של המסוף שלך), כך שכל שילוב נשאר קריא בכל פרופיל. עיטורים, מסגרות במצב לא פעיל, מפרידים, לשונית פס הגלילה, משתמשים ב-ANSI bright black כצבע קדמי, משבצת הפלטה שהפרופיל שלך מכוונן כגוון העמום שלו. רכיבי ממשק ממוקדים, כמו מסגרת עורך ההודעה הפעיל, נשארים בצבע הקדמי המלא של ברירת המחדל כדי שהמיקוד עדיין יבלוט. Grok גם אינו משנה את צבע הסמן שלך בערכת נושא זו (ערכות נושא אחרות צובעות אותו מחדש בצבע ההדגשה שלהן).

[ui]
theme = "terminal"

הניגודיות טובה רק כפי שפרופיל המסוף שלך מאפשר: פרופיל עם משבצת bright-black כהה מאוד יציג מפרידים חלשים, מכיוון ש-Grok גוזר הכל מהפלטה שלך במקום לקבוע צבעים קבועים מראש בקוד.

ערכת הנושא נפרסת בהדרגה. עד שהפריסה תגיע לחשבון שלך היא מוסתרת מ-/theme ומ-/settings, שמותיה אינם מזוהים, והגדרה של theme = "terminal" נסוגה לערכת ברירת המחדל. הגדר GROK_TERMINAL_THEME=1 (או [features] terminal_theme = true ב-config.toml) כדי להפעיל אותה מקומית לפני הפריסה.

#במצב מינימלי אין ערכות נושא

מצב מינימלי (--minimal) מוצג תמיד עם פלטה קבועה ויחידה המותאמת למסוף ומתעלם לחלוטין מהגדרות theme (הן עדיין חלות על ה-TUI המלא). מצב מינימלי מצייר ישירות על הרקע של המסוף שלך, ולכן הוא משתמש בצבעי ברירת המחדל הקדמיים והאחוריים של המסוף בתוספת פלטת 16 צבעי ה-ANSI שלו, אותם צבעים שבהם משתמשים git או ls, שנשארים קריאים בכל פרופיל מסוף בהיר או כהה ללא זיהוי או הגדרה. הפקודה /theme ושורות ערכת הנושא ב-/settings אינן זמינות במצב מינימלי.

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

#החלפת ערכות נושא

#בתוך ה-TUI

הפעל את פקודת הסלאש /theme (כינוי: /t) כדי לפתוח את בורר ערכות הנושא. בעת מעבר ברשימה באמצעות מקשי החצים, Grok מציג תצוגה מקדימה של כל ערכת נושא בזמן אמת. הקש על Enter כדי להחיל ולשמור את בחירתך, או הקש על Escape כדי לבטל. הקלדה מסננת את הרשימה לפי כל אחד משמות ההגדרה של ערכת הנושא, כך ש-/theme transparent מצמצם את הרשימה לשורת Terminal.

כדי להחליף ללא הבורר, העבר שם ישירות:

/theme tokyonight

הפעלת /theme בפני עצמה, בלי לבחור מתוך הבורר, מעבירה במחזוריות לערכת הנושא הבאה.

#באמצעות קובץ הגדרות

הגדר את ערכת הנושא ב-~/.grok/config.toml:

[ui]
theme = "tokyonight"

#ערכת נושא אוטומטית (מראה המערכת)

הגדר theme = "auto" כדי ש-Grok יעקוב אחר מראה בהיר או כהה של מערכת ההפעלה שלך ויחליף ערכות נושא באופן אוטומטי:

[ui]
theme = "auto"

כברירת מחדל, מצב כהה ממופה ל-GrokNight ומצב בהיר ממופה ל-GrokDay. ניתן לדרוס כל אחד מהמיפויים באמצעות auto_dark_theme ו-auto_light_theme:

[ui]
theme = "auto"
auto_dark_theme = "tokyonight"
auto_light_theme = "grokday"

theme = "system" הוא כינוי עבור theme = "auto".

#כיצד הזיהוי פועל

לאחר ההפעלה, Grok דוגם ממשקי API של שולחן העבודה ורמזים ממשתני סביבה כל 5 שניות. מעבר של מערכת ההפעלה בין מצב בהיר לכהה בשולחן עבודה מקומי נכנס לתוקף תוך שניות ללא צורך בהפעלה מחדש. דרך SSH, משתנה הסביבה שהוטבע על ידי wrap קבוע עבור אותו דילוג (hop).

באפשרותך גם להגדיר את GROK_THEME (או LC_GROK_THEME) כדי לכפות ערכת נושא מסוימת או auto מבלי לערוך את config.toml.

#דרך חלונית ההגדרות

הפעל את /settings (כינוי: /config) ופתח את הקטגוריה Appearance כדי להגדיר את Auto dark theme ואת Auto light theme באופן אינטראקטיבי. בחירה ב-auto בבורר /theme מפעילה מצב אוטומטי באמצעות מיפויים אלה.

#זיהוי תמיכה בצבעים

בעת ההפעלה, Grok מזהה את רמת יכולת הצבע של המסוף שלך:

כאשר מגדירים את NO_COLOR, Grok אינו מפיק צבע ומוצג בשחור לבן (מונוכרום).

הפעל את /doctor כדי לראות את רמת הצבע שזוהתה ואת ערכות הנושא הזמינות במסוף זה. אם truecolor אינו זמין, Doctor מציג את שלבי ההגדרה הרלוונטיים או מסביר את מגבלת המסוף.

#כימות אוטומטי

כל ערכת נושא מוגדרת באמצעות ערכי RGB מלאים. בעת ההפעלה, Grok מבצע כימות לכל הצבעים כדי להתאים לרמת היכולת שזוהתה. המשמעות היא:

• במסופי truecolor, צבעים מועברים ללא שינוי.
• במסופי 256-color, כל ערך RGB ממופה לערך הקרוב ביותר בפלטה הממופתרת.
• במסופי 16-color, צבעים ממופים לשמות ANSI.

GrokNight ו-GrokDay משתמשות בגווני אפור ניטרליים שעוברים כימות בצורה נקייה. TokyoNight, RosePineMoon ו-OscuraMidnight משתמשות ברקעים בעלי גוון ייחודי שמאבדים מאופיים בעת כימות, ולכן בורר ערכות הנושא מסתיר אותן במסופים שאינם תומכים ב-truecolor.

#צבעים הנוצרים בזמן ריצה

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

#צבע הסמן

Grok מגדיר את סמן המסוף שלך לצבע accent_user של ערכת הנושא הנוכחית באמצעות רצף escape מסוג OSC 12, כדי לציין הפעלת Grok פעילה. צבע הסמן:

• מוחל בעת ההפעלה ובעת החלפת ערכת נושא.
• מאופס לברירת המחדל של המסוף בעת יציאה באמצעות OSC 112.

פעולה זו פועלת במסופים התומכים ב-OSC 12 (רוב המסופים המודרניים).

#מצב קומפקטי

ניתן להפעיל או לכבות מצב קומפקטי באמצעות פקודת הסלאש /compact-mode. מצב קומפקטי:

• מסיר ריפוד אנכי חיצוני (שוליים עליונים ותחתונים הופכים ל-0).
• מפחית את הריפוד האופקי למינימום (עמודה אחת).
• מפחית את הריפוד העליון באזור ההנחיה ובבלוקי המידע.

ההגדרה נשמרת ב-~/.grok/config.toml תחת [ui].compact_mode ונשמרת גם לאחר הפעלות מחדש.

השתמש במצב קומפקטי במסכים קטנים כדי למקסם את שטח התוכן.

#הדגשת תחביר

Grok כולל שלושה קובצי .tmTheme עבור הדגשת תחביר של בלוקי קוד, ובוחר אחד מהם בהתאם לערכת הנושא הפעילה:

• grok-night.tmTheme: עבור GrokNight, RosePineMoon ו-OscuraMidnight
• grok-day.tmTheme: עבור GrokDay
• tokyo-night.tmTheme: עבור TokyoNight

Grok בוחר את הקובץ התואם באופן אוטומטי בעת החלפת ערכת נושא. קובצי ה-.tmTheme מובנים בתוך הקובץ הבינארי, ולכן לא ניתן להחליף אותם בקבצים משלך.

#התאמה אישית עמוקה באמצעות pager.toml

לבקרה מפורטת על מראה ה-TUI, צור את ~/.grok/pager.toml. קובץ זה שולט בפריסת היסטוריית הגלילה (scrollback), בסגנון בלוקים, באנימציות ועוד. לכל ההגדרות יש ערכי ברירת מחדל; ציין רק את הערכים שברצונך לדרוס. (גרסאות פיתוח מייצרות קובץ זה כתבנית שבה כל ערך ברירת מחדל מופיע כהערה. בטל הערה בשורה כדי לדרוס אותה; ערכים שמופיעים כהערה ממשיכים לעקוב אחר ערכי ברירת המחדל העתידיים.)

#פריסה (Layout)

שליטה בריפוד שטח התצוגה (viewport) ובמרווחי בלוקים:

[scrollback.layout]
outer_vpad = 1          
# Vertical padding (top/bottom) for the viewport
outer_hpad_left = 2     
# Left margin (minimum: 1)
outer_hpad_right = 2    
# Right margin (minimum: 1)
block_pad_left = 2      
# Padding between accent line and content
block_pad_right = 2     
# Padding after content at right edge

#פס גלילה (Scrollbar)

[scrollback.scrollbar]
enabled = true          
# Show/hide the scrollbar
gap_left = 0            
# Gap between content and scrollbar (0 = adjacent)
gap_right = 0           
# Gap between scrollbar and screen edge (0 = at edge)
# scrollbar_bg = "none" 
# Override background color (or "none" for theme default)
# scrollbar_fg = "none" 
# Override thumb color (or "none" for theme default)

#התנהגות גלילה (Scroll Behavior)

[scrollback.scroll]
margin = 0                  
# Context lines above/below selected entry (0 = edge)
min_page_fraction = 0       
# Minimum scroll as % of viewport (0-100)
follow_indicator = "center" 
# "center" = show the ▼/▲ scroll arrows, "none" = hidden
follow_auto_select = true   
# Auto-select latest entry when following
follow_by_overscroll = true 
# Scrolling past bottom engages follow mode
anchor_on_fold = true       
# Keep block header at same screen position when folding

#אפשרויות תצוגה (Display Options)

[scrollback.display]
sticky_headers = true              
# Pin user prompts as headers when scrolled past
tab_width = 4                      
# Spaces per tab character (0 = pass through)
expandable_indicator = true        
# Show "›" on foldable collapsed entries
expandable_indicator_char = "›"    
# Character to use (default: "›")
collapsed_accent_char = "❙"        
# Accent for collapsed groupable blocks (falls back to "|" on the legacy Windows console)
dim_accent = 0.5                   
# Blend factor for dimmed accents (0.0-1.0)
line_under_last_entry = false      
# Horizontal line below last entry
selection_buttons = false          
# Show copy/view buttons on selection box

#אנימציה (Animation)

[animation]
fps = 30           
# Frame rate (1-60). Higher = smoother, more CPU
wave_rows = 32     
# Rows per wave cycle for accent animation

#סגנון בלוקים: הבדלי עריכה (Edit Diffs)

[scrollback.blocks.edit]
indent = true                   
# Indent diff content
vpad = false                    
# Vertical padding around diffs
# expanded_by_default = true    
# Unset: follows [ui] collapsed_edit_blocks in config.toml
                                
# (flag on = collapsed one-liner); uncomment to pin either shape
hunk_separator = "…"            
# Separator between hunks ("…", "───", "⋯", or "" for none)
dual_line_numbers = false       
# Two-column line numbers (old + new, like GitHub)
# line_summary = false          
# Show +N/-M in the collapsed header; unset follows the same flag
# bg = "none"                   
# Block background ("none", "light", "dark")

#סגנון בלוקים: חשיבה והסקה (Thinking/Reasoning)

[scrollback.blocks.thinking]
accent_enabled = true       
# Show accent line for thinking blocks
animate = true              
# Animate accent line while thinking
truncated_lines = 3         
# Lines to show in truncated mode
bg_blend = 70               
# Markdown-color blend with background (0-100)
header = true               
# Show "Thinking..." header
header_bright = false       
# Bright header style (vs dim/muted)

#סגנון בלוקים: קריאות לכלים (Tool Calls)

[scrollback.blocks.tool]
muted_collapsed = true     
# Gray out collapsed tool calls
dim_details = true          
# Dim parenthetical details (line counts, match counts)
bullet = "diamond"          
# Bullet style before tool headers

סגנונות תבליט (bullet) זמינים:

#סגנון בלוקים: ביצוע (פקודות מעטפת)

[scrollback.blocks.execute]
first_lines = 2                   
# Output lines shown at start in truncated mode
last_lines = 3                    
# Output lines shown at end in truncated mode
accent_enabled = true             
# Show accent line (animated while running)
header_style = "label"            
# "shell" ($ prefix) or "label" (Run prefix)
muted_command_collapsed = true    
# Mute command text when collapsed

#סגנון בלוקים: הנחיות משתמש (היסטוריית גלילה)

[scrollback.blocks.prompt]
vpad = true            
# Vertical padding
bg = "light"           
# Background ("none", "light", "dark")
show_prefix = true     
# Show the prompt prefix character
min_lines = 2          
# Minimum content lines in truncated/sticky mode

#רכיב קלט הנחיות (Prompt Input Widget)

[prompt]
collapse_unfocused = true    
# Collapse when scrollback is focused
mouse_hover = true           
# Show hover highlight on mouse over
show_prefix = true           
# Show the prompt prefix character

#התנהגות מסוף (Terminal Behavior)

[terminal]
alt_screen = "auto"    
# "auto", "always", or "never"

מדיניות Alt-screen:

• auto: מסך מלא במסופים רגילים וב-tmux רגיל; מוטבע בתוך השורה (inline) במצב שליטה של tmux וב-Zellij.
• always: כניסה תמידית למסך מלא.
• never: לעולם לא להיכנס למסך מלא; ריצה מוטבעת בתוך היסטוריית הגלילה הראשית.

#ממשק תוספים (Plugins UI)

disable_plugins = false   
# Set to true to hide /hooks, /plugins commands and annotations

#משבצות צבע של ערכות נושא

כל ערכת נושא מגדירה את משבצות הצבע הבאות המשמשות ברחבי ה-TUI:

רקעים: bg_base, bg_light, bg_dark, bg_highlight, bg_hover, bg_terminal, bg_visual

הדגשות: accent_user, accent_assistant, accent_thinking, accent_tool, accent_system, accent_error, accent_success, accent_running, accent_skill, accent_plan, accent_verify, accent_remember, accent_model

טקסט: text_primary, text_secondary

גווני אפור: gray_dim, gray, gray_bright

סמנטיקה: command, path, running, warning, fuzzy_accent

מסגרות ופס גלילה: selection_border, hover_border, prompt_border, prompt_border_active, scrollbar_bg, scrollbar_fg

הדבקה: paste_bg, paste_fg, paste_dim

Diff: diff_delete_bg, diff_delete_fg, diff_insert_bg, diff_insert_fg, diff_equal_fg, diff_gutter_fg

Markdown: צבעי כותרות (md_heading_h1 עד md_heading_h6), md_code, md_code_bg, md_text, md_muted, md_task_checked, md_task_unchecked, link_fg

מערכת ערכות הנושא מנהלת את המשבצות הללו באופן פנימי ומבצעת להן כימות אוטומטי בהתאם למסוף שלך.