@optima-chat/dev-skills 0.16.7 → 0.16.9

package/.codex/skills/yzsgo-e2e/pull_wire.py

@@ -169,6 +169,19 @@ def render_conversation(conv, resps, deref, idx):
                         res_ids.add(b.get("tool_use_id"))
     dangling = [(u, n) for u, n in use_ids.items() if u not in res_ids]
 
+    # 末 response 状态：审查靠它判「最终回复能不能核」。缺失时**必须显式标注**，
+    # 否则 transcript 静默停在末条 user 消息（常是超长 tool_result 截断处），
+    # 会被误读成「响应被截断吞了」（上游 #102 真根因：不是截断，是末 req 无 response 记录）。
+    lastresp = resps.get(last["callId"])
+    if not lastresp:
+        last_state = "⚠️ 末 request 无 response 记录（生成中断/未落盘/末轮是 continuation）——最终回复不可核"
+    elif lastresp.get("kind") == "error":
+        last_state = "⚠️ 末 response 是 error：" + json.dumps(deref(lastresp.get("error") or {}), ensure_ascii=False)[:160]
+    elif (lastresp.get("finalMessage") or {}).get("stopReason") == "max_tokens":
+        last_state = "⚠️ 末 response stop_reason=max_tokens（回复被截断，可能未说完）"
+    else:
+        last_state = "有（正常 response）"
+
     L = [f"# 对话 #{idx}  {ts0}",
          "", f"**prompt**: {prompt[:200]}", "",
          "## 事实卡（代码算的确定信息）",
@@ -176,9 +189,9 @@ def render_conversation(conv, resps, deref, idx):
          f"- error 响应 {len(errs)}" + (f"：{[json.dumps(deref(e.get('error') or {}),ensure_ascii=False)[:120] for e in errs]}" if errs else ""),
          f"- stop_reason=max_tokens 的响应 {maxtok}",
          f"- 悬空 tool_use（无匹配 result）{len(dangling)}: {dangling[:5]}",
+         f"- 末 response: {last_state}",
          "", "## 完整 transcript（末 req 全历史 + 末 response）", ""]
-    # 末 response 拼到历史尾
-    lastresp = resps.get(last["callId"])
+    # 末 response 拼到历史尾（仅 response 类才有 finalMessage 内容可拼）
     if lastresp and lastresp.get("kind") == "response":
         fm = lastresp.get("finalMessage") or {}
         msgs.append({"role": "assistant", "content": fm.get("content", [])})
@@ -190,8 +203,15 @@ def render_conversation(conv, resps, deref, idx):
             L.append("    " + _clip(c, CAP_TEXT))
         elif isinstance(c, list):
             for b in c:
-                L.append(render_block(b, deref))
-    return prompt, ts0, len(errs), len(dangling), "\n".join(L)
+                try:
+                    L.append(render_block(b, deref))
+                except Exception as e:  # 单个块渲染失败不该中断后续消息（上游 #102 加固）
+                    L.append(f"    [渲染失败 {type(e).__name__}: {str(e)[:80]}]")
+    # transcript 结尾显式收口——末 response 非正常时补一行，让审查者绝不把静默结束当完整
+    resp_ok = bool(lastresp and lastresp.get("kind") == "response")
+    if not resp_ok:
+        L.append(f"\n--- [transcript 结束] {last_state} ---")
+    return prompt, ts0, len(errs), len(dangling), resp_ok, "\n".join(L)
 
 
 def render_all(wire_root, out):
@@ -214,10 +234,10 @@ def render_all(wire_root, out):
         index.append(f"\n## session `{sid}` — {len(convs)} 对话 / {len(reqs)} req\n")
         for conv in convs:
             gidx += 1
-            prompt, ts0, n_err, n_dang, md = render_conversation(conv, resps, deref, gidx)
+            prompt, ts0, n_err, n_dang, resp_ok, md = render_conversation(conv, resps, deref, gidx)
             fn = f"{gidx:03d}.md"
             open(os.path.join(conv_dir, fn), "w", encoding="utf-8").write(md)
-            flag = (" ⚠️err" if n_err else "") + (" ⚠️dangling" if n_dang else "")
+            flag = (" ⚠️err" if n_err else "") + (" ⚠️dangling" if n_dang else "") + ("" if resp_ok else " ⚠️无末response")
             index.append(f"- [{fn}](conversations/{fn}) [{len(conv):>2} req] {prompt[:64]}{flag}")
     idxpath = os.path.join(out, "index.md")
     open(idxpath, "w", encoding="utf-8").write("\n".join(index))
@@ -278,9 +298,20 @@ def _ts_key(ts):
         return None
 
 
-def locate_conversation(index, started_ts, first_message):
+def locate_conversation(index, started_ts, first_message, session_id=None):
     """按 (started_ts, first_message) 定位本次对话；禁用 ls -t。规则见 plan Task 3 Interfaces。
-    时间比较先把两侧 ISO（Z / +00:00、小数位宽不同）归一成 datetime，避免依赖字典序=数值序的脆弱假设。"""
+    时间比较先把两侧 ISO（Z / +00:00、小数位宽不同）归一成 datetime，避免依赖字典序=数值序的脆弱假设。
+
+    `session_id`（2026-09-09 起，鸭嘴兽支持并发任务后）：驱动侧现在知道自己跑在**哪个 gateway
+    session** 上（一 tab 一 session，wire 目录名就是 sessionId），传进来就先把候选缩到该 session。
+    这是**确定性**定位，比 (时间, 首句) 的启发式可靠得多 —— 同一句 prompt 重跑多次时，
+    启发式只能靠时间戳挑，而并发跑的多个会话时间戳本来就交叠。
+    传了但该 session 在索引里一条都没有（wire 还没落盘/TTL 过期/拉的账号不对）→ **不回退**到
+    全局启发式：那样会安静地定位到别的 session 的对话，比返回 None 更糟。"""
+    if session_id:
+        index = [it for it in index if it.get("sid") == session_id]
+        if not index:
+            return None
     key = (first_message or "").strip()[:40]
     cands = []
     for it in index:

package/.codex/skills/yzsgo-e2e/run_e2e.py

@@ -85,7 +85,21 @@ def main():
 
     started_ts = _utc_now()
     answers = _parse_answers(args.answer)
-    d = chat_driver.ChatDriver().attach()
+    # attach() 默认就自己开 tab 独占一个 gateway session（"auto" 档）。两个好处——
+    #  ① 不去抢用户已经开着的 chat tab（抢了会互相串台，见 chat_driver 模块 docstring）；
+    #  ② 拿到确定的 sessionId，后面按它**确定性**定位 wire 对话，不靠 (时间,首句) 猜。
+    # 该环境 multi-tab 没开（flag 默认关，cn-stage 未验）时 auto 档自己会降级复用已有 tab
+    # 并打 warn —— 单 driver 复用是安全的，功能不减，只是 wire 定位退回启发式。
+    # ziniao 是 attach() 的必填关键字参数（上游 store-skills #611，漏传即 TypeError）：
+    # 本 skill 测的是鸭嘴兽对话链路，这个 tab 不绑定任何紫鸟 profile，所以显式声明 None + 理由。
+    # 若 --message 正文里写了 `--ziniao-profile <id>`，send() 会抛 ZiniaoDeclarationConflict
+    # 拒发 —— 那是上游有意的闸，不是本脚本的 bug。装到 ~/.claude 后已知 profile 表为空
+    # （它读 store-skills 仓库里的 e2e/registry*.yaml），所以只认 `--ziniao-profile` 这种显式写法。
+    d = chat_driver.ChatDriver().attach(
+        ziniao=None, reason="yzsgo-e2e 驱动鸭嘴兽网页对话做端到端测试，本脚本不绑定任何紫鸟 profile")
+    session_id = d.session_id      # attach 后立刻取：放在 try 里的话，中途抛异常会留下未绑定名
+    if not d.tab_isolated:
+        print("[warn] 未能独占 tab（该环境 multi-tab 未开）—— wire 定位退回 (时间,首句) 启发式")
     try:
         d.new_conversation()
         turns = []
@@ -99,13 +113,17 @@ def main():
     wire_root = pull_wire.pull(args.user, since_days=args.since, out=args.out)
     meta = {"env": args.env, "started_ts": started_ts, "first_message": args.message[0],
             "expect": args.expect, "issue_repo": args.issue_repo, "turns": turns,
+            "session_id": session_id,      # 本轮跑在哪个 gateway session（= wire 目录名）
             "located": None, "located_reason": None}
     wrote_prepped = False
     if not wire_root:
         meta["located_reason"] = "no_wire_session"
     if wire_root:
         index = pull_wire.emit_conversation_index(wire_root)
-        hit = pull_wire.locate_conversation(index, started_ts, args.message[0])
+        hit = pull_wire.locate_conversation(index, started_ts, args.message[0],
+                                            session_id=session_id)
+        if session_id and not hit:
+            meta["located_reason"] = f"session {session_id} 在 wire 索引里没有对话（未落盘/TTL 过期/账号不对）"
         meta["located"] = hit
         if hit:
             sdir = os.path.join(wire_root, hit["sid"])
@@ -117,7 +135,10 @@ def main():
             convs = pull_wire.segment(reqs, deref)
             conv = select_conversation_in_session(convs, deref, hit)
             if conv is not None:
-                _, _, _, _, wire_md = pull_wire.render_conversation(conv, resps, deref, hit["gidx"])
+                # 6 元返回（上游 #102 起多了 resp_ok）：末 response 不正常时 wire_md 结尾已显式收口，
+                # 但 meta 也记一份，报告层不必去 grep transcript 才知道「最终回复不可核」。
+                _, _, _, _, resp_ok, wire_md = pull_wire.render_conversation(conv, resps, deref, hit["gidx"])
+                meta["wire_last_response_ok"] = resp_ok
                 prepped = prep_conversation.merge_browser_evidence(wire_md, turns)
                 with open(os.path.join(args.out, "prepped.md"), "w", encoding="utf-8") as f:
                     f.write(prepped)

package/AGENTS.md

@@ -7,7 +7,7 @@ This repository provides shared development skills and CLI helpers for Optima en
 Prefer the installed CLI tools over reimplementing long shell workflows:
 
 - `optima-query-db <service> "<sql>" [environment]`
-- `optima-show-env <service> <stage|prod> [options]`
+- `optima-show-env <service> <stage|prod|cn-prod|cn-stage> [options]`
 - `optima-generate-test-token [options]`
 - `optima-grant-subscription <email> [options]`
 - `optima-grant-credits <email|phone|userId> --credits <n> [options]`

package/bin/cli.js

@@ -32,8 +32,8 @@ switch (command) {
     log('Available Commands:', 'yellow');
     log('  optima-query-db <service> "<sql>" [env]              Query database', 'cyan');
     log('  optima-show-env <service> [env]                      Show service env vars', 'cyan');
-    log('  optima-verify-health <service> [--env cn|prod|all]   Probe L1-L5 上线健康', 'cyan');
-    log('  optima-generate-test-token [--env production]        Generate test token', 'cyan');
+    log('  optima-verify-health <service> [--env stage|prod|cn-prod|cn-stage|all]  Probe L1-L5 上线健康', 'cyan');
+    log('  optima-generate-test-token [--env ci|stage|prod|cn-prod|cn-stage]       Generate test token', 'cyan');
     log('  optima-grant-credits <email|phone|userId> --credits <n> [--env] Grant credits (bonus, 30d)', 'cyan');
     log('  optima-grant-subscription <email|phone|userId> --plan <p> [--env] Grant subscription', 'cyan');
     log('  optima-logs <service> [--env] [--since] [--grep] [-n]  View logs (cn=SLS 直连/aws=CloudWatch)', 'cyan');
@@ -41,7 +41,7 @@ switch (command) {
     log('  /restart-ecs <service> [env]                         Restart ECS service (skill)', 'cyan');
 
     log('\nSupported Services:', 'yellow');
-    log('  commerce-backend  user-auth  mcp-host  agentic-chat  optima-logistics', 'cyan');
+    log('  commerce-backend  user-auth  agentic-chat  optima-logistics', 'cyan');
     log('  session-gateway  optima-scout  billing  browser-backend  optima-generation', 'cyan');
 
     log('\nEnvironments:', 'yellow');

package/bin/helpers/billing-http.ts

@@ -1,4 +1,4 @@
-import { execSync } from 'child_process';
+import { execFileSync } from 'child_process';
 import { fetchInfisicalSecret } from './infisical-secrets';
 import { getInfisicalConfig, getInfisicalToken, getCnInfisicalToken, getCnSecrets, resolveUserId } from './db-utils';
 
@@ -149,8 +149,17 @@ export function getServiceToken(env: string, scope?: string): string {
   const effectiveScope = scope ?? (isCn ? CN_PROD_TOKEN_SCOPE : undefined);
   const scopeParam = effectiveScope ? `&scope=${encodeURIComponent(effectiveScope)}` : '';
   const body = `grant_type=client_credentials&client_id=${encodeURIComponent(clientId)}&client_secret=${encodeURIComponent(clientSecret)}${scopeParam}`;
-  const response = execSync(
-    `curl -s -X POST '${authUrl}/api/v1/oauth/token' -H 'Content-Type: application/x-www-form-urlencoded' -d '${body}'`,
+  // execFileSync + 参数数组（不经 shell）：Windows cmd.exe 不认单引号，shell 拼出的
+  // `-d '${body}'` 会被拆碎、curl 收到垃圾参数直接退出（#92）。数组传参绕开 shell、
+  // 跨平台一致；函数保持同步。
+  const response = execFileSync(
+    'curl',
+    [
+      '-s', '-X', 'POST',
+      `${authUrl}/api/v1/oauth/token`,
+      '-H', 'Content-Type: application/x-www-form-urlencoded',
+      '-d', body,
+    ],
     { encoding: 'utf-8' },
   );
 

package/bin/helpers/cn-deploy.ts

@@ -142,7 +142,8 @@ async function main() {
 
   // 2. 触发(凭证由云效变量组供给,无需注入)。stage/prod 流水线 id 均按名 `${svc}-cn-${env}`
   //    从云效实时解析、不硬编码,根除与 optima-terraform cn-run.py 手工 PIPELINES 表漂移(#84)。
-  const lp = devops('ListPipelines', { maxResults: '100' });
+  // nextToken 自 2026-09 起被 aliyun CLI 标成必填,不传则 API 直接返参数错误 → devops() 吞成 {} → 误报「云效无流水线」。
+  const lp = devops('ListPipelines', { maxResults: '100', nextToken: '0' });
   const hit = (lp.pipelines || []).find((p: any) => p.pipelineName === `${svcName}-cn-${envName}`);
   if (!hit) { console.error(`✗ 云效无 ${svcName}-cn-${envName} 流水线`); process.exit(1); }
   const pipelineId = hit.pipelineId;

package/bin/helpers/db-utils.ts

@@ -81,11 +81,14 @@ export function getInfisicalConfig(): InfisicalConfig {
 }
 
 export function getInfisicalToken(config: InfisicalConfig): string {
-  const response = execSync(
-    `curl -s -X POST "${config.url}/api/v1/auth/universal-auth/login" -H "Content-Type: application/json" -d '{"clientId": "${config.clientId}", "clientSecret": "${config.clientSecret}"}'`,
-    { encoding: 'utf-8' }
-  );
-  return JSON.parse(response).accessToken;
+  // 复用 curlJson（execFileSync + 参数数组、不经 shell）：Windows cmd.exe 不认单引号，
+  // 原来 shell 拼的 `-d '{...}'` JSON body 会被拆碎、curl 收垃圾参数直接退出（#92）。
+  // cn 路径早已用 curlJson，这里对齐；函数保持同步（调用方无需改 async）。
+  return curlJson([
+    '-X', 'POST', `${config.url}/api/v1/auth/universal-auth/login`,
+    '-H', 'Content-Type: application/json',
+    '-d', JSON.stringify({ clientId: config.clientId, clientSecret: config.clientSecret }),
+  ]).accessToken;
 }
 
 export function getInfisicalSecrets(config: InfisicalConfig, token: string, environment: string, secretPath: string): Record<string, string> {

package/bin/helpers/generate-test-token.ts

@@ -88,6 +88,41 @@ async function httpRequest<T>(url: string, options: RequestInit = {}): Promise<T
   return response.json() as Promise<T>;
 }
 
+/**
+ * 判定「账号/商户已存在」——吃 httpRequest 抛出的 `HTTP <status>: <body>` message。
+ *
+ * 两条腿各自对应一个真实来源（user-auth / commerce-backend 是同一套代码跑在 AWS 与
+ * cn 两侧，响应形态一致；下列均为 2026-08-13 直查 origin/main 坐实）：
+ *
+ * - **文案腿** `^HTTP 4xx` 且 `already (exists|registered)`
+ *   · user-auth 注册已注册邮箱 → 400 "Email already registered"
+ *     （user-auth `app/services/user.py`）。**这就是 #78 的病灶**：旧判定只认
+ *     "already exists"，措辞对不上 ⇒ cn 侧 `--email` 复用已有账号必挂。
+ *     实测 cn-prod 响应体：{"error":"Email already registered","status_code":400}
+ *   · commerce-backend 重复建 merchant profile → 400 "Merchant profile already
+ *     exists. Use PUT ..."（commerce-backend `src/api/merchants.py`）
+ *   · 🔴 必须同时是 4xx：5xx 是服务端故障，body 里恰好带着这些词也不能吞 —— 否则
+ *     `POST /api/merchants/me` 的 502/503 会被报成 ℹ already exists，一路打印到
+ *     「✅ Test token generated successfully!」+ Merchant ID: N/A、exit 0。
+ * - **状态码腿** `^HTTP 409`
+ *   · 本工具只调 `POST /api/v1/auth/register/merchant` 与 `POST /api/merchants/me`
+ *     两个端点。**register/merchant 这条路径上唯一的 409** 是企业席位：
+ *     account_type == ENTERPRISE_SEAT → 409 detail "email_bound_to_seat"。
+ *     🔴 **该文案既不含 exists 也不含 registered，所以这条腿不是历史遗留、
+ *     是席位场景的唯一命中路径，别删。**
+ *     ⚠️ 「这条路径上唯一」的限定不是废话：user-auth 全仓有 20+ 处 409
+ *     （referral / internal-sms / teams / admin），措辞各异且语义完全不同
+ *     （如 `claim_in_progress` 是并发冲突）。给本工具接新端点时别想当然沿用本判定，
+ *     否则会把并发冲突静默吞成「已存在」。
+ *
+ * 锚 `^HTTP 409` 而不是 issue 建议的 `\b(409|400)\b`：后者会把 body 里夹带的数字当
+ * 状态码，把真故障（500 而 body 里提到 409）静默吞成「已存在」；而 400 本身太泛
+ * （参数校验失败也是 400），单凭它放行等于吞掉一切请求错误 —— 400 一律交给文案腿判。
+ */
+export function isAlreadyExistsError(message: string): boolean {
+  return /^HTTP 409\b/.test(message) || (/^HTTP 4\d\d\b/.test(message) && /already (exists|registered)/i.test(message));
+}
+
 async function registerMerchant(
   email: string,
   password: string,
@@ -112,7 +147,7 @@ async function registerMerchant(
     console.log(`✓ Merchant registered successfully (ID: ${result.user_id ?? (result as any).id})`);
     return result;
   } catch (error: any) {
-    if (error.message.includes('409') || error.message.includes('already exists')) {
+    if (isAlreadyExistsError(error.message)) {
       console.log(`ℹ Merchant already exists, proceeding to login...`);
       return { email, user_id: '', role: 'merchant', is_active: true, created_at: '', updated_at: '' };
     }
@@ -167,7 +202,7 @@ async function setupMerchantProfile(token: string, businessName: string, config:
     console.log(`✓ Merchant profile setup complete (ID: ${result.merchant_id})`);
     return result;
   } catch (error: any) {
-    if (error.message.includes('409') || error.message.includes('already exists')) {
+    if (isAlreadyExistsError(error.message)) {
       console.log(`ℹ Merchant profile already exists`);
       return { merchant_id: '', business_name: businessName, user_id: '' };
     }
@@ -311,4 +346,6 @@ Example:
   }
 }
 
-main();
+if (require.main === module) {
+  main();
+}

package/bin/helpers/verify-health.ts

@@ -17,8 +17,8 @@
  *
  * 用法:
  *   optima-verify-health user-auth                  # 默认 cn-prod
- *   optima-verify-health user-auth --env prod        # 环境 stage|prod|cn|all
- *   optima-verify-health --all --env all             # stage/prod/cn 三环境矩阵
+ *   optima-verify-health user-auth --env prod        # 环境 stage|prod|cn-prod|cn-stage|all
+ *   optima-verify-health --all --env all             # stage/prod/cn-prod/cn-stage 四环境矩阵
  *   optima-verify-health gateway-core --expect-commit a1b2c3d
  *   optima-verify-health --url https://auth.yzsgo.com/health
  *   optima-verify-health --all --json                # 机器可读,接 CI
@@ -29,23 +29,40 @@ import { promises as dns } from 'node:dns';
 import * as tls from 'node:tls';
 import * as https from 'node:https';
 
-type Env = 'stage' | 'prod' | 'cn' | 'cn-stage';
-interface SvcCfg { path: string; stage?: string; prod?: string; cn?: string; cn_path?: string; 'cn-stage'?: string; 'cn-stage_path'?: string; }
+// 环境名与全仓保持一致（logs.ts 的 CN_ENVS、query-db.ts 的 VALID_ENVS、show-env、
+// billing-http 的 validateEnvCnProd）：阿里云生产叫 cn-prod，不叫 cn。
+// 🔴 名字对不上时 resolve() 会把每个 SvcCfg 键查成 undefined，于是走到「无目标」分支，
+// 把「环境名打错」报成「该服务无部署」—— 与 #83 那批 301 被报成「疑似未部署」同一个病：
+// 探针在不确定的时候撒了一个确定的谎。
+type Env = 'stage' | 'prod' | 'cn-prod' | 'cn-stage';
+interface SvcCfg { path: string; stage?: string; prod?: string; 'cn-prod'?: string; 'cn-prod_path'?: string; 'cn-stage'?: string; 'cn-stage_path'?: string; }
 
 // 服务 × 环境 FQDN 表。某服务某环境没部署 → 该 env 键缺省,探时跳过。
 // cn-prod 真实 subdomain 抄自 optima-terraform alicloud/stacks/cn-prod-ingress-sae/main.tf。
 // #201 (2026-06-12): yzsgo.com 全量迁移完成,旧 *-cn.optima.chat 路由已下线。
 // cn-stage（阿里云预发）域名 *.stage.optima.chat，抄自 cn-stage-ingress-sae services map。
+// #83 (2026-08-13): AWS stage 是 *.stage.optima.onl（点号），旧的连字符形式 *-stage.optima.onl
+// 已不再路由到服务——三项实测 301 → www.optima.onl，探测恒红并误报成「疑似未部署」。
+// 🔴 别只看 stage 列：agentic-chat 的 prod 也踩同一个坑（见下面那行的注释）。
 const SERVICES: Record<string, SvcCfg> = {
-  'user-auth':        { path: '/health',     stage: 'auth-stage.optima.onl', prod: 'auth.optima.onl', cn: 'auth.yzsgo.com', 'cn-stage': 'auth.stage.optima.chat' },
-  'agentic-chat':     { path: '/api/health', stage: 'ai-stage.optima.onl',   prod: 'ai.optima.onl',   cn: 'app.yzsgo.com', 'cn-stage': 'app.stage.optima.chat' },
-  'commerce-backend': { path: '/health',     stage: 'api-stage.optima.onl',  prod: 'api.optima.onl',  cn: 'commerce.yzsgo.com', cn_path: '/health/live', 'cn-stage': 'commerce.stage.optima.chat', 'cn-stage_path': '/health/live' },
-  'mcp-host':         { path: '/health',     stage: 'mcp-stage.optima.onl',  prod: 'mcp.optima.onl' },
-  'gateway-core':     { path: '/health',     cn: 'gw.yzsgo.com', 'cn-stage': 'gw.stage.optima.chat' },
-  'optima-scout':     { path: '/health',     cn: 'scout.yzsgo.com', 'cn-stage': 'scout.stage.optima.chat' },
-  'optima-skills':    { path: '/health',     cn: 'skills.yzsgo.com', 'cn-stage': 'skills.stage.optima.chat' },
+  'user-auth':        { path: '/health',     stage: 'auth.stage.optima.onl', prod: 'auth.optima.onl', 'cn-prod': 'auth.yzsgo.com', 'cn-stage': 'auth.stage.optima.chat' },
+  // agentic-chat 的 prod 入口是 www 不是 ai：prod-ecs/variables.tf 里它的 subdomain = "www"，
+  // 且 main.tf 有一条 ai_to_www_redirect(priority 309) 专门把 ai.optima.onl 301 到 www。
+  // 实测 ai.optima.onl/api/health → 301；www.optima.onl/api/health → 200 service=agentic-chat。
+  'agentic-chat':     { path: '/api/health', stage: 'ai.stage.optima.onl',   prod: 'www.optima.onl',  'cn-prod': 'app.yzsgo.com', 'cn-stage': 'app.stage.optima.chat' },
+  'commerce-backend': { path: '/health',     stage: 'api.stage.optima.onl',  prod: 'api.optima.onl',  'cn-prod': 'commerce.yzsgo.com', 'cn-prod_path': '/health/live', 'cn-stage': 'commerce.stage.optima.chat', 'cn-stage_path': '/health/live' },
+  // #83: mcp-host 已于 2025-12-18 下线,故不在表内 —— optima-terraform origin/main(f97adbb) 的
+  // stage-ecs/variables.tf:146 与 prod-ecs/variables.tf:508 都写着「MCP 工具服务已移除」,
+  // 两个 ecs stack 的 services map 里均无该条目;实测四个候选主机名全是壳(mcp.stage.optima.onl
+  // 307 → /en-US/health 前端 locale 路由,mcp-stage.optima.onl 与 prod 的 mcp.optima.onl 均
+  // 301 → www)。🔴 别再把它加回来:worstOk 是全局单标志(见 main()),留着它会让 `--all --env stage`
+  // 与 `--all --env prod` 恒 exit 1,而那个退出码正是接 CI 卡口时唯一被读的东西。
+  // 同一约束在 tests/service-matrix-alignment.test.js 里对 show-env 的清单也钉着。
+  'gateway-core':     { path: '/health',     'cn-prod': 'gw.yzsgo.com', 'cn-stage': 'gw.stage.optima.chat' },
+  'optima-scout':     { path: '/health',     'cn-prod': 'scout.yzsgo.com', 'cn-stage': 'scout.stage.optima.chat' },
+  'optima-skills':    { path: '/health',     'cn-prod': 'skills.yzsgo.com', 'cn-stage': 'skills.stage.optima.chat' },
 };
-const ENVS: Env[] = ['stage', 'prod', 'cn', 'cn-stage'];
+const ENVS: Env[] = ['stage', 'prod', 'cn-prod', 'cn-stage'];
 
 const G = '\x1b[32m', R = '\x1b[31m', Y = '\x1b[33m', B = '\x1b[34m', N = '\x1b[0m';
 const MARK: Record<string, string> = { ok: `${G}✅${N}`, fail: `${R}❌${N}`, warn: `${Y}⚠️ ${N}`, na: `${B}··${N}` };
@@ -165,27 +182,56 @@ function resolve(svc: string, e: Env): [string, string, string] | null {
   return [`${svc} [${e}]`, host, path];
 }
 
+export interface Args { help: boolean; json: boolean; strict: boolean; all: boolean; env: Env | 'all'; expect?: string; url?: string; service?: string; }
+
+// 🔴 不认识的输入一律报错、绝不静默丢弃（同 query-db.ts 的 parseQueryDbArgs、logs.ts 的 parseArgs）：
+// 此前 `--env=stage` 不认、`--env` 漏写取值、多敲一个位置参数都会被静默无视而回落默认 cn-prod ——
+// 想探 stage，实际探的是阿里云生产，还 exit 0。
+export function parseArgs(argv: string[]): Args {
+  const flags = new Set<string>(), vals: Record<string, string> = {}, positional: string[] = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const eq = arg.startsWith('--') ? arg.indexOf('=') : -1;
+    const name = eq > 0 ? arg.slice(0, eq) : arg;
+    if (['--env', '--expect-commit', '--url'].includes(name)) {
+      const v = eq > 0 ? arg.slice(eq + 1) : argv[++i];
+      if (!v || v.startsWith('-')) throw new Error(`${name} 缺少取值`);
+      vals[name] = v;
+    } else if (['--json', '--strict', '--all', '--help', '-h'].includes(arg)) flags.add(arg);
+    else if (arg.startsWith('-')) throw new Error(`未知参数:${arg}`);
+    else positional.push(arg);
+  }
+  // 🔴 必须先校验再转型：不校验的话任何不认识的 env 都会让 resolve() 把每个 SvcCfg 键查成
+  // undefined，于是落到下面的「无目标」分支，把「环境名打错」报成「该服务无部署」——
+  // 一个活着的服务被说成没上线，正是 #83 要根治的那类静默误报。
+  let envArg = vals['--env'] || 'cn-prod';
+  // 'cn' 是本文件的历史叫法，继续放行但不在 usage 里宣传（同 query-db.ts 的 ENV_ALIASES）。
+  if (envArg === 'cn') envArg = 'cn-prod';
+  if (envArg !== 'all' && !ENVS.includes(envArg as Env)) throw new Error(`未知环境:${envArg}(可选:${ENVS.join(' | ')} | all)`);
+  if (positional.length > 1) throw new Error(`多余参数:${positional.slice(1).join(' ')}(一次探一个服务;环境用 --env 指定)`);
+  const service = positional[0];
+  if (service && !Object.keys(SERVICES).includes(service)) throw new Error(`未知服务:${service}(可选:${Object.keys(SERVICES).join(' | ')})`);
+  const url = vals['--url'], all = flags.has('--all');
+  return { help: flags.has('--help') || flags.has('-h') || !(url || all || service), json: flags.has('--json'), strict: flags.has('--strict'), all, env: envArg as Env | 'all', expect: vals['--expect-commit'], url, service };
+}
+
 async function main() {
-  const argv = process.argv.slice(2);
-  const has = (f: string) => argv.includes(f);
-  const val = (f: string) => { const i = argv.indexOf(f); return i >= 0 ? argv[i + 1] : undefined; };
-  const asJson = has('--json'), strict = has('--strict');
-  const expect = val('--expect-commit');
-  const env = (val('--env') || 'cn') as Env | 'all';
-  const envs: Env[] = env === 'all' ? ENVS : [env as Env];
-  const positional = argv.filter((x, i) => !x.startsWith('--') && !(i > 0 && argv[i - 1].startsWith('--') && ['--env', '--expect-commit', '--url'].includes(argv[i - 1])));
+  let args: Args;
+  try { args = parseArgs(process.argv.slice(2)); } catch (e: any) { console.error(`❌ ${e.message}`); process.exit(2); }
+  const { json: asJson, strict, expect, env } = args;
+  const envs: Env[] = env === 'all' ? ENVS : [env];
 
   let targets: [string, string, string][] = [];
-  if (has('--url')) {
-    const u = new URL(val('--url')!);
-    targets = [[u.hostname, u.hostname, u.pathname || '/health']];
-  } else if (has('--all')) {
-    for (const e of envs) for (const s of Object.keys(SERVICES)) { const t = resolve(s, e); if (t) targets.push(t); }
-  } else if (positional[0] && SERVICES[positional[0]]) {
-    for (const e of envs) { const t = resolve(positional[0], e); if (t) targets.push(t); }
-  } else {
+  if (args.help) {
     console.log((require('fs').readFileSync(__filename, 'utf-8').match(/\/\*\*[\s\S]*?\*\//)?.[0] || '').replace(/^\s*\*?/gm, ''));
     process.exit(2);
+  } else if (args.url) {
+    const u = new URL(args.url);
+    targets = [[u.hostname, u.hostname, u.pathname || '/health']];
+  } else if (args.all) {
+    for (const e of envs) for (const s of Object.keys(SERVICES)) { const t = resolve(s, e); if (t) targets.push(t); }
+  } else if (args.service) {
+    for (const e of envs) { const t = resolve(args.service, e); if (t) targets.push(t); }
   }
   if (targets.length === 0) { console.log(`(无目标:${env} 环境下该服务无部署)`); process.exit(2); }
 
@@ -207,4 +253,6 @@ async function main() {
   process.exitCode = worstOk ? 0 : 1;
 }
 
-main();
+if (require.main === module) {
+  main();
+}

package/dist/bin/helpers/billing-http.js

@@ -156,7 +156,15 @@ function getServiceToken(env, scope) {
     const effectiveScope = scope ?? (isCn ? CN_PROD_TOKEN_SCOPE : undefined);
     const scopeParam = effectiveScope ? `&scope=${encodeURIComponent(effectiveScope)}` : '';
     const body = `grant_type=client_credentials&client_id=${encodeURIComponent(clientId)}&client_secret=${encodeURIComponent(clientSecret)}${scopeParam}`;
-    const response = (0, child_process_1.execSync)(`curl -s -X POST '${authUrl}/api/v1/oauth/token' -H 'Content-Type: application/x-www-form-urlencoded' -d '${body}'`, { encoding: 'utf-8' });
+    // execFileSync + 参数数组（不经 shell）：Windows cmd.exe 不认单引号，shell 拼出的
+    // `-d '${body}'` 会被拆碎、curl 收到垃圾参数直接退出（#92）。数组传参绕开 shell、
+    // 跨平台一致；函数保持同步。
+    const response = (0, child_process_1.execFileSync)('curl', [
+        '-s', '-X', 'POST',
+        `${authUrl}/api/v1/oauth/token`,
+        '-H', 'Content-Type: application/x-www-form-urlencoded',
+        '-d', body,
+    ], { encoding: 'utf-8' });
     let parsed;
     try {
         parsed = JSON.parse(response);

package/dist/bin/helpers/cn-deploy.js

@@ -163,7 +163,8 @@ async function main() {
     console.log(`✓ mirror 已追平 ${svc.repo}@${ref} = ${ghSha.slice(0, 10)}`);
     // 2. 触发(凭证由云效变量组供给,无需注入)。stage/prod 流水线 id 均按名 `${svc}-cn-${env}`
     //    从云效实时解析、不硬编码,根除与 optima-terraform cn-run.py 手工 PIPELINES 表漂移(#84)。
-    const lp = devops('ListPipelines', { maxResults: '100' });
+    // nextToken 自 2026-09 起被 aliyun CLI 标成必填,不传则 API 直接返参数错误 → devops() 吞成 {} → 误报「云效无流水线」。
+    const lp = devops('ListPipelines', { maxResults: '100', nextToken: '0' });
     const hit = (lp.pipelines || []).find((p) => p.pipelineName === `${svcName}-cn-${envName}`);
     if (!hit) {
         console.error(`✗ 云效无 ${svcName}-cn-${envName} 流水线`);

package/dist/bin/helpers/db-utils.js

@@ -117,8 +117,14 @@ function getInfisicalConfig() {
     };
 }
 function getInfisicalToken(config) {
-    const response = (0, child_process_1.execSync)(`curl -s -X POST "${config.url}/api/v1/auth/universal-auth/login" -H "Content-Type: application/json" -d '{"clientId": "${config.clientId}", "clientSecret": "${config.clientSecret}"}'`, { encoding: 'utf-8' });
-    return JSON.parse(response).accessToken;
+    // 复用 curlJson（execFileSync + 参数数组、不经 shell）：Windows cmd.exe 不认单引号，
+    // 原来 shell 拼的 `-d '{...}'` JSON body 会被拆碎、curl 收垃圾参数直接退出（#92）。
+    // cn 路径早已用 curlJson，这里对齐；函数保持同步（调用方无需改 async）。
+    return curlJson([
+        '-X', 'POST', `${config.url}/api/v1/auth/universal-auth/login`,
+        '-H', 'Content-Type: application/json',
+        '-d', JSON.stringify({ clientId: config.clientId, clientSecret: config.clientSecret }),
+    ]).accessToken;
 }
 function getInfisicalSecrets(config, token, environment, secretPath) {
     const response = (0, child_process_1.execSync)(`curl -s "${config.url}/api/v3/secrets/raw?workspaceId=${config.projectId}&environment=${environment}&secretPath=${secretPath}" -H "Authorization: Bearer ${token}"`, { encoding: 'utf-8' });

package/dist/bin/helpers/generate-test-token.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAlreadyExistsError = isAlreadyExistsError;
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
@@ -88,6 +89,40 @@ async function httpRequest(url, options = {}) {
     }
     return response.json();
 }
+/**
+ * 判定「账号/商户已存在」——吃 httpRequest 抛出的 `HTTP <status>: <body>` message。
+ *
+ * 两条腿各自对应一个真实来源（user-auth / commerce-backend 是同一套代码跑在 AWS 与
+ * cn 两侧，响应形态一致；下列均为 2026-08-13 直查 origin/main 坐实）：
+ *
+ * - **文案腿** `^HTTP 4xx` 且 `already (exists|registered)`
+ *   · user-auth 注册已注册邮箱 → 400 "Email already registered"
+ *     （user-auth `app/services/user.py`）。**这就是 #78 的病灶**：旧判定只认
+ *     "already exists"，措辞对不上 ⇒ cn 侧 `--email` 复用已有账号必挂。
+ *     实测 cn-prod 响应体：{"error":"Email already registered","status_code":400}
+ *   · commerce-backend 重复建 merchant profile → 400 "Merchant profile already
+ *     exists. Use PUT ..."（commerce-backend `src/api/merchants.py`）
+ *   · 🔴 必须同时是 4xx：5xx 是服务端故障，body 里恰好带着这些词也不能吞 —— 否则
+ *     `POST /api/merchants/me` 的 502/503 会被报成 ℹ already exists，一路打印到
+ *     「✅ Test token generated successfully!」+ Merchant ID: N/A、exit 0。
+ * - **状态码腿** `^HTTP 409`
+ *   · 本工具只调 `POST /api/v1/auth/register/merchant` 与 `POST /api/merchants/me`
+ *     两个端点。**register/merchant 这条路径上唯一的 409** 是企业席位：
+ *     account_type == ENTERPRISE_SEAT → 409 detail "email_bound_to_seat"。
+ *     🔴 **该文案既不含 exists 也不含 registered，所以这条腿不是历史遗留、
+ *     是席位场景的唯一命中路径，别删。**
+ *     ⚠️ 「这条路径上唯一」的限定不是废话：user-auth 全仓有 20+ 处 409
+ *     （referral / internal-sms / teams / admin），措辞各异且语义完全不同
+ *     （如 `claim_in_progress` 是并发冲突）。给本工具接新端点时别想当然沿用本判定，
+ *     否则会把并发冲突静默吞成「已存在」。
+ *
+ * 锚 `^HTTP 409` 而不是 issue 建议的 `\b(409|400)\b`：后者会把 body 里夹带的数字当
+ * 状态码，把真故障（500 而 body 里提到 409）静默吞成「已存在」；而 400 本身太泛
+ * （参数校验失败也是 400），单凭它放行等于吞掉一切请求错误 —— 400 一律交给文案腿判。
+ */
+function isAlreadyExistsError(message) {
+    return /^HTTP 409\b/.test(message) || (/^HTTP 4\d\d\b/.test(message) && /already (exists|registered)/i.test(message));
+}
 async function registerMerchant(email, password, businessName, config, phone, address) {
     console.log(`\n📝 Registering merchant: ${email}...`);
     const payload = { email, password, business_name: businessName };
@@ -105,7 +140,7 @@ async function registerMerchant(email, password, businessName, config, phone, ad
         return result;
     }
     catch (error) {
-        if (error.message.includes('409') || error.message.includes('already exists')) {
+        if (isAlreadyExistsError(error.message)) {
             console.log(`ℹ Merchant already exists, proceeding to login...`);
             return { email, user_id: '', role: 'merchant', is_active: true, created_at: '', updated_at: '' };
         }
@@ -153,7 +188,7 @@ async function setupMerchantProfile(token, businessName, config) {
         return result;
     }
     catch (error) {
-        if (error.message.includes('409') || error.message.includes('already exists')) {
+        if (isAlreadyExistsError(error.message)) {
             console.log(`ℹ Merchant profile already exists`);
             return { merchant_id: '', business_name: businessName, user_id: '' };
         }
@@ -292,4 +327,6 @@ Example:
         process.exit(1);
     }
 }
-main();
+if (require.main === module) {
+    main();
+}