תפריט

XIII.ספר ההתקנה · v0.19

Codex / Claude Code · Windows / macOS / Linux

בקשה אחת. הסוכן מתקין את STOLZ.

העתיקו את הבקשה ל־Codex או ל־Claude Code. אותה בקשה מתאימה ל־Windows, ל־macOS ול־Linux.

Codex / Claude Code
התקן לעצמך את כל המיומנויות של STOLZ A.I. ואת קובצי הייחוס שלהן מתוך https://github.com/Sergey360/stolz-ai/releases/latest. אמת את SHA-256 של הארכיון, השתמש בתיקיית המיומנויות האישית, שמור על המיומנויות הקיימות ובדוק את ההתקנה.

הדביקו את הבקשה בצ׳אט של הסוכן. הוא יכול להוריד ולהתקין את המיומנויות עבור המערכת שלכם.

לאחר ההתקנה פתחו סשן סוכן חדש.

התקנה ידנית והגדרת צוות
02

2. התקנה בפרויקט הצורך

התקינו את הארכיון שהורד כתלות פיתוח. לאחר מכן ה־CLI אינו מושך חבילה אחרת.

terminal / npm
npm install --save-dev /absolute/downloads/stolz-ai-0.19.0.tgz
03

3. בחירה, תצוגה מקדימה והתקנת הפרופיל

בחרו את פרופיל Codex, סקרו את תוכנית ההתקנה הדטרמיניסטית והוסיפו `--apply` רק אחרי בדיקת היעד והקבצים המנוהלים.

terminal / profile
npx --no-install stolz-profile resolve --runtime codex
npx --no-install stolz-profile install --runtime codex --destination /absolute/path/to/skills --dry-run
npx --no-install stolz-profile install --apply --runtime codex --destination /absolute/path/to/skills
04

4. הרצת doctor

Doctor אינו קורא לספק או למודל. הוא מדווח על מצב ההתקנה, גרסת סביבת הריצה שנצפתה, בסיס התאימות, זמינות המתאם העצל והפעולה הבאה.

terminal / doctor
npx --no-install stolz-profile doctor --runtime codex --runtime-version <version> --destination /absolute/path/to/skills
05

5. שמירת נעילת צוות ואימותה ב־CI

קובץ הנעילה מכיל זהות חבילה ופרופיל, לא פרטי גישה או נתיבים מקומיים. `verify-lock` מכשיל CI בסטייה, בנעילה לא תקינה או בגרסת סביבת ריצה מדווחת שאינה תואמת.

terminal / team lock
npx --no-install stolz-profile lock --apply --runtime codex --lockfile ./stolz-profile.lock.json
npx --no-install stolz-profile verify-lock --runtime codex --lockfile ./stolz-profile.lock.json
06

6. סקירת עדכון לפני החלתו

הפקודה הראשונה מציגה את השינוי העתידי. החילו רק לאחר סקירה; קובץ STOLZ חסר או ששונה מקומית עוצר את העדכון. נתיבי העדכון, השחזור, הקונפליקט והחזרה מ־v0.18.0 ל־v0.19.0 עברו בדיקת עשן לחבילה.

terminal / update
npx --no-install stolz-profile update --runtime codex --destination /absolute/path/to/skills
npx --no-install stolz-profile update --apply --runtime codex --destination /absolute/path/to/skills
07

7. שחזור עדכון שנקטע

אם doctor מדווח `recovery_required`, סקרו תחילה את השחזור. הוספת `--apply` משחזרת את ההתקנה הקודמת שאומתה ביומן העסקה.

terminal / recover
npx --no-install stolz-profile recover --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile recover --apply --destination /absolute/path/to/skills
08

8. חזרה לאחור באותה משמעת

סקרו את החזרה לפני החלתה. החזרה מסרבת לדרוס קובץ מנוהל ששונה מקומית.

terminal / rollback
npx --no-install stolz-profile rollback --dry-run --destination /absolute/path/to/skills
npx --no-install stolz-profile rollback --apply --destination /absolute/path/to/skills
+

אפשרות: התקנת stolz-browser בנפרד

העתקת כל תיקיית browser עם שני קובצי ההפניות. אין תלות במיומנות שחזור אישית או במתאם סמוך.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-browser .agents/skills/

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

+

אפשרות: התקנת stolz-evidence בנפרד

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

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-evidence .agents/skills/

בדיקת התצוגה המקדימה של כלל הפרויקט לפני --apply. בחירת codex, claude-code או qwen-code ותיקיית פרויקט קיימת בנתיב מוחלט. בדיקת ההוראות הפעילות בסביבה; מיזוג קובץ אינו מוכיח גילוי.

terminal / project rule dry run
node node_modules/stolz-ai/tools/evidence-instructions.mjs --project-root /absolute/project --runtime codex
09

לבחירה: התקנת stolz-guard בנפרד

הפרופילים מתקינים חמש מיומנויות אופטימיזציה. לבדיקת אבטחת הוראות יש להעתיק את כל תיקיית guard, כולל ההפניות. הפעילו את הפקודה פעם אחת עבור יעד חדש.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-guard .agents/skills/

פקודות lock, status, update ו־uninstall מנהלות רק קבצים בבעלות הפרופיל. יש לבדוק ולעדכן את התקנת guard הנפרדת ידנית. סביבת הריצה אוכפת הרשאות לכלים.

+

אפשרות: התקנת stolz-mcp בנפרד

העתקת תיקיית MCP המלאה עם שני קובצי ההפניות. חבילת Node מספקת גם CLI מקומי stolz-mcp ו־API בשם stolz-ai/mcp-code.

terminal / optional skill
mkdir -p .agents/skills
cp -R node_modules/stolz-ai/skills/stolz-mcp .agents/skills/
npx --no-install stolz-mcp --help

אין שינוי בהגדרות MCP. המארח מספק תעבורה וסביבה מורשית; הרצה בקוד אינה יוצרת sandbox או עוקפת הרשאות.

§ 3scope / evidence

מה הבדיקות מוכיחות

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

09

המשך בפרויקט אמיתי

המצב נשאר `followup_gap`: עדיין אין בעלים מזוהה לפיילוט אמיתי או חלון של 28 ימי ראיות אמיתיות.

חזרה לגרסה v0.19