chainlesschain 0.162.20 → 0.162.25

package/src/commands/hub.js

@@ -977,6 +977,499 @@ 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 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 +1766,108 @@ 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 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 +2110,11 @@ export const _internal = {
   cmdWechatList,
   cmdWechatUnregister,
   cmdWechatDoctor,
+  cmdBilibiliAdbSync,
+  cmdBilibiliAdbDoctor,
+  cmdDouyinAdbSync,
+  cmdWeiboAdbSync,
+  cmdXhsAdbSync,
   interpretWechatProbe,
   _defaultKnownVendors,
 };

package/src/gateways/ws/personal-data-hub-protocol.js

@@ -392,6 +392,56 @@ export const PERSONAL_DATA_HUB_HANDLERS = {
   "personal-data-hub.list-wechat-accounts": async () =>
     withHub((hub) => hub.listWechatAccounts()),
 
+  // ─── Phase 1c — Bilibili C 路径 one-shot sync ─────────────────────────
+  //
+  // Pulls cookies from the user's Android Bilibili App via ADB, fetches 4
+  // endpoints, ingests as a snapshot. Returns the standard
+  // `{ok, report?, reason?, message?}` shape — see hub.bilibiliAdbSync for
+  // the full reason taxonomy. UI maps reasons to banner strings.
+  "personal-data-hub.bilibili-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.bilibiliAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 1e — dry-run env probe (cookies path only, no API calls / vault writes)
+  "personal-data-hub.bilibili-adb-doctor": async () =>
+    withHub((hub) => hub.bilibiliAdbDoctor()),
+
+  // Phase 2a — Douyin C 路径 one-shot sync (db extraction)
+  "personal-data-hub.douyin-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.douyinAdbSync({
+        uid: msg && msg.uid,
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 3a — Weibo C 路径 one-shot sync (m.weibo.cn cookies + 4 endpoints)
+  "personal-data-hub.weibo-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.weiboAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 3c — Xhs C 路径 one-shot sync (xiaohongshu.com cookies + 4 endpoints X-S signed)
+  "personal-data-hub.xhs-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.xhsAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
   // ─── Phase 8 — EntityResolver review / merge / unmerge ───────────────
 
   "personal-data-hub.review-queue-list": async (msg) =>