siluzan-tso-cli 1.1.22-beta.2 → 1.1.22-beta.3

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.22-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.22-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |
@@ -69,7 +69,7 @@ siluzan-tso init --force             # 强制覆盖已存在文件
 
 **若用户已安装 `siluzan-cso` 并完成登录，无需重复操作，直接跳到第 4 步。**
 
-**推荐顺序**：① **手机号 + 验证码**（首选）完整参数与排错见 `references/setup.md`（随 Skill 安装到本地）。
+**推荐顺序**：① **手机号 + 验证码**（首选）完整参数与排错见 `references/core/setup.md`（随 Skill 安装到本地）。
 
 ### 方式 A：手机号 + 验证码（**推荐**）
 

package/dist/index.js

@@ -4019,7 +4019,7 @@ var init_cli_json = __esm({
     SCHEMA_VERSION = 1;
     OUTLINE_AGENT_HINT = "\u5904\u7406\u987A\u5E8F\uFF1A\u5148\u8BFB outlineFile\uFF08schema \u63CF\u8FF0\uFF0C\u975E\u6570\u636E\uFF09\u4E86\u89E3\u5B57\u6BB5\u7C7B\u578B\uFF0C\u518D\u7528\u811A\u672C\u8BFB writtenFiles[0]\uFF08\u771F\u5B9E JSON \u6570\u636E\uFF09\u505A\u7B5B\u9009/\u805A\u5408\uFF1B\u4E0D\u8981\u628A outline \u5F53\u6210\u6570\u636E\uFF0C\u4E5F\u4E0D\u8981\u628A JSON \u5F53\u6210 schema\u3002";
     DEFAULT_FIELD_GUIDE = {
-      markdownRefs: ["references/currency.md", "references/tips.md", "references/accounts.md"]
+      markdownRefs: ["references/accounts/currency.md", "references/core/tips.md", "references/accounts/accounts.md"]
     };
     TS_LIKE_ARRAY_SAMPLE_MAX = 8;
   }
@@ -4731,7 +4731,7 @@ var init_google_analysis = __esm({
     CLI_PACKAGE2 = "siluzan-tso-cli";
     SCHEMA_VERSION2 = 2;
     DEFAULT_FIELD_GUIDE2 = {
-      markdownRefs: ["references/currency.md", "references/account-analytics.md"],
+      markdownRefs: ["references/accounts/currency.md", "references/analytics/account-analytics.md"],
       tsTypesModule: "tso-cli/src/types/google-analysis-api.ts"
     };
     GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS = [
@@ -105686,7 +105686,7 @@ function reportManifestFile(accountId) {
   return `${applyIdSuffix("report-manifest", accountId)}.json`;
 }
 var DEFAULT_FIELD_GUIDE3 = {
-  markdownRefs: ["references/account-analytics.md"]
+  markdownRefs: ["references/analytics/account-analytics.md"]
 };
 function sectionToFilename(section, accountId) {
   if (!/^[a-z0-9_-]+$/.test(section)) {
@@ -108655,7 +108655,7 @@ function register17(program2) {
   const optimizeCmd = program2.command("optimize").description("AI \u5E7F\u544A\u4F18\u5316\uFF08Google\uFF09");
   optimizeCmd.command("list").description("\u67E5\u8BE2\u8D26\u6237\u7EA7\u4F18\u5316\u4E3B\u5217\u8868\uFF08\u5BF9\u5E94\u9875\u9762 /advertising/intelligentOptimization\uFF09").option("-a, --account <id>", "\u8D26\u6237 mediaCustomerId\uFF08\u7559\u7A7A\u67E5\u5168\u90E8\uFF09").option(
     "--match-media-customer-id <id>",
-    "\u5728\u5168\u91CF\u5217\u8868\u4E2D\u7B5B\u9009\u8BE5 Google \u5BA2\u6237 ID\uFF08\u81EA\u52A8\u7FFB\u9875\uFF1B\u5DF2\u8131\u7BA1\u52FF\u7528 -a\uFF0C\u89C1 optimize.md\uFF09"
+    "\u5728\u5168\u91CF\u5217\u8868\u4E2D\u7B5B\u9009\u8BE5 Google \u5BA2\u6237 ID\uFF08\u81EA\u52A8\u7FFB\u9875\uFF1B\u5DF2\u8131\u7BA1\u52FF\u7528 -a\uFF0C\u89C1 operations/optimize.md\uFF09"
   ).option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF", parseInt).option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA", false).option(
     "--json-out <path>",
     "\u843D\u76D8\uFF08\u76EE\u5F55\u6216 *.json \u6587\u4EF6\u8DEF\u5F84\uFF09\u5E76\u66F4\u65B0 cli-manifest[-<\u67E5\u8BE2id>].json\uFF08\u4E0E --json \u4E92\u65A5\uFF09\uFF1B\u76EE\u5F55\u6A21\u5F0F\u6587\u4EF6\u540D\u4E3A `<section>[-<\u67E5\u8BE2id>].json`\uFF1Bstdout \u4E00\u884C\u6458\u8981 JSON\uFF0C\u542B outlineFile\uFF08TS \u5F0F\u7C7B\u578B\u5728 `*.outline.txt`\uFF09",
@@ -109499,12 +109499,16 @@ init_cli_table();
 function pushLengthViolation(violations, item) {
   violations.push({ ...item, excess: item.actual - item.limit });
 }
-function formatLengthViolationsReport(violations) {
+function lengthViolationAgentHint(revalidateCommand = "campaign-validate") {
+  return `\u52FF\u81EA\u52A8\u622A\u65AD JSON\u3002\u8BFB\u53D6\u843D\u76D8 JSON \u7684 lengthViolations\uFF0C\u5C06\u5168\u90E8\u6761\u76EE\u4E0E\u4FEE\u6539\u65B9\u6848\u5217\u7ED9\u7528\u6237\uFF0C\u786E\u8BA4\u540E\u5199\u5165\u914D\u7F6E\u5E76\u91CD\u65B0 ${revalidateCommand}\u3002`;
+}
+function formatLengthViolationsReport(violations, opts) {
   if (violations.length === 0) return "";
+  const cmd = opts?.revalidateCommand ?? "campaign-validate";
   const lines = [
     "",
     `\u{1F4CF} \u8D85\u957F\u5185\u5BB9\u6E05\u5355\uFF08\u5171 ${violations.length} \u9879\uFF09`,
-    "   \u8BF7\u52FF\u5728 JSON \u4E2D\u81EA\u52A8\u622A\u65AD\uFF1B\u8BF7\u5C06\u5168\u90E8\u6761\u76EE\u4E0E\u4FEE\u6539\u65B9\u6848\u5217\u7ED9\u7528\u6237\uFF0C\u786E\u8BA4\u540E\u518D\u6539 JSON \u5E76\u91CD\u65B0 campaign-validate\u3002",
+    `   \u8BF7\u52FF\u5728 JSON \u4E2D\u81EA\u52A8\u622A\u65AD\uFF1B\u8BF7\u5C06\u5168\u90E8\u6761\u76EE\u4E0E\u4FEE\u6539\u65B9\u6848\u5217\u7ED9\u7528\u6237\uFF0C\u786E\u8BA4\u540E\u518D\u6539 JSON \u5E76\u91CD\u65B0 ${cmd}\u3002`,
     ""
   ];
   for (let i = 0; i < violations.length; i++) {
@@ -113751,9 +113755,6 @@ var BUSINESS_NAME_MAX = 25;
 function pushErr3(errors, msg) {
   errors.push(msg);
 }
-function pushWarn3(warnings, msg) {
-  warnings.push(msg);
-}
 function nonEmptyStrings(list) {
   return (list ?? []).map((s) => s?.trim()).filter((s) => Boolean(s));
 }
@@ -113784,20 +113785,28 @@ function normalizeBidding(raw) {
   };
   return byNum[n] ?? null;
 }
-function warnTextLengths(cfg, warnings, prefix, texts, limit, label) {
+function validateTextLengths(errors, lengthViolations, texts, arrayField, kind, limit, label) {
   texts.forEach((text, i) => {
     const len = calcGoogleCharLength(text);
     if (len > limit) {
-      pushWarn3(
-        warnings,
-        `${prefix}${label}[${i}] \u6709\u6548\u957F\u5EA6 ${len} \u8D85\u8FC7\u5EFA\u8BAE\u4E0A\u9650 ${limit}\uFF08Google \u53EF\u80FD\u62D2\u767B\uFF09`
-      );
+      const field = `${arrayField}[${i}]`;
+      pushLengthViolation(lengthViolations, {
+        path: field,
+        field,
+        kind,
+        limit,
+        actual: len,
+        countMode: "google",
+        text
+      });
+      pushErr3(errors, `${label}[${i}] \u8D85\u8FC7 ${limit} \u5B57\u7B26\uFF08\u5F53\u524D ${len}\uFF0CCJK \u8BA1 2\uFF09\uFF1A"${text}"`);
     }
   });
 }
 function runPmaxCreateValidation(cfg) {
   const errors = [];
   const warnings = [];
+  const lengthViolations = [];
   const account = cfg.account?.toString().trim();
   if (!account) {
     pushErr3(errors, "account\uFF08\u5A92\u4F53\u5BA2\u6237 ID\uFF09\u5FC5\u586B");
@@ -113893,19 +113902,53 @@ function runPmaxCreateValidation(cfg) {
       }
     }
   }
-  warnTextLengths(cfg, warnings, "", headlines, HEADLINE_MAX, "headlines");
-  warnTextLengths(cfg, warnings, "", longHeadlines, LONG_HEADLINE_MAX, "longHeadlines");
-  warnTextLengths(cfg, warnings, "", descriptions, DESCRIPTION_MAX, "descriptions");
+  validateTextLengths(
+    errors,
+    lengthViolations,
+    headlines,
+    "headlines",
+    "pmax_headline",
+    HEADLINE_MAX,
+    "headlines"
+  );
+  validateTextLengths(
+    errors,
+    lengthViolations,
+    longHeadlines,
+    "longHeadlines",
+    "pmax_long_headline",
+    LONG_HEADLINE_MAX,
+    "longHeadlines"
+  );
+  validateTextLengths(
+    errors,
+    lengthViolations,
+    descriptions,
+    "descriptions",
+    "pmax_description",
+    DESCRIPTION_MAX,
+    "descriptions"
+  );
   if (cfg.businessName?.trim()) {
-    const bn = calcGoogleCharLength(cfg.businessName.trim());
+    const bnText = cfg.businessName.trim();
+    const bn = calcGoogleCharLength(bnText);
     if (bn > BUSINESS_NAME_MAX) {
-      pushWarn3(
-        warnings,
-        `businessName \u6709\u6548\u957F\u5EA6 ${bn} \u8D85\u8FC7\u5EFA\u8BAE\u4E0A\u9650 ${BUSINESS_NAME_MAX}`
+      pushLengthViolation(lengthViolations, {
+        path: "businessName",
+        field: "businessName",
+        kind: "pmax_business_name",
+        limit: BUSINESS_NAME_MAX,
+        actual: bn,
+        countMode: "google",
+        text: bnText
+      });
+      pushErr3(
+        errors,
+        `businessName \u8D85\u8FC7 ${BUSINESS_NAME_MAX} \u5B57\u7B26\uFF08\u5F53\u524D ${bn}\uFF0CCJK \u8BA1 2\uFF09\uFF1A"${bnText}"`
       );
     }
   }
-  return { errors, warnings };
+  return { errors, warnings, lengthViolations };
 }
 
 // src/commands/ad/pmax-image-validate.ts
@@ -114082,6 +114125,7 @@ async function runPmaxImageValidation(configFile, cfg) {
 }
 
 // src/commands/ad/pmax-image-resolve.ts
+init_auth();
 import { basename as basename4, dirname as dirname8, isAbsolute as isAbsolute3, resolve as resolve7 } from "path";
 import { readFileSync as readFileSync5 } from "fs";
 
@@ -114167,6 +114211,7 @@ var SLOT_META = {
     label: "Logo (LOGO)"
   }
 };
+var MAX_BASE64_UPLOAD_BYTES = 2e5;
 function guessContentType(fileName) {
   const lower = fileName.toLowerCase();
   if (lower.endsWith(".png")) return "image/png";
@@ -114183,10 +114228,8 @@ function normalizePmaxAssetId(value) {
   const m = s.match(/\/assets\/(\d+)\s*$/);
   return m ? m[1] : s;
 }
-async function uploadPmaxImageFile(config, googleApiUrl, accountId, absImagePath, name2, verbose) {
+async function uploadPmaxImageFileMultipart(config, googleApiUrl, accountId, absImagePath, assetName, fileBuffer, verbose) {
   const fileName = basename4(absImagePath);
-  const assetName = (name2 ?? fileName).trim() || fileName;
-  const fileBuffer = readFileSync5(absImagePath);
   const mimeType = guessContentType(fileName);
   const form = new FormData();
   form.append("file", new Blob([fileBuffer], { type: mimeType }), fileName);
@@ -114215,6 +114258,54 @@ async function uploadPmaxImageFile(config, googleApiUrl, accountId, absImagePath
   }
   return id;
 }
+async function uploadPmaxImageFileBase64(config, googleApiUrl, accountId, absImagePath, assetName, fileBuffer, verbose) {
+  const url = pmaxImageAssetUrl(googleApiUrl, accountId);
+  let data;
+  try {
+    data = await apiFetch2(
+      url,
+      config,
+      {
+        method: "POST",
+        body: JSON.stringify({ name: assetName, base64String: fileBuffer.toString("base64") })
+      },
+      verbose
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`\u4E0A\u4F20\u56FE\u7247\u8D44\u4EA7\u5931\u8D25\uFF1A${msg}\uFF08${absImagePath}\uFF09`);
+  }
+  const id = normalizePmaxAssetId(data["id"]);
+  if (!id) {
+    throw new Error(`\u4E0A\u4F20\u56FE\u7247\u8D44\u4EA7\u672A\u8FD4\u56DE id\uFF08${absImagePath}\uFF09`);
+  }
+  return id;
+}
+async function uploadPmaxImageFile(config, googleApiUrl, accountId, absImagePath, name2, verbose) {
+  const fileName = basename4(absImagePath);
+  const assetName = (name2 ?? fileName).trim() || fileName;
+  const fileBuffer = readFileSync5(absImagePath);
+  if (fileBuffer.length <= MAX_BASE64_UPLOAD_BYTES) {
+    return uploadPmaxImageFileBase64(
+      config,
+      googleApiUrl,
+      accountId,
+      absImagePath,
+      assetName,
+      fileBuffer,
+      verbose
+    );
+  }
+  return uploadPmaxImageFileMultipart(
+    config,
+    googleApiUrl,
+    accountId,
+    absImagePath,
+    assetName,
+    fileBuffer,
+    verbose
+  );
+}
 async function resolveOneSlot(configFile, cfg, kind, accountId, config, googleApiUrl, verbose) {
   const meta = SLOT_META[kind];
   const presetId = String(cfg[meta.configAssetIdKey] ?? "").trim();
@@ -114343,7 +114434,11 @@ function buildPmaxCreateUrl(googleApiUrl, accountId) {
 // src/commands/ad/pmax-create.ts
 async function runAdPmaxCreate(opts) {
   const cfg = loadPmaxCreateConfig(opts.configFile);
-  const { errors: cfgErrors, warnings: cfgWarnings } = runPmaxCreateValidation(cfg);
+  const {
+    errors: cfgErrors,
+    warnings: cfgWarnings,
+    lengthViolations: cfgLengthViolations
+  } = runPmaxCreateValidation(cfg);
   const { errors: imgErrors, warnings: imgWarnings } = await runPmaxImageValidation(
     opts.configFile,
     cfg
@@ -114357,6 +114452,10 @@ async function runAdPmaxCreate(opts) {
   if (errors.length > 0) {
     console.error("\n\u274C PMax \u914D\u7F6E\u6821\u9A8C\u5931\u8D25\uFF1A");
     for (const e of errors) console.error(`   \u2022 ${e}`);
+    const lengthReport = formatLengthViolationsReport(cfgLengthViolations, {
+      revalidateCommand: "pmax-validate"
+    });
+    if (lengthReport) console.error(lengthReport);
     console.error();
     process.exit(1);
   }
@@ -114432,13 +114531,18 @@ import { writeFileSync as writeFileSync3 } from "fs";
 init_cli_json_snapshot();
 async function runAdPmaxValidate(opts) {
   const cfg = loadPmaxCreateConfig(opts.configFile);
-  const { errors: cfgErrors, warnings: cfgWarnings } = runPmaxCreateValidation(cfg);
+  const {
+    errors: cfgErrors,
+    warnings: cfgWarnings,
+    lengthViolations: cfgLengthViolations
+  } = runPmaxCreateValidation(cfg);
   const { errors: imgErrors, warnings: imgWarnings } = await runPmaxImageValidation(
     opts.configFile,
     cfg
   );
   const errors = [...cfgErrors, ...imgErrors];
   const warnings = [...cfgWarnings, ...imgWarnings];
+  const lengthViolations = cfgLengthViolations;
   if (opts.writeNormalized) {
     const toWrite = stripMetaKeysForExport(cfg);
     writeFileSync3(opts.writeNormalized, `${JSON.stringify(toWrite, null, 2)}
@@ -114449,7 +114553,9 @@ async function runAdPmaxValidate(opts) {
     configFile: opts.configFile,
     account: cfg.account?.toString().trim() || void 0,
     errors,
-    warnings
+    warnings,
+    lengthViolations,
+    agentHint: lengthViolations.length > 0 ? lengthViolationAgentHint("pmax-validate") : void 0
   };
   const accountSuffix = payload.account;
   if (await emitCliJsonOrSnapshot(opts, {
@@ -114469,6 +114575,10 @@ async function runAdPmaxValidate(opts) {
   if (errors.length > 0) {
     console.error("\n\u274C PMax \u914D\u7F6E\u6821\u9A8C\u5931\u8D25\uFF1A");
     for (const e of errors) console.error(`   \u2022 ${e}`);
+    const lengthReport = formatLengthViolationsReport(lengthViolations, {
+      revalidateCommand: "pmax-validate"
+    });
+    if (lengthReport) console.error(lengthReport);
     console.error();
     process.exit(1);
   }
@@ -115283,7 +115393,6 @@ PMax \u5730\u7406\u62A5\u8868\uFF08\u6D3B\u52A8\xD7\u56FD\u5BB6\uFF0C${query.get
 // src/commands/ad/campaign-validate.ts
 import { writeFileSync as writeFileSync4 } from "fs";
 init_cli_json_snapshot();
-var LENGTH_VIOLATION_AGENT_HINT = "\u52FF\u81EA\u52A8\u622A\u65AD JSON\u3002\u8BFB\u53D6\u843D\u76D8 JSON \u7684 lengthViolations\uFF0C\u5C06\u5168\u90E8\u6761\u76EE\u4E0E\u4FEE\u6539\u65B9\u6848\u5217\u7ED9\u7528\u6237\uFF0C\u786E\u8BA4\u540E\u5199\u5165 campaign.json \u5E76\u91CD\u65B0 campaign-validate\u3002";
 async function runAdCampaignValidate(opts) {
   const cfg = loadCampaignCreateConfig(opts.configFile);
   const { errors, warnings, lengthViolations } = runCampaignCreateValidation(cfg);
@@ -115299,7 +115408,7 @@ async function runAdCampaignValidate(opts) {
     errors,
     warnings,
     lengthViolations,
-    agentHint: lengthViolations.length > 0 ? LENGTH_VIOLATION_AGENT_HINT : void 0
+    agentHint: lengthViolations.length > 0 ? lengthViolationAgentHint("campaign-validate") : void 0
   };
   const accountSuffix = payload.account || void 0;
   if (await emitCliJsonOrSnapshot(opts, {

package/dist/skill/AGENTS.md

@@ -0,0 +1,45 @@
+# siluzan-tso — Agent 文档目录
+
+> 单一 Skill 包（`name: siluzan-tso`）。运行时入口：`SKILL.md` → 按域 lazy-load `references/`。
+
+## 启动顺序
+
+1. Read `SKILL.md`（路由 + 任务→文档表）
+2. **每个新任务** Read `references/core/agent-conventions.md`
+3. 按任务表 Read 对应域文档后再执行 `siluzan-tso …`
+
+## 文档域（gstack-style domains）
+
+| 域 | 路径 | 何时 Read |
+| --- | --- | --- |
+| **Core** | `references/core/` | 纪律、安装、tips、playbooks、workflows |
+| **Accounts** | `references/accounts/` | 列表、余额、开户、财务、审计 |
+| **Google Ads** | `references/google-ads/` | CRUD、PMax、搜索系列流水线；`rules/` 为优化 SOP |
+| **Analytics** | `references/analytics/` | 拉数、批处理、拓词、RAG、TSO 报告 |
+| **Operations** | `references/operations/` | 预警、线索、优化记录、宿主编排自动化 |
+| **Templates** | `assets/`、`report-templates/` | JSON 契约、报告纲要 |
+
+## Playbook（标准动作）
+
+| ID | 文档 |
+| --- | --- |
+| P1–P7 | `references/core/playbooks.md` |
+| OKKI 周报 | `report-templates/okki-weekly-google-client.md` |
+| 询盘分析 | `report-templates/google-inquiry-analysis.md` |
+
+## 维护
+
+- 结构规范：`references/core/skill-authoring.md`
+- 人类深读：`docs/skill-guide.md`
+- 源码唯一真相：`tso-cli/assets/siluzan-ads/`（勿编辑 `skills/siluzan-tso/` 副本）
+
+## CLI 代码域（与文档对齐）
+
+| CLI 模块 | 文档域 |
+| --- | --- |
+| `src/commands/list-accounts/`、`accounts-digest/`、`balance-scan/` | accounts |
+| `src/commands/open-account/`、`account-manage-register.ts` | accounts |
+| `src/commands/ad/` | google-ads |
+| `src/commands/google-analysis/`、`google-analysis-batch.ts` | analytics |
+| `src/commands/report/` | analytics + report-templates |
+| `src/commands/forewarning/`、`optimize/`、`clue.ts` | operations |