视频成果归档与冗余清理
属于 yl-media → yl-video，也可直接调用。读取 个人配置约定 和本次相关个人规则；复用当前批次、已确定版本和授权，不重新选择剪辑模式。
范围与原则
- 归档的目的是减少冗余、让成果和来源好对应好查找。优先沿用已有成品根目录，不另建一套成品根目录或独立母带归档根目录；具体名称从个人配置和本次指令取得。
- 只归档本次指定材料；“改完归档”先完成明确修改，再归档。仅问状态时只读核对。归档不触发重新剪辑、编码、增强、云端入库或发布。
- 用户要求归档已完成的视频，视为本批定稿，并默认授权最终文稿的本地入库、蒸馏、语义去重、表达资产、关系与检索更新。这是同一次归档的完成条件，不等待另一次“入库”指令；用户当次明确只归档媒体或不入库时遵从并记录。定稿不改变原话归属、转写校对或人工听审的证据等级。
- 路径与保留要求来自当前任务和个人配置，本轮指令优先。本批自产且已无依赖的临时副本、未采用候选导出和可再生缓存，验收后默认自动清理，不依赖个人约定或额外口令。任务开始前已有的历史版本、其他工程和共享资产不自动删除。
- 文件归档与剪辑质量验收分别记录，人工听审等缺项不能因文件归档成功改成PASS。
- 用户确认成果并说“归档”，默认是本批全部工程清场：按 确认归档的处理 将最终成品、最初始母带/原始文件、说明、已有逐字稿、最终PPT/PDF、封面及明确要求的其他交付留在现有课程/成果目录，核验后直接清除对应历轮工程、过程视频、制作脚本与缓存，不再集中保留一套“工程归档”。只有用户明确要求的可编辑工程属于交付；中间增强母版或付费结果不因其生成成本而自动保留。
来源复用优先
课程切片：放入已有成品目录的“切片/课程编号或日期”子目录。原件以课程主文件夹为真源，先核实真实位置与可读取性，在审查稿记清引用，不再复制、硬链接或另外归档母带。核对改名、目录重组及课程工程后，才判断原件是否丢失。清理此前的课程副本前核对相同来源仍在课程项目中；唯一源缺失时，恢复到课程项目正式位置，不新增一套“切片母带”。
运营/分类映射目录：用户指定为“只放映射快捷方式”的赠品、爆款、素材分类等目录仅保存入口，实体文件保留在已有正式原位置。Windows 使用普通 .lnk 文件快捷方式，不以复制、硬链接、Junction或符号链接代替。替换现有副本前核对正式原件可读及完整SHA-256一致，先创建并回读快捷方式的 TargetPath，更新引用后才删除副本。保持原目录分类及显示名称；唯一文件尚无可确认的正式原位置时先保留并查来源，不凭名称猜目标。目录位置从本轮指令或 video.archive.reference_only_roots 读取，正式来源范围可由 canonical_source_roots 指明；不因名字含“爆款”就认定它是实体真源。
爆款素材库复用：先分清素材库保存的是原件还是快捷方式。映射目录里的 .lnk 先只读解析到真实文件，再核对来源关系、可读性、SHA-256和剪辑区间；剪辑、上传、网页及工程引用都使用真实源路径，不把 .lnk 当视频传给媒体工具，也不为运行另复制一套。读取快捷方式只取路径，不执行它的命令/参数；异常或指向程序、链式失效目标时停下核对。实体原件已在既有正式目录时原位复用，成品与分类入口之间不再重复归档。已核验副本按授权在映射侧替换为快捷方式，不移动或删除正式原件。
其他常规视频：未在爆款素材库等指定真源集中保存的母带，才与对应成片放在同一个成果子目录。多份素材可在该成果目录内用“素材原件”整理，日期只作属性或说明，不另用母带日期目录拆散作品。一份素材对应多个成片时只留一份并记录引用。沿用原字节，同名同哈希复用；同名不同哈希明确区分。原件不存在而增强源是唯一复剪依据时保留并注明，不能冒称相机原片。
对应关系根据源名、原稿、交付记录和内容核对，不凭日期猜测。无法确认的唯一素材先保留并标明待对应，不将推断写成确定关系。用户要求迁移旧母带目录时，处理全部明确列入范围的文件，核验后移除已空目录。
执行与验收
- 从交付记录和实际文件确定最终成片、最多一个已有封面、来源及完整原稿，不只按最大版本号或修改时间选择。
- 将原始逐字稿、定稿删改标记、成片完整顺读稿、多轮修订、最终源到成片映射、字幕全文及验证边界合入自包含审查稿，避免必须依赖将被清理的JSON或工程。无真实发布证据不创建“已发”标记。
- 同卷优先移动并核验，跨卷先复制、核验，再移除旧位置，不永久保留两套。课程切片及爆款素材库复用只核验成片与已有真源引用，不搬动真源；其他常规视频核验成片、同目录母带及对应关系。拍摄日期不明如实说明，不用导出日期冒充。
- 按 最终文稿入库交接 从已绑定的最终字幕/顺读稿交给
yl-knowledge完成本地处理，逐条留存成片哈希、正文版本、来源 ID 与语义完成回执。原素材、原课程或旧发布版已处理不等于本次最终剪辑稿已处理；相同正文复用，修改版检查差异。不把审查稿中的制作日志、删除段和历史候选全部当成最终正文。 - 列准确清理范围、保留集、文件数量与体积；确认唯一来源、最终成果、最终正文与知识处理回执在清理范围之外并验证后，默认清理本批自产且已无依赖的未采用导出、临时副本与可再生过程材料。知识处理未完成时保留其恢复所必需的文字/映射，不因媒体归档成功先删掉唯一稿件。任务前已有旧版仅在明确纳入范围时处理；共享工具、个人配置、Skill备份、未点名素材不作为垃圾。详情与工具见 文件计划与核验。
- 浏览网页与说明放本轮成果目录，用相对链接；移动后核对成片、封面、审查稿和知识正文链接并调整依赖旧路径的服务。不为归档默认创建公网链接或常驻服务。
- 分别核对媒体保留集、知识处理和实际清理结果。知识清单运行
scripts/verify_knowledge_handoff.py --manifest MANIFEST.json，缺稿、缺完成回执、版本变化或仍待处理均不能报整批完成。必要结果合入审查稿或批次说明，长期知识回执留知识库系统资料区，媒体临时记录可清理。技术核验可复用与哈希一致的已有证据；原声实听与语义判断不得用哈希代替。
清理与恢复
剪辑与发布共同遵守 去重收尾，这是所有安装者的默认完成步骤。验收通过且依赖结束后自动清理本批临时副本及项目可再生缓存，包含 node_modules/.cache/webpack；不要求额外清理授权或个人开关。用户明确保留的文件、原始输入、正式成果、要求交付的工程、无关历史批次及共享依赖继续保护；待审工程只在确认前临时保留。
删除或移动前验证绝对目标在本次明确范围内且不是根目录。递归清理不跟随Junction或符号链接。占用时仅处理已核实属于本批的预览/构建进程，保留未完成状态，不批量终止Node/Python或无关软件。
临时回执支持中断后核对和续接；先回读已归档目标及来源哈希，不能因旧位置已移动就重复建副本或误删。清理失败后刷新预检，必要信息合入成果说明后再删除回执。
交付
给成果位置或浏览入口，分别说明媒体归档数、最终文稿入库数、蒸馏/归并/无需新增数、检索验收与清理结果，并列出未完成条目。文件归档成功但知识处理未完时明确报告“媒体已归档，知识处理未完成”，不能只给媒体路径结束。安装或更新本Skill不自动迁移历史目录；历史排查仍须来自用户明确范围。
防熵增收尾
正式保留集核验后清理本批历轮工程、候选和中间件，原件与确认成果各自唯一；日常归档不备份、不另建工程归档，复用用映射。文件完整性与媒体感知验收分别报告。
通用原则与独立磁盘排查汇总见 yl-anti-entropy；本成员上面的专项归档/清理步骤继续保留。
SkillHub 独立安装
运行前先读 安装与依赖说明。本包不会自动安装同级依赖；缺少必需成员或外部工具时停止相应分支并列明待办，不能跳过原流程而报告完成。
