# 怪物图鉴

## 文件

- `schema.json`：单个怪物记录的 JSON Schema。
- `terminology.json`：分类、身份形态、强化状态及来源等级词表。
- `sources.json`：资料源登记和使用限制。
- `data/monsters.json`：规范化怪物记录。
- `data/catalog-summary.json`：数量与覆盖范围统计。
- `scripts/import-monster-db.mjs`：可重复执行的事实字段导入器。

## 数据边界

当前种子数据覆盖 MHFU、MH3U、MH4U、MHGU、World/Iceborne、Rise/Sunbreak、Wilds、Stories 1/2 的社区跨作索引。全部记录均提供简体中文主名称，英文名作为检索别名保留。它不是全系列终版：初代、Dos、Frontier、Online、Explore 等仍需用独立来源补齐。

每条记录都有 `ecology` 字段。当前可追溯生态摘要优先来自 Wilds 与 Rise/Sunbreak 的简中游戏数据；没有游戏简中的条目可采用英语原文译为简中，并以 `summary_origin: translated_en_zh_hans` 和页面“依据英文资料翻译”标出。生态观察与栖息地来自 Wilds 简中结构化数据；World/Iceborne 另补充了可确定译名的栖息地。尚无原文或可靠中文资料的条目会保留空生态字段并在页面显示“尚未录入”，不将缺失误作不存在。

图鉴以“具名身份”为一条记录。亚种、稀少种、特殊个体和二名可拥有独立身份；带 `Apex`、`Risen`、`Guardian` 固定前缀的特殊身份不收录。跨作品联动怪物（包括鹿首精、古代鹿首精、贝希摩斯）也不收录。狂龙化、极限、狞猛、历战、历战王和傀异化通常记录为遭遇状态，不自动算作新怪物。

## 字段可信度

- `official_primary`：游戏、CAPCOM 官网、官方手册或官方出版物。
- `official_secondary`：官方宣传、活动页或采访中的明确资料。
- `community_structured`：可追溯的社区数据库或 API。
- `community_edited`：Wiki 等人工协作资料。
- `inference`：根据多个事实作出的推定，必须写明理由。
- `unverified`：尚未核实，不得作为确定设定引用。

## 更新

在本目录执行：

```bash
node scripts/import-monster-db.mjs
node scripts/import-english-ecology-translations.mjs
node scripts/import-monster-db.mjs
```

第一步先同步怪物身份与已有简中资料；第二步只为仍缺摘要且有英文原文的身份生成译文；第三步将新增译文合并进玩家可见图鉴。

脚本会重新获取上游事实数据与中文名称、合并同名重复项，并验证 ID、简体中文名及作品记录的完整性。它会导入 Rise/Sunbreak 与 Wilds 的简中生态摘要、`data/ecology-translations.zh-Hans.json` 中可追溯的英文译文、Wilds 的生态观察与栖息地，以及 World/Iceborne 已有中文映射的栖息地；不导入图片、素材、数值或攻略。中文名按 Wilds 游戏数据、World/Rise 简中数据、旧作社区译名、人工校订缺口的顺序覆盖。