self-learning-hyperframes

name	self-learning-hyperframes
description	作为 self-learning 的 HyperFrames 产出能力，自主学习本地教学音视频或公开视频链接，把教程讲授的方法、可观察动效和屏幕代码转成有证据、可恢复、可渲染的 HyperFrames Demo，并记录实际使用的内容、Skills、工具与可复用经验。仅在 self-learning 调用，或用户明确要求从教学素材制作 HyperFrames Demo 时使用；普通学习任务不要单独触发。

Self Learning · HyperFrames

把自己当作会看、会验证、会复盘的学习者。忠实复现教程教授的因果机制与时间关系，不追求逐像素复制，也不要把“看起来像”当成学会。

边界

• 用于完成“摄取教程 → 提取方法与动效 → 构建 Demo → 真实渲染评审 → 沉淀经验”的完整任务。
• 若用户只要下载、字幕、素材整理或通用视频剪辑，直接路由对应能力，不建立完整学习 run。
• 不复制 ASR、抽帧、素材管理或 HyperFrames 实现能力；探测并调用当前环境已有的 Skills 与工具。
• HyperFrames 创作先走官方路由；只有最佳实践、环境故障或本机适配问题才调用 hyperframes-ops，且不把机器经验写回共享工作流。

Reference 地图

只在对应时刻读取，避免把全部细节一起装入上下文：

Reference	何时完整读取
workflow.json	建立、恢复或推进 run 前；它是 12 阶段与失效传播的机器事实
contracts.md	写任何 run artifact、receipt、证据引用或最终指针前
extraction-protocol.md	执行 ingest 到 observe_motion，或提取证据不足需要回退时
capabilities.json	选择能力、执行 probe 或首选能力失败时
rubric.json	verify 开始前，以及 R1、R2 评分前
learning-loop.md	Phase 0 选择旧经验，以及 Review、反馈或 finalize 后沉淀本轮学习时

Phase 0：模式与本地上下文

1. 完整读取存在的 experience.local.md；把 runtime.local.json 仅作为可能过期的提示。
2. Phase 0 只查长期 index；preflight 完成后按 learning loop 最多选择 1–3 条直接相关经验，并始终写 memory-selection.json。无命中也写空 selection，但不创建空长期 local/。
3. 用户明确授权无人值守或批量执行时进入自动模式，持续选择范围内最安全、可逆的下一步；否则使用协作模式，只询问会改变 Demo 数量、核心方法或公开素材边界的决定。
4. 确认目标是 Git 仓库，且 .learning/runs/、.learning.lock 和本 Skill 的 /local/ 私有层不会进入 Git。

建立或恢复 run

• 新任务先用 scripts/init_run.py start 建立私有 run，再摄取来源；规划完成前不要占 Demo 编号。
• 恢复任务先用 scripts/validate_run.py --apply-invalidation 校验 hash 链。只跳过仍匹配真实源媒体、当前 workflow、直接上游、schema 与实际输出 hash 的阶段。
• 任一来源、证据、源码、fixture、日志、观看材料或成片漂移时，从首个不可信阶段向下失效；不要凭记忆续跑。

12 阶段

严格按 workflow 推进，不静默跳过失败：

阶段	核心动作	主要交付
preflight	确认授权、范围、模式、能力面与私有边界	preflight.json
ingest	取得可读媒体并绑定真实媒体字节	ingest.json
transcript	提取并复核时间码字幕	transcript.json
learn_method	分层提炼教程事实、代码事实与实现推断	method-spec.json
observe_motion	粗采、密采、观看并建立动效证据	motion-spec.json
plan_demo	决定 Demo 数量、机制边界、slug 与素材策略	asset-plan.json
build	原子绑定编号并调用 HyperFrames 能力实现	Demo 源码 + draft MP4
verify	修完全部机械 must-pass	verification.json
review_r1	独立完整观看 draft，只选一个最大问题	score-r1.json
revise	只修 top_fix.dimension，冻结其余维度	revision.json + 新 MP4
review_r2	用新证据独立复评并硬停止	score-r2.json
finalize	绑定唯一 final、更新索引并沉淀学习	final.json

全局不变量

• 事实：每条结论绑定真实 source ID、媒体 hash、时间范围以及实际 cue、帧或代码证据；占位字符串不能算证据。
• 分层：保持 tutorial_fact、visual_observation、code_fact 与 implementation_inference 独立；本地设计选择不冒充教程事实。
• 证据：字幕不能替代视觉观察；均匀接触表不能替代关键段密集证据；实现结果不能反向证明来源。
• 可恢复：每阶段 artifact 绑定当前输出、直接上游、schema、workflow 与相关源码/fixture/回执 hash。
• 能力：只对当前输入适用的候选执行无副作用 probe；probe 不下载、不安装、不改写环境。
• 素材：原媒体、完整字幕、私人照片和绝对路径只留在私有 run；公开 Demo 自带原创或明确授权 fixture，并能在 clean checkout 中 check/render。
• 编号：plan_demo 后才用 bind-demo 原子分配；不手猜编号，不用锁文件是否存在推断锁状态。
• 留痕：只记录本轮实际读取的内容、调用的 Skills/工具、版本、回执与产物 hash；不能由模型自报使用事实。

Must-pass 与两轮停止

1. verify 先完成 rubric 中所有 must-pass；失败项必须先修，无法修复则 blocked，不消耗 R1/R2。
2. R1 与 R2 都审阅真实完整 MP4，并使用各自实际解码、framemd5、全片 watch sheets、关键段密集帧带与时间码问题记录。
3. R1 只输出一个可修的 top_fix。revise 只改同一维度并生成不同 MP4 hash。
4. R2 不复用 R1 观看结论；完成后把 top_fix 设为 null 并硬停止，不开启第三轮。
5. final 必须指向 R2 审阅的同一 hash。must-pass 全绿但总分低于 80 时使用 completed_with_residuals，不隐藏残余。

何时 blocked

仅在以下条件停止并写明可验证理由：

• 来源未授权、不可读，或目标范围需要用户作实质选择；
• 当前阶段所有适用能力候选都真实失败；
• 隐私或公开素材边界无法满足；
• 机械 must-pass 经修复仍无法通过。

风格小选择、已有安全默认值或低风险可逆步骤不是 blocked 理由。

学习沉淀与收尾

• 新 workflow 1.1.0 run 以 required=true、state=collecting、contract_version=1.0.0、selection=null、sidecars={} 初始化；preflight 后 selection 必须指向 memory-selection.json（无命中也写空选择），且所有 descriptor 的 {path, sha256} 都由 validator 重算。
• 每个 completed stage/workflow capability 都记录真实 content/Skill/tool event，或明确 missing|degraded|not_recorded coverage；无执行不能静默缺席，模型自报 hash/receipt 不能算证据。
• Finalize 按 skill-usage-manifest → usage-ledger → retrospective → 原子 state=frozen 的唯一顺序落盘。之后 Review/用户反馈只新增 feedback candidate；不得改写 retrospective、R2、final、manifest、ledger 或重新渲染。
• workflow 1.0.0 默认继续有效；显式 backfill 只从旧 run 已保存事实幂等生成 state=backfilled sidecars，未知 Skill/tool 写 not_recorded，不用当前环境补造，且除 sidecars/run.json.extensions 外旧文件和 final hash 不变。
• 机器路径、私有偏好和单机经验只进被忽略的 local memory；跨案例验证的通用规则才进入共享 Skill reference；未验证想法留在 backlog。
• 更新 Demo 索引后只暂存精确目标文件，分别用 scripts/audit_staged.py 审计 Skill 与 Demo 仓库的 Git index；空暂存集必须失败。
• 最终用 scripts/validate_run.py --ffprobe on 验证唯一成片，并报告 Demo 路径、final hash、测试/check/render、R2 分数、账本状态与残余。