自建图库资产管理器 (Custom Asset Manager)

专为手绘风格与排版图型库设计的专属资产管理技能。负责管理用户自建图库（角色库、道具库、场景库）的全生命周期资产维护，包括目录初始化与挂载、新增归档、替换基准图、修改属性、安全删除以及资产查询，并确保与官方预置完全解耦、Git 更新永无冲突。

---

核心职责分工

业务意图	负责 Skill	说明
资产维护（增/删/改/换/查）	custom-asset-manager	专注管理本地物理文件、多级配置与清单索引，严格维护资产状态
出图与提示词组装	handdraw-style-prompter	专注风格激活、图型排版拼装、垫图引用与出图设计，只读资产

---

支持的核心指令与操作规范

底层统一调用 Python 引擎：skills/handdraw-style-prompter/scripts/custom_library_manager.py

1. 初始化或挂载图库目录 (Init / Attach)

• 用户触发词：
  • 请帮我初始化图库目录：d:\path\to\tuku
  • 切换图库目录：d:\path\to\my_assets
• 执行逻辑： 调用 init_or_attach_library(target_path)：
  1. 在指定目录下创建 characters/、props/、scenes/ 及自包含的 library.json；
  2. 将路径持久化写入全局配置 ~/.handraw-style/config.json 与工作区容灾配置；
  3. 若是已有目录，自动扫描现有 WebP 资产并完成无缝挂载；
  4. 触发画廊重建，生成并刷新 skills/handdraw-style-prompter/gallery/assets.html。

2. 新增归档资产 (Add / Archive)

• 用户触发词：
  • 保存图片到角色库，名称：xxx
  • 保存图片到道具库，名称：xxx
  • 保存图片到场景库，名称：xxx
  • 请添加到角色库（未指定名称时由 AI 赋予贴切名称，并提示用户可修改）
• 执行逻辑： 调用 save_asset(category, name, source_image, tags)：
  1. 计算下一个顺序编号（角色 CH-002...、道具 PR-001...、场景 SCN-001...）；
  2. 通过 PIL 自动转换为高质量 WebP 格式存入 <tuku_dir>/<category>/<ID>.webp；
  3. 同步镜像到离线预览目录 images/custom/<category>/<ID>.webp；
  4. 写入外部图库的 library.json；
  5. 自动刷新画廊。

3. 替换基准图 (Replace Benchmark Image)

• 用户触发词：
  • 用这张图片替换角色 CH-002
  • 替换 CH-002 的基准图
  • 更新道具 PR-001 的图片
• 执行逻辑： 调用 replace_asset_image(asset_id, new_source_image)：
  1. 保留原编号与元数据不变；
  2. 将新图片转换为 WebP 覆盖写入 <tuku_dir>/<category>/<ID>.webp 与镜像缓存；
  3. 更新外部 library.json 的 updated_at 时间戳；
  4. 自动刷新画廊，出图时即刻使用全新基准图垫图。