דילוג לתוכן
Skynetתיעוד
דפים

מדריכים

אפליקציית Mac

הרץ/י את Skynet על ה-Mac שלך עם סוכן הקוד שלך ו-Docker.

אפליקציית ה-Mac של Skynet מריצה את Skynet על המחשב שלך. היא שולחת קריאות למודל דרך CLI לקוד שמחובר ב-Mac שלך, כך שהמנוי שלך ל-CLI משלם על הקריאות האלה. אפשר גם לקשר את האפליקציה לחשבון Skynet המתארח שלך.

דרישות

  • Mac עם Apple silicon. יש גרסאות ל-Intel, אבל אף אחד לא בדק אותן על חומרת Intel.
  • Docker Desktop פועל, עם ההגדרה Use Rosetta for x86_64/amd64 emulation מופעלת.
  • CLI לקוד אחד, מחובר:
    • Claude Code (claude) בגרסה 2.1.226 ומעלה, או
    • Codex (codex) בגרסה 0.160.0 ומעלה.

הגדרת Codex

Codex חייב לשמור את פרטי ההתחברות שלו בקובץ. בצע/י את השלבים האלה לפני ההפעלה הראשונה:

  1. פתח/י את ~/.codex/config.toml והוסף/הוסיפי את השורה הזו:
cli_auth_credentials_store = "file"
  1. התחבר/י עם חשבון ה-ChatGPT שלך:
codex login

התקנת האפליקציה

הגרסאות חתומות בחתימת ad hoc ולא עברו notarization. macOS חוסם אותן עד שמסירים את דגל ההסגר (quarantine).

  1. פתח/י את קובץ ה-.dmg.
  2. גרור/גררי את Skynet אל Applications.
  3. הרץ/הריצי את הפקודה הזו ב-Terminal:
xattr -dr com.apple.quarantine /Applications/Skynet.app
  1. פתח/י את Skynet מתוך Applications.

מה קורה בהפעלה

האפליקציה מבצעת את השלבים האלה לפי הסדר:

  1. היא קוראת את ה-PATH מ-login shell שלך, כדי למצוא את Docker ואת ה-CLI.
  2. היא בודקת את Docker ואת ה-CLI לקוד.
  3. היא מפעילה מסד נתונים Postgres מקומי ב-Docker.
  4. היא בונה את ה-image של ה-sandbox‏ skynet-local-sandbox עבור linux/amd64. Docker מריץ אותו תחת Rosetta.
  5. היא מעדכנת את הסכמה של מסד הנתונים.
  6. היא מפעילה את ה-API המקומי ואת אפליקציית הווב, ומציגה את אפליקציית הווב בחלון.

בדיקות ההתחלה

האפליקציה מציגה רשימה של בדיקות: Docker, CLI לקוד, מחובר, מגבלת שימוש, שירותים מקומיים ו-חשבון. אם בדיקה נכשלת, האפליקציה מציגה מסך שמסביר מה לעשות:

מסךמה לעשות
צריך להתקין את Docker Desktopהתקן/י את Docker Desktop.
צריך להפעיל את Dockerהפעל/י את Docker Desktop.
צריך להתקין CLI לקודהתקן/י את Claude Code או את Codex.
צריך לעדכן את ה-CLIעדכן/י את ה-CLI לגרסה המינימלית שלמעלה.
צריך להתחבר ל-CLIהתחבר/י ל-CLI ב-Terminal.
הגעת למגבלת השימושחכה/חכי לזמן האיפוס. אפשר להתחיל אופטימיזציות חדשות שוב אחרי האיפוס.

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

ריצות מקומיות

באפליקציה, קריאות למודל עוברות דרך ה-CLI ב-Mac שלך. תפריט המודלים מציג את המצב הזה כ-מקומי. הרמז אומר: "המנוי שלכם משלם על הקריאות, כך שהמודל הזה מוסיף $0 לריצה."

שמות ה-CLI באפליקציה הם Claude Code ו-Codex.

הרצת המציע ב-CLI שלך

ההגדרה הרצת המציע ב-CLI שלי קובעת איפה סוכן המציע (proposer) רץ. האפשרויות הן מנוע הסוכן (ברירת מחדל) ו-כבוי (מציע בסביבה מבודדת).

הרשאות המציע קובעת למה ה-CLI יכול לגשת:

  • סביבת העבודה בלבד היא ברירת המחדל. היא מסתמכת על ה-sandbox של כל CLI.
  • גישה מלאה מריצה את ה-CLI עם הרשאות המשתמש שלך.

תיוג באפליקציה

תיוג עם AI באפליקציית ה-Mac צריך מפתח ספק משלך. בחר/י מודל תחת המפתח שלך. ראה/ראי תיוג נתונים עם כלי התיוג.

קישור לחשבון Skynet שלך

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

קישור ה-Mac הזה

  1. בשלב התחברות ל-Skynet, האפליקציה פותחת את העמוד קישור ה-Mac הזה לחשבון Skynet שלכם בדפדפן ברירת המחדל.
  2. התחבר/י ל-Skynet בדפדפן אם הוא מבקש.
  3. בדוק/בדקי את הרשימה תחת אחרי הקישור, ה-Mac הזה יוכל:.
  4. לחץ/י על קישור ה-Mac הזה. העמוד מציג "חוזרים לאפליקציית ה-Mac…".

אם ההתחברות נכשלת או שאת/ה מבטל/ת, האפליקציה מציגה לנסות שוב ו-להמשיך בלי להתחבר.

אחרי הקישור, ה-Mac יכול:

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

הקישור משתמש בתהליך התחברות מאובטח (OAuth עם PKCE). האפליקציה שומרת את הטוקנים שלה מוצפנים ב-Mac שלך. כשמבטלים את הקישור, Skynet מבטל את הטוקנים.

מגבלות קישור

מגבלהערך
מחשבי Mac מקושרים לכל חשבון10
משך החיים של access tokenשעה אחת, ואז האפליקציה מרעננת אותו
זמן קצוב לחוסר פעילות של קישור30 ימים בלי שימוש
גיל מרבי של קישור365 ימים

אחרי הזמן הקצוב לחוסר פעילות או אחרי הגיל המרבי, קשר/י את ה-Mac שוב.

סטטוס הקישור

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

שירותים מקומיים ונתונים

כל השירותים המקומיים מאזינים רק ב-127.0.0.1:

שירותטווח פורטים
API48100 עד 48119
אפליקציית הווב48120 עד 48139
Postgres48140 עד 48159

האפליקציה שומרת את הנתונים שלה ב-~/Library/Application Support/Skynet. התיקייה logs/ מכילה את desktop.log, api.log, frontend.log, migrate.log ו-sandbox-build.log.

כשסוגרים את האפליקציה, היא עוצרת את אפליקציית הווב, את ה-API, את Postgres ואת כל הקונטיינרים של האופטימיזציות.

איפוס האפליקציה

קודם סגור/סגרי את האפליקציה. אחר כך הרץ/הריצי:

docker volume rm skynet-local-pgdata
rm -rf ~/Library/Application\ Support/Skynet

השלבים הבאים