@leonxin/meetgames 0.1.7 → 0.1.11

package/tests/sdkVersionConfig.test.ts

@@ -0,0 +1,130 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { loadMeetSdkDefaultConfigWithLatestAndroidVersion } from "../src/config/meetSdkDefaultConfig.js";
+import {
+  loadMeetSdkIosConfig,
+  resolveMeetSdkIosConfigPath,
+  syncMeetSdkIosVersionToConfig,
+} from "../src/config/meetSdkIosConfig.js";
+
+function makeTempPackageRoot(): string {
+  return fs.mkdtempSync(path.join(os.tmpdir(), "meet-sdk-config-"));
+}
+
+function writeAndroidDefaults(packageRoot: string): void {
+  fs.writeFileSync(
+    path.join(packageRoot, "meetsdk-android.json"),
+    JSON.stringify(
+      {
+        topsdk: {
+          version: "",
+          groupId: "com.sino.topsdk",
+          repositories: [],
+        },
+        sdkModules: {
+          login: {},
+          payment: {},
+          analytics: {},
+        },
+      },
+      null,
+      2
+    ),
+    "utf8"
+  );
+}
+
+describe("SDK version package configs", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it("stores fetched Android SDK version in meetsdk-android.json", async () => {
+    const packageRoot = makeTempPackageRoot();
+    try {
+      writeAndroidDefaults(packageRoot);
+      vi.stubGlobal(
+        "fetch",
+        vi.fn(async () => ({
+          ok: true,
+          status: 200,
+          text: async () =>
+            JSON.stringify({
+              code: 200,
+              data: {
+                result: {
+                  android: { ver: "9.8.7", date: "2026-06-20" },
+                  ios: { ver: "1.2.3", date: "2026-06-21" },
+                },
+              },
+            }),
+        })) as unknown as typeof fetch
+      );
+
+      const defaults = await loadMeetSdkDefaultConfigWithLatestAndroidVersion({
+        sdkHomeApiBaseUrl: "https://android-version-sync.example.com",
+        packageRoot,
+      });
+
+      const stored = JSON.parse(fs.readFileSync(path.join(packageRoot, "meetsdk-android.json"), "utf8")) as {
+        topsdk: { version: string; date: string };
+      };
+      expect(defaults.topsdk.version).toBe("9.8.7");
+      expect(defaults.topsdk.date).toBe("2026-06-20");
+      expect(stored.topsdk.version).toBe("9.8.7");
+      expect(stored.topsdk.date).toBe("2026-06-20");
+    } finally {
+      fs.rmSync(packageRoot, { recursive: true, force: true });
+    }
+  });
+
+  it("stores resolved iOS SDK version in meetsdk-ios.json", () => {
+    const packageRoot = makeTempPackageRoot();
+    try {
+      const configPath = syncMeetSdkIosVersionToConfig({
+        packageRoot,
+        version: "1.6.0.5",
+        date: "2026-06-09",
+        packageType: "native",
+        plugins: ["guest", "facebook"],
+      });
+
+      expect(configPath).toBe(resolveMeetSdkIosConfigPath(packageRoot));
+      expect(loadMeetSdkIosConfig(packageRoot)).toEqual({
+        topsdk: {
+          version: "1.6.0.5",
+          date: "2026-06-09",
+          packageType: "native",
+          plugins: ["guest", "facebook"],
+        },
+      });
+    } finally {
+      fs.rmSync(packageRoot, { recursive: true, force: true });
+    }
+  });
+
+  it("clears stale iOS SDK date when only an explicit version is stored", () => {
+    const packageRoot = makeTempPackageRoot();
+    try {
+      syncMeetSdkIosVersionToConfig({
+        packageRoot,
+        version: "1.6.0.5",
+        date: "2026-06-09",
+      });
+      syncMeetSdkIosVersionToConfig({
+        packageRoot,
+        version: "1.6.0.6",
+        date: "",
+      });
+
+      expect(loadMeetSdkIosConfig(packageRoot).topsdk).toMatchObject({
+        version: "1.6.0.6",
+      });
+      expect(loadMeetSdkIosConfig(packageRoot).topsdk.date).toBeUndefined();
+    } finally {
+      fs.rmSync(packageRoot, { recursive: true, force: true });
+    }
+  });
+});

package/tests/test-projects-hosts.test.ts

@@ -0,0 +1,78 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { buildWorkspaceContext } from "../src/core/workspace.js";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const pkgRoot = path.resolve(here, "..");
+const androidFixtureRoot = path.join(pkgRoot, "fixtures", "android-test-project");
+
+function testProjectRoot(...names: string[]): string {
+  for (const name of names) {
+    const candidate = path.join(androidFixtureRoot, name);
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return path.join(androidFixtureRoot, names[0] ?? "");
+}
+
+function createAndroidAppModule(root: string, name: string, applicationId: string): void {
+  const moduleDir = path.join(root, name);
+  fs.mkdirSync(path.join(moduleDir, "src", "main"), { recursive: true });
+  fs.writeFileSync(
+    path.join(moduleDir, "build.gradle"),
+    [
+      "plugins {",
+      "    id 'com.android.application'",
+      "}",
+      "android {",
+      "    defaultConfig {",
+      `        applicationId '${applicationId}'`,
+      "    }",
+      "}",
+      "",
+    ].join("\n"),
+    "utf8"
+  );
+  fs.writeFileSync(path.join(moduleDir, "src", "main", "AndroidManifest.xml"), "<manifest />\n", "utf8");
+}
+
+describe("fixture host trees", () => {
+  const powerRaidRoot = testProjectRoot("power-raid");
+
+  it("android-latest-project (plugins DSL) resolves application module :app", () => {
+    const root = path.join(androidFixtureRoot, "android-latest-project");
+    const ctx = buildWorkspaceContext(root, pkgRoot);
+    expect(ctx.android?.ok).toBe(true);
+    expect(ctx.android?.ok && ctx.android.moduleName).toBe(":app");
+    expect(ctx.android?.ok && ctx.android.moduleDir.endsWith(`${path.sep}app`)).toBe(true);
+  });
+
+  it.skipIf(!fs.existsSync(powerRaidRoot))("power-raid resolves launcher application module", () => {
+    const ctx = buildWorkspaceContext(powerRaidRoot, pkgRoot);
+    expect(ctx.android?.ok).toBe(true);
+    expect(ctx.android?.ok && ctx.android.moduleName).toBe(":launcher");
+    expect(ctx.android?.ok && ctx.android.moduleDir.endsWith(`${path.sep}launcher`)).toBe(true);
+  });
+
+  it("requires an Android app module selector when multiple application modules exist", () => {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), "meet-android-multi-app-"));
+    fs.writeFileSync(path.join(root, "settings.gradle"), "include ':app'\ninclude ':demo'\n", "utf8");
+    createAndroidAppModule(root, "app", "com.example.app");
+    createAndroidAppModule(root, "demo", "com.example.demo");
+
+    const ambiguous = buildWorkspaceContext(root, pkgRoot);
+    expect(ambiguous.android?.ok).toBe(false);
+    expect(ambiguous.android?.ok ? "" : ambiguous.android?.error).toContain("MULTIPLE_APPLICATION_MODULES_FOUND: :app, :demo");
+
+    const selected = buildWorkspaceContext(root, pkgRoot, { appTarget: "demo" });
+    expect(selected.android?.ok).toBe(true);
+    expect(selected.android?.ok && selected.android.moduleName).toBe(":demo");
+    expect(selected.android?.ok && selected.android.moduleDir.endsWith(`${path.sep}demo`)).toBe(true);
+
+    const missing = buildWorkspaceContext(root, pkgRoot, { appTarget: "missing" });
+    expect(missing.android?.ok).toBe(false);
+    expect(missing.android?.ok ? "" : missing.android?.error).toContain("ANDROID_APPLICATION_MODULE_NOT_FOUND: :missing");
+  });
+});

package/tests/topsdk.test.ts

@@ -0,0 +1,53 @@
+import { describe, expect, it } from "vitest";
+import { topsdkMd5Base64Sign } from "../src/remote/topsdkSign.js";
+import {
+  buildTopSdkGetSdkConfigUrl,
+  defaultTopSdkBaseUrl,
+  filterTopSdkAuthTypesForRequest,
+  resolveAuthTypesForGetSdkConfigRequest,
+} from "../src/remote/topsdkGetSdkConfig.js";
+
+describe("TOPSDK getSDKConfig client", () => {
+  it("matches topsdk-tool-ios md5_base64_byte signing", () => {
+    const sign = topsdkMd5Base64Sign("testApp", "secret", 1700000000000);
+    expect(sign).toBe("Fww7ophf9iCbLC+Rj9rQ5w==");
+  });
+
+  it("filters auth types like ChannelConfigManager", () => {
+    expect(filterTopSdkAuthTypesForRequest(["GUEST", "GOOGLE", "UI", "FACEBOOK", "IAPPAY"])).toEqual([
+      "GOOGLE",
+      "FACEBOOK",
+    ]);
+  });
+
+  it("resolveAuthTypesForGetSdkConfigRequest uses discovery when explicit list is empty", () => {
+    const r = resolveAuthTypesForGetSdkConfigRequest([]);
+    expect(r).toContain("FACEBOOK");
+    expect(r).toContain("GOOGLE");
+    expect(r).not.toContain("GUEST");
+  });
+
+  it("builds GET URL with repeated authType query keys", () => {
+    const { url } = buildTopSdkGetSdkConfigUrl({
+      baseUrl: "https://pre-api-sdk-gameplus.meetsocial.com/",
+      appId: "a",
+      appSecret: "b",
+      authTypes: ["GOOGLE", "FACEBOOK"],
+      channelType: "google",
+      timestampMillis: 99,
+    });
+    const u = new URL(url);
+    expect(u.pathname).toContain("getSDKConfig");
+    expect(u.searchParams.getAll("authType")).toEqual(["GOOGLE", "FACEBOOK"]);
+    expect(u.searchParams.get("channelType")).toBe("google");
+    expect(u.searchParams.get("appId")).toBe("a");
+    expect(u.searchParams.get("timestamp")).toBe("99");
+    expect(u.searchParams.get("sign")).toBeTruthy();
+  });
+
+  it("defaultTopSdkBaseUrl: prod / pre / test hosts", () => {
+    expect(defaultTopSdkBaseUrl("prod")).toBe("https://api-sdk-gameplus.meetsocial.com/");
+    expect(defaultTopSdkBaseUrl("pre")).toBe("https://pre-api-sdk-gameplus.meetsocial.com/");
+    expect(defaultTopSdkBaseUrl("test")).toBe("https://test-api-sdk-gameplus.meetsocial.com/");
+  });
+});

package/tests/topsdkDownloadSdkConfig.test.ts

@@ -0,0 +1,81 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { topsdkMd5Base64Sign } from "../src/remote/topsdkSign.js";
+import {
+  buildTopSdkDownloadSdkConfigUrl,
+  fetchTopSdkDownloadSdkConfig,
+  parseTopSdkApiErrorBody,
+} from "../src/remote/topsdkDownloadSdkConfig.js";
+
+describe("TOPSDK downloadSDKConfig client", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it("builds GET URL with appId, channelType, sign, and timestamp", () => {
+    const { url } = buildTopSdkDownloadSdkConfigUrl({
+      baseUrl: "https://test-api-sdk-gameplus.meetsocial.com:1157/",
+      appId: "791251136341225472",
+      appSecret: "test-secret",
+      channelType: "GOOGLE",
+      timestampMillis: 1700000000000,
+    });
+    const u = new URL(url);
+    expect(u.pathname).toContain("downloadSDKConfig");
+    expect(u.searchParams.get("appId")).toBe("791251136341225472");
+    expect(u.searchParams.get("channelType")).toBe("GOOGLE");
+    expect(u.searchParams.get("timestamp")).toBe("1700000000000");
+    expect(u.searchParams.get("sign")).toBe(topsdkMd5Base64Sign("791251136341225472", "test-secret", 1700000000000));
+    expect(u.searchParams.has("devicePlatform")).toBe(false);
+  });
+
+  it("parseTopSdkApiErrorBody detects gp-sdk error envelope", () => {
+    expect(parseTopSdkApiErrorBody({ code: 4007, message: "secret error" })).toMatch(/secret error/);
+    expect(parseTopSdkApiErrorBody({ code: 200, data: {} })).toBeNull();
+  });
+
+  it("fetchTopSdkDownloadSdkConfig returns parsed JSON body and raw text", async () => {
+    const payload = {
+      packageName: "com.example.game",
+      topsdk: { channel: "GOOGLE", appId: "1", appSecret: "sec" },
+      sdkModules: { login: {}, payment: {}, analytics: {} },
+    };
+    const raw = JSON.stringify(payload, null, 2);
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(async () => ({
+        ok: true,
+        status: 200,
+        text: async () => raw,
+      })) as unknown as typeof fetch
+    );
+
+    const { body, text } = await fetchTopSdkDownloadSdkConfig({
+      baseUrl: "https://example.com/",
+      appId: "1",
+      appSecret: "sec",
+      channelType: "GOOGLE",
+    });
+    expect(body).toEqual(payload);
+    expect(text).toBe(raw);
+  });
+
+  it("fetchTopSdkDownloadSdkConfig throws on API error body", async () => {
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(async () => ({
+        ok: true,
+        status: 500,
+        text: async () => JSON.stringify({ code: 10000, message: "channel not found" }),
+      })) as unknown as typeof fetch
+    );
+
+    await expect(
+      fetchTopSdkDownloadSdkConfig({
+        baseUrl: "https://example.com/",
+        appId: "1",
+        appSecret: "sec",
+        channelType: "GOOGLE",
+      })
+    ).rejects.toThrow(/channel not found/);
+  });
+});

package/tests/topsdkFeatureModules.test.ts

@@ -0,0 +1,116 @@
+import { describe, expect, it } from "vitest";
+import {
+  TOPSDK_FEATURE_MODULES,
+  buildTopSdkFeatureImplementationLines,
+  isTopSdkFeatureModuleEnabled,
+} from "../src/config/topsdkFeatureModules.js";
+import { defaultSdkModules, type MeetSdkRemoteConfig } from "../src/config/meetSdkRemoteConfig.js";
+
+const base = (sdk: MeetSdkRemoteConfig["sdkModules"]): MeetSdkRemoteConfig => ({
+  packageName: "com.example",
+  topsdk: {
+    channel: "GOOGLE",
+    appId: "a",
+    appSecret: "s",
+    version: "1",
+    groupId: "com.sino.topsdk",
+    repositories: [],
+  },
+  sdkModules: sdk,
+});
+
+describe("topsdkFeatureModules", () => {
+  it("maps googleIap to google-iap artifact", () => {
+    const row = TOPSDK_FEATURE_MODULES.find((m) => m.subKey === "googleIap");
+    expect(row?.topsdkArtifact).toBe("google-iap");
+    expect(row?.category).toBe("payment");
+  });
+
+  it("buildTopSdkFeatureImplementationLines only includes enabled sdkModules", () => {
+    const m = defaultSdkModules();
+    m.login.google = { googleClientId: "cid" };
+    m.payment.googleIap = { dependencies: [{ implementation: "$groupId:google-iap:$topsdk_version" }] };
+    const cfg = base(m);
+    const lines = buildTopSdkFeatureImplementationLines(cfg);
+    expect(lines.some((l) => l.includes(":google:"))).toBe(true);
+    expect(lines.some((l) => l.includes(":google-iap:"))).toBe(true);
+    expect(lines.some((l) => l.includes(":guest:"))).toBe(false);
+  });
+
+  it("login.facebook credentials object enables facebook artifact", () => {
+    const m = defaultSdkModules();
+    m.login.facebook = { facebookAppId: "", fbLoginProtocolScheme: "", facebookClientToken: "" };
+    m.analytics.facebookdata = false;
+    const cfg = base(m);
+    const lines = buildTopSdkFeatureImplementationLines(cfg);
+    expect(lines.some((l) => l.includes(":facebook:"))).toBe(true);
+    expect(lines.some((l) => l.includes(":facebook-data:"))).toBe(false);
+  });
+
+  it("login.facebook does not imply analytics facebook-data", () => {
+    const m = defaultSdkModules();
+    m.login.facebook = {
+      facebookAppId: "1",
+      fbLoginProtocolScheme: "fb1",
+      facebookClientToken: "t",
+    };
+    m.analytics.facebookdata = false;
+    const cfg = base(m);
+    const lines = buildTopSdkFeatureImplementationLines(cfg);
+    expect(lines.some((l) => l.includes(":facebook:"))).toBe(true);
+    expect(lines.some((l) => l.includes(":facebook-data:"))).toBe(false);
+  });
+
+  it("analytics.facebookdata enables facebook-data only", () => {
+    const m = defaultSdkModules();
+    m.login.facebook = false;
+    m.analytics.facebookdata = { dependencies: [{ implementation: "$groupId:facebook-data:$topsdk_version" }] };
+    const cfg = base(m);
+    const lines = buildTopSdkFeatureImplementationLines(cfg);
+    expect(lines.some((l) => l.includes(":facebook:"))).toBe(false);
+    expect(lines.some((l) => l.includes(":facebook-data:"))).toBe(true);
+  });
+
+  it("analytics.firebase credentials enable firebase artifact", () => {
+    const m = defaultSdkModules();
+    m.analytics.firebase = {
+      firebase_file_url: "https://x/g.json",
+      repositories: ["google"],
+      classpath: "com.google.gms:google-services:4.4.4",
+      applyplugin: "com.google.gms.google-services",
+    };
+    const cfg = base(m);
+    expect(buildTopSdkFeatureImplementationLines(cfg).some((l) => l.includes(":firebase:"))).toBe(true);
+  });
+
+  it("analytics.adjust credentials enable adjust artifact", () => {
+    const m = defaultSdkModules();
+    m.analytics.adjust = { appId: "adj1" };
+    const cfg = base(m);
+    expect(buildTopSdkFeatureImplementationLines(cfg).some((l) => l.includes(":adjust:"))).toBe(true);
+  });
+
+  it("login.line credentials enable line artifact", () => {
+    const m = defaultSdkModules();
+    m.login.line = { clientId: "L" };
+    const cfg = base(m);
+    expect(buildTopSdkFeatureImplementationLines(cfg).some((l) => l.includes(":line:"))).toBe(true);
+  });
+
+  it("isTopSdkFeatureModuleEnabled reads sdkModules only", () => {
+    const row = TOPSDK_FEATURE_MODULES.find((m) => m.topsdkArtifact === "facebook-data")!;
+    const m = defaultSdkModules();
+    m.analytics.facebookdata = { dependencies: [{ implementation: "$groupId:facebook-data:$topsdk_version" }] };
+    expect(isTopSdkFeatureModuleEnabled(base(m), row)).toBe(true);
+  });
+
+  it("enables module only when subKey is present (key-based integrate)", () => {
+    const kakaoRow = TOPSDK_FEATURE_MODULES.find((m) => m.subKey === "kakao")!;
+    const m = defaultSdkModules();
+    m.login = { google: { googleClientId: "cid" } } as typeof m.login;
+    expect(isTopSdkFeatureModuleEnabled(base(m), kakaoRow)).toBe(false);
+
+    m.login.kakao = { clientId: "k", scheme: "s" };
+    expect(isTopSdkFeatureModuleEnabled(base(m), kakaoRow)).toBe(true);
+  });
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: false,
+    environment: "node",
+    include: ["tests/**/*.test.ts"],
+  },
+});

package/vitest.mcp.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: false,
+    environment: "node",
+    include: ["tests/mcp.e2e.ts"],
+    testTimeout: 20_000,
+    hookTimeout: 20_000,
+  },
+});

package/bundled/android/sample.txt

@@ -1 +0,0 @@
-bundled-sample

package/docs/ANDROID.md

@@ -1,133 +0,0 @@
-# Android 集成工具说明
-
-本仓库（`meet-sdk-tool`）内的 CLI 与库代码**全部为 TypeScript**；发布时由 `tsc` 编译到 `dist/*.js`，npm `bin` 指向编译产物。
-
-## 范围
-
-- **Android**：远程拉取配置、组装 JSON、按步骤修改 Gradle / `AndroidManifest.xml` / 拷贝 `bundled/` 资源等（步骤可扩展）。
-- **iOS**：暂不实现；`src/ios/reserved.ts` 中保留占位类型与说明，便于后续接入。
-
-## 远程接口文档
-
-meet-sdk-tool 用到的及对照用的 HTTP 接口（含 `downloadSDKConfig`、`getSDKConfig`、`getChannelConfig` 样例）见 **[`docs/API.md`](./API.md)**。
-
-## 远程配置（TOPSDK，与平台无关）
-
-与 **Android / iOS 共用同一套 HTTP 接口**，实现对齐 `topsdk-tool-ios`：
-
-- 路径：`GET {baseUrl}console/openSDK/getSDKConfig`
-- 查询参数：`appId`、`authType`（可重复多次）、`channelType`、`sign`、`timestamp`（毫秒）
-- 签名：`sign = base64( md5_binary( appId + appSecret + timestamp ) )`，与 `topsdk-tool-ios` 仓库中 `TOPSDKUtils/ChannelConfigManager.py` 的 `md5_base64_byte` 一致。
-- 默认 `baseUrl` 由 **`--env`** 决定（**不传则 `prod` 正式服**）：`prod` → `https://api-sdk-gameplus.meetsocial.com/`；`pre` → `https://pre-api-sdk-gameplus.meetsocial.com/`；`test` → `https://test-api-sdk-gameplus.meetsocial.com/`（开发调试请显式 `--env test`）。**不再提供 `--base-url`**。
-- 请求前会从 `authType` 列表中移除 `GUEST`、`UI`、`IAPPAY`（与 `ChannelConfigManager.getSdkConfig` 行为一致）。Android 侧若使用 `google` 等渠道，通过 `--channel-type` 传入即可（与 iOS 传 `apple` 一样走同一 URL）。
-- **服务端与字段**：`gp-sdk` 的 `openSDK/getSDKConfig`（`SDKDownloadController`）返回体通常 **只有** `data.channelAuthConfig`（`VOSDKConfig`），与 `topsdk-tool` / `topsdk-tool-ios` 解析的 `channelAuthConfig` 一致。`sdk-home` 提供的是 **SDK 包下载**（`/home/sdk-download/...`），不负责该配置接口。控制台 VO 里 Facebook 的 **client token 多在 `secret`**；AppsFlyer 的 **devKey 在 `secret`**（`clientId` 可能为其它业务字段）。SDK 版本、仓库、构件依赖、Firebase Gradle plugin 等固定集成配置由工具内置的 `meetsdk-android.json` 提供。
-
-对应 TypeScript 实现：`[src/remote/topsdkGetSdkConfig.ts](../src/remote/topsdkGetSdkConfig.ts)`、`[src/remote/topsdkSign.ts](../src/remote/topsdkSign.ts)`；映射为 mock 形输出：`[src/config/meetSdkRemoteConfig.ts](../src/config/meetSdkRemoteConfig.ts)`。
-
-### `fetch-config` 与缓存文件 `meetsdk-remote-config.json`
-
-拉取结果**始终**写入宿主工程根目录下的 **`meetsdk-remote-config.json`**（即 `<project-root>/meetsdk-remote-config.json`），作为本地缓存，**不提供自定义输出路径**。该文件只放每个游戏不同的后台参数：`packageName`、根级 `channel` / `devicePlatform`、`topsdk.appId/appSecret` 以及各插件的业务参数（例如登录 clientId、AppsFlyer devKey、Firebase `firebase_file_url`、Adjust appId）。固定 SDK 集成配置放在工具内置的 [`meetsdk-android.json`](../meetsdk-android.json) 中，包括 `topsdk.version/groupId/repositories`、插件仓库、Firebase `classpath/applyplugin` 和各插件 `dependencies`。标准集成步骤放在工具内置 [`recipes/android-default.yaml`](../recipes/android-default.yaml) 中，测试 fixture 放在 [`fixtures/recipes/`](../fixtures/recipes/) 中，游戏工程目录不需要放 recipe/fixture 文件。远程配置请用 `fetch-config` 或 `setup` 从后台拉取；`fixtures/meetsdk-remote-config.mock.json` 仅用于本仓库 Vitest，勿用于真实游戏工程。仓库内自带可跑的 Android 宿主样例见 `[test-projects/android-sample/](../test-projects/android-sample/)`（仅包含宿主工程文件与 `meetsdk-remote-config.json`）；另可在同级目录下并列更多工程（如 `[test-projects/android-sample-b/](../test-projects/android-sample-b/)），用不同 `--project-root` 分别验证；说明见 `[test-projects/README.md](../test-projects/README.md)`。Vitest 管线测试默认只使用 `android-sample/`。
-
-**与 `topsdk-tool-ios` 一致**：iOS 工具在 Python 里固定调用 `getChannelConfigUrl() + 'console/openSDK/getSDKConfig'`，用 `appId` / `appSecret` / `channelType` / `authType[]` 等拼查询串并算 `sign`，**没有**「用户传入任意完整 URL」的模式。本 CLI 的 `fetch-config` 同样**只走该 TOPSDK 接口**，不提供 `--url`。
-
-**含义**：CLI 调用 `**console/openSDK/downloadSDKConfig`**（无需 sign）：用 `appId`、`channelType` 拉取与 gp-sdk 一致的 `meetsdk-remote-config.json` 全文并**原样**写入工程根目录（不做 JSON 再序列化，不合并 `meetsdk-android.json`；后者仅在 `integrate` 时在内存中合并）。
-
-```bash
-meetgames fetch-config \
-  --project-root /path/to/android-project \
-  --app-id 791251136341225472 \
-  --channel-type GOOGLE \
-  --env test
-```
-
-`--app-id` 与 `--channel-type` 为调用接口所必需（也可来自已有 `meetsdk-remote-config.json` 或 `TOPSDK_APP_ID` / `TOPSDK_CHANNEL_TYPE`）。`packageName`、`topsdk.appSecret` 等由接口返回的 JSON 写入，无需 CLI 传入。gp-sdk 按 `(appId, channelType)` 查 channel。`--auth-type` / `TOPSDK_AUTH_TYPES` 已忽略（仅兼容旧脚本）。
-
-### CLI 参数与子命令对应关系
-
-解析器是**全局**的：除未知 token 会报错外，部分参数在某一子命令下**不会生效**（仅为与其它子命令共用同一套 flag 名）。
-
-
-| 参数                               | `fetch-config` | `integrate` / `setup`                          | `doctor` |
-| -------------------------------- | -------------- | ------------------------------------------ | ----------------- |
-| `--project-root`                 | 是（缓存目录）        | 是                                          | 是                 |
-| `--app-id`                       | 是（必填*）        | 否                                          | 否                 |
-| `--channel-type`                 | 是（必填*）        | 否                                          | 否                 |
-| `--auth-type`（可重复）               | 忽略（兼容）         | 否                                          | 否                 |
-| `--env`（`prod` / `pre` / `test`，默认 `prod`） | 是              | 否                                          | 否                 |
-| `--verbose`                      | 是              | 是                                          | 是                 |
-| `--dry-run`                      | 忽略             | 是（仅预览、不写盘）                                 | 否                 |
-| `--report-file`                  | 忽略             | 是                                          | 否                 |
-| `--patch-file`                   | 忽略             | 是                                          | 否                 |
-| `--help` / `-h`                  | 是              | 是                                          | 是                 |
-
-
-因此，在 `**fetch-config`** 上除本地 `meetsdk-remote-config.json` 外，**实际参与拉取**的还有：`--env`、`--verbose`，以及 `--app-id`、`--channel-type`（或环境变量 / 已有缓存文件）。`--dry-run`、`--report-file`、`--patch-file` 可被解析但不会改变 `fetch-config` 行为。
-
-## 其它命令
-
-1. `**integrate`** / `**setup**`：固定读取工具内置 `recipes/integrate-default.yaml`，对 `--project-root` 下的工程执行标准集成步骤（`setup` 会先 `fetch-config`）。
-2. `**doctor**`：检测工程类型（Android / iOS）与路径，不写入配置。
-
-`**integrate` 默认写磁盘**；若流水线或本地只想生成 diff、不落盘，请显式传入 `**--dry-run`**（可配合 `--patch-file` 输出 patch 文件）。Vitest 在 `tests/pipeline.preview.patch.test.ts` 中把内置 recipe 与 schema fixture 的 dry-run diff **合并写入唯一文件** `**test-projects/_preview/pipeline.patch`**（`npm test` 后打开即可核对）。
-
-## Gradle 编辑方式（Groovy only）
-
-| 项 | 说明 |
-|----|------|
-| **现阶段** | **正则 + 括号匹配**定位 `android` / `defaultConfig` / `dependencies` 等块；**行级正则**识别 `resValue`、`implementation`；**`// >>> TOPSDK … START/END`** 标记块做幂等写入（实现：`src/android/gradle.ts`、`src/android/meetSdkRemoteGradle.ts`） |
-| **将来** | 改用 **Groovy AST** 做块定位与语句级改写 |
-| **不支持** | **`build.gradle.kts`（Kotlin DSL）** — 仅支持 Groovy DSL 的 `build.gradle` |
-
-详见 [技术方案调研.md §6](./技术方案调研.md#6-gradle-编辑技术路线正则--groovy-ast)。
-
-## `gradle.applyMeetSdkRemoteConfig`
-
-与 **sdk-integration-agent**（`topsdk-agent`）中 `gradleEditor.js` 一致：读取工程根下的 `**meetsdk-remote-config.json`**（或由步骤参数 `**configFile**` 指定相对路径），再与工具内置 `**meetsdk-android.json**` 合并；只对远程配置中已出现的插件补齐 SDK 固定配置，校验后：
-
-- 在**根目录 `build.gradle`** 的 `allprojects { repositories { … } }` 内写入 `**// >>> TOPSDK REPO AUTO START/END**` 托管块，从内置 `meetsdk-android.json` 汇总已启用插件与 TopSdk 仓库声明生成 `google()` / `mavenCentral()` / `maven { url '…' }`；默认顺序为 Firebase、AppsFlyer、TopSdk。
-- 若开启 `sdkModules.analytics.firebase`，在**根目录 `build.gradle`** 的 `buildscript { repositories { … } dependencies { … } }` 内写入 Firebase 所需仓库与 `classpath`（默认示例为 `com.google.gms:google-services:4.4.4`）。
-- 在 **application 模块 `build.gradle`** 的 `defaultConfig { … }` 内把 `applicationId` 更新为远程配置里的 `packageName`，并写入 `**resValue**`（`top_channel_id`、`top_app_id`、Facebook / Google / AppsFlyer 等），在文件顶部写入 Firebase 的 `apply plugin`（默认示例为 `com.google.gms.google-services`），并在 `**dependencies { … }**` 内写入 `**def topsdk_version` / `def groupId**`、`implementation "$groupId:ui:$topsdk_version"` 以及内置 `meetsdk-android.json` 中对应插件的 `dependencies` 配置。
-
-与 `**gradle.insertRepositories**`（`MEET_INTEGRATE REPOS` 标记块）可并存于同一 `repositories` 闭包内；当前 `**test-projects/android-sample**` 已仅用本 op 从 `meetsdk-remote-config.json` 写入仓库与依赖。
-
-### `sdkModules`、凭证与 Gradle 依赖
-
-- **不再**使用顶层 `facebook` / `google` / `appsflyer`，也不使用扁平 `features` / `featuresByCategory`；解析时若仍存在这些顶层键会拒绝（`tryParseAsMeetSdkRemoteConfig` 返回 `null`）。
-- **所有插件**：integrate 仅当 `sdkModules` 对应 scope 下**写了子键**时接入（如 `kakao`、`appsflyer`、`facebookdata`）；有键则 value 为 `{}` 或参数对象。无配置则不写该键。远程配置对象只放业务参数，仓库、`classpath`、`applyplugin`、`dependencies` 从内置 `meetsdk-android.json` 按插件 key 补齐。
-- **`login.facebook` / `login.google` / `analytics.appsflyer` 等带参数插件**：对象内只包含插件业务参数；直接写 `true` 会被拒绝，避免缺参数误开启。
-- **`login.guest` / `login.email` / `payment.googleIap` / `analytics.facebook` 等无参数插件**：使用空对象 `{}` 表示开启；其中 **`analytics.facebook`** 只控制埋点构件 `facebook-data`，与登录 Facebook 无关。
-
-示例（开启 Facebook / Google 登录与 AppsFlyer 时，参数写在对应子键下）：
-
-```json
-"sdkModules": {
-  "login": {
-    "guest": {},
-    "email": {},
-    "facebook": {
-      "facebookAppId": "…",
-      "fbLoginProtocolScheme": "fb…",
-      "facebookClientToken": "…"
-    },
-    "google": { "googleClientId": "….apps.googleusercontent.com" }
-  },
-  "payment": {
-    "googleIap": {}
-  },
-  "analytics": {
-    "appsflyer": {
-      "enableDebugLog": false,
-      "devKey": "…"
-    }
-  }
-}
-```
-
-- **`login.facebook`**（为对象时）→ Gradle 写入 Facebook 相关 `resValue`，并追加 TOPSDK 构件 **`facebook`**（见 [`topsdkFeatureModules.ts`](../src/config/topsdkFeatureModules.ts)）。
-- **`analytics.facebook`**（为对象时）→ 构件 **`facebook-data`**（Maven 名在内置 `meetsdk-android.json` 中维护）。
-- **`fetch-config`**：仍按 `channelAuthConfig` 把各 auth 项映射为上述嵌套结构（直接落在 `sdkModules` 内）。
-- 扩展：在 `MeetSdkRemoteConfig` / `normalizeSdkModulesFromUnknown` 增加子模块形状，并在内置 `meetsdk-android.json` 中补对应插件的仓库、依赖或 Gradle plugin 配置。
-
-## 后续扩展
-
-在 `src/ops/handlers.ts` 中可继续新增其它 `op`，扩展 manifest 能驱动的工程修改能力。