רוב הבעיות נובעות מכך שהסוכן לא מוצא את הפקודה, את הכניסה, את התיקייה של האפליקציה, או מרמת הטוקן. כאן ההודעות שהסוכן או ה-CLI מציגים, מה כל אחת אומרת ומה עושים. מתחילים עם ploa doctor: הוא בודק את Node, ploa, git, Xcode, CocoaPods, Java, ה-Android SDK, Flutter, מקום בדיסק, הכניסה, והאם התיקייה מקושרת.
הסוכן לא מציג את Ploa
מפעילים מחדש את הסוכן אחרי ploa mcp install או שינוי בהגדרות. רוב הסוכנים קוראים את הגדרות ה-MCP רק כשהם עולים.
בודקים שהקובץ נמצא איפה שהסוכן מחפש: .mcp.json (Claude Code), .cursor/mcp.json, .vscode/mcp.json בתיקיית השורש של הפרויקט, ~/.codex/config.toml ל-Codex. פותחים את הסוכן באותה תיקייה. ב-Claude Code מאשרים את השרתים של הפרויקט כשהוא שואל.
הפקודה לא נמצאה: סוכן שנפתח מה-Dock לא תמיד רואה את ה-PATH שלך. מריצים שוב ploa mcp install (הוא כותב נתיבים מלאים), או משתמשים בנתיב המלא מ-command -v npx.
Node ישן מדי: השרת צריך Node 24 ומעלה. node --version מציג את הגרסה שלך.
ב-Windows: 'ploa' לא מזוהה, סקריפטים חסומים, או שהסוכן לא מפעיל את Ploa אחרי התקנה מ-npm: ראה עבודה מ-Windows.
הכלים של Ploa כבויים: בהגדרות ה-MCP של Cursor או ברשימת הכלים של VS Code, מדליקים את ploa.
הודעות ומה עושים
כניסה
מה כתוב
מה עושים
This machine isn't signed in to Ploa. Ask the person to run ploa login in a terminal
מריצים ploa login באותו מחשב (סוכן לא יכול להיכנס בעצמו), או נותנים לשרת טוקן כ-PLOA_TOKEN. בטרמינל אותה הודעה היא not signed in: run ploa login.
this token is unknown or revoked
הטוקן בוטל בהגדרות › טוקנים, או על ידי ploa logout. מריצים שוב ploa login, או יוצרים טוקן חדש. סוכן ברשת: מחברים אותו מחדש.
the code expired before it was confirmed: run ploa login again
מריצים ploa login ומאשרים את הקוד בדפדפן כל עוד הוא מוצג.
הקוד לא מוכר, כבר שומש או שפג תוקפו (בדפדפן)
מריצים שוב ploa login ומשתמשים בקוד החדש.
החשבון או הרמה לא נכונים
מריצים ploa whoami, או מבקשים מהסוכן לקרוא ל-ploa_access. PLOA_TOKEN בסביבה גובר על ploa login: מסירים אותו אם הוא ישן.
can't reach https://ploa.dev, או didn't answer within … seconds
המחשב לא מצליח להגיע ל-Ploa: בודקים את החיבור, proxy או VPN, ושה-PLOA_SERVER לא מוגדר לכתובת אחרת.
איזו אפליקציה
מה כתוב
מה עושים
This folder isn't linked to an app in Ploa: ploa_setup_guide says what's missing, and ploa_link links it
מבקשים מהסוכן להריץ ploa_link. מהטרמינל, ploa init בתיקייה של האפליקציה עושה אותו דבר.
the app has neither ios.bundleIdentifier nor android.package (או בלי applicationId או bundle ID, לאפליקציה שהיא לא Expo)
לאפליקציה עוד אין מזהה, ולכן אי אפשר לקשר אותה. מבקשים מהסוכן להריץ ploa_setup_guide: הוא מציע מזהים, והסוכן קובע בפרויקט את זה שבחרת.
several apple connections (…): choose one with --apple <name> (או google)
בסביבת העבודה יש יותר מחיבור אחד ל-App Store או ל-Google Play. אומרים לסוכן באיזה, או מריצים ploa init --apple <name>.
הסוכן עובד על האפליקציה הלא נכונה, או על אף אחת
השרת עובד על האפליקציה שבתיקייה שבה הוא עולה, לפי ה-ploa.json הקרוב. מפעילים את הסוכן בתיקייה של האפליקציה, או מוסיפים --dir /path/to/app לארגומנטים של השרת. ריפו אחד עם כמה אפליקציות: לכל תיקיית אפליקציה יש ploa.json משלה, והכלים מקבלים את התיקייה.
Say which app: pass app, its ID in Ploa (ploa_apps lists them)
ברשת, כשיש בסביבת העבודה יותר מאפליקציה אחת: אומרים לסוכן איזו, או מבקשים ממנו להציג אותן.
כלי נדחה
מה כתוב
מה עושים
this token can't ask for submit actions (או production actions)
רמת הטוקן נמוכה מכדי אפילו לבקש. מעלים אותה בהגדרות › טוקנים להגשה לבדיקה או לפרודקשן; הטוקן ממשיך לעבוד עם הרמה החדשה. ראה הרמות.
this token is limited to read (או draft, או submit)
אותו דבר: הפעולה צריכה רמה גבוהה יותר. מעלים אותה בהגדרות › טוקנים, או עושים את זה בעצמך בלוח הבקרה.
an agent on the web asks a person for what needs this level, and doesn't do it itself
סוכן ברשת (טיוטות, בניות ובקשות) ניסה שינוי בחנות שמותר לו רק לבקש, או שינוי שלא מבקשים בכלל (העלאת צילומי מסך, קבוצה ב-TestFlight, שליחת דף החנות). עושים את זה בלוח הבקרה, או עם הסוכן שבמחשב שלך. אם הוא על טיוטות ובניות וצריך לבקש, משנים אותו לטיוטות, בניות ובקשות בהגדרות › טוקנים.
an agent on the web does drafts and builds itself and asks a person for the rest
בהגדרות › טוקנים סוכן ברשת יכול לקבל קריאה, טיוטות או טיוטות ובקשות, אף פעם לא הגשה, פרודקשן או סוכן אוטונומי. בשביל אלה מריצים את הסוכן במחשב שלך.
an agent on the web can't be autonomous
מריצים את הסוכן במחשב שלך אם רוצים שיהיה אוטונומי.
an owner hasn't given you the "…" permission in this workspace
התפקיד שלך לא כולל את זה, ולכן גם לא הסוכנים שלך. מבקשים מבעלים להדליק לך את זה בדף חברי הצוות. המילה במירכאות היא ההרשאה: apps אפליקציות ובנייה, store דף החנות, release App Review ופרודקשן, reviews ביקורות, keys חנויות, מפתחות ו-GitHub, sales מכירות והכנסות, agents סוכנים וטוקנים, billing תוכנית ותשלום, security אבטחה, autonomous סוכנים אוטונומיים.
only a signed-in person, or an agent its owner made autonomous, can do this
עושים את זה בעצמך בלוח הבקרה, או הופכים את הסוכן לאוטונומי (סוכנים אוטונומיים).
only a person can say App Privacy was entered in App Store Connect (או this was entered in Play Console)
מזינים את התשובות בקונסולה, ואז מסמנים את זה בעצמך ב-Ploa. הסוכן אומר לך מה להזין.
Data safety replaces what Play Console has, so a person sends it; the encryption declaration is the person's statement to Apple
שולחים את זה בעצמך מ-Ploa (Google Play setup › Data safety, או דף פרטי החנות), אחרי שבודקים את התשובות של הסוכן.
Only a person can add the upload key for this agent
מוסיפים אותו ב-Ploa, בהגדרות של האפליקציה › Google Play › הוספת המפתח.
לא מוצע ברשת (הכלי לא ברשימה)
בנייה במחשב, בדיקה מקדימה, קבצים מקומיים וצילומי מסך מסימולטור צריכים את השרת שבמחשב שלך.
the Free plan has room for 1 app: move to Pro for more (או מספר חברי צוות)
האפליקציות או חברי הצוות בתוכנית מלאים. עוברים לתוכנית גדולה יותר בהגדרות › חיוב ושימוש, או מסירים אפליקציה שכבר לא צריך. ראה תוכניות.
this workspace is suspended: its owners have an email from Ploa about it
לבעלים יש את הסיבה במייל. כותבים לתמיכה אם זה לא ברור.
link the app to its repository first
מבקשים מהסוכן להריץ ploa_github_setup, ואז מאשרים את הקישור.
לא שגיאות
מה כתוב
מה זה אומר
מחכה לאישור שלך
מאשרים בלוח הבקרה או מההתראה, והסוכן ממשיך עם ploa_approval_status.
Kept in Ploa, not sent yet
ל-Apple יש את הפריט אצל App Review. Ploa שולחת את השינוי בעצמה אחרי ש-Apple מחליטה. אין מה לנסות שוב; ploa_held_changes מציג מה נשמר.
Ploa was updated on this machine (… → …) after these tools started
מפעילים מחדש את הסוכן, או טוענים מחדש את שרתי ה-MCP שלו, כדי להשתמש בגרסה החדשה.
משימה באישורים שלך
צעד שרק אתה יכול לעשות בקונסולה של חנות. הצעדים והקישור נמצאים במשימה, והסוכן מעביר אותך בהם.
הגדרת הסוכן
מה כתוב
מה עושים
the file isn't plain JSON (comments?), so it was left alone
מציינים את הסוכנים במילים האלה: ploa mcp install --agent claude,codex.
Node … is too old: ploa needs Node 24 or newer (סקריפט ההתקנה)
מתקינים Node 24 ומעלה מ-nodejs.org (או עם nvm, fnm, Homebrew), ומריצים שוב את הסקריפט.
… isn't on your PATH yet (סקריפט ההתקנה)
מוסיפים את השורה שהוא מדפיס ל-~/.zshrc או ל-~/.bashrc, ופותחים טרמינל חדש.
בנייה נכשלת
שואלים את הסוכן: למה השחרור האחרון נכשל? הוא קורא את ploa_release_status ואת ploa_runs, צעד אחר צעד, מתקן את מה שבקוד של האפליקציה, ומריץ ploa_setup_guide בשביל מה שמחוץ לו (חשבון, יכולת אצל Apple, הגדרה בחנות), שמציג את הצעד הזה ראשון, עם הקישורים שלו.
מריצים ploa doctor במחשב: Xcode, Java, ה-Android SDK, מקום בדיסק והכניסה.
מריצים ploa preflight לפני הבנייה: הוא תופס את מה שהחנויות דוחות. בנייה מהטרמינל נעצרת על מה שהבדיקה המקדימה מוצאת (preflight found … problem(s)… fix them, or pass --force).
לבנייה ב-GitHub חסרים google-services.json או .env: ploa files מציג אותם ו-ploa files push שולח אותם לאישור שלך.
השרת ברשת (ploa.dev/mcp)
דף האישור לא נפתח: הסוכן פותח אותו בדפדפן שלך. נכנסים קודם ל-ploa.dev באותו דפדפן, ומנסים להתחבר שוב.
זה עבד, ואז הפסיק: ייתכן שהטוקן בוטל בהגדרות › טוקנים. מתחברים מחדש.
כלי בנייה מבקש GitHub: ברשת הבניות רצות ב-GitHub. מבקשים מהסוכן להריץ ploa_github_status.
הוא לא יכול להגיש ל-App Review או לשחרר: סוכן ברשת מבקש רק אם בחרת טיוטות, בניות ובקשות; אז הוא מבקש ואתה מאשר. על טיוטות ובניות הוא לא יכול אפילו לבקש: משנים את זה בהגדרות › טוקנים, או עושים את זה בלוח הבקרה.
עדיין תקוע?
כותבים לנו בדף התמיכה מה ביקשת מהסוכן, מה הכלי ענה ואיזו אפליקציה. אף פעם לא שולחים מפתח או סיסמה.
