Project Compass
לראות במה פרויקט After Effects באמת משתמש, לפני שמנקים אותו.
עובד אפשר להוריד אותו. למטה יש הדגמה בדפדפן על נתונים לדוגמה.
הבעיה
לנקות פרויקט After Effects שקיבלתם ממישהו אחר זה מסוכן. מוחקים את הקובץ הלא נכון, ומשהו נשבר בלי אזהרה.
מה בניתי
סקריפט שבודק במה הקומפוזיציה הראשית באמת משתמשת, מסמן לבדיקה את מה שלא ברור, ומציע סידור תיקיות שאפשר לבטל.
- בשימוש, לא בטוח או לא בשימוש, עם סיבה
- קורא הפניות גם בתוך expressions
- לא מוחק שום דבר
הורדה ל-After Effectsלנסות את הדמו בדפדפן
יכולות ומגבלות
נבנה ונבדק
- עוקב אחרי כל מה שהקומפוזיציה הראשית מגיעה אליו: שכבות, קומפוזיציות מקוננות, מאטים, וקומפוזיציות או קבצים שמוזכרים בתוך expressions.
- שלוש הכרעות, כל אחת עם סיבה: Used, Check ו-Unused.
- כל מה שלא ודאי עובר ל-Check ולא ל-Unused: שכבות כבויות, שכבות guide ושמות שיכולים להתפרש בשתי דרכים.
- אם expression בונה שם בקוד, הכל נחשב כאילו ייתכן שהוא בשימוש, כי סקריפט לא יכול להוכיח אחרת.
- מצביע על expressions שמפנים לפריטים שחסרים בפרויקט.
- מעביר פריטים לתיקיות _Compass, עם תוכנית ביטול שמחזירה כל פריט למקומו.
מגבלות
- מסדר פריטים בתיקיות. הוא לא מוחק פריטים מהפרויקט.
- נבדק ב-After Effects 26.5.0 על macOS 27.0.1 על פרויקט לדוגמה. עוד לא נבדק ב-Windows או על פרויקטים גדולים מאוד.
- את ה-expressions הוא קורא לפי תבנית: comp("Name") ו-footage("Name"). דרכים אחרות להגיע לפריט עדיין לא מזוהות.
- אפקטים שמפנים לשכבות אחרות, כמו מקור של Displacement Map, עדיין לא נבדקים.
- תיקיות ה-_Compass הריקות נשארות בפרויקט אחרי ביטול.
מתוכנן
אפקטים שמפנים לשכבות אחרות, עוד תבניות של expressions, ובדיקה ב-Windows.
איך משתמשים
- בוחרים את הקומפוזיציה הראשית, או טוענים מודל פרויקט שיוצא מ-After Effects.
- קוראים את ההכרעה ואת הסיבה לכל פריט.
- מחליטים אם שכבות כבויות ושכבות guide נחשבות בשימוש בניקוי הזה.
- מייצאים את תוכנית ההעברה, ושומרים לידה את תוכנית הביטול.
איך זה עובד
- בונה גרף מהקומפוזיציה הראשית דרך שכבות, קומפוזיציות מקוננות, מאטים והפניות מתוך expressions.
- פריט שמגיעים אליו רק דרך שכבה כבויה או שכבת guide מסומן כ-Check, אף פעם לא כ-Unused.
- תוכנית ההעברה ותוכנית הביטול נוצרות יחד, כך שכל העברה אפשר להחזיר.
גרסאות שנבדקו ומגבלות
- עבר Unit: layers, precomps, mattes, expressions followed Node 22, Linux
- עבר Unit: disabled and guide layers are Check, never Unused Node 22, Linux
- עבר Unit: ambiguous names, computed expressions, missing references Node 22, Linux
- עבר Unit: plan only moves; undo restores every folder Node 22, Linux
- עבר Browser: audit, toggle, main-comp switch Chromium (Playwright)
- עבר Host script on a mock After Effects project: export, plan, undo plan; every item back, layers unchanged; backups never overwritten Node 22, Linux
- עבר Browser: loads a model exported by the host script; rejects an invalid one Chromium (Playwright), Linux
- עבר Host: export, apply the move plan and the undo plan inside After Effects After Effects 26.5.0, macOS 27.0.1
נבדק לאחרונה: 2026-11-01.
לוגיקת הבדיקה נבנתה ונבדקה, והעמוד טוען מודל שיוצא מ-After Effects. סקריפט ה-host רץ ב-After Effects 26.5.0 על macOS 27.0.1 על פרויקט בדיוני: המודל שיוצא נבדק והגיע להכרעות הצפויות, תוכנית ההעברה ותוכנית הביטול בוצעו עם גיבוי קודם, והשכבות, המקורות, המאטים וה-expressions נשארו זהים. תיעוד: labs/host-tests/results/2026-10-31-mac-t03.
פרטים
- קלט
- פרויקט After Effects והקומפוזיציה הראשית שלו
- פלט
- דוח של מה בשימוש, וסידור תיקיות שאפשר לבטל
- רץ ב
- סקריפט ל-After Effects שמייצא את הפרויקט ומבצע את תוכנית התיקיות, נבדק ב-After Effects 26.5.0 על macOS 27.0.1. הבדיקה בעמוד הזה רצה בדפדפן.
- מקור
- מקורי, נבנה מחדש מאפס