# 西行云途 · 战斗 + 在线PK（纯静态单页原型）

赛博水墨风格的「战斗闯关 + 在线PK」可运行网页原型。单文件 `index.html`，内联 CSS/JS，零外部依赖，数据模拟与进度均在前端完成。

## 功能概览

### 1. 顶部 HUD
- 当前关卡、双积分余额（仙途勋值 / 梵言书卷值）、胜场实时展示。
- 「↺ 重置进度」可清空 localStorage 存档重新体验。

### 2. 回合制闯关（6 关）
- 关卡列表从 `battle_pk.json` 读取：关名 / 地点 / BOSS 名 / 推荐战力 / BOSS 生命 / 奖励。
- 关卡按前置通关顺序解锁（第 1 关默认开放）。
- 选关进入战斗：师徒 4 人（玄清行者 / 石明小石 / 亥悟 / 尘净，纯 SVG 布衣 Q 版）+ 1 灵宠，对战抽象元素灵怪 BOSS（云 / 石 / 土 / 水 / 火 / 金，纯 SVG 非写实）。
- 每回合可选战术：**普攻 / 技能齐发 / 灵宠增益 / 结界防御**，并可在 4 款灵宠间切换。
- HP 血条动画 + 伤害飘字；胜负判定后按规则产出积分：
  - 首通额外 +50% 仙途勋值、全员存活 +20%、≤10 回合速通 +15%。
  - 积分与通关记录写入 `localStorage`。

### 3. 在线 PK（1v1 / 5v5）
- 模式切换；展示公平匹配规则（战力区间 ±15%、30 秒上限、超时放宽、段位优先）。
- 「开始匹配」→ 扫描动画 → 匹配到战力 ±15% 内的 AI 对手。
- 双方阵容展示 → 「开战」自动推进回合，伤害飘字、回合日志、胜负判定。
- 积分按规则结算：胜利 150 仙途勋值 +30 梵言书卷值，失败 30 安慰奖；三/五连胜额外加成；每日 PK 积分上限 1000（防刷分）。均写入 `localStorage`。

### 4. 灵宠图鉴
- 4 款灵宠卡片：小石灵 / 月绒兔 / 文甲龟 / 云羽雀，含专属被动 Buff 说明（防御 / 治疗 / 护盾 / 速度暴击）。
- 战斗中生效：石灵坚韧（减伤+致命免疫）、月华庇佑（每回合回血）、文甲御盾（开局护盾+重生）、云羽疾风（暴击+先手）。

## 本地预览

直接双击打开，或启动任意静态服务：

```bash
# 方式一：直接打开
open battle-pk/index.html        # macOS
# 或浏览器拖入该文件

# 方式二：本地静态服务
cd battle-pk
python3 -m http.server 8080
# 浏览器访问 http://localhost:8080
```

> 进度保存在浏览器 `localStorage`（键名 `xyyt_battle_save_v1`），刷新不丢失；点 HUD「重置进度」可清零。

## 视觉与版权脱敏说明

- **赛博水墨风格**：深蓝紫渐变背景 + 网格底纹 + 霓虹发光；主色 `--cyan:#5fe3ff` / `--purple:#b98cff` / `--gold:#ffd479`，与 `cyber-hiking/index.html` 保持一致（HUD 栏、信息面板、霓虹按钮、网格背景、toast 弹窗等）。
- **角色脱敏**：师徒用「玄清行者 / 石明小石 / 亥悟 / 尘净」，灵宠用「小石灵 / 月绒兔 / 文甲龟 / 云羽雀」，积分为「仙途勋值 / 梵言书卷值」，**无任何原版西游 IP 名称或形象**。
- **美术全部为纯 SVG 绘制**：角色、灵宠、BOSS 均为布衣 Q 版抽象造型，非写实、无外部图片资源。
- **技术约束**：单文件 `index.html`，内联 CSS/JS，零外部依赖；战斗与积分由前端 JS 模拟，进度存 `localStorage`。

## 文件结构

```
battle-pk/
├── index.html   # 完整可运行网页（内联 CSS/JS）
└── README.md    # 本说明
```