tracup-bug 1.0.0 → 1.0.1

package/README.md

@@ -36,7 +36,10 @@ tracup login
 ```
 
 会弹出一个 Chrome 窗口，正常登录 Tracup（账密或扫码都行）。
-登录成功它自己检测到并关闭，终端打印 `✓ 登录态已保存`。
+登录成功它自己检测到并关闭，终端打印 `✓ 登录成功`。
+
+- 如果会话还没过期，`tracup login` 会直接告诉你“无需重新登录”，不弹窗口。
+  要换号登录：`tracup login --force`。
 
 - 登录态存在你电脑的 `~/.cache/tracup/profile`，**通常能用数周**，过期重跑一次 `tracup login`。
 - 这等价于你的 Tracup 会话：**别发给别人、别提交到 git**。

package/SKILL.md

@@ -38,7 +38,11 @@ node $BIN/tracup_web.mjs status
 
   登录态存在 `~/.cache/tracup/profile`（持久化浏览器用户目录），通常可维持数周。
 
+  `login` 会先无头预检：会话仍有效就直接返回不弹窗口；失效才弹浏览器让你重登。
+  要切换账号：`login --force`（跳过预检、清掉旧 cookie）。
+
 `status` 同时做自检：playwright 能否加载、本机 Chrome 是否可用、配置文件是否存在，一行一行打印，排错先看它。
+（`status` 的“有效”结论经过真接口探活，过期 cookie 骗不了它。）
 
 ## Step 1 · 确认项目与字段名
 

package/bin/tracup_web.mjs

@@ -9,7 +9,8 @@
  *   ✅ 浏览器会话 + POST /api2/issue/create（前端自己用的接口，字段最全）
  *
  * 用法：node tracup_web.mjs <login|status|projects|create|delete|capture|api>
- *   login     打开有头浏览器，你手动登录一次（登录态存 ~/.cache/tracup/profile，可用数周）
+ *   login [--force] 打开有头浏览器，你手动登录一次（登录态存 ~/.cache/tracup/profile，可用数周）
+ *                     已有有效会话会直接返回不弹窗口；--force 强制清掉重登（切换账号用）
  *   status    检查登录态 + 自检（playwright / 浏览器 / 配置是否就位）
  *   projects  列出项目及其类型、状态、模块、成员名
  *   create    建单（--title/--body/--priority/--type/--module/--assignee/--status/--dry-run/--json）
@@ -35,11 +36,13 @@ const SKILL_DIR = path.resolve(__dirname, "..");
 const CONFIG_DIR = path.join(os.homedir(), ".config", "tracup");
 const RUNTIME_DIR = path.join(CONFIG_DIR, "runtime");
 const CACHE_DIR = path.join(os.homedir(), ".cache", "tracup");
-const PROFILE_DIR = path.join(CACHE_DIR, "profile");
+const PROFILE_DIR = process.env.TRACUP_PROFILE_DIR || path.join(CACHE_DIR, "profile");
 const WEB_CONFIG_PATH = path.join(CONFIG_DIR, "web.json");
 const APP_URL = "https://app.tracup.com/";
 const API_ORIGIN = "https://www.tracup.com";
 const LOGIN_HINT = /login|signin|sign-in|passport|auth/i;
+// 等待用户完成登录的最长毫秒数（默认 5 分钟；自动化/测试可调小）
+const LOGIN_TIMEOUT_MS = Number(process.env.TRACUP_LOGIN_TIMEOUT_MS || 300000);
 
 const require = createRequire(import.meta.url);
 
@@ -119,8 +122,18 @@ function waitEnter(promptText) {
   });
 }
 
-/** 轮询判断是否已进入应用（不是登录页且有会话 cookie）。 */
-async function waitForLogin(page, timeoutMs = 300000) {
+/** 调一次需要登录态的接口：200 才算真登录（只看 URL/cookie 会被过期 cookie 骗）。 */
+async function sessionIsValid(ctx) {
+  try {
+    const resp = await ctx.request.get(`${API_ORIGIN}/api2/workspace/config`);
+    return resp.status() === 200;
+  } catch {
+    return false;
+  }
+}
+
+/** 轮询等待用户完成登录：URL 已进应用 _且_ 接口探活通过才算数。 */
+async function waitForLogin(page, ctx, timeoutMs = LOGIN_TIMEOUT_MS) {
   const started = Date.now();
   while (Date.now() - started < timeoutMs) {
     await page.waitForTimeout(1500);
@@ -131,36 +144,62 @@ async function waitForLogin(page, timeoutMs = 300000) {
       continue;
     }
     if (!url || LOGIN_HINT.test(url.replace(APP_URL, ""))) continue;
-    const cookies = await page.context().cookies();
-    const hasSession = cookies.some((c) => c.value && c.value.length > 20 && !/^(1|0|true|false)$/i.test(c.value));
-    if (hasSession) return "auto";
+    if (await sessionIsValid(ctx)) return "auto";
   }
   return "timeout";
 }
 
-async function cmdLogin() {
+async function cmdLogin(args) {
   const headless = process.env.TRACUP_WEB_HEADLESS === "1";
+  const force = args.force || args.fresh;
+
+  // 预检：已有会话且接口探活通过就直接返回，不弹浏览器
+  //（否则过期 cookie 会让检测瞬间通过、窗口一闪而过，还误报“已保存”）。
+  if (!force) {
+    const pre = await openContext({ headless: true });
+    try {
+      const prePage = pre.pages()[0] || (await pre.newPage());
+      await prePage.goto(APP_URL, { waitUntil: "domcontentloaded" });
+      await prePage.waitForTimeout(2000);
+      if (await sessionIsValid(pre)) {
+        log("✓ 登录态仍有效，无需重新登录。");
+        log("  （要切换账号请加 --force：tracup login --force）");
+        await pre.close();
+        return;
+      }
+      log("· 已有会话已失效，清掉过期 cookie 后请重新登录。");
+    } catch {
+      /* 预检失败就走正常登录流程 */
+    }
+    await pre.close();
+  }
+
   const ctx = await openContext({ headless });
+  await ctx.clearCookies();
   const page = ctx.pages()[0] || (await ctx.newPage());
   await page.goto(APP_URL, { waitUntil: "domcontentloaded" });
 
   log("浏览器已打开，请在窗口里完成 Tracup 登录（支持扫码/账密）。");
   log("登录成功后会自动继续；也可以回到这里按回车。\n");
 
-  const result = process.stdin.isTTY
-    ? await Promise.race([waitForLogin(page), waitEnter("登录完成后按回车继续… ")])
-    : await waitForLogin(page);
+  let result = process.stdin.isTTY
+    ? await Promise.race([waitForLogin(page, ctx), waitEnter("登录完成后按回车继续… ")])
+    : await waitForLogin(page, ctx);
+  // 回车不代表真登上：探活没过就继续等，而不是误报成功
+  if (result === "enter" && !(await sessionIsValid(ctx))) {
+    log("✗ 按了回车但接口探活没通过（登录可能没完成），继续自动等待…");
+    result = await waitForLogin(page, ctx);
+  }
   if (result === "timeout") {
-    log("⚠️  5 分钟内没检测到登录态，已放弃。请重跑 login。");
+    log(`⚠️  ${Math.round(LOGIN_TIMEOUT_MS / 1000)} 秒内没检测到登录态，已放弃。请重跑 login。`);
     await ctx.close();
     process.exit(1);
   }
 
   await page.waitForTimeout(1000);
-  log(`✓ 登录态已保存到 ${PROFILE_DIR}`);
+  log(`✓ 登录成功，会话已保存到 ${PROFILE_DIR}`);
   log(`  当前页面：${page.url()}`);
-  if (!headless) await ctx.close();
-  else await ctx.close();
+  await ctx.close();
 }
 
 /** 自检：依赖 / 配置 / 登录态。排错时先跑这个，比猜快。 */
@@ -193,8 +232,9 @@ async function cmdStatus() {
   await page.goto(APP_URL, { waitUntil: "domcontentloaded" });
   await page.waitForTimeout(3000);
   const url = page.url();
-  const ok = !LOGIN_HINT.test(url.replace(APP_URL, ""));
-  log(ok ? `✓ 登录态有效（${url}）` : `✗ 登录态已失效（${url}）`);
+  // URL 通过只是必要条件：过期 cookie 下 SPA 壳照样落在 /，必须再调一次真接口
+  const ok = !LOGIN_HINT.test(url.replace(APP_URL, "")) && (await sessionIsValid(ctx));
+  log(ok ? `✓ 登录态有效（${url}）` : `✗ 登录态已失效${url ? `（${url}）` : ""}，请重跑 login`);
   await ctx.close();
 
   if (!ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracup-bug",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Tracup 缺陷提单 CLI（免费版无开放 API，走浏览器登录态调网页同款内部接口）",
   "type": "module",
   "license": "MIT",