成交资料全流程更新
每次启动处理的是同一套成交档案的完整更新，不能只做图片或只补文案后报完成。一次交付包含：内部成交文案、按成交金额降序排列的一张封面总览、供达人使用的完整 Word 稿。用户明确指定只检查或单项修改时按当次范围执行，并说明未运行其余步骤。
配置与启动
先读个人配置 ~/.config/yl-toolbox/profile.json 及 personal_instructions，取 sales_content_refresh.config_file；也接受用户指定配置。首次配置见 配置与交付清单。通用核心不保存账户、私人目录、真实标题、模板或媒体。没有定时器、目录监听、群消息读取或自动外发。
- 运行
scripts/workflow.py scan --config <配置> --out <本轮scan.json>，以 SHA-256 与上次完整交付基线比较。新增、同名变更、移动/重复、缺失分别列出。即使无新截图，也核对三项交付，补齐上一轮漏掉的达人稿等；扫描零新增不等于完成。 - 逐张读取新增/变更截图，记录画面日期、统计区间、视频身份、金额、商品及封面；OCR 只辅助。文件夹名和写入时间不能当作业务日期。全店、商品或渠道总额不能分摊到视频。多个窗口不相加，不因新窗口不再出现而移除历史有成交视频。
- 匹配以发布ID优先；没有ID时使用账号＋发布时间＋封面及完整正文交叉确认，分清同文重发。只见标题不能编正文；无法唯一匹配的留入待核清单，不阻塞其他已核项目，也不宣称全量完成。金额未知但成交已证实的可纳入，金额留空；0元记录不当成交证据。退款与实际净额按原标签分别记录。
- 补齐内部文案：复用现存正式平台校订稿/本人完整原文；保留原话、原思路及听辨不清标记，不调用通用写作风格。标题下分开列小店和视频号数据，缺指标写“未补录”，保留真实采集日期。已有正文保持，新增观察追加可追溯来源，避免把不同窗口覆盖成无出处的累计金额。
- 同步封面总览：使用同一全量清单，复用已发布真实封面或截图内封面，不用重剪版封面冒充历史封面。按有依据的成交金额从大到小、左到右上到下排列；相同金额保留上一版相对顺序；未知金额置后且不写金额。明确各卡金额区间，按实际条数自适应网格，不能写死条数。保存一张可直接查看的PNG，检查全文、裁切和金额映射。
- 同步达人稿：先读上一版模板及完整正文，保持其目录、指标表、字体、页码和每篇独立起页。只输出标题、真实视频号表现和完整文案；排除成交金额、千次成交、小店播放、商品成交明细、内部说明、证据路径及客户信息。保留影响引用的原文不确定标记。达人稿默认沿用原目录顺序，新稿按发布时间插入；图片降序不自动改变达人稿顺序。不得用小店播放替代视频号播放。见 达人稿与验收。
- 真正新增知识正文交
yl-knowledge完整处理；已有校订源及蒸馏记录只建立关联，不能重复蒸馏。指标回流遵循yl-knowledge-review-sync；仅成交增量不可调用全量排名刷新器覆盖其他作品。无需为本任务额外开启实时平台采集。 - 渲染Word并检查所有页、目录页码及正文完整，检查汇总PNG；产出审查清单及交付manifest。运行
scripts/workflow.py verify --manifest <交付manifest> --out <verification.json>。该检查是机器一致性检查，不代替视觉和语义判断。 - 所有项目已核且三项交付一致后，用
scripts/workflow.py commit --config <配置> --scan <scan.json> --manifest <manifest> --verification <verification.json>更新成功基线。命令会复查源文件和交付哈希，不能提前把只扫描过的文件标为已完成。保留失败/待核状态，下次继续。
交付状态
先给新增/更新数、三项最终文件位置，再简述未解决项。三个状态分别报告；只有全部通过才说“整套已更新”。有证据支持的历史清单不等于账号所有历史成交。若无变化且现有三份都一致，复核后复用，不堆重复版本。被替换的最终成果保留上一可恢复版；不更改原始截图，不清理无关历史。
SkillHub 独立安装
运行前先读 安装与依赖说明。本包不会自动安装同级依赖；缺少必需成员或外部工具时停止相应分支并列明待办，不能跳过原流程而报告完成。
