siluzan-tso-cli 1.0.0-beta.13 → 1.0.0-beta.15

package/README.md

@@ -1,6 +1,6 @@
 # Siluzan TSO Skill — 给大模型的安装说明
 
-当用户发来本页面的 **URL** 时，请按顺序协助用户完成安装（不要编造不存在的 npm 包名；若公司尚未发布，请改用用户提供的 Git 地址或本地 `tso-cli` 路径）。
+当用户发来本页面的 **URL** 时，请按顺序协助用户完成安装。
 
 ## 1. 环境
 
@@ -13,10 +13,14 @@
 
 ```bash
 npm install -g siluzan-tso-cli@beta
-siluzan-tso init --ai cursor
+siluzan-tso init --ai cursor         # 写入 Cursor（默认）
+siluzan-tso init --ai cursor,claude  # 同时写入多个平台
+siluzan-tso init --ai all            # 写入所有支持的平台
+siluzan-tso init -d /path/to/skills  # 写入自定义目录
+siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.0.0-beta.13），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.0.0-beta.15），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手 | 建议 `--ai` |
 |------|-------------|
@@ -28,39 +32,78 @@ siluzan-tso init --ai cursor
 | WorkBuddy（全局技能） | `workbuddy-global` |
 | 一次写入多处 | `all` |
 
-若 CLI 未发布：指导用户在克隆的仓库根目录执行 `npm install && npm run build`，再 `node tso-cli/dist/index.js init --ai cursor`。
+## 3. 登录 / 鉴权
 
-## 3. 登录 / Token
+`siluzan-tso` 与 `siluzan-cso` **共用同一个凭据**（存储在 `~/.siluzan/config.json`）。
 
-`siluzan-tso` 与 `siluzan-cso` **共用同一个 Token**（存储在 `~/.siluzan/config.json`）。
+**若用户已安装 `siluzan-cso` 并完成登录，无需重复操作，直接跳到第 4 步。**
 
-**若用户已安装 siluzan-cso 并完成登录，无需重复操作，直接跳到第 4 步。**
+### 方式 A：交互式登录（推荐）
 
-若尚未登录，请先安装 `siluzan-cso-cli` 并完成登录：
+```bash
+siluzan-tso login
+```
+
+按提示访问丝路赞控制台「个人设置 → API Key 管理」页面创建 API Key 后粘贴到终端，自动保存。也可跳过交互直接传入：
+
+```bash
+siluzan-tso login --api-key <YOUR_API_KEY>
+```
+
+### 方式 B：直接设置（适合自动化场景）
+
+```bash
+siluzan-tso config set --api-key <你的ApiKey>
+```
+
+### 方式 C：Token 登录（已有 siluzan-cso 账号）
 
 ```bash
 npm install -g siluzan-cso-cli
 siluzan-cso login
 ```
 
-向导会在终端中提示用户访问 [https://www.siluzan.com](https://www.siluzan.com) 注册登录，然后在控制台的「个人设置 → API Token」页面复制 Token，粘贴到命令行提示处，自动保存到 `~/.siluzan/config.json`，后续 `siluzan-tso` 命令自动读取。
+向导会提示用户访问 [https://www.siluzan.com](https://www.siluzan.com) 注册登录，在「个人设置 → API Token」页面复制 Token 粘贴到命令行，自动保存后 `siluzan-tso` 会读取该 Token。
 
-提醒用户：**不要将 Token 提交到 Git。**
+提醒用户：**不要将 Token / API Key 提交到 Git。**
 
 ## 4. 验证
 
-确认以下路径已存在且含 `SKILL.md`：
+确认以下路径已存在且含 `SKILL.md` 和 `_meta.json`：
 
 | 助手 | Skill 文件路径 |
 |------|----------------|
 | Cursor | `.cursor/skills/siluzan-tso/SKILL.md` |
 | Claude Code | `.claude/skills/siluzan-tso/SKILL.md` |
 | OpenClaw 工作区 | `skills/siluzan-tso/SKILL.md` |
+| OpenClaw 全局 | `~/.openclaw/skills/siluzan-tso/SKILL.md` |
 | WorkBuddy 项目级 | `.workbuddy/skills/siluzan-tso/SKILL.md` |
 | WorkBuddy 全局 | `~/.workbuddy/skills/siluzan-tso/SKILL.md` |
 
-完成后，用户可在对话中描述广告账户管理需求（查账户、查余额、查消耗、充值、绑定 MCC/BC/BM 等），由已加载的 Skill 指导 `siluzan-tso` CLI 使用方式。
+完成后，用户可在对话中描述广告账户管理需求（查账户、查余额、查消耗、充值、开户、绑定 MCC/BC/BM、管理 Google 广告等），由已加载的 Skill 指导 `siluzan-tso` CLI 的使用方式。
+
+## 5. 更新
+
+CLI 在每次命令执行后会静默检查是否有新版本可用，有更新时会提示：
+
+```
+💡 发现新版本 x.x.x（测试版），运行以下命令升级：
+   npm install -g siluzan-tso-cli@beta
+```
+
+**发现提示后，Agent 应主动执行以下两步完成升级：**
+
+```bash
+# 第一步：升级 CLI
+{{INSTALL_CMD}}
+
+# 第二步：用新版 CLI 重新写入 Skill 文件（--force 覆盖旧版）
+siluzan-tso init --ai xxx --force
+```
+
+> `--ai` 参数换成实际使用的平台（如 `claude`、`openclaw-global` 等）。
+> 若不确定当前安装在哪个平台，可查看 `~/.siluzan/config.json` 中的 `tsoInstalledTargets` 字段。
 
-## 5. Token 续期
+## 6. Token 续期
 
-Token 过期后，重新运行 `siluzan-cso login` 即可更新，`siluzan-tso` 会自动读取新 Token，无需额外操作。
+Token 过期后，重新运行 `siluzan-cso login` 或 `siluzan-tso config set --api-key <新Key>` 即可，`siluzan-tso` 自动读取新凭据，无需额外操作。

package/dist/commands/init.js

@@ -51,9 +51,9 @@ function parseTargets(raw) {
     }
     return [...new Set(result)];
 }
-function assetsRoot() {
-    // dist/commands/init.js → ../../assets
-    return path.join(__dirname, "..", "..", "assets");
+function skillRoot() {
+    // dist/commands/init.js → dist/skill/
+    return path.join(__dirname, "..", "skill");
 }
 /** 将 skill 文件写入指定目录，返回是否有文件被写入 */
 async function writeSkillFilesToDir(destDir, skillFiles, force) {
@@ -106,7 +106,7 @@ function saveInstalledTargets(entries) {
 }
 export async function runInit(options) {
     const home = os.homedir();
-    const skillFiles = await getSkillFiles(assetsRoot());
+    const skillFiles = await getSkillFiles(skillRoot());
     const installedEntries = [];
     if (options.dir) {
         // 自定义目录模式

package/dist/index.js

@@ -26,6 +26,7 @@ import { runKeywordSuggest } from "./commands/keyword.js";
 import { runAccountDelink, runAccountShare, runAccountUnshare, runAccountShareDetail, runAccountAuth, runAccountMccBind, runAccountMccUnbind, runAccountClose, runAccountBmBind, runAccountWithdrawList, runAccountWithdrawSubmit, runAccountBcBind, runAccountBcUnbind, runAccountEmailAuthList, runAccountEmailAuth, runAccountEmailDeauth, } from "./commands/account-manage.js";
 import { runListAdvertiserGroups, runOpenAccountYandex, runOpenAccountBing, runOpenAccountKwai, runOpenAccountGoogleTimezones, runOpenAccountGoogleWizard, runOpenAccountGoogle, runOpenAccountTikTok, runOpenAccountTikTokTimezones, runOpenAccountTikTokIndustries, runOpenAccountTikTokAreas, runOpenAccountBingIndustries, } from "./commands/open-account.js";
 import { runLogin } from "./commands/login.js";
+import { notifyIfOutdated } from "./utils/version.js";
 /** 从 package.json 读取当前版本号 */
 function getVersion() {
     try {
@@ -1970,4 +1971,7 @@ program
     console.log("  诊断入口（测试）：https://www-ci.siluzan.com/diagnostics/\n");
     console.log("  请在浏览器中打开上述地址完成诊断操作。\n");
 });
-program.parse();
+// parseAsync 支持异步 action；命令执行完后触发版本检查（不阻塞主流程）
+program.parseAsync().then(() => {
+    notifyIfOutdated();
+});

package/{assets/siluzan-ads → dist/skill}/SKILL.md

@@ -15,7 +15,7 @@ description: >-
 
 通过 `siluzan-tso` CLI 完成广告投放管理，不要手动调接口。
 
-登录与配置详见 `references/setup.md`。
+配置查看与更新详见 `references/setup.md`。
 
 ---
 

package/dist/skill/_meta.json

@@ -0,0 +1,5 @@
+{
+  "slug": "siluzan-tso",
+  "version": "1.0.0-beta.15",
+  "publishedAt": 1774319855442
+}

package/{assets/siluzan-ads → dist/skill}/references/finance.md

@@ -7,7 +7,7 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`{{WEB_URL}}/v3/foreign_trade/settings/invoiceInformation`
+对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
 
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 - **PI**：形式发票（境外美金账户，英文信息）
@@ -130,10 +130,10 @@ siluzan-tso config show
 **示例：**
 
 ```
-- 现金充值（单笔）：{{WEB_URL}}/recharge/pay
-- 现金充值（批量）：{{WEB_URL}}/recharge/pay_batch
-- 月结充值：        {{WEB_URL}}/recharge/accountBillingQuota
-- 丝路赞钱包：      {{WEB_URL}}/recharge/siluzanWallet
+- 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
+- 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
+- 月结充值：        https://www-ci.siluzan.com/recharge/accountBillingQuota
+- 丝路赞钱包：      https://www-ci.siluzan.com/recharge/siluzanWallet
 ```
 
 ---

package/{assets/siluzan-ads → dist/skill}/references/reporting.md

@@ -132,10 +132,10 @@ siluzan-tso report list -m Google --json
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: {{WEB_URL}}
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# {{WEB_URL}}/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```
 
 ---

package/dist/skill/references/setup.md

@@ -0,0 +1,119 @@
+# 安装与配置
+
+## 安装 CLI
+
+```bash
+npm install -g siluzan-tso-cli@beta
+```
+
+环境要求：Node.js 18+
+
+---
+
+## 初始化 Skill 文件
+
+将 Skill 文件写入 AI 助手目录，使 Agent 能读取到本文档：
+
+```bash
+siluzan-tso init                          # 写入 Cursor（默认）
+siluzan-tso init --ai cursor,claude,workbuddy,openclaw       # 同时写入多个平台
+siluzan-tso init --ai all                 # 写入所有支持的平台
+siluzan-tso init -d /path/to/skills       # 写入自定义目录
+siluzan-tso init --force                  # 强制覆盖已存在文件
+```
+
+根据你的平台，使用不同的安装命令，如果没有列出你的平台，则使用 `init -d /path/to/skills`的方式，将skill复制到你的skill目录下
+支持的 `--ai` 目标：
+
+| 值 | 写入路径 |
+|----|---------|
+| `cursor` | `.cursor/skills/siluzan-tso/` |
+| `claude` | `.claude/skills/siluzan-tso/` |
+| `openclaw-workspace` | `skills/siluzan-tso/` |
+| `openclaw-global` | `~/.openclaw/skills/siluzan-tso/` |
+| `workbuddy-workspace` | `.workbuddy/skills/siluzan-tso/` |
+| `workbuddy-global` | `~/.workbuddy/skills/siluzan-tso/` |
+| `all` | 以上全部 |
+
+---
+
+## 首次登录 / 配置凭据
+
+`siluzan-tso` 与 `siluzan-cso` **共用同一份凭据**，存储在 `~/.siluzan/config.json`，配置一次两个 CLI 均可使用。
+
+```bash
+siluzan-tso login                          # 交互式登录，按提示创建 API Key 后粘贴
+siluzan-tso login --api-key <YOUR_API_KEY> # 直接设置 API Key（跳过交互）
+siluzan-tso config set --api-key <Key>     # 或通过 config set 直接写入
+siluzan-tso config set --token <Token>     # 备用：设置 JWT Token
+```
+
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+
+---
+
+## 查看当前配置
+
+```bash
+siluzan-tso config show
+```
+
+输出示例：
+```
+  构建环境     : production
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
+  apiKey       : abcd****1234
+```
+
+`webUrl` 是前端页面基地址，需要引导用户打开网页时用此值拼接路径。
+
+---
+
+## 更新 CLI 与 Skill 文件
+
+CLI 在每次命令执行后会静默检查新版本，有更新时提示：
+
+```
+💡 发现新版本 x.x.x，运行以下命令升级：
+   npm install -g siluzan-tso-cli@beta
+```
+
+发现提示后主动执行：
+
+```bash
+npm install -g siluzan-tso-cli@beta                        # 升级 CLI
+siluzan-tso init --force               # 重新写入 Skill 文件（--ai 与初始安装时一致）
+```
+
+已安装过的目标平台记录在 `~/.siluzan/config.json` 的 `tsoInstalledTargets` 字段，可用于确认需要更新哪些平台。
+
+---
+
+## 修改其他配置
+
+```bash
+siluzan-tso config set --api-base <url>    # 切换 TSO API 地址
+siluzan-tso config set --google-api <url>  # 切换 Google 网关地址
+siluzan-tso config clear                   # 清空所有凭据
+```
+
+---
+
+## 环境切换
+
+| 配置项 | 生产环境（默认） | 测试环境 |
+|--------|----------------|---------|
+| `apiBaseUrl` | `https://tso-api.siluzan.com` | `https://tso-api-ci.siluzan.com` |
+| `googleApiUrl` | `https://googleapi.mysiluzan.com` | `https://googleapi-ci.mysiluzan.com` |
+
+```bash
+# 切换到测试环境
+siluzan-tso config set --api-base https://tso-api-ci.siluzan.com
+siluzan-tso config set --google-api https://googleapi-ci.mysiluzan.com
+
+# 切回生产环境
+siluzan-tso config set --api-base https://tso-api.siluzan.com
+siluzan-tso config set --google-api https://googleapi.mysiluzan.com
+```

package/{assets/siluzan-ads → dist/skill}/references/tso-home.md

@@ -6,7 +6,7 @@
 
 用 `siluzan-tso config show` 读取 **`webUrl`**，再拼接路径：
 
-首页地址：`{{WEB_URL}}/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 
 > 若用户已登录 TSO，也可从左侧菜单进入「首页」。
 

package/{assets/siluzan-ads → dist/skill}/references/workflows.md

@@ -252,7 +252,7 @@ Failed / HasFailed（部分或全部失败）
 # 前置：确认 Google API 地址已配置
 siluzan-tso config show
 # 若 googleApiUrl 为空，先配置：
-# siluzan-tso config set --google-api {{GOOGLE_API_URL}}
+# siluzan-tso config set --google-api https://googleapi-ci.mysiluzan.com
 
 # 第一步：确认目标账户
 siluzan-tso list-accounts -m Google --json

package/dist/templates/load-templates.d.ts

@@ -1,5 +1,6 @@
 /**
- * 从 assets/siluzan-ads/ 目录读取所有 skill 文件，返回 { 相对路径: 文件内容 } 映射。
- * 读取后自动将环境占位符替换为当前构建环境对应的真实地址。
+ * 读取 dist/skill/ 目录下所有文件，返回 { 相对路径: 文件内容 } 映射。
+ *
+ * 占位符替换已在构建阶段（copy-skill-assets.mjs）完成，此处无需二次处理。
  */
-export declare function getSkillFiles(assetsDir: string): Promise<Record<string, string>>;
+export declare function getSkillFiles(skillDir: string): Promise<Record<string, string>>;

package/dist/templates/load-templates.js

@@ -1,45 +1,11 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { DEFAULT_API_BASE, DEFAULT_GOOGLE_API } from "../config/defaults.js";
 /**
- * 根据 TSO API 地址推导前端 Web 地址。
- * tso-api.siluzan.com    → www.siluzan.com
- * tso-api-ci.siluzan.com → www-ci.siluzan.com
- */
-function deriveWebBaseUrl(tsoApiBase) {
-    try {
-        const u = new URL(tsoApiBase);
-        u.hostname = u.hostname.replace(/^tso-api/, "www");
-        return u.origin;
-    }
-    catch {
-        return "https://www.siluzan.com";
-    }
-}
-// 构建时确定的环境变量，用于替换 markdown 中的占位符
-const WEB_URL = deriveWebBaseUrl(DEFAULT_API_BASE);
-const TSO_API_URL = DEFAULT_API_BASE;
-const GOOGLE_API_URL = DEFAULT_GOOGLE_API;
-/**
- * 将 markdown 内容中的环境占位符替换为当前构建环境对应的真实地址。
+ * 读取 dist/skill/ 目录下所有文件，返回 { 相对路径: 文件内容 } 映射。
  *
- * 占位符规范：
- *   {{WEB_URL}}        → 前端页面基地址（如 https://www.siluzan.com）
- *   {{TSO_API_URL}}    → TSO 主 API 地址
- *   {{GOOGLE_API_URL}} → Google 广告网关地址
- */
-function applyEnvPlaceholders(content) {
-    return content
-        .replaceAll("{{WEB_URL}}", WEB_URL)
-        .replaceAll("{{TSO_API_URL}}", TSO_API_URL)
-        .replaceAll("{{GOOGLE_API_URL}}", GOOGLE_API_URL);
-}
-/**
- * 从 assets/siluzan-ads/ 目录读取所有 skill 文件，返回 { 相对路径: 文件内容 } 映射。
- * 读取后自动将环境占位符替换为当前构建环境对应的真实地址。
+ * 占位符替换已在构建阶段（copy-skill-assets.mjs）完成，此处无需二次处理。
  */
-export async function getSkillFiles(assetsDir) {
-    const skillDir = path.join(assetsDir, "siluzan-ads");
+export async function getSkillFiles(skillDir) {
     const out = {};
     async function walk(dir, prefix) {
         const entries = await fs.readdir(dir, { withFileTypes: true });
@@ -50,8 +16,7 @@ export async function getSkillFiles(assetsDir) {
                 await walk(full, rel);
             }
             else {
-                const raw = await fs.readFile(full, "utf8");
-                out[rel] = applyEnvPlaceholders(raw);
+                out[rel] = await fs.readFile(full, "utf8");
             }
         }
     }

package/dist/utils/version.d.ts

@@ -0,0 +1,11 @@
+/** 读取 CLI 自身的当前版本（来自 package.json） */
+export declare function getCurrentVersion(): string;
+/** 比较语义化版本，支持 beta 后缀，返回 true 表示 b > a */
+export declare function isNewer(a: string, b: string): boolean;
+/**
+ * 静默版本检查：命令完成后异步触发。
+ * - 当前为 beta 版 → 对比 npm beta tag 的最新版本
+ * - 当前为正式版 → 对比 npm latest tag 的最新版本
+ * 有更新时打印一行提示，不阻塞主命令，不抛出异常。
+ */
+export declare function notifyIfOutdated(): Promise<void>;

package/dist/utils/version.js

@@ -0,0 +1,124 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { fileURLToPath } from "node:url";
+const CONFIG_FILE = path.join(os.homedir(), ".siluzan", "config.json");
+const PKG_NAME = "siluzan-tso-cli";
+/** 读取 CLI 自身的当前版本（来自 package.json） */
+export function getCurrentVersion() {
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        // dist/utils/version.js → ../../package.json
+        const pkgPath = path.join(__dirname, "..", "..", "package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/** 判断当前版本是否为 beta（版本号含 -beta） */
+function isBetaVersion(version) {
+    return version.includes("-beta");
+}
+/** 比较语义化版本，支持 beta 后缀，返回 true 表示 b > a */
+export function isNewer(a, b) {
+    // 拆出纯数字部分，如 "1.0.0-beta.12" → [1,0,0,12]
+    const parse = (v) => {
+        const [base, pre] = v.replace(/^v/, "").split("-beta.");
+        const nums = base.split(".").map(Number);
+        // beta 版附加预发布号；无预发布号的正式版视为无穷大（正式版 > beta）
+        nums.push(pre !== undefined ? Number(pre) : Infinity);
+        return nums;
+    };
+    const av = parse(a);
+    const bv = parse(b);
+    for (let i = 0; i < Math.max(av.length, bv.length); i++) {
+        const ai = av[i] ?? 0;
+        const bi = bv[i] ?? 0;
+        if (bi !== ai)
+            return bi > ai;
+    }
+    return false;
+}
+function readConfigRaw() {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfigRaw(data) {
+    try {
+        fs.mkdirSync(path.dirname(CONFIG_FILE), { recursive: true });
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), "utf8");
+        if (process.platform !== "win32") {
+            fs.chmodSync(CONFIG_FILE, 0o600);
+        }
+    }
+    catch {
+        // 写入失败不影响主流程
+    }
+}
+/**
+ * 从 npm registry 查询指定 tag 的最新版本。
+ * 结果缓存于 config.json，24 小时内不重复请求。
+ */
+async function fetchVersionByTag(tag, cfg) {
+    const cacheKey = tag === "beta" ? "_tsoLatestBeta" : "_tsoLatestStable";
+    const hours24 = 24 * 60 * 60 * 1000;
+    // 检查 24 小时内的缓存（两个 tag 共用同一个检查时间戳）
+    if (cfg._tsoLastVersionCheck && cfg[cacheKey]) {
+        const lastCheck = new Date(cfg._tsoLastVersionCheck).getTime();
+        if (Date.now() - lastCheck < hours24) {
+            return cfg[cacheKey];
+        }
+    }
+    try {
+        const url = `https://registry.npmjs.org/${PKG_NAME}/${tag}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 4000);
+        const res = await fetch(url, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 静默版本检查：命令完成后异步触发。
+ * - 当前为 beta 版 → 对比 npm beta tag 的最新版本
+ * - 当前为正式版 → 对比 npm latest tag 的最新版本
+ * 有更新时打印一行提示，不阻塞主命令，不抛出异常。
+ */
+export async function notifyIfOutdated() {
+    try {
+        const current = getCurrentVersion();
+        const isBeta = isBetaVersion(current);
+        const tag = isBeta ? "beta" : "latest";
+        const cfg = readConfigRaw();
+        const latest = await fetchVersionByTag(tag, cfg);
+        if (!latest)
+            return;
+        // 更新缓存
+        const cacheKey = isBeta ? "_tsoLatestBeta" : "_tsoLatestStable";
+        writeConfigRaw({
+            ...cfg,
+            _tsoLastVersionCheck: new Date().toISOString(),
+            [cacheKey]: latest,
+        });
+        if (isNewer(current, latest)) {
+            const tagLabel = isBeta ? "（测试版）" : "（正式版）";
+            console.error(`\n💡 发现新版本 ${latest}${tagLabel}（当前 ${current}），运行以下命令升级：\n` +
+                `   npm install -g ${PKG_NAME}@${tag}\n`);
+        }
+    }
+    catch {
+        // 静默，不干扰用户
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.0.0-beta.13",
+  "version": "1.0.0-beta.15",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "type": "module",
   "bin": {
@@ -8,14 +8,13 @@
   },
   "files": [
     "dist",
-    "assets",
     "README.md"
   ],
   "scripts": {
     "prebuild": "node scripts/write-defaults.mjs --env production",
-    "build": "tsc",
-    "build:prod": "node scripts/write-defaults.mjs --env production && tsc",
-    "build:test": "node scripts/write-defaults.mjs --env test && tsc",
+    "build": "tsc && node scripts/copy-skill-assets.mjs --env production",
+    "build:prod": "node scripts/write-defaults.mjs --env production && tsc && node scripts/copy-skill-assets.mjs --env production",
+    "build:test": "node scripts/write-defaults.mjs --env test && tsc && node scripts/copy-skill-assets.mjs --env test",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build:prod",
     "prepublishOnly:test": "npm run build:test"

package/assets/siluzan-ads/references/setup.md

@@ -1,80 +0,0 @@
-# 安装、登录与配置
-
-## 安装 Skill 文件（首次）
-
-运行以下命令将 Skill 文件写入 AI 助手目录，使 AI Agent 能读取到本文档：
-
-```bash
-siluzan-tso init                          # 写入 Cursor（默认）
-siluzan-tso init -a cursor,claude         # 写入多个平台
-siluzan-tso init -d /path/to/skills       # 写入自定义目录
-siluzan-tso init --force                  # 强制覆盖已存在文件
-```
-
-支持的目标（`-a`）：`cursor` | `claude` | `openclaw-workspace` | `openclaw-global` | `workbuddy-workspace` | `workbuddy-global` | `all`
-
----
-
-## 首次登录
-
-```bash
-siluzan-tso login
-```
-
-按提示访问 `{{WEB_URL}}/v3/foreign_trade/settings/apiKeyManagement`，创建 API Key 后粘贴到终端。
-API Key 保存在 `~/.siluzan/config.json`，与 `siluzan-cso` 共用，配置一次两个 CLI 均可使用。
-
-也可直接通过参数跳过交互：
-
-```bash
-siluzan-tso login --api-key <YOUR_API_KEY>
-```
-
----
-
-## 查看当前配置
-
-```bash
-siluzan-tso config show
-```
-
-输出示例：
-```
-  apiBaseUrl   : {{TSO_API_URL}}
-  googleApiUrl : {{GOOGLE_API_URL}}
-  webUrl       : {{WEB_URL}}
-  apiKey       : abcd****1234
-```
-
-`webUrl` 是前端页面基地址，需要引导用户打开网页时用此值拼接路径。
-
----
-
-## 修改配置
-
-```bash
-siluzan-tso config set --api-key <新ApiKey>       # 推荐：设置 API Key
-siluzan-tso config set --token <新Token>          # 备用：设置 JWT Token
-siluzan-tso config set --api-base <url>           # 切换 TSO API 地址
-siluzan-tso config set --google-api <url>         # 切换 Google 网关地址
-siluzan-tso config clear                          # 清空凭据
-```
-
----
-
-## 环境切换
-
-| 配置项 | 生产环境（默认） | 测试环境 |
-|--------|----------------|---------|
-| `apiBaseUrl` | `https://tso-api.siluzan.com` | `https://tso-api-ci.siluzan.com` |
-| `googleApiUrl` | `https://googleapi.mysiluzan.com` | `https://googleapi-ci.mysiluzan.com` |
-
-```bash
-# 切换到测试环境
-siluzan-tso config set --api-base https://tso-api-ci.siluzan.com
-siluzan-tso config set --google-api https://googleapi-ci.mysiluzan.com
-
-# 切回生产环境
-siluzan-tso config set --api-base https://tso-api.siluzan.com
-siluzan-tso config set --google-api https://googleapi.mysiluzan.com
-```