chainlesschain 0.162.25 → 0.162.27

package/src/commands/__tests__/hub-toutiao-adb-sync.test.js

@@ -0,0 +1,158 @@
+/**
+ * Phase 6c — cc hub toutiao-adb-sync CLI command unit tests.
+ *
+ * Mirror of hub-xhs-adb-sync. Covers profileFetchFailed + CLI no-bridge
+ * short-circuit banner + lastErrorCode propagation.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+
+import { _internal } from "../hub.js";
+
+let logSpy, errSpy;
+let prevExitCode;
+
+function fakeHub(syncResult) {
+  return { toutiaoAdbSync: vi.fn(async (_opts) => syncResult) };
+}
+
+const HAPPY_RESULT = {
+  ok: true,
+  report: {
+    adapter: "social-toutiao",
+    status: "ok",
+    rawCount: 26,
+    entityCounts: { events: 26, persons: 1, places: 0, items: 0, topics: 0 },
+    toutiao: {
+      uid: "12345",
+      nickname: "Alice",
+      eventCounts: {
+        profile: 1,
+        feed: 15,
+        collection: 5,
+        search: 5,
+        total: 26,
+      },
+      lastErrorCode: 0,
+      lastErrorMessage: null,
+      cookieDiagnostic: { cookieCount: 8, hadEncrypted: false },
+      profileFetchFailed: false,
+      signProviderUsed: "ToutiaoSignBridge",
+      signProviderHits: 3,
+      signProviderFallbacks: 0,
+      cleanupFailed: false,
+    },
+  },
+};
+
+beforeEach(() => {
+  logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+  errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+  prevExitCode = process.exitCode;
+  process.exitCode = 0;
+});
+
+afterEach(() => {
+  logSpy.mockRestore();
+  errSpy.mockRestore();
+  process.exitCode = prevExitCode;
+});
+
+describe("cc hub toutiao-adb-sync — happy path", () => {
+  it("prints human summary with nickname", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    expect(hub.toutiaoAdbSync).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/toutiao-adb-sync succeeded/);
+    expect(out).toMatch(/uid:.*12345/);
+    expect(out).toMatch(/nickname:\s+Alice/);
+    expect(out).toMatch(/profile:\s+1/);
+    expect(out).toMatch(/feed:\s+15/);
+    expect(out).toMatch(/collection:\s+5/);
+    expect(out).toMatch(/search:\s+5/);
+    expect(out).toMatch(/total:\s+26/);
+  });
+
+  it("--json outputs raw result", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdToutiaoAdbSync({
+      _getHub: async () => hub,
+      json: true,
+    });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed.ok).toBe(true);
+    expect(parsed.report.toutiao.uid).toBe("12345");
+  });
+
+  it("renders profileFetchFailed warning when set", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.toutiao.profileFetchFailed = true;
+    result.report.toutiao.lastErrorCode = 1;
+    result.report.toutiao.lastErrorMessage = "token expired";
+    result.report.toutiao.uid = null;
+    const hub = fakeHub(result);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/passport\/info\/v2 returned no user_id/);
+    expect(out).toMatch(/profile fetch failed/);
+  });
+
+  it("renders 'no sign bridge' short-circuit banner in CLI context", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.toutiao.signProviderUsed = "none";
+    result.report.toutiao.signProviderHits = 0;
+    result.report.toutiao.signProviderFallbacks = 3;
+    result.report.toutiao.eventCounts.feed = 0;
+    result.report.toutiao.eventCounts.collection = 0;
+    result.report.toutiao.eventCounts.search = 0;
+    result.report.toutiao.eventCounts.total = 1; // just profile
+    result.report.toutiao.lastErrorCode = -99;
+    const hub = fakeHub(result);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/3 signed endpoints short-circuited/);
+    expect(out).toMatch(/no sign bridge in CLI context/);
+  });
+
+  it("renders lastErrorCode partial-result warning (non-(-99))", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.toutiao.lastErrorCode = 412;
+    result.report.toutiao.lastErrorMessage = "HTTP 412";
+    const hub = fakeHub(result);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/partial: lastErrorCode=412/);
+  });
+});
+
+describe("cc hub toutiao-adb-sync — failure paths", () => {
+  function failCase(reason, expectedHint) {
+    return async () => {
+      const hub = fakeHub({ ok: false, reason, message: "synthetic" });
+      await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+      const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+      expect(out).toMatch(new RegExp(`toutiao-adb-sync failed: ${reason}`));
+      if (expectedHint) {
+        expect(out).toMatch(expectedHint);
+      }
+      expect(process.exitCode).toBe(1);
+    };
+  }
+
+  it("BRIDGE_UNAVAILABLE banner", failCase("BRIDGE_UNAVAILABLE", /ADB_PATH/));
+  it("TOUTIAO_NO_ROOT banner", failCase("TOUTIAO_NO_ROOT", /Magisk root/));
+  it(
+    "TOUTIAO_NOT_INSTALLED banner",
+    failCase("TOUTIAO_NOT_INSTALLED", /com\.ss\.android\.article\.news/),
+  );
+  it(
+    "TOUTIAO_COOKIES_INCOMPLETE banner",
+    failCase("TOUTIAO_COOKIES_INCOMPLETE", /sessionid \/ sessionid_ss/),
+  );
+  it(
+    "TOUTIAO_COOKIES_TRUNCATED banner",
+    failCase("TOUTIAO_COOKIES_TRUNCATED", /unplug \+ replug USB/),
+  );
+});

package/src/commands/hub.js

@@ -18,7 +18,7 @@
 import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
-import { getHub } from "../lib/personal-data-hub-wiring.js";
+import { getHub, getHubMinimal } from "../lib/personal-data-hub-wiring.js";
 import { getAIChatWizard } from "../lib/personal-data-hub-aichat-wizard.js";
 
 function printJson(obj) {
@@ -121,6 +121,55 @@ async function cmdAsk(question, options) {
   }
 }
 
+// ─── retrieve-context (LLM-free RAG preflight) ─────────────────────────
+//
+// 2026-05-27 — Bridges Android CLOUD_ANDROID route to RAG. AnalysisEngine
+// already exposes `retrieveContext()` which runs parseQuery → _gatherFacts
+// → buildPrompt and returns the LLM-ready messages WITHOUT calling any
+// LLM. This subcommand surfaces that JSON to stdout so a non-Ollama
+// caller (Android cloud LLM provider — Doubao / DeepSeek / Kimi) can:
+//   1. Spawn `cc hub retrieve-context "<q>" --max-facts 20 --json`
+//   2. Parse JSON → get { messages, factIds, factCount, parsed, ... }
+//   3. POST messages to the cloud LLM provider directly
+//   4. Validate citations from the answer against factIds locally
+//
+// Privacy invariant: retrieveContext does NOT invoke any LLM, so it never
+// touches `acceptNonLocal` — the caller's own gate is the gate. The
+// returned messages contain raw user data (events / persons / items)
+// formatted as the prompt's FACTS block; the caller is responsible for
+// where they POST it.
+
+async function cmdRetrieveContext(question, options) {
+  try {
+    // §S4.1 cold-start optimization — when --minimal (or default to true
+    // since this command never needs adapters), use getHubMinimal which
+    // skips the 50+ adapter registry + KG/RAG sinks + email account auto-
+    // load + ADB extension imports. retrieveContext only touches vault
+    // queries + AnalysisEngine, so the full hub init is wasted work.
+    // In-APK Android cold-start drops from ~90s to <5s. Tests can still
+    // pass _getHub override for stubbing.
+    const useMinimal = options.minimal !== false; // default true
+    const hub = options._getHub
+      ? await options._getHub()
+      : useMinimal
+        ? await getHubMinimal()
+        : await getHub();
+    if (!hub.engine) throw new Error("Analysis engine unavailable");
+    const maxFacts = parsePositiveInt(options.maxFacts);
+    const maxQueryLimit = parsePositiveInt(options.maxQueryLimit);
+    const retrieveOptions = { skipAudit: false };
+    if (maxFacts !== null) retrieveOptions.maxFacts = maxFacts;
+    if (maxQueryLimit !== null) retrieveOptions.maxQueryLimit = maxQueryLimit;
+    const result = await hub.engine.retrieveContext(question, retrieveOptions);
+    // Always JSON output — this command is machine-only by design. The
+    // shape mirrors AnalysisEngine.retrieveContext return + the system
+    // prompt baked in (so the caller doesn't need to re-fetch it).
+    printJson(result);
+  } catch (err) {
+    fail(null, err, true /* json */);
+  }
+}
+
 // ─── stats ────────────────────────────────────────────────────────────
 
 async function cmdStats(options) {
@@ -1192,6 +1241,240 @@ async function cmdXhsAdbSync(options) {
   }
 }
 
+/**
+ * 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`
  *
@@ -1726,6 +2009,25 @@ export function registerHubCommand(program) {
     .option("--json", "Output JSON")
     .action(cmdAsk);
 
+  hub
+    .command("retrieve-context <question>")
+    .description(
+      "RAG preflight — gather facts + build LLM prompt WITHOUT calling LLM (for cloud-LLM callers that need RAG context)",
+    )
+    .option(
+      "--max-facts <n>",
+      "Cap facts in prompt (default 80; on-device small models e.g. Qwen2.5-1.5B should pass 20)",
+    )
+    .option(
+      "--max-query-limit <n>",
+      "Cap vault queryEvents limit (default 200; small-model callers should pass 50)",
+    )
+    .option(
+      "--no-minimal",
+      "Use full hub init (with adapters / KG / RAG sinks). Default uses minimal init (vault + engine only) which is ~10-20x faster on cold-start.",
+    )
+    .action(cmdRetrieveContext);
+
   hub
     .command("stats")
     .description("Vault row counts + registered adapter list + hub paths")
@@ -1819,6 +2121,53 @@ export function registerHubCommand(program) {
     .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")
@@ -2098,6 +2447,7 @@ export function registerHubCommand(program) {
 // real `getHub()` call. The commander wiring above is the runtime path.
 export const _internal = {
   cmdAsk,
+  cmdRetrieveContext,
   parsePositiveInt,
   cmdAIChatList,
   cmdAIChatLogin,
@@ -2115,6 +2465,8 @@ export const _internal = {
   cmdDouyinAdbSync,
   cmdWeiboAdbSync,
   cmdXhsAdbSync,
+  cmdToutiaoAdbSync,
+  cmdKuaishouAdbSync,
   interpretWechatProbe,
   _defaultKnownVendors,
 };

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

@@ -442,6 +442,40 @@ export const PERSONAL_DATA_HUB_HANDLERS = {
       }),
     ),
 
+  // Phase 6c — Toutiao C 路径 one-shot sync (www.toutiao.com cookies +
+  // passport profile + 3 _signature endpoints). CLI/web context with no
+  // desktop bridge: 3 signed endpoints short-circuit (no HTTP). Desktop
+  // wiring uses ToutiaoSignBridge → ~100% hit.
+  "personal-data-hub.toutiao-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.toutiaoAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 6d — Kuaishou C 路径 one-shot sync (www.kuaishou.com cookies +
+  // profile from api_ph payload + 3 GraphQL endpoints with __NS_sig3 +
+  // kpf/kpn). CLI/web context: signed endpoints short-circuit (no HTTP).
+  // Desktop wiring uses KuaishouSignBridge → ~100% hit.
+  "personal-data-hub.kuaishou-adb-sync": async (msg) =>
+    withHub((hub) =>
+      hub.kuaishouAdbSync({
+        limits: msg && msg.limits,
+        stagingDir: msg && msg.stagingDir,
+        displayName: msg && msg.displayName,
+      }),
+    ),
+
+  // Phase 6e — Bridge dry-run doctor. Spins up Xhs / Toutiao / Kuaishou
+  // sign bridges with empty cookie, probes for candidate signing globals,
+  // times each phase. No phone needed. Detects SDK rotation BEFORE the
+  // user starts a real sync. Desktop-only — CLI/web-shell-no-desktop
+  // returns MODULE_LOAD_FAILED.
+  "personal-data-hub.bridge-doctor": async () =>
+    withHub((hub) => hub.bridgeDoctor()),
+
   // ─── Phase 8 — EntityResolver review / merge / unmerge ───────────────
 
   "personal-data-hub.review-queue-list": async (msg) =>