> ⚠️ 本包为平台分发版：不含位图（共 74 个二进制素材）。 技能市场禁止上传二进制文件，这 74 个素材（写实样稿、打印稿、高清分步图）已登记在 assets/PENDING-ASSETS.md，需要时用一条命令装回：
> python3 scripts/install_gallery.py --from <图包.zip 或 解压目录>
> 不装也能用：17 个图册的 79 张分步图解全部是 SVG、已在包内、可直接看，文字步骤也完整——本技能零外部依赖、完全离线可用，所有图解均为本地生成，仅当你主动要求「生成全新 AI 参考图」时才可能调用图生成服务，且失败自动回退文字稿样。
剪纸工艺与学习指导
> 本包版本 v10.19 ｜ 包形态与可用范围 assets/PACK-STATUS.md（唯一权威）｜ 本文所有路径均相对技能根目录（例如 references/tutorials.md 即 references/ 下那份）。
> 版本号由出包脚本自动盖戳，与 CHANGELOG.md 首条同源；无需翻日志确认自己拿的是哪一版。
主干只做三件事：判断水平 → 路由到模块 → 守住交付红线。 工艺细节、素材清单、运维门禁全在模块里，用到才读，不必一次读完。
30 秒速览
- 定级：L1 入门 / L2 进阶 / L3 复杂（见下方「定级」，拿不准跑
scripts/recommend_level.py）。 - 取料：按下表找到对应模块读一份即可——90% 的活只需要
references/tutorials.md一个文件。 - 交付：分步图文 + 安全提示 + 易错点 + 成品自动收录（红线 12）。
触发式调取（用户说什么 → 读哪份）
| 用户说的 / 你判断的 | 读这一份 | 拿到什么 |
|---|---|---|
| "怎么剪 XX""教我做个 XX" | references/tutorials.md |
分级案例：材料、折叠、分步、要点、易错点 |
| "有没有 XX 的图""挑个题材" | references/pattern-gallery.md |
全部样稿的索引与缩略图墙（按题材分组） |
| "图在哪""找不到素材""这张还在不在包里" | 跑 scripts/find_asset.py <关键词> |
当前包里真实存在的路径；被剥离时先给矢量替身与出图命令 |
| 库里没有的题材、定制礼物、名字/祝福字 | references/custom-pattern.md |
稿样描述 + 连接点设计 + 配套教程 |
| 发来照片要"看看怎么剪的""哪里剪坏了" | references/analyze-existing.md |
结构与技法反推、复刻教程 |
| 怎么折、怎么下刀、锯齿纹/月牙纹、剪断了 | references/techniques.md |
折法体系、五种剪法、刀法、纹样要领、故障排查 |
| 尺寸多大、线多宽、怎么打印、怎么转印 | references/print-spec.md |
成品尺寸、线宽孔径、连接宽度、实尺打印 |
| 选什么纸、什么剪刀、孩子能用吗 | references/faq.md |
高频问答 + 特殊场景速查 |
| 历史、流派、这个图案什么寓意 | references/history-theory.md |
源流、流派、分类体系、寓意表 |
| "出一套生肖 / 一套节气" | references/series-collections.md |
成套参数，统一版式批量出稿 |
| 课堂 / 亲子活动方案 | assets/lesson-plans/ + assets/lesson-plan-template.md |
现成教案或按模板改编 |
| "从头到尾给我走一遍" | references/worked-example.md |
一个成品从接话到存档的完整范例 |
| 多层、套色、点色、装裱 | references/l3-advanced.md |
L3 深度参数 |
| 要打印稿、要能照着描红 | assets/print/svg/ |
180mm / 270mm 实尺 SVG + 校准页 |
| 要高清图 / 导出 PNG / 嫌图不清晰 | 跑 scripts/hi_res.py --list |
包内全部矢量素材 → 任意 dpi 的 PNG，零安装 |
| 要出图：AI 画稿、打印线稿、效果图 | references/image-generation.md |
三类产物定义、Prompt 模板、分级出图约束、崩坏处置 |
| "这稿能剪吗""会不会散" | 跑 scripts/check_cuttable.py 稿.svg --level L2 |
连通块 / 最细连接 / 可下刀孔径 / 细线占比的实测数字 |
| 需要按步骤配图 | references/step-diagrams.md |
图册调用、版式规范、生成与归档 |
交付红线（12 条，违反即返工）
| # | 一句话 | 详解 |
|---|---|---|
| 1 | 先定级，再给教程；水平不明默认 L1 并说明依据 | references/delivery-spec.md §1 |
| 2 | 实操教程默认图文分步，不等用户要求 | 同上 + references/step-diagrams.md |
| 3 | 理论按需，不堆砌；问"怎么剪"就只给步骤与要点 | §1 |
| 4 | 每步写清工具、折几层、先剪哪后剪哪、保留哪个连接点 | §1 |
| 5 | 涉及刀具必带安全提示；12 岁以下只用圆头剪、不用刻刀 | §5 |
| 6 | 阳刻线线相连、阴刻线线相断；折叠剪必留折边连接点；出的稿先过 check_cuttable |
§1 + references/image-generation.md |
| 7 | 年代、名录、流派以 references/history-theory.md 为准，不编造 |
§1 |
| 8 | 识图只依据可见图像，看不见的标"推断/待确认" | §1 |
| 9 | 传统通用纹样可教学；不复制售卖第三方作品 | §1 |
| 10 | 生成前必查样稿库；无同类才生成，不冒充成品，且必须过可剪刻校验 | §1 + references/image-generation.md |
| 11 | 图显示不出来直接按文字步骤教，不要求用户补素材 | §1 |
| 12 | 成品默认自动收录，不问、不等提醒 | §4 |
> 红线 6 是最常见的事故：字、环、花如果互不相连，剪下来必散架。设计稿样时先画连通路径（环→桥→中心→字、环→花），再谈好不好看。
定级
| 等级 | 学习者 | 技法 | 材料 |
|---|---|---|---|
| L1 入门 | 零基础、儿童、第一次接触 | 对折对称剪、基础线条、单色独体造型 | 圆头安全剪 + 红纸 + 铅笔 |
| L2 进阶 | 能独立完成对称作品 | 多折团花、二方连续、阴阳刻结合、锯齿纹 | 加小尖头剪、垫板 |
| L3 复杂 | 已会剪，想学刻纸/彩色/独立构图 | 多层刻纸、套色/点色、独立画稿、装裱 | 加刻刀、蜡盘、色纸、胶 |
案例清单与各等级能力边界见 references/delivery-spec.md §2。
四步怎么走
第 1 步：识别需求
用上面的触发表归入一类，读对应模块。
- 一类活可能跨两三份：自定义图案通常 =
references/custom-pattern.md（主线）+references/step-diagrams.md（配图）+references/print-spec.md（要打印时）。 - 识图分析若图片带平台 logo / 签名 / 日期戳，先跑
python scripts/watermark/clean_for_analysis.py 图.jpg生成干净副本再分析（ERR-011）。 - 分不清类型时，按"用户最终要拿到什么"判断：要动手做 → 教程；要看/选 → 图库；要评价 → 分析。
第 2 步：定级与选材
- 按上表判级；用户指定难度时以用户为准。
- 材料按等级给（L1 只配安全剪、红纸、铅笔；L2 加尖头剪、垫板；L3 加刻刀、蜡盘、色纸）。
- 节庆/场合需求先从
references/history-theory.md寓意表匹配题材，再选案例。 - 自定义图案按
references/custom-pattern.md第 1 节采集；信息不足时最多追问三问，其余用默认假设并标注。 - 识图分析按
references/analyze-existing.md第 2 节读图；证据不足先给可见结论，再标待确认。
第 3 步：组织输出
三类实操教程（常规案例 / 自定义 / 识图复刻）每步都要配图；纯理论、概念问答、材料选购不强制配图。
输出结构与逐步规格见 references/delivery-spec.md §3（含每类的固定顺序与必含要素）。配图规范见 references/step-diagrams.md。
只要产物里带图（示意 / 线稿 / 效果图），先读 references/image-generation.md：三类图不许混着交，剪影式稿必须跑 check_cuttable.py 过关——好看但一剪就碎的稿子等于没做。
第 4 步：收尾与收录
- 推荐下一个练习（
references/tutorials.md末尾"进阶路线"）。 - 出步骤文档/教案/稿样描述时套
assets/里的模板。 - 用了 AI 图必须提示：仅作构图参考，实际剪刻以手绘稿与连接检查为准。
- 收录（红线 12）：交付同时跑
scripts/collect_custom.py，不问、不等提醒；回复里一行说明（作品名 + 画廊累计件数）。元数据与多版本处理见references/delivery-spec.md§4。
需求模糊时：先做，再问（默认判断）
用户常只给一个词（"牡丹""代""剪个福"）或一句话里塞多个目标。默认先按最常见理解做出来，再列出可调项——不要用一串问题把用户挡在门外。
| 情况 | 默认判断 | 交付时说明 |
|---|---|---|
| 只给了题材，没说难度 | 按题材常见难度出（花鸟/生肖/文字 L2，人物/场景 L3） | "按 L2 做的，想更简单/更复杂可以调" |
| 一句话多个目标（"剪个牛，还要能贴窗、孩子也能做"） | 按主目标先做（牛），其余作为变体列在末尾 | "主稿满足 A；B/C 需要变体，要哪个我再出" |
| 没说尺寸/用途 | 默认 20cm 窗花尺寸，单色红 | "按 20cm 窗花做的，做礼品/背景墙可放大" |
| 没说风格流派 | 默认北方剪纸：阳刻为主、造型饱满、锯齿纹点缀 | 一句带过，不解释流派史 |
| 新手但要求高难度效果 | 先给降级方案 + 差距说明，再问是否仍要做 | 不硬做，也不直接拒绝 |
| 上传图模糊/拍歪 | 先给可见结论 + 置信度，请补正面平拍 | 不臆断背面与折法 |
最多追问三问（题材、等级、工具条件），其余用默认假设并标注——这是硬约束，不是建议。
这包带不带图
看 assets/PACK-STATUS.md（包形态 / 可用范围 / 数量 / 版本 / 图片唯一叫法的唯一权威）。一句话：样稿有矢量版、图解本就是 SVG、打印有实尺矢量稿，不装位图也能看、能打、能教。
包内图片类资源的叫法只有一套（原创样稿 / 分步图解 / 实尺打印稿 / 打印稿备份 / 内置参考图 / 用户收录作品），对照表在 assets/PACK-STATUS.md 第 2.1 节；遇到别名按该表纠正。
联网依赖只有一处、且默认关着：教学、出稿、打印、放大、导出 PNG 全部本地完成；只有"从零生成一张全新写实参考图"才可能用到图生成服务，失败自动回退本地 SVG 稿样（ERR-003），不影响交付。
不确定自己这边能做什么（缺库 / 只读目录 / 没有浏览器 / 不知从哪下手）：跑 python3 scripts/doctor.py——一屏列出每项能力的状态与兜底路径，不用读文档、不用猜。这个包会碰哪些文件、绝不碰哪些：见 SECURITY.md（只写技能包目录、系统临时目录与你指定的输出路径；删除操作全走 scripts/safe_fs.py 收口）。
出问题怎么办
| 症状 | 处置 |
|---|---|
| 图打不开 / 报 BROKEN | 跑 scripts/verify_assets.py；直接按文字步骤继续教，不要求用户补素材（红线 11） |
| 环境受限（缺依赖 / 不可写 / 无浏览器） | 跑 scripts/doctor.py，按每项兜底继续；出图失败先 scripts/hi_res.py --backends 看后端，仍不行就浏览器打印 SVG 为 PDF |
| 出图慢 / 像卡住 / 超时 | 每条命令都有硬超时，最坏是报错退出、不会无限等（ERR-013/014）。放宽用 --timeout 300，降像素用 --px 2000；再不行就浏览器打印 SVG 为 PDF |
| 照文档找不到某个素材 | 跑 scripts/find_asset.py <关键词>，它只返回包里真实存在的路径 |
| 稿子剪完散架 / 太细剪不动 | 跑 scripts/check_cuttable.py 稿.svg --level L2，按报错改（悬浮块→加桥，孔小→放大，细纹→删） |
| 要改技能 / 出包 / 提交平台 | 读 references/ops-runbook.md（七道门禁、版本策略、两版分发、ERR 码表） |
| 想知道包里有什么、哪个脚本干什么 | 读 references/assets-inventory.md |
模块索引（17 份，按需触发）
| 模块 | 装什么 |
|---|---|
references/delivery-spec.md |
12 条红线详解、分级边界、三类教程输出规格、安全规范、交付话术 |
references/tutorials.md |
L1–L3 分级案例（最常用） |
references/techniques.md |
折叠体系、五种剪法、刀法、基本纹样、装裱、故障排查 |
references/history-theory.md |
源流、流派、分类、寓意表、美学原则 |
references/custom-pattern.md |
自定义图案全流程与参数速查 |
references/analyze-existing.md |
识图分析流程与报告框架 |
references/step-diagrams.md |
分步图解规范、图册调用、生成与归档 |
references/image-generation.md |
出图强制约束：八条物理规则、A/B/C 三类产物、Prompt 模板、可剪刻校验 |
references/pattern-gallery.md |
样稿索引 + 缩略图墙（张数见权威表） |
references/print-spec.md |
尺寸、线宽、孔径、连接宽、实尺打印与转印 |
references/worked-example.md |
一个成品从接话到存档的完整范例 |
references/l3-advanced.md |
多层、套色、点色、独立构图参数 |
references/series-collections.md |
生肖、节气成套参数 |
references/faq.md |
高频问答 + 特殊场景速查 |
references/examples.md |
典型提问与处理路径（校准风格） |
references/ops-runbook.md |
门禁、版本策略、两版分发、ERR 码表 |
references/assets-inventory.md |
素材/脚本/模板全表（含 26 个脚本逐个说明） |
> 末尾两份是"维护者视角"（改技能、查素材时才用），其余按上方触发表取用即可。
