siluzan-tso-cli 1.0.0-beta.10

package/dist/commands/open-account.js

@@ -0,0 +1,988 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as readline from "node:readline/promises";
+import { stdin as stdinStream, stdout as stdoutStream } from "node:process";
+import { loadConfig, apiFetch } from "../utils/auth.js";
+/**
+ * 查询当前账号下的广告主组列表。
+ * GET /query/profile/steward-individual
+ *
+ * 接口返回完整 profile 对象，广告主组在 profile.mediaAccountGroups 中。
+ * 每个广告主组的 key 字段即为开户时需要的 MediaAccountGroupId（magKey）。
+ */
+export async function runListAdvertiserGroups(opts) {
+    const config = loadConfig(opts.token);
+    let data;
+    try {
+        data = await apiFetch(`${config.apiBaseUrl}/query/profile/steward-individual`, config, {}, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 查询广告主组失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(data?.profile?.mediaAccountGroups ?? [], null, 2));
+        return;
+    }
+    const groups = data?.profile?.mediaAccountGroups ?? [];
+    if (groups.length === 0) {
+        console.log("\n  暂无广告主组，请先在 Siluzan TSO 平台创建广告主。\n");
+        return;
+    }
+    console.log(`\n广告主组列表（共 ${groups.length} 条）\n`);
+    const header = ["magKey（开户时使用）".padEnd(38), "广告主名称".padEnd(28), "类型".padEnd(12), "状态"].join("  ");
+    console.log("  " + header);
+    console.log("  " + "-".repeat(header.length));
+    for (const g of groups) {
+        const key = (g.key ?? "").toString();
+        const name = (g.advertiserName ?? "").toString();
+        const type = (g.advertiserType ?? "").toString();
+        const status = g.disabled ? "已禁用" : "正常";
+        console.log("  " + [key.padEnd(38), name.padEnd(28), type.padEnd(12), status].join("  "));
+    }
+    console.log("\n提示：Google 开户可用 `open-account google`，按公司名称自动关联广告主组，一般无需手动传 magKey。\n");
+}
+/** 与网页 openAnAccount 一致：无协议时补全为 https:// */
+function normalizePromotionLinkForGoogle(url) {
+    const t = url.trim();
+    if (/^https?:\/\//i.test(t))
+        return t;
+    return `https://${t}`;
+}
+function extractMagKeyFromStewardResponse(res) {
+    if (!res || typeof res !== "object")
+        return undefined;
+    const o = res;
+    const top = o.magKey;
+    if (typeof top === "string" && top.trim())
+        return top.trim();
+    const inner = o.data;
+    if (inner && typeof inner === "object" && !Array.isArray(inner)) {
+        const m = inner.magKey;
+        if (typeof m === "string" && m.trim())
+            return m.trim();
+    }
+    return undefined;
+}
+/**
+ * 通用 MAG 解析：按公司名在广告主组列表中精确匹配，存在则 Update，不存在则 Add。
+ * 与网页 checkMa() + 第一步表单提交逻辑完全一致（所有媒体共用相同模式）。
+ *
+ * @param company       公司名称（用于精确匹配）
+ * @param magPayload    写入 mediaAccountGroup 的字段（各媒体有差异）
+ * @param advertiserId  若已手动指定，直接使用（跳过自动解析）
+ */
+async function resolveGenericMagKey(config, company, magPayload, verbose, advertiserId) {
+    if (advertiserId?.trim())
+        return advertiserId.trim();
+    let profile;
+    try {
+        profile = await apiFetch(`${config.apiBaseUrl}/query/profile/steward-individual`, config, {}, verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 无法拉取广告主组信息：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const groups = profile?.profile?.mediaAccountGroups ?? [];
+    const existing = groups.find((g) => (g.advertiserName ?? "").trim() === company.trim());
+    const baseUrl = `${config.apiBaseUrl}/command/profile/steward-individual`;
+    let res;
+    if (existing?.key) {
+        console.log(`\n  ℹ️  已存在同名广告主组，正在更新资料…`);
+        res = await apiFetch(`${baseUrl}/${encodeURIComponent(String(existing.key))}`, config, {
+            method: "PUT",
+            body: JSON.stringify({ advertiserName: company, ...magPayload }),
+            headers: { "s-command-type": "UpdateMediaAccountGroup" },
+        }, verbose);
+    }
+    else {
+        console.log(`\n  ℹ️  未找到同名广告主组，正在创建…`);
+        res = await apiFetch(baseUrl, config, {
+            method: "PUT",
+            body: JSON.stringify({ mediaAccountGroup: { advertiserName: company, ...magPayload } }),
+            headers: { "s-command-type": "AddMediaAccountGroup" },
+        }, verbose);
+    }
+    const magKey = extractMagKeyFromStewardResponse(res);
+    if (!magKey) {
+        if (verbose) {
+            console.error(`  ⚠️  创建/更新广告主组响应（无法解析 magKey）：${JSON.stringify(res).slice(0, 500)}`);
+        }
+        console.error("\n❌ 服务端未返回 magKey，无法继续提交开户。可加 --verbose 查看响应。\n");
+        process.exit(1);
+    }
+    return magKey;
+}
+/**
+ * 解析 Google 开户所需的 MediaAccountGroupId（magKey）。
+ * - 若调用方已传 advertiserId，直接使用；
+ * - 否则 GET profile，按公司名称精确匹配已有广告主组；有则 Update，无则 Add；
+ *   与网页第一步逻辑一致（见 openAnAccount.vue）。
+ */
+async function resolveGoogleMediaAccountGroupId(config, opts) {
+    if (opts.advertiserId?.trim()) {
+        return opts.advertiserId.trim();
+    }
+    const company = opts.company.trim();
+    const promotionLink = normalizePromotionLinkForGoogle(opts.promotionLink);
+    const level1 = (opts.industryLevel1 ?? "").trim();
+    const level2 = (opts.industryLevel2 ?? "").trim();
+    let profile;
+    try {
+        profile = await apiFetch(`${config.apiBaseUrl}/query/profile/steward-individual`, config, {}, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 无法拉取广告主组信息：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const groups = profile?.profile?.mediaAccountGroups ?? [];
+    const existing = groups.find((g) => (g.advertiserName ?? "").trim() === company);
+    const ex = existing;
+    const storageRaw = ex?.StorageProvider ?? ex?.storageProvider;
+    const storageFromGroup = typeof storageRaw === "string" ? storageRaw : undefined;
+    const mediaAccountGroupPayload = {
+        advertiserName: company,
+        StorageProvider: storageFromGroup ?? "StorageAccount",
+        industry: { level1: level1, level2: level2 },
+        promotionLink,
+        promotionType: opts.promotionType,
+    };
+    let res;
+    const baseUrl = `${config.apiBaseUrl}/command/profile/steward-individual`;
+    if (existing?.key) {
+        if (!opts.verbose) {
+            console.log(`\n  ℹ️  已存在同名广告主组，正在更新资料…`);
+        }
+        res = await apiFetch(`${baseUrl}/${encodeURIComponent(String(existing.key))}`, config, {
+            method: "PUT",
+            body: JSON.stringify(mediaAccountGroupPayload),
+            headers: { "s-command-type": "UpdateMediaAccountGroup" },
+        }, opts.verbose);
+    }
+    else {
+        if (!opts.verbose) {
+            console.log(`\n  ℹ️  未找到同名广告主组，正在创建…`);
+        }
+        res = await apiFetch(baseUrl, config, {
+            method: "PUT",
+            body: JSON.stringify({ mediaAccountGroup: mediaAccountGroupPayload }),
+            headers: { "s-command-type": "AddMediaAccountGroup" },
+        }, opts.verbose);
+    }
+    const magKey = extractMagKeyFromStewardResponse(res);
+    if (!magKey) {
+        if (opts.verbose) {
+            console.error(`  ⚠️  创建/更新广告主组响应（无法解析 magKey）：${JSON.stringify(res).slice(0, 500)}`);
+        }
+        console.error("\n❌ 服务端未返回 magKey，无法继续提交开户。可加 --verbose 查看响应。\n");
+        process.exit(1);
+    }
+    return magKey;
+}
+/**
+ * 提交 Yandex 开户申请（无图片，全部为文字参数）。
+ * 流程：按公司名自动创建/匹配广告主组（与网页一致）→ POST /command/media-account/AddAgencyClient
+ */
+export async function runOpenAccountYandex(opts) {
+    const config = loadConfig(opts.token);
+    const magKey = await resolveGenericMagKey(config, opts.company, 
+    // Yandex MAG payload 只需要 advertiserName，其余字段不传
+    {}, opts.verbose, opts.advertiserId);
+    const body = {
+        MediaAccountGroupId: magKey,
+        AgencyClientInfo: {
+            Login: opts.login,
+            FirstName: opts.firstName,
+            LastName: opts.lastName,
+            Currency: "USD",
+            Notification: {
+                Email: opts.email,
+            },
+            TinInfo: {
+                TinType: "FOREIGN_LEGAL",
+                Tin: opts.tin,
+            },
+            AccountInfo: {
+                Phone: opts.phone,
+                TaxpayerNumber: opts.taxpayerNumber ?? "",
+                WebUrl: opts.webUrl ?? "",
+            },
+        },
+    };
+    try {
+        const res = await apiFetch(`${config.apiBaseUrl}/command/media-account/AddAgencyClient`, config, { method: "POST", body: JSON.stringify(body) }, opts.verbose);
+        console.log("\n✅ Yandex 开户申请已提交成功，请在「开户记录」页面查看审核状态。\n");
+        if (opts.verbose && res != null) {
+            console.log("响应：", JSON.stringify(res, null, 2));
+        }
+    }
+    catch (err) {
+        console.error(`\n❌ 提交失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * 上传文件到附件接口，返回 { id, fileName }。
+ * POST /command/attachment（multipart/form-data）
+ *
+ * 不经过 apiFetch，直接调用 fetch，因为需要 FormData（自动处理 Content-Type + boundary）。
+ */
+async function uploadAttachment(filePath, apiBaseUrl, config, verbose) {
+    const fileName = path.basename(filePath);
+    const fileBuffer = fs.readFileSync(filePath);
+    const mimeType = guessContentType(fileName);
+    const form = new FormData();
+    form.append("file", new Blob([fileBuffer], { type: mimeType }), fileName);
+    const uploadUrl = `${apiBaseUrl}/command/attachment`;
+    const res = await fetch(uploadUrl, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.authToken}`,
+            Datapermission: config.dataPermission ?? "",
+            // 注意：不手动设置 Content-Type，让 fetch 自动添加含 boundary 的值
+        },
+        body: form,
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        const detail = verbose ? `：${text.slice(0, 300)}` : "";
+        throw new Error(`上传文件 HTTP ${res.status}${detail}`);
+    }
+    const data = JSON.parse(text);
+    if (!data.id) {
+        throw new Error("上传文件失败：响应中未包含文件 ID");
+    }
+    return { id: data.id, fileName };
+}
+function guessContentType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    const map = {
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".png": "image/png",
+        ".gif": "image/gif",
+        ".pdf": "application/pdf",
+        ".bmp": "image/bmp",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+/**
+ * 提交 Bing/BingV2 开户申请。
+ * 流程：先上传营业执照 → 自动创建/匹配广告主组 → 提交开户请求。
+ * 与网页 bingOpenAnAccount.vue 行为一致，用户只需填公司名，无需关心 magKey。
+ * POST /command/media-account/AddBingV2Account
+ */
+export async function runOpenAccountBing(opts) {
+    const config = loadConfig(opts.token);
+    if (!fs.existsSync(opts.licenseFile)) {
+        console.error(`\n❌ 营业执照文件不存在：${opts.licenseFile}\n`);
+        process.exit(1);
+    }
+    console.log("  正在上传营业执照...");
+    let fileId;
+    let fileName;
+    try {
+        const uploaded = await uploadAttachment(opts.licenseFile, config.apiBaseUrl, config, opts.verbose);
+        fileId = uploaded.id;
+        fileName = uploaded.fileName;
+    }
+    catch (err) {
+        console.error(`\n❌ 营业执照上传失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log(`  营业执照上传成功，FileId: ${fileId}`);
+    // Bing MAG payload 包含 advertiserName + 执照图片信息
+    const magKey = await resolveGenericMagKey(config, opts.advertiserName, { ImageId: fileId, StorageProvider: "StorageAccount" }, opts.verbose, opts.advertiserId);
+    const body = {
+        MediaAccountGroupId: magKey,
+        AccountCount: opts.accountCount ?? 1,
+        BingCustomerInfo: {
+            name: opts.advertiserName,
+            province: opts.province,
+            tradeId: opts.tradeId,
+            nameShort: opts.nameShort,
+            postcode: opts.postcode ?? "",
+            city: opts.city,
+            address: opts.address,
+            promotionLink: opts.promotionLink,
+            directAgent: "",
+            FileId: fileId,
+            FileName: fileName,
+        },
+        BingV2AccountInfo: {
+            nameRemarkList: [],
+            promotionLink: opts.promotionLink,
+            address: opts.address,
+            city: opts.city,
+            companyName: opts.advertiserName,
+            postcode: opts.postcode ?? "",
+            province: opts.province,
+            tradeId: opts.tradeId,
+            nameShort: opts.nameShort,
+            FileId: fileId,
+            FileName: fileName,
+            AdvertiserCid: opts.advertiserCid ?? "",
+            AdvertiserName: opts.advertiserName2 ?? "",
+        },
+    };
+    try {
+        await apiFetch(`${config.apiBaseUrl}/command/media-account/AddBingV2Account`, config, { method: "POST", body: JSON.stringify(body) }, opts.verbose);
+        console.log("\n✅ Bing 开户申请已提交成功，请在「开户记录」页面查看审核状态。\n");
+    }
+    catch (err) {
+        console.error(`\n❌ 提交失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * 将图片 base64 上传到 Kwai，获取 blobstoreKey。
+ * POST /KwaiAccount/Management/Upload
+ * Body: { ImageType: "jpeg", base64Image: "<base64>" }
+ */
+async function uploadToKwai(filePath, apiBaseUrl, config, verbose) {
+    const ext = path.extname(filePath).toLowerCase().replace(".", "").replace("jpg", "jpeg");
+    const imageType = ext || "jpeg";
+    const fileBuffer = fs.readFileSync(filePath);
+    const base64Image = fileBuffer.toString("base64");
+    const res = await apiFetch(`${apiBaseUrl}/KwaiAccount/Management/Upload`, config, {
+        method: "POST",
+        body: JSON.stringify({ ImageType: imageType, base64Image }),
+    }, verbose);
+    const blobstoreKey = res?.data?.fileBlobKey;
+    if (!blobstoreKey) {
+        throw new Error("Kwai 图片上传失败：响应中未包含 fileBlobKey");
+    }
+    return blobstoreKey;
+}
+/**
+ * 提交 Kwai 开户申请。
+ * 流程：先上传营业执照图片至 Kwai → 自动创建/匹配广告主组 → 提交开户请求。
+ * 与网页 KwaiOpenAnAccount.vue 行为一致，用户只需填公司名，无需关心 magKey。
+ * POST /command/media-account/AddKwaiAccount
+ */
+export async function runOpenAccountKwai(opts) {
+    const config = loadConfig(opts.token);
+    if (!fs.existsSync(opts.licenseFile)) {
+        console.error(`\n❌ 营业执照文件不存在：${opts.licenseFile}\n`);
+        process.exit(1);
+    }
+    console.log("  正在上传营业执照到 Kwai...");
+    let blobstoreKey;
+    try {
+        blobstoreKey = await uploadToKwai(opts.licenseFile, config.apiBaseUrl, config, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 营业执照上传失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log(`  上传成功，blobstoreKey: ${blobstoreKey}`);
+    // Kwai MAG payload 包含 advertiserName + 执照图片信息
+    // blobstoreKey 对应 Kwai 上传的图片 ID（与网页 ImageId 概念一致）
+    const magKey = await resolveGenericMagKey(config, opts.companyName, { ImageId: blobstoreKey, StorageProvider: "StorageAccount" }, opts.verbose, opts.advertiserId);
+    const body = {
+        MediaAccountGroupId: magKey,
+        KwaiAccountInfo: {
+            licenceId: opts.licenceId,
+            licenceRegisterCountryCode: opts.licenceCountry,
+            licenceRegisterLocation: opts.licenceLocation,
+            businessScope: opts.businessScope,
+            product: opts.product,
+            advertisementType: opts.adType,
+            productUrl: opts.productUrl,
+            currencyCode: "USD",
+            licenceIdType: opts.licenceIdType,
+            accountName: opts.accountName,
+            legalEntityName: opts.companyName,
+            newIndustryId1: opts.industryId1,
+            newIndustryId2: opts.industryId2,
+            mainCertPhotos: [
+                {
+                    blobstoreKey,
+                    expireType: opts.expireType,
+                    expireAt: opts.expireType === 2 ? 0 : (opts.expireAt ?? 0),
+                },
+            ],
+            targetCountryInfos: [{ targetCountryCode: opts.targetCountry }],
+        },
+    };
+    try {
+        await apiFetch(`${config.apiBaseUrl}/command/media-account/AddKwaiAccount`, config, { method: "POST", body: JSON.stringify(body) }, opts.verbose);
+        console.log("\n✅ Kwai 开户申请已提交成功，请在「开户记录」页面查看审核状态。\n");
+    }
+    catch (err) {
+        console.error(`\n❌ 提交失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * GET /query/media-account/Google/TimeZoneInfo/ReadFile
+ * 与网页「第二步」广告账户表格里时区下拉同一数据源。
+ */
+export async function fetchGoogleTimezoneRows(config, verbose) {
+    const raw = await apiFetch(`${config.apiBaseUrl}/query/media-account/Google/TimeZoneInfo/ReadFile`, config, {}, verbose);
+    if (Array.isArray(raw))
+        return raw;
+    if (raw && typeof raw === "object" && Array.isArray(raw.data)) {
+        return raw.data;
+    }
+    return [];
+}
+export async function runOpenAccountGoogleTimezones(opts) {
+    const config = loadConfig(opts.token);
+    let rows;
+    try {
+        rows = await fetchGoogleTimezoneRows(config, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 拉取时区列表失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const kw = (opts.keyword ?? "").trim().toLowerCase();
+    if (kw) {
+        rows = rows.filter((r) => {
+            const code = String(r.Code ?? "").toLowerCase();
+            const name = String(r.Name ?? "").toLowerCase();
+            const time = String(r.Time ?? "").toLowerCase();
+            const label = `(${r.Time ?? ""})${r.Name ?? ""}`.toLowerCase();
+            return code.includes(kw) || name.includes(kw) || time.includes(kw) || label.includes(kw);
+        });
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    console.log(`\nGoogle 开户可选时区（与网页 /openAnAccount 下拉一致，共 ${rows.length} 条）\n`);
+    if (rows.length === 0) {
+        console.log("  无数据。可尝试去掉 --keyword 或加 --verbose。\n");
+        return;
+    }
+    const codeW = Math.min(36, Math.max(10, ...rows.map((r) => String(r.Code ?? "").length)));
+    const labelW = Math.min(56, Math.max(12, ...rows.map((r) => `(${r.Time ?? ""})${r.Name ?? ""}`.length)));
+    const head = ["#".padStart(4), "Code".padEnd(codeW), "展示（与网页相同）".padEnd(labelW)].join("  ");
+    console.log("  " + head);
+    console.log("  " + "-".repeat(head.length));
+    rows.forEach((r, i) => {
+        const label = `(${r.Time ?? ""})${r.Name ?? ""}`;
+        console.log("  " + [String(i + 1).padStart(4), String(r.Code ?? "").padEnd(codeW), label.slice(0, labelW).padEnd(labelW)].join("  "));
+    });
+    console.log("\n提示：选币种后网页会默认 —— CNY → Asia/Shanghai，USD → Asia/Hong_Kong；其它时区请从上表取 Code。\n");
+}
+/** 与网页 changeCurrency 一致 */
+function defaultGoogleTimezoneForCurrency(currency) {
+    return currency.trim().toUpperCase() === "CNY" ? "Asia/Shanghai" : "Asia/Hong_Kong";
+}
+/**
+ * 交互式 Google 开户向导：字段顺序与网页 openAnAccount（Google）两步表单一致，
+ * 并说明顶部「五步」进度条含义（CLI 只能代劳前两步的数据采集与提交）。
+ */
+export async function runOpenAccountGoogleWizard(opts) {
+    if (!stdinStream.isTTY || !stdoutStream.isTTY) {
+        console.error("\n❌ 当前不是交互式终端（无 TTY）。请改用非交互命令：\n" +
+            "   siluzan-tso open-account google --company \"…\" --promotion-link \"…\" ...\n" +
+            "   或先查时区：siluzan-tso open-account google-timezones\n\n");
+        process.exit(1);
+    }
+    const rl = readline.createInterface({ input: stdinStream, output: stdoutStream });
+    const q = async (prompt) => (await rl.question(prompt)).trim();
+    try {
+        console.log(`
+╔══════════════════════════════════════════════════════════════════╗
+║  Google 开户向导（对齐网页：/v3/foreign_trade/tso/openAnAccount） ║
+╚══════════════════════════════════════════════════════════════════╝
+
+  页面顶部「五步」为整体开户生命周期（与 CLI 分工如下）：
+
+  ① 准备开户资料     → 你已具备公司名、网址、推广类型等信息即可
+  ② 填写申请         → 【本向导收集并提交】对应网页第 1、2 步表单
+  ③ 等待审核         → 网页「开户记录」或：siluzan-tso account-history -m Google
+  ④ 审核通过         → 同上查看状态
+  ⑤ 充值激活账户     → 须在丝路赞网页完成（CLI 无法代充值）
+
+  网页提示：美元账户最低充值约 100 USD、人民币约 700 CNY（以页面为准）。
+
+──────────────────────── 【网页第 1 步】企业 / 推广信息 ────────────────────────
+`);
+        const company = await q("公司名称（与营业执照一致，可匹配已有广告主组）：");
+        if (!company) {
+            console.error("\n❌ 公司名不能为空。\n");
+            process.exit(1);
+        }
+        console.log("\n网址协议（网页左侧下拉：https:// 或 http://）");
+        const protoAns = await q("输入 1=https（默认） 2=http ：");
+        const urlProto = protoAns === "2" ? "http://" : "https://";
+        const urlRest = await q(`域名或路径（不要重复协议，例如 www.example.com）：`);
+        if (!urlRest) {
+            console.error("\n❌ 网址不能为空。\n");
+            process.exit(1);
+        }
+        const promotionLink = /^https?:\/\//i.test(urlRest) ? urlRest.trim() : `${urlProto}${urlRest.trim()}`;
+        console.log("\n推广类型（网页单选 B2B / B2C / APP）");
+        const typeAns = await q("输入 1=b2b（默认） 2=b2c 3=app ：");
+        let promotionType = "b2b";
+        if (typeAns === "2")
+            promotionType = "b2c";
+        else if (typeAns === "3")
+            promotionType = "app";
+        console.log(`
+──────────────────────── 【网页第 2 步】广告账户表格 ─────────────────────────
+`);
+        let accountName = await q(`广告账户名称（默认与公司名相同，≤22 字符） [${company}]：`);
+        if (!accountName)
+            accountName = company;
+        console.log("\n币种（网页下拉；HKD 对代理商场景禁用，向导不提供）");
+        const curAns = await q("输入 1=USD（默认） 2=CNY ：");
+        const currency = curAns === "2" ? "CNY" : "USD";
+        let timezone = defaultGoogleTimezoneForCurrency(currency);
+        console.log(`\n默认时区（与网页选币种后自动联动）：${timezone}`);
+        const tzAns = await q("回车确认，或粘贴 IANA 时区 Code，或输入 list 拉取完整列表：");
+        if (tzAns.toLowerCase() === "list") {
+            const config = loadConfig(opts.token);
+            const rows = await fetchGoogleTimezoneRows(config, opts.verbose);
+            const head = ["#".padStart(4), "Code".padEnd(34), "展示"].join("  ");
+            console.log("\n  " + head + "\n  " + "-".repeat(Math.min(100, head.length + 20)));
+            rows.slice(0, 60).forEach((r, i) => {
+                const label = `(${r.Time ?? ""})${r.Name ?? ""}`.slice(0, 52);
+                console.log("  " + [String(i + 1).padStart(4), String(r.Code ?? "").padEnd(34), label].join("  "));
+            });
+            if (rows.length > 60)
+                console.log(`  … 共 ${rows.length} 条，也可用：siluzan-tso open-account google-timezones --keyword Tokyo\n`);
+            const pick = await q("\n输入序号（1-60）或直接粘贴 Code：");
+            const n = parseInt(pick, 10);
+            if (!Number.isNaN(n) && n >= 1 && n <= Math.min(60, rows.length)) {
+                timezone = String(rows[n - 1]?.Code ?? timezone);
+            }
+            else if (pick) {
+                timezone = pick;
+            }
+        }
+        else if (tzAns) {
+            timezone = tzAns;
+        }
+        const countsStr = await q("\n开户数量 1～3（网页「一个 URL 最多开几个账户」）[1]：");
+        const counts = Math.min(Math.max(parseInt(countsStr || "1", 10) || 1, 1), 3);
+        const inviteEmail = await q("\n开户邀请邮箱（须 .com 结尾，建议 Gmail）：");
+        if (!inviteEmail.endsWith(".com")) {
+            console.error("\n❌ 网页要求邀请邮箱为 .com 结尾，请重新运行向导。\n");
+            process.exit(1);
+        }
+        console.log(`
+──────────────────────── 确认提交 ─────────────────────────
+  公司名：       ${company}
+  推广链接：     ${promotionLink}
+  推广类型：     ${promotionType}
+  账户名称：     ${accountName}
+  币种 / 时区：  ${currency} / ${timezone}
+  开户数量：     ${counts}
+  邀请邮箱：     ${inviteEmail}
+──────────────────────────────────────────────────────────`);
+        const ok = await q("\n确认提交？(y/N)：");
+        if (ok.toLowerCase() !== "y" && ok.toLowerCase() !== "yes") {
+            console.log("\n已取消。\n");
+            return;
+        }
+        await runOpenAccountGoogle({
+            token: opts.token,
+            company,
+            promotionLink,
+            promotionType,
+            accountName,
+            currency,
+            timezone,
+            counts,
+            inviteEmail,
+            verbose: opts.verbose,
+        });
+        console.log("\n后续：在网页查看顶部进度 ③④⑤，或使用：\n" +
+            "  siluzan-tso account-history -m Google\n");
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * 提交 Google 开户申请（无需图片，无 OAuth 跳转）。
+ * POST /command/media-account/google
+ * Header: s-command-type: AddExistingMediaAccountList
+ *
+ * 未传 advertiserId 时，会先 PUT 创建/更新广告主组（与网页一致），再提交开户。
+ * customer_info.industry 格式为 "level1-level2"；不传行业时多为 "-" 或空串，与网页当前行为对齐。
+ */
+export async function runOpenAccountGoogle(opts) {
+    const config = loadConfig(opts.token);
+    const counts = Math.min(Math.max(opts.counts ?? 1, 1), 3);
+    const magKey = await resolveGoogleMediaAccountGroupId(config, {
+        advertiserId: opts.advertiserId,
+        company: opts.company,
+        promotionLink: opts.promotionLink,
+        promotionType: opts.promotionType,
+        industryLevel1: opts.industryLevel1,
+        industryLevel2: opts.industryLevel2,
+        verbose: opts.verbose,
+    });
+    const level1 = (opts.industryLevel1 ?? "").trim();
+    const level2 = (opts.industryLevel2 ?? "").trim();
+    const industryStr = level1 || level2 ? `${level1}-${level2}` : "";
+    const promotionLinkNorm = normalizePromotionLinkForGoogle(opts.promotionLink);
+    const body = {
+        accountInfo: Array.from({ length: counts }, () => ({
+            advertiser_info: {
+                name: opts.accountName,
+                currency: opts.currency,
+                timezone: opts.timezone,
+                accounttype: "Adwords",
+                inviteduseremail: opts.inviteEmail,
+                inviteduserrole: opts.inviteRole ?? "Standard",
+            },
+            customer_info: {
+                company: opts.company.trim(),
+                industry: industryStr,
+            },
+            qualification_info: {
+                promotion_link: promotionLinkNorm,
+                promotion_type: opts.promotionType,
+            },
+            auto_allot_mailbox: opts.autoAllotMailbox ?? false,
+            counts: 1,
+        })),
+        MediaAccountGroupId: magKey,
+        IsSaltAdd: false,
+        ManagerCustomerId: opts.managerCustomerId ?? "",
+    };
+    try {
+        await apiFetch(`${config.apiBaseUrl}/command/media-account/google`, config, {
+            method: "POST",
+            body: JSON.stringify(body),
+            headers: { "s-command-type": "AddExistingMediaAccountList" },
+        }, opts.verbose);
+        console.log(`\n✅ Google 开户申请已提交（共 ${counts} 个），邀请邮件将发送到 ${opts.inviteEmail}。\n请在「开户记录」页面查看审核状态。\n`);
+    }
+    catch (err) {
+        console.error(`\n❌ 提交失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * 将营业执照图片上传到 TikTok 平台，获取 license_image_id。
+ * POST /command/media-account/tiktok/Upload
+ * Body: { MediaType, fileBase64, fileName, businessCentreType }
+ */
+async function uploadLicenseToTikTok(filePath, businessCentreType, config, verbose) {
+    const fileName = path.basename(filePath);
+    const fileBuffer = fs.readFileSync(filePath);
+    const base64Image = fileBuffer.toString("base64");
+    const res = await apiFetch(`${config.apiBaseUrl}/command/media-account/tiktok/Upload`, config, {
+        method: "POST",
+        body: JSON.stringify({
+            MediaType: "Tiktok",
+            fileBase64: base64Image,
+            fileName,
+            businessCentreType,
+        }),
+    }, verbose);
+    const imageId = res?.data?.image_id;
+    if (!imageId) {
+        throw new Error("TikTok 图片上传失败：响应中未包含 image_id");
+    }
+    return imageId;
+}
+/**
+ * 查询该营业执照是否需要法人银联验证信息。
+ * GET /query/media-account/tiktok/... (CheckUnionpayInfo)
+ */
+async function checkUnionpayRequired(licenseNo, company, businessCentreType, config, verbose) {
+    try {
+        const params = new URLSearchParams({
+            license_no: licenseNo,
+            company_name: company,
+            businessCentreType,
+        });
+        // TikTok 相关接口走 tiktokApiUrl（前端从 config 里取），
+        // 但该接口也在 tso-api 下（和其他 tiktok 接口一样）
+        const res = await apiFetch(`${config.apiBaseUrl}/query/media-account/tiktok/TikTokAdvQuery/CheckUnionpayInfo?${params}`, config, {}, verbose);
+        return res?.data?.unionpay_verification_required === true;
+    }
+    catch {
+        // 查询失败时保守处理：不传法人信息
+        return false;
+    }
+}
+/**
+ * 提交 TikTok 开户申请。
+ * 流程：
+ * 1. 上传营业执照到 TikTok → 获取 license_image_id
+ * 2. 上传营业执照到 Siluzan 附件系统 → 获取 imageId（存档 + MAG 用）
+ * 3. 按公司名自动创建/匹配广告主组（与网页 openAnAccount.vue 第一步一致）
+ * 4. 查询是否需要法人银联验证信息
+ * 5. POST /command/media-account（Header: s-command-type: AddExistingMediaAccountList）
+ */
+export async function runOpenAccountTikTok(opts) {
+    const config = loadConfig(opts.token);
+    const bcType = opts.businessCentreType ?? "Shop";
+    if (!fs.existsSync(opts.licenseFile)) {
+        console.error(`\n❌ 营业执照文件不存在：${opts.licenseFile}\n`);
+        process.exit(1);
+    }
+    // 步骤 1：上传到 TikTok 平台
+    console.log("  [1/4] 正在上传营业执照到 TikTok...");
+    let licenseImageId;
+    try {
+        licenseImageId = await uploadLicenseToTikTok(opts.licenseFile, bcType, config, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 上传到 TikTok 失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log(`  TikTok license_image_id: ${licenseImageId}`);
+    // 步骤 2：上传到 Siluzan 附件系统（存档 + 广告主组用）
+    console.log("  [2/4] 正在上传营业执照到 Siluzan 存档...");
+    let siluzanImageId = "";
+    try {
+        const uploaded = await uploadAttachment(opts.licenseFile, config.apiBaseUrl, config, opts.verbose);
+        siluzanImageId = uploaded.id;
+        console.log(`  Siluzan imageId: ${siluzanImageId}`);
+    }
+    catch (err) {
+        // 存档上传失败不阻断流程，给出警告即可
+        console.warn(`  ⚠️  Siluzan 存档上传失败（不影响开户）：${err instanceof Error ? err.message : String(err)}`);
+    }
+    // 步骤 3：按公司名自动创建/匹配广告主组
+    console.log("  [3/4] 正在关联广告主组...");
+    const magKey = await resolveGenericMagKey(config, opts.company, {
+        ImageId: siluzanImageId,
+        BusinessLicenseId: opts.licenseNo,
+        businessCentreType: bcType,
+        advertiserContactMail: "",
+        RegisteredArea: opts.registeredArea,
+        StorageProvider: "StorageAccount",
+        ManagerCustomers: [],
+    }, opts.verbose, opts.advertiserId);
+    // 步骤 4：检查是否需要法人银联验证
+    console.log("  [4/4] 正在检查法人验证要求...");
+    const needUnionpay = await checkUnionpayRequired(opts.licenseNo, opts.company, bcType, config, opts.verbose);
+    if (needUnionpay && (!opts.representativeName || !opts.representativeId)) {
+        console.error("\n❌ 该营业执照需要填写法人银联验证信息，请追加以下参数再重试：\n" +
+            "   --representative-name <法人姓名>\n" +
+            "   --representative-id   <身份证号>\n" +
+            "   --unionpay-account    <银联账号>\n" +
+            "   --representative-phone <手机号>\n");
+        process.exit(1);
+    }
+    const counts = Math.min(Math.max(opts.counts ?? 1, 1), 10);
+    // 构造单条账户信息
+    const singleAccountInfo = {
+        advertiser_info: {
+            name: opts.accountName,
+            currency: opts.currency,
+            timezone: opts.timezone,
+        },
+        customer_info: {
+            company: opts.company,
+            industry: opts.industryId,
+            registered_area: opts.registeredArea,
+        },
+        qualification_info: {
+            promotion_link: opts.promotionLink,
+            license_no: opts.licenseNo,
+            license_image_id: licenseImageId,
+        },
+    };
+    if (needUnionpay && opts.representativeName) {
+        singleAccountInfo.representative_info = {
+            representative_name: opts.representativeName,
+            representative_id: opts.representativeId ?? "",
+            unionpay_account: opts.unionpayAccount ?? "",
+            representative_phone_number: opts.representativePhone ?? "",
+        };
+    }
+    const body = {
+        accountInfo: Array.from({ length: counts }, () => ({ ...singleAccountInfo })),
+        MediaAccountGroupId: magKey,
+        IsSaltAdd: false,
+        ManagerCustomerId: "",
+        PartnerId: opts.partnerId ?? "",
+    };
+    try {
+        await apiFetch(`${config.apiBaseUrl}/command/media-account`, config, {
+            method: "POST",
+            body: JSON.stringify(body),
+            headers: { "s-command-type": "AddExistingMediaAccountList" },
+        }, opts.verbose);
+        console.log(`\n✅ TikTok 开户申请已提交（共 ${counts} 个）。\n请在「开户记录」页面查看审核状态。\n`);
+    }
+    catch (err) {
+        console.error(`\n❌ 提交失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * GET /query/media-account/tiktok/TikTokTimeZoneInfo/Read
+ * 与网页 openAnAccount（TikTok）时区下拉同一数据源，结构与 Google 时区接口一致。
+ */
+export async function runOpenAccountTikTokTimezones(opts) {
+    const config = loadConfig(opts.token);
+    let rows;
+    try {
+        const raw = await apiFetch(`${config.apiBaseUrl}/query/media-account/tiktok/TikTokTimeZoneInfo/Read`, config, {}, opts.verbose);
+        rows = Array.isArray(raw) ? raw
+            : Array.isArray(raw.data) ? raw.data
+                : [];
+    }
+    catch (err) {
+        console.error(`\n❌ 拉取 TikTok 时区列表失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    // 按 UTC offset 升序排序（与网页行为一致）
+    rows = [...rows].sort((a, b) => {
+        const ta = String(a.Time ?? "").slice(3, 6);
+        const tb = String(b.Time ?? "").slice(3, 6);
+        return ta.localeCompare(tb);
+    });
+    const kw = (opts.keyword ?? "").trim().toLowerCase();
+    if (kw) {
+        rows = rows.filter((r) => {
+            const code = String(r.Code ?? "").toLowerCase();
+            const name = String(r.Name ?? "").toLowerCase();
+            const time = String(r.Time ?? "").toLowerCase();
+            return code.includes(kw) || name.includes(kw) || time.includes(kw);
+        });
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    console.log(`\nTikTok 开户可选时区（共 ${rows.length} 条）\n`);
+    if (rows.length === 0) {
+        console.log("  无数据。\n");
+        return;
+    }
+    const codeW = Math.min(36, Math.max(10, ...rows.map((r) => String(r.Code ?? "").length)));
+    console.log("  " + ["Code（--timezone 传此值）".padEnd(codeW + 2), "UTC 偏移".padEnd(10), "名称"].join("  "));
+    console.log("  " + "-".repeat(codeW + 40));
+    for (const r of rows) {
+        const code = String(r.Code ?? "").padEnd(codeW + 2);
+        const time = String(r.Time ?? "").padEnd(10);
+        const name = String(r.Name ?? "");
+        console.log("  " + [code, time, name].join("  "));
+    }
+    console.log();
+}
+/**
+ * GET /query/media-account/tiktok/TikTokIndustryInfo/Read
+ * 返回 TikTok 行业列表，前端以两级 Cascader 展示。
+ * ID 第 5-6 位（0-indexed 4-5）为 "01" 的是一级分类，其余与同一级 2-4 位相同的是其子项。
+ * 提交开户时只传叶子节点 ID（--industry-id）。
+ */
+export async function runOpenAccountTikTokIndustries(opts) {
+    const config = loadConfig(opts.token);
+    let rows;
+    try {
+        const raw = await apiFetch(`${config.apiBaseUrl}/query/media-account/tiktok/TikTokIndustryInfo/Read`, config, {}, opts.verbose);
+        rows = Array.isArray(raw) ? raw
+            : Array.isArray(raw.data) ? raw.data
+                : [];
+    }
+    catch (err) {
+        console.error(`\n❌ 拉取 TikTok 行业列表失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const kw = (opts.keyword ?? "").trim().toLowerCase();
+    if (kw) {
+        rows = rows.filter((r) => String(r.IndustryName ?? "").toLowerCase().includes(kw));
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    // 按 ID 区分一级/二级并缩进展示
+    console.log(`\nTikTok 行业列表（共 ${rows.length} 条，--industry-id 传叶子节点 ID）\n`);
+    if (rows.length === 0) {
+        console.log("  无数据。\n");
+        return;
+    }
+    for (const r of rows) {
+        const id = String(r.IndustryId ?? "");
+        const name = String(r.IndustryName ?? "");
+        // ID 第 5-6 位为 "01" 视为一级分类
+        const isTop = id.length >= 6 && id.slice(4, 6) === "01";
+        if (isTop) {
+            console.log(`  ▸ ${name}  (${id})`);
+        }
+        else {
+            console.log(`      ${name}  (${id})`);
+        }
+    }
+    console.log();
+}
+/**
+ * GET /query/media-account/bing/BingTradeList/Read
+ * 返回 BingV2 行业列表（中文名），name 字段即为 --trade-id 的传入值。
+ */
+export async function runOpenAccountBingIndustries(opts) {
+    const config = loadConfig(opts.token);
+    let list;
+    try {
+        const raw = await apiFetch(`${config.apiBaseUrl}/query/media-account/bing/BingTradeList/Read`, config, {}, opts.verbose);
+        // 响应可能是 { value: [...] } 或直接是数组
+        list = Array.isArray(raw) ? raw : (raw.value ?? []);
+    }
+    catch (err) {
+        console.error(`\n❌ 拉取 Bing 行业列表失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const kw = (opts.keyword ?? "").trim().toLowerCase();
+    if (kw) {
+        list = list.filter((r) => r.name.toLowerCase().includes(kw));
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(list, null, 2));
+        return;
+    }
+    console.log(`\nBingV2 行业列表（共 ${list.length} 条，将 name 值传给 --trade-id）\n`);
+    if (list.length === 0) {
+        console.log("  无数据。\n");
+        return;
+    }
+    for (const r of list) {
+        console.log(`  ${r.name}`);
+    }
+    console.log();
+}
+/**
+ * GET /query/media-account/tiktok/TikTokAreacode/Read
+ * 返回 TikTok 注册地（--registered-area）的合法值列表。
+ * Key 为提交值（如 "CN"），Value 为显示名。
+ */
+export async function runOpenAccountTikTokAreas(opts) {
+    const config = loadConfig(opts.token);
+    let rows;
+    try {
+        const raw = await apiFetch(`${config.apiBaseUrl}/query/media-account/tiktok/TikTokAreacode/Read`, config, {}, opts.verbose);
+        rows = Array.isArray(raw) ? raw
+            : Array.isArray(raw.data) ? raw.data
+                : [];
+    }
+    catch (err) {
+        console.error(`\n❌ 拉取 TikTok 注册地列表失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const kw = (opts.keyword ?? "").trim().toLowerCase();
+    if (kw) {
+        rows = rows.filter((r) => String(r.Key ?? "").toLowerCase().includes(kw) ||
+            String(r.Value ?? "").toLowerCase().includes(kw));
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(rows, null, 2));
+        return;
+    }
+    console.log(`\nTikTok 注册地列表（共 ${rows.length} 条，--registered-area 传 Key 值）\n`);
+    if (rows.length === 0) {
+        console.log("  无数据。\n");
+        return;
+    }
+    console.log("  " + "Key（--registered-area 传此值）".padEnd(10) + "  " + "名称");
+    console.log("  " + "-".repeat(40));
+    for (const r of rows) {
+        console.log("  " + String(r.Key ?? "").padEnd(10) + "  " + String(r.Value ?? ""));
+    }
+    console.log();
+}