chainlesschain 0.162.25 → 0.162.26

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

@@ -0,0 +1,161 @@
+/**
+ * Phase 6d — cc hub kuaishou-adb-sync CLI command unit tests.
+ *
+ * Mirror of hub-toutiao-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 { kuaishouAdbSync: vi.fn(async (_opts) => syncResult) };
+}
+
+const HAPPY_RESULT = {
+  ok: true,
+  report: {
+    adapter: "social-kuaishou",
+    status: "ok",
+    rawCount: 26,
+    entityCounts: { events: 26, persons: 1, places: 0, items: 0, topics: 0 },
+    kuaishou: {
+      uid: "12345",
+      nickname: "Alice",
+      eventCounts: {
+        profile: 1,
+        watch: 15,
+        collect: 5,
+        search: 5,
+        total: 26,
+      },
+      lastErrorCode: 0,
+      lastErrorMessage: null,
+      cookieDiagnostic: { cookieCount: 8, hadEncrypted: false },
+      profileFetchFailed: false,
+      signProviderUsed: "KuaishouSignBridge",
+      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 kuaishou-adb-sync — happy path", () => {
+  it("prints human summary with nickname", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    expect(hub.kuaishouAdbSync).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/kuaishou-adb-sync succeeded/);
+    expect(out).toMatch(/uid:.*12345/);
+    expect(out).toMatch(/nickname:\s+Alice/);
+    expect(out).toMatch(/profile:\s+1/);
+    expect(out).toMatch(/watch:\s+15/);
+    expect(out).toMatch(/collect:\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.cmdKuaishouAdbSync({
+      _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.kuaishou.uid).toBe("12345");
+  });
+
+  it("renders profileFetchFailed warning when set", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.kuaishou.profileFetchFailed = true;
+    result.report.kuaishou.lastErrorCode = -8;
+    result.report.kuaishou.uid = null;
+    const hub = fakeHub(result);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/cookie 缺 kuaishou\.web\.cp\.api_ph/);
+    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.kuaishou.signProviderUsed = "none";
+    result.report.kuaishou.signProviderHits = 0;
+    result.report.kuaishou.signProviderFallbacks = 3;
+    result.report.kuaishou.eventCounts.watch = 0;
+    result.report.kuaishou.eventCounts.collect = 0;
+    result.report.kuaishou.eventCounts.search = 0;
+    result.report.kuaishou.eventCounts.total = 1;
+    result.report.kuaishou.lastErrorCode = -99;
+    const hub = fakeHub(result);
+    await _internal.cmdKuaishouAdbSync({ _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/);
+    expect(out).toMatch(/__NS_sig3 via Electron WebContentsView/);
+  });
+
+  it("renders lastErrorCode partial-result warning (non-(-99))", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.kuaishou.lastErrorCode = 412;
+    result.report.kuaishou.lastErrorMessage = "HTTP 412";
+    const hub = fakeHub(result);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/partial: lastErrorCode=412/);
+  });
+});
+
+describe("cc hub kuaishou-adb-sync — failure paths", () => {
+  function failCase(reason, expectedHint) {
+    return async () => {
+      const hub = fakeHub({ ok: false, reason, message: "synthetic" });
+      await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+      const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+      expect(out).toMatch(new RegExp(`kuaishou-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("KUAISHOU_NO_ROOT banner", failCase("KUAISHOU_NO_ROOT", /Magisk root/));
+  it(
+    "KUAISHOU_NOT_INSTALLED banner",
+    failCase("KUAISHOU_NOT_INSTALLED", /com\.smile\.gifmaker/),
+  );
+  it(
+    "KUAISHOU_COOKIES_INCOMPLETE banner",
+    failCase(
+      "KUAISHOU_COOKIES_INCOMPLETE",
+      /userId \/ kuaishou\.web\.cp\.api_ph/,
+    ),
+  );
+  it(
+    "KUAISHOU_COOKIES_TRUNCATED banner",
+    failCase("KUAISHOU_COOKIES_TRUNCATED", /unplug \+ replug USB/),
+  );
+});

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

@@ -1192,6 +1192,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`
  *
@@ -1819,6 +2053,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")
@@ -2115,6 +2396,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) =>