# TapTap CLI Skill: 图片素材库

处理当前游戏的图片素材：按图标、宣传图、截图和 Windows 素材等场景检索与批量筛选，整理真实游戏截图，并为允许生图的场景生成、校验和收录本地候选图。

- 网页版: /v3/cli/#skill-taptap-asset-library
- Markdown: /v3/cli/skills/taptap-asset-library.md

## 摘要

| Skill ID | 分组 | 类型 | 作用域 | 主要命令数 | 确认要求 |
| --- | --- | --- | --- | --- | --- |
| taptap-asset-library | Assets | 命令调用 | 应用 | 7 | 有（图片收录写入） |

## 行为与边界

这项能力用于为游戏寻找或整理图片素材，包括图标、宣传图、真实游戏截图和 Windows 素材。只需要一种素材时，查找这一种素材；需要多种素材时，一次返回各类素材的候选和推荐项。没有匹配结果时会明确说明。开始补充素材前，先确认是否已有本地素材或真实游戏截图；有文件时优先校验和整理原文件。

没有合适的本地素材时，可以为图标、宣传图或 Windows 素材准备候选，但不能生成游戏截图。生成的图片需要经过本地规则检查；通过检查不代表已经上传或写入资料字段。用户确认后，再继续上传本地图片或收录已有 HTTPS 图片。

> 检索会保留候选图片和推荐结果；模型只允许为图标、宣传图和 Windows 素材生成候选，不能生成游戏截图。上传或收录操作会先展示目标图片和所属游戏，确认后再写入素材库。

## 能力摘要

- 按单个目标场景检索素材候选与推荐项。

- 一次批量检索多个素材场景。

- 排除已看过的候选并获取替换参考图。

- 优先整理本地图片和真实游戏截图，按当前规则校验图片文件。

- 为允许生图的场景生成本地候选图片并完成规则校验。

- 上传本地图片并自动收录，或收录已有 HTTPS 图片。

## 你可以这样问

- 我想给游戏找图标、宣传图或截图，有合适的素材吗？

- 我手头有一些图片和真实游戏截图，能帮我看看哪些适合使用吗？

- 我没有合适的图标或宣传图，可以帮我准备一些候选吗？

## 示例

```bash
taptap-cli skills read taptap-asset-library
taptap-cli asset-library search-assets --dev-id <developerId> --app-id <appId> --data '{"target_scene":"ICON"}'
taptap-cli asset-library +ai-image-rules
taptap-cli asset-library +ai-image-validate .taptap/ai-image/<run-id> --rule <rule>
taptap-cli upload ./icon.png --dev-id <developerId> --app-id <appId> --idempotency-key <image-key> --dry-run
taptap-cli upload ./icon.png --dev-id <developerId> --app-id <appId> --idempotency-key <image-key> --yes
```

## 用户可见输出边界

会说明匹配的使用场景、可用候选、推荐图片、没有结果的原因、收录状态和下一步。

## 主要命令

| 命令 | 类型 | 说明 | 输入 | 输出 | 注意事项 |
| --- | --- | --- | --- | --- | --- |
| asset-library search-assets | 只读 | 按一个目标场景查询素材候选与推荐项 | 目标使用场景、需要排除的候选图片（可选） | 候选列表 + 推荐项 | 优先采用当前结果给出的推荐项；没有匹配时会返回空结果 |
| asset-library batch-search-assets | 只读 | 一次查询多个目标场景的素材候选 | 多个目标使用场景 | 按场景分组的候选与推荐项 | 多个场景不要循环调用单场景检索 |
| asset-library +ai-image-rules | 只读 | 读取当前允许生图场景的图片规则 | 无额外业务参数 | 可生图场景、尺寸、格式和限制 | 开始生图前必须读取，不凭经验猜规格 |
| asset-library +ai-image-plan | 辅助 | 根据当前规则生成允许场景的本地生图计划 | 目标场景、创作要求、输出目录 | 生图计划和候选输出目录 | 只用于图标、宣传图和 Windows 素材；不能生成游戏截图 |
| asset-library +ai-image-validate | 只读 | 校验本地候选图片是否符合当前规则 | 本地图片路径、目标场景 | 逐文件校验结果和修复建议 | 校验通过仍未上传，需展示候选并取得确认 |
| upload | 写入 | 上传本地图片并自动收录进当前游戏素材库 | 本地图片路径、厂商 ID、游戏 ID | 上传结果 + 已收录素材 | 先 --dry-run，确认后 --yes；成功后不重复收录 |
| asset-library ingest-image-to-assets | 写入 | 把已有 HTTPS 图片收录到当前游戏素材库 | 安全网络图片地址（HTTPS） | 收录结果 | 只用于已有 HTTPS 图片，不用于本地文件 |