前言¶
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。
