@optima-chat/dev-skills 0.16.4 → 0.16.6

package/.claude/skills/cn-deploy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cn-deploy
-description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 21 个服务（构建→DB迁移→SAE 发布一条龙；含 build-only 的 agent-runtime）。
+description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 22 个服务（构建→DB迁移→SAE 发布一条龙；含 build-only 的 agent-runtime）。
 ---
 
 # cn-deploy - 云效 cn-stage 流水线发布
@@ -21,7 +21,7 @@ optima-cn-deploy --list                       # 列出全部可发服务
 
 ## 使用要点
 
-1. **先 `--list` 确认服务名**（21 个服务，含 commerce-backend / optima-scout / build-only 的 agent-runtime）。
+1. **先 `--list` 确认服务名**（22 个服务，含 commerce-backend / optima-scout / build-only 的 agent-runtime）。
 2. 全链约 3-8 分钟（agentic-chat 最重）。触发后会输出云效 run 链接，可发给用户自行围观。
 3. **凭证零配置**：构建凭证由云效变量组 `cn-stage-build-credentials`(41970) 供给，不需要注入任何 secret。
 4. 分支构建会把该分支代码部署到 cn-stage（替换现运行版本）——用户明确要求部署分支时才用。

package/.claude/skills/yzsgo-e2e/SKILL.md

@@ -16,9 +16,20 @@ allowed-tools: ["Bash", "Read", "Write", "Agent", "Workflow"]
 - 用户提到「遇到它问 X 就答 Y / 测某个反问」→ `--answer "X=Y"`。
 - 用户说「重点看有没有 Z」→ `--expect "Z"`。
 
+## 环境自举（第一步，自包含——别外链别的仓库）
+脚本都在本 skill 目录（记为 `$S`，就是本 SKILL.md 所在目录）。托管 venv = `~/.cache/yzsgo-e2e/venv`（记 `$VENV`），不碰系统 python。
+
+1. **体检**：`python3 $S/preflight.py <env>`。缺项分两类：
+   - 🅰️ **auto（能自动装）**：`venv+playwright`、`sshpass`。
+   - ✋ **manual（凭据/登录，装不了）**：`chrome-9222`（登了测试账号的调试 Chrome）、`buildbox-pw`、`test-user-id`。
+2. **逐个补缺**（🔴 全绿才往下；不绿就停下、别硬跑半残）：
+   - 每个 🅰️ 缺项：**先问用户「要我装 `<name>` 吗？」，用户同意了**再跑 `python3 $S/bootstrap.py setup`（装 venv+playwright）或 `python3 $S/bootstrap.py install-sshpass`。别不问就装。
+   - 每个 ✋ 缺项：引导用户——`chrome-9222`：`python3 $S/bootstrap.py launch-chrome` 起窗口、让用户**手动登测试账号**（登一次长期免登）；`buildbox-pw`：让用户把口令放 `~/.buildbox_pw`（内部拉 wire 用，向团队要）；`test-user-id`：让用户登录 Optima（run_e2e 自动从 `~/.optima/token.json` 读 userId）。
+   - 补完 `python3 $S/preflight.py <env>` 复检，直到全 ✅ 才进四段。
+
 ## 四段流程
-1. **preflight**：`python3 preflight.py <env>`；缺项按提示准备（一次性登录/充值见 store-skills `setting-up-yzsgo-test-env`，我不替做）。
-2. **驱动 + 拉 wire + 备料**：`python3 run_e2e.py --env <env> --user <测试账号userId> --message ... [--answer k=v] [--expect ...] --out <dir>` → 出 `prepped.md` + `meta.json`。
+1. **preflight + 自举**：见上「环境自举」，**全绿**才继续。
+2. **驱动 + 拉 wire + 备料**：`$VENV/bin/python $S/run_e2e.py --env <env> --message ... [--answer k=v] [--expect ...] --out <dir>` → 出 `prepped.md` + `meta.json`。🔑 用 **venv 的 python**（playwright 在那儿）；`--user` 不给则自动读 `~/.optima/token.json`。
 3. **判定**：`gh issue list --repo Optima-Chat/optima-gateway --state open --json number,title` 拉已知 issue 文本，`Workflow({scriptPath:"<skill>/judge_workflow.js", args:{base:"<dir>", sids:["prepped"], knownIssues:"<文本>"}})`。
 4. **报告 + 提 issue**：
    判定跑完后，先把 judge_workflow 输出 + meta.json 组装成 render_report 的入参（两者字段形状不同，别直接传）：
@@ -45,7 +56,8 @@ allowed-tools: ["Bash", "Read", "Write", "Agent", "Workflow"]
 
 ## 真机 smoke（改完先跑这个验管道通）
 ```bash
-python3 run_e2e.py --env cn-prod --user <测试账号userId> --message "你好" --out /tmp/yzsgo-smoke
+python3 $S/preflight.py cn-prod          # 先体检，缺项按「环境自举」补齐到全绿
+$VENV/bin/python $S/run_e2e.py --env cn-prod --message "你好" --out /tmp/yzsgo-smoke
 # 期望：/tmp/yzsgo-smoke/prepped.md 含「前端所见」节 + wire transcript；meta.json 的 located 命中本次对话。
-# 只验四段接线通，不追判定质量。
+# 只验四段接线通，不追判定质量。（--user 自动读 token.json）
 ```

package/.claude/skills/yzsgo-e2e/bootstrap.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""yzsgo-e2e 自举：把「能装的」依赖装好。**征得用户同意由 SKILL.md/Claude 负责问**，
+本脚本只在被调用时执行对应动作。托管 venv 放 ~/.cache/yzsgo-e2e/venv——不碰系统 python
+（macOS/发行版的系统 python 常是外部管理，pip install 会被拒），最稳、可复现、不污染。"""
+import os, subprocess, sys
+
+VENV = os.path.expanduser("~/.cache/yzsgo-e2e/venv")
+
+
+def venv_python(base: str = VENV) -> str:
+    return os.path.join(base, "bin", "python")
+
+
+def plan_actions(missing_names: list, base: str = VENV) -> list:
+    """纯函数：把缺项名映射成要执行的命令序列。供单测 + 让 Claude/用户预知会跑什么。
+    返回 [(动作名, [[argv...], ...]), ...]。只覆盖 auto 类缺项（manual 类装不了，不在此）。"""
+    plan = []
+    for n in missing_names:
+        if n == "venv+playwright":
+            plan.append(("setup", [
+                [sys.executable, "-m", "venv", base],
+                [venv_python(base), "-m", "pip", "install", "-q", "playwright"],
+                [venv_python(base), "-m", "playwright", "install", "chromium"],
+            ]))
+        elif n == "sshpass":
+            plan.append(("install-sshpass", [["brew", "install", "hudochenkov/sshpass/sshpass"]]))
+        elif n == "chrome-9222":
+            plan.append(("launch-chrome", [[
+                "open", "-na", "Google Chrome", "--args",
+                "--remote-debugging-port=9222", "--user-data-dir=/tmp/yzsgo-chrome",
+                "https://www.yzsgo.com"]]))
+    return plan
+
+
+def _run(cmds: list) -> bool:
+    for c in cmds:
+        print("+", " ".join(c))
+        if subprocess.run(c).returncode != 0:
+            print(f"[bootstrap] 命令失败：{' '.join(c)}", file=sys.stderr)
+            return False
+    return True
+
+
+def _do(name: str) -> bool:
+    plan = plan_actions([name])
+    if not plan:
+        print(f"[bootstrap] 无法自动处理 {name}（可能是 manual 类，需人工准备）", file=sys.stderr)
+        return False
+    return _run([c for _, cmds in plan for c in cmds])
+
+
+# 动作名 → 触发它的缺项名
+_CMD_TO_MISSING = {"setup": "venv+playwright", "install-sshpass": "sshpass", "launch-chrome": "chrome-9222"}
+
+if __name__ == "__main__":
+    cmd = sys.argv[1] if len(sys.argv) > 1 else "setup"
+    miss = _CMD_TO_MISSING.get(cmd)
+    if not miss:
+        print(f"未知命令 {cmd}；可用：{' / '.join(_CMD_TO_MISSING)}", file=sys.stderr)
+        sys.exit(2)
+    ok = _do(miss)
+    if cmd == "launch-chrome" and ok:
+        print("已起调试端口 Chrome；请在弹出的窗口里手动登录测试账号（登一次即长期免登）。")
+    sys.exit(0 if ok else 1)

package/.claude/skills/yzsgo-e2e/preflight.py

@@ -1,44 +1,74 @@
 #!/usr/bin/env python3
-"""yzsgo-e2e 环境自检。探测函数有副作用（读端口/文件），汇总用纯函数 summarize_preflight。
-缺项只指路（不替用户做一次性登录/充值），准备步骤见 store-skills 的 setting-up-yzsgo-test-env。"""
-import os, shutil, socket, sys
+"""yzsgo-e2e 环境体检（医生）。诊断每项依赖，分两类：
+- auto：可由 bootstrap.py 在**征得用户同意后**自动装（托管 venv+playwright、sshpass）；
+- manual：凭据/登录类，装不了、只能引导（buildbox 口令、登了测试账号的调试 Chrome、userId）。
+本脚本只诊断、不装东西。装由 bootstrap.py 做（同意由 SKILL.md/Claude 负责问）。"""
+import json, os, shutil, socket, subprocess, sys
+
+VENV = os.path.expanduser("~/.cache/yzsgo-e2e/venv")
+
+
+def venv_python(base: str = VENV) -> str:
+    return os.path.join(base, "bin", "python")
+
 
 def _port_open(port: int) -> bool:
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         s.settimeout(1.0)
         return s.connect_ex(("127.0.0.1", port)) == 0
 
-def probe(env: str = "cn-prod") -> list[dict]:
-    return [
-        {"name": "chrome-9222", "ok": _port_open(9222),
-         "hint": '起调试端口 Chrome：open -na "Google Chrome" --args --remote-debugging-port=9222 '
-                 '--user-data-dir=/tmp/yzsgo-chrome https://www.yzsgo.com（手动登测试账号）'},
-        {"name": "buildbox-pw", "ok": os.path.exists(os.path.expanduser("~/.buildbox_pw")),
-         "hint": "拉 wire 需 buildbox 口令文件 ~/.buildbox_pw（见 setting-up-yzsgo-test-env）"},
-        {"name": "sshpass", "ok": shutil.which("sshpass") is not None,
-         "hint": "brew install hudochenkov/sshpass/sshpass"},
-        {"name": "playwright", "ok": _has_playwright(),
-         "hint": "pip install playwright && playwright install chromium"},
-    ]
 
-def _has_playwright() -> bool:
+def _venv_has_playwright() -> bool:
+    py = venv_python()
+    if not os.path.exists(py):
+        return False
+    return subprocess.run([py, "-c", "import playwright"], capture_output=True).returncode == 0
+
+
+def _token_user() -> str | None:
     try:
-        import playwright  # noqa: F401
-        return True
+        d = json.load(open(os.path.expanduser("~/.optima/token.json")))
+        return (d.get("user") or {}).get("userId")
     except Exception:
-        return False
+        return None
+
+
+def probe(env: str = "cn-prod") -> list:
+    return [
+        {"name": "venv+playwright", "ok": _venv_has_playwright(), "category": "auto",
+         "fix": "python3 bootstrap.py setup   # 建托管 venv(~/.cache/yzsgo-e2e/venv) + 装 playwright/chromium"},
+        {"name": "sshpass", "ok": shutil.which("sshpass") is not None, "category": "auto",
+         "fix": "python3 bootstrap.py install-sshpass   # 或 brew install hudochenkov/sshpass/sshpass"},
+        {"name": "chrome-9222", "ok": _port_open(9222), "category": "manual",
+         "fix": "python3 bootstrap.py launch-chrome，然后在弹出的 Chrome 里手动登录测试账号"},
+        {"name": "buildbox-pw", "ok": os.path.exists(os.path.expanduser("~/.buildbox_pw")), "category": "manual",
+         "fix": "把 buildbox 口令写进 ~/.buildbox_pw（内部拉 wire 用；向团队要）"},
+        {"name": "test-user-id", "ok": _token_user() is not None, "category": "manual",
+         "fix": "登录 Optima 生成 ~/.optima/token.json（run_e2e 会自动读 user.userId）"},
+    ]
+
 
 def summarize_preflight(checks: list) -> dict:
     ok = all(c["ok"] for c in checks)
-    missing = [c["name"] for c in checks if not c["ok"]]
+    missing = [{"name": c["name"], "category": c["category"], "fix": c["fix"]}
+               for c in checks if not c["ok"]]
     rows = []
     for c in checks:
-        mark = "✅" if c["ok"] else "❌"
-        rows.append(f"{mark} {c['name']}" + ("" if c["ok"] else f"\n    → {c['hint']}"))
+        mark = "✅" if c["ok"] else ("🅰️ ❌" if c["category"] == "auto" else "✋ ❌")
+        rows.append(f"{mark} {c['name']}" + ("" if c["ok"] else f"\n    → {c['fix']}"))
     return {"ok": ok, "missing": missing, "report": "\n".join(rows)}
 
+
 if __name__ == "__main__":
     env = sys.argv[1] if len(sys.argv) > 1 else "cn-prod"
     r = summarize_preflight(probe(env))
     print(r["report"])
+    if not r["ok"]:
+        auto = [m["name"] for m in r["missing"] if m["category"] == "auto"]
+        man = [m["name"] for m in r["missing"] if m["category"] == "manual"]
+        print()
+        if auto:
+            print(f"🅰️  可自动装（Claude 会先征得你同意再跑 bootstrap）：{', '.join(auto)}")
+        if man:
+            print(f"✋  需你人工准备（凭据/登录，装不了）：{', '.join(man)}")
     sys.exit(0 if r["ok"] else 1)

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

@@ -23,6 +23,14 @@ def render_report(result: dict) -> str:
 def _utc_now() -> str:
     return datetime.now(timezone.utc).isoformat()
 
+def _read_user_from_token(path: str = None) -> str:
+    path = path or os.path.expanduser("~/.optima/token.json")
+    try:
+        d = json.load(open(path))
+        return (d.get("user") or {}).get("userId")
+    except Exception:
+        return None
+
 def _parse_answers(pairs):
     out = []
     for p in pairs or []:
@@ -50,7 +58,8 @@ def main():
     ap.add_argument("--message", action="append", required=True, help="逐轮发送的消息（可多次）")
     ap.add_argument("--answer", action="append", help="反问预设答案 关键词=答案（可多次）")
     ap.add_argument("--expect", default="", help="关注点，喂给判定层")
-    ap.add_argument("--user", required=True, help="测试账号 userId（拉 wire 用）")
+    ap.add_argument("--user", default=None,
+                    help="测试账号 userId（拉 wire 用）；不给则从 ~/.optima/token.json 自动读")
     ap.add_argument("--out", default="e2e-out")
     ap.add_argument("--timeout", type=int, default=180,
                     help="每轮等回复超时秒；长任务（简报/多工具）调大到 500+")
@@ -58,6 +67,13 @@ def main():
     ap.add_argument("--issue-repo", default="Optima-Chat/optima-gateway")
     args = ap.parse_args()
 
+    if not args.user:
+        args.user = _read_user_from_token()
+    if not args.user:
+        print("[error] 没给 --user 且 ~/.optima/token.json 读不到 userId；先登录 Optima 或显式传 --user。",
+              file=sys.stderr)
+        sys.exit(2)
+
     if args.env == "cn-stage":
         print("[warn] cn-stage 的 wire 取法未验证（spec §8 待核实）；仅 cn-prod 全链路已打通。", file=sys.stderr)
 

package/.codex/skills/cn-deploy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cn-deploy
-description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 21 个服务（构建→DB迁移→SAE 发布一条龙；含 build-only 的 agent-runtime）。
+description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 22 个服务（构建→DB迁移→SAE 发布一条龙；含 build-only 的 agent-runtime）。
 ---
 
 # cn-deploy - 云效 cn-stage 流水线发布
@@ -21,7 +21,7 @@ optima-cn-deploy --list                       # 列出全部可发服务
 
 ## 使用要点
 
-1. **先 `--list` 确认服务名**（21 个服务，含 commerce-backend / optima-scout / build-only 的 agent-runtime）。
+1. **先 `--list` 确认服务名**（22 个服务，含 commerce-backend / optima-scout / build-only 的 agent-runtime）。
 2. 全链约 3-8 分钟（agentic-chat 最重）。触发后会输出云效 run 链接，可发给用户自行围观。
 3. **凭证零配置**：构建凭证由云效变量组 `cn-stage-build-credentials`(41970) 供给，不需要注入任何 secret。
 4. 分支构建会把该分支代码部署到 cn-stage（替换现运行版本）——用户明确要求部署分支时才用。

package/.codex/skills/yzsgo-e2e/SKILL.md

@@ -16,9 +16,20 @@ allowed-tools: ["Bash", "Read", "Write", "Agent", "Workflow"]
 - 用户提到「遇到它问 X 就答 Y / 测某个反问」→ `--answer "X=Y"`。
 - 用户说「重点看有没有 Z」→ `--expect "Z"`。
 
+## 环境自举（第一步，自包含——别外链别的仓库）
+脚本都在本 skill 目录（记为 `$S`，就是本 SKILL.md 所在目录）。托管 venv = `~/.cache/yzsgo-e2e/venv`（记 `$VENV`），不碰系统 python。
+
+1. **体检**：`python3 $S/preflight.py <env>`。缺项分两类：
+   - 🅰️ **auto（能自动装）**：`venv+playwright`、`sshpass`。
+   - ✋ **manual（凭据/登录，装不了）**：`chrome-9222`（登了测试账号的调试 Chrome）、`buildbox-pw`、`test-user-id`。
+2. **逐个补缺**（🔴 全绿才往下；不绿就停下、别硬跑半残）：
+   - 每个 🅰️ 缺项：**先问用户「要我装 `<name>` 吗？」，用户同意了**再跑 `python3 $S/bootstrap.py setup`（装 venv+playwright）或 `python3 $S/bootstrap.py install-sshpass`。别不问就装。
+   - 每个 ✋ 缺项：引导用户——`chrome-9222`：`python3 $S/bootstrap.py launch-chrome` 起窗口、让用户**手动登测试账号**（登一次长期免登）；`buildbox-pw`：让用户把口令放 `~/.buildbox_pw`（内部拉 wire 用，向团队要）；`test-user-id`：让用户登录 Optima（run_e2e 自动从 `~/.optima/token.json` 读 userId）。
+   - 补完 `python3 $S/preflight.py <env>` 复检，直到全 ✅ 才进四段。
+
 ## 四段流程
-1. **preflight**：`python3 preflight.py <env>`；缺项按提示准备（一次性登录/充值见 store-skills `setting-up-yzsgo-test-env`，我不替做）。
-2. **驱动 + 拉 wire + 备料**：`python3 run_e2e.py --env <env> --user <测试账号userId> --message ... [--answer k=v] [--expect ...] --out <dir>` → 出 `prepped.md` + `meta.json`。
+1. **preflight + 自举**：见上「环境自举」，**全绿**才继续。
+2. **驱动 + 拉 wire + 备料**：`$VENV/bin/python $S/run_e2e.py --env <env> --message ... [--answer k=v] [--expect ...] --out <dir>` → 出 `prepped.md` + `meta.json`。🔑 用 **venv 的 python**（playwright 在那儿）；`--user` 不给则自动读 `~/.optima/token.json`。
 3. **判定**：`gh issue list --repo Optima-Chat/optima-gateway --state open --json number,title` 拉已知 issue 文本，`Workflow({scriptPath:"<skill>/judge_workflow.js", args:{base:"<dir>", sids:["prepped"], knownIssues:"<文本>"}})`。
 4. **报告 + 提 issue**：
    判定跑完后，先把 judge_workflow 输出 + meta.json 组装成 render_report 的入参（两者字段形状不同，别直接传）：
@@ -45,7 +56,8 @@ allowed-tools: ["Bash", "Read", "Write", "Agent", "Workflow"]
 
 ## 真机 smoke（改完先跑这个验管道通）
 ```bash
-python3 run_e2e.py --env cn-prod --user <测试账号userId> --message "你好" --out /tmp/yzsgo-smoke
+python3 $S/preflight.py cn-prod          # 先体检，缺项按「环境自举」补齐到全绿
+$VENV/bin/python $S/run_e2e.py --env cn-prod --message "你好" --out /tmp/yzsgo-smoke
 # 期望：/tmp/yzsgo-smoke/prepped.md 含「前端所见」节 + wire transcript；meta.json 的 located 命中本次对话。
-# 只验四段接线通，不追判定质量。
+# 只验四段接线通，不追判定质量。（--user 自动读 token.json）
 ```

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

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""yzsgo-e2e 自举：把「能装的」依赖装好。**征得用户同意由 SKILL.md/Claude 负责问**，
+本脚本只在被调用时执行对应动作。托管 venv 放 ~/.cache/yzsgo-e2e/venv——不碰系统 python
+（macOS/发行版的系统 python 常是外部管理，pip install 会被拒），最稳、可复现、不污染。"""
+import os, subprocess, sys
+
+VENV = os.path.expanduser("~/.cache/yzsgo-e2e/venv")
+
+
+def venv_python(base: str = VENV) -> str:
+    return os.path.join(base, "bin", "python")
+
+
+def plan_actions(missing_names: list, base: str = VENV) -> list:
+    """纯函数：把缺项名映射成要执行的命令序列。供单测 + 让 Claude/用户预知会跑什么。
+    返回 [(动作名, [[argv...], ...]), ...]。只覆盖 auto 类缺项（manual 类装不了，不在此）。"""
+    plan = []
+    for n in missing_names:
+        if n == "venv+playwright":
+            plan.append(("setup", [
+                [sys.executable, "-m", "venv", base],
+                [venv_python(base), "-m", "pip", "install", "-q", "playwright"],
+                [venv_python(base), "-m", "playwright", "install", "chromium"],
+            ]))
+        elif n == "sshpass":
+            plan.append(("install-sshpass", [["brew", "install", "hudochenkov/sshpass/sshpass"]]))
+        elif n == "chrome-9222":
+            plan.append(("launch-chrome", [[
+                "open", "-na", "Google Chrome", "--args",
+                "--remote-debugging-port=9222", "--user-data-dir=/tmp/yzsgo-chrome",
+                "https://www.yzsgo.com"]]))
+    return plan
+
+
+def _run(cmds: list) -> bool:
+    for c in cmds:
+        print("+", " ".join(c))
+        if subprocess.run(c).returncode != 0:
+            print(f"[bootstrap] 命令失败：{' '.join(c)}", file=sys.stderr)
+            return False
+    return True
+
+
+def _do(name: str) -> bool:
+    plan = plan_actions([name])
+    if not plan:
+        print(f"[bootstrap] 无法自动处理 {name}（可能是 manual 类，需人工准备）", file=sys.stderr)
+        return False
+    return _run([c for _, cmds in plan for c in cmds])
+
+
+# 动作名 → 触发它的缺项名
+_CMD_TO_MISSING = {"setup": "venv+playwright", "install-sshpass": "sshpass", "launch-chrome": "chrome-9222"}
+
+if __name__ == "__main__":
+    cmd = sys.argv[1] if len(sys.argv) > 1 else "setup"
+    miss = _CMD_TO_MISSING.get(cmd)
+    if not miss:
+        print(f"未知命令 {cmd}；可用：{' / '.join(_CMD_TO_MISSING)}", file=sys.stderr)
+        sys.exit(2)
+    ok = _do(miss)
+    if cmd == "launch-chrome" and ok:
+        print("已起调试端口 Chrome；请在弹出的窗口里手动登录测试账号（登一次即长期免登）。")
+    sys.exit(0 if ok else 1)

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

@@ -1,44 +1,74 @@
 #!/usr/bin/env python3
-"""yzsgo-e2e 环境自检。探测函数有副作用（读端口/文件），汇总用纯函数 summarize_preflight。
-缺项只指路（不替用户做一次性登录/充值），准备步骤见 store-skills 的 setting-up-yzsgo-test-env。"""
-import os, shutil, socket, sys
+"""yzsgo-e2e 环境体检（医生）。诊断每项依赖，分两类：
+- auto：可由 bootstrap.py 在**征得用户同意后**自动装（托管 venv+playwright、sshpass）；
+- manual：凭据/登录类，装不了、只能引导（buildbox 口令、登了测试账号的调试 Chrome、userId）。
+本脚本只诊断、不装东西。装由 bootstrap.py 做（同意由 SKILL.md/Claude 负责问）。"""
+import json, os, shutil, socket, subprocess, sys
+
+VENV = os.path.expanduser("~/.cache/yzsgo-e2e/venv")
+
+
+def venv_python(base: str = VENV) -> str:
+    return os.path.join(base, "bin", "python")
+
 
 def _port_open(port: int) -> bool:
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         s.settimeout(1.0)
         return s.connect_ex(("127.0.0.1", port)) == 0
 
-def probe(env: str = "cn-prod") -> list[dict]:
-    return [
-        {"name": "chrome-9222", "ok": _port_open(9222),
-         "hint": '起调试端口 Chrome：open -na "Google Chrome" --args --remote-debugging-port=9222 '
-                 '--user-data-dir=/tmp/yzsgo-chrome https://www.yzsgo.com（手动登测试账号）'},
-        {"name": "buildbox-pw", "ok": os.path.exists(os.path.expanduser("~/.buildbox_pw")),
-         "hint": "拉 wire 需 buildbox 口令文件 ~/.buildbox_pw（见 setting-up-yzsgo-test-env）"},
-        {"name": "sshpass", "ok": shutil.which("sshpass") is not None,
-         "hint": "brew install hudochenkov/sshpass/sshpass"},
-        {"name": "playwright", "ok": _has_playwright(),
-         "hint": "pip install playwright && playwright install chromium"},
-    ]
 
-def _has_playwright() -> bool:
+def _venv_has_playwright() -> bool:
+    py = venv_python()
+    if not os.path.exists(py):
+        return False
+    return subprocess.run([py, "-c", "import playwright"], capture_output=True).returncode == 0
+
+
+def _token_user() -> str | None:
     try:
-        import playwright  # noqa: F401
-        return True
+        d = json.load(open(os.path.expanduser("~/.optima/token.json")))
+        return (d.get("user") or {}).get("userId")
     except Exception:
-        return False
+        return None
+
+
+def probe(env: str = "cn-prod") -> list:
+    return [
+        {"name": "venv+playwright", "ok": _venv_has_playwright(), "category": "auto",
+         "fix": "python3 bootstrap.py setup   # 建托管 venv(~/.cache/yzsgo-e2e/venv) + 装 playwright/chromium"},
+        {"name": "sshpass", "ok": shutil.which("sshpass") is not None, "category": "auto",
+         "fix": "python3 bootstrap.py install-sshpass   # 或 brew install hudochenkov/sshpass/sshpass"},
+        {"name": "chrome-9222", "ok": _port_open(9222), "category": "manual",
+         "fix": "python3 bootstrap.py launch-chrome，然后在弹出的 Chrome 里手动登录测试账号"},
+        {"name": "buildbox-pw", "ok": os.path.exists(os.path.expanduser("~/.buildbox_pw")), "category": "manual",
+         "fix": "把 buildbox 口令写进 ~/.buildbox_pw（内部拉 wire 用；向团队要）"},
+        {"name": "test-user-id", "ok": _token_user() is not None, "category": "manual",
+         "fix": "登录 Optima 生成 ~/.optima/token.json（run_e2e 会自动读 user.userId）"},
+    ]
+
 
 def summarize_preflight(checks: list) -> dict:
     ok = all(c["ok"] for c in checks)
-    missing = [c["name"] for c in checks if not c["ok"]]
+    missing = [{"name": c["name"], "category": c["category"], "fix": c["fix"]}
+               for c in checks if not c["ok"]]
     rows = []
     for c in checks:
-        mark = "✅" if c["ok"] else "❌"
-        rows.append(f"{mark} {c['name']}" + ("" if c["ok"] else f"\n    → {c['hint']}"))
+        mark = "✅" if c["ok"] else ("🅰️ ❌" if c["category"] == "auto" else "✋ ❌")
+        rows.append(f"{mark} {c['name']}" + ("" if c["ok"] else f"\n    → {c['fix']}"))
     return {"ok": ok, "missing": missing, "report": "\n".join(rows)}
 
+
 if __name__ == "__main__":
     env = sys.argv[1] if len(sys.argv) > 1 else "cn-prod"
     r = summarize_preflight(probe(env))
     print(r["report"])
+    if not r["ok"]:
+        auto = [m["name"] for m in r["missing"] if m["category"] == "auto"]
+        man = [m["name"] for m in r["missing"] if m["category"] == "manual"]
+        print()
+        if auto:
+            print(f"🅰️  可自动装（Claude 会先征得你同意再跑 bootstrap）：{', '.join(auto)}")
+        if man:
+            print(f"✋  需你人工准备（凭据/登录，装不了）：{', '.join(man)}")
     sys.exit(0 if r["ok"] else 1)

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

@@ -23,6 +23,14 @@ def render_report(result: dict) -> str:
 def _utc_now() -> str:
     return datetime.now(timezone.utc).isoformat()
 
+def _read_user_from_token(path: str = None) -> str:
+    path = path or os.path.expanduser("~/.optima/token.json")
+    try:
+        d = json.load(open(path))
+        return (d.get("user") or {}).get("userId")
+    except Exception:
+        return None
+
 def _parse_answers(pairs):
     out = []
     for p in pairs or []:
@@ -50,7 +58,8 @@ def main():
     ap.add_argument("--message", action="append", required=True, help="逐轮发送的消息（可多次）")
     ap.add_argument("--answer", action="append", help="反问预设答案 关键词=答案（可多次）")
     ap.add_argument("--expect", default="", help="关注点，喂给判定层")
-    ap.add_argument("--user", required=True, help="测试账号 userId（拉 wire 用）")
+    ap.add_argument("--user", default=None,
+                    help="测试账号 userId（拉 wire 用）；不给则从 ~/.optima/token.json 自动读")
     ap.add_argument("--out", default="e2e-out")
     ap.add_argument("--timeout", type=int, default=180,
                     help="每轮等回复超时秒；长任务（简报/多工具）调大到 500+")
@@ -58,6 +67,13 @@ def main():
     ap.add_argument("--issue-repo", default="Optima-Chat/optima-gateway")
     args = ap.parse_args()
 
+    if not args.user:
+        args.user = _read_user_from_token()
+    if not args.user:
+        print("[error] 没给 --user 且 ~/.optima/token.json 读不到 userId；先登录 Optima 或显式传 --user。",
+              file=sys.stderr)
+        sys.exit(2)
+
     if args.env == "cn-stage":
         print("[warn] cn-stage 的 wire 取法未验证（spec §8 待核实）；仅 cn-prod 全链路已打通。", file=sys.stderr)
 

package/bin/helpers/cn-deploy.ts

@@ -64,6 +64,8 @@ const SERVICES: Record<string, Svc> = {
   'optima-sentinel':          { repo: 'optima-sentinel',    saeAppId: '3759db7b-4640-4a04-8436-4f241f0ec9d9', prodSaeAppId: 'e120e70c-b2c1-49ef-a66c-9016fd2d807d' },
   'optima-sentinel-worker':   { repo: 'optima-sentinel',    saeAppId: '7c975caf-ebfb-4bb3-91c4-2a8c83d1d2e5', prodSaeAppId: 'e0f9b92c-00af-4ade-9b07-15bba48c14cc' },
   'optima-skills':            { repo: 'optima-skills',      saeAppId: '90457be3-5eb3-4efc-a362-1788dcc51921', prodSaeAppId: '55a63ee7-fb75-46e4-99f3-20854a699237' },
+  // prodSaeAppId 待 cn-prod 首发后补(流水线 tiktok-backend-cn-prod 亦未生成,prod 请求会在找流水线一步失败,符合预期)
+  'tiktok-backend':           { repo: 'tiktok-api-integration', saeAppId: 'd34e8e25-1eab-473b-a01e-8df1375f7330' },
   'user-auth':                { repo: 'user-auth',          saeAppId: '36efc3a6-5b42-49fa-8db2-0865aa0c25d2', prodSaeAppId: 'd6fbf9de-fed6-4165-978f-7b3a0a456acc' },
   'user-auth-admin':          { repo: 'user-auth',          saeAppId: '7feb9cc3-4731-4ea8-964c-4870a9e63afb', prodSaeAppId: '54093f99-37bf-4354-abd7-f6e76abdbcb6' },
   'yzsgo-api':                { repo: 'yzsgo',              saeAppId: 'd0af7f66-ef66-4587-9e93-250d01ee3cf6', prodSaeAppId: '5a820992-e11b-404a-9e58-8f607d8e0c5f' },

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

@@ -61,6 +61,8 @@ const SERVICES = {
     'optima-sentinel': { repo: 'optima-sentinel', saeAppId: '3759db7b-4640-4a04-8436-4f241f0ec9d9', prodSaeAppId: 'e120e70c-b2c1-49ef-a66c-9016fd2d807d' },
     'optima-sentinel-worker': { repo: 'optima-sentinel', saeAppId: '7c975caf-ebfb-4bb3-91c4-2a8c83d1d2e5', prodSaeAppId: 'e0f9b92c-00af-4ade-9b07-15bba48c14cc' },
     'optima-skills': { repo: 'optima-skills', saeAppId: '90457be3-5eb3-4efc-a362-1788dcc51921', prodSaeAppId: '55a63ee7-fb75-46e4-99f3-20854a699237' },
+    // prodSaeAppId 待 cn-prod 首发后补(流水线 tiktok-backend-cn-prod 亦未生成,prod 请求会在找流水线一步失败,符合预期)
+    'tiktok-backend': { repo: 'tiktok-api-integration', saeAppId: 'd34e8e25-1eab-473b-a01e-8df1375f7330' },
     'user-auth': { repo: 'user-auth', saeAppId: '36efc3a6-5b42-49fa-8db2-0865aa0c25d2', prodSaeAppId: 'd6fbf9de-fed6-4165-978f-7b3a0a456acc' },
     'user-auth-admin': { repo: 'user-auth', saeAppId: '7feb9cc3-4731-4ea8-964c-4870a9e63afb', prodSaeAppId: '54093f99-37bf-4354-abd7-f6e76abdbcb6' },
     'yzsgo-api': { repo: 'yzsgo', saeAppId: 'd0af7f66-ef66-4587-9e93-250d01ee3cf6', prodSaeAppId: '5a820992-e11b-404a-9e58-8f607d8e0c5f' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.16.4",
+  "version": "0.16.6",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {