用途
style-library-importer 用于把一个新的视觉风格加入本地手绘风格库，支持以名称、视觉特征或两者结合的方式定义风格。它独立于 tweet-style-importer：仅提供图片的导入请求应由 Tweet 工作流处理，不应在此获得新编号。
主要能力
- 解析输入类型：
- 仅名称：保留所给名称作为风格标签，不虚构或存储视觉特征，并为 gpt-image-2 登记 name_activation=strong、traits_activation=none。
- 名称加特征：保留名称，仅保留正向具体的可见特征，移除如“避免”“不要”“不准”“禁止”或“无写实纹理”等否定性描述，并登记 name_activation=weak、traits_activation=strong。
- 仅特征：生成一个可读的中文风格标签和一个简洁的英文生成名称，仅保留正向具体的可见特征，并登记 name_activation=weak、traits_activation=strong。
- 仅图片：不修改风格库，并说明仅图片导入由 tweet-style-importer 处理。
- 对每个文本定义风格，gpt-image-2 必须使用其配置的文本激活方式，且不得接收参考图；未知模型保留风格库已有的图像回退行为。
- 代表图处理：
- 若用户随文本输入提供了图片，直接将其用作代表源图，不再另行生成。
- 若未提供图片，使用 gpt-image-2 生成恰好一张原创的 1:1 代表图。选择简单中性的主体与场景，使声明的风格清晰可辨。使用所给名称以及（若存在）过滤后的正向特征；不得复用现有风格库条目中的主体、动作、场景、构图或故事。生成一张干净图片，不带任何编号角标或叠加层。
使用方式
取得代表图后，在仓库根目录运行确定性导入脚本：
python scripts/import_manual_style.py --source-name "中文风格名" --generation-name "English Generation Style Name" --traits "正向可见特征" --image "/path/to/representative.png"
- 仅名称输入时省略 --traits。
- 仅特征输入时，将你创建的 --source-name 与 --generation-name 传入。
- 当检查所选激活策略有帮助时，可在导入前使用 --dry-run。
导入器会分配下一个编号，创建 512px 干净单图块（严格不含任何编号角标、叠加层或烧录文字），并延续当前活动的 H 联系表。单张提供或生成的代表图不会创建参考网格；若需要参考，则使用该干净单图。仅当提供两到四张源图时，才创建 1024px 的 2×2 参考网格。随后导入器更新源表与能力元数据、重建画廊并运行完整验证。
适用场景
- 需要向本地手绘风格库注册一个新的文本定义视觉风格。
- 已有风格名称或视觉特征描述，希望生成干净代表图并纳入编号库。
- 需要延续 H 联系表、更新源表与能力元数据、重建画廊并执行验证。
限制
- 仅图片导入不属于本技能，应使用 tweet-style-importer。
- 严格禁止在图片上烧录、叠加或盖印任何编号角标；代表图块必须 100% 干净无瑕。
- 参考网格仅在提供两到四张源图时创建，单张图不创建参考网格。
- 报告内容需包含编号、激活路径、图片是生成还是提供、活动的 H 表以及验证结果。