# Custom Asset Manager

管理自建图库（角色库、道具库、场景库）全生命周期资产。支持初始化与挂载图库目录、新增归档资产、替换基准图、修改名称与标签、安全删除资产、查询清单及自动刷新画廊。当用户提出“添加...

- Repository: https://github.com/yang0/handraw-style (6861 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add yang0/handraw-style --skill custom-asset-manager -g -a claude-code -y`
Codex: `npx skills add yang0/handraw-style --skill custom-asset-manager -g -a codex -y`
Cursor: `npx skills add yang0/handraw-style --skill custom-asset-manager -g -a cursor -y`
Gemini CLI: `npx skills add yang0/handraw-style --skill custom-asset-manager -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 自建图库资产管理器 (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. 自动刷新画廊，出图时即刻使用全新基准图垫图。

The rest: https://github.com/yang0/handraw-style/blob/HEAD/skills/custom-asset-manager/SKILL.md