# 📜 添加古风官职字符到字体子集

## 📋 需要添加的字符

古风官职文本中的特殊字符（可能缺失）：

```
— 庶 民 太 尉 谏 给 簿 司 户 录 丞 判 殿
```

---

## 🚀 方法1：运行Python脚本（推荐）

```bash
cd E:\GitHub\blog

# 运行合并脚本
python scripts/merge_ancient_chars.py

# 重新生成字体子集
python scripts/subset-font-safe.py
```

---

## 🚀 方法2：手动添加字符

### 步骤1：编辑字符列表

打开文件：`themes/Ying/static/font/used_chars.txt`

在文件末尾添加：

```
—庶民太尉谏给簿司户录丞判殿
```

### 步骤2：重新生成字体子集

```bash
cd E:\GitHub\blog

# 重新生成字体子集
python scripts/subset-font-safe.py
```

---

## 🧪 验证添加成功

### 检查字符列表

```bash
# 查看字符列表
type themes\Ying\static\font\used_chars.txt

# 搜索特殊字符
findstr "—" themes\Ying\static\font\used_chars.txt
```

### 检查字体文件

```bash
# 查看字体文件大小
dir themes\Ying\static\font\zql-v2-subset.*
```

**预期：** 字体文件大小应该略有增加（包含新字符）

---

## 📊 预期效果

### 字体大小变化

| 指标 | 添加前 | 添加后 | 变化 |
|------|--------|--------|------|
| **字符数** | 2,485 | ~2,500 | +15 |
| **字体大小** | 757KB | ~760KB | +3KB |

**说明：** 增加15个字符，字体大小增加约3KB（可忽略）

---

## 🎯 使用场景

### 古风官职系统

这些字符用于：

```
正一品 太师 2000
从一品 太尉 1400
正二品 参知政事 1050
...
正九品 主簿 15
从九品 司户参军 5
— 庶民 0
```

**应用场景：**
- 古风游戏
- 历史题材文章
- 等级系统展示

---

## 💡 后续优化

### 如果还有其他特殊字符

1. 收集所有需要的特殊字符
2. 添加到 `used_chars.txt`
3. 重新运行字体子集化

### 自动化

**GitHub Actions会自动处理：**
- 当你发布包含这些字符的文章时
- 自动重新生成字体子集
- 自动部署到UpYun

---

## 🔄 回滚方案

### 如果出现问题

```bash
# 恢复原始字符列表
git checkout themes/Ying/static/font/used_chars.txt

# 重新生成字体子集
python scripts/subset-font-safe.py
```

---

## ✅ 完成确认

### 检查清单

- [ ] 字符已添加到 used_chars.txt
- [ ] 字体子集已重新生成
- [ ] 字体文件大小略有增加
- [ ] 新字符可以正常显示

### 测试

```bash
# 启动Hugo
hugo server -D

# 访问包含古风官职的页面
# 检查字符是否正常显示
```

---

**添加古风官职字符指南完成！** 🎉

**按照指南操作即可完成字符添加！**