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

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

核心职责分工

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

底层统一调用 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. 自动刷新画廊，出图时即刻使用全新基准图垫图。

4. 修改属性与标签 (Update Metadata)

• 用户触发词：
  • 把 CH-002 名称修改为：粉扑兔
  • 修改 CH-002 标签为：可爱, 萌系, 毛绒
  • 将 CH-002 英文名改为：Cute Pink Bunny
• 执行逻辑： 调用 update_asset_metadata(asset_id, name=..., name_en=..., tags=...)：
  1. 更新外部 library.json 中对应的资产属性；
  2. 自动刷新画廊，前端卡片即刻同步更新显示。

5. 安全删除资产 (Safe Delete)

• 用户触发词：
  • 删除角色库中的 CH-002
  • 从自建图库删除道具 PR-001
  • 清理角色：傲娇粉团
• 执行逻辑： 调用 delete_asset(asset_id)：
  1. 官方预置安全拦截：若目标为官方预置（如 CH-001 黑猫侍者），坚决拒绝删除并告知受官方保护；
  2. 从外部图库目录物理删除对应文件；
  3. 从镜像预览目录物理删除缓存文件；
  4. 从外部 library.json 资产清单中移除该条目；
  5. 自动重构画廊，卡片同步从画廊消失。

6. 查询资产列表 (List / Inspect)

• 用户触发词：
  • 查看我的自建角色
  • 当前自建图库有哪些资产
• 执行逻辑： 调用 load_custom_assets() 与 get_asset(id)，清晰列出当前图库目录、角色、道具与场景的数量、编号与名称。

安全守则与硬性约束

1. 官方预置神圣只读： 官方预置（CH-001 等）属于公共仓库核心资产，严禁被 delete_asset 或 replace_asset_image 篡改或删除。
2. 零路径硬编码： 严禁将用户的外部物理路径硬编码至 Git 追踪的代码或文档中。所有配置均经由 ~/.handraw-style/config.json 自动寻址。
3. 操作后必定刷新画廊： 任何增、删、改、换操作执行后，必须确保触发画廊重构，保证前端 assets.html 与本地磁盘数据 100% 强一致。
4. 自建资产索引与 Git 严格隔离： 自建资产编号与元数据统一导出至本地 gitignored 索引文件（images/custom/custom_assets.js），由浏览器端动态渲染加载，绝不可烘焙进 Git 追踪的静态 HTML 文件（assets.html 与 tutorials.html）中，确保用户私有资产 100% 零泄露。