feedback5: Japanese, Korean and Traditional Chinese ship — the official game texts of the JP / KR / TW clients (data/i18n/ja.json 96.5 %, ko.json 97.4 %, zh-TW.json 91.1 % of 22 114 texts, built with build-i18n --lang from ArknightsAssets/ArknightsGamedata) and minimal UI packs public/i18n/ja.json, ko.json, zh-TW.json (a _meta manifest, no UI strings yet): ja / ko fall back to the English UI, zh-TW to the Simplified Chinese UI (no fallback; numbers in 萬 / 億); the owner's decision of 2026-10-07; UI translations welcome from the community; golden: unchanged (client text only)

- The packs: _meta = type lang, the code, its own and English name (日本語 / Japanese, 한국어 / Korean, 繁體中文 / Traditional Chinese), version 0.2.0, app >=0.2.0, authors, credits (the official client data, © Hypergryph (/ Yostar for JP and KR), via ArknightsAssets/ArknightsGamedata), fallback ["en"] for ja / ko and [] for zh-TW; formatted as `node tools/i18n.mjs template` writes them, so a translator runs it on the shipped file and keeps the manifest. - Built offline from the tables W5AD downloaded and checked today (jp / kr 51.10.0, tw 51.2.0; copied into .cache/gamedata-<code>): coverage as W5AD measured; `build-i18n --lang <code> --check` up to date for en, ja, ko, zh-TW. `node tools/i18n.mjs check --all --strict`: 0 errors (en complete; ja / ko / zh-TW 0 of 1022 msgids, fallback). `node tools/packs.mjs list` lists the four packs with their game texts; `tools/package.mjs --dry-run --list` ships data/i18n and public/i18n of all four and the generated packs/index.json. - With five languages the menu is a list (ui/lang.js SEGMENTED_MAX 4, W5AD's rule): test/ui/i18n.e2e.test.js reads and picks either form, expects the shipped languages, and checks each new pack in the browser (its official game text, the fallback UI, <html lang>) — SP_E2E=1: 3 / 3; the title page of the five devices (devices.e2e "title page") still fits: 5 / 5. - Docs: docs/I18N.md (intro, §2, §5 "Shipped packs" with the call for UI translations), docs/PLAYING.md (语言), DESIGN §25.20 and the §25 intro's decisions of 2026-10-07. Gate: non-browser suites 5024 / 5024 (test/i18n*, test/package, client-static 358 / 358), npm run golden ok, test/golden.test.js 9 / 9, lint 0 errors, check:imports ok, typecheck ok.
2026-10-07 04:16:59 +08:00
1 parent 9738bb829a
commit 2e83a6b977
@@ -4,8 +4,9 @@ Chinese is the default; every other language is a switch (the owner's decision o
 opens in Chinese until the player picks a language on the title screen (top right) or in 设置 / Settings. Every
 language but Chinese is a **language pack** — a file in the language folder, nothing else (the owner's decision of
 2026-10-07; §5 "Adding a language"): the menu lists every pack the server finds, each under its own name (buttons up to
-four languages, a list beyond). English is a pack like any other; it ships with the game and is the complete one. The
-choice is kept in `localStorage` (`sp.pref.lang`); `?lang=<code>` in the address bar (`?lang=en`, `?lang=zh`) sets it
+four languages, a list beyond). English is a pack like any other; it ships with the game and is the complete one.
+Japanese, Korean and Traditional Chinese ship too, with the official game texts and no UI strings yet (§5 "Shipped
+packs"). The choice is kept in `localStorage` (`sp.pref.lang`); `?lang=<code>` in the address bar (`?lang=en`, `?lang=zh`) sets it
 once and is then removed; a stored language whose pack is gone opens in Chinese. A switch re-renders the page in place
 (no reload). Language packs are the first type of the content packs (docs/PACKS.md: the manifest, the registry, the
 index, the pack folders).
@@ -173,8 +174,10 @@ rebuilt.
  22 114 texts — the TW data is older, 51.2, and a Traditional text equal to the Simplified one counts as untranslated
  although it shows the same). The remake's own strings (stage-name composites, the fallback files) are English only;
  for another language the pack's UI file (`public/i18n/<code>.json`) is the fallback dictionary, and what is left falls
-  back per text at run time (the pack's chain, then Chinese). Only English is generated in the repository: a game-text
-  overlay ships with the UI pack of its language (a pack is listed by its UI file).
+  back per text at run time (the pack's chain, then Chinese). A game-text overlay ships with the UI pack of its language
+  (a pack is listed by its UI file): the repository generates English and, since the owner's decision of 2026-10-07,
+  `data/i18n/ja.json`, `ko.json` and `zh-TW.json` (§5 "Shipped packs"). Rebuild them like English after a data change
+  (`--lang <code> --check` says when one is out of date).
 - **A language without an official client** (French, German, Russian …) needs no game texts at all: they follow the
  pack's chain (`"fallback": ["en"]` shows the English ones). To translate some, write a community dictionary — a flat
  JSON `{ "<Chinese data text>": "<translation>" }`; the `names` of `data/i18n/en.json` (every game-data name with its
@@ -237,6 +240,14 @@ which are bilingual on purpose.

 ## 5. Adding a language

+**Shipped packs** (0.2.0; the owner's decision of 2026-10-07): English (complete) and three packs that carry the
+official game texts but no UI strings yet — 日本語 (`ja`: the JP client, 96.5 % of the game texts), 한국어 (`ko`: KR,
+97.4 %) and 繁體中文 (`zh-TW`: TW, 91.1 %; its data is older, and a Traditional text equal to the Simplified one counts as
+untranslated). Their UI falls back to English (`ja`, `ko`: `"fallback": ["en"]`) or, for `zh-TW`, to the Simplified
+Chinese msgids (no fallback — the owner's choice); `zh-TW` counts large numbers in 萬 / 億. **UI translations are
+welcome from the community**: start from the shipped file — `node tools/i18n.mjs template <code>` keeps its `_meta` and
+adds every msgid with an empty value — then follow the steps below and send a pull request.
+
 A language is a file in the language folder; the server lists it on the next page load (no restart, no build step, no
 code change). For a community translator:

@@ -4,7 +4,7 @@

 本文数值来自官方数据表（`data/config.json` 等）与 [research](research/00-INDEX.md)；游戏内左下角 📖「玩法说明」有官方教程图（随素材一起下载；没下载到时显示文字要点）。操作方式见 [README · 操作](../README.md#操作)，键盘快捷键和修改方法见 [§11](#11-快捷键)。

-界面语言：默认中文；标题画面右上角或「设置」里可切换 **中文 / English**（会记住选择，不用刷新）。英文的干员、技能、盟约、装备、敌人等游戏文本取自官方英文服数据，界面文字全部有英文；切到英文后仍显示中文的只有玩家名字（人机的名字也是）、多轮悬赏改写过的「接下来两场作战」说明，以及官方英文服还没有的游戏文本（部分自选干员和较新的模组）；「玩法说明」的教程图是官方的中文图片，标题有英文（docs/I18N.md）。
+界面语言：默认中文；标题画面右上角或「设置」里可切换 **中文 / English / 日本語 / 한국어 / 繁體中文**（会记住选择，不用刷新）。日语、韩语、繁体中文的游戏文本取自官方日服 / 韩服 / 台服数据，界面文字暂未翻译——日语和韩语显示英文界面，繁体中文显示简体中文界面，欢迎社区补全（docs/I18N.md「Adding a language」）。英文的干员、技能、盟约、装备、敌人等游戏文本取自官方英文服数据，界面文字全部有英文；切到英文后仍显示中文的只有玩家名字（人机的名字也是）、多轮悬赏改写过的「接下来两场作战」说明，以及官方英文服还没有的游戏文本（部分自选干员和较新的模组）；「玩法说明」的教程图是官方的中文图片，标题有英文（docs/I18N.md）。

 ## 1. 一局的流程

@@ -58,7 +58,9 @@ lock (§25.13.2); a newly merged elite 拉普兰德 counts as a new 拉普兰德
 alive at the fight's start, adopting PR #209 and replacing 「保持固定血量」 (§25.13.4); flying units at 1.3 tiles and the two
 model quirks of PR #211 (§25.13.5); the bounty pays whenever its enemy dies (relayed with the community
 reports, §25.14.3); 2026-10-07 — the in-match shortcuts rebindable in 设置 (§25.15); a language is a file in the
-language folder, and the language pack is the first type of a general content-pack mechanism (§25.20); 乌尔比安 knocked
+language folder, and the language pack is the first type of a general content-pack mechanism; Japanese, Korean and
+Traditional Chinese ship with the official game texts and fallback UIs — the Traditional one's in Simplified Chinese
+(§25.20); 乌尔比安 knocked
 out during his S3 comes back on his deployment tile, a deliberate deviation from PRTS's "where it fell" (§25.17.3);
 烛煌's 绝处重燃 before 坚固维式重锤's lock and the official tier cap of 寻呼模块 / 简易通讯机 kept as they are (§25.21.1,
 §25.21.10).
@@ -1707,8 +1709,14 @@ one commit with its tests; two open community PRs were reused without merging th
    `node tools/build-i18n.mjs --lang ja | ko | zh-TW` builds a pack's game texts from the official JP / KR / TW client
    (ArknightsAssets/ArknightsGamedata `jp/`, `kr/`, `tw/`, each with both 盟约 seasons, checked 2026-10-07: ja 96.5 %,
    ko 97.4 %, zh-TW 91.1 % of 22 114 texts); a language without a client uses `--dict` (a community dictionary) or no
-    game texts at all (they follow the chain). No language but English ships: there is no Japanese, Korean or
-    Traditional Chinese UI pack yet, and a game-text file without its UI pack is not listed.
+    game texts at all (they follow the chain). The stream shipped no language but English (a game-text file without
+    its UI pack is not listed).
+  - **Shipped: 日本語, 한국어, 繁體中文** (the owner's decision of 2026-10-07, at the merge): `data/i18n/ja.json`,
+    `ko.json`, `zh-TW.json` built with `build-i18n --lang` (ja 96.5 %, ko 97.4 %, zh-TW 91.1 %) and minimal UI packs
+    `public/i18n/ja.json`, `ko.json`, `zh-TW.json` — a `_meta` manifest (its own and English name, credits: the official
+    client data via ArknightsAssets) and no UI strings yet: `ja` / `ko` fall back to English, `zh-TW` to the Simplified
+    Chinese UI (no fallback — the owner's choice; [ASSUMED] numbers in 萬 / 億). The menu shows the five languages as
+    buttons. UI translations are welcome from the community (docs/I18N.md §5 "Shipped packs").
 - **The output in Chinese and English did not change**: `test/i18n-packs.test.js` renders every msgid of
  `public/i18n/en.json` in both languages with sample params and compares it with the renderer of 0.2.0 before packs;
  `node tools/build-i18n.mjs --check` still finds `data/i18n/en.json` up to date. One English entry was added, the tab