# 本地图标库

> 这里是 skill 自带的**只读种子图标库**,**已入库一组商务红 tabler 种子集**(target / brain / chart-bar / users / trophy / alert-triangle / cpu / building-factory / cloud-network / database 等),覆盖大部分商务汇报场景 —— 直接 `glob` 读用即可。docker 沙盒里 `skills/` 是只读挂载,**不能往这儿写**。新场景按需 `fetch_icon.py` 拉,落点是 `<task_dir>/assets/icons/`(可写),本 task 内再用直接读不发请求。

## 缓存命名规约

```
<set>_<name>_<colorhex>_<sizepx>.png
<set>_<name>_<colorhex>.svg
```

例: `tabler_rocket_C00000_128.png` / `lucide_target_FFC107_96.svg`

## 推荐图标清单 (按业务主题)

种子集已含下列大部分;若某个本 task 缺,按下面命令拉到 `<task_dir>/assets/icons/`(种子库只读,新图标进 task 目录):

```bash
ICONS_DIR=<task_dir>/assets/icons   # 可写落点;<skill_dir>/scripts 来自 load_skill 头(只读可执行)

# 战略 / 目标 / 启动
for n in target rocket flag bulb; do
  python <skill_dir>/scripts/fetch_icon.py $n --set tabler --color C00000 --size 128 \
    -o "$ICONS_DIR/tabler_${n}_C00000_128.png"
done

# 数据 / 趋势 / 报表
for n in chart-bar chart-line trending-up calculator; do
  python <skill_dir>/scripts/fetch_icon.py $n --set tabler --color C00000 --size 128 \
    -o "$ICONS_DIR/tabler_${n}_C00000_128.png"
done

# 团队 / 流程 / 时间
for n in users settings calendar clock check shield-check arrow-right alert-triangle currency-yuan circle-check; do
  python <skill_dir>/scripts/fetch_icon.py $n --set tabler --color C00000 --size 128 \
    -o "$ICONS_DIR/tabler_${n}_C00000_128.png"
done
```

## 图标集对照

| 集名 | 风格 | 数量 | License |
|-----|-----|-----|---------|
| **tabler** ⭐ 推荐 | 描边、商务、克制 | 4500+ | MIT |
| lucide | 描边、克制 | 1500+ | ISC |
| heroicons | Tailwind 风、双重粗细 | 300+ | MIT |
| material-symbols | Google Material 描边/填充 | 3000+ | Apache 2.0 |
| carbon | IBM、克制专业 | 2000+ | Apache 2.0 |
| fluent | Microsoft、温和现代 | 4000+ | MIT |
| mdi | Material Design Icons 社区 | 7000+ | Apache 2.0 |

## 浏览找名字

打开 https://icon-sets.iconify.design/ 搜中英文关键词,复制图标名 (如 `tabler:rocket`),回来用 `--set tabler rocket` 拉。

## 主题色变体

同一图标按主色/辅色/强调色/灰各拉一份,文件名只在 `<colorhex>` 段不同:
- `tabler_target_C00000_128.png` (主红)
- `tabler_target_E15554_128.png` (辅红)
- `tabler_target_FFC107_128.png` (强调金)
- `tabler_target_595959_128.png` (灰)

## 用图标的硬规则

见 `references/icons.md §C` —— 风格统一、颜色限定、大小克制、不替表意、避 emoji。
