先做三分法，再决定放到哪里
| 类别 | 入库判断 |
|---|---|
| 可复用资源 | 能被下一条视频直接调用的真实文件，例如字体、BGM、音效、音色参考、Logo 或边框图片；登记稳定 ID、种类、文件路径和人工确认的使用状态。 |
| 可复用模板 | 一组已经选定的安排，例如字幕样式或包装图层；模板有版本、画布、参数、引用资源和采用状态。改动会影响既有选择时，新建版本。 |
| 参考样片 | 用来回答“这个效果实际是什么样”的成片或片段；写明它示范什么、哪些人物、文字、时间码或单片决定不能照搬。 |
这三类的复用单位不同。字体文件本身属于资源；“这套字体在竖屏画布上的字号、描边、行数和字幕带”属于模板；一条展示最终阅读效果的视频属于样片。把三者混成“好用素材”文件夹，会让下一位剪辑者分不清可直接调用的文件、可复用的安排和仅供观察的结果。
原始采访、剧集、拍摄卡和每期下载素材继续按制作项目归档。这里登记的是跨项目可能再次选择的后期资产与安排。
用两列入库表给每项一个明确身份
| 入库字段 | 填写方法 |
|---|---|
| 稳定 ID | 用短小、可读、不会随展示标题改变的名称；后续模板和项目按 ID 引用。 |
| 当前类别 | 只选资源、模板或样片；模板另写字幕样式或包装，资源另写字体、图片、声音等种类。 |
| 真实载体 | 资源填写实际文件；模板填写参数及所引资源；样片填写实际片段或可访问路径。 |
| 适用边界 | 资源写它承担的具体工作；模板写画布与适用范围；样片写 demonstrates 与 not reusable。 |
| 采用状态 | 试做模板保持 draft；经创作者采用后才标 adopted；停用版本标 retired，保留旧项目可追溯性。 |
| 开工动作 | 先列出对应种类，查看候选完整记录，再把最终选项写进当前项目绑定。 |
入库时先完成最小记录，再补充能帮助人做选择的说明。标签可以辅助浏览，不能替代稳定 ID、真实文件和明确类别。一个项目如果只记“用上次那套”，下一次无法判断指的是某个字体文件、整套字幕参数，还是一条参考视频。
原创纸面案例：给抱石教学系列建可复用选择
下面的“岩壁读线课”是本文原创纸面项目。条目名、路径和版本均为教学占位，没有创建文件、扫描资源库、运行命令、渲染视频或观看样片。真实项目要换成当前机器可读的文件和创作者实际采用的记录。
系列每期讲解一条室内抱石线路。剪辑者希望复用低干扰背景音乐、抓点编号图、讲解字幕安排和静态抓点编号叠层，同时保留一期“重心转移”视频作为观察参考。入库方案如下：
| 纸面条目 | 明确用途 |
|---|---|
bgm-route-focus | BGM 资源；设计路径 resources/bgm/bgm-route-focus/route-focus.wav；作为讲解段落的低干扰背景音乐，具体音量与入点由当前项目决定。 |
font-route-notes | 字体资源；设计路径 resources/font/font-route-notes/RouteNotes-Regular.otf；供讲解字幕模板引用，内部 family 待真实字体核对后填写。 |
image-hold-numbers | 图片资源；设计路径 resources/image/image-hold-numbers/hold-numbers.png；透明抓点编号图。 |
boulder-captions@v1 | 字幕模板；横屏画布，引用 font-route-notes，并记录字号、描边、每行上限与字幕带。 |
hold-number-overlay@v2 | 包装模板；只引用 image-hold-numbers 这一张静态透明图片，记录它在画布内的矩形位置和图层顺序。运动画面如何并排不属于该模板。 |
weight-shift-sample | 参考样片；只示范抓点编号与重心讲解在真实动作中的配合。运动员、线路颜色、讲解文字、剪点和时间码全部留在该期。 |
下一期讲“换脚”时，剪辑者按种类找已知项，查看字幕与静态抓点编号模板及其所引资源，再把 boulder-captions@v1、hold-number-overlay@v2 和 bgm-route-focus 写进项目选择。样片只用于观察信息出现顺序，不能把上一期的运动员、抓点路线或讲解句子带入新片。若新一期改为竖屏，原横屏模板不直接套用；应为新画布建立并采用相应版本。
开工时按“列出、查看、选择”走一遍
通用方法只有三步：按当前任务的种类列出已知 ID；打开少量候选的完整记录；把最终选择写进本项目。先查字体、字幕模板或包装模板，避免每次从整个硬盘重新猜。查看记录时核真实文件、模板画布、采用状态和样片边界；项目只绑定这次确实使用的项。
在固定版本的 $video-recap 中，只读工具的实际参数是 --library-dir，子命令为 list、show 与 check。例如：
```bash
python3 scripts/library.py --library-dir <library> list --kind font
python3 scripts/library.py --library-dir <library> show hold-number-overlay@v2
python3 scripts/library.py --library-dir <library> check --json
```
list --kind 依赖已知类别，不提供语义或推荐搜索；show 接收资源 ID、样片 ID 或模板的 id@vN；check 读取整个库，错误会阻止条目使用，警告交给人复核。工具不会写库。项目准备好后，recap_project.json 的 bindings 保存已选字幕模板、包装模板、声音或 BGM；运行入口用 --project 解析这些选择。
选用前做一次短核对
选用前只核与当前任务有关的事实：资源文件仍可读；模板仍是 adopted；模板画布与本次成片一致；所引资源存在；样片被当作证据而非可复制模板；项目绑定写的是本次最终选择。check 的技术结果与人的内容判断分别记录。
若警告指出文件在模板采用后发生变化，回到创作者重新确认该资源，或建立新版本。若样片在本机不可用，保留其记录并停止把它当作当前可观看证据。授权状态由人填写和复核；文件进入目录本身不会改变其使用状态。
这套短核对让库回答“我们选了哪个已知项、它现在是否可用”。剪辑节奏、字幕文案、音乐入点与具体画面遮挡仍在各自的创作和成片检查中决定。
常见问题
参考样片可以直接当模板复用吗？
样片只证明某种结果曾经出现。把其中可复用的画布、参数和资源引用另存为带版本模板，并明确样片里不能照搬的人物、文字、剪点和时间码。
资源库能替代原始素材归档吗？
原始拍摄与每期来源素材继续按项目归档。这个库服务跨项目复用的后期资源、模板和参考样片，并通过已知 ID 与种类浏览。
用 skill 来做
用 $video-recap 整理这批可复用后期内容。先把真实字体、声音与图片放入资源，把已采用的字幕或包装安排存成带画布和版本的模板，把成片只登记为参考样片。请按种类列出已知 ID，查看候选记录，运行只读检查，再把最终资源和模板选择写入当前 recap_project.json；不要把原始素材归档或语义搜索并入这项任务。
查看具体方法： 资源、模板、样片与项目绑定 · 资源库只读 list、show 与 check 参数 · 素材库边界、资源登记与项目入口