docs: add note about ui-dir path if zip has dist/ prefix

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
MusiCode
2026-03-18 00:03:51 +00:00
committed by Shantur Rathore
parent c886344e2f
commit d9d56d77bc

View File

@@ -6,41 +6,44 @@
## דרישות מוקדמות ## דרישות מוקדמות
- **Node.js 18+** — ההתקנה חייבת להתבצע דרך `npm` בלבד. * **Node.js 18+** — ההתקנה חייבת להתבצע דרך `npm` בלבד.
> ⚠️ **bun אינו נתמך.** השרת חייב לרוץ דרך `node`, לא `bun`.
- **OpenCode CLI** — נדרש לפעולת הסוכן. > ⚠️ **bun אינו נתמך.** השרת חייב לרוץ דרך `node`, לא `bun`.
* **OpenCode CLI** — נדרש לפעולת הסוכן.
### התקנת OpenCode ### התקנת OpenCode
```bash ```
curl -fsSL https://opencode.ai/install | bash curl -fsSL https://opencode.ai/install | bash
``` ```
--- ---
## 1. התקנת CodeNomad גלובלית ## 1\. התקנת CodeNomad גלובלית
```bash ```
npm install -g @neuralnomads/codenomad@latest npm install -g @neuralnomads/codenomad@latest
``` ```
בדיקה: בדיקה:
```bash ```
codenomad --version codenomad --version
``` ```
> אם `codenomad` אינו נמצא ב-PATH, בדוק היכן npm מתקין packages גלובליים: > אם `codenomad` אינו נמצא ב-PATH, בדוק היכן npm מתקין packages גלובליים:
> ```bash >
> ```
> npm prefix -g > npm prefix -g
> # הוסף את <output>/bin ל-PATH > # הוסף את <output>/bin ל-PATH
> ``` > ```
--- ---
## 2. הגדרת אישורים ## 2\. הגדרת אישורים
```bash ```
mkdir -p ~/.config/codenomad mkdir -p ~/.config/codenomad
cat > ~/.config/codenomad/env <<'EOF' cat > ~/.config/codenomad/env <<'EOF'
CODENOMAD_SERVER_USERNAME=codenomad CODENOMAD_SERVER_USERNAME=codenomad
@@ -51,26 +54,26 @@ chmod 600 ~/.config/codenomad/env
--- ---
## 3. הורדת ממשק ה-RTL+Hebrew ## 3\. הורדת ממשק ה-RTL+Hebrew
### הורדה וחילוץ ### הורדה וחילוץ
```bash ```
mkdir -p ~/.config/codenomad/ui mkdir -p ~/.config/codenomad/ui
curl -L https://github.com/MusiCode1/CodeNomad/releases/download/v0.12.3-rtl-he/codenomad-ui-rtl-he.zip \ curl -L https://github.com/MusiCode1/CodeNomad/releases/download/v0.12.3-rtl-he/codenomad-ui-rtl-he.zip \
-o /tmp/codenomad-ui-rtl-he.zip -o /tmp/codenomad-ui-rtl-he.zip
``` ```
**חילוץ עם `unzip` (מומלץ):** **חילוץ עם** `**unzip**` **(מומלץ):**
```bash ```
unzip -o /tmp/codenomad-ui-rtl-he.zip -d ~/.config/codenomad/ui unzip -o /tmp/codenomad-ui-rtl-he.zip -d ~/.config/codenomad/ui
``` ```
**חילוץ עם `python3` (אם `unzip` אינו מותקן):** **חילוץ עם** `**python3**` **(אם** `**unzip**` **אינו מותקן):**
```bash ```
python3 -c " python3 -c "
import zipfile, os import zipfile, os
with zipfile.ZipFile('/tmp/codenomad-ui-rtl-he.zip') as z: with zipfile.ZipFile('/tmp/codenomad-ui-rtl-he.zip') as z:
@@ -79,18 +82,19 @@ print('Done.')
" "
``` ```
לאחר החילוץ, וודא שהתיקייה תקינה: לאחר החילוץ, וודא ש-`index.html` נמצא ישירות בתיקייה:
```bash
ls ~/.config/codenomad/ui/
# אמור לכלול: index.html, assets/, sw.js, ...
``` ```
ls ~/.config/codenomad/ui/index.html
```
> אם הקובץ נמצא ב-`ui/dist/index.html` (zip ישן), השתמש ב-`--ui-dir ~/.config/codenomad/ui/dist` במקום.
--- ---
## 4. הפעלה ידנית (לבדיקה) ## 4\. הפעלה ידנית (לבדיקה)
```bash ```
codenomad \ codenomad \
--host 0.0.0.0 \ --host 0.0.0.0 \
--ui-dir ~/.config/codenomad/ui \ --ui-dir ~/.config/codenomad/ui \
@@ -105,7 +109,7 @@ codenomad \
במקום `--ui-dir` אפשר להשתמש ב-`--ui-manifest-url` כדי שהשרת יוריד ויעדכן את ה-UI אוטומטית: במקום `--ui-dir` אפשר להשתמש ב-`--ui-manifest-url` כדי שהשרת יוריד ויעדכן את ה-UI אוטומטית:
```bash ```
codenomad \ codenomad \
--host 0.0.0.0 \ --host 0.0.0.0 \
--ui-manifest-url https://raw.githubusercontent.com/MusiCode1/CodeNomad/i18n-hebrew/manifest.json --ui-manifest-url https://raw.githubusercontent.com/MusiCode1/CodeNomad/i18n-hebrew/manifest.json
@@ -115,24 +119,24 @@ codenomad \
--- ---
## 5. שירות systemd (הפעלה אוטומטית עם המערכת) ## 5\. שירות systemd (הפעלה אוטומטית עם המערכת)
### יצירת קובץ השירות ### יצירת קובץ השירות
```bash ```
mkdir -p ~/.config/systemd/user mkdir -p ~/.config/systemd/user
``` ```
מצא את נתיב ה-node וה-codenomad שלך: מצא את נתיב ה-node וה-codenomad שלך:
```bash ```
which node # למשל: /usr/bin/node which node # למשל: /usr/bin/node
which codenomad # למשל: /usr/local/bin/codenomad which codenomad # למשל: /usr/local/bin/codenomad
``` ```
צור את קובץ השירות: צור את קובץ השירות:
```bash ```
cat > ~/.config/systemd/user/codenomad.service <<'EOF' cat > ~/.config/systemd/user/codenomad.service <<'EOF'
[Unit] [Unit]
Description=CodeNomad Server (RTL + Hebrew) Description=CodeNomad Server (RTL + Hebrew)
@@ -156,13 +160,13 @@ WantedBy=default.target
EOF EOF
``` ```
> **חשוב:** החלף את הנתיבים בנתיבים מהפקודות `which` שהרצת למעלה. > **חשוב:** החלף את הנתיבים בנתיבים מהפקודות `which` שהרצת למעלה.
> נתיב הבינארי של node: `$(which node)` > נתיב הבינארי של node: `$(which node)`
> נתיב bin.js: `$(npm prefix -g)/lib/node_modules/@neuralnomads/codenomad/dist/bin.js` > נתיב bin.js: `$(npm prefix -g)/lib/node_modules/@neuralnomads/codenomad/dist/bin.js`
### הפעלת השירות ### הפעלת השירות
```bash ```
systemctl --user daemon-reload systemctl --user daemon-reload
systemctl --user enable --now codenomad systemctl --user enable --now codenomad
systemctl --user status codenomad systemctl --user status codenomad
@@ -170,15 +174,15 @@ systemctl --user status codenomad
### לוגים ### לוגים
```bash ```
journalctl --user -u codenomad -f journalctl --user -u codenomad -f
``` ```
--- ---
## 6. הפעלה לאחר logout (שרתים ללא מסך) ## 6\. הפעלה לאחר logout (שרתים ללא מסך)
```bash ```
loginctl enable-linger $USER loginctl enable-linger $USER
``` ```
@@ -190,7 +194,7 @@ loginctl enable-linger $USER
כשיוצאת גרסה חדשה: כשיוצאת גרסה חדשה:
```bash ```
# הורד את ה-UI החדש # הורד את ה-UI החדש
curl -L https://github.com/MusiCode1/CodeNomad/releases/latest/download/codenomad-ui-rtl-he.zip \ curl -L https://github.com/MusiCode1/CodeNomad/releases/latest/download/codenomad-ui-rtl-he.zip \
-o /tmp/codenomad-ui-rtl-he.zip -o /tmp/codenomad-ui-rtl-he.zip
@@ -208,9 +212,9 @@ systemctl --user restart codenomad
## פתרון בעיות נפוצות ## פתרון בעיות נפוצות
| בעיה | פתרון | | בעיה | פתרון |
|------|--------| | --- | --- |
| `codenomad: command not found` | הוסף `$(npm prefix -g)/bin` ל-`~/.bashrc` | | `codenomad: command not found` | הוסף `$(npm prefix -g)/bin` ל-`~/.bashrc` |
| השירות לא עולה | בדוק נתיבים ב-`ExecStart` — חייב להיות `node`, לא `bun` | | השירות לא עולה | בדוק נתיבים ב-`ExecStart` — חייב להיות `node`, לא `bun` |
| הממשק לא נטען | וודא שהחלצה הצליחה: `ls ~/.config/codenomad/ui/index.html` | | הממשק לא נטען | וודא שהחלצה הצליחה: `ls ~/.config/codenomad/ui/index.html` |
| העברית לא מופיעה | בחר את השפה ידנית מבורר השפות בממשק | | העברית לא מופיעה | בחר את השפה ידנית מבורר השפות בממשק |
| השרת לא נגיש מרחוק | וודא ש-`--host 0.0.0.0` מוגדר ושה-firewall פותח את פורט 9899 | | השרת לא נגיש מרחוק | וודא ש-`--host 0.0.0.0` מוגדר ושה-firewall פותח את פורט 9899 |