siluzan-tso-cli 1.1.13 → 1.1.14-beta.10

package/eval/stub-fixtures/google-analysis.json

@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "data": {
+    "keywords": [{ "text": "brand shoes", "cost": 12.34, "clicks": 40 }],
+    "meta": { "stub": true, "section": "KeywordSectionData" }
+  }
+}

package/eval/stub-fixtures/invoice-billable.json

@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "data": {
+    "items": [{ "entityId": "bill-entity-1", "amount": 500.0, "currency": "USD", "media": "Google" }]
+  },
+  "meta": { "stub": true }
+}

package/eval/stub-fixtures/invoice-info-list.json

@@ -0,0 +1,13 @@
+{
+  "ok": true,
+  "data": {
+    "items": [
+      {
+        "id": "inv-1",
+        "invoiceType": "VATI",
+        "companyName": "Demo Tech Co., Ltd."
+      }
+    ]
+  },
+  "meta": { "stub": true }
+}

package/eval/stub-fixtures/invoice-list.json

@@ -0,0 +1,10 @@
+{
+  "ok": true,
+  "data": {
+    "items": [
+      { "invoiceNo": "INV202604001", "status": "Issued", "amount": 1200.0, "currency": "CNY", "media": "Google" },
+      { "invoiceNo": "INV202604002", "status": "Pending", "amount": 800.0, "currency": "CNY", "media": "TikTok" }
+    ]
+  },
+  "meta": { "stub": true }
+}

package/eval/stub-fixtures/list-accounts.json

@@ -0,0 +1,13 @@
+{
+  "ok": true,
+  "data": {
+    "items": [
+      {
+        "entityId": "f2a5ca16-cff9-4a9e-9aea-f7429c3e2696",
+        "mediaCustomerId": "4256317784",
+        "mag": { "advertiserName": "ACME Demo Brand" },
+        "currencyCode": "USD"
+      }
+    ]
+  }
+}

package/eval/stub-fixtures/optimize-list.json

@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "data": {
+    "items": [{ "id": "opt-1", "status": "Completed", "summary": "提高系列预算 10%" }]
+  },
+  "meta": { "stub": true }
+}

package/eval/stub-fixtures/report-push-list.json

@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "data": {
+    "configs": [{ "id": "pc-1", "reportType": "Google", "enabled": true, "recipients": ["ops@example.com"] }]
+  },
+  "meta": { "stub": true }
+}

package/eval/stub-fixtures/stats.json

@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "data": {
+    "accountsoverview": {
+      "costMicrosDisplay": 500.12,
+      "currencyCode": "USD"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.13",
+  "version": "1.1.14-beta.10",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",
@@ -18,8 +18,11 @@
   },
   "files": [
     "dist",
+    "eval/cases",
+    "eval/stub-fixtures",
     "README.md",
-    "scripts/postinstall.mjs"
+    "scripts/postinstall.mjs",
+    "assets/siluzan-ads/references/hosted-automation-user-catalog.md"
   ],
   "type": "module",
   "publishConfig": {
@@ -36,6 +39,7 @@
     "@types/node": "^22.10.0",
     "@types/qrcode": "^1.5.6",
     "tsup": "^8.3.0",
+    "tsx": "^4.19.0",
     "typescript": "^5.7.2",
     "siluzan-cli-common": "1.0.0"
   },
@@ -71,6 +75,7 @@
     "build": "node scripts/write-defaults.mjs --env production && tsup && node scripts/copy-skill-assets.mjs --env production",
     "build:prod": "node scripts/write-defaults.mjs --env production && tsup && node scripts/copy-skill-assets.mjs --env production",
     "build:test": "node scripts/write-defaults.mjs --env test && tsup && node scripts/copy-skill-assets.mjs --env test",
+    "eval:export-cases": "tsx eval/scripts/export-scenarios.mts",
     "test:ad-read": "node scripts/test-ad-api-read.mjs",
     "start": "node dist/index.js"
   }

package/scripts/postinstall.mjs

@@ -1,7 +1,32 @@
 /**
  * 安装本包后提示：升级 CLI 后请同步 Skill（见 siluzan-tso update）。
  * monorepo / 本地 link 时每次 install 也会执行，属预期。
+ *
+ * 自动化场景说明从 `assets/.../hosted-automation-user-catalog.md` 读取，避免在脚本内嵌含反引号的模板字符串导致语法错误。
  */
-console.log(
-  "[siluzan-tso]: 安装成功，请执行 siluzan-tso init -d /path/to/skills 复制项目中最新的skill文件来更新你的skill",
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const catalogPath = path.join(
+  __dirname,
+  "..",
+  "assets",
+  "siluzan-ads",
+  "references",
+  "hosted-automation-user-catalog.md",
 );
+
+const header =
+  "[siluzan-tso]: 安装成功，请执行 siluzan-tso init -d /path/to/skills 复制项目中最新的 skill 文件来更新你的 skill";
+
+let body = "";
+try {
+  body = "\n\n" + fs.readFileSync(catalogPath, "utf8").trimEnd();
+} catch {
+  body =
+    "\n\n";
+}
+
+console.log(header + body);

package/dist/skill/references/open-account-by-media.md

@@ -1,61 +0,0 @@
-# 各媒体开户：接口与参数技术细节
-
-> 业务流程（步骤、所需资料、审核处理）见 `references/workflows.md` 流程一。  
-> 本文件仅记录各媒体的底层接口路径与请求体结构，供排查问题或深度定制时参考。
-
----
-
-## 路由对照
-
-| 媒体       | 前端路由（path）                  | 说明                                                                                             |
-| ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------ |
-| **Google** | `/openAnAccount?mediaType=Google` | 与 TikTok 共用 `openAnAccount.vue`；从开户记录进入 Google 时往往先弹 **GGwarn** 合规提示再进表单 |
-| **TikTok** | `/openAnAccount?mediaType=TikTok` | 同上组件，`mediaType` 区分字段与提交流程                                                         |
-| **Yandex** | `/YandexOpenAnAccount`            | 独立页面 `YandexOpenAnAccount_v2.vue`                                                            |
-| **BingV2** | `/bingOpenAnAccount`              | 独立页面 `bingOpenAnAccount.vue`                                                                 |
-| **Kwai**   | `/KwaiOpenAnAccount`              | 独立页面 `KwaiOpenAnAccount.vue`                                                                 |
-
----
-
-## 广告主组（magKey）接口
-
-所有媒体在提交开户前都需要一个广告主组，并取得 `magKey`（MediaAccountGroupId）：
-
-- **查询列表**：`GET {apiBaseUrl}/query/profile/steward-individual` → `profile.mediaAccountGroups[]`，项上 `key` 即 magKey
-- **创建**：`PUT {apiBaseUrl}/command/profile/steward-individual`，Header `s-command-type: AddMediaAccountGroup`
-- **更新**：`PUT {apiBaseUrl}/command/profile/steward-individual/{id}`，Header `s-command-type: UpdateMediaAccountGroup`
-
-**所有媒体均无需手动查询 magKey**：CLI 对每个媒体都会按 `--company`（或 `--advertiser-name` / `--company-name`）自动查找同名广告主组——存在则更新，不存在则创建——再用拿到的 magKey 提交开户。`--advertiser-id` 在所有开户命令中均为可选，仅供调试时手动指定。
-
----
-
-## 各媒体提交接口
-
-| CLI 子命令            | 提交接口                                   | Method | 关键 Header / 特点                                                                                                     |
-| --------------------- | ------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------- |
-| `open-account google` | `/command/media-account/google`            | POST   | `s-command-type: AddExistingMediaAccountList`；前置自动创建广告主组                                                    |
-| `open-account tiktok` | `/command/media-account`（不是 `/google`） | POST   | 同上；前置 `POST .../tiktok/Upload` 上传执照图片；可选 `POST .../command/attachment` 存档、`GET .../CheckUnionpayInfo` |
-| `open-account yandex` | `/command/media-account/AddAgencyClient`   | POST   | Body：`MediaAccountGroupId` + `AgencyClientInfo`（登录名、税号、电话等）                                               |
-| `open-account bing`   | `/command/media-account/AddBingV2Account`  | POST   | Body：`BingCustomerInfo` / `BingV2AccountInfo` + 执照 `FileId`；前置 `POST .../command/attachment`                     |
-| `open-account kwai`   | `/command/media-account/AddKwaiAccount`    | POST   | Body：Kwai 专用主体/行业/执照结构 + `blobstoreKey`；前置 `POST .../KwaiAccount/Management/Upload`                      |
-
----
-
-## 辅助接口
-
-| 用途              | 接口                                                                                                                | CLI 命令                         |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
-| Google 时区列表   | `GET {apiBaseUrl}/query/media-account/Google/TimeZoneInfo/ReadFile`                                                 | `open-account google-timezones`  |
-| TikTok 时区列表   | `GET {apiBaseUrl}/query/media-account/tiktok/TikTokTimeZoneInfo/Read`                                               | `open-account tiktok-timezones`  |
-| TikTok 行业列表   | `GET {apiBaseUrl}/query/media-account/tiktok/TikTokIndustryInfo/Read`                                               | `open-account tiktok-industries` |
-| TikTok 注册地列表 | `GET {apiBaseUrl}/query/media-account/tiktok/TikTokAreacode/Read`                                                   | `open-account tiktok-areas`      |
-| Bing 行业列表     | `GET {apiBaseUrl}/query/media-account/bing/BingTradeList/Read`（返回中文行业名，`name` 字段即为 `--trade-id` 的值） | `open-account bing-industries`   |
-| 修改 Google 申请  | `PUT .../command/media-account/google/{entityId}`，`s-command-type: UpdateMediaAccount`                             | —                                |
-| 修改 TikTok 申请  | `PUT .../command/media-account/{entityId}`，`s-command-type: UpdateMediaAccount`                                    | —                                |
-| 修改 Yandex 申请  | `POST .../command/media-account/UpdateAgencyClient/{id}`                                                            | —                                |
-
-## 公司名称（广告主组）联想说明
-
-网页上「公司名称」下拉的数据来自 `GET {apiBaseUrl}/query/profile/steward-individual`（与 `open-account list-groups` 同一接口），**无搜索接口，为本地过滤**。
-
-选中已有广告主后，网页会自动回填推广链接、行业、推广类型等字段。CLI 的 `open-account google` 同样按 `--company` 名称自动匹配或创建广告主组，行为与网页一致。