前言¶
DSH 的扩展思路是「一切皆插件」，Web GUI 一侧的插件可以把侧边栏变成具体工具。这里介绍的 zengchunhua-boost/dsh-cat-star（喵星大道）就是一个 Web GUI 插件：上传猫的照片或视频，调用带图像能力的模型识别品种、按 CFA 品种标准的评分点逐项打分，输出总分、等级、雷达图、逐项点评、国内市场参考价和分享卡片，还可以发布到可选的公开榜单。
它维护者是 zengchunhua-boost，分类在插件目录里归为「趣味换装」，适合作为 Web GUI 插件接入的示例，也适合想做娱乐向 AI 评分产品的人参考。下面介绍安装、用法和边界。
适用前提与安全说明¶
这个插件以当前 dsh 进程的权限运行，能访问本机附件存储和宿主环境变量。安装前应先查看源码和许可证：许可证为 MIT（见 package.json），源码在 GitHub 上，建议确认后再装。插件是非 CFA 官方产品，与 CFA 无关联。
安装与启用¶
插件通过 DSH 的 dsh plugin 命令安装，需要指定 web profile：
# 从 GitHub 安装
dsh plugin --profile web add github:zengchunhua-boost/dsh-cat-star
# 本地开发（link 安装）
dsh plugin --profile web add link:/path/to/dsh-cat-star
安装后要重启一次 dsh web：新增的 Host 路由需要重启才生效；之后只改 client.js 刷新页面即可。装完侧边栏会出现「喵星大道」入口。
核心功能¶
- 侧边栏入口，点开即用，不占用会话。
- 支持图片和视频：1–4 张多角度照片，或一段视频自动抽 4 帧；视频文件本身不上传，只取帧。
- 品种可以留空，AI 自动识别概率最高的品种；手动选择则跳过识别。
- 按 34 个 CFA 品种的评分点和权重生成评分，输出加权总分、等级、能力雷达、逐项点评、亮点/扣分和下次拍摄建议。
- 结合品种行情区间给出国内市场参考价（宠物级），随评分一起生成。
- 名字可编辑，左侧输入框预填，结果页标题旁的 ✎ 可随时改，分享图、文案和榜单同步使用。
- 生成 1080×1440 分享图（含猫图、总分、雷达、参考价）和小红书/微博风格文案，一键复制。
- 可选发布到公开榜单，只上传 160px 缩略图加名字/品种/分数/评语，不传原图。
- 本地保留最近 10 次评分，支持按分数排行。
- 界面用 iOS 风格：系统字体、分组卡片、Large Title、分段控件，深浅色自动适配。
典型用法¶
1、侧边栏点「喵星大道」。
2、上传猫片或视频；名字可填可不填；品种留空会自动识别。
3、点「开始评分」，等待 5–40 秒。
4、看分数和参考价，可以生成分享图、复制文案、保存历史，或发布到公开榜单。
发布榜单前会弹出命名框确认。默认发布到 README 给出的公开实例，公开页国内直连可达：https://dsh-cat-beauty-leaderboard.netlify.app；数据后端是 Cloudflare Worker + KV（dsh-cat-beauty-leaderboard.vrchunsir-catbeauty.workers.dev），部署方式见 leaderboard/README.md。
配置¶
评分模型和榜单地址都可以改：
| 项 | 位置 | 默认 |
|---|---|---|
| 裁判模型 | 环境变量 DSH_CAT_JUDGE_PROVIDER / DSH_CAT_JUDGE_MODEL |
deepseek-official / deepseek-flash（需图像能力） |
| 榜单入口 | client.js 的 LEADERBOARD_URL |
内置公开实例 |
| 榜单转发目标 | Host 环境变量 DSH_CAT_LEADERBOARD_URL |
内置 Netlify 入口 |
想用自己部署的榜单：部署 Worker 后，把 client.js 顶部 LEADERBOARD_URL 改掉，并设置 Host 环境变量 DSH_CAT_LEADERBOARD_URL 指向自己的 Netlify 入口。
已知边界¶
- 评分是 AI 主观判断：同一只猫换角度、光线或品种选择，分数会变，不能当购猫或繁育依据。
- 参考价是区间估价，受血统、证书、地区、年龄影响，仅供娱乐参考，不构成交易建议。
- 模型偶尔输出格式漂移的 JSON，Host 端做了截断修复、尾随逗号处理和自动重试；仍失败时错误卡片可展开「查看模型原始输出」。
- 视频只支持浏览器能解码的容器/编码，MP4/H.264 最稳，WebM 次之，单个文件 ≤50MB。
- 上传的图片会经
ctx.attachments存进本机附件存储，DSH 不做自动清理，敏感照片不要上传。 - 榜单 KV 有约 60 秒最终一致性延迟，发布后榜单页最多 1 分钟可见。
开发¶
仓库自带测试：node test/cat-star.test.mjs（插件测试 22 项）和 node leaderboard/test/worker.test.mjs（榜单 Worker 测试 6 项）。package.json 里标注 engines.node >=20。
评分点数据来自 src/breeds.js，各品种的评分点与满分转录自 CFA 官网品种页的 Point Score 表（2026-11-04 抓取），priceHint 是国内宠物市场常见行情估算区间。
小结¶
这套插件的价值在于把「图像识别 + 结构化评分 + 估价值 + 分享」这条链路完整落到 DSH Web GUI，同时把娱乐性和严肃用途划清界限。目录页在 https://www.skillhub.cn/plugins/zengchunhua-boost/dsh-cat-star，源码在 https://github.com/zengchunhua-boost/dsh-cat-star。
