siluzan-tso-cli 1.0.0-beta.4

package/dist/commands/account-history.d.ts

@@ -0,0 +1,13 @@
+export interface AccountHistoryOptions {
+    token?: string;
+    media?: string;
+    status?: string;
+    keyword?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    pageSize?: number;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runAccountHistory(opts: AccountHistoryOptions): Promise<void>;

package/dist/commands/account-history.js

@@ -0,0 +1,87 @@
+import { loadConfig, apiFetch } from "../utils/auth.js";
+const VALID_MEDIA_TYPES = ["Google", "TikTok", "Yandex", "MetaAd", "BingV2", "Kwai"];
+export async function runAccountHistory(opts) {
+    const config = loadConfig(opts.token);
+    if (opts.media && !VALID_MEDIA_TYPES.includes(opts.media)) {
+        console.error(`\n❌ 不支持的媒体类型：${opts.media}\n   可选：${VALID_MEDIA_TYPES.join(" | ")}\n`);
+        process.exit(1);
+    }
+    const params = new URLSearchParams();
+    if (opts.media)
+        params.set("MediaType", opts.media);
+    if (opts.keyword)
+        params.set("keyword", opts.keyword);
+    if (opts.startDate)
+        params.set("startDate", opts.startDate);
+    if (opts.endDate)
+        params.set("endDate", opts.endDate);
+    params.set("pageIndex", String((opts.page ?? 1) - 1));
+    params.set("pageSize", String(opts.pageSize ?? 20));
+    // 开户历史复用账户列表接口，通过 mediaAccountState 筛选历史状态
+    // Google 包含 Inactive，其他媒体不含
+    const historyStates = !opts.media || opts.media === "Google"
+        ? "Created,Approved,Denied,Inactive"
+        : "Created,Approved,Denied";
+    // 若调用方传了 status 参数则优先使用（向后兼容）
+    params.set("mediaAccountState", opts.status ?? historyStates);
+    const url = `${config.apiBaseUrl}/query/media-account/?${params}`;
+    // 接口直接返回 MediaAccountItem[] 数组，与 list-accounts 结构一致
+    let items;
+    try {
+        items = await apiFetch(url, 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(items, null, 2));
+        return;
+    }
+    if (items.length === 0) {
+        console.log("\n暂无开户申请记录。\n");
+        return;
+    }
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 20;
+    console.log(`\n开户申请历史（第 ${page} 页，本页 ${items.length} 条）\n`);
+    // 从 ma / mag 提取展示字段
+    const rows = items.map((item) => ({
+        mediaType: item.ma.mediaAccountType ?? "",
+        mediaCustomerId: item.ma.mediaCustomerId ?? "(未开通)",
+        advertiserName: item.mag?.advertiserName ?? "",
+        status: item.ma.mediaAccountState ?? "",
+        createdAt: item.ma.createdDateTime
+            ? item.ma.createdDateTime.slice(0, 10)
+            : "",
+    }));
+    const colW = {
+        media: Math.max(8, ...rows.map((r) => r.mediaType.length)),
+        id: Math.max(10, ...rows.map((r) => r.mediaCustomerId.length)),
+        company: Math.max(8, ...rows.map((r) => r.advertiserName.length)),
+        status: Math.max(6, ...rows.map((r) => r.status.length)),
+    };
+    const header = [
+        "媒体类型".padEnd(colW.media),
+        "账户ID".padEnd(colW.id),
+        "广告主".padEnd(colW.company),
+        "状态".padEnd(colW.status),
+        "创建日期",
+    ].join("  ");
+    console.log("  " + header);
+    console.log("  " + "-".repeat(header.length));
+    for (const row of rows) {
+        const line = [
+            row.mediaType.padEnd(colW.media),
+            row.mediaCustomerId.padEnd(colW.id),
+            row.advertiserName.padEnd(colW.company),
+            row.status.padEnd(colW.status),
+            row.createdAt,
+        ].join("  ");
+        console.log("  " + line);
+    }
+    if (items.length >= pageSize) {
+        console.log(`\n  使用 --page <n> 翻页，--page-size <n> 调整每页数量。`);
+    }
+    console.log();
+}

package/dist/commands/account-manage.d.ts

@@ -0,0 +1,71 @@
+export interface AccountDelinkOptions {
+    token?: string;
+    /** 单个账户 entityId */
+    id?: string;
+    /** 批量账户 entityId（逗号分隔） */
+    ids?: string[];
+    verbose?: boolean;
+}
+/**
+ * 断开广告账户与当前账号的关联关系。
+ * 单个：PUT /command/media-account/{entityId}/delink
+ * 批量：POST /command/media-account/delinkList
+ */
+export declare function runAccountDelink(opts: AccountDelinkOptions): Promise<void>;
+export interface AccountShareOptions {
+    token?: string;
+    /** 要分享的账户 entityId（来自 list-accounts 的 ma.entityId 字段） */
+    id: string;
+    /** 被分享人的丝路赞注册手机号 */
+    phone: string;
+    verbose?: boolean;
+}
+/**
+ * 将 Google 广告账户分享给指定手机号的丝路赞用户。
+ *
+ * 流程：
+ * 1. GET mainApiUrl/query/account/SimpleAccountInfo?phone=xxx → 获取被分享人 accountId
+ * 2. POST /command/media-account/TSOMediaAccountShared/{entityId} { AccountId: userId }
+ */
+export declare function runAccountShare(opts: AccountShareOptions): Promise<void>;
+export interface AccountUnshareOptions {
+    token?: string;
+    /** 被分享的账户 entityId */
+    id: string;
+    /** 被分享人的账号 ID（通过 list-accounts → accountIds 或分享详情页获取） */
+    accountId: string;
+    verbose?: boolean;
+}
+/**
+ * 取消 Google 广告账户的分享。
+ * POST /command/media-account/TSOMediaAccountSharedRemove/{entityId}
+ * Body: { AccountId: "<被分享人的 accountId>" }
+ */
+export declare function runAccountUnshare(opts: AccountUnshareOptions): Promise<void>;
+export interface AccountShareDetailOptions {
+    token?: string;
+    /** 账户的 mediaCustomerId（来自 list-accounts） */
+    mediaCustomerId: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+/**
+ * 查询指定账户的分享详情（被分享给哪些用户）。
+ * GET mainApiUrl/query/account/GetAccountsByMediaAcountId?mediaAcountId=xxx
+ */
+export declare function runAccountShareDetail(opts: AccountShareDetailOptions): Promise<void>;
+export interface AccountAuthOptions {
+    token?: string;
+    /** Google | TikTok | Meta | Yandex | BingV2 | Kwai */
+    media: string;
+    verbose?: boolean;
+}
+/**
+ * 发起媒体账户 OAuth 授权。
+ *
+ * 流程：
+ * 1. 调 GET /command/media-account/link/{mediaType}?returnUrl=... 获取 redirectUrl
+ * 2. 用系统浏览器打开 redirectUrl（fallback 输出链接让用户手动粘贴）
+ * 3. 用户在浏览器完成授权后会跳回丝路赞回调页面，自动完成账户绑定
+ */
+export declare function runAccountAuth(opts: AccountAuthOptions): Promise<void>;

package/dist/commands/account-manage.js

@@ -0,0 +1,217 @@
+import { execSync } from "node:child_process";
+import { loadConfig, apiFetch } from "../utils/auth.js";
+import { deriveWebUrl } from "./config.js";
+/**
+ * 断开广告账户与当前账号的关联关系。
+ * 单个：PUT /command/media-account/{entityId}/delink
+ * 批量：POST /command/media-account/delinkList
+ */
+export async function runAccountDelink(opts) {
+    if (!opts.id && (!opts.ids || opts.ids.length === 0)) {
+        console.error("\n❌ 请通过 --id 或 --ids 提供要断开关联的账户 entityId\n");
+        process.exit(1);
+    }
+    const config = loadConfig(opts.token);
+    // S-Command-Type 是前端固定传的操作类型头
+    const delinkHeader = { "S-Command-Type": "delinkMediaAccount" };
+    if (opts.ids && opts.ids.length > 1) {
+        // 批量断开
+        const url = `${config.apiBaseUrl}/command/media-account/delinkList`;
+        try {
+            await apiFetch(url, config, {
+                method: "POST",
+                body: JSON.stringify(opts.ids),
+                headers: delinkHeader,
+            }, opts.verbose);
+        }
+        catch (err) {
+            console.error(`\n❌ 批量断开关联失败：${err instanceof Error ? err.message : String(err)}\n`);
+            process.exit(1);
+        }
+        console.log(`\n✅ 已批量断开 ${opts.ids.length} 个账户的关联关系\n`);
+    }
+    else {
+        // 单个断开
+        const entityId = opts.id ?? opts.ids[0];
+        const url = `${config.apiBaseUrl}/command/media-account/${entityId}/delink`;
+        try {
+            await apiFetch(url, config, { method: "PUT", body: "{}", headers: delinkHeader }, opts.verbose);
+        }
+        catch (err) {
+            console.error(`\n❌ 断开关联失败：${err instanceof Error ? err.message : String(err)}\n`);
+            process.exit(1);
+        }
+        console.log(`\n✅ 账户 ${entityId} 已断开关联\n`);
+    }
+}
+/**
+ * 将 Google 广告账户分享给指定手机号的丝路赞用户。
+ *
+ * 流程：
+ * 1. GET mainApiUrl/query/account/SimpleAccountInfo?phone=xxx → 获取被分享人 accountId
+ * 2. POST /command/media-account/TSOMediaAccountShared/{entityId} { AccountId: userId }
+ */
+export async function runAccountShare(opts) {
+    const config = loadConfig(opts.token);
+    if (!config.mainApiUrl) {
+        console.error("\n❌ 无法推导主 API 地址，请检查 apiBaseUrl 配置\n");
+        process.exit(1);
+    }
+    // 第一步：用手机号查询目标用户 ID
+    let userId;
+    try {
+        const lookupUrl = `${config.mainApiUrl}/query/account/SimpleAccountInfo?phone=${encodeURIComponent(opts.phone)}`;
+        const users = await apiFetch(lookupUrl, config, {}, opts.verbose);
+        if (!Array.isArray(users) || users.length === 0) {
+            console.error(`\n❌ 未找到手机号 ${opts.phone} 对应的丝路赞账号，请确认该用户已完成注册\n`);
+            process.exit(1);
+        }
+        userId = users[0].id;
+    }
+    catch (err) {
+        console.error(`\n❌ 查询用户信息失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    // 第二步：执行分享
+    const shareUrl = `${config.apiBaseUrl}/command/media-account/TSOMediaAccountShared/${opts.id}`;
+    try {
+        await apiFetch(shareUrl, config, { method: "POST", body: JSON.stringify({ AccountId: userId }) }, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 分享失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log(`\n✅ 账户已成功分享给手机号 ${opts.phone} 的用户（AccountId: ${userId}）\n`);
+}
+/**
+ * 取消 Google 广告账户的分享。
+ * POST /command/media-account/TSOMediaAccountSharedRemove/{entityId}
+ * Body: { AccountId: "<被分享人的 accountId>" }
+ */
+export async function runAccountUnshare(opts) {
+    const config = loadConfig(opts.token);
+    const url = `${config.apiBaseUrl}/command/media-account/TSOMediaAccountSharedRemove/${opts.id}`;
+    try {
+        await apiFetch(url, config, { method: "POST", body: JSON.stringify({ AccountId: opts.accountId }) }, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 取消分享失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log(`\n✅ 已取消账户 ${opts.id} 对用户 ${opts.accountId} 的分享\n`);
+}
+/**
+ * 查询指定账户的分享详情（被分享给哪些用户）。
+ * GET mainApiUrl/query/account/GetAccountsByMediaAcountId?mediaAcountId=xxx
+ */
+export async function runAccountShareDetail(opts) {
+    const config = loadConfig(opts.token);
+    if (!config.mainApiUrl) {
+        console.error("\n❌ 无法推导主 API 地址，请检查 apiBaseUrl 配置\n");
+        process.exit(1);
+    }
+    const url = `${config.mainApiUrl}/query/account/GetAccountsByMediaAcountId?mediaAcountId=${encodeURIComponent(opts.mediaCustomerId)}`;
+    let data;
+    try {
+        data = await apiFetch(url, 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, null, 2));
+        return;
+    }
+    const users = Array.isArray(data) ? data : [];
+    console.log(`\n账户 ${opts.mediaCustomerId} 的分享详情（共 ${users.length} 人）\n`);
+    if (users.length === 0) {
+        console.log("  暂未分享给任何用户。\n");
+        return;
+    }
+    const header = [
+        "账号 ID".padEnd(36),
+        "姓名".padEnd(16),
+        "手机号".padEnd(14),
+        "邮箱",
+    ].join("  ");
+    console.log("  " + header);
+    console.log("  " + "-".repeat(header.length));
+    for (const u of users) {
+        console.log("  " + [
+            (u.id ?? u.entityId ?? "").padEnd(36),
+            (u.name ?? "").padEnd(16),
+            (u.phone ?? "").padEnd(14),
+            u.email ?? "",
+        ].join("  "));
+    }
+    console.log();
+}
+/**
+ * Meta 在 API 调用中使用 "FacebookAds"（与其他媒体的枚举值不同）。
+ */
+function toApiMediaType(media) {
+    return media === "Meta" ? "FacebookAds" : media;
+}
+/**
+ * 用系统默认浏览器打开 URL，跨平台（Windows/macOS/Linux）。
+ * 失败时静默，让调用方回退到打印 URL。
+ */
+function tryOpenBrowser(url) {
+    try {
+        if (process.platform === "win32") {
+            // Windows：start 命令需要加空字符串作为窗口标题占位
+            execSync(`start "" "${url}"`, { stdio: "ignore" });
+        }
+        else if (process.platform === "darwin") {
+            execSync(`open "${url}"`, { stdio: "ignore" });
+        }
+        else {
+            execSync(`xdg-open "${url}"`, { stdio: "ignore" });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 发起媒体账户 OAuth 授权。
+ *
+ * 流程：
+ * 1. 调 GET /command/media-account/link/{mediaType}?returnUrl=... 获取 redirectUrl
+ * 2. 用系统浏览器打开 redirectUrl（fallback 输出链接让用户手动粘贴）
+ * 3. 用户在浏览器完成授权后会跳回丝路赞回调页面，自动完成账户绑定
+ */
+export async function runAccountAuth(opts) {
+    const config = loadConfig(opts.token);
+    const apiMediaType = toApiMediaType(opts.media);
+    const webUrl = deriveWebUrl(config.apiBaseUrl);
+    // returnUrl 与前端生产环境保持一致：{webUrl}/v3/foreign_trade/tso/{mediaType}/accountsAuthorizationBind
+    const returnPath = encodeURIComponent(`${webUrl}/v3/foreign_trade/tso/${apiMediaType}/accountsAuthorizationBind`);
+    const linkUrl = `${config.apiBaseUrl}/command/media-account/link/${apiMediaType}?returnUrl=${returnPath}`;
+    console.log(`\n正在获取 ${opts.media} 授权链接…\n`);
+    let redirectUrl;
+    try {
+        const res = await apiFetch(linkUrl, config, {}, opts.verbose);
+        if (!res.redirectUrl) {
+            console.error("\n❌ 接口未返回 redirectUrl，该媒体类型可能暂不支持授权。\n");
+            process.exit(1);
+        }
+        redirectUrl = res.redirectUrl;
+    }
+    catch (err) {
+        console.error(`\n❌ 获取授权链接失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    const opened = tryOpenBrowser(redirectUrl);
+    if (opened) {
+        console.log(`✅ 已在默认浏览器中打开 ${opts.media} 授权页面。`);
+        console.log(`   完成授权后浏览器会自动跳回丝路赞，账户绑定即生效。\n`);
+    }
+    else {
+        console.log(`⚠️  无法自动打开浏览器，请手动复制以下链接到浏览器中完成授权：\n`);
+    }
+    // 无论是否自动打开，都打印链接方便用户参考
+    console.log(`  ${redirectUrl}\n`);
+}

package/dist/commands/ad.d.ts

@@ -0,0 +1,161 @@
+export interface AdCampaignsOptions {
+    token?: string;
+    account: string;
+    startDate?: string;
+    endDate?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runAdCampaigns(opts: AdCampaignsOptions): Promise<void>;
+export interface AdGroupsOptions {
+    token?: string;
+    account: string;
+    startDate?: string;
+    endDate?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runAdGroups(opts: AdGroupsOptions): Promise<void>;
+export interface AdListOptions {
+    token?: string;
+    account: string;
+    startDate?: string;
+    endDate?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runAdList(opts: AdListOptions): Promise<void>;
+export interface AdKeywordsOptions {
+    token?: string;
+    account: string;
+    negative?: boolean;
+    startDate?: string;
+    endDate?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runAdKeywords(opts: AdKeywordsOptions): Promise<void>;
+export interface AdCampaignStatusOptions {
+    token?: string;
+    account: string;
+    id: string;
+    status: "Enabled" | "Paused";
+    verbose?: boolean;
+}
+export declare function runAdCampaignStatus(opts: AdCampaignStatusOptions): Promise<void>;
+export interface AdCampaignDeleteOptions {
+    token?: string;
+    account: string;
+    id: string;
+    verbose?: boolean;
+}
+export declare function runAdCampaignDelete(opts: AdCampaignDeleteOptions): Promise<void>;
+export interface AdGroupsVerboseOptions {
+    token?: string;
+    account: string;
+    startDate?: string;
+    endDate?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export interface AdGroupCreateOptions {
+    token?: string;
+    account: string;
+    campaignId: string;
+    campaignName: string;
+    name: string;
+    /** 最高 CPC，单位：分（最小货币单位），前端乘以 100 后发送 */
+    maxCpc: number;
+    status?: "ENABLED" | "PAUSED";
+    verbose?: boolean;
+}
+export declare function runAdGroupCreate(opts: AdGroupCreateOptions): Promise<void>;
+export interface AdGroupStatusOptions {
+    token?: string;
+    account: string;
+    id: string;
+    status: "Enabled" | "Paused";
+    startDate?: string;
+    endDate?: string;
+    verbose?: boolean;
+}
+export declare function runAdGroupStatus(opts: AdGroupStatusOptions): Promise<void>;
+export interface AdGroupDeleteOptions {
+    token?: string;
+    account: string;
+    id: string;
+    startDate?: string;
+    endDate?: string;
+    verbose?: boolean;
+}
+export declare function runAdGroupDelete(opts: AdGroupDeleteOptions): Promise<void>;
+export interface AdCreateOptions {
+    token?: string;
+    account: string;
+    adgroupId: string;
+    adgroupName: string;
+    campaignId?: string;
+    campaignName?: string;
+    finalUrl: string;
+    /** 至少 3 个标题，逗号分隔 */
+    headlines: string[];
+    /** 至少 2 个描述，逗号分隔 */
+    descriptions: string[];
+    path1?: string;
+    path2?: string;
+    verbose?: boolean;
+}
+export declare function runAdCreate(opts: AdCreateOptions): Promise<void>;
+export interface AdStatusOptions {
+    token?: string;
+    account: string;
+    id: string;
+    status: "Enabled" | "Paused";
+    startDate?: string;
+    endDate?: string;
+    verbose?: boolean;
+}
+export declare function runAdStatus(opts: AdStatusOptions): Promise<void>;
+export interface AdDeleteOptions {
+    token?: string;
+    account: string;
+    id: string;
+    startDate?: string;
+    endDate?: string;
+    verbose?: boolean;
+}
+export declare function runAdDelete(opts: AdDeleteOptions): Promise<void>;
+export interface AdKeywordCreateOptions {
+    token?: string;
+    account: string;
+    adgroupId: string;
+    adgroupName: string;
+    campaignId: string;
+    campaignName: string;
+    /** 关键词列表，逗号分隔 */
+    keywords: string[];
+    finalUrl?: string;
+    verbose?: boolean;
+}
+export declare function runAdKeywordCreate(opts: AdKeywordCreateOptions): Promise<void>;
+export interface AdNegativeKeywordCreateOptions {
+    token?: string;
+    account: string;
+    campaignId: string;
+    campaignName: string;
+    adgroupId?: string;
+    adgroupName?: string;
+    /** 关键词列表，逗号分隔 */
+    keywords: string[];
+    verbose?: boolean;
+}
+export declare function runAdNegativeKeywordCreate(opts: AdNegativeKeywordCreateOptions): Promise<void>;
+export interface AdNegativeKeywordDeleteOptions {
+    token?: string;
+    account: string;
+    id: string;
+    startDate?: string;
+    endDate?: string;
+    verbose?: boolean;
+}
+export declare function runAdNegativeKeywordDelete(opts: AdNegativeKeywordDeleteOptions): Promise<void>;