docs(scripting): add baseline api reference and guide

docs/api/XCEngine/Scripting/IScriptRuntime/IScriptRuntime.md

@@ -0,0 +1,71 @@
+# IScriptRuntime
+
+**命名空间**: `XCEngine::Scripting`
+
+**类型**: `class (abstract)`
+
+**头文件**: `XCEngine/Scripting/IScriptRuntime.h`
+
+**描述**: 定义引擎脚本调度层与具体脚本后端之间的统一契约。
+
+## 概览
+
+`IScriptRuntime` 是 `ScriptEngine` 唯一应该依赖的脚本后端接口。它把脚本后端抽象成三类能力：
+
+- 运行时启停。
+- 托管类/字段元数据查询与字段读写。
+- 脚本实例创建销毁与生命周期方法调用。
+
+这种设计让 `ScriptEngine` 能专注于“调度”，而把 Mono、GCHandle、程序集加载这些实现细节留给具体后端。
+
+## 公开概念
+
+### ScriptLifecycleMethod
+
+当前生命周期枚举值为：
+
+- `Awake`
+- `OnEnable`
+- `Start`
+- `FixedUpdate`
+- `Update`
+- `LateUpdate`
+- `OnDisable`
+- `OnDestroy`
+
+### ScriptRuntimeContext
+
+`ScriptRuntimeContext` 是后端执行脚本实例时的最小上下文：
+
+| 字段 | 说明 |
+|------|------|
+| `scene` | 当前运行场景。 |
+| `gameObject` | 当前脚本所属对象。 |
+| `component` | 当前脚本组件。 |
+| `gameObjectUUID` | 原生对象 UUID。 |
+| `scriptComponentUUID` | 脚本组件 UUID。 |
+
+## 线程语义
+
+- 接口本身不承诺线程安全。
+- 当前引擎默认由主线程按固定时序调用这些方法。
+
+## 公开方法
+
+| 方法 | 说明 |
+|------|------|
+| [OnRuntimeStart](OnRuntimeStart.md) | 运行时开始时的后端入口。 |
+| [OnRuntimeStop](OnRuntimeStop.md) | 运行时停止时的后端入口。 |
+| [TryGetClassFieldMetadata](TryGetClassFieldMetadata.md) | 查询脚本类字段元数据。 |
+| [TrySetManagedFieldValue](TrySetManagedFieldValue.md) | 向托管实例写字段。 |
+| [TryGetManagedFieldValue](TryGetManagedFieldValue.md) | 从托管实例读字段。 |
+| [SyncManagedFieldsToStorage](SyncManagedFieldsToStorage.md) | 把托管字段同步回本地存储。 |
+| [CreateScriptInstance](CreateScriptInstance.md) | 创建脚本实例。 |
+| [DestroyScriptInstance](DestroyScriptInstance.md) | 销毁脚本实例。 |
+| [InvokeMethod](InvokeMethod.md) | 调用生命周期方法。 |
+
+## 相关文档
+
+- [ScriptEngine](../ScriptEngine/ScriptEngine.md)
+- [NullScriptRuntime](../NullScriptRuntime/NullScriptRuntime.md)
+- [MonoScriptRuntime](../Mono/MonoScriptRuntime/MonoScriptRuntime.md)