完善客户端功能并加入40250一致性审计

2026-09-21 16:38:58 -07:00
parent 3eb001a1fd
commit 1522a8a1a1
22 changed files with 876 additions and 105 deletions
@@ -0,0 +1,49 @@
+# Project map
+
+## Reference client
+
+- Root: `../40250/Server Client TMP4/ClientVS22/source`
+- High-level game and packet flow: `UserInterface`
+- actors, motion, maps, flying objects: `GameLib`
+- rendering, input, collision primitives: `EterLib`
+- effects: `EffectLib`
+- Granny integration: `EterGrnLib`
+- audio: `MilesLib`
+- terrain: `PRTerrainLib`
+
+Use the Visual Studio project and active preprocessor flags to distinguish reachable product code from disabled, obsolete, and third-party code.
+
+## Current client
+
+- GDScript runtime and tests: `project/`
+- native extension: `extension/`
+- format readers: `formats/`
+- shared/native libraries: `libgr2/`
+- extracted assets and tables: `assets/`
+- numerical reference oracle: `oracle/`
+- host-side tools: `tools/`
+
+## Existing evidence
+
+- `docs/CLIENT-GAP.md`: historical broad gap analysis; migrate useful claims into contracts rather than trusting status text.
+- `docs/CLIENT-PARITY-AUDIT-AND-FIX-GUIDE.md`: existing methodology and high-risk domains.
+- `docs/CLIENT-40250-PORT.md`: porting context.
+- `docs/PARITY-GAP.md`: visual/rendering gap notes.
+- `oracle/run-diff-suite.sh`: Granny numerical comparison suite.
+- `project/test_*_parity.gd` and `project/*_test.gd`: existing tests; inspect assertions before treating them as evidence.
+
+## Typical verification commands
+
+Run a narrow Godot test with:
+
+```bash
+godot --headless --path project --script project/test_name.gd
+```
+
+Some scripts expect the path relative to `project/` instead:
+
+```bash
+godot --headless --path project --script test_name.gd
+```
+
+Follow the convention already used by the selected test. Always finish code changes with `git diff --check`.