chainlesschain 0.162.20 → 0.162.26

package/src/commands/hub.js

@@ -977,6 +977,733 @@ async function cmdWechatList(options) {
   }
 }
 
+/**
+ * Phase 1c — `cc hub bilibili-adb-sync`
+ *
+ * One-shot Bilibili C 路径 sync: pulls cookies from the user's Android
+ * Bilibili App via ADB, fetches history/favourite/dynamic/follow, writes
+ * a snapshot, and ingests via the existing social-bilibili adapter.
+ *
+ * Requires:
+ *  - `adb` on PATH (or ADB_PATH env var) — see host-adb-bridge.js
+ *  - exactly one Android device attached + authorized (set ADB_SERIAL if
+ *    multiple are present)
+ *  - phone rooted (Bilibili release APK isn't debuggable; we use `su -c
+ *    base64` to read /data/data/tv.danmaku.bili/app_webview/Default/Cookies)
+ *  - user already logged into the Bilibili App on the phone
+ *
+ * Common failure reasons (UI maps these to actionable banners):
+ *  - BRIDGE_UNAVAILABLE — adb missing on host
+ *  - BILIBILI_NOT_INSTALLED_OR_NEVER_LOGGED_IN — Cookies path absent
+ *  - BILIBILI_NO_ROOT — phone isn't rooted
+ *  - BILIBILI_COOKIES_INCOMPLETE — user logged out, or Keystore-wrapped
+ *    cookies we can't decrypt yet
+ *  - SYNC_FAILED — anything else (HTTP / vault error)
+ */
+async function cmdBilibiliAdbSync(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.bilibiliAdbSync({
+      stagingDir: options.stagingDir,
+      displayName: options.displayName,
+      limits:
+        options.limitHistory ||
+        options.limitFavourite ||
+        options.limitDynamic ||
+        options.limitFollow
+          ? {
+              history: parsePositiveInt(options.limitHistory),
+              favourite: parsePositiveInt(options.limitFavourite),
+              dynamic: parsePositiveInt(options.limitDynamic),
+              follow: parsePositiveInt(options.limitFollow),
+            }
+          : undefined,
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ bilibili-adb-sync failed: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      // Inline tips for the common reasons — saves a doc lookup.
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Install Android Platform Tools or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "BILIBILI_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Bilibili release APK isn't debuggable; root + Magisk required to read its Cookies DB",
+          ),
+        );
+      } else if (
+        result.reason === "BILIBILI_NOT_INSTALLED_OR_NEVER_LOGGED_IN"
+      ) {
+        logger.log(
+          chalk.gray(
+            "  Install Bilibili App on the phone + log in once, then retry",
+          ),
+        );
+      } else if (result.reason === "BILIBILI_COOKIES_INCOMPLETE") {
+        logger.log(
+          chalk.gray(
+            "  Cookie file is missing required fields — relog on the phone",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const report = result.report || {};
+    const bili = report.bilibili || {};
+    const counts = bili.eventCounts || {};
+    logger.log(chalk.green(`✓ bilibili-adb-sync succeeded`));
+    logger.log(`  uid:        ${chalk.cyan(bili.uid)}`);
+    logger.log(`  history:    ${counts.history || 0}`);
+    logger.log(`  favourite:  ${counts.favourite || 0}`);
+    logger.log(`  dynamic:    ${counts.dynamic || 0}`);
+    logger.log(`  follow:     ${counts.follow || 0}`);
+    logger.log(`  total:      ${counts.total || 0}`);
+    if (bili.lastErrorCode) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ partial: lastErrorCode=${bili.lastErrorCode} (${bili.lastErrorMessage || "?"})`,
+        ),
+      );
+    }
+    logger.log(`  status:     ${report.status || "?"}`);
+    logger.log(`  rawCount:   ${report.rawCount || 0}`);
+    const ec = report.entityCounts || {};
+    logger.log(`  events:     ${ec.events || 0}`);
+    if (bili.cleanupFailed) {
+      logger.log(
+        chalk.gray(`  (note: staging file cleanup failed — non-fatal)`),
+      );
+    }
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
+/**
+ * Phase 3c — `cc hub xhs-adb-sync`
+ *
+ * Pulls xiaohongshu.com cookies from the user's Android Xhs App, fetches
+ * userId + 3 endpoints (notes/liked/follows, X-S signed best-effort).
+ * Inline tip per typed reason codes + meFetchFailed warning.
+ */
+async function cmdXhsAdbSync(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.xhsAdbSync({
+      stagingDir: options.stagingDir,
+      displayName: options.displayName,
+      limits:
+        options.limitNote || options.limitLiked || options.limitFollow
+          ? {
+              note: parsePositiveInt(options.limitNote),
+              liked: parsePositiveInt(options.limitLiked),
+              follow: parsePositiveInt(options.limitFollow),
+            }
+          : undefined,
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ xhs-adb-sync failed: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Install Android Platform Tools or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "XHS_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Phone needs Magisk root — Xhs release APK isn't debuggable",
+          ),
+        );
+      } else if (result.reason === "XHS_NOT_INSTALLED") {
+        logger.log(
+          chalk.gray(
+            "  Install Xiaohongshu App on the phone + log in once, then retry",
+          ),
+        );
+      } else if (result.reason === "XHS_COOKIES_INCOMPLETE") {
+        logger.log(
+          chalk.gray(
+            "  a1 / web_session cookie missing — relog on the Xhs App",
+          ),
+        );
+      } else if (
+        result.reason === "XHS_COOKIES_TRUNCATED" ||
+        result.reason === "XHS_NOT_SQLITE"
+      ) {
+        logger.log(
+          chalk.gray(
+            "  ADB stream may be corrupted; unplug + replug USB and retry",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const report = result.report || {};
+    const xhs = report.xhs || {};
+    const counts = xhs.eventCounts || {};
+    logger.log(chalk.green(`✓ xhs-adb-sync succeeded`));
+    logger.log(
+      `  userId:     ${chalk.cyan(xhs.userId || "(me fetch failed)")}`,
+    );
+    if (xhs.nickname) {
+      logger.log(`  nickname:   ${xhs.nickname}`);
+    }
+    logger.log(`  notes:      ${counts.note || 0}`);
+    logger.log(`  liked:      ${counts.liked || 0}`);
+    logger.log(`  follows:    ${counts.follow || 0}`);
+    logger.log(`  total:      ${counts.total || 0}`);
+    logger.log(`  status:     ${report.status || "?"}`);
+    logger.log(`  rawCount:   ${report.rawCount || 0}`);
+    if (xhs.meFetchFailed) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ /user/me returned no user_id — cookie expired or web_session missing (lastErrorCode=${xhs.lastErrorCode})`,
+        ),
+      );
+    } else if (xhs.lastErrorCode) {
+      // X-S sign best-effort: ~60% GET hit, <30% POST hit; 461 = X-S rejected
+      logger.log(
+        chalk.yellow(
+          `  ⚠ partial: lastErrorCode=${xhs.lastErrorCode} (${xhs.lastErrorMessage || "?"}) — X-S 签名 best-effort, 部分接口 461 可能正常`,
+        ),
+      );
+    }
+    if (xhs.cleanupFailed) {
+      logger.log(chalk.gray(`  (note: staging cleanup failed — non-fatal)`));
+    }
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
+/**
+ * Phase 6d — `cc hub kuaishou-adb-sync`
+ *
+ * Pulls www.kuaishou.com cookies from the user's Android Kuaishou App,
+ * fetches uid + profile via cookie's api_ph payload (PURE COOKIE PARSE,
+ * no HTTP) + 3 signed GraphQL endpoints (watch / collect / search).
+ * CLI context has NO sign bridge — 3 signed endpoints short-circuit
+ * with lastErrorCode=-99. Desktop wiring upgrades via KuaishouSignBridge.
+ */
+async function cmdKuaishouAdbSync(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.kuaishouAdbSync({
+      stagingDir: options.stagingDir,
+      displayName: options.displayName,
+      limits:
+        options.limitWatch || options.limitCollect || options.limitSearch
+          ? {
+              watch: parsePositiveInt(options.limitWatch),
+              collect: parsePositiveInt(options.limitCollect),
+              search: parsePositiveInt(options.limitSearch),
+            }
+          : undefined,
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ kuaishou-adb-sync failed: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Install Android Platform Tools or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "KUAISHOU_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Phone needs Magisk root — Kuaishou release APK isn't debuggable",
+          ),
+        );
+      } else if (result.reason === "KUAISHOU_NOT_INSTALLED") {
+        logger.log(
+          chalk.gray(
+            "  Install 快手 (com.smile.gifmaker, NOT 极速版 com.kuaishou.nebula) + log in once + open any video (WebView populates cookies), then retry",
+          ),
+        );
+      } else if (result.reason === "KUAISHOU_COOKIES_INCOMPLETE") {
+        logger.log(
+          chalk.gray(
+            "  userId / kuaishou.web.cp.api_ph missing — relog on the Kuaishou App",
+          ),
+        );
+      } else if (
+        result.reason === "KUAISHOU_COOKIES_TRUNCATED" ||
+        result.reason === "KUAISHOU_NOT_SQLITE"
+      ) {
+        logger.log(
+          chalk.gray(
+            "  ADB stream may be corrupted; unplug + replug USB and retry",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const report = result.report || {};
+    const kuaishou = report.kuaishou || {};
+    const counts = kuaishou.eventCounts || {};
+    logger.log(chalk.green(`✓ kuaishou-adb-sync succeeded`));
+    logger.log(
+      `  uid:        ${chalk.cyan(kuaishou.uid || "(profile fetch failed)")}`,
+    );
+    if (kuaishou.nickname) {
+      logger.log(`  nickname:   ${kuaishou.nickname}`);
+    }
+    logger.log(`  profile:    ${counts.profile || 0}`);
+    logger.log(`  watch:      ${counts.watch || 0}`);
+    logger.log(`  collect:    ${counts.collect || 0}`);
+    logger.log(`  search:     ${counts.search || 0}`);
+    logger.log(`  total:      ${counts.total || 0}`);
+    logger.log(`  status:     ${report.status || "?"}`);
+    logger.log(`  rawCount:   ${report.rawCount || 0}`);
+    if (kuaishou.profileFetchFailed) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ cookie 缺 kuaishou.web.cp.api_ph — relog on Kuaishou (lastErrorCode=${kuaishou.lastErrorCode})`,
+        ),
+      );
+    } else if (
+      kuaishou.signProviderUsed === "none" &&
+      counts.watch === 0 &&
+      counts.collect === 0 &&
+      counts.search === 0
+    ) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ 3 signed endpoints short-circuited (no sign bridge in CLI context) — run from desktop app to enable __NS_sig3 via Electron WebContentsView`,
+        ),
+      );
+    } else if (kuaishou.lastErrorCode) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ partial: lastErrorCode=${kuaishou.lastErrorCode} (${kuaishou.lastErrorMessage || "?"})`,
+        ),
+      );
+    }
+    if (kuaishou.cleanupFailed) {
+      logger.log(chalk.gray(`  (note: staging cleanup failed — non-fatal)`));
+    }
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
+/**
+ * Phase 6c — `cc hub toutiao-adb-sync`
+ *
+ * Pulls www.toutiao.com cookies from the user's Android Toutiao App,
+ * fetches uid + profile (no _sig) + 3 signed endpoints (feed / collection
+ * / search). CLI context has NO sign bridge — 3 signed endpoints short-
+ * circuit with lastErrorCode=-99 (no HTTP traffic). Desktop wiring
+ * upgrades via ToutiaoSignBridge (Electron WebContentsView).
+ */
+async function cmdToutiaoAdbSync(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.toutiaoAdbSync({
+      stagingDir: options.stagingDir,
+      displayName: options.displayName,
+      limits:
+        options.limitFeed || options.limitCollection || options.limitSearch
+          ? {
+              feed: parsePositiveInt(options.limitFeed),
+              collection: parsePositiveInt(options.limitCollection),
+              search: parsePositiveInt(options.limitSearch),
+            }
+          : undefined,
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ toutiao-adb-sync failed: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Install Android Platform Tools or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "TOUTIAO_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Phone needs Magisk root — Toutiao release APK isn't debuggable",
+          ),
+        );
+      } else if (result.reason === "TOUTIAO_NOT_INSTALLED") {
+        logger.log(
+          chalk.gray(
+            "  Install 今日头条 (com.ss.android.article.news, NOT 极速版/.lite) + log in once + open any article (WebView populates cookies), then retry",
+          ),
+        );
+      } else if (result.reason === "TOUTIAO_COOKIES_INCOMPLETE") {
+        logger.log(
+          chalk.gray(
+            "  sessionid / sessionid_ss missing — relog on the Toutiao App",
+          ),
+        );
+      } else if (
+        result.reason === "TOUTIAO_COOKIES_TRUNCATED" ||
+        result.reason === "TOUTIAO_NOT_SQLITE"
+      ) {
+        logger.log(
+          chalk.gray(
+            "  ADB stream may be corrupted; unplug + replug USB and retry",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const report = result.report || {};
+    const toutiao = report.toutiao || {};
+    const counts = toutiao.eventCounts || {};
+    logger.log(chalk.green(`✓ toutiao-adb-sync succeeded`));
+    logger.log(
+      `  uid:        ${chalk.cyan(toutiao.uid || "(profile fetch failed)")}`,
+    );
+    if (toutiao.nickname) {
+      logger.log(`  nickname:   ${toutiao.nickname}`);
+    }
+    logger.log(`  profile:    ${counts.profile || 0}`);
+    logger.log(`  feed:       ${counts.feed || 0}`);
+    logger.log(`  collection: ${counts.collection || 0}`);
+    logger.log(`  search:     ${counts.search || 0}`);
+    logger.log(`  total:      ${counts.total || 0}`);
+    logger.log(`  status:     ${report.status || "?"}`);
+    logger.log(`  rawCount:   ${report.rawCount || 0}`);
+    if (toutiao.profileFetchFailed) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ passport/info/v2 returned no user_id — cookie expired or sessionid missing (lastErrorCode=${toutiao.lastErrorCode})`,
+        ),
+      );
+    } else if (
+      toutiao.signProviderUsed === "none" &&
+      counts.feed === 0 &&
+      counts.collection === 0 &&
+      counts.search === 0
+    ) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ 3 signed endpoints short-circuited (no sign bridge in CLI context) — run from desktop app to enable _signature via Electron WebContentsView`,
+        ),
+      );
+    } else if (toutiao.lastErrorCode) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ partial: lastErrorCode=${toutiao.lastErrorCode} (${toutiao.lastErrorMessage || "?"})`,
+        ),
+      );
+    }
+    if (toutiao.cleanupFailed) {
+      logger.log(chalk.gray(`  (note: staging cleanup failed — non-fatal)`));
+    }
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
+/**
+ * Phase 3a — `cc hub weibo-adb-sync`
+ *
+ * Pulls m.weibo.cn cookies from the user's Android Weibo App, fetches
+ * UID + 3 endpoints (posts/favourites/follows), ingests via social-weibo
+ * adapter snapshot mode. Inline tip per typed reason codes.
+ */
+async function cmdWeiboAdbSync(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.weiboAdbSync({
+      stagingDir: options.stagingDir,
+      displayName: options.displayName,
+      limits:
+        options.limitPost || options.limitFavourite || options.limitFollow
+          ? {
+              post: parsePositiveInt(options.limitPost),
+              favourite: parsePositiveInt(options.limitFavourite),
+              follow: parsePositiveInt(options.limitFollow),
+            }
+          : undefined,
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ weibo-adb-sync failed: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Install Android Platform Tools or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "WEIBO_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Phone needs Magisk root — Weibo release APK isn't debuggable",
+          ),
+        );
+      } else if (result.reason === "WEIBO_NOT_INSTALLED") {
+        logger.log(
+          chalk.gray(
+            "  Install Weibo App on the phone + log in once, then retry",
+          ),
+        );
+      } else if (result.reason === "WEIBO_COOKIES_INCOMPLETE") {
+        logger.log(
+          chalk.gray(
+            "  SUB cookie missing — relog on the Weibo App (or app uses non-default WebView profile dir)",
+          ),
+        );
+      } else if (
+        result.reason === "WEIBO_COOKIES_TRUNCATED" ||
+        result.reason === "WEIBO_NOT_SQLITE"
+      ) {
+        logger.log(
+          chalk.gray(
+            "  ADB stream may be corrupted; unplug + replug USB and retry",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const report = result.report || {};
+    const wb = report.weibo || {};
+    const counts = wb.eventCounts || {};
+    logger.log(chalk.green(`✓ weibo-adb-sync succeeded`));
+    logger.log(`  uid:        ${chalk.cyan(wb.uid || "(uid fetch failed)")}`);
+    logger.log(`  posts:      ${counts.post || 0}`);
+    logger.log(`  favourites: ${counts.favourite || 0}`);
+    logger.log(`  follows:    ${counts.follow || 0}`);
+    logger.log(`  total:      ${counts.total || 0}`);
+    logger.log(`  status:     ${report.status || "?"}`);
+    logger.log(`  rawCount:   ${report.rawCount || 0}`);
+    if (wb.uidFetchFailed) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ /api/config returned login=false — cookie expired or anti-bot redirect (lastErrorCode=${wb.lastErrorCode})`,
+        ),
+      );
+    } else if (wb.lastErrorCode) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ partial: lastErrorCode=${wb.lastErrorCode} (${wb.lastErrorMessage || "?"})`,
+        ),
+      );
+    }
+    if (wb.cleanupFailed) {
+      logger.log(chalk.gray(`  (note: staging cleanup failed — non-fatal)`));
+    }
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
+/**
+ * Phase 2a — `cc hub douyin-adb-sync`
+ *
+ * Pulls <uid>_im.db from the user's Android Douyin App, parses msg +
+ * SIMPLE_USER (abrignoni DFIR schema), ingests via social-douyin adapter
+ * snapshot mode. Inline tip per 9 typed reason codes.
+ */
+async function cmdDouyinAdbSync(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.douyinAdbSync({
+      uid: options.uid,
+      stagingDir: options.stagingDir,
+      displayName: options.displayName,
+      limits:
+        options.limitMessages || options.limitContacts
+          ? {
+              messages: parsePositiveInt(options.limitMessages),
+              contacts: parsePositiveInt(options.limitContacts),
+            }
+          : undefined,
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ douyin-adb-sync failed: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Install Android Platform Tools or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "DOUYIN_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Phone needs Magisk root — Douyin release APK isn't debuggable",
+          ),
+        );
+      } else if (result.reason === "DOUYIN_NOT_INSTALLED") {
+        logger.log(chalk.gray("  Install Douyin App on the phone, then retry"));
+      } else if (result.reason === "DOUYIN_NO_IM_DB") {
+        logger.log(
+          chalk.gray(
+            "  Log in to Douyin App + open any chat thread to materialize the IM database",
+          ),
+        );
+      } else if (result.reason === "DOUYIN_MULTIPLE_USERS") {
+        logger.log(
+          chalk.gray(
+            "  Multiple accounts on this phone — pass --uid <19-digit> to pick one",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const report = result.report || {};
+    const dy = report.douyin || {};
+    const counts = dy.eventCounts || {};
+    logger.log(chalk.green(`✓ douyin-adb-sync succeeded`));
+    logger.log(`  uid:        ${chalk.cyan(dy.uid)}`);
+    logger.log(`  messages:   ${counts.message || 0}`);
+    logger.log(`  contacts:   ${counts.contact || 0}`);
+    logger.log(`  total:      ${counts.total || 0}`);
+    logger.log(`  status:     ${report.status || "?"}`);
+    logger.log(`  rawCount:   ${report.rawCount || 0}`);
+    const diag = dy.parserDiagnostic || {};
+    if (!diag.hadMsgTable) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ msg table not found — Douyin App version may use a different IM schema`,
+        ),
+      );
+    }
+    if (!diag.hadSimpleUserTable) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ SIMPLE_USER table not found — contacts won't be ingested`,
+        ),
+      );
+    }
+    if (dy.cleanupFailed) {
+      logger.log(chalk.gray(`  (note: staging cleanup failed — non-fatal)`));
+    }
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
+/**
+ * Phase 1e — `cc hub bilibili-adb-doctor`
+ *
+ * Dry-run env probe. Runs only the cookies-extraction half of the sync
+ * pipeline (no api.bilibili.com calls, no vault writes) so the user can
+ * confirm root + Bilibili-installed + cookie-complete BEFORE triggering
+ * a real sync. Surfaces the same 9 typed reasons as bilibili-adb-sync
+ * but with a green "✓ ready to sync" message on success.
+ *
+ * Use this as the first command in a real-device E2E session.
+ */
+async function cmdBilibiliAdbDoctor(options) {
+  try {
+    const hub = await (options._getHub || getHub)();
+    const result = await hub.bilibiliAdbDoctor();
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    if (!result.ok) {
+      logger.log(chalk.red(`✗ bilibili-adb-doctor: ${result.reason}`));
+      logger.log(chalk.gray(`  ${result.message || ""}`));
+      if (result.reason === "BRIDGE_UNAVAILABLE") {
+        logger.log(
+          chalk.gray(
+            "  Fix: install Android Platform Tools, or set ADB_PATH=/path/to/adb",
+          ),
+        );
+      } else if (result.reason === "BILIBILI_NO_ROOT") {
+        logger.log(
+          chalk.gray(
+            "  Fix: phone needs Magisk root — Bilibili release APK isn't debuggable",
+          ),
+        );
+      } else if (
+        result.reason === "BILIBILI_NOT_INSTALLED_OR_NEVER_LOGGED_IN"
+      ) {
+        logger.log(
+          chalk.gray("  Fix: install Bilibili App + log in once on the phone"),
+        );
+      } else if (result.reason === "BILIBILI_COOKIES_INCOMPLETE") {
+        logger.log(
+          chalk.gray(
+            "  Fix: relog on the Bilibili App — required cookies are missing",
+          ),
+        );
+      } else if (
+        result.reason === "BILIBILI_COOKIES_TRUNCATED" ||
+        result.reason === "BILIBILI_NOT_SQLITE"
+      ) {
+        logger.log(
+          chalk.gray(
+            "  Fix: ADB stream may be corrupted; unplug + replug USB and retry",
+          ),
+        );
+      }
+      process.exitCode = 1;
+      return;
+    }
+    const diag = result.cookieDiagnostic || {};
+    logger.log(chalk.green(`✓ bilibili-adb-doctor: env ready to sync`));
+    logger.log(`  uid:                 ${chalk.cyan(result.uid)}`);
+    logger.log(`  cookies found:       ${diag.cookieCount || "?"}`);
+    if (diag.hadEncrypted) {
+      logger.log(
+        chalk.yellow(
+          `  ⚠ encrypted rows:    some cookies are Android-Keystore-wrapped (skipped)`,
+        ),
+      );
+      logger.log(
+        chalk.gray(
+          `  This may indicate a newer Bilibili App on Android 14+ using Keystore wrap.`,
+        ),
+      );
+    }
+    logger.log(
+      `  extracted at:        ${new Date(result.extractedAt).toISOString()}`,
+    );
+    logger.log(
+      chalk.gray(
+        `\n  Next: run \`cc hub bilibili-adb-sync\` to ingest 4 endpoints.`,
+      ),
+    );
+  } catch (err) {
+    fail(null, err, options.json);
+  }
+}
+
 /**
  * `cc hub wechat doctor` — env-probe + actionable interpretation +
  * inline reference to the Phase 12.9 §5.1 Frida hook trap table.
@@ -1273,6 +2000,155 @@ export function registerHubCommand(program) {
     .option("--json", "Output JSON")
     .action(cmdSyncAll);
 
+  // Phase 1c — Bilibili C 路径 one-shot
+  hub
+    .command("bilibili-adb-sync")
+    .description(
+      "Bilibili C 路径: pull cookies via ADB from the user's Android Bilibili App, fetch 4 endpoints, ingest as snapshot. Needs rooted Android + Bilibili App logged in + `adb` on PATH.",
+    )
+    .option("--limit-history <n>", "Cap history items (default 200)")
+    .option(
+      "--limit-favourite <n>",
+      "Cap favourite items per folder (default 50)",
+    )
+    .option("--limit-dynamic <n>", "Cap dynamic items (default 50)")
+    .option("--limit-follow <n>", "Cap follow items (default 200)")
+    .option(
+      "--display-name <s>",
+      "Account displayName for the snapshot (default empty)",
+    )
+    .option(
+      "--staging-dir <path>",
+      "Custom dir for the temp snapshot JSON (default os.tmpdir())",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdBilibiliAdbSync);
+
+  // Phase 1e — dry-run env probe (cookies only, no API, no vault write)
+  hub
+    .command("bilibili-adb-doctor")
+    .description(
+      "Bilibili C 路径 dry-run: probe adb + root + Bilibili App + cookies completeness without triggering a sync. Use this BEFORE `cc hub bilibili-adb-sync` to debug env issues.",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdBilibiliAdbDoctor);
+
+  // Phase 3a — Weibo C 路径 one-shot (m.weibo.cn cookies + 4 endpoints, sign-less)
+  hub
+    .command("weibo-adb-sync")
+    .description(
+      "Weibo C 路径: pull m.weibo.cn cookies via ADB from the user's Android Weibo App, fetch UID + 3 endpoints (posts/favourites/follows), ingest as snapshot. Needs rooted Android + Weibo App logged in + `adb` on PATH. No X-Bogus / WBI signing required.",
+    )
+    .option("--limit-post <n>", "Cap user-timeline posts (default 100)")
+    .option("--limit-favourite <n>", "Cap favourite items (default 100)")
+    .option("--limit-follow <n>", "Cap follow items (default 200)")
+    .option(
+      "--display-name <s>",
+      "Account displayName for the snapshot (default empty)",
+    )
+    .option(
+      "--staging-dir <path>",
+      "Custom dir for the temp snapshot JSON (default os.tmpdir())",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdWeiboAdbSync);
+
+  // Phase 6d — Kuaishou C 路径 one-shot (www.kuaishou.com cookies + profile
+  // from api_ph + 3 GraphQL endpoints with __NS_sig3 + kpf/kpn).
+  // CLI: signed endpoints short-circuit. Desktop: KuaishouSignBridge.
+  hub
+    .command("kuaishou-adb-sync")
+    .description(
+      "Kuaishou C 路径: pull www.kuaishou.com cookies via ADB from the user's Android Kuaishou App (com.smile.gifmaker, NOT 极速版 com.kuaishou.nebula), parse profile from kuaishou.web.cp.api_ph cookie payload (no HTTP) + 3 GraphQL endpoints (watch/collect/search, __NS_sig3 + kpf/kpn — CLI short-circuits, desktop uses KuaishouSignBridge). Needs rooted Android + Kuaishou App logged in once + opened a video once + `adb` on PATH.",
+    )
+    .option(
+      "--limit-watch <n>",
+      "Cap recommended feed watch history (default 50)",
+    )
+    .option("--limit-collect <n>", "Cap own posted photos (default 100)")
+    .option("--limit-search <n>", "Cap search history (default 50)")
+    .option(
+      "--display-name <s>",
+      "Account displayName for the snapshot (default = api_ph user_name)",
+    )
+    .option(
+      "--staging-dir <path>",
+      "Custom dir for the temp snapshot JSON (default os.tmpdir())",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdKuaishouAdbSync);
+
+  // Phase 6c — Toutiao C 路径 one-shot (www.toutiao.com cookies + profile +
+  // 3 endpoints with _signature). CLI context: signed endpoints short-circuit
+  // (-99) with no HTTP traffic. Desktop: ToutiaoSignBridge → ~100% hit.
+  hub
+    .command("toutiao-adb-sync")
+    .description(
+      "Toutiao C 路径: pull www.toutiao.com cookies via ADB from the user's Android Toutiao App (com.ss.android.article.news, NOT 极速版), fetch profile (no _sig) + 3 endpoints (feed/collection/search, _signature required — CLI short-circuits, desktop uses ToutiaoSignBridge). Needs rooted Android + Toutiao App logged in once + `adb` on PATH.",
+    )
+    .option("--limit-feed <n>", "Cap recommended feed (default 50)")
+    .option("--limit-collection <n>", "Cap saved articles (default 200)")
+    .option("--limit-search <n>", "Cap search history (default 100)")
+    .option(
+      "--display-name <s>",
+      "Account displayName for the snapshot (default = passport screen_name)",
+    )
+    .option(
+      "--staging-dir <path>",
+      "Custom dir for the temp snapshot JSON (default os.tmpdir())",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdToutiaoAdbSync);
+
+  // Phase 3c — Xhs C 路径 one-shot (xiaohongshu.com cookies + 4 endpoints with X-S signing)
+  hub
+    .command("xhs-adb-sync")
+    .description(
+      "Xhs C 路径: pull xiaohongshu.com cookies via ADB from the user's Android Xhs App, fetch userId + 3 endpoints (notes/liked/follows). Best-effort X-S signing (~60% GET hit rate). Needs rooted Android + Xhs App logged in + `adb` on PATH.",
+    )
+    .option("--limit-note <n>", "Cap user notes (default 30)")
+    .option("--limit-liked <n>", "Cap liked notes (default 30)")
+    .option("--limit-follow <n>", "Cap follow list (default 100)")
+    .option(
+      "--display-name <s>",
+      "Account displayName for the snapshot (default = xhs nickname)",
+    )
+    .option(
+      "--staging-dir <path>",
+      "Custom dir for the temp snapshot JSON (default os.tmpdir())",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdXhsAdbSync);
+
+  // Phase 2a — Douyin C 路径 one-shot (pull <uid>_im.db → parse abrignoni DFIR schema)
+  hub
+    .command("douyin-adb-sync")
+    .description(
+      "Douyin C 路径: pull <uid>_im.db cohort via ADB from the user's Android Douyin App, parse msg + SIMPLE_USER (abrignoni DFIR), ingest as snapshot. Needs rooted Android + Douyin App logged in + `adb` on PATH.",
+    )
+    .option(
+      "--uid <id>",
+      "19-digit Douyin uid — required when multiple accounts logged in on the phone",
+    )
+    .option(
+      "--limit-messages <n>",
+      "Cap msg rows from the IM db (default 10000)",
+    )
+    .option(
+      "--limit-contacts <n>",
+      "Cap SIMPLE_USER rows from the IM db (default 5000)",
+    )
+    .option(
+      "--display-name <s>",
+      "Account displayName for the snapshot (default empty)",
+    )
+    .option(
+      "--staging-dir <path>",
+      "Custom dir for the temp snapshot JSON (default os.tmpdir())",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdDouyinAdbSync);
+
   hub
     .command("rederive")
     .description(
@@ -1515,6 +2391,13 @@ export const _internal = {
   cmdWechatList,
   cmdWechatUnregister,
   cmdWechatDoctor,
+  cmdBilibiliAdbSync,
+  cmdBilibiliAdbDoctor,
+  cmdDouyinAdbSync,
+  cmdWeiboAdbSync,
+  cmdXhsAdbSync,
+  cmdToutiaoAdbSync,
+  cmdKuaishouAdbSync,
   interpretWechatProbe,
   _defaultKnownVendors,
 };