按功能学习，或直接搜索你现在要完成的任务。每篇说明都包含入口、操作步骤、注意事项和实际案例。
建库 → 导入 → 整理 → 搜索
重点掌握 MCP 配置与安全确认
查看本地、云端与工具插件
新手入门
完成安装、登录、建库和第一次素材导入。
下载并安装 Windows 公测版。启动 Mira 后登录账号。
选择“创建资源库”，把资源库放在空间充足、读写稳定的本地磁盘；继续使用旧库时选择“打开资源库”。
进入目标分类，把文件或完整文件夹拖入主区域。Mira 会保留文件夹层级，并在后台生成缩略图和索引。
导入后可以继续浏览和整理；视频、大型 PSD 与 3D 文件的预览可能稍后出现。
把角色、场景、UI 三个原始文件夹整体拖入，再用标签补充“投放阶段”和“画面风格”，同时保留目录与业务维度。
资源管理
用多个维度组织素材，而不依赖冗长文件名。
在左侧创建分类，用于保存稳定的项目或业务结构；一份素材可以关联多个分类。
在标签管理中建立标签分组和模板，用说明和匹配规则约束 AI 如何选择标签。
多选素材后通过右键菜单批量移动、复制、评分、标记颜色或添加标签。
创建看板并设置筛选规则，把跨目录素材聚合成可重复使用的动态视图。
删除的素材先进入回收站；确认无误后再永久清理。
查找与预览
在大量素材中快速定位需要的画面和文件。
切换网格、自适应、瀑布流或列表模式；使用缩放滑块或 Ctrl + 滚轮调整卡片大小。
搜索框支持名称和拼音；筛选栏可组合类型、标签、评分、颜色等条件。
安装 AI 视觉搜索后，可用自然语言描述画面或从一张素材查找相似内容；首次使用需要等待索引建立。
双击或按 Space 查看大图；选择两份素材后按 Ctrl + Shift + C 对比；右键可转为桌面浮动预览。
输入“红黑色、Boss 对峙、竖版”，再筛选文件类型；从结果中选两份进入对比，检查构图与文案空间。
采集与导入
从网页把图片、视频和音频直接收进当前分类。
在浏览器采集页面下载对应版本，并按说明加载扩展。
保持 Mira 已启动并打开资源库，在 Mira 中选中目标分类。
在网页媒体上右键选择“采集到 Mira”，或在支持的页面直接拖拽采集。
采集后在素材属性中检查来源链接；动态视频需要先播放，浏览器才能取得真实媒体地址。
图片与设计文件
处理常用图片格式，并按需查看大型设计文件。
图片文字识别可批量提取中、英、日、韩文字，并保留文字位置；识别结果可用于搜索。
安装本地抠图或 LaMa 擦除插件后，从素材右键菜单或 AI 画布打开工具，处理结果可保存回资源库。
打开 PSD/PSB 图层面板，搜索并勾选图层进行组合预览，再导出选中层级；大型文件需先安装分层引擎。
图片转换器支持 JPG、PNG、WebP、BMP、TIFF、TGA，可批量设置尺寸、质量和透明背景。
启用 Photoshop 联动后，可从右键菜单批量发送图片和设计文件。
打开图层树，搜索角色名，勾选角色和特效层，用棋盘背景确认透明区域，再保存为新素材。
视频与音频
在本地完成常见视频整理，并生成可编辑字幕。
使用视频片段截取器设置开始和结束位置；精确模式适合卡点，快速模式适合长视频粗剪。
视频格式转换器支持批量文件、分辨率和画质设置，结果可保存到电脑或当前资源库。
本地字幕插件提供智能自动、纯音频和纯视觉三种模式；完成后可校对并导出 SRT。
豆包语音套件支持在线字幕、翻译和音频生成，需要配置 X-Api-Key，调用可能产生费用。
启用 After Effects 联动后，可把选中的图片、视频和音频批量导入当前项目。
3D 工作流
检查模型资产，并与 3ds Max、Unreal Engine 协作。
启用“3D 预览与 DCC / UE 互导”插件后，打开模型进入本地 3D 查看器。
检查网格、材质槽、贴图、透明度和同骨架动作；PSK/PSA 可分别承载模型与动作。
导入散落文件时，先在导入复核中确认模型、动作和贴图归属，再提交后台整理任务。
发送到 3ds Max 时使用随附连接脚本；发送到 Unreal Engine 前先选择项目目录并检测 MiraAssetBridge。
任务中心显示转换、预览和导入状态；失败项目可查看原因后重试。
AI 创作
以资源库素材为参考，搜索、分析并继续生成内容。
在插件中心启用火山方舟创作套件并验证 Ark API Key；音频能力需另外启用豆包语音套件。
从资源库把图片、视频或音频加入画布，也可拖入本地文件作为参考。
在图片、视频、音频或 Agent 模式选择模型与参数，写清目标、主体、风格和输出要求。
资源库 Agent 可查找参考、总结方向并组织任务；批量修改前先检查它准备执行的范围。
生成结果先落在画布中，确认后通过右键菜单保存到当前资源库。
插件中心
区分云端套件、本地模型和内置工具。
打开“插件中心”，按 AI 创作、本地 AI、工具增强查看能力。
云端套件需要填写对应 API Key 并验证；本地 AI 插件首次安装会下载或检测模型。
内置工具通常只需启用；启用后，入口会出现在右键菜单、画布或顶部工具栏。
卸载本地插件只清理对应模型或组件，不删除资源库原始素材和已保存结果。
外部 AI / MCP
让外部 AI 直接、安全地调用 Mira 的资源库能力。
在“插件中心 → 工具增强”启用“外部 AI / MCP”，先点击“测试服务”；看到“协议正常”和工具数量即可继续。
Codex：点击“一键连接”，然后新建 Codex 会话或重启客户端。Mira 会保留其他 MCP 配置。
WorkBuddy：先打开并登录一次，再点击“一键连接”；完全退出并重开，在“连接器管理 → 自定义连接器”中信任 Mira，然后新建会话。
豆包：点击“开启服务”和“连接信息”；在豆包添加自定义 MCP，选择 Streamable HTTP，填入地址和 Authorization 请求头，授权后回到 Mira 测试。
其他客户端：生成 JSON、TOML 或原始命令；也可选择客户端后点击“复制给 AI 自动连接”。
AI 应返回资源库类型、健康状态和匹配素材；若工具未出现，重启 AI 客户端并重新检查 MCP 状态。
外部 AI / MCP
掌握搜索、标签、3D 整理、任务管理和确认流程。
资源读取：library_list / doctor 检查资源库，asset_search 搜索，asset_evidence 获取素材、标签、目录和来源证据。
自动标签：先读取标签表与素材证据，调用 tag_proposal_validate；确认结果后才调用 tag_proposal_apply，并传 confirm=true。
整理导入：先 import_scan，再生成并验证 ImportPlan；确认后提交并持续查询 import_status。团队库执行时来源电脑需保持 Mira 在线。
3D 材质：先 inspect；名称不明确时分析 UV 并查看叠加预览；然后 validate，最后才 apply。UV 形状不能判断贴图通道。
后台任务：task_list / get 查看进度和失败原因；retry、pause、resume、cancel 会改变任务状态。
标签删除或清空、导入提交、材质应用及设置修改都应先预览或验证，再由用户确认执行。
检查分组与归属后，再要求 Agent 用固定 requestId 提交；Mira 在后台导入，任务中心可追踪。
团队协作
通过 NAS 或共享目录维护共同的素材与标签体系。
从资源库菜单创建团队资源库，并选择可靠的 NAS 或局域网共享目录。
成员打开同一团队库后，共享分类、标签、模板和素材记录。
显示只读状态时先检查网络和协调者状态，恢复后再执行写入操作。
缩略图、OCR、视觉索引、转换和外部 Agent 导入统一在任务中心查看。
数据与维护
保护资源库，并快速判断常见故障发生在哪一步。
定期完整备份资源库目录；迁移时先关闭 Mira，复制完整目录，再在新电脑选择“打开资源库”。
缩略图延迟时先看任务中心；大视频、PSD 和 3D 文件通常仍在后台处理。
插件未启用时，检查安装状态、模型是否完整或 API 是否验证通过。
MCP 无工具时先测试服务，再重启外部 AI 并新建会话；豆包还需检查地址和请求头。
问题仍存在时记录操作步骤、素材类型、错误文字和任务状态，再从官网提交反馈。
