siluzan-tso-cli 1.1.18-beta.1 → 1.1.18-beta.2

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.18-beta.1），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.18-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -2913,23 +2913,15 @@ async function createApiKeyByBearer(opts) {
   }
   return data;
 }
-async function runPhoneLoginAndIssueApiKey(opts) {
-  const sendResult = await sendPhoneLoginCode({
-    ssoBaseUrl: opts.ssoBaseUrl,
-    phone: opts.phone,
-    verbose: opts.verbose
-  });
-  if (!sendResult.ok) {
-    throw new Error(`\u77ED\u4FE1\u9A8C\u8BC1\u7801\u53D1\u9001\u5931\u8D25\uFF1A${sendResult.message || "(\u540E\u7AEF\u672A\u8FD4\u56DE\u539F\u56E0)"}`);
-  }
-  const code = await opts.getCode();
+async function issueApiKeyWithPhoneCode(opts) {
+  const code = opts.code?.trim() ?? "";
   if (!code) {
-    throw new Error("\u5DF2\u53D6\u6D88\uFF08\u672A\u8F93\u5165\u9A8C\u8BC1\u7801\uFF09");
+    throw new Error("\u9A8C\u8BC1\u7801\u4E0D\u80FD\u4E3A\u7A7A");
   }
   const tokenInfo = await loginByPhoneCode({
     ssoBaseUrl: opts.ssoBaseUrl,
     phone: opts.phone,
-    code: code.trim(),
+    code,
     verbose: opts.verbose
   });
   const apiKey = await createApiKeyByBearer({
@@ -16447,15 +16439,53 @@ function defaultApiKeyName() {
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   return `CLI - ${host} - ${today}`;
 }
-async function runPhoneLogin(opts) {
-  const rawPhone = opts.phone?.trim() ?? "";
+function validateAndNormalizePhone(rawInput) {
+  const rawPhone = rawInput?.trim() ?? "";
   if (!isValidChinaPhone(rawPhone)) {
     console.error(
       "\n\u274C \u624B\u673A\u53F7\u683C\u5F0F\u9519\u8BEF\uFF1A\u4EC5\u652F\u6301\u4E2D\u56FD\u5927\u9646\u624B\u673A\u53F7\uFF0C\u53EF\u5E26\u6216\u4E0D\u5E26 +86\uFF08\u5982 13800138000 / +8613800138000\uFF09\u3002\n"
     );
     process.exit(1);
   }
-  const phone = normalizeChinaPhone(rawPhone);
+  return normalizeChinaPhone(rawPhone);
+}
+async function runSendLoginCode(opts) {
+  const phone = validateAndNormalizePhone(opts.phone);
+  const tsoApiBase = process.env.SILUZAN_TSO_API_BASE ?? DEFAULT_API_BASE;
+  const ssoBaseUrl = deriveSsoBaseUrl(tsoApiBase);
+  console.log("\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+  console.log("  Siluzan \u53D1\u9001\u767B\u5F55\u77ED\u4FE1\u9A8C\u8BC1\u7801");
+  console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
+  console.log(`  \u624B\u673A\u53F7 : ${phone}`);
+  console.log(`  SSO    : ${ssoBaseUrl}
+`);
+  console.log("\u2192 \u6B63\u5728\u5411\u624B\u673A\u53D1\u9001\u9A8C\u8BC1\u7801...");
+  const r = await sendPhoneLoginCode({ ssoBaseUrl, phone, verbose: opts.verbose });
+  if (!r.ok) {
+    console.error(`
+\u274C \u77ED\u4FE1\u9A8C\u8BC1\u7801\u53D1\u9001\u5931\u8D25\uFF1A${r.message || "(\u540E\u7AEF\u672A\u8FD4\u56DE\u539F\u56E0)"}
+`);
+    process.exit(1);
+  }
+  console.log(`\u2713 \u9A8C\u8BC1\u7801\u5DF2\u53D1\u9001\uFF0810 \u5206\u949F\u5185\u6709\u6548\uFF09\u3002
+`);
+  console.log("\u4E0B\u4E00\u6B65\uFF1A\u62FF\u5230 6 \u4F4D\u9A8C\u8BC1\u7801\u540E\uFF0C\u8FD0\u884C\u4E0B\u9762\u7684\u547D\u4EE4\u5B8C\u6210\u767B\u5F55\uFF1A\n");
+  console.log(`  siluzan-tso login --phone ${phone} --code <6\u4F4D\u9A8C\u8BC1\u7801>
+`);
+  console.log("\u53EF\u9009\u53C2\u6570\uFF1A--name / --valid-days / --expires-at / --services");
+  console.log("\uFF08\u9ED8\u8BA4\u521B\u5EFA 90 \u5929\u6709\u6548\u3001\u52FE\u9009 TSO + CUT \u670D\u52A1\u7684 API Key\uFF09\n");
+}
+async function runPhoneLogin(opts) {
+  const phone = validateAndNormalizePhone(opts.phone);
+  const code = opts.code?.trim() ?? "";
+  if (!code) {
+    console.error("\n\u274C \u7F3A\u5C11 --code \u53C2\u6570\u3002\u624B\u673A\u53F7\u767B\u5F55\u662F\u4E24\u6BB5\u5F0F\u8C03\u7528\uFF0C\u8BF7\u6309\u987A\u5E8F\u6267\u884C\uFF1A\n");
+    console.error(`  1) siluzan-tso send-login-code --phone ${phone}`);
+    console.error(`  2) siluzan-tso login --phone ${phone} --code <\u6536\u5230\u76846\u4F4D\u9A8C\u8BC1\u7801>
+`);
+    console.error("\uFF08\u62C6\u6210\u4E24\u6B65\u662F\u4E3A\u4E86\u907F\u514D AI Agent \u5361\u5728\u4EA4\u4E92\u8F93\u5165\u65F6\u53CD\u590D\u91CD\u8BD5\u5BFC\u81F4\u77ED\u4FE1\u8F70\u70B8\uFF09\n");
+    process.exit(1);
+  }
   let allowedServices;
   try {
     allowedServices = parseAllowedServices(opts.services);
@@ -16472,10 +16502,12 @@ async function runPhoneLogin(opts) {
   const tsoApiBase = process.env.SILUZAN_TSO_API_BASE ?? DEFAULT_API_BASE;
   const ssoBaseUrl = deriveSsoBaseUrl(tsoApiBase);
   const csoBaseUrl = deriveCsoApiBaseUrl(tsoApiBase);
+  const apiKeyName = opts.name ?? defaultApiKeyName();
   console.log("\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
   console.log("  Siluzan \u767B\u5F55\uFF08\u624B\u673A\u53F7 + \u77ED\u4FE1\u9A8C\u8BC1\u7801\uFF09");
   console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
   console.log(`  \u624B\u673A\u53F7       : ${phone}`);
+  console.log(`  \u9A8C\u8BC1\u7801       : ${code}`);
   console.log(`  SSO          : ${ssoBaseUrl}`);
   console.log(`  CSO API      : ${csoBaseUrl}`);
   console.log(`  \u670D\u52A1\u8303\u56F4     : ${allowedServices.join(", ")}`);
@@ -16484,40 +16516,20 @@ async function runPhoneLogin(opts) {
   } else {
     console.log(`  \u6709\u6548\u671F       : ${opts.validDays ?? 90} \u5929`);
   }
-  const apiKeyName = opts.name ?? defaultApiKeyName();
   console.log(`  API Key \u540D\u79F0 : ${apiKeyName}
 `);
-  console.log("\u2192 \u6B63\u5728\u5411\u624B\u673A\u53D1\u9001\u9A8C\u8BC1\u7801...");
+  console.log("\u2192 \u6B63\u5728\u6821\u9A8C\u9A8C\u8BC1\u7801\u5E76\u521B\u5EFA API Key...");
   try {
-    const created = await runPhoneLoginAndIssueApiKey({
+    const created = await issueApiKeyWithPhoneCode({
       ssoBaseUrl,
       csoBaseUrl,
       phone,
+      code,
       apiKeyName,
       validDays: opts.expiresAt ? void 0 : opts.validDays ?? 90,
       expiresAt: opts.expiresAt,
       allowedServices,
-      verbose: opts.verbose,
-      getCode: async () => {
-        if (opts.code !== void 0) {
-          const trimmed = opts.code.trim();
-          if (!trimmed) {
-            console.error("\u274C --code \u4E0D\u80FD\u4E3A\u7A7A\u3002");
-            return null;
-          }
-          console.log(`\u2713 \u9A8C\u8BC1\u7801\u5DF2\u53D1\u9001\uFF0C\u4F7F\u7528\u547D\u4EE4\u884C\u4F20\u5165\u7684 code\uFF08${trimmed}\uFF09\u3002`);
-          return trimmed;
-        }
-        console.log("\u2713 \u9A8C\u8BC1\u7801\u5DF2\u53D1\u9001\uFF0810 \u5206\u949F\u5185\u6709\u6548\uFF09\u3002");
-        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
-        const input = await new Promise(
-          (res) => rl.question("\u8BF7\u8F93\u5165\u6536\u5230\u7684 6 \u4F4D\u9A8C\u8BC1\u7801\uFF1A", (a) => {
-            rl.close();
-            res(a.trim());
-          })
-        );
-        return input || null;
-      }
+      verbose: opts.verbose
     });
     writeSharedConfig({ apiKey: created.rawKey });
     console.log("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
@@ -16545,7 +16557,16 @@ async function runPhoneLogin(opts) {
         `
   \u8BE5\u624B\u673A\u53F7\u5C1A\u672A\u6CE8\u518C\u4E1D\u8DEF\u8D5E\u8D26\u53F7\u3002\u8BF7\u5148\u5728\u7F51\u9875\u7AEF\u6CE8\u518C\uFF1A
     ${WEB_BASE_URL}
-  \u6CE8\u518C\u6210\u529F\u540E\u518D\u56DE\u5230 CLI \u91CD\u8BD5 siluzan-tso login --phone ${phone}
+  \u6CE8\u518C\u6210\u529F\u540E\u518D\u56DE\u5230 CLI \u91CD\u8BD5\u4E24\u6BB5\u5F0F\u767B\u5F55\uFF1A
+    siluzan-tso send-login-code --phone ${phone}
+    siluzan-tso login --phone ${phone} --code <6\u4F4D\u9A8C\u8BC1\u7801>
+`
+      );
+    } else if (/验证码错误|验证码/.test(msg)) {
+      console.error(
+        `
+  \u9A8C\u8BC1\u7801\u53EF\u80FD\u5DF2\u8FC7\u671F\u6216\u8F93\u9519\u3002\u8BF7\u91CD\u65B0\u53D1\u7801\u540E\u518D\u8BD5\uFF1A
+    siluzan-tso send-login-code --phone ${phone}
 `
       );
     }
@@ -16664,15 +16685,22 @@ program.hook("preAction", async () => {
   setWriteAuditCliCommit(extractCommitFromArgv(process.argv.slice(2)));
   setCliInvocationForAudit(process.argv.slice(2));
   const activeCmd = process.argv[2];
-  if (activeCmd !== "update" && activeCmd !== "login" && activeCmd !== "audit") {
+  if (activeCmd !== "update" && activeCmd !== "login" && activeCmd !== "send-login-code" && activeCmd !== "audit") {
     await notifyIfOutdated().catch(() => {
     });
   }
 });
-program.command("login").description("\u4FDD\u5B58\u8BA4\u8BC1\u51ED\u636E\u5230 ~/.siluzan/config.json\uFF08API Key / \u624B\u673A\u53F7\u9A8C\u8BC1\u7801 / \u4EA4\u4E92\u5F0F\u4E09\u9009\u4E00\uFF09").option("--api-key <key>", "\u76F4\u63A5\u4FDD\u5B58 API Key\uFF08\u5728\u4E1D\u8DEF\u8D5E\u300C\u8BBE\u7F6E \u2192 API Key \u7BA1\u7406\u300D\u521B\u5EFA\uFF09\uFF0C\u6700\u9AD8\u4F18\u5148\u7EA7").option(
+program.command("send-login-code").description(
+  "\u5411\u624B\u673A\u53D1\u9001 SSO_LOGIN \u77ED\u4FE1\u9A8C\u8BC1\u7801\uFF08\u624B\u673A\u53F7\u767B\u5F55\u7684\u7B2C\u4E00\u6B65\uFF09\uFF1B\u7ACB\u5373\u8FD4\u56DE\uFF0C\u65E0\u4EFB\u4F55\u4EA4\u4E92\u3002\n  \u6536\u5230\u9A8C\u8BC1\u7801\u540E\u7528 `siluzan-tso login --phone xxx --code xxx` \u5B8C\u6210\u767B\u5F55\u3002"
+).requiredOption(
   "--phone <phone>",
-  "11 \u4F4D\u624B\u673A\u53F7\uFF1B\u89E6\u53D1\u77ED\u4FE1\u9A8C\u8BC1\u7801\u767B\u5F55\u5E76\u81EA\u52A8\u7B7E\u53D1 API Key\uFF08\u9700\u624B\u673A\u53F7\u5DF2\u5728\u4E1D\u8DEF\u8D5E\u6CE8\u518C\uFF09"
-).option("--code <code>", "\u77ED\u4FE1\u9A8C\u8BC1\u7801\uFF1B\u4E0E --phone \u914D\u5408\u4F7F\u7528\uFF0C\u8DF3\u8FC7\u4EA4\u4E92\u5F0F\u8F93\u5165").option("--name <name>", "\u81EA\u52A8\u521B\u5EFA\u7684 API Key \u540D\u79F0\uFF0C\u9ED8\u8BA4 `CLI - <hostname> - <yyyy-MM-dd>`").option("--valid-days <days>", "API Key \u6709\u6548\u671F\uFF08\u5929\uFF09\uFF0C\u9ED8\u8BA4 90", (v) => parseInt(v, 10)).option("--expires-at <iso8601>", "API Key \u7EDD\u5BF9\u8FC7\u671F\u65F6\u95F4\uFF08ISO 8601\uFF09\uFF0C\u4E0E --valid-days \u4E8C\u9009\u4E00").option(
+  "\u4E2D\u56FD\u5927\u9646\u624B\u673A\u53F7\uFF0C\u53EF\u5E26\u6216\u4E0D\u5E26 +86\uFF08\u5982 13800138000 / +8613800138000\uFF09"
+).option("--verbose", "\u8F93\u51FA\u6BCF\u6B21 HTTP \u8BF7\u6C42 URL\uFF08\u8C03\u8BD5\u7528\uFF09").action(async (opts) => {
+  await runSendLoginCode({ phone: opts.phone, verbose: opts.verbose });
+});
+program.command("login").description(
+  "\u4FDD\u5B58\u8BA4\u8BC1\u51ED\u636E\u5230 ~/.siluzan/config.json\uFF1A\n  \xB7 --api-key <key>                 \u76F4\u63A5\u4FDD\u5B58 API Key\uFF08CI/CD \u63A8\u8350\uFF09\n  \xB7 --phone <\u624B\u673A\u53F7> --code <\u9A8C\u8BC1\u7801>  \u4E24\u6BB5\u5F0F\u767B\u5F55\u7B2C\u4E8C\u6B65\uFF08\u5148\u8C03 send-login-code\uFF09\n  \xB7 \u65E0\u53C2\u6570                           \u4EA4\u4E92\u5F0F\u5F15\u5BFC\u7528\u6237\u53BB\u7F51\u9875\u7C98\u8D34 API Key"
+).option("--api-key <key>", "\u76F4\u63A5\u4FDD\u5B58 API Key\uFF08\u5728\u4E1D\u8DEF\u8D5E\u300C\u8BBE\u7F6E \u2192 API Key \u7BA1\u7406\u300D\u521B\u5EFA\uFF09\uFF0C\u6700\u9AD8\u4F18\u5148\u7EA7").option("--phone <phone>", "\u4E2D\u56FD\u5927\u9646\u624B\u673A\u53F7\uFF0C\u9700\u914D\u5408 --code \u4E00\u8D77\u4F7F\u7528\uFF08\u5FC5\u987B\u5148\u8C03 send-login-code \u53D1\u7801\uFF09").option("--code <code>", "\u77ED\u4FE1\u9A8C\u8BC1\u7801\uFF086 \u4F4D\uFF09\uFF1B\u4E0E --phone \u4E00\u8D77\u5FC5\u586B").option("--name <name>", "\u81EA\u52A8\u521B\u5EFA\u7684 API Key \u540D\u79F0\uFF0C\u9ED8\u8BA4 `CLI - <hostname> - <yyyy-MM-dd>`").option("--valid-days <days>", "API Key \u6709\u6548\u671F\uFF08\u5929\uFF09\uFF0C\u9ED8\u8BA4 90", (v) => parseInt(v, 10)).option("--expires-at <iso8601>", "API Key \u7EDD\u5BF9\u8FC7\u671F\u65F6\u95F4\uFF08ISO 8601\uFF09\uFF0C\u4E0E --valid-days \u4E8C\u9009\u4E00").option(
   "--services <list>",
   "API Key \u53EF\u8BBF\u95EE\u7684\u670D\u52A1\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u53EF\u9009 CSO/TSO/CUT\uFF0C\u9ED8\u8BA4 `TSO,CUT`"
 ).option("--manual", "\u4EA4\u4E92\u5F0F\u7C98\u8D34 JWT Token\uFF08\u65E0 API Key \u65F6\u4F7F\u7528\uFF0C\u5DF2\u5E9F\u5F03\uFF09").option("--verbose", "\u8F93\u51FA\u6BCF\u6B21 HTTP \u8BF7\u6C42 URL\uFF08\u8C03\u8BD5\u7528\uFF09").action(

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.18-beta.1",
-  "publishedAt": 1778315223329
+  "version": "1.1.18-beta.2",
+  "publishedAt": 1778317442558
 }

package/dist/skill/references/setup.md

@@ -43,7 +43,8 @@ siluzan-tso init -d /path/to-your/skills       # 写入自定义目录
 ```bash
 siluzan-tso login                                    # 交互式登录，按提示创建 API Key 后粘贴
 siluzan-tso login --api-key <YOUR_API_KEY>           # 直接设置 API Key（跳过交互）
-siluzan-tso login --phone 138xxxx                    # 手机号 + 短信验证码登录（自动签发并保存 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 --token <Token>               # 备用：设置 JWT Token
 ```
@@ -52,34 +53,43 @@ API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/api
 
 ### 通过手机号 + 验证码登录（对话式 AI 推荐）
 
-适合让 AI 助手在对话里直接帮用户完成登录：用户报手机号 → AI 调 `siluzan-tso login --phone <号码>` → 用户报到的验证码 → AI 用 `--phone <号码> --code <验证码>` 一次性完成签发；签发成功的 API Key 会自动写入 `~/.siluzan/config.json`，后续命令直接复用。
+**两段式调用**，专为 AI Agent 设计——任何一步都不会进入交互等待，绝不会卡住 stdout。
+拆分后单一职责：第 1 步只发码；第 2 步只用 code 换 API Key。这样 Agent 不会因为"看到 stdout 卡住就重试"而触发短信轰炸。
+
+| 步骤 | 命令 | 说明 |
+| ---- | ---- | ---- |
+| 1 | `siluzan-tso send-login-code --phone <手机号>` | 仅向手机发送 6 位验证码，立即返回；**绝不创建 API Key** |
+| 2 | `siluzan-tso login --phone <手机号> --code <验证码>` | 用 code 完成登录并自动签发 API Key 写入 `~/.siluzan/config.json` |
 
 ```bash
-# 第 1 次调用：发送验证码（命令会进入交互式等输入验证码）
-siluzan-tso login --phone 13800138000
+# 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
+siluzan-tso send-login-code --phone 13800138000
 
-# 第 2 次调用：用户告诉 AI 收到的验证码后，一次性把 phone+code 都传进去（AI 推荐用法）
+# 第 2 步：让用户读出收到的 6 位验证码，再调登录命令
 siluzan-tso login --phone 13800138000 --code 123456
 
-# 自定义自动创建的 API Key 名称、有效期、可访问的服务
+# 自定义 API Key 名称 / 有效期 / 服务范围
 siluzan-tso login --phone 13800138000 --code 123456 \
   --name "Cursor - my-mac - 2026" \
   --valid-days 30 \
   --services TSO,CUT
 ```
 
-| 参数             | 说明                                                                              | 默认值                              |
-| ---------------- | --------------------------------------------------------------------------------- | ----------------------------------- |
-| `--phone`        | 11 位中国大陆手机号；触发短信验证码流程；**手机号必须已在丝路赞网页端注册**         | 必填                                |
-| `--code`         | 6 位短信验证码；不传则进入交互式提示输入                                          | 交互式输入                          |
-| `--name`         | 自动创建的 API Key 显示名称                                                       | `CLI - <hostname> - <yyyy-MM-dd>`   |
-| `--valid-days`   | API Key 有效期（天），与 `--expires-at` 二选一                                    | `90`                                |
-| `--expires-at`   | API Key 绝对过期时间（ISO 8601）                                                  | 不传则用 `--valid-days`             |
-| `--services`     | 可访问的服务列表，逗号分隔；可选 `CSO`/`TSO`/`CUT`                                | `TSO,CUT`（广告投放 + 素材中心）    |
-| `--verbose`      | 输出每次 HTTP 请求的 URL，便于排错                                                | 关闭                                |
-
-> **未注册手机号** 会返回 `❌ 登录失败：手机未注册` 并附带网页注册地址，引导用户先去网页注册再回来重试。
-> **AI 助手用法**：第一次只把 `--phone` 传进去触发发码；用户在对话里报了验证码后，**重新调用并同时传 `--phone` + `--code`**，避免被交互式 prompt 卡住。
+| 参数 | 命令 | 说明 | 默认值 |
+| ---- | ---- | ---- | ---- |
+| `--phone` | 两个命令都需要 | 中国大陆手机号，可带或不带 +86（如 `13800138000` / `+8613800138000`）；底层会自动补 `+86` 前缀；**手机号必须已在丝路赞网页端注册** | 必填 |
+| `--code` | 仅 `login` | 6 位短信验证码（来自第 1 步发码后的短信）；**login 命令必填**，未传会直接报错指引重新走两段式 | 必填（login 命令） |
+| `--name` | 仅 `login` | 自动创建的 API Key 显示名称 | `CLI - <hostname> - <yyyy-MM-dd>` |
+| `--valid-days` | 仅 `login` | API Key 有效期（天），与 `--expires-at` 二选一 | `90` |
+| `--expires-at` | 仅 `login` | API Key 绝对过期时间（ISO 8601） | 不传则用 `--valid-days` |
+| `--services` | 仅 `login` | 可访问的服务列表，逗号分隔；可选 `CSO`/`TSO`/`CUT` | `TSO,CUT`（广告投放 + 素材中心） |
+| `--verbose` | 两个命令都支持 | 输出每次 HTTP 请求的 URL，便于排错 | 关闭 |
+
+> **未注册手机号**：`login` 第 2 步会返回 `❌ 登录失败：手机未注册` 并附带网页注册地址，引导用户先去网页注册再回来重试两段式。
+>
+> **验证码错误/过期**：返回明确提示，让用户重新跑 `send-login-code` 拿新验证码。
+>
+> **AI 助手用法**：先调 `send-login-code` 发码、立即返回继续对话；等用户报出收到的验证码后，再调 `login --phone xxx --code xxx` 完成登录。**永远不要在没拿到 `--code` 的情况下调用 `login --phone xxx`，那会直接报错。**
 
 ### 通过环境变量传入凭据（CI/CD 推荐）
 

package/package.json

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