/custom-asset-manager

name: custom-asset-manager
description: 管理自建图库（角色库、道具库、场景库）全生命周期资产。支持初始化与挂载图库目录、新增归档资产、替换基准图、修改名称与标签、安全删除资产、查询清单及自动刷新画廊。当用户提出“添加到角色库”、“替换IP图片”、“修改角色名称”、“删除角色/道具/场景”、“初始化图库目录”等资产维护需求时使用。

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

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

---

核心职责分工

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

---

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

底层统一调用 Python 引擎：[`skills/handdraw-style-prompter/scripts/custom_library_manager.py`](../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% 零泄露。