מוח שני (LLM Wiki) לקלוד קוד: מדריך התקנה מלא

מדריך התקנה שלב אחר שלב ל-LLM Wiki, המוח השני שנותן לקלוד קוד זיכרון שנשמר בין סשנים. מרגע ההורדה ועד וויקי עובד, בפקודה אחת.

כל סשן חדש בקלוד קוד מתחיל מאפס.

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

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

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

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

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


מה מקבלים

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

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

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

סעיף חדש בקובץ ההוראות שלכם שאומר לקלוד שהוויקי קיים. בלי זה הוא לא היה יודע להשתמש בו מיוזמתו.


לפני שמתחילים

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

אם צריך להתקין, זה מ-python.org, וחובה לסמן "Add Python to PATH" בזמן ההתקנה. זו התקלה הנפוצה ביותר, והיא כולה בגלל תיבת סימון אחת.

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


ההתקנה

1. לתת לקלוד קוד את הפקודה

זה השלב היחיד שדורש מכם משהו. מדביקים לקלוד קוד את השורה הזאת:

Clone https://github.com/digimate-rani/wiki-kit
into this project, then read wiki-kit/INSTALL.md and follow it

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

הקוד פתוח וניתן לצפייה: github.com/digimate-rani/wiki-kit

2. לענות על שתי שאלות

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

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

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

3. לחכות דקה

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

4. לוודא שכתוב "All 8 checks passed"

זו הנקודה הקריטית במדריך.

המערכת בודקת את עצמה: שהספריות נטענות, שהתיקיות נוצרו, שגורד הרשת מחזיר טקסט נקי, שממיר ה-PDF עובד, ושההגנות על עברית הפוכה מתפקדות.

אם מופיע FAIL, פשוט תכתבו לקלוד "fix it". יש לו טבלת אבחון שמתרגמת כל כישלון לפתרון.

5. לסגור ולפתוח מחדש את קלוד קוד

זה השלב שהכי הרבה אנשים ידלגו עליו, ואז "כלום לא עובד".

הפקודות החדשות נטענות רק בהפעלה של קלוד. בלי הפעלה מחדש, הפקודות פשוט לא קיימות.


הבדיקה שזה חי

הכניסו משהו אמיתי, לא דוגמה:

/wiki-ingest <קישור למשהו שבאמת מעניין אתכם>

קלוד יגרד את הדף, יקרא אותו, יציג לכם מה הוא עומד לכתוב, ויחכה לאישור.

אחר כך תשאלו על זה:

/wiki-query מה אנחנו יודעים על ...

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


תקלות נפוצות

מה קורה הסיבה הפתרון
הפקודות לא קיימות לא הופעל מחדש לסגור ולפתוח את קלוד קוד
python לא מזוהה לא סומן Add to PATH להתקין את פייתון מחדש עם הסימון
דף גורד וכמעט ריק האתר נטען ב-JavaScript להריץ את ההתקנה שוב עם --with-playwright
PDF יצא ריק הקובץ סרוק, בלי שכבת טקסט אין מה לחלץ בלי OCR
עברית מ-PDF יוצאת הפוכה ככה קובצי PDF שומרים טקסט להריץ את הממיר שוב עם --fix-rtl

כמה עצות לשימוש

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

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

לבדוק תקינות מדי פעם. אחרי עשרים או שלושים דפים חדשים, הפקודה /wiki-lint מוצאת דפים שאף אחד לא מקשר אליהם, טענות שדפים חדשים יותר סותרים, וקישורים שנשברו.

מקור הוא לא ידע. התיקייה sources מחזיקה טקסט גולמי. דף בוויקי הוא הסינתזה שלו. מי שמזין בלי לסנתז מקבל תיקיית תמלולים, ואפס מהערך.


למי שמעדיף לעשות את זה לבד

בלי לערב את הסוכן, שורה אחת בטרמינל:

python wiki-kit/install.py

הוא שואל את אותן שאלות בעצמו, ומתקין את אותו הדבר.


ואם אתם רוצים לראות את זה נבנה

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

לצפייה בהקלטה המלאה

← חזרה למשאבים