docs: sync api and planning docs

docs/api/XCEngine/Scripting/ScriptEngine/TryGetAvailableScriptClasses.md

@@ -21,15 +21,35 @@ bool TryGetAvailableScriptClasses(
 ## 当前实现流程
 
 1. 清空 `outClasses`。
-2. 调用运行时 `TryGetAvailableScriptClasses()`。
-3. 若传入了 `assemblyName`，只保留匹配该程序集的类。
-4. 过滤掉 `className` 为空的无效描述。
-5. 按 `assemblyName -> namespaceName -> className` 排序。
+2. 调用当前运行时的 `TryGetAvailableScriptClasses(runtimeClasses)`。
+3. 如果运行时返回 `false`，直接返回 `false`。
+4. 若传入了 `assemblyName`，只保留匹配该程序集的条目。
+5. 过滤掉 `className` 为空的无效描述。
+6. 按 `assemblyName -> namespaceName -> className` 排序。
+7. 返回 `true`。
+
+## 关键语义
+
+- 这个方法消费的是“运行时已经发现好的类列表”，不会在这里重新扫描程序集，也不会为结果做实例创建验证。
+- 如果运行时能提供列表，但过滤后一个类都不剩，当前仍返回 `true`，只是 `outClasses` 为空。
+- 这一步的排序是给 Inspector / 脚本类选择 UI 做稳定输出用的；调用方不需要再按自己的规则重排一遍。
+- 当前 `MonoScriptRuntime` 本身也会返回排序后的列表，但 `ScriptEngine` 仍然会再做一层规范化，这样换后端时对上层 UI 的输出形态更稳定。
 
 ## 返回值语义
 
-- 返回 `true`：运行时支持类发现，排序/过滤后的结果可用。
-- 返回 `false`：运行时不支持或当前不能返回类列表。
+- 返回 `true`: 运行时支持类发现，排序 / 过滤后的结果可用。
+- 返回 `false`: 运行时不支持，或当前不能返回类列表。
+
+## 典型用途
+
+- Inspector 中的脚本类下拉列表。
+- 运行时或编辑器中的脚本类过滤器。
+- 需要显示 `Namespace.Class` 稳定排序结果的调试面板。
+
+## 真实行为依据
+
+- `engine/src/Scripting/ScriptEngine.cpp`
+- `tests/Scripting/test_script_engine.cpp`
 
 ## 相关文档