siluzan-tso-cli 1.1.18-beta.5 → 1.1.18-beta.6

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.18-beta.5），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.18-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |
@@ -69,7 +69,18 @@ siluzan-tso init --force             # 强制覆盖已存在文件
 
 **若用户已安装 `siluzan-cso` 并完成登录，无需重复操作，直接跳到第 4 步。**
 
-### 方式 A：交互式登录（推荐）
+**推荐顺序**：① **手机号 + 验证码**（首选）完整参数与排错见 `references/setup.md`（随 Skill 安装到本地）。
+
+### 方式 A：手机号 + 验证码（**推荐**）
+
+```bash
+siluzan-tso send-login-code --phone <手机号>
+siluzan-tso login --phone <手机号> --code <6位验证码>
+```
+
+不向终端索要交互输入；Agent 先发码、用户回填验证码后再执行第二步。手机号须已在丝路赞注册。
+
+### 方式 B：交互式登录（需真人 TTY）
 
 ```bash
 siluzan-tso login
@@ -81,13 +92,13 @@ siluzan-tso login
 siluzan-tso login --api-key <YOUR_API_KEY>
 ```
 
-### 方式 B：直接设置（适合自动化场景）
+### 方式 C：直接设置（适合自动化场景）
 
 ```bash
 siluzan-tso config set --api-key <你的ApiKey>
 ```
 
-### 方式 C：Token 登录（已有 siluzan-cso 账号）
+### 方式 D：Token 登录（已有 siluzan-cso 账号）
 
 ```bash
 npm install -g siluzan-cso-cli
@@ -137,4 +148,4 @@ siluzan-tso init --ai xxx --force
 
 ## 6. Token 续期
 
-Token 过期后，重新运行 `siluzan-cso login` 或 `siluzan-tso config set --api-key <新Key>` 即可，`siluzan-tso` 自动读取新凭据，无需额外操作。
+Token 过期后：**优先**再走一遍**方式 A**（手机验证码）签发新 API Key；或 `siluzan-cso login` / `siluzan-tso config set --api-key <新Key>`，`siluzan-tso` 自动读取新凭据。

package/dist/index.js

@@ -1974,6 +1974,7 @@ import { performance } from "perf_hooks";
 import * as fs2 from "fs";
 import * as path2 from "path";
 import { fileURLToPath } from "url";
+import { spawn } from "child_process";
 import Table from "cli-table3";
 import * as path3 from "path";
 import { chmod, mkdir, open, readdir, stat, unlink } from "fs/promises";
@@ -2375,6 +2376,29 @@ async function fetchNpmVersion(pkgName, tag, timeoutMs = 4e3) {
     return null;
   }
 }
+async function defaultRunMinRequiredGlobalInstall(ctx) {
+  if (process.env.SILUZAN_SKIP_AUTO_GLOBAL_INSTALL === "1") {
+    return { ok: false, stderr: "SILUZAN_SKIP_AUTO_GLOBAL_INSTALL=1" };
+  }
+  const spec = `${ctx.pkgName}@${ctx.tag}`;
+  return await new Promise((resolve32) => {
+    const child = spawn("npm", ["install", "-g", spec, "--no-fund", "--no-audit"], {
+      stdio: "inherit",
+      shell: true
+    });
+    child.on("error", (err) => {
+      resolve32({ ok: false, stderr: err instanceof Error ? err.message : String(err) });
+    });
+    child.on("close", (code, signal) => {
+      if (code === 0) {
+        resolve32({ ok: true });
+      } else {
+        const sig = signal ? ` signal=${signal}` : "";
+        resolve32({ ok: false, stderr: `exit code ${code}${sig}` });
+      }
+    });
+  });
+}
 function createVersionNotifier(opts) {
   const {
     pkgName,
@@ -2383,6 +2407,7 @@ function createVersionNotifier(opts) {
     resolveTag,
     forceUpdateExtra = "",
     updateAvailableExtra = "",
+    runMinRequiredGlobalInstall = defaultRunMinRequiredGlobalInstall,
     getCurrentVersion: getCurrentVersion22,
     mergeWriteConfig,
     readConfigRaw
@@ -2430,11 +2455,26 @@ function createVersionNotifier(opts) {
         await mergeWriteConfig({ [KEY_LAST_NOTIFIED]: (/* @__PURE__ */ new Date()).toISOString() });
         console.log(
           `
-[SILUZAN_FORCE_UPDATE] \u5F53\u524D\u7248\u672C ${current} \u5DF2\u8FC7\u671F\uFF0C\u6700\u4F4E\u8981\u6C42\u7248\u672C ${minRequired}${tagLabel}
-\u26D4 \u5FC5\u987B\u5148\u5347\u7EA7\u624D\u80FD\u7EE7\u7EED\u4F7F\u7528\uFF0CAgent \u8BF7\u7ACB\u5373\u6267\u884C\uFF1A${binName} update
-   \u6216\u624B\u52A8\uFF1Anpm install -g ${pkgName}@${tag}
+[SILUZAN_FORCE_UPDATE] \u5F53\u524D\u7248\u672C ${current} \u5DF2\u4F4E\u4E8E\u6700\u4F4E\u8981\u6C42 ${minRequired}${tagLabel}
+\u26D4 \u6B63\u5728\u81EA\u52A8\u6267\u884C\uFF1Anpm install -g ${pkgName}@${tag}
 ` + (forceUpdateExtra ? forceUpdateExtra + "\n" : "")
         );
+        const installResult = await runMinRequiredGlobalInstall({ pkgName, tag });
+        if (installResult.ok) {
+          console.log(
+            `
+[SILUZAN_AUTO_GLOBAL_INSTALL_OK] \u5168\u5C40\u5B89\u88C5\u5DF2\u5B8C\u6210\uFF0C\u8BF7\u91CD\u65B0\u8FD0\u884C\u672C\u547D\u4EE4\u4EE5\u52A0\u8F7D\u65B0\u7248\u672C ${pkgName}@${tag}\u3002
+`
+          );
+        } else {
+          console.log(
+            `
+[SILUZAN_AUTO_GLOBAL_INSTALL_FAILED] \u81EA\u52A8\u5168\u5C40\u5B89\u88C5\u5931\u8D25\uFF1A${installResult.stderr ?? "unknown"}
+\u8BF7\u624B\u52A8\u6267\u884C\uFF1Anpm install -g ${pkgName}@${tag}
+\u6216\uFF1A${binName} update
+` + (forceUpdateExtra ? forceUpdateExtra + "\n" : "")
+          );
+        }
         return;
       }
       if (latest && isNewer(current, latest)) {
@@ -16403,7 +16443,7 @@ async function runAccountShareDetail(opts) {
 
 // src/commands/account-manage/oauth.ts
 init_auth();
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 function toApiMediaType(media) {
   return media === "Meta" ? "FacebookAds" : media;
 }
@@ -16414,17 +16454,17 @@ function tryOpenBrowser(url) {
       return false;
     }
     if (process.platform === "win32") {
-      const child = spawn("rundll32", ["url.dll,FileProtocolHandler", parsed.toString()], {
+      const child = spawn2("rundll32", ["url.dll,FileProtocolHandler", parsed.toString()], {
         detached: true,
         stdio: "ignore",
         windowsHide: true
       });
       child.unref();
     } else if (process.platform === "darwin") {
-      const child = spawn("open", [parsed.toString()], { detached: true, stdio: "ignore" });
+      const child = spawn2("open", [parsed.toString()], { detached: true, stdio: "ignore" });
       child.unref();
     } else {
-      const child = spawn("xdg-open", [parsed.toString()], { detached: true, stdio: "ignore" });
+      const child = spawn2("xdg-open", [parsed.toString()], { detached: true, stdio: "ignore" });
       child.unref();
     }
     return true;

package/dist/skill/SKILL.md

@@ -26,7 +26,7 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令时存在兼容性问题。若上述命令异常失败，请先安装 [Git for Windows](https://git-scm.com/download/win)，然后在 Git Bash 中执行 macOS / Linux / WSL 的 Bash 安装命令。
 
-参照 `references/setup.md` 完成安装与配置。
+参照 `references/setup.md` 完成安装与配置。**需登录或我方 401 换凭据时，优先引导「手机号 + 验证码」**（`send-login-code` → `login --phone --code`），详见 `references/setup.md` 登录优先级说明。
 
 ---
 
@@ -34,7 +34,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 
 | 文档 | 功能 |
 |------|------|
-| `references/setup.md` | 安装、登录、配置、环境切换、更新 |
+| `references/setup.md` | 安装、**登录（手机验证码优先）**、配置、环境切换、更新 |
 | `references/workflows.md` | 多步骤业务流程、跨命令串联 |
 | `references/tips.md` | **Agent 拉数一律 `--json-out`**（目录或 `*.json` 文件）+ 读 `cli-manifest[-<查询id>].json` / 各 `<section>[-<查询id>].json` + **`*.outline.txt`**（TS 式类型，**几百字节，描述完整字段结构**——写聚合脚本前先读它而不是 `Read` 整个 JSON，省 2~3 个数量级 context）；stdout 一行摘要含 `manifestFile` / `writtenFiles` / `outlineFile` 等 |
 | `references/accounts.md` | 账户列表、余额、消耗、开户记录、授权/解绑/分享/MCC/BC/BM/邮箱授权 |
@@ -147,7 +147,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 2. 中断后**必须**用 `resume --run-id <id>` 续跑，**禁止**重新 `run`。
 3. stdout 始终是单行 JSON（`kind=siluzan-tso-batch-summary`）；进度读 `progress.json`、轨迹读 `state/tasks.jsonl`。
 4. 退出码：`0` 全成功 / `2` 部分成功 / `3` 全失败或 Token 失效 / `4` 用法错误。
-5. 401 响应 → 整批终止 + `tokenInvalidated:true`，提示用户重新登录`references/setup.md` 后再 resume。
+5. 401 响应 → 整批终止 + `tokenInvalidated:true`，提示用户按 `references/setup.md` **优先手机验证码**重新登录后再 `resume`。
 
 若无批量命令（如 117 个 Bing 账户剩余天数计算）：先 `list-accounts --json-out <dir>` 一次性拿全量 → `node -e` 本地计算 → 只对命中账户做后续操作。
 
@@ -244,7 +244,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 ### 常见 HTTP 状态码
 
 - **400**：参数错误，查看对应 reference 或用 `-h` 了解命令用法
-- **401**：平台方返回则需用户重新授权；我方返回则让用户执行 `siluzan-tso login`
+- **401**：平台方返回则需用户重新授权；**我方凭据失效**则优先 **`send-login-code` + `login --phone --code`**（或 TTY 下 `siluzan-tso login` / `config set …`），见 `references/setup.md`
 - **500**：服务可能正在部署/升级，建议提交给 Siluzan 相关人员
 
 ### 报告模板外部资源

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.18-beta.5",
-  "publishedAt": 1778322175468
+  "version": "1.1.18-beta.6",
+  "publishedAt": 1778324246028
 }

package/dist/skill/references/accounts.md

@@ -1,7 +1,5 @@
 # 账户管理命令详解
 
-> 所属 skill：`siluzan-tso`。通用选项 `--token <token>` 可覆盖配置文件中的 Token（通常无需传，直接使用 `siluzan-tso login` 保存的配置）。
-
 ---
 
 ## list-accounts — 查询广告账户列表

package/dist/skill/references/setup.md

@@ -40,8 +40,11 @@ siluzan-tso init -d /path/to-your/skills       # 写入自定义目录
 
 `siluzan-tso` 与 `siluzan-cso` **共用同一份凭据**，存储在 `~/.siluzan/config.json`，配置一次两个 CLI 均可使用。
 
+> **登录方式优先级**  
+> 1. **首选**：**手机号 + 短信验证码**两段式（`send-login-code` → `login --phone --code`）——无 TTY 不卡死、不依赖浏览器里复制 API Key，**对话式 AI / OpenClaw / CI 日志旁路**均适用。  
 
-### 通过手机号 + 验证码登录（对话式 AI 推荐）
+
+### 通过手机号 + 验证码登录（**首选**；对话式 AI / 无 TTY 与各 Agent 环境）
 
 **两段式调用**，专为 AI Agent 设计——任何一步都不会进入交互等待，绝不会卡住 stdout。
 拆分后单一职责：第 1 步只发码；第 2 步只用 code 换 API Key。这样 Agent 不会因为"看到 stdout 卡住就重试"而触发短信轰炸。
@@ -51,13 +54,12 @@ siluzan-tso init -d /path/to-your/skills       # 写入自定义目录
 | 1 | `siluzan-tso send-login-code --phone <手机号>` | 仅向手机发送 6 位验证码 |
 | 2 | `siluzan-tso login --phone <手机号> --code <验证码>` | 用 code 完成登录并自动签发 API Key 写入 `~/.siluzan/config.json` |
 
-## 其他方式登录
+## 其它登录方式（TTY 交互 / 已有 API Key / JWT）
+
 ```bash
-siluzan-tso login                                    # 交互式登录，按提示创建 API Key 后粘贴
+siluzan-tso login                                    # 交互式登录（需 TTY），按提示创建 API Key 后粘贴
 siluzan-tso login --api-key <YOUR_API_KEY>           # 直接设置 API Key（跳过交互）
-siluzan-tso send-login-code --phone 138xxxx          # 两段式登录第 1 步：发送短信验证码
-siluzan-tso login --phone 138xxxx --code 123456      # 两段式登录第 2 步：用验证码完成登录
-siluzan-tso config set --api-key <Key>               # 或通过 config set 直接写入
+siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.18-beta.5",
+  "version": "1.1.18-beta.6",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",