HSGuru-Chinese-Plus

当前版本：v2.1.0

---

📌 项目简介

HSGuru-Chinese-Plus 是一款 ScriptCat / Tampermonkey 用户脚本，适用于 HSGuru（炉石传说数据统计网站）。

该脚本提供以下能力：

• 网站界面文本中文化
• 页面样式优化与视觉增强
• 卡组与卡牌信息翻译
• 本地缓存与自定义配置支持

---

🧭 使用说明

自动生效

安装后访问 HSGuru 即可自动生效：

• UI 自动翻译
• 卡组 / 卡牌翻译
• 页面样式优化
• 广告隐藏

---

⚙️ 配置面板

点击导航栏 ⚙️ 按钮可打开：

• 功能开关（界面 / 翻译 / 增强）
• 自定义卡组翻译
• 自定义卡牌翻译

---

💾 数据存储

存储键	说明
hsguru_config	功能配置
hsguru_custom_deck_names	自定义卡组翻译
hsguru_custom_card_names	自定义卡牌翻译
hsguru_card_*	卡牌翻译缓存
hsguru_card_image_*	卡牌图片缓存

---

✨ 功能特性（Features）

🎨 界面处理

• 页面基础样式优化（背景 / 导航 / 卡片）
• 筛选器与排行榜 UI 调整
• 表格优化（斑马纹 / 行距 / 职业色）
• 法力水晶图标替换
• 死亡骑士符文样式增强
• 标题与排版优化

---

🌐 翻译处理

• UI 文本翻译（导航 / 按钮 / 表头等）
• 卡组名称自动翻译（支持规则与自定义）
• 卡牌名称翻译（API + 多级缓存）
• Omni Bar / 排行榜 / 标签翻译
• 页面标题与表格翻译

---

⚡ 功能扩展

• 广告移除
• 卡牌悬浮中文预览
• 卡组复制增强
• 返回顶部按钮
• 职业配色系统
• 移除卡牌跳转链接

---

📄 页面支持

页面路由	翻译	美化
/decks	✅	✅
/meta	✅	✅
/matchups	✅	✅
/leaderboard	✅	✅
/leaderboard/points	✅	✅
/leaderboard/player-stats	✅	✅
/leaderboard/rank-history/*	✅	✅
/leaderboard/player-history/*	✅	✅
/streamer-decks	✅	✅
/deck/<id>	✅	✅
/card/<id>	✅	✅
/card-stats	✅	✅
/cards	✅	—
/esports	✅	—

---

🔧 实现细节（Implementation）

🌐 翻译策略

1. 静态映射（staticPrefix）
2. 符文组合生成
3. 用户自定义翻译
4. 动态生成

---

⚡ 缓存机制

多层缓存策略：

• 内存缓存
• localStorage 持久化
• API 回退机制

---

🗂️ 缓存结构

• translationCache（LRU）
• queryCache（WeakMap）
• cardCache
• cardImageCache
• staticPrefix

---

🧠 技术特点

• MutationObserver 动态响应
• 幂等保护机制
• 请求队列与并发控制
• 多级缓存架构
• 配置持久化

---