16.1 出海发行方案装配

{
  "version": 1,
  "game": "merge-island",
  "observedAt": "2026-10",
  "title": "《合成小岛》出海发行方案装配清单",
  "note": "出海发行方案装配清单（D 层）：把卷五第 1–16 章的交付物按章号装订成一份可交付的发行方案。每章登记一条：章号、章标题、一份主交付物、本卷工具链前缀（g01–g16）与一条验收清单。口径是「装配结构」的建模，不是任何真实发行方案的实测。前缀是本卷各章在 pebble/ 工作区的文件族（config/gNN_*.json、sim/gNN_*.py、core/src/gNN/），「前缀已落盘」指该族至少有一个配置文件存在。真实方案内容与验收结论需真实业务环境，命令行不可复现（X）。全字段为整数或字符串，无浮点。",
  "chapters": [
    { "ch": 1,  "title": "海外小游戏平台格局", "deliverable": "平台分层与组合选择表", "prefix": "g01", "check": "平台分层与流量结构写明，各平台分成与结算条款逐项对照，组合选择有依据" },
    { "ch": 2,  "title": "平台接入与上架",     "deliverable": "SDK 接入与上架资料表",   "prefix": "g02", "check": "SDK 与广告 API 差异对照，上架资料与驳回清单可查，平台专属能力已标注" },
    { "ch": 3,  "title": "一套代码多平台",     "deliverable": "平台抽象层与构建矩阵",   "prefix": "g03", "check": "抽象层与渠道配置分离，构建矩阵产物齐全，版本一致性与回滚路径已定义" },
    { "ch": 4,  "title": "海外变现",           "deliverable": "H5 广告形态与收入配比表", "prefix": "g04", "check": "Web 广告形态与广告网络对照，纯 IAA 结构闭合，多平台收入配比可复算" },
    { "ch": 5,  "title": "多语言资源管线",     "deliverable": "i18n 资源结构与语言包表", "prefix": "g05", "check": "资源键设计可扩展，语言包加载与回退明确，文案膨胀与 UI 适配有阈值" },
    { "ch": 6,  "title": "文化与美术本地化",   "deliverable": "文化禁忌与本地化变体表", "prefix": "g06", "check": "禁忌与符号审查逐条可查，美术变体按地区登记，日期/数字/货币/RTL 有落点" },
    { "ch": 7,  "title": "本地化质量",         "deliverable": "伪本地化与语言 QA 清单", "prefix": "g07", "check": "伪本地化溢出检测可跑，母语审校流程写明，本地化成本与排期成对出现" },
    { "ch": 8,  "title": "多语言运营",         "deliverable": "分语言指标与小语种取舍表", "prefix": "g08", "check": "分语言指标口径统一，活动与素材按语言登记，小语种取舍有预算约束" },
    { "ch": 9,  "title": "数据合规的工程落地", "deliverable": "合规工程落点与同意清单",   "prefix": "g09", "check": "GDPR/CCPA 落点到字段，COPPA 与儿童向限制明确，同意管理与数据出境有流程" },
    { "ch": 10, "title": "归因与隐私新政",     "deliverable": "归因链路与替代方案表",   "prefix": "g10", "check": "ATT/IDFA/SKAdNetwork 链路写明，无 IDFA 归因替代可跑，聚合上报有口径" },
    { "ch": 11, "title": "跨境结算与资金",     "deliverable": "收款方式与费率周期表",   "prefix": "g11", "check": "收款门槛逐平台写明，汇率/手续费/到账周期可复算，税务表单清单齐全" },
    { "ch": 12, "title": "出海风控",           "deliverable": "内容版权与地区可用性表", "prefix": "g12", "check": "内容与版权地区差异可查，制裁与地区可用性有门禁，反作弊与刷量有判据" },
    { "ch": 13, "title": "海外买量与素材",     "deliverable": "海外渠道与投放口径表",   "prefix": "g13", "check": "海外渠道与投放口径写明，素材本地化与合规对照，海外 ROI 与止损成对出现" },
    { "ch": 14, "title": "海外榜单与竞品",     "deliverable": "榜单结构与竞品拆解表",   "prefix": "g14", "check": "各平台榜单结构写明，竞品拆解与本地化机会可核，品类海外差异有对照" },
    { "ch": 15, "title": "案例：把《合成小岛》发到五个海外平台", "deliverable": "五平台接入时间线与数据复盘", "prefix": "g15", "check": "平台组合与接入时间线完整，本地化与合规落地可追溯，多平台数据表现可迭代" },
    { "ch": 16, "title": "出海收官",           "deliverable": "出海发行方案与五卷总收官", "prefix": "g16", "check": "方案装配完整、多平台仿真验收通过、五卷链路与剩余未知项交代清楚" }
  ]
}

// file: core/src/g16/manifest.ts
// tier: P
// verify: node --test 'core/test/g16_*.test.ts'
//
// 出海发行方案装配内核：读 config/g16_manifest.json 的装配清单，校验「第 1–16 章齐全、
// 章号唯一、章标题/交付物/验收清单不缺、每章工具链前缀等于 gNN」，并给出一枚清单指纹
// （FNV-1a 32 位，与 Python 侧同法可对拍）。另按 availableConfigs 统计「前缀已落盘」的章数
// （该族至少有一个 config/gNN_*.json 存在）。只用可擦除语法（禁 enum / namespace / 参数属性 / 装饰器）。

export interface PlanChapter {
  readonly ch: number;
  readonly title: string;
  readonly deliverable: string;
  readonly prefix: string;
  readonly check: string;
}
export interface PlanManifest {
  readonly version: number;
  readonly game: string;
  readonly title: string;
  readonly chapters: readonly PlanChapter[];
}
export interface PlanReport {
  readonly chapterCount: number;
  readonly expected: number;
  readonly missing: number[];
  readonly dupChapters: number[];
  readonly emptyFields: string[];
  readonly prefixMismatch: string[];
  readonly landedFamilies: number;
  readonly pendingFamilies: string[];
  readonly fingerprint: string;
  readonly valid: boolean;
}

/** 章号 → 期望的工具链前缀，如 3 → "g03"。 */
export function expectedPrefix(ch: number): string {
  return `g${String(ch).padStart(2, "0")}`;
}

/** 清单指纹：对「章号|标题|交付物|前缀|验收清单」逐行拼串做 FNV-1a 32 位（UTF-8 字节）。 */
export function fingerprint(mf: PlanManifest): string {
  const norm = mf.chapters
    .map((c) => `${c.ch}|${c.title}|${c.deliverable}|${c.prefix}|${c.check}`)
    .join("\n");
  const bytes = new TextEncoder().encode(norm);
  let h = 0x811c9dc5;
  for (const b of bytes) {
    h ^= b;
    h = Math.imul(h, 0x01000193) >>> 0;
  }
  return h.toString(16).padStart(8, "0");
}

/** 某前缀是否已有落盘的配置文件（config/ 下存在 gNN_*.json）。 */
export function familyLanded(prefix: string, availableConfigs: readonly string[]): boolean {
  const head = `${prefix}_`;
  return availableConfigs.some((f) => f.startsWith(head) && f.endsWith(".json"));
}

/** 校验装配清单：章号 1..expected 齐全且唯一、三要素非空、前缀等于 gNN、统计已落盘前缀。 */
export function validateManifest(
  mf: PlanManifest,
  availableConfigs: readonly string[],
  expected = 16,
): PlanReport {
  const chs = mf.chapters.map((c) => c.ch);
  const missing: number[] = [];
  for (let i = 1; i <= expected; i += 1) if (!chs.includes(i)) missing.push(i);
  const dupChapters = chs.filter((c, i) => chs.indexOf(c) !== i);
  const emptyFields: string[] = [];
  const prefixMismatch: string[] = [];
  for (const c of mf.chapters) {
    if (!c.title.trim()) emptyFields.push(`${c.ch}:title`);
    if (!c.deliverable.trim()) emptyFields.push(`${c.ch}:deliverable`);
    if (!c.check.trim()) emptyFields.push(`${c.ch}:check`);
    if (c.prefix !== expectedPrefix(c.ch)) prefixMismatch.push(`${c.ch}:${c.prefix}`);
  }
  const pendingFamilies = mf.chapters
    .map((c) => c.prefix)
    .filter((p) => !familyLanded(p, availableConfigs));
  const landedFamilies = mf.chapters.length - pendingFamilies.length;
  const valid = mf.chapters.length === expected && missing.length === 0
    && dupChapters.length === 0 && emptyFields.length === 0 && prefixMismatch.length === 0;
  return {
    chapterCount: mf.chapters.length, expected, missing, dupChapters, emptyFields,
    prefixMismatch, landedFamilies, pendingFamilies, fingerprint: fingerprint(mf), valid,
  };
}

// file: core/test/g16_manifest.test.ts
// tier: P
// verify: node --test 'core/test/g16_*.test.ts'
//
// 硬断言：出海发行方案装配清单校验通过，且清单指纹与 Python 侧 FNV-1a 实现逐位一致。

import { test } from "node:test";
import assert from "node:assert/strict";
import { readFileSync, readdirSync } from "node:fs";
import { fileURLToPath } from "node:url";
import { dirname, join } from "node:path";

import { validateManifest, fingerprint, expectedPrefix, familyLanded } from "../src/g16/manifest.ts";

const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
const mf = JSON.parse(readFileSync(join(ROOT, "config", "g16_manifest.json"), "utf8"));
const available = readdirSync(join(ROOT, "config")).filter((f) => f.endsWith(".json"));

test("清单指纹与 Python FNV-1a 一致（跨语言对拍）", () => {
  assert.equal(fingerprint(mf), "1e96e2f1");
});

test("装配清单校验通过：16 章齐全、章号唯一、三要素不缺、前缀等于 gNN", () => {
  const rep = validateManifest(mf, available);
  assert.equal(rep.chapterCount, 16);
  assert.deepEqual(rep.missing, []);
  assert.deepEqual(rep.dupChapters, []);
  assert.deepEqual(rep.emptyFields, []);
  assert.deepEqual(rep.prefixMismatch, []);
  assert.equal(rep.valid, true);
});

test("工具链前缀族：g01–g12 均已落盘，g15 章允许仍待落盘", () => {
  const rep = validateManifest(mf, available);
  assert.equal(expectedPrefix(1), "g01");
  assert.equal(expectedPrefix(16), "g16");
  assert.ok(rep.landedFamilies >= 13, `已落盘前缀族应 >= 13，实测 ${rep.landedFamilies}`);
  assert.ok(familyLanded("g01", available));
  assert.ok(familyLanded("g16", available));
});

test("缺一章即判无效：删掉第 9 章后 missing 命中", () => {
  const broken = { ...mf, chapters: mf.chapters.filter((c: { ch: number }) => c.ch !== 9) };
  const rep = validateManifest(broken, available);
  assert.deepEqual(rep.missing, [9]);
  assert.equal(rep.valid, false);
});

test("前缀写错即判无效：第 3 章前缀改成 g99", () => {
  const broken = { ...mf, chapters: mf.chapters.map((c: { ch: number; prefix: string }) =>
    c.ch === 3 ? { ...c, prefix: "g99" } : c) };
  const rep = validateManifest(broken, available);
  assert.deepEqual(rep.prefixMismatch, ["3:g99"]);
  assert.equal(rep.valid, false);
});

✔ 清单指纹与 Python FNV-1a 一致（跨语言对拍） (1.236209ms)
✔ 装配清单校验通过：16 章齐全、章号唯一、三要素不缺、前缀等于 gNN (0.694458ms)
✔ 工具链前缀族：g01–g12 均已落盘，g15 章允许仍待落盘 (0.234042ms)
✔ 缺一章即判无效：删掉第 9 章后 missing 命中 (0.212042ms)
✔ 前缀写错即判无效：第 3 章前缀改成 g99 (0.165042ms)
ℹ tests 11   ℹ pass 11   ℹ fail 0
fingerprint = 1e96e2f1