docs(scripting): add baseline api reference and guide

docs/api/XCEngine/Scripting/Mono/MonoScriptRuntime/MonoScriptRuntime.md

@@ -0,0 +1,86 @@
+# MonoScriptRuntime
+
+**命名空间**: `XCEngine::Scripting`
+
+**类型**: `class`
+
+**头文件**: `XCEngine/Scripting/Mono/MonoScriptRuntime.h`
+
+**描述**: 基于 Mono 的脚本运行时实现，负责程序集加载、类发现、实例创建、internal call 桥接和生命周期调用。
+
+## 概览
+
+`MonoScriptRuntime` 是当前唯一的真实托管脚本后端。它把 `ScriptEngine` 提供的抽象调用翻译成 Mono 世界里的具体动作：
+
+- 初始化 root domain 和 app domain。
+- 加载脚本核心程序集与游戏程序集。
+- 发现继承 `MonoBehaviour` 的可用脚本类。
+- 构建类元数据缓存。
+- 创建和销毁脚本实例。
+- 通过 internal call 让托管脚本访问原生 `GameObject`、`Transform`、`Camera` 等能力。
+
+## 生命周期
+
+- 构造时接收一份 `Settings`，并做路径补全。
+- [Initialize](Initialize.md) 会完成完整 Mono 初始化流程。
+- [Shutdown](Shutdown.md) 会销毁 app domain、清空类缓存与实例缓存。
+- 析构会自动调用 `Shutdown()`。
+
+## 常用访问器
+
+- `IsInitialized()`
+- `GetSettings()`
+- `GetLastError()`
+
+这些访问器主要用于测试、诊断和工具层。当前文档对 `GetLastError()` 单独补页，因为它直接关系到失败排查。
+
+## 设计要点
+
+- `ScriptEngine` 不直接碰 Mono API；所有后端细节收敛在这个类里。
+- 类缓存和实例缓存都基于稳定键，便于场景重建和脚本回绑。
+- internal call 注册集中在本实现里，说明当前托管 API 面是围绕 Mono 后端组织的，而不是独立脚本 ABI。
+
+## 当前实现边界
+
+- 当前只发现应用程序集中的非抽象 `MonoBehaviour` 子类。
+- 支持的公共字段类型只覆盖 `float / double / bool / int32 / uint64 / string / Vector2 / Vector3 / Vector4 / GameObject`。
+- `SyncManagedFieldsToStorage()` 只会回写已经存在于 `ScriptFieldStorage` 中的字段；运行时临时字段不会自动持久化。
+- `OnRuntimeStop()` 只清理当前活动场景与实例，不会做完整 `Shutdown()`。
+
+## 公开方法
+
+| 方法 | 说明 |
+|------|------|
+| [Constructor](Constructor.md) | 创建 Mono 运行时对象并解析设置。 |
+| [Destructor](Destructor.md) | 析构时执行 `Shutdown()`。 |
+| [Initialize](Initialize.md) | 初始化 Mono 域并发现脚本类。 |
+| [Shutdown](Shutdown.md) | 关闭当前 Mono 运行时。 |
+| [GetLastError](GetLastError.md) | 读取最近一次错误描述。 |
+| [IsClassAvailable](IsClassAvailable.md) | 查询脚本类是否已发现。 |
+| [GetScriptClassNames](GetScriptClassNames.md) | 返回已发现脚本类名列表。 |
+| [TryGetClassFieldMetadata](TryGetClassFieldMetadata.md) | 读取脚本类字段元数据。 |
+| [HasManagedInstance](HasManagedInstance.md) | 判断某脚本组件是否已有托管实例。 |
+| [GetManagedInstanceCount](GetManagedInstanceCount.md) | 返回当前托管实例数。 |
+| [GetManagedInstanceObject](GetManagedInstanceObject.md) | 读取托管对象裸指针。 |
+| [CreateManagedComponentWrapper](CreateManagedComponentWrapper.md) | 为原生组件创建托管包装对象。 |
+| [TryGetFieldValue](TryGetFieldValue.md) | 直接读取托管实例字段。 |
+| [OnRuntimeStart](OnRuntimeStart.md) | 启动脚本运行时上下文。 |
+| [OnRuntimeStop](OnRuntimeStop.md) | 停止当前运行场景的托管上下文。 |
+| [TrySetManagedFieldValue](TrySetManagedFieldValue.md) | 写托管字段。 |
+| [TryGetManagedFieldValue](TryGetManagedFieldValue.md) | 读托管字段。 |
+| [SyncManagedFieldsToStorage](SyncManagedFieldsToStorage.md) | 回写本地字段缓存。 |
+| [CreateScriptInstance](CreateScriptInstance.md) | 创建脚本实例。 |
+| [DestroyScriptInstance](DestroyScriptInstance.md) | 销毁脚本实例。 |
+| [InvokeMethod](InvokeMethod.md) | 调用生命周期方法。 |
+
+## 真实行为依据
+
+- `engine/src/Scripting/Mono/MonoScriptRuntime.cpp`
+- `tests/scripting/test_mono_script_runtime.cpp`
+
+## 相关文档
+
+- [Mono](../Mono.md)
+- [IScriptRuntime](../../IScriptRuntime/IScriptRuntime.md)
+- [ScriptEngine](../../ScriptEngine/ScriptEngine.md)
+- [Scripting Runtime And Field Model](../../../../_guides/Scripting/Scripting-Runtime-And-Field-Model.md)