Wire engine feature services into game skeleton

BUILD.md

@@ -121,6 +121,8 @@ Switch 版依赖不走 XMake 的桌面包，而是使用 devkitPro 的 portlibs
 - SDL2_ttf
 - GLM
 - zlib
+- HarfBuzz
+- bzip2
 - libnx
 
 ### 2.2 编译 Switch 引擎静态库
@@ -302,6 +304,7 @@ romfs:/assets
 - `Frostbite2DGameSwitch` 可成功编译为 ELF/NRO
 - PC 和 Switch 共用同一套 GLES 300 es shader
 - Windows 游戏目标仍可正常编译和启动
+- devkitPro 当前版本的 `SDL2_ttf` / `freetype` 需要静态链接 `harfbuzz` 和 `bz2`，该链接项已写入 `engine.lua`
 
 ## 3. 常见问题
 
@@ -355,3 +358,13 @@ romfs:/assets/character/male/*.png
 
 旧版本曾只把资源复制到 NRO 旁边，运行时引擎找不到 shader 和纹理，
 会表现为黑屏或没有场景内容。
+
+### 3.5 Switch 链接时报 `hb_*` 或 `BZ2_*` 未定义
+
+这是 devkitPro portlibs 静态库依赖未完整链接。当前 `engine.lua` 已把
+`harfbuzz` 和 `bz2` 加入 Switch 链接列表；如果换机器后再次出现，先确认：
+
+```powershell
+Test-Path C:\devkitPro\portlibs\switch\lib\libharfbuzz.a
+Test-Path C:\devkitPro\portlibs\switch\lib\libbz2.a
+```