# 三国故事集接入说明

本目录只包含六个战役/政变故事页，不包含也不依赖 `three-kingdoms-parallax` 转场素材。

## 稳定入口

- 总入口：`index.html`
- 机器可读清单：`manifest.json`
- 独立故事：`stories/<id>/index.html`

每个故事目录均自包含 HTML、CSS、JavaScript、五张 WebP、本地行书字体、装饰 SVG 与本地史料数据，可单独托管或嵌入现有路由。除五丈原沿用用户已经指定的本地音乐外，其他页面没有音频依赖。

后续接入主站时优先读取 `manifest.json` 的 `stories[].entry`、`cover`、`title`、`summary` 与 `sceneCount`，不要扫描目录猜路径。

## 三国鼎立页接入

主站路由 `/sanguo/stories` 以 `三国鼎立.html` 为档案选择页，以本目录的独立故事为详情页。档案页使用的短 ID 与故事集正式 ID 不完全相同，必须按下表映射：

| 三国鼎立短 ID | 故事集 ID | 入口 |
| --- | --- | --- |
| `jieting` | `jieting-battle` | `stories/jieting-battle/index.html` |
| `wuzhang` | `wuzhang-plains` | `stories/wuzhang-plains/index.html` |
| `gaopingling` | `gaopingling-coup` | `stories/gaopingling-coup/index.html` |
| `caomao` | `cao-mao-death` | `stories/cao-mao-death/index.html` |
| `wei-shu` | `wei-conquest-shu` | `stories/wei-conquest-shu/index.html` |
| `zhonghui` | `zhong-hui-rebellion` | `stories/zhong-hui-rebellion/index.html` |

当前主站使用同源 iframe 双层交接：档案页点击主卡后先发送 `three-kingdoms-story-prefetch` 预载故事，再在画幅扩展完成时发送 `three-kingdoms-story-enter`；主站详情层淡入接管。返回档案时，主站向档案页发送 `three-kingdoms-story-reset`，恢复原卡片和滚动状态。