资源管理

资源库用于沉淀工作空间素材，让页面、组件、主题、字体注册和 AI 创作可以复用同一批资产。

资源类型

平台资源包括图片、图标、视频、音频、字体、三维模型（GLB）、DrawIO、Mermaid、图表、公式和可编辑内容资源。不同类型的资源会有不同的预览方式、元数据和可引用方式。

音频资源

可上传 MP3、M4A、AAC、OGG 或 WAV，页面可按资源名引用音频。页面旁白与项目 cue 已默认开放；项目 cue 绑定和音量在项目设置的“音频”分区维护。推荐使用 MP3；不同浏览器对其它格式的播放支持可能不同。

三维模型

三维模型资源使用单文件自包含 GLB，上传后在资源详情中可以查看场景、相机和动画数量摘要。页面与组件通过稳定资源名引用模型，并可分别设置每个实例的相机、背景与交互参数；同一模型可以在不同页面、不同实例中使用不同视角。

上传校验同时约束文件大小和模型解码规模：单个 accessor（顶点等数据数组）解码后不超过 64 MiB，所有 accessor 合计不超过 128 MiB；稀疏和零填充数据也按展开后大小计算。

• 替换模型文件使用"替换"入口并以当前文件版本为基线：基线不匹配时会被拒绝，避免覆盖并发修改。
• 替换即全局更新：页面、组件和资源预览（含历史版本预览）都会显示替换后的新模型，不会保留旧模型的冻结视图。
• 正在执行的截图或构建任务使用任务开始时解析到的文件，任务进行中对应文件不会被清理；任务结束后按资源清理规则回收。
• 仍被当前页面或组件引用的模型文件不可删除；如需清理，先解除引用并等待在途任务结束。
• 动态拼接的模型名可以保存，但资源身份不会进入截图缓存；替换后旧截图可能不会自动重截，建议优先使用静态资源名。

可编辑内容资源

可编辑内容资源适合保存 Mermaid、DrawIO、公式、图表配置和结构化文本。相比只上传图片，保留源数据能让后续编辑、AI 修改和再渲染更稳定。

元数据

资源应维护清晰的名称、类型、分组、描述和标签。命名建议体现用途和版本，例如“品牌 Logo 主色版”“季度收入柱状图 v1”。

替换、复制、归档和删除

替换资源前需要确认引用关系。已被页面、组件、主题或字体注册引用的资源，不建议直接删除；如果资源不再使用，优先归档，待确认无引用后再删除。

引用关系

引用关系帮助判断一个资源是否正在被页面、组件、主题或样式使用。批量清理资源前，应先检查引用，避免预览和构建产物缺图、缺字体或缺配置。

与主题、字体和组件的关系

主题可以引用 Logo、项目图标和字体；字体注册依赖字体资源；组件可以把图片、图表和图标作为可复用视觉元素。资源的稳定性会直接影响这些上层对象。

与 AI 协作

AI 可以读取当前范围内的资源摘要，并按用户要求引用或改写资源。需要上传新素材时，先把素材放入资源库，再让 AI 在明确资源名和用途的前提下使用。

使用建议

• 每个工作空间维护统一的资源分组和命名规则。
• 可编辑资源优先保留源数据，不只保存截图。
• 删除或替换前先看引用关系。
• 常用品牌素材、字体和图表配置应沉淀为可复用资源。