siluzan-tso-cli 1.0.0-beta.4

package/dist/commands/forewarning.js

@@ -0,0 +1,239 @@
+import { loadConfig, apiFetch } from "../utils/auth.js";
+const VALID_MEDIA_TYPES = ["Google", "TikTok"];
+export async function runForewarningList(opts) {
+    if (!VALID_MEDIA_TYPES.includes(opts.media)) {
+        console.error(`\n❌ 不支持的媒体类型：${opts.media}\n   可选：${VALID_MEDIA_TYPES.join(" | ")}\n`);
+        process.exit(1);
+    }
+    const config = loadConfig(opts.token);
+    const params = new URLSearchParams();
+    // 后端使用 1-based PageIndex
+    params.set("PageIndex", String(opts.page ?? 1));
+    params.set("PageSize", String(opts.pageSize ?? 20));
+    if (opts.keyword)
+        params.set("Name", opts.keyword);
+    if (opts.account)
+        params.set("MediaAccountId", opts.account);
+    if (opts.startDate)
+        params.set("startDate", opts.startDate);
+    if (opts.endDate)
+        params.set("endDate", opts.endDate);
+    const url = `${config.apiBaseUrl}/query/smart-strategy/settings/${opts.media}?${params}`;
+    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 items = data.results ?? [];
+    const total = data.totalResultCount ?? 0;
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 20;
+    console.log(`\n智能预警规则（第 ${page}/${Math.ceil(total / pageSize)} 页，共 ${total} 条）\n`);
+    if (items.length === 0) {
+        console.log("  暂无数据。\n");
+        return;
+    }
+    const header = [
+        "名称".padEnd(30),
+        "类型".padEnd(16),
+        "已停用".padEnd(8),
+        "ID",
+    ].join("  ");
+    console.log("  " + header);
+    console.log("  " + "-".repeat(header.length));
+    for (const item of items) {
+        console.log("  " + [
+            (item.data?.name ?? "").padEnd(30),
+            (item.data?.templateType ?? "").padEnd(16),
+            (item.stopped ? "是" : "否").padEnd(8),
+            item.entityId ?? "",
+        ].join("  "));
+    }
+    console.log();
+}
+export async function runForewarningRecords(opts) {
+    if (!VALID_MEDIA_TYPES.includes(opts.media)) {
+        console.error(`\n❌ 不支持的媒体类型：${opts.media}\n`);
+        process.exit(1);
+    }
+    const config = loadConfig(opts.token);
+    // ruleId 为空时传 "all" 表示查所有规则的记录
+    const ruleId = opts.ruleId ?? "all";
+    const params = new URLSearchParams();
+    // 后端使用 1-based PageIndex
+    params.set("PageIndex", String(opts.page ?? 1));
+    params.set("PageSize", String(opts.pageSize ?? 20));
+    if (opts.status)
+        params.set("ExecResult", opts.status);
+    if (opts.account)
+        params.set("MediaAccountId", opts.account);
+    if (opts.keyword)
+        params.set("Name", opts.keyword);
+    if (opts.startDate)
+        params.set("startDate", opts.startDate);
+    if (opts.endDate)
+        params.set("endDate", opts.endDate);
+    const url = `${config.apiBaseUrl}/query/smart-strategy/settings/${opts.media}/${ruleId}/trigger-historys?${params}`;
+    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 items = data.results ?? [];
+    const total = data.totalResultCount ?? 0;
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 20;
+    console.log(`\n预警记录（第 ${page}/${Math.ceil(total / pageSize)} 页，共 ${total} 条）\n`);
+    if (items.length === 0) {
+        console.log("  暂无数据。\n");
+        return;
+    }
+    for (const item of items) {
+        const d = item.data ?? {};
+        const ruleName = d.settingData?.name ?? d.settingId ?? "—";
+        console.log(`  [${d.execResult ?? "—"}] ${ruleName}  触发时间: ${d.execTime ?? "—"}`);
+    }
+    console.log();
+}
+export async function runForewarningStart(opts) {
+    const config = loadConfig(opts.token);
+    const url = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}/${opts.id}/start`;
+    try {
+        await apiFetch(url, config, { method: "POST", body: "null" }, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 启动失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log("\n✅ 预警规则已启动\n");
+}
+export async function runForewarningStop(opts) {
+    const config = loadConfig(opts.token);
+    const url = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}/${opts.id}/stop`;
+    try {
+        await apiFetch(url, config, { method: "POST", body: "null" }, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 停止失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log("\n✅ 预警规则已停止\n");
+}
+export async function runForewarningDelete(opts) {
+    const config = loadConfig(opts.token);
+    const url = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}/${opts.id}`;
+    try {
+        await apiFetch(url, config, { method: "DELETE" }, opts.verbose);
+    }
+    catch (err) {
+        console.error(`\n❌ 删除失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log("\n✅ 预警规则已删除\n");
+}
+const WEEKDAYS = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
+/** 将 ForewarningCreateOptions 组装成接口所需的 body */
+function buildRuleBody(opts) {
+    const accountIds = opts.accounts.split(",").map((s) => s.trim()).filter(Boolean);
+    const notifyIds = opts.notify ? opts.notify.split(",").map((s) => s.trim()).filter(Boolean) : [];
+    return {
+        TemplateType: "Customization",
+        MediaType: opts.media,
+        Name: opts.name,
+        ExecScopeSetting: {
+            ScopeType: opts.scopeType ?? "Campaign",
+            MediaAccounts: accountIds,
+            MatchPattern: "Default",
+            WhiteList: [],
+            BlockedList: [],
+        },
+        ConditionSetting: {
+            MatchConditions: [
+                {
+                    Field: opts.field,
+                    ComparisonOperator: opts.operator,
+                    CompareWith: "Fixed",
+                    CompareValue: opts.value,
+                    CompareDays: opts.days ?? 1,
+                    CompareUnit: "Yuan",
+                },
+            ],
+            LogicOperator: "AND",
+        },
+        ExecActionSetting: {
+            Enabled: false,
+            ExecActions: [],
+            PeriodLimitType: "Day",
+            PeriodLimitTimes: 1,
+        },
+        ExecTimeSetting: {
+            TimeFrequency: opts.frequency ?? "QuarterHour",
+            DaysFrequency: WEEKDAYS,
+            BeginTime: "00:00",
+            EndTime: "23:59",
+            TimeZone: 8,
+        },
+        NotifySetting: {
+            NotifyBy: "MediaAccount",
+            Enabled: notifyIds.length > 0,
+            NotifyObjects: notifyIds,
+        },
+    };
+}
+/**
+ * 创建或更新预警规则。
+ * 不传 --id 时新建（POST），传 --id 时更新（PUT）。
+ */
+export async function runForewarningCreate(opts) {
+    if (!VALID_MEDIA_TYPES.includes(opts.media)) {
+        console.error(`\n❌ 不支持的媒体类型：${opts.media}\n   可选：${VALID_MEDIA_TYPES.join(" | ")}\n`);
+        process.exit(1);
+    }
+    const VALID_OPERATORS = ["GREATER_EQUALS", "GREATER", "LESS_EQUALS", "LESS", "EQUALS"];
+    if (!VALID_OPERATORS.includes(opts.operator)) {
+        console.error(`\n❌ 无效的比较运算符：${opts.operator}\n   可选：${VALID_OPERATORS.join(" | ")}\n`);
+        process.exit(1);
+    }
+    const config = loadConfig(opts.token);
+    const base = `${config.apiBaseUrl}/command/smart-strategy/settings/${opts.media}`;
+    const isUpdate = Boolean(opts.id);
+    const url = isUpdate ? `${base}/${opts.id}` : base;
+    const method = isUpdate ? "PUT" : "POST";
+    const body = buildRuleBody(opts);
+    try {
+        await apiFetch(url, config, { method, body: JSON.stringify(body) }, opts.verbose);
+    }
+    catch (err) {
+        const action = isUpdate ? "更新" : "创建";
+        console.error(`\n❌ ${action}失败：${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(1);
+    }
+    console.log(`\n✅ 预警规则已${isUpdate ? "更新" : "创建"}：${opts.name}\n`);
+}
+export async function runForewarningGet(opts) {
+    const config = loadConfig(opts.token);
+    const url = `${config.apiBaseUrl}/query/smart-strategy/settings/${opts.media}/${opts.id}`;
+    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);
+    }
+    console.log(JSON.stringify(data, null, 2));
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+/** 各平台 skill 安装目录（使用 siluzan-tso 作为目录名） */
+export type AiTarget = "cursor" | "claude" | "openclaw-workspace" | "openclaw-global" | "workbuddy-workspace" | "workbuddy-global";
+export interface InitOptions {
+    cwd: string;
+    aiTargets: string;
+    /** 自定义安装目录（绝对或相对路径），与 --ai 互斥 */
+    dir?: string;
+    force: boolean;
+}
+export declare function runInit(options: InitOptions): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,141 @@
+import * as fs from "node:fs/promises";
+import * as fsSync from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getSkillFiles } from "../templates/load-templates.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TARGET_DIRS = {
+    cursor: (cwd) => path.join(cwd, ".cursor", "skills", "siluzan-tso"),
+    claude: (cwd) => path.join(cwd, ".claude", "skills", "siluzan-tso"),
+    "openclaw-workspace": (cwd) => path.join(cwd, "skills", "siluzan-tso"),
+    "openclaw-global": (_cwd, home) => path.join(home, ".openclaw", "skills", "siluzan-tso"),
+    "workbuddy-workspace": (cwd) => path.join(cwd, ".workbuddy", "skills", "siluzan-tso"),
+    "workbuddy-global": (_cwd, home) => path.join(home, ".workbuddy", "skills", "siluzan-tso"),
+};
+function parseTargets(raw) {
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === "all") {
+        return [
+            "cursor",
+            "claude",
+            "openclaw-workspace",
+            "openclaw-global",
+            "workbuddy-workspace",
+            "workbuddy-global",
+        ];
+    }
+    const parts = normalized
+        .split(",")
+        .map((s) => s.trim())
+        .map((p) => {
+        if (p === "openclaw")
+            return "openclaw-workspace";
+        if (p === "workbuddy")
+            return "workbuddy-workspace";
+        return p;
+    });
+    const allowed = [
+        "cursor", "claude",
+        "openclaw-workspace", "openclaw-global",
+        "workbuddy-workspace", "workbuddy-global",
+    ];
+    const result = [];
+    for (const p of parts) {
+        if (!allowed.includes(p)) {
+            console.error(`未知平台: ${p}。可选: cursor, claude, openclaw-workspace, openclaw-global, workbuddy-workspace, workbuddy-global, all`);
+            process.exitCode = 1;
+            return [];
+        }
+        result.push(p);
+    }
+    return [...new Set(result)];
+}
+function assetsRoot() {
+    // dist/commands/init.js → ../../assets
+    return path.join(__dirname, "..", "..", "assets");
+}
+/** 将 skill 文件写入指定目录，返回是否有文件被写入 */
+async function writeSkillFilesToDir(destDir, skillFiles, force) {
+    await fs.mkdir(destDir, { recursive: true });
+    let anyWritten = false;
+    for (const [relativePath, content] of Object.entries(skillFiles)) {
+        const fullPath = path.join(destDir, relativePath);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        try {
+            await fs.access(fullPath);
+            if (!force) {
+                console.warn(`跳过（已存在，使用 --force 覆盖）: ${fullPath}`);
+                continue;
+            }
+        }
+        catch {
+            // 文件不存在，继续写入
+        }
+        await fs.writeFile(fullPath, content, "utf8");
+        console.log(`已写入: ${fullPath}`);
+        anyWritten = true;
+    }
+    return anyWritten;
+}
+/** 持久化安装记录到 ~/.siluzan/config.json（siluzan-tso 专用键） */
+function saveInstalledTargets(entries) {
+    const CONFIG_FILE = path.join(os.homedir(), ".siluzan", "config.json");
+    try {
+        fsSync.mkdirSync(path.dirname(CONFIG_FILE), { recursive: true });
+        let existing = {};
+        if (fsSync.existsSync(CONFIG_FILE)) {
+            existing = JSON.parse(fsSync.readFileSync(CONFIG_FILE, "utf8"));
+        }
+        // 使用独立键 tsoInstalledTargets，与 CSO 的 installedTargets 互不干扰
+        const prev = Array.isArray(existing.tsoInstalledTargets)
+            ? existing.tsoInstalledTargets
+            : [];
+        const merged = new Map();
+        for (const e of [...prev, ...entries]) {
+            merged.set(`${e.target}::${e.cwd}`, e);
+        }
+        fsSync.writeFileSync(CONFIG_FILE, JSON.stringify({ ...existing, tsoInstalledTargets: [...merged.values()] }, null, 2), "utf8");
+        if (process.platform !== "win32") {
+            fsSync.chmodSync(CONFIG_FILE, 0o600);
+        }
+    }
+    catch {
+        // 记录失败不影响安装流程
+    }
+}
+export async function runInit(options) {
+    const home = os.homedir();
+    const skillFiles = await getSkillFiles(assetsRoot());
+    const installedEntries = [];
+    if (options.dir) {
+        // 自定义目录模式
+        const destDir = path.resolve(options.cwd, options.dir);
+        console.log(`安装目标目录：${destDir}`);
+        const anyWritten = await writeSkillFilesToDir(destDir, skillFiles, options.force);
+        if (anyWritten)
+            installedEntries.push({ target: "custom", cwd: "", dir: destDir });
+    }
+    else {
+        // 预定义平台模式
+        const targets = parseTargets(options.aiTargets);
+        if (targets.length === 0)
+            return;
+        for (const target of targets) {
+            const destDir = TARGET_DIRS[target](options.cwd, home);
+            console.log(`[${target}] → ${destDir}`);
+            const anyWritten = await writeSkillFilesToDir(destDir, skillFiles, options.force);
+            if (anyWritten) {
+                const isGlobal = target === "openclaw-global" || target === "workbuddy-global";
+                installedEntries.push({ target, cwd: isGlobal ? "" : options.cwd });
+            }
+        }
+    }
+    if (installedEntries.length > 0) {
+        saveInstalledTargets(installedEntries);
+    }
+    console.log("\n下一步：");
+    console.log("1. 若还未登录，请先运行：siluzan-cso login  （siluzan-tso 与 siluzan-cso 共用同一 Token）");
+    console.log("2. OpenClaw 全局技能若未生效，请在 ~/.openclaw/openclaw.json 的 skills.load.extraDirs 中加入技能父目录。");
+    console.log("3. WorkBuddy 技能安装后重启 WorkBuddy 即可生效。");
+}

package/dist/commands/invoice.d.ts

@@ -0,0 +1,38 @@
+export interface InvoiceListOptions {
+    token?: string;
+    keyword?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    pageSize?: number;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runInvoiceList(opts: InvoiceListOptions): Promise<void>;
+export interface InvoiceBillableOptions {
+    token?: string;
+    media?: string;
+    currency?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    pageSize?: number;
+    wallet?: boolean;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runInvoiceBillable(opts: InvoiceBillableOptions): Promise<void>;
+export interface InvoiceApplyOptions {
+    token?: string;
+    /** 要开票的订单 entityId，多个逗号分隔 */
+    billIds: string[];
+    billType: string;
+    mediaType?: string;
+    /** JSON 字符串，包含发票抬头信息 */
+    invoiceInfo: string;
+    /** JSON 字符串，包含收件人信息 */
+    recipientInfo: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runInvoiceApply(opts: InvoiceApplyOptions): Promise<void>;

package/dist/commands/invoice.js

@@ -0,0 +1,187 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { loadConfig, apiFetch, fetchDataPermission } from "../utils/auth.js";
+/**
+ * 若 config 中没有 dataPermission，自动从主平台权限菜单 API 获取并缓存到 config.json。
+ * 返回附有 dataPermission 的 config 副本。
+ */
+async function ensureDataPermission(config) {
+    if (config.dataPermission)
+        return config;
+    if (!config.mainApiUrl)
+        return config;
+    const dp = await fetchDataPermission(config.mainApiUrl, config.authToken);
+    if (!dp)
+        return config;
+    // 写入 config.json 缓存，供后续调用直接使用
+    const configPath = path.join(os.homedir(), ".siluzan", "config.json");
+    try {
+        const raw = fs.existsSync(configPath)
+            ? JSON.parse(fs.readFileSync(configPath, "utf8"))
+            : {};
+        raw.dataPermission = dp;
+        fs.writeFileSync(configPath, JSON.stringify(raw, null, 2), "utf8");
+    }
+    catch {
+        // 写入失败不影响本次请求
+    }
+    return { ...config, dataPermission: dp };
+}
+/** 返回 YYYY-MM-DD 格式的日期字符串 */
+function formatDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+export async function runInvoiceList(opts) {
+    const config = await ensureDataPermission(loadConfig(opts.token));
+    // 后端 startDate/endDate 为必填，未指定时默认最近 3 个月
+    const endDate = opts.endDate ?? formatDate(new Date());
+    const startDefault = new Date();
+    startDefault.setMonth(startDefault.getMonth() - 3);
+    const startDate = opts.startDate ?? formatDate(startDefault);
+    const params = new URLSearchParams();
+    // 后端使用 1-based pageIndex
+    params.set("pageIndex", String(opts.page ?? 1));
+    params.set("pageSize", String(opts.pageSize ?? 20));
+    // searchValue 必须传（即使为空字符串）
+    params.set("searchValue", opts.keyword ?? "");
+    params.set("startDate", startDate);
+    params.set("endDate", endDate);
+    const url = `${config.apiBaseUrl}/invoice-request?${params}`;
+    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 items = data.results ?? [];
+    const total = data.totalResultCount ?? 0;
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 20;
+    console.log(`\n开票记录（第 ${page}/${Math.ceil(total / pageSize)} 页，共 ${total} 条）\n`);
+    if (items.length === 0) {
+        console.log("  暂无数据。\n");
+        return;
+    }
+    const header = [
+        "申请单号".padEnd(20),
+        "企业".padEnd(20),
+        "类型".padEnd(16),
+        "状态".padEnd(10),
+        "申请时间",
+    ].join("  ");
+    console.log("  " + header);
+    console.log("  " + "-".repeat(header.length));
+    for (const item of items) {
+        console.log("  " + [
+            (item.requestNo ?? "").padEnd(20),
+            (item.companyName ?? "").padEnd(20),
+            (item.billType ?? "").padEnd(16),
+            (item.invoiceStatus ?? "").padEnd(10),
+            item.applyTime ?? "",
+        ].join("  "));
+    }
+    console.log();
+}
+export async function runInvoiceBillable(opts) {
+    const config = await ensureDataPermission(loadConfig(opts.token));
+    const params = new URLSearchParams();
+    params.set("pageNumber", String(opts.page ?? 1));
+    params.set("pageSize", String(opts.pageSize ?? 20));
+    if (opts.media)
+        params.set("mediaType", opts.media);
+    if (opts.currency)
+        params.set("currencyCode", opts.currency);
+    if (opts.startDate)
+        params.set("startDate", opts.startDate);
+    if (opts.endDate)
+        params.set("endDate", opts.endDate);
+    // 钱包开票走独立接口
+    const endpoint = opts.wallet
+        ? `${config.apiBaseUrl}/command/WalletRecharge/SearchByInvoiceRequest`
+        : `${config.apiBaseUrl}/query/amountaccount/SearchByInvoiceRequest`;
+    const url = `${endpoint}?${params}`;
+    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 items = data.results ?? [];
+    const total = data.totalResultCount ?? 0;
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 20;
+    const label = opts.wallet ? "钱包可开票记录" : "充值可开票订单";
+    console.log(`\n${label}（第 ${page}/${Math.ceil(total / pageSize)} 页，共 ${total} 条）\n`);
+    if (items.length === 0) {
+        console.log("  暂无数据。\n");
+        return;
+    }
+    const header = [
+        "媒体".padEnd(10),
+        "币种".padEnd(8),
+        "金额".padEnd(12),
+        "状态".padEnd(16),
+        "账户名称".padEnd(20),
+        "创建时间",
+    ].join("  ");
+    console.log("  " + header);
+    console.log("  " + "-".repeat(header.length));
+    for (const item of items) {
+        console.log("  " + [
+            (item.mediaAccountType ?? "").padEnd(10),
+            (item.currencyCode ?? "").padEnd(8),
+            String(item.amounts ?? "").padEnd(12),
+            (item.invoiceState ?? item.rechargeStatus ?? "").padEnd(16),
+            (item.mediaCustomerName ?? "").padEnd(20),
+            (item.createdDateTime ?? "").slice(0, 19),
+        ].join("  "));
+    }
+    console.log();
+}
+export async function runInvoiceApply(opts) {
+    const config = await ensureDataPermission(loadConfig(opts.token));
+    let invoiceInfomation;
+    let recipientInfomation;
+    try {
+        invoiceInfomation = JSON.parse(opts.invoiceInfo);
+        recipientInfomation = JSON.parse(opts.recipientInfo);
+    }
+    catch {
+        console.error("\n❌ --invoice-info 或 --recipient-info 不是合法的 JSON\n");
+        process.exit(1);
+    }
+    const body = {
+        Bills: opts.billIds,
+        BillType: opts.billType,
+        MediaType: opts.mediaType,
+        InvoiceInfomation: invoiceInfomation,
+        RecipientInfomation: recipientInfomation,
+    };
+    const url = `${config.apiBaseUrl}/invoice-request`;
+    let data;
+    try {
+        data = await apiFetch(url, config, { method: "POST", body: JSON.stringify(body) }, 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;
+    }
+    console.log(`\n✅ 开票申请已提交（${opts.billIds.length} 条订单）\n`);
+}

package/dist/commands/keyword.d.ts

@@ -0,0 +1,14 @@
+export interface KeywordSuggestOptions {
+    token?: string;
+    /** 搜索词，可多次指定 */
+    keywords: string[];
+    /** 公司/产品网址（选填），填写后触发网址拓词 + 关键字推荐融合流程 */
+    url?: string;
+    /** 过滤：必须包含的词，逗号/空格分隔 */
+    include?: string;
+    /** 过滤：不包含的词，逗号/空格分隔 */
+    exclude?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+export declare function runKeywordSuggest(opts: KeywordSuggestOptions): Promise<void>;