本地素材需解析完成（显示绿色对勾）才可检索，支持三种调用方式：新建项目时勾选、分镜规划中手动选取时间点、自然语言指令锁定；上传前应粗剪并命名核心片段，JSON中补全queries字段（用具体中文短语），并用avoid字段排除干扰项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在花生AI里快速找到已上传的本地视频素材，而不是每次都要重新上传或翻找文件夹，这就需要掌握它的本地素材检索逻辑——它不靠文件名模糊匹配，而是依赖解析时生成的结构化标签和你输入的关键词语义映射。
确认素材已完成智能解析
只有状态显示为「解析完成」的素材才能被检索到。上传后若仍显示「智能解析中」或「解析失败」，检索框里不会出现该素材，哪怕文件名里含关键词也搜不到。
解析失败常见原因是视频格式不受支持（如 AV1 编码的 MP4）或单个文件超过 2 小时时长限制。遇到失败提示时，用剪映或 VLC 先转成 H.264+AAC 编码的 MP4 再重传。
解析完成后，素材会自动进入【资产】→【本地素材】列表，右上角显示绿色对勾图标【解析完成才可参与后续所有分镜匹配】。
在创作中调用本地素材的三种方式
方法一：创建项目时直接勾选
进入「新建项目」→ 输入文案或上传音频 → 在「选择素材来源」页，点击「本地素材」标签 → 勾选一个或多个已解析完成的视频 → 点击「继续」。系统将优先从这些视频中按时间戳切片匹配分镜。
方法二：在分镜规划环节手动指定
项目创建后进入「规划书」页面 → 找到某一分镜右侧的「画面来源」下拉菜单 → 选择「本地素材」→ 弹出已解析素材列表 → 点击目标视频缩略图 → 拖动时间轴选取起始帧 → 点击「确认选取」。这一步能精准控制画面切入位置，适合需要卡点镜头的历史解说类内容。
方法三：用自然语言指令强制锁定
在「规划书」或「创作偏好」文本框中输入明确提示词，例如：“全部使用本地素材”“只用《敦煌壁画实拍》第3段至第7段”“避免云端MG动画，全部用本地素材中的特写镜头”。AI会据此压制云端检索权重，把匹配范围收缩到你指定的视频片段内。
提高本地素材命中率的关键操作
第一步：上传前做粗剪
单个本地视频最长支持 2 小时，但实际使用中，未剪辑的原始素材（如整场赛事录像、全天会议录制）会导致解析标签过于稀疏——人物、场景、动作信息混杂，AI无法准确锚定“骑兵冲锋”“青铜器铭文特写”这类高精度画面。建议上传前用剪映裁出 3～5 个核心片段，分别命名上传，比如《秦代军阵_行进》《西周青铜器_内壁铭文》。
第二步：在分镜JSON中补全queries字段
如果你导出并编辑了分镜JSON（如文物类项目），务必在每个segment.visual.queries数组里写明具体检索词，格式必须是中文短语组合，例如["敦煌莫高窟 第220窟 初唐壁画","飞天 乐器反弹 线描特写"]。不要写“好看”“高清”“古代”，这些词不会触发本地素材的语义标签匹配。
第三步：善用avoid负向约束
在分镜JSON的visual.avoid字段中填入排除项，例如["现代人出镜","字幕遮挡画面","水印","横屏拍摄"]。这能过滤掉解析时误标的时间段，尤其适用于从纪录片中截取的带台标素材。
