# 系列資料檔規格（給內容撰寫者）

每個系列一個檔案：`data/series/<id>.json`（UTF-8，繁體中文，台灣用語）。
寫完後 `node tools/audit.mjs` 必須通過。

## 檔案結構

```json
{
  "id": "mario",
  "order": 10,
  "group": "nintendo",
  "name": "超級瑪利歐",
  "nameJa": "スーパーマリオ",
  "nameEn": "Super Mario",
  "publisher": "任天堂",
  "creator": "宮本茂",
  "debut": 1985,
  "theme": "mario",
  "tagline": "一句話（18 字內，不要行銷詞）",
  "genres": ["橫向卷軸動作", "3D 平台動作", "競速"],
  "hero": { "file": "assets/photos/mario/hero.jpg", "caption": "圖說（含來源）" },
  "summary": ["第一段（80-160 字）", "第二段"],
  "culture": ["文化定位段落 1（可 1-3 段）"],
  "history": [
    { "year": 1981, "title": "《大金剛》街機", "text": "80-160 字的沿革說明" }
  ],
  "mechanics": [
    { "era": "1985-1992", "title": "橫向卷軸的黃金期", "text": "120-220 字，講玩法如何變化",
      "image": { "file": "assets/photos/mario/mech-1.jpg", "caption": "圖說" } }
  ],
  "works": [
    { "year": 1985, "title": "超級瑪利歐兄弟", "titleJa": "スーパーマリオブラザーズ",
      "platform": "FC", "note": "30 字內的定位說明" }
  ],
  "gallery": [
    { "file": "assets/photos/mario/g1.jpg", "caption": "圖說" }
  ],
  "facts": [
    { "label": "累計銷量", "value": "8.7 億套（系列）", "note": "資料截止 2025 年任天堂財報" }
  ],
  "sources": ["https://ja.wikipedia.org/wiki/スーパーマリオブラザーズ", "..."],
  "related": ["zelda", "donkeykong"]
}
```

## 規則

1. **作品年表要完整。** `works` 由舊到新，涵蓋本傳與重要外傳。每筆一行，不重複。年份必須是實際發售年。
2. **年份、平台、作品名要查證。** 至少查日文維基或英文維基，把用到的頁面放進 `sources`。不確定就不要寫。
3. **不要虛構。** 沒有把握的銷量、獎項、爭議一律省略。`facts` 只放能查到的。
4. **文字風格：**繁中、白話、有人味、避免「深入淺出、賦能、至關重要、不容錯過、經典中的經典」這類填充詞。段落長短交錯。不要 em-dash（—）與破折號，需要停頓用逗號、冒號或括號。
5. **不要寫死星期幾或更新頻率。**
6. **圖片欄位一律留空字串。** `hero`、`mechanics[].image`、`gallery[]` 這次都寫 `"file": ""` 與 `"caption": ""`（gallery 要有 6 個空物件）。圖片下載與圖說由館方統一在照片抓取完成後指派，你不要下載圖片、不要自己編檔案路徑。
7. `theme` 填 `themes.css` 已有的主題名；`related` 只能指向存在的 id。
8. `order` 決定大廳排序（同 group 內）。
9. 每個系列 `history` 至少 6 筆、`mechanics` 至少 3 筆、`works` 至少 8 筆、`summary` 2 段、`culture` 2 段、`gallery` 6 張、`facts` 3 筆。