单人数字人探盘视频·WorkBuddy蝉镜版
把房源照片、真实空镜和卖点资料制作成一条事实有依据、口播连续、适合竖屏发布的单人探盘视频。
本版本面向不能使用海外服务的房产中介学员。数字人口播必须调用 WorkBuddy 中已经连接并授权的“蝉镜数字人”连接器，不调用 HeyGen，不要求学员提供或接触蝉镜 App ID、Secret Key、Access Token。
成片结构
默认9:16竖屏、中文字幕，总时长通常36—60秒：
- 开头3—8秒：数字人全屏口播，用真实卖点或买房痛点形成钩子。
- 中间约30—45秒：只显示全屏房源空镜，不显示数字人；同一条数字人口播音轨继续讲解。
- 结尾3—8秒：数字人恢复全屏，给出一个明确的咨询或留资行动。
先按完整文案生成一条连续数字人口播，再在中间段用纯房源空镜替换人物画面并保留音轨。不要分别生成互不连续的开头和结尾人物片段。中间段禁止加入数字人小窗、抠像人物或头像贴纸。
读取参考文件
- 写文案前读取 @references/copywriting.md。
- 调用蝉镜前读取 @references/chanjing-connector.md。
- 编排三段时间线前读取 @references/composition.md。
- 导出或宣布完成前读取 @references/quality-check.md。
输入
每套房必需输入：
- 城市、楼盘或小区名；
- 房源照片或真实空镜视频；
- 用户提供的房源或楼盘卖点资料。
推荐输入：目标客户、禁用表述、发布平台、目标时长和片尾引导。
完整出片还需要在 WorkBuddy 中预先连接“蝉镜数字人”，并配置以下经纪人档案：
- 已授权的蝉镜公共或定制数字人ID；
- 与数字人匹配的公共或克隆音色ID；
- 数字人的
figure_type、宽度和高度； - 经纪人称呼、服务区域和常用转化方式。
讲师可以复制 @references/realtor-profile-template.yaml 为每位学员建立配置。模板不包含任何密钥。
连接器负责鉴权。不要要求学员把 App ID、Secret Key、Access Token 粘贴到对话、文案、脚本或技能文件中。
执行模式
- 用户只要文案：交付完整口播稿及事实依据，不提交蝉镜任务。
- 用户要文案和分镜：同时交付画面匹配、三段时间线和空镜需求。
- 用户要制作包但蝉镜连接器不可用：交付事实表、文案、分镜、字幕草案和蝉镜输入清单，明确尚未生成成片。
- 用户要求完整成片且连接器可用：自动推进数字人口播、纯空镜合成、字幕、导出和验收。
提示词、任务ID、处理中状态、只有空镜的版本均不是最终成片。
工作流
1. 建立事实与素材索引
为资料和素材建立：
事实ID｜主张｜来源及日期｜证据状态｜可用表述｜对应素材
素材ID｜文件或区间｜画面主体｜可用时长｜对应事实ID｜限制
把“用户提供”与“已核实”分开。不能从照片推断产权、确定学区资格、隔音、永久无遮挡或真实通勤时间。样板间、同小区其他户型和实际出售房源不能混用。
2. 写完整探盘口播
按“与客户相关、资料可证、画面可见”筛选2—3个核心卖点，写成“开头钩子＋中间卖点讲解＋结尾引导”的连续文案。
先按每秒约3—4个汉字估算，再以蝉镜实际语音时长校正。目标时长默认允许约±5秒；用户要求严格时长时，生成前调整文案，不对成片明显加速或删断结尾。
3. 调用蝉镜生成连续数字人口播
按照 @references/chanjing-connector.md 使用当前 WorkBuddy 环境已经连接的蝉镜工具。不要调用 HeyGen，也不要绕过现有连接器要求学员重新配置开放平台密钥。
优先复用经纪人档案中已验证的数字人和音色。提交付费任务前查询蝉豆余额；余额不足时停止生成并说明，不自动更换人物或音色。
采用已经实测通过的两阶段链路：
- 使用完整文案创建语音合成任务，保存音频任务ID。
- 轮询同一音频任务，取得完整音频URL和真实时长。
- 使用选定数字人＋完整音频创建视频合成任务，保存视频任务ID。
- 轮询同一视频任务直至完成，取得视频URL和时长。
- 立即下载音频和视频到任务目录；蝉镜结果URL不作为长期交付地址。
任务处于等待、处理中或状态不明时，只查询原任务ID，不重新提交。不要因为一次轮询超时重复扣费。
4. 验收蝉镜数字人母版
母版下载后先检查容器、音轨、时长和可解码性，再抽查开头、切换前、结尾恢复后及结束前的多个画面。
重点检查嘴唇、牙齿、下颌、眼睛、眼镜边缘和手部。发现明显口型不同步、嘴部拉伸、脸部漂移或人物闪烁时，先重新生成或更换已验证的蝉镜形象，不进入最终合成。
5. 准备中间纯房源空镜
真实空镜优先。已有真实房源视频时，不调用照片转视频或额外生成服务。
只有照片或素材确实不足时，先用缓慢推近、平移和轻微缩放形成动态展示；仅在用户要求且环境有可用能力时生成补充空镜。不得生成照片以外的房间、门窗、家具、园林或配套。
每个核心卖点都应有对应镜头；没有画面或可靠资料时改稿或删减卖点，不用重复和无关镜头凑时长。
6. 制作三段时间线
依据 @references/composition.md 建立：
镜头ID｜成片起止｜画面模式｜空镜入出点｜口播｜事实ID｜字幕重点
- 开头保留蝉镜数字人全屏和原始口播音轨。
- 中间用房源空镜铺满画面，隐藏数字人视频，只保留同一条口播音轨。
- 结尾撤下空镜，让同一条数字人视频恢复全屏。
切换画面时不重启音频、不复制旁白、不改变音频时间。
7. 本地字幕和后期
字幕根据最终文案和蝉镜实际音频在本地生成、校对和烧录。不要把房源视频、字幕或成片重新上传蝉镜；蝉镜仅负责本次流程中的语音与数字人口播生成。
使用 WorkBuddy 环境现有的本地视频工具完成画面替换、缩放、字幕、混音和导出。空镜中的无关人声或音乐默认移除；需要环境声时低音量保留，数字人口播始终是主声音。
8. 验收并交付
执行 @references/quality-check.md。只有最终MP4完整解码、实际播放检查通过后才能宣布完成。
默认交付：
- 最终探盘MP4；
- 最终口播文案；
- SRT字幕；
- 简短制作记录；
- 工具支持时提供可编辑项目。
失败处理
- 连接器未安装或未授权：停止蝉镜生成，说明需要在 WorkBuddy 启用“蝉镜数字人”连接器；继续完成文案和分镜。
- 蝉豆不足：停止新的付费任务，保留已有成果，不自动换服务。
- 音频任务未完成：按原任务ID继续查询，不重复创建。
- 视频任务未完成：按原任务ID继续查询，不重复创建。
- 数字人或音色ID失效：重新列出当前账号可用资源，让用户或讲师选择，不编造ID。
- 下载中断：使用同一结果URL续传并校验文件完整性。
- 中间段误留人物：移除人物视频层，只保留连续音轨和全屏房源空镜。
存储
每套房使用独立目录。优先沿用 WorkBuddy 当前工作区；可以配置路径时采用：
D:\WorkBuddy文件\日期-房源名称-数字人探盘\
work\ 素材副本、事实表、分镜、任务状态、数字人母版和空镜
outputs\ 最终MP4、SRT、口播文案和制作记录
不覆盖用户原始素材，不把连接器凭据写入任务目录。
