Store zh CN

🇨🇳 中文 | 🇺🇸 English

Home · Troubleshooting · Changelog

皮肤商店

内置皮肤商店让你可以直接从卡片编辑器下载和安装社区皮肤。

工作原理

浏览 — 打开卡片编辑器 → 点击商店按钮（购物车图标）
下载 — 点击任意皮肤上的下载按钮
安装 — 卡片从 CDN 获取皮肤包并通过 skins-pro-hass 集成进行安装
应用 — 从卡片编辑器的皮肤下拉菜单选择已下载的皮肤

前置条件

必需：`skins-pro-hass` 集成

皮肤商店需要配套集成：

通过 HACS 安装：将 https://github.com/ha-china/skins-pro-hass 添加为自定义仓库（类别：Integration）
或手动将 skins-pro-hass/custom_components/skins_pro_hass/ 复制到你的 HA custom_components/ 文件夹
重启 Home Assistant

如果你只使用内置的 modern 皮肤，则不需要该集成。商店仅用于下载额外的皮肤。

网络访问

你的 HA 实例需要互联网访问才能连接到托管皮肤包的 CDN。

手动安装

如果商店无法使用（网络限制、没有集成等），你可以手动安装皮肤：

获取皮肤文件 — 以下方式任选：
- 克隆 skin-assets 分支：git clone -b skin-assets https://github.com/ha-china/Skins-Pro.git
- 或从社区成员的仓库下载

复制到 HA：

<HA 配置>/www/skins-pro/<皮肤名称>/
  ├── theme.css
  ├── strings.json
  ├── avatar.jpg
  ├── background.jpg
  ├── room-*.jpg
  ├── icon-*.jpg
  └── ...（皮肤目录中的所有文件）

注册皮肤 — 在卡片编辑器中，将皮肤名称添加到 downloaded_skins：
```
"downloaded_skins": ["<皮肤名称>"]
```
选择 — 皮肤现在出现在皮肤下拉菜单中。选择它并强制刷新。

皮肤商店机制

CDN 托管

皮肤包由 CI 流水线构建并上传到 CDN。每个皮肤包包含：

编译后的 CSS（theme.css）
处理后的图片（已调整大小、压缩）
元数据（strings.json）

版本管理

商店中的每个皮肤在其 strings.json 中都有一个 version 字段。当新版本可用时，商店会显示"新版本"徽章。更新会被下载并替换旧版本。

社区提交

社区皮肤通过 PR 提交。合并后，CI 会：

构建皮肤（处理图片、生成 CSS）
将包上传到 CDN
使其在商店中可用

提交指南见贡献皮肤。

可用皮肤

商店提供 60+ 个社区创建的皮肤（除内置的 modern 皮肤外）。点击缩略图查看完整预览。

🎮 游戏与动漫

皮肤	预览
animal-crossing
black-myth-wukong
cs-go
deltaforce
dota-2
genshin
golden-spatula
gta-6
gundam
hearthstone
honor-of-kings
league-of-legends
legend-of-zelda
maplestory
need-for-speed
plants-vs-zombies
pocket-monsters
spirited-away
stardew-valley
street-fighter-6
teyvat-assets
tom-and-jerry
ultraman
valorant
wall-e
witcher-3
world-cup-championship-night

🎨 艺术与设计

皮肤	预览
blue-and-white-porcelain
chinese-ink-wash-painting
oil-painting-classic
paper-ink-morning
starry-night
xuan-bamboo-shadow

🏠 智能家居与简约

皮肤	预览
free-layout
glass-smart-home
ios-27-light
plush-3d
prism-tide
quiet-luxury
red-smart-home
retro-luxury
smarto-minimal
soft-home
suzhou-moon-garden
warm-glass

🎬 电影与电视

皮肤	预览
chinese-odyssey-cinderella
chinese-odyssey-pandora
fantasy-westward-journey
farewell-my-concubine
forrest-gump
hongse-youhuo
iron-man
nezha-demon-child
peacekeeper-elite
resident-evil
romance-three-kingdoms