AnvilKit

每个 AnvilKit crate 的自动生成 API 文档可在 docs.rs 上查阅。这些页面直接从源代码和文档注释构建，提供完整的类型签名、trait 实现和示例。

Crate 文档

Crate	说明	docs.rs
`anvilkit-core`	核心类型 -- Transform、Time、Timer、Persistence	docs.rs/anvilkit-core
`anvilkit-app`	游戏应用运行器 -- GameCallbacks、调度、状态机、ECS 插件系统	docs.rs/anvilkit-app
`anvilkit-render`	渲染 -- wgpu、Canvas2D、Canvas3D、PBR 管线、帧捕获、transform 层级	docs.rs/anvilkit-render
`anvilkit-assets`	资产管线 -- glTF 加载、动画、MeshData 工厂、AudioAsset、热重载	docs.rs/anvilkit-assets
`anvilkit-audio`	音频 -- AudioSource、AudioBus、空间音频、循环/变调	docs.rs/anvilkit-audio
`anvilkit-input`	输入 -- 键盘、鼠标、手柄、ActionMap、ActionId、AxisBinding	docs.rs/anvilkit-input
`anvilkit-camera`	摄像机系统 -- 5 种模式、OrbitState、SpringArm、CameraRig、trauma 抖动、过渡、轨道、输入曲线	docs.rs/anvilkit-camera
`anvilkit-describe`	AI 优先内省 -- Describe trait 和 derive 宏	docs.rs/anvilkit-describe
`anvilkit-mcp`	MCP 服务器 -- 17 个工具（视觉、控制、状态、场景），供 AI 代理交互	docs.rs/anvilkit-mcp
`anvilkit-gameplay`	游戏性系统 -- Health、Inventory	docs.rs/anvilkit-gameplay
`anvilkit-data`	数据表（RON/JSON）与 i18n 本地化	docs.rs/anvilkit-data
`anvilkit`	总括 crate -- facade、prelude、DefaultPlugins	docs.rs/anvilkit

即时模式 2D 绘图 API，位于 anvilkit_render::renderer::canvas2d。

类型	说明
`Canvas2DRenderer`	2D 渲染的 GPU 资源。在 `init()` 中创建一次。
`Canvas2D`	通过 `Canvas2D::begin()` 获取的每帧绘制上下文。

Canvas2D 方法：clear()、draw_rect()、draw_text()、draw_sprite()、finish()。

场景图 3D API，位于 anvilkit_render::renderer::canvas3d。

类型	说明
`Canvas3DRenderer`	3D 渲染的 GPU 资源。在 `init()` 中创建一次。
`Canvas3D`	通过 `Canvas3D::begin()` 获取的每帧 3D 场景上下文。

Canvas3D 方法：clear()、spawn_mesh()、set_camera()、add_light()、finish()。

Canvas2D 和 Canvas3D 都支持 capture_frame()，返回渲染帧的原始图像字节。这是 AI 优先设计的基础：代理能看到玩家所见。

MCP 服务器提供 17 个工具，分为四个类别：

类别	工具
视觉	`capture_frame`、`describe_scene`、`get_screen_info`
控制	`press_key`、`release_key`、`move_mouse`、`click`、`scroll`
状态	`get_component`、`set_component`、`list_entities`、`get_resource`
场景	`spawn_object`、`despawn_object`、`save_scene`、`load_scene`、`run_system`

在本地生成并查看 API 文档：

cargo doc --workspace --no-deps --open

此命令为工作区中所有 crate 构建文档，并在浏览器中打开。