facemini-脚本专家

用户使用教程 · 完整使用指南

文档版本：v2.1.7 ｜研发归属：facemini 公司自主研发

本文档面向首次拿到本技能包的用户，完整覆盖：包内容 → 安装 → 环境确认 → 日常使用 → 常见问题。全程预计 3~5 分钟即可完成并开始使用。

一、这是什么？

facemini-脚本专家 是 facemini 公司自主研发的一款 AI 视频脚本与提示词创作专家技能，安装到 AI 助手后：

🎬 帮你写出电影级的 AI 视频提示词（支持 Seedance 2.0 等主流视频生成平台）
🧠 内置导演思维方法论：四层结构法、@素材绑定语法、黄金公式、反模式检查
🔧 内置 20+ 场景问题诊断：视频效果不好时，帮你找出原因并给出修复方案
📦 内置 8 大实战模板：电商、治愈、科幻、美食、运动、音乐、情感、古风，直接套用
⚡ 零依赖开箱即用：无需安装任何运行环境，装完就能用

二、压缩包内容清单

解压后得到：

facemini-脚本专家/
├── README.md                     ← 包说明
├── 用户使用教程.md                ← 你正在看的这份
├── 技术文档.md                    ← 技术文档（AI 助手安装与配置依据）
├── SKILL.md                      ← 技能定义（AI 助手读取的入口）
├── _meta.json                    ← 技能元信息
├── _icon.png                     ← 技能图标
├── references/
│   ├── latest_updates.md         ← 最新知识库内容
│   └── update_log.md             ← 更新历史记录
├── assets/
│   └── templates/                ← 提示词模板资产
└── scripts/
    └── update_knowledge.py       ← 知识库更新脚本（可选，普通用户无需使用）

💡 收到的是 zip 压缩包时，请先解压；把 facemini-脚本专家 整个文件夹（含里面所有文件）复制到技能目录即可。

三、环境要求（安装前请确认）

项目	要求
操作系统	Windows 10/11、macOS 12+、主流 Linux 发行版
AI 助手	已安装并正常登录
运行环境	无需任何额外环境（本技能纯文档型，零依赖）
联网	不需要（知识库已内置随包分发）
可选：Python	仅当需要更新知识库时，需 Python 3.8+（详见技术文档第 7 章）

✅ 本技能不需要安装 Python、不需要配置环境变量、不需要 API Key，装完即用。

四、安装到 AI 助手（两种方式任选）

方式 A：复制到技能目录（推荐）

打开本机用户目录下的技能文件夹：
- Windows：C:\Users\<你的用户名>\.workbuddy\skills\
- macOS / Linux：~/.workbuddy/skills/
把 facemini-脚本专家 整个文件夹复制进去。
最终结构应为：C:\Users\<你的用户名>\.workbuddy\skills\facemini-脚本专家\SKILL.md

方式 B：对话导入（最简单）

把 facemini-脚本专家 整个文件夹压缩打包（zip 格式）。
将压缩包直接复制粘贴到 AI 助手的对话框输入框（可拖拽文件，或点输入框左侧「+」选择文件）。
发送这句话：

「把这个 skills 导入进去」
AI 助手会自动识别并完成技能导入。

如何确认安装成功？

重启 AI 助手后，在对话中提到「写视频提示词」，或查看技能列表，若出现 facemini-脚本专家 即安装成功。

五、环境确认（重点，但很简单）

安装完成后无需任何手动配置。AI 助手首次调用本技能时，会依据技能包内《技术文档.md》自动完成环境确认（确认技能文件完整、知识库存在），全程自动，几秒钟完成。

如果你只是想自己确认一下，可以检查技能文件夹内是否包含：SKILL.md、技术文档.md、references/、assets/ 四个核心内容，都在即就绪。

六、日常使用

6.1 写视频提示词（核心功能）

在 AI 助手中直接说，例如：

你想做什么	对话示例
写一个完整提示词	「用 Seedance 2.0 写一个日式动漫风格的战斗场景提示词」
写分镜脚本	「帮我写一个 20 秒的美食短视频分镜脚本，每个镜头一段提示词」
指定参数	「竖屏 9:16，Q版3D风格，15 秒，夏日冰淇淋主题，两个角色互动」
绑定参考图	「@图片1 作为主角，保持角色外观一致，写一个开场镜头」

AI 会按照「技术地基 → 空间搭建 → 光影设计 → 运动编排」四层结构，输出可直接复制使用的提示词，每镜独立成段。

6.2 诊断视频问题（进阶功能）

视频生成效果不好时，直接描述现象：

现象	示例
人物不一致	「生成的角色脸每次都变，怎么修？」
运镜混乱	「镜头乱晃，没有电影感」
动作僵硬	「人物像蜡像一样不会动」
背景糊	「背景糊成一团」

AI 会按诊断表给出原因、修复指令和止损边界（比如：换参考图、简化运动、加负向提示）。

6.3 套用模板（快捷功能）

直接说场景名即可套用内置模板：

「用电商产品模板写一个手表展示」
「用治愈系模板写一个雨天喝咖啡的镜头」
「用古风模板写一个撑伞场景」

内置 8 大模板：电商产品展示 / 社交媒体治愈系 / 科幻史诗 / 美食特写 / 运动动作 / 音乐舞蹈 / 情感叙事 / 中国风古风。

6.4 更新知识库（可选，普通用户可跳过）

本技能知识库随包内置，无需更新即可使用。研发团队发布新资料后，可执行技能包内 scripts/update_knowledge.py 一键归档（需 Python 3.8+，仅标准库）。

七、常见问题（FAQ）

Q1：装好后 AI 助手不识别？ 确认技能文件夹放入了正确的技能目录，且结构为 <技能目录>\facemini-脚本专家\SKILL.md；重启 AI 助手后再试。

Q2：需要装 Python 吗？ 不需要。本技能纯文档型、零依赖，只有研发人员更新知识库时才需要 Python。

Q3：写出来的提示词效果不好？ 把现象（人物变形/镜头乱/动作僵等）告诉 AI 助手，用「诊断」功能定位问题；也可以检查是否同时混用了多种风格（如 3D + 2D 混写）。

Q4：生成的视频人物总变脸？ 提示词里要显式 @ 绑定参考图并声明「保持外观一致」；人物特写超过 3 秒也容易变形，建议分段生成。

Q5：可以生成多长视频？ 单镜头建议 4~15 秒最稳定；60 秒长视频请按镜头拆分，每镜单独生成后剪辑拼接。

Q6：需要联网吗？ 不需要。知识库已内置，离线可用。

Q7：想卸载技能？ 删除已复制的 facemini-脚本专家 文件夹即可，无残留。

八、技术支持与反馈

本技能包由 facemini 公司 自主研发与维护
技术原理与安装细节见技能包内《技术文档.md》
使用中遇到问题，或希望新增模板/功能（如更多场景模板、批量脚本生成），请联系 facemini 研发团队

本文档由 facemini 公司编写，未经授权不得外传。

脚本专家

产品介绍