# 西行云途 · AI拟人灵宠NPC（纯静态单页原型）

基于「赛博水墨」视觉风格的 **AI拟人灵宠 NPC** 前端原型，零外部依赖，单文件 `index.html` 可直接在浏览器打开运行。

## 功能概览

1. **4 款灵宠展示** —— 左侧图鉴切换：小石灵 / 月绒兔 / 文甲龟 / 云羽雀，每款均为纯 SVG 绘制（布衣 Q 版、非写实）。
2. **双形态切换** —— 每款灵宠支持「兽形 / 拟人布衣娃娃」实时切换，同一灵宠两套 SVG 造型。
3. **AI 伴读对话** —— 聊天框输入问题，基于 `ai_pet_dialogue.md` 问答模板做**关键词匹配**回复：命中当前灵宠专属关键词 → 回复对应内容；命中通用分类（问候 / 徒步 / 战斗 / 打卡 / 低落 / 闲置）→ 回复对应分类语；均未命中 → 通用伴读语。对话气泡使用灵宠 SVG 头像，附快捷问题 chips 一键体验。
4. **增益展示** —— 右侧卡片展示当前灵宠的「徒步增益」与「战斗增益」（数据源自 `ai_pet.json` 的 buffs）。
5. **皮肤收集系统** —— 每款灵宠含 2 款皮肤（共 8 款），用**仙途勋值 / 梵言书卷值**模拟解锁（写入 `localStorage`）；已解锁皮肤可点击应用，实时改变灵宠 SVG 配色。
6. **顶部 HUD** —— 当前随行灵宠、已解锁皮肤数、双积分余额（仙途勋值 / 梵言书卷值），含「模拟获得积分」「重置存档」。

## 本地预览

无需构建、无需联网。任选其一：

- 直接双击 `index.html` 用浏览器打开；
- 或本地起静态服务：
  ```bash
  cd /workspace/xixing-yuntu/ai-pet
  python3 -m http.server 8080
  # 浏览器访问 http://localhost:8080
  ```

## 数据来源

| 文件 | 用途 |
| --- | --- |
| `cyber-hiking/index.html` | 赛博水墨视觉规范（HUD/面板/霓虹/网格、主色 `--cyan #5fe3ff / --purple #b98cff / --gold #ffd479`） |
| `frontend/config/ai_pet.json` | 灵宠兽形/拟人描述、性格、增益、皮肤字段 |
| `output_text/desensitized/ai_pet_dialogue.md` | 4 款灵宠伴读对话 / 问答模板 / 战斗台词 |

## 版权脱敏说明

- 灵宠仅使用脱敏名：**小石灵 / 月绒兔 / 文甲龟 / 云羽雀**；
- 角色使用脱敏名：**玄清行者**、**石明小石 / 亥悟 / 尘净** 等；
- 全部美术为**纯 SVG 绘制的布衣 Q 版非写实形象**，无写实图片，无原版西游 IP 元素；
- 解锁 / 皮肤状态仅存于浏览器 `localStorage`（键名 `xixing_ai_pet_save`），积分均为前端模拟，不涉及任何后端或真实账号。

## 交互速览

- 切换左侧灵宠 → 舞台、增益、皮肤、快捷问题同步更新，灵宠主动问候；
- 切换「兽形 / 拟人布衣娃娃」→ 舞台与皮肤预览同步变形；
- 输入或点击快捷问题 → 灵宠按关键词匹配作答；
- 点击皮肤 → 积分足够则解锁并应用（变色），不足提示补积分；
- 「模拟获得积分」可补充双积分以便体验完整解锁流程。