自建图库资产管理器(Custom Asset Manager)是专为手绘风格与排版图型库设计的专属资产管理技能,负责管理用户自建图库(角色库、道具库、场景库)的全生命周期资产维护,包括目录初始化与挂载、新增归档、替换基准图、修改属性、安全删除以及资产查询,并确保与官方预置完全解耦、Git 更新永无冲突。
一、职责分工 资产维护(增/删/改/换/查)由 custom-asset-manager 负责,专注管理本地物理文件、多级配置与清单索引,严格维护资产状态。出图与提示词组装由 handdraw-style-prompter 负责,专注风格激活、图型排版拼装、垫图引用与出图设计,只读资产。
二、底层引擎 统一调用 Python 引擎:skills/handdraw-style-prompter/scripts/custom_library_manager.py。
三、支持的核心指令与操作规范
-
初始化或挂载图库目录(Init / Attach) 用户触发词示例:请帮我初始化图库目录:d:\path\to\tuku;切换图库目录:d:\path\to\my_assets。 执行逻辑:调用 init_or_attach_library(target_path),在指定目录下创建 characters/、props/、scenes/ 及自包含的 library.json;将路径持久化写入全局配置 ~/.handraw-style/config.json 与工作区容灾配置;若是已有目录,自动扫描现有 WebP 资产并完成无缝挂载;触发画廊重建,生成并刷新 skills/handdraw-style-prompter/gallery/assets.html。
-
新增归档资产(Add / Archive) 用户触发词示例:保存图片到角色库,名称:xxx;保存图片到道具库,名称:xxx;保存图片到场景库,名称:xxx;请添加到角色库(未指定名称时由 AI 赋予贴切名称,并提示用户可修改)。 执行逻辑:调用 save_asset(category, name, source_image, tags),计算下一个顺序编号(角色 CH-002...、道具 PR-001...、场景 SCN-001...);通过 PIL 自动转换为高质量 WebP 格式存入 <tuku_dir>/<category>/<ID>.webp;同步镜像到离线预览目录 images/custom/<category>/<ID>.webp;写入外部图库的 library.json;自动刷新画廊。
-
替换基准图(Replace Benchmark Image) 用户触发词示例:用这张图片替换角色 CH-002;替换 CH-002 的基准图;更新道具 PR-001 的图片。 执行逻辑:调用 replace_asset_image(asset_id, new_source_image),保留原编号与元数据不变;将新图片转换为 WebP 覆盖写入 <tuku_dir>/<category>/<ID>.webp 与镜像缓存;更新外部 library.json 的 updated_at 时间戳;自动刷新画廊,出图时即刻使用全新基准图垫图。
-
修改属性与标签(Update Metadata) 用户触发词示例:把 CH-002 名称修改为:粉扑兔;修改 CH-002 标签为:可爱, 萌系, 毛绒;将 CH-002 英文名改为:Cute Pink Bunny。 执行逻辑:调用 update_asset_metadata(asset_id, name=..., name_en=..., tags=...),更新外部 library.json 中对应的资产属性;自动刷新画廊,前端卡片即刻同步更新显示。
-
安全删除资产(Safe Delete) 用户触发词示例:删除角色库中的 CH-002;从自建图库删除道具 PR-001;清理角色:傲娇粉团。 执行逻辑:调用 delete_asset(asset_id),官方预置安全拦截:若目标为官方预置(如 CH-001 黑猫侍者),坚决拒绝删除并告知受官方保护;从外部图库目录物理删除对应文件;从镜像预览目录物理删除缓存文件;从外部 library.json 资产清单中移除该条目;自动重构画廊,卡片同步从画廊消失。
-
查询资产列表(List / Inspect) 用户触发词示例:查看我的自建角色;当前自建图库有哪些资产。 执行逻辑:调用 load_custom_assets() 与 get_asset(id),清晰列出当前图库目录、角色、道具与场景的数量、编号与名称。
四、安全守则与硬性约束 官方预置神圣只读:官方预置(CH-001 等)属于公共仓库核心资产,严禁被 delete_asset 或 replace_asset_image 篡改或删除。 零路径硬编码:严禁将用户的外部物理路径硬编码至 Git 追踪的代码或文档中,所有配置均经由 ~/.handraw-style/config.json 自动寻址。 操作后必定刷新画廊:任何增、删、改、换操作执行后,必须确保触发画廊重构,保证前端 assets.html 与本地磁盘数据 100% 强一致。 自建资产索引与 Git 严格隔离:自建资产编号与元数据统一导出至本地 gitignored 索引文件(images/custom/custom_assets.js),由浏览器端动态渲染加载,绝不可烘焙进 Git 追踪的静态 HTML 文件(assets.html 与 tutorials.html)中,确保用户私有资产 100% 零泄露。