siluzan-tso-cli 1.1.45 → 1.1.46-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/README.md +2 -1
  2. package/dist/index.js +480 -106
  3. package/dist/skill/_meta.json +2 -2
  4. package/dist/skill/references/accounts/accounts-balance-stats.md +10 -10
  5. package/dist/skill/references/accounts/accounts-list.md +1 -1
  6. package/dist/skill/references/accounts/accounts-permissions.md +2 -2
  7. package/dist/skill/references/accounts/finance.md +1 -1
  8. package/dist/skill/references/accounts/open-account-by-media.md +1 -1
  9. package/dist/skill/references/accounts/open-account-google-ui.md +1 -1
  10. package/dist/skill/references/analytics/account-analytics.md +74 -13
  11. package/dist/skill/references/analytics/rag.md +1 -1
  12. package/dist/skill/references/analytics/reporting.md +5 -5
  13. package/dist/skill/references/core/setup.md +5 -5
  14. package/dist/skill/references/google-ads/rules/google-ads-keyword-strategy.md +8 -8
  15. package/dist/skill/references/misc/tso-home.md +2 -2
  16. package/dist/skill/references/operations/hosted-automation-monitoring-json.md +9 -9
  17. package/dist/skill/references/operations/hosted-automation-scenarios.md +2 -0
  18. package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +3 -3
  19. package/dist/skill/references/report-templates/yandex-period-report-excel.md +45 -45
  20. package/dist/skill/references/report-templates/yandex-period-report.md +26 -27
  21. package/dist/skill/report-templates/REPORT-WORKFLOW.md +3 -3
  22. package/dist/skill/report-templates/yandex-period-report-excel.md +45 -45
  23. package/dist/skill/report-templates/yandex-period-report.html +1377 -1164
  24. package/dist/skill/report-templates/yandex-period-report.md +26 -27
  25. package/dist/skill/scripts/install.ps1 +3 -3
  26. package/dist/skill/scripts/install.sh +3 -3
  27. package/package.json +1 -1
package/dist/skill/report-templates/yandex-period-report.md CHANGED
@@ -8,16 +8,16 @@
8
8
 
9
9
  数据块（YandexAPI `/yandex-analysis` 8 维 + 本地周聚合）：总览、按日、Search 网络、系列、关键词、搜索词、地域、设备；周报由 CLI 写入 `daily.weekly`（后端无独立 weekly）。**禁止**自行按 `date` 聚周。
10
10
 
11
- | CLI `--sections` | 落盘形状（CI 实测） | 报告 `tables.*` / KPI |
12
- | ---------------- | -------------------------------------------------------- | ---------------------------------------------------------- |
13
- | `overview` | 对象：`account` / `currency` / `balance` / `totals` … | → `meta` + `kpis`（余额、日均、续航天数） |
11
+ | CLI `--sections` | 落盘形状（CI 实测） | 报告 `tables.*` / KPI |
12
+ | ---------------- | --------------------------------------------------------------------- | ------------------------------------------------ |
13
+ | `overview` | 对象：`account` / `currency` / `balance` / `totals` … | → `meta` + `kpis`（余额、日均、续航天数） |
14
14
  | `daily` | `{ account, startDate, endDate, items: DayRow[], weekly: WeekRow[] }` | → `tables.daily[]` + `tables.weekly[]`（勿重算） |
15
- | `search` | `{ …, items: SearchRow[] }` | → `tables.search[]` |
16
- | `campaigns` | `{ …, items: CampaignRow[] }`（默认 limit=100） | → `tables.campaigns[]` |
17
- | `keywords` | `{ …, items: KeywordRow[] }` | → `tables.keywords[]` |
18
- | `search-terms` | `{ …, items: SearchTermRow[] }`（**仅近 180 天**） | → `tables.searchTerms[]` |
19
- | `geo` | `{ …, items: GeoRow[] }` | → `tables.geo[]` |
20
- | `devices` | `{ …, items: DeviceRow[] }` | → `tables.devices[]` |
15
+ | `search` | `{ …, items: SearchRow[] }` | → `tables.search[]` |
16
+ | `campaigns` | `{ …, items: CampaignRow[] }`（默认 limit=100） | → `tables.campaigns[]` |
17
+ | `keywords` | `{ …, items: KeywordRow[] }` | → `tables.keywords[]` |
18
+ | `search-terms` | `{ …, items: SearchTermRow[] }`（**仅近 180 天**） | → `tables.searchTerms[]` |
19
+ | `geo` | `{ …, items: GeoRow[] }` | → `tables.geo[]` |
20
+ | `devices` | `{ …, items: DeviceRow[] }` | → `tables.devices[]` |
21
21
 
22
22
  > 金额已为账户币种小数；`ctr` / `conversionRate` 为 **0~1 小数**。写叙事前先读各维 `*.outline.txt`。
23
23
 
@@ -25,12 +25,12 @@
25
25
 
26
26
  ## 标准四步流程（默认 · 交付 HTML）
27
27
 
28
- | 步骤 | 执行者 | 动作 |
29
- | ---------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
30
- | **1. 拉数** | Agent 调 CLI | `yandex-analysis -a <porg-xxx> --start <s> --end <e> --json-out ./snap-yandex`（全 8 维或 `--sections` 指定子集） |
31
- | **2. 分析** | Agent | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`）。周趋势读 `daily-*.json` 的 `weekly[]`，**禁止**自己按 `date` 聚周。 |
28
+ | 步骤 | 执行者 | 动作 |
29
+ | ---------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
30
+ | **1. 拉数** | Agent 调 CLI | `yandex-analysis -a <porg-xxx> --start <s> --end <e> --json-out ./snap-yandex`（全 8 维或 `--sections` 指定子集） |
31
+ | **2. 分析** | Agent | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`）。周趋势读 `daily-*.json` 的 `weekly[]`，**禁止**自己按 `date` 聚周。 |
32
32
  | **3. 写 JSON** | Agent | 撰写 `yandex-period-report.json`：仅 `meta.accountId` + `narrative`（8 个分析章节）为必填；`kpis`/`tables` 可省略由 `--snapshot-dir` 合并 |
33
- | **4. 渲染 HTML** | CLI | `yandex-analysis render` — **校验 narrative 8 个分析章节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML |
33
+ | **4. 渲染 HTML** | CLI | `yandex-analysis render` — **校验 narrative 8 个分析章节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML |
34
34
 
35
35
  ```bash
36
36
  # 步骤 1
@@ -57,7 +57,6 @@ siluzan-tso yandex-analysis render \
57
57
  - `geo[]`：`{locationName, targetingLocationName, network, …metrics}`
58
58
  - `devices[]`：`{device, network, …metrics}`
59
59
  - `narrative`（**Agent 必填**）：
60
- - `executiveSummary[]`：≥1 段执行摘要
61
60
  - `sections.{overview,search,campaigns,keywords,searchTerms,geo,devices,daily}`：每个维度各 `{analysis[]（≥1，含数字依据）, suggestions[]（≥1）}`
62
61
  - `recommendations[]`：≥3 条跨维度优化建议（可用 `{priority,text,anchor}`，anchor 对齐样例锚点如 `#keyword` / `#query`）
63
62
  - `rowInsights`：有关键词表格行时，**HTML 将展示的 Top N 行必须有中文翻译**；`render` 缺项会拒绝出 HTML。见下方「逐行洞察」。Campaign / 关键词 / 搜索词 / 地域 / 设备列表**不展示**「问题」「建议」列，行级判断写入各维 `sections.*.analysis/suggestions` 即可。
@@ -132,18 +131,18 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
132
131
 
133
132
  ## HTML 章节与锚点（对齐开发样例）
134
133
 
135
- | 锚点 | 章节 | 数据 / 叙事来源 |
136
- | ----------- | -------------- | ---------------------------------------------------- |
137
- | `#overview` | 账户总览 | `kpis` + `tables.weekly` + 每日折叠 + `sections.overview` |
138
- | `#next` | 后续优化动作 | `narrative.recommendations` |
139
- | `#search` | Search 网络 | `tables.search` + `sections.search` |
140
- | `#campaign` | Campaign | `tables.campaigns` + `sections.campaigns` |
141
- | `#keyword` | 关键词 | `tables.keywords` + `sections.keywords` |
142
- | `#query` | 搜索词 | `tables.searchTerms` + `sections.searchTerms` |
143
- | `#geo` | 地域 | `tables.geo` + `sections.geo` |
144
- | `#device` | 设备 | `tables.devices` + `sections.devices` |
145
- | `#daily` | 日报表 | `tables.daily` + `sections.daily` |
146
- | `#weekly` | 周报表 | `tables.weekly`（同 daily 叙事） |
134
+ | 锚点 | 章节 | 数据 / 叙事来源 |
135
+ | ----------- | ------------ | --------------------------------------------------------- |
136
+ | `#overview` | 账户总览 | `kpis` + `tables.weekly` + 每日折叠 + `sections.overview` |
137
+ | `#next` | 后续优化动作 | `narrative.recommendations` |
138
+ | `#search` | Search 网络 | `tables.search` + `sections.search` |
139
+ | `#campaign` | Campaign | `tables.campaigns` + `sections.campaigns` |
140
+ | `#keyword` | 关键词 | `tables.keywords` + `sections.keywords` |
141
+ | `#query` | 搜索词 | `tables.searchTerms` + `sections.searchTerms` |
142
+ | `#geo` | 地域 | `tables.geo` + `sections.geo` |
143
+ | `#device` | 设备 | `tables.devices` + `sections.devices` |
144
+ | `#daily` | 日报表 | `tables.daily` + `sections.daily` |
145
+ | `#weekly` | 周报表 | `tables.weekly`（同 daily 叙事） |
147
146
 
148
147
  ---
149
148
 
package/dist/skill/scripts/install.ps1 CHANGED
@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
9
9
  # -- Package info (injected at build time) ------------------------------------
10
10
  $PKG_NAME = 'siluzan-tso-cli'
11
11
  # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
12
- $PKG_VERSION = '1.1.45'
12
+ $PKG_VERSION = '1.1.46-beta.2'
13
13
  $CLI_BIN = 'siluzan-tso'
14
14
  $SKILL_LABEL = 'Siluzan TSO'
15
- $INSTALL_CMD = 'npm install -g siluzan-tso-cli'
16
- $WEB_BASE = 'https://www.siluzan.com'
15
+ $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
16
+ $WEB_BASE = 'https://www-ci.siluzan.com'
17
17
 
18
18
  # -- Constants ----------------------------------------------------------------
19
19
  $NODE_MAJOR_MIN = 18
package/dist/skill/scripts/install.sh CHANGED
@@ -9,11 +9,11 @@ set -euo pipefail
9
9
  # -- Package info (injected at build time) ------------------------------------
10
10
  readonly PKG_NAME="siluzan-tso-cli"
11
11
  # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
12
- readonly PKG_VERSION="1.1.45"
12
+ readonly PKG_VERSION="1.1.46-beta.2"
13
13
  readonly CLI_BIN="siluzan-tso"
14
14
  readonly SKILL_LABEL="Siluzan TSO"
15
- readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
16
- readonly WEB_BASE="https://www.siluzan.com"
15
+ readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
16
+ readonly WEB_BASE="https://www-ci.siluzan.com"
17
17
 
18
18
  # -- Constants ----------------------------------------------------------------
19
19
  readonly NODE_MAJOR_MIN=18
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.1.45",
3
+ "version": "1.1.46-beta.2",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
5
5
  "keywords": [
6
6
  "ad-account",