# 美术资源规范（assets/）

> 本目录存放斗地主插件的全部美术资源。`assets/` 随仓库入库（`scratch/` 不入库）。

## 目录结构

```
assets/
├── deepseek-blue.svg    # 品牌素材（DeepSeek 蓝，用户提供）：默认头像 + 牌背设计源
├── deepseek-black.svg   # 品牌素材（DeepSeek 黑，用户提供）：默认头像 + 牌背设计源
├── cards/               # 扑克牌：54 张正面 + 牌背 + 底牌
├── avatars/             # 默认头像（派生自品牌图）
├── ui/                  # 牌桌、按钮、图标、LOGO、背景
├── sound/               # 音效（发牌/出牌/炸弹/结算…）
└── README.md            # 本规范
```

## 品牌素材（默认头像与牌背的设计源）

- `deepseek-blue.svg`（蓝 `#4D6BFE`）与 `deepseek-black.svg`（黑 `#2c2c2c`）为同一 DeepSeek 品牌图形、两种配色。
- **默认头像**：基于这两张图制作 `default-01`（蓝）与 `default-02`（黑）；后续如需更多变体，可派生（反色/裁剪/加边框）。
- **牌背**：同样以这两张图之一为设计基底（默认用蓝，黑可作为底牌/地主变体）；在浅色牌桌上使用纯色底和细边界，避免复杂纹理抢夺牌面信息。
- 使用注意：保持图形完整不变形；不用于与 DeepSeek 官方无关的误导性用途。


## 命名规范

| 资源 | 命名规则 | 示例 |
|---|---|---|
| 扑克牌正面 | 点数+花色：`C03`(梅花3) `S10`(黑桃10) `HA`(红心A) `D2`(方块2)；王：`JOKER-B`(小王) `JOKER-R`(大王) | `S10.svg`, `JOKER-R.svg` |
| 牌背 | `back.svg`（普通牌背）、`back-bottom.svg`（底牌牌背可区分色）；设计源=品牌图 | `back.svg` |
| 头像 | `default-01.svg`(蓝) `default-02.svg`(黑)，派生自品牌图 | `default-01.svg` |
| UI | 小写下划线：`table-bg`, `btn-primary`, `icon-coin`, `logo` | `btn-primary.svg` |
| 音效 | 小写下划线：`deal`, `play`, `bomb`, `spring`, `settle`, `rankup` | `bomb.mp3` |

## 规格

### 扑克牌 `cards/`
- 格式：**SVG 源文件 + PNG 导出**（`@1x` 与 `@2x`，如 `S10@2x.png`）。
- 正面尺寸：SVG viewBox `0 0 120 168`（宽高比 5:7）。
- 牌面元素：左上角点数/花色、中央大花色、角标；点数数字用无衬线字体。
- 颜色：黑桃/梅花黑，红心/方块红；王用描金风。
- 牌背：以品牌图（蓝/黑）为基底，纯色底 + 细边界，保持「梁」的辨识度并适配浅色牌桌。

### 默认头像 `avatars/`
- 规格：方形，`256×256`（`@2x` 512 用），SVG 优先。
- **当前**：`default-01`（DeepSeek 蓝）、`default-02`（DeepSeek 黑），直接派生自 `assets/deepseek-blue.svg` / `deepseek-black.svg`。
- 后续可派生更多变体（反色、裁剪居中、加描边）扩充默认头像库。
- 约定：头像只做展示用，不做收费皮肤（皮肤 Phase 2 另议）。
- 自定义头像：**暂缓**（需启用 R2/绑卡），设计见 docs/架构设计.md §3.5。

### UI `ui/`
- 牌桌背景、筹码图标（Token 币）、按钮态（normal/hover/disabled）、段位徽章 ×6（小难梁→梁祖）、LOGO、等待/加载动效。
- 白色内容面和浅灰牌桌为默认底色，主强调色使用 DSH 蓝（`#4D6BFE`），辅助色红/金用于「地主/胜利/段位」。
- 图标统一线性风（stroke），导出 `@1x/@2x`。

### 音效 `sound/`
- 格式：MP3（短，< 300KB/条）或 Web Audio 合成（优先）。
- 事件：`deal`（发牌）、`play`（出牌）、`pass`（过）、`call`（叫/抢地主）、`bomb`（炸弹/王炸）、`spring`（春天）、`settle`（结算计数）、`rankup`（升段）、`coin`（签到到账）、`lose`（破产）。
- 风格：轻量、不吵，可叠加开关（设置页「音效」）。

## 视觉风格总则（贴合 DSH）
1. **浅色优先**：牌桌/面板以白色和浅灰为底，蓝色只用于信息与关键操作。
2. **克制动效**：出牌轻位移、炸弹抖动、结算计数滚动；不用夸张粒子。
3. **技术感**：Token 金额、倍数、倒计时用等宽数字（tabular-nums）；文案可带工程师梗（见策划文档 §5.4）。
4. **品牌贯穿**：DeepSeek 品牌图作为「默认头像 + 牌背」的统一元素，强化辨识度（见上文「品牌素材」）。
5. **可访问性**：花色除颜色外要有符号区分（♠♥♣♦），色弱可辨。

## 当前接入
- 牌面仍使用 Unicode + CSS 卡片，默认头像直接使用 `deepseek-blue.svg` / `deepseek-black.svg`，未揭示底牌使用黑色品牌图牌背。
- 为避免 DSH 插件运行时无法解析仓库内静态路径，客户端通过 `src/client/brandAssets.ts` 将上述两份 SVG 内嵌为 Data URI；`assets/` 中的 SVG 仍是唯一源素材。
- 发牌、底牌揭示和出牌使用 CSS 动画，音效仍以 Web Audio 合成为主。