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.
6.7 KiB
תמיכה ובנייה מקוד מקור
השתמשו במאגר לדיווחי תקלות, לגרסאות עדכניות ולתרומות. מדריך פתרון הבעיות מכסה התאוששות בטוחה לפני דיווח על תקלה.
דיווח על באג
- פתחו הגדרות → מידע → אבחון.
- בחרו דווח על באג לפתיחת טופס דיווח התקלה ב־GitHub.
- בדקו את פרטי הגרסה/הלקוח שמולאו מראש. הוסיפו שחזור מינימלי, התנהגות צפויה ותוצאה בפועל, ואז שלחו דרך GitHub.
הפעולה ממלאת מראש את גרסאות CodeNomad ו־OpenCode (לרבות שירות OpenCode הפועל כשהוא שונה מהגרסה המותקנת), את מערכת ההפעלה שלכם, את סוג הלקוח (עם ה־user agent של הדפדפן בדפדפן אינטרנט) ואת מערכת ההפעלה של השרת. היא אינה ממלאת מראש כתובות מאזינים, נתיבי סביבת עבודה, פרטי התחברות או טקסט שיחה. פתיחת הטופס אינה שליחת דיווח.
אם דרוש אבחון נוסף, העתק ללוח או הורד .txt מפיקים דוח נפרד. דוח מפורט זה יכול להכיל נתיבים מקומיים וכתובות רשת: בדקו והשחירו אותו לפני צירופו. צילום מסך או קטע יומן עדיין יכולים להכיל סודות גם כשדוח האבחון האוטומטי אינו כולל סודות אימות.
אם שדות טופס GitHub אינם תואמים, CodeNomad פותח דיווח רגיל עם אותם פרטי דוח. כשל זמני בקריאת הטופס אינו מונע את פתיחתו. תמיד אפשר להשתמש ידנית ב־רשימת הדיווחים.
קהילה וגרסאות
| משאב | שימוש |
|---|---|
| מאגר CodeNomad | קוד מקור, פעילות הפרויקט ותיעוד. |
| דיווחים | חפשו דיווחים קיימים לפני פתיחת באג שניתן לשחזור או בקשת תכונה. |
| בקשות משיכה | סקירת שינויים מוצעים או תיאום תרומה. |
| הגרסה האחרונה | קובצי הורדה יציבים. |
| כל הגרסאות | תצוגות מקדימות שפורסמו והערות גרסה. |
| Neural Nomads | ארגון הפרויקט. |
| רישיון MIT | תנאי הרישיון. |
לבעיות בתצורה המקורית של OpenCode ולא בפקדי CodeNomad, עיינו ב־תיעוד OpenCode וב־גרסאות המקור.
בנייה מקוד מקור
השתמשו ב־Node.js 24.20.0, כפי שמקובע ב־.node-version, ב־npm, ב־Git וב־OpenCode CLI תואם. הריצו את הפקודות מעותק פיתוח:
git clone --branch dev https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm ci --workspaces --include=optional
npm run dev
npm run dev מפעיל את מארח הפיתוח של Electron. לשימוש ב־Tauri, התקינו תחילה את דרישות הבנייה לפלטפורמה, לרבות כלי Rust, ואז הריצו:
npm run dev:tauri
שינויי פיתוח משפיעים על מארח הפיתוח, לא על הגרסה המותקנת של דמון OpenCode הפועל בנפרד. אריזה מקורית דורשת את כלי היעד המתאימים; העדיפו בנייה במערכת ההפעלה של היעד.
בנייה ואימות
| פקודה, משורש המאגר | מטרה |
|---|---|
npm run build |
בניית משאבי יישום Electron. |
npm run build:tauri |
בניית יישום Tauri עם דרישות הקדם המקוריות שלו. |
npm run build:ui |
בניית ממשק הדפדפן. |
npm run build --workspace @neuralnomads/codenomad |
בניית השרת העצמאי והנכסים הכלולים. |
npm run build:linux --workspace @neuralnomads/codenomad-electron-app |
אריזת גרסת Debian של Electron. |
npm exec --workspace @codenomad/tauri-app -- tauri build --bundles appimage |
אריזת AppImage של Tauri ל־Linux. |
npm run typecheck |
בדיקת סביבות העבודה של TypeScript שהוגדרו בשורש. |
npm run test:help |
אימות כל שפות העזרה הציבורית והקישורים. |
npm run build:help |
בניית העזרה הציבורית העצמאית אל dist/help. |
בניית העזרה אינה דורשת שירות CodeNomad או OpenCode פועל. ראו BUILD.md לפרטי אריזה ו־CONTRIBUTING.md לאימות ממוקד ולנוהלי PR; השתמשו בסקריפטים הקיימים בפועל בחבילת היעד.
מפת החבילות ותרומה
| חבילה | אחריות |
|---|---|
packages/server |
פקדי סביבת עבודה/API/Git, חיבור OpenCode, אימות, אירועים וקול. |
packages/ui |
סביבת העבודה של SolidJS, פקדים, תרגום ונקודת הכניסה לעזרה בדפדפן. |
packages/electron-app |
חלונות Electron, שילוב מקורי ואריזה. |
packages/tauri-app |
חלונות Tauri, שילוב פלטפורמה ואריזה. |
packages/remote-tunnel |
סביבת תעבורת OpenTunnel בצד שרת הקצה. |
- דונו בהיקף בדיווח הרלוונטי לפני מימוש עבודה חופפת.
- הסתעפו מ־
devושמרו על שינוי ממוקד. - הריצו בדיקות לאזור המושפע, עדכנו עזרת משתמש לצד ההתנהגות והפנו את ה־PR ל־
dev.
מקורות העזרה הציבורית נמצאים ב־docs/help/<locale>/. שמרו בתרגומים על המזהה המפורש, הרמה והסדר של כל כותרת באנגלית; כותרות מתורגמות חייבות לא לשבור קישורים עמוקים. חוזה תחזוקת העזרה מתאר בדיקות שלמות קפדניות ואת תהליך הפרסום הסטטי.