既知の制限とトラブル対応

現在の仕様・検証範囲

開発記録には実機対戦、勝敗表示、結果・精算・配信の確認があります。一方、公開コピーのコード・本体を組み合わせた新しい配布物の全受入は未実施です。過去の「合格」と、いま手元で作った版の合格を区別します。

• 原本は中国版を基準とする記録です。Steam版・Wargaming版・別のDLLのアドレスやパッチを混ぜません。
• 復活版では317部隊をTier X相当で扱う方針です。Godot移植版の原作Tier保持とは異なります。
• スキル・消耗品・ツリーの原作値を保持する方針。旧資料の一律30ポイントや独自倍率を現行仕様として復活させないでください。
• 通常の武器・防具による数値補正を無効にする方針があります。表示差をすべて保存不具合と決めつけません。
• 現候補の公開protocolでは新規PVEを拒否します。9月の「PVE 1〜10人」説明だけを根拠にPVEを開放しないでください。未使用席のCPU補充とは別です。
• 全317部隊のGUI受入、同じ完成物での2台の通常・Private Room・再戦・切断復帰・長時間動作、スキルの所持/装着/既定状態の細部には残件があります。

根拠: 現行仕様記録、native公開protocol、作業記録。

症状から調べる

症状	最初の確認
npm ci がlockfile不足	Hostingの組み立て手順でsource側のlockfileを補ったか
../../catalog/... が見つからない	backendと同じ階層にcandidate/catalogを配置したか
workerdの EPIPE	workerd単体の起動、OSのELFローダー。NixOSでは汎用Linux実行環境を確認
/health が404/到達不能	自分のWorker名、route、DNS、TLS、src/index.ts の入口
/health が503 startup_configuration_unavailable	CONTROLのmaintenance JSON、min_client_version、min_launcher_versionが存在し、値・semverが正しいか
nativeBattles が有効にならない	build define、twa-relay-v1、staging/production、内部PVPがfalseか
ログイン拒否	Connect ID tokenか。issuer、product/sandbox/deployment/client、期限、登録方針、Epic公開範囲
invalid_release_configuration	player-release.jsonのキー・HTTPS hostname、companion/VERSION、ゲーム用EOS client設定
起動前の整合性エラー	Arena/DLL/WAD/NPLの版、catalog、manifest署名、native receipt。検査の迂回で直さない
更新404・署名不一致	PUBLIC_DOWNLOAD_ORIGIN、静的manifestとobjectの公開場所、自分のRELEASE_TRUSTED_KEYS
メンテナンスで入れない	管理APIのmaintenance statusと最低版
対戦が始まらない	mode、編成、assignment、参加権限、ticket、relay接続。Room開始API成功だけでは判断しない
結果がない/重複する	同じbattle IDでnative終了、結果送信、settlement、deliveryを分けて追跡

不具合報告に含めるもの

ソースcommit、launcher版、Worker版、本体の該当SHA-256、Windows版、人数・マップ・編成、時刻、再現手順、期待した結果と実結果を記録します。対戦がある場合は公開範囲を考慮してbattle IDを添えます。

認証token、session、API管理秘密、署名秘密鍵、個人プロフィールは貼らないでください。ログを添える時はその部分を除き、前後の操作・エラー種別が分かる形にします。受付先はIssuesです。