GaCy-GO/tools/AI TOOLBOX/MEMORY.md

AI TOOLBOX - Project Long-Term Memory

Project Overview

Honkai Star Rail Game Server (.NET / C# and Rust Architecture & Protocol Simulation).

Core Directives & User Preferences

1. Approval Automation: Group tasks into single automated commands or use subagents; avoid asking repetitive approval prompts.
2. FreeCam System: Preserve live-reloading of scripts/freecam.lua via PlayerHeartBeatScRsp.download_data (CmdID: 62). Maintain user's exact controls and rainbow watermark.
3. Challenge Unlocks: Keep stages unlocked (hgpkmhfpmbj: true / is_unlock: true) across Forgotten Hall (Jarilo-VI 15, Xianzhou Luofu 6), MoC (12 floors), Pure Fiction (4 stages), and Apocalyptic Shadow (4 difficulties).
4. Hotfix Sync: Hotfix URLs are stored in versions.json. SDK server delivers hotfix payloads for target client versions (e.g. OSBETAWin4.5.51, OSBETAWin4.5.52, CNBETAWin4.3.51..55).
5. No Code Overwrites: Never blindly wipe or revert user source code without explicit verification.
6. External Reference: https://git.neonteam.dev/amizing/robinsr (Third-party repo used only as an external reference to inspect when game updates break server compatibility).
7. No Vanity / Slop Logs: Never output fake or vanity console logs pretending handlers or systems are registered/functional when they are placeholders. Only log real operations that actually execute.
8. Dimbreath Game Data: https://gitlab.com/Dimbreath/turnbasedgamedata (Primary source for exact game tables: ExcelOutput, ChallengeMazeConfig, stages, etc.).
9. Daily Memory Logging (Continuous): Maintain daily logs in tools/AI TOOLBOX/memory/YYYY-MM-DD.md. Update this file continuously throughout active sessions to ensure all technical discoveries, reverse engineering findings, and architectural shifts are persistently saved across chat resets.
10. Open Source & Mod-Friendly Data: Do NOT compress or pack game tables into opaque binary blobs like March7th's Resource.bin. Keep resources open, transparent, and moddable in standard JSON directories (resources/Config, ExcelOutput, TextMap).
11. MhyKcp Protocol (28-byte Header): HoYoverse games modify standard KCP by inserting a 4-byte token after conv: conv(4) + token(4) + cmd(1) + frg(1) + wnd(2) + ts(4) + sn(4) + una(4) + len(4) (Little-Endian). Standard KCP libraries cannot read this; use the native C# MhyKcp.cs.
12. Login Security (login_random): In PlayerLoginCsReq (CmdId: 34), client sends a 64-bit random number (login_random, Tag 6). The server MUST echo this exact value in PlayerLoginScRsp (CmdId: 25, Tag 14). Failing to do so triggers Error 1001_3.
13. Dispatch HTTP Server: Must use ASP.NET Core Kestrel on port 21000 to prevent raw TCP StreamReader buffer hangs (which triggers Error 1001_1).
14. MoC & Endgame Unlock Protocol:
    • MoC floors 11–12 require matching actual RewardIDs in ChallengeHistoryMaxLevel.reward_display_type (101201..=101212 for level 12).
    • Apocalyptic Shadow tab requires active schedule in GetActivityScheduleConfigScRsp (CmdID: 2616) with panel_id: 21001 and activity_id: 21001..=21030.
    • Total challenge stages: 790 stages across 101 groups.
15. Exact Command IDs (4.5.52):
    • PlayerGetToken: CsReq: 60 -> ScRsp: 16
    • PlayerLogin: CsReq: 34 -> ScRsp: 25
    • PlayerLoginFinish: CsReq: 87 -> ScRsp: 63
    • PlayerHeartBeat: CsReq: 44 -> ScRsp: 62
    • GetCurSceneInfo: CsReq: 1458 -> ScRsp: 1456
    • GetChallenge: CsReq: 1734 -> ScRsp: 1725
    • GetCurChallenge: CsReq: 1715 -> ScRsp: 1742
    • GetBasicInfo: CsReq: 80 -> ScRsp: 67
    • GetActivityScheduleConfig: CsReq: 2625 -> ScRsp: 2616
16. Dependency & Pip Installation Tracking:
    • Whenever any script, tool, or component requires installing packages via pip install, ALWAYS record the package and its version in requirements.txt and note it in tools/AI TOOLBOX/memory/YYYY-MM-DD.md.
    • This ensures friends or other users who receive the project can simply run pip install -r requirements.txt and execute all scripts/tools without encountering missing module errors.
17. Skill & Knowledge Crystallization:
    • Whenever a complex protocol mechanism, reverse engineering pattern, build pipeline, or operational workflow is solved, ALWAYS immediately create/update a dedicated Skill in tools/AI TOOLBOX/skills/<skill-name>/SKILL.md and write the exact findings into memory.
    • Never rely on memory alone or re-search from scratch in subsequent sessions; consult and maintain the skill library first.
18. Primary Server is Now Go (C:/Users/Phitchayut/Desktop/GaC-hkrpg-go): As of 2026-10-07 the active server is the Go port (commit 59ea97b). The Rust GaC-hkrpg-ps code drifted out of sync with its own proto (old message names like PveBattleResultCsReq/GateServer no longer exist in 4.6.51 proto) - treat Rust as reference only. Data files (freesr-data.json, persistent, res.json, teleports.json, challenge_data.json, mission_unlocks.json, versions.json) are shared between both.
19. SceneCastSkill Camera Fix (solved): Never reply battle_info/monster_battle_info for hit targets that are not real scene monsters. The server tracks real monster entities per session (Session.MonsterEntities in internal/gameserver/handlers_battle.go); attacking props/NPCs/player avatars must return retcode 0 with NO battle, or the client's battle camera detaches from the character.
20. Skill File Single Source: The living lessons doc is SKILL.md at each repo root; a synced copy lives in tools/AI TOOLBOX/skills/hkrpg-ps-version-update/SKILL.md. Update the root file first, then copy to the toolbox (both projects). Session-scoped prompt docs (HANDOFF/PROMPT/GLM_FIX_PROMPT) were deleted 2026-10-07 - do not recreate them; extend SKILL.md instead.