Hex — מלוח ריק למשחק אופליין מול מחשב

נקודת ההתחלה

הפרויקט hex5 מתחיל ב־Empty Views Activity בשפת Java, עם XML ו־View Binding פעיל. שם החבילה הוא com.example.hex. המורה מספק את המודלים המאומנים; אין במסלול הזה משימת אימון ב־Python או ב־Colab.

לאן אנחנו הולכים?

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

%% dir: rtl %%
flowchart TB
    subgraph preparation["מחוץ לטלפון — המורה מספק"]
        training["אימון עצמי מראש"] --> tflite["מודל .tflite"]
    end
    subgraph app["האפליקציה — משחק אופליין"]
        catalog["model_catalog.json<br/>נתיב וגודל לוח"]
        assets["קובצי .tflite"]
        human["מהלך האדם"] --> game["מצב המשחק וחוקיו"]
        game --> candidates["עותק לכל מהלך מחשב חוקי"]
        candidates --> values["הערכת המצבים במכשיר"]
        catalog --> values
        assets --> values
        values --> move["בחירת מהלך מחשב"]
    end
    tflite -->|"העתקה לנכסי האפליקציה"| assets

בפרקים 01–04 נגיע למשחק מקומי שלם, עם לוח 7×7 כברירת מחדל. בפרק 02 מצב המשחק והתצוגה כבר יקבלו גודל לוח; בפרק 07 נוסיף את שתי אפשרויות הגודל ונציג רק מודלים תואמים. בפרקים 05–07 נחבר את המחשב. בפרק 08 נוסיף רמז שלא מניח אבן, ובפרק 09 נוסיף ערכות נושא.

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

מי אחראי על מה באפליקציה?

%% dir: rtl %%
flowchart TB
    xml["XML ופקדי המסך"] <-->|"View Binding"| activity["MainActivity<br/>תיאום המסך והעבודה"]
    activity -->|"עדכון תצוגה"| board["HexBoardView<br/>ציור ותרגום מגע לתא"]
    board -->|"קריאת מצב הלוח"| game["HexGame<br/>גודל, מצב וחוקים"]
    activity -->|"החלת מהלך"| game
    activity -->|"בקשת מהלך או רמז"| ai["HexAi<br/>בחירה בין מהלכים חוקיים"]
    ai -->|"עותק לכל מועמד"| game
    ai --> contract["ValueModel<br/>הערכת מצב"]
    loader["TfliteValueModel<br/>LiteRT CompiledModel"] -.->|"מממשת"| contract
    catalog["ModelCatalog<br/>קריאת הקטלוג"] --> loader
    catalog --> assets["מודלים בנכסי האפליקציה"]

HexBoardView עובדת עם פיקסלים ומרכזי משושים; HexGame עובדת עם גודל הלוח, התאים והחוקים. MainActivity מחברת את המסך למשחק, ו־HexAi משתמשת בעותקי משחק וב־ValueModel כדי לבחור מהלך. המודל מעריך עמדה; הוא אינו מחזיר תא מוכן.

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

מי עושה מה?

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

בפרק 08 נוסיף רמז למהלך בלי להניח אבן, ובפרק 09 נוסיף צבעי יום ולילה לאותו מסך.

חבילת המודל היחיד לפרק 5 וחבילת המודלים הנוספים לפרק 7 זמינות בקישורים שבפרקים.