1实现原理 · 为什么它能做到

实现原理极简：skill 不打包、不镜像任何图标文件，全部能力等于『固定 CDN 路径模板 + 图标名』的字符串拼接，由 agent 现场生成 URL 交给用户。

llm-icon-finder/SKILL.md

# PNG https://raw.githubusercontent.com/lobehub/lobe-icons/refs/heads/master/packages/static-png/{light|dark}/{icon-name}.png

这里在做什么：SKILL.md 用 4 个 URL 模板把 lobe-icons 仓库的静态目录约定固化下来（格式段 static-svg|static-png|static-webp + 主题段 light|dark + 图标名），因此本目录只有 3 个 markdown 文件，零二进制资产。

默认输出取向是『给链接而非给文件』：除非用户要下载，否则只回 URL；下载才用宿主 Bash 执行 curl。

llm-icon-finder/SKILL.md

1. Identify icon name (usually lowercase company/model name, hyphenated if multi-word) 2. Determine format (default: PNG) and theme (default: dark) 3. Construct CDN URL using pattern above 4. Provide URL to user 5. If download requested, use Bash tool with curl 6. Include web viewer link: `https://lobehub.com/icons/{icon-name}`

六步工作流同时定死三个默认值：格式默认 PNG、主题默认 dark、且无论是否下载都要附 lobehub.com/icons/{name} 网页查看器链接。

命名规则是唯一的知识本体：小写 + 连字符，多形态靠后缀（-color 彩色、-text 文字版）区分，中文名需先映射到英文 icon 名。

llm-icon-finder/SKILL.md

**Icon naming convention**: Lowercase, hyphenated (e.g., `claude`, `chatglm`, `openai`, `huggingface`)

同段上方还有 'Color variant (append -color to icon-name)'；实测 -color.png / -text.png 变体在 CDN 上确实存在（claude-color.png 200），说明后缀约定与上游目录一致。

中文查询靠内建映射表（智谱→chatglm、月之暗面→moonshot），并会主动给出同族相关图标。

llm-icon-finder/SKILL.md

**Chinese AI models**: Support Chinese queries (e.g., "智谱" → `chatglm`, "月之暗面" → `moonshot`)

示例段里同一映射再出现一次（'User: "找一下智谱的图标" → Identify: 智谱 = ChatGLM → icon name: chatglm'，并提示 mention related icons (zhipu, codegeex)）——这是把领域词典写进 prompt 的做法。

常用图标名录外置到 references/icons-list.md，按 Models / Providers / Applications / Chinese AI 四类分组，SKILL.md 只保留路由。

llm-icon-finder/SKILL.md

**Common icons**: See `references/icons-list.md` for comprehensive list organized by category (Models, Providers, Applications, Chinese AI)

名录共 57 行、去重后 44 个图标名（Models 12 + Providers 17 + Applications 11 + 中文 AI 表 17 行；中文表里有 4 个前三类未出现的新名：ai360 / aimass / aihubmix / codegeex），是 SKILL.md 之外唯一的数据文件，也是 404 排障的候选名池。

404 排障是三步而非重试：试 -color 后缀 → 试别名（company vs product，如 chatgpt/gpt、google/gemini）→ 引导去画廊浏览或搜仓库。

llm-icon-finder/SKILL.md

If URL returns 404: 1. Try `-color` suffix variant 2. Check alternate naming (e.g., `chatgpt` vs `gpt`, `google` vs `gemini`) 3. Direct user to https://lobehub.com/icons to browse 4. Search repository: https://github.com/lobehub/lobe-icons

讽刺之处：排障里给的别名 chatgpt/gpt 在 CDN 上实测都不存在（见 verification.second_pass 的 discrepancy 项），这一步的候选名本身就有过期风险。

开发者集成路径单列一份 reference：npm 包名（@lobehub/icons 及其 static-svg/png/webp、rn 变体）与 React 组件用法。

llm-icon-finder/references/developer-info.md

Icons can be installed as npm packages:

这条路径面向『把图标装进自己项目』的用户，与主流程（拼 URL 引用）是两条互不依赖的路线；实测这 5 个 npm 包在 registry 上均存在（HTTP 200）。

技能本体没有任何校验/回退代码：URL 是否可用只能靠用户或 agent 事后 curl 发现 404，skill 自身不含探测逻辑。

llm-icon-finder/SKILL.md

- Browse https://lobehub.com/icons - Try variations (e.g., company name vs product name: `alibaba` vs `alibabacloud`) - Check for `-color` variants if standard URL fails

『Uncertain names』一节把不确定性处理完全交给人/模型判断，没有清单校验脚本——这是它与自带 catalog 校验的同类 skill（如 hyperframes registry 类）的主要差别。

2核心能力

01按图标名生成可直接引用的 CDN URL（SVG/PNG/WEBP × light/dark，另有 -color 彩色变体）

02内置 44 个不重复的常用 AI/LLM 图标名录（57 行，按 Models / Providers / Applications / 中国 AI 四类组织）

03中文名 → 图标名映射（智谱→chatglm、月之暗面→moonshot、零一万物→zeroone/yi、通义千问→qwen 等）

04受控下载：用户要求时才用宿主 Bash 执行 curl -o 落盘（示例给 openai.svg / anthropic.svg）

05404 排障指引：变体后缀 → 别名候选 → 官方画廊/仓库检索

06开发者集成指引：5 个 npm 包（React / static-svg / static-png / static-webp / React Native）与 React 组件示例

07始终附网页查看器链接，便于人工确认图标外观

3外部依赖

Kind	Dependency / Endpoint
network	lobe-icons 静态资源 CDN（PNG，实测 200）
network	lobe-icons 静态资源 CDN（WEBP，实测 200）
network	lobe-icons 静态资源 CDN（SVG；文档写的 {light\|dark} 路径实测 404，实际位于 static-svg/icons/）
cli	curl（宿主 Bash 执行的下载动作）
network	图标画廊（人工浏览/确认外观）
network	上游仓库（排障检索入口）
package	@lobehub/icons（React 组件包；实测 npm registry 200）
package	@lobehub/icons-static-svg / @lobehub/icons-static-png / @lobehub/icons-static-webp / @lobehub/icons-rn（实测 4 个包 registry 均 200）
network	开发者文档站（图标库文档）

4管控建议与判定依据

建议配套管控措施

面向 Agent

声明可访问域名与密钥范围

面向管理者

密钥最小权限，保留请求日志

判定依据（文件路径与关键语句摘要）

网络端点: 声明外部网络访问: https://raw.githubusercontent.com/lobehub/lobe-icons/refs/heads/master/pack
本地工作目录: 文件读写与工件输出: 仅在用户明确要求下载时：宿主 Bash 执行 `curl -o <icon>.<ext>` 写入 agent/用户选定路径；SKILL.md 未规定固

审计说明： 。按六档范式第 3 档特征『常规网络调用（公开 API/官方 CLI），外发对象可预期』：本 skill 无脚本执行、无凭证读取、无本地写入（除用户主动要求下载），唯一外部动作是对固定公开端点 raw.githubusercontent.com/lobehub/lobe-icons 的读取，且路径前缀固定、不含用户数据外发——不涉及凭证/远程包执行，故不是橙色；但它确实产生网络访问并指导落盘，比同类纯文本 skill 多一层运行期依赖，故不给绿色。真正的留意点不在安全而在可靠性：①SKILL.md 的 SVG 路径模板（packages/static-svg/{light|dark}/）与上游现状不符（实测 404，实际在 static-svg/icons/），照抄会拿到坏链；②名录中 chatgpt / gpt / llama / lobechat 四个名字在 CDN 上不存在（实测 404，上游对应名字为 openai / meta / lobehub）；③URL 跟随上游 master 分支、未 pin 版本，上游目录重构即令本 skill 文档失效（本批已实测到一次）。

5第二遍独立确认

[ok] PNG / WEBP 端点可用性（skill 的主路径） — curl 实测：packages/static-png/dark/claude.png = 200、packages/static-png/dark/claude-color.png = 200、packages/static-png/light/claude.png = 200、packages/static-webp/dark/claude.webp = 200，不存在的名字（notarealicon123.png）返回 404 —— 主路径与文档模板一致，404 也可正常反映为 404。
[discrepancy] SVG 路径模板 vs 上游真实布局 — SKILL.md 写 `packages/static-svg/{light|dark}/{icon-name}.svg`，实测 packages/static-svg/dark/claude.svg = 404、.../light/claude.svg = 404、.../dark/claude-color.svg = 404；GitHub Contents API 显示 packages/static-svg 下只有 icons/ 子目录（无 light/dark 段），tree API 中 static-svg 路径 911 条、形如 packages/static-svg/icons/claude.svg，curl 实测 200。即 SVG 分支的模板已过期（PNG/WEBP 仍是 light|dark 布局，两条路径规则已不一致）。
[discrepancy] icons-list.md 名录逐名验证 — 把名录去重后的 44 个图标名逐个 GET static-png/dark/<name>.png：40 个 200，4 个 404 —— `chatgpt`、`gpt`、`llama`、`lobechat`；这 4 个名字在 static-svg/icons 的仓库树里同样不存在（tree API 过滤结果为空）。可用替代名实测均 200：openai（对应 chatgpt/gpt）、meta（对应 llama）、lobehub（对应 lobechat）。即名录是『上游旧名 + 别名』的混合体，需要 agent 现场纠偏（讽刺的是 SKILL.md 的 404 排障恰恰建议试 chatgpt/gpt 这两个已失效的名字）。
[ok] npm 包名真实性（developer-info.md） — curl registry.npmjs.org/<pkg>/latest：@lobehub/icons、@lobehub/icons-static-svg、@lobehub/icons-static-png、@lobehub/icons-static-webp、@lobehub/icons-rn 五个均返回 200，包名与用途注释对应无误；这些是给用户在自己项目里安装的指引，skill 运行期不会自动安装。
[ok] 画廊与仓库入口可达性 — https://lobehub.com/icons 返回 302（跳转，属正常站点行为）；https://github.com/lobehub/lobe-icons 为公开仓库且 tree API 可读（master 分支可访问，packages/ 下有 react-native、static-avatar、static-png、static-svg、static-webp 五个包）。文档给的四个外链（画廊/仓库/文档/npm 搜索）均非死链。
[ok] 功能声明 vs 实际能力（夸大检查） — SKILL.md/README 声称 '100+ icons'，实际上游规模远大：单 packages/static-png/dark 目录即含数百个 PNG（含 -color/-text 变体），static-svg/icons 有 911 个 svg 路径，且涵盖名录之外的品牌（如 adobe、aws、cursor、vercel）——声明属保守而非夸大。反面：declared 'Comprehensive' 的名录只 44 名、且含 4 个失效名，'comprehensive' 一词偏乐观。
[ok] 『支持中文查询』的映射来源 — SKILL.md 的 '智谱 → chatglm、月之暗面 → moonshot' 与 icons-list.md 的中文列表格（| `chatglm` | 智谱清言 | ChatGLM |、| `moonshot` | 月之暗面 | Moonshot (Kimi) | 等 17 行）一致，映射有仓内依据；但『智谱=ChatGLM』这类厂商别名词典属领域知识，仓内无法证真伪，只能确认两侧文本自洽。
[discrepancy] 下载示例可照抄性 — SKILL.md 的 Multi-icons 示例里 URL 用了省略号：`curl -o openai.svg "https://raw.githubusercontent.com/lobehub/lobe-icons/.../dark/openai.svg"`，and 完整可用的路径需要补 `packages/static-png`（SVG 情况还要改成 static-svg/icons）。照字面复制该示例会得到无效/404 请求；同一文档上方的模板段才是可执行形式。

6结论

极低成本、零依赖落地：3 个 markdown 就是全部，任何宿主直接可读，不装包不附脚本。

默认给链接而非落盘，集成方式对文档/README/演示最省事，也避免污染用户目录。

形态维度齐全：三种格式 × light/dark × -color 变体，一条模板覆盖所有常见引用需求。

44 名常用名录 + 中文映射，覆盖主流模型/厂商/应用与国内厂商，中文提问可直接落到 icon 名。

开发者路径完整：5 个真实存在的 npm 包 + React 用法，方便把图标装进工程项目而非仅引用。

适合： 适合：①写 README / 文档 / 演示 / 落地页时想快速拿到 Claude、OpenAI、Gemini 等品牌图标直链的人；②只想引用而不想往仓库里塞图标的团队（PNG/WEBP 直链最稳）；③需要中文名检索（智谱、月之暗面、通义千问）的中文用户；④要在自己前端项目里用 React 组件而非图片的开发者（走 developer-info.md 的 npm 路径）。

不适合： 不适合：①要求图标必须可长期稳定引用、不能破链的场合——上游是 master 分支直链，本批实测 SVG 模板已坏、4 个名录名字 404；②需要离线/内网环境（所有图标都在 raw.githubusercontent.com）；③需要图标元数据、许可证信息或品牌使用条款的场景——本 skill 只给图片直链，不提供授权/合规信息（品牌图标的使用许可需另行确认）；④期望 skill 自动校验名字是否存在的人（它不做任何探测，404 要你自己发现）。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload llm-icon-finder.tar.gz

sha256: 8c8f311d4974d206…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit d5c4678cb5.