Dashboard Icons 评测 服务匹配、主题变体与格式

使用固定的 3515 项本地图标目录,实测 Dashboard Icons 名称别名、主题变体、资源路径与模糊匹配上限,说明智能体选图的验收方法。

AgentIndex · 发布于 2026-11-05 · 更新于 2026-11-05

Dashboard Icons 为仪表盘和应用目录提供服务标志,并通过 HTTP MCP 供智能体查询。它的实际价值在于帮助智能体找到已有图标,再返回真正声明可用的格式,减少从产品名称臆造文件名。采用时需要判断的是:一个匹配结果经过哪些步骤,才能成为正确显示的品牌图标?

本地目录检查能按调用顺序匹配 Plex、Home Assistant、Pi-hole、qBittorrent,也能解析别名、选择声明的浅色变体。同时发现两个消费端需要处理的边界:模糊搜索有单次预算,排序分数也不是概率。资源可用性验证的是固定仓库的清单与实际受跟踪路径,没有测量实时 CDN。

固定源码与十二项检查

本篇在 2026 年 11 月 5 日评测,固定十一月四日提交 16c42dc580c144246651d322a079e535cb2b69f8,网站包版本为 0.2.0。该快照的元数据含 3515 个原生图标条目。这个数字是目录条目数,不是全部外部来源去重后的品牌数,也不是每一种格式文件的数量。项目说明

十二项检查在 macOS arm64、Node.js 26.12.1 下执行真实目录、搜索、变体、文件清单和 URL 模块。原生元数据加载器替换为提交内 JSON,外部目录返回空替身;为独立运行,还替换了 Next 服务端标记和框架错误辅助函数。未测试部署中的 MCP 传输、OAuth、投稿、浏览器渲染或 CDN 在线状态。复现脚本与指纹

输入或条件本次观察
Plex、Home Assistant、Pi-hole、qBittorrent匹配正确原生条目,保留请求顺序
别名 8311 community解析为 8311
搜索 github whiteGitHub 排首位,选择声明的 light 变体
GitHub 详情 URL格式符合清单,路径存在于 Git 树
仅位图的 radarr-3d有 PNG,没有补造 SVG
人工不存在的文件名不推断格式可用性
十一个需模糊查找的名称后接 Plex第十一个标记 fuzzy_limit,Plex 仍匹配
超过一百字符的查询拒绝
连续两页、每页五条这两页之间没有重复
外部空目录替身标记来源降级,原生 Plex 仍可返回

结果说明一个快照上选定目录逻辑的行为,没有证明全库标志均正确、最新或视觉风格完全一致。

先解析身份,再使用资源链接

对空格、标点进行规范化,可以把服务名称转成目录身份。测试中 Home Assistant 对应 home-assistant,qBittorrent 对应 qbittorrent;显式别名也能定位所属条目。返回结果保留调用者原始服务字符串,便于智能体更新正确的配置项。目录实现

生成仪表盘时,建议保留这层映射直到页面显示验收完成。展示名称、目录 slug 与文件名有关联,却不是同一个字段。先确认条目,再获取 URL,比把任意名称转小写后直接加 .svg 更符合目录实际结构。

四个常见服务只是样例,不是全库相关性基准。生僻产品或简短歧义词仍可能需要从候选中人工选择。本次没有覆盖所有服务的带标签准确率样本,也没有给匹配系统计算统一成功率。

分数用于排序,不表示确定概率

Plex 的返回分数为 3.6,Home Assistant 为 3.39。超过一的值已说明不能直接换算成“百分之多少可信”。源码将名称、别名和其他信号组合成排序分数。搜索实现

消费端应把它当作带身份和预览的候选。在多个产品共享短名称时,保留备选并允许确认品牌。排名靠前不等于已经独立验证该图标属于当前服务。

批量匹配对新出现的规范化模糊名称设置十次预算。测试里的第十一个未知式名称得到空最佳匹配和 fuzzy_limit,但排在后面的精确 Plex 仍可成功。因此应把“本轮模糊预算用完”与“目录不存在该图标”分开,随后缩小或拆分剩余查询。原样重试大批次,并不会改变这条边界。

主题键不一定对应独立后缀文件

搜索 github white 选中了 light 变体。该快照中,GitHub 浅色 SVG 指向 github-light.svg,而 default 与 dark 都指向基础 github.svg。主题键的存在,并不意味着必然有一个对应后缀的独立文件。

原生详情根据声明的变体和提交内文件清单,返回各格式 URL。测试同时核对这些 URL 与清单及 Git 树路径。人为不存在的名称不会得到格式;只含位图的条目有 PNG 而没有臆造 SVG。原生格式处理

集成时应采用详情返回的链接,并处理首选格式缺失,不宜假设每个图标都有三种格式和两种后缀。这里的路径存在检查没有测量 CDN 响应、缓存新鲜度、页面对比度或图片尺寸。如果项目要求可重复构建,还需要自行决定怎样固定资源版本,或纳入项目自身的资源流程。

来源降级要保留在结果里

外部来源返回空替身时,真实目录逻辑会标记 selfh.st、LobeHub、Simple Icons 降级,同时仍返回原生 Plex。注入原生元数据加载失败后,限定原生来源的查询返回空结果,并标记原生来源降级。这有助于避免把“目录暂不可用”误读成“产品没有图标”。

来源身份也关系到格式与许可字段。测试中的原生 GitHub 详情,其逐图标 license 为 null;仓库 Apache-2.0 许可不会自动填入这个字段。README 另有品牌归属和外部来源说明,消费端应保留已提供的出处信息,而不是补造逐图标许可。仓库与来源说明

选型建议

Dashboard Icons 适合仪表盘、服务目录,以及需要从现有集合获取可识别标志的智能体。文档中的端点支持公开查询,账号与投稿属于另一套流程;本次没有登录、投稿或修改任何客户端配置。MCP 接口说明

可先拿一小份真实服务列表试用,查询详情后在目标背景检查变体,并明确处理格式缺失和来源降级。需要更广的界面设计判断,可看 Taste Skill 浏览器检查评测;如果要单独诊断 MCP 传输,可看 MCP TypeScript SDK 评测。