@gobing-ai/knowledge-kit 0.0.30 → 0.0.32

package/plugins/publishings/xhs-pub/dist/index.js

@@ -14671,7 +14671,7 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/errors.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/errors.js
 var ErrorCode;
 var init_errors3 = __esm(() => {
   ErrorCode = {
@@ -14682,7 +14682,7 @@ var init_errors3 = __esm(() => {
   };
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/api-response.js
 var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
 var init_api_response = __esm(() => {
   init_errors3();
@@ -14705,10 +14705,10 @@ var init_api_response = __esm(() => {
   CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/cursor.js
 var init_cursor = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/env.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/env.js
 function getEnvVar(name, fallback) {
   const raw = process.env[name];
   return raw === undefined ? fallback : raw;
@@ -14717,10 +14717,10 @@ function getEnvVars() {
   return process.env;
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
 var init_event_severity = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/object.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/object.js
 function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -14738,7 +14738,7 @@ function deepMerge(target, source) {
   return result;
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/output.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/output.js
 function processStream(name) {
   const proc = globalThis.process;
   const stream = proc?.[name];
@@ -14756,7 +14756,7 @@ function echoError(message, target = defaultStderrTarget ?? processStream("stder
 }
 var defaultStderrTarget;
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/index.js
 var init_dist = __esm(() => {
   init_api_response();
   init_cursor();
@@ -21754,7 +21754,7 @@ var init_dist2 = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/config.js
 function getProcessEnv() {
   return getEnvVars();
 }
@@ -21832,7 +21832,7 @@ var init_config = __esm(() => {
   };
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21919,7 +21919,7 @@ function findProjectRoot(startDir) {
 }
 var init_file_system_node = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/db-errors.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/db-errors.js
 var DbModuleNotInstalledError;
 var init_db_errors = __esm(() => {
   DbModuleNotInstalledError = class DbModuleNotInstalledError extends Error {
@@ -29130,7 +29130,7 @@ var init_execa = __esm(() => {
   } = getIpcExport());
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/process-group.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/process-group.js
 function resolveDeadline(optionTimeout, defaultTimeout) {
   if (optionTimeout === null)
     return null;
@@ -29222,7 +29222,7 @@ function ownProcessGroupLifecycle(ownership) {
 }
 var MAX_TIMEOUT_MS = 2147483647, DEFAULT_KILL_GRACE_MS = 5000, GROUP_POLL_INTERVAL_MS = 25, GROUP_KILL_PATIENCE_MS = 2000;
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/process-executor.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/process-executor.js
 import { isatty } from "tty";
 function processEventSeverity(reason, exitCode) {
   if (reason === "error")
@@ -29594,7 +29594,7 @@ var init_process_executor = __esm(() => {
   init_config();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/runtime-node-bun.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/runtime-node-bun.js
 function getNodeFileSystem() {
   if (!_nodeFileSystem)
     _nodeFileSystem = createNodeFileSystem();
@@ -29655,7 +29655,7 @@ var init_runtime_node_bun = __esm(() => {
 });
 
 // ../../plugins/publishings/xhs-pub/src/index.ts
-import { dirname as dirname2, isAbsolute } from "path";
+import { dirname as dirname2 } from "path";
 import { parseArgs } from "util";
 
 // ../../packages/kk-core/src/kinds.ts
@@ -29745,11 +29745,11 @@ var PluginManifestSchema = exports_external.looseObject({
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/path.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/path.js
 function normalizeSeparators(path6) {
   return path6.replaceAll("\\", "/");
 }
@@ -29807,7 +29807,7 @@ function getProcessCwd() {
   return globalThis.process?.cwd?.() ?? "/";
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_runtime_node_bun();
 
 // ../../packages/kk-core/src/render-md.ts
@@ -29919,7 +29919,8 @@ async function trySelectors(page, selectors, options = {}) {
   }
   return { found: false, selector: null };
 }
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.11+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/errors.js
+
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/errors.js
 class BrowserAutomationError extends Error {
   constructor(message, options) {
     super(message, options);
@@ -29968,11 +29969,10 @@ class OperationAbortedError extends BrowserAutomationError {
     this.name = "OperationAbortedError";
   }
 }
-
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.11+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
 import { mkdir } from "fs/promises";
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.11+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/profile-dir.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/profile-dir.js
 function resolveProfileDir(profileDir) {
   if (profileDir.trim() === "") {
     throw new InvalidProfileDirError;
@@ -29984,7 +29984,7 @@ function resolveProfileDir(profileDir) {
   return resolved;
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.11+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
 var PROFILE_DIR_MODE = 448;
 var BUSY_PROFILE_PATTERN = /singleton|already in use|in use by another/i;
 var CHROMIUM_MISSING_PATTERN = /playwright install|executable doesn't exist/i;
@@ -30035,7 +30035,7 @@ function createPersistentLauncher(options = {}) {
   };
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.11+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/operations.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/operations.js
 var DEFAULT_TIMEOUT_MS = 30000;
 var POLL_INTERVAL_MS = 250;
 var defaultLauncher;
@@ -30120,6 +30120,201 @@ async function pollPredicate(page, predicate, timeoutMs, signal) {
 function sleep(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
+// ../../packages/publish-harness/src/browser.ts
+var DEFAULT_CHECK_TIMEOUT_MS = 30000;
+var DEFAULT_STEP_TIMEOUT_MS = 30000;
+var DEFAULT_POLL_MS = 500;
+var ATTACH_POLL_MS = 100;
+function resolveChannelProfileDir(channel, override) {
+  const tiers = [override, process.env[`${channel.toUpperCase()}_PROFILE_DIR`], process.env.KK_BROWSER_PROFILE_DIR];
+  const chosen = tiers.find((tier) => tier !== undefined && tier.trim().length > 0);
+  return resolveBrowserProfileDir(channel, chosen);
+}
+async function checkChannelSession(config3, opts) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_CHECK_TIMEOUT_MS;
+  const passes = opts.headedFallback === false ? [true] : [true, false];
+  let lastDetail = `${config3.channel} readiness was never probed`;
+  for (const headless of passes) {
+    try {
+      await withProfilePage({
+        profileDir: opts.profileDir,
+        headless,
+        url: config3.homeUrl,
+        isAuthenticated: config3.isAuthenticated,
+        timeoutMs,
+        launcher: opts.launcher
+      }, async () => true);
+      return {
+        status: "verified",
+        profileDir: opts.profileDir,
+        detail: `authenticated ${config3.channel} session observed ${headless ? "headlessly" : "via headed fallback"} via profile ${opts.profileDir} (read-only)`
+      };
+    } catch (error51) {
+      if (error51 instanceof BrowserProfileMissingError) {
+        return {
+          status: "refused",
+          profileDir: opts.profileDir,
+          detail: `no ${config3.channel} browser profile at ${opts.profileDir} \u2014 run the login command first`
+        };
+      }
+      lastDetail = `${headless ? "headless" : "headed"} ${config3.channel} readiness refused: ${errorMessage2(error51)}`;
+    }
+  }
+  return { status: "refused", profileDir: opts.profileDir, detail: lastDetail };
+}
+async function waitUntil(predicate, timeoutMs, pollMs = DEFAULT_POLL_MS) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await predicate()) {
+      return true;
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, pollMs));
+  }
+  return predicate();
+}
+async function pasteHtml(page, selector, html, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_STEP_TIMEOUT_MS;
+  await requireAttached(page, selector, "pasteHtml", timeoutMs);
+  await page.evaluate(pasteScript(selector, html));
+  const filled = await waitUntil(async () => String(await page.evaluate(editorTextScript(selector))).length > 0, timeoutMs, ATTACH_POLL_MS);
+  if (!filled) {
+    throw new Error(`pasteHtml: ${selector}: editor text is empty ${timeoutMs}ms after the paste`);
+  }
+}
+async function uploadFile(page, selector, filePath, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_STEP_TIMEOUT_MS;
+  await requireAttached(page, selector, "uploadFile", timeoutMs);
+  await page.setInputFiles(selector, filePath);
+}
+async function expectOutcome(probe, opts) {
+  let evidence = "";
+  let lastProbeError = null;
+  const observed = await waitUntil(async () => {
+    let result;
+    try {
+      result = await probe();
+    } catch (error51) {
+      lastProbeError = error51 instanceof Error ? error51.message : String(error51);
+      return false;
+    }
+    if (result === null || result.length === 0) {
+      return false;
+    }
+    evidence = result;
+    return true;
+  }, opts.timeoutMs, opts.pollMs ?? DEFAULT_POLL_MS);
+  if (observed && evidence.length > 0) {
+    return { ok: true, evidence };
+  }
+  const detail = lastProbeError === null ? "" : ` (last probe error: ${lastProbeError})`;
+  return { ok: false, error: `${opts.label}: no outcome observed within ${opts.timeoutMs}ms${detail}` };
+}
+var DEFAULT_SIGNAL_CONTAINERS = [
+  '[class*="toast" i]',
+  '[class*="notification" i]',
+  '[role="alert"]',
+  '[class*="message" i]'
+];
+async function readScopedSignal(page, texts, containers = DEFAULT_SIGNAL_CONTAINERS) {
+  for (const text of texts) {
+    for (const container of containers) {
+      const locator = page.locator(`${container} :text("${text}")`).first();
+      if (await locator.count().catch(() => 0) === 0)
+        continue;
+      if (!await locator.isVisible().catch(() => false))
+        continue;
+      const observed = (await locator.textContent().catch(() => null))?.trim();
+      return observed !== undefined && observed.length > 0 ? observed : text;
+    }
+  }
+  return null;
+}
+var cdpNodeText = (node) => node.nodeName === "#text" ? node.nodeValue ?? "" : (node.children ?? []).map(cdpNodeText).join("");
+async function findShadowControl(session, labels) {
+  const document = await session.send("DOM.getDocument", { depth: -1, pierce: true });
+  if (!document.root)
+    return null;
+  const wanted = new Set(labels);
+  const findNode = (node, insideShadow) => {
+    if (insideShadow && node.nodeName === "BUTTON" && typeof node.backendNodeId === "number") {
+      const label = cdpNodeText(node).replace(/\s+/g, "");
+      if (wanted.has(label))
+        return { label, backendNodeId: node.backendNodeId };
+    }
+    for (const shadowRoot of node.shadowRoots ?? []) {
+      const hit2 = findNode(shadowRoot, true);
+      if (hit2)
+        return hit2;
+    }
+    for (const child of node.children ?? []) {
+      const hit2 = findNode(child, insideShadow);
+      if (hit2)
+        return hit2;
+    }
+    return null;
+  };
+  const hit = findNode(document.root, false);
+  if (hit === null)
+    return null;
+  const box = await session.send("DOM.getBoxModel", { backendNodeId: hit.backendNodeId });
+  const quad = box.model?.content;
+  if (quad === undefined || quad.length < 8)
+    return null;
+  const [x1 = 0, y1 = 0, x3 = 0, , , y4 = 0] = quad;
+  return { label: hit.label, x: Math.round((x1 + x3) / 2), y: Math.round((y1 + y4) / 2) };
+}
+async function createShadowFinder(context2, page) {
+  if (typeof context2.newCDPSession !== "function")
+    return;
+  try {
+    const session = await context2.newCDPSession(page);
+    await session.send("DOM.enable");
+    return (labels) => findShadowControl(session, labels);
+  } catch {
+    return;
+  }
+}
+var markdownToHtml = (markdown) => Bun.markdown.html(markdown);
+async function requireAttached(page, selector, action, timeoutMs) {
+  await resolveSelector(page, [selector], { timeoutMs, label: action });
+}
+async function resolveSelector(page, selectors, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_STEP_TIMEOUT_MS;
+  const found = { selector: null };
+  const attached = await waitUntil(async () => {
+    const result = await trySelectors(page, selectors, { visible: false });
+    found.selector = result.selector;
+    return result.found && result.selector !== null;
+  }, timeoutMs, ATTACH_POLL_MS);
+  const selector = found.selector;
+  if (!attached || selector === null) {
+    throw new Error(`${opts.label ?? "selector"}: ${selectors.join(" | ")} not attached within ${timeoutMs}ms`);
+  }
+  return selector;
+}
+function errorMessage2(error51) {
+  return error51 instanceof Error ? error51.message : String(error51);
+}
+function pasteScript(selector, html) {
+  const text = html.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+  return `(() => {
+    const el = document.querySelector(${JSON.stringify(selector)});
+    if (!el) return false;
+    const data = new DataTransfer();
+    data.setData('text/html', ${JSON.stringify(html)});
+    data.setData('text/plain', ${JSON.stringify(text)});
+    el.focus();
+    el.dispatchEvent(new ClipboardEvent('paste', { clipboardData: data, bubbles: true, cancelable: true }));
+    return true;
+})()`;
+}
+function editorTextScript(selector) {
+  return `(() => {
+    const el = document.querySelector(${JSON.stringify(selector)});
+    return el ? (el.textContent ?? '').trim() : '';
+})()`;
+}
+
 // ../../plugins/publishings/xhs-pub/src/index.ts
 init_dist();
 
@@ -30195,48 +30390,86 @@ function createAutomationGuard(options) {
   };
 }
 
-// ../../plugins/publishings/xhs-pub/src/index.ts
-var CHANNEL = "xhs";
+// ../../plugins/publishings/xhs-pub/src/modes.ts
+import { isAbsolute } from "path";
 var TARGET = "xhs";
 var PUBLISH_URL = "https://creator.xiaohongshu.com/publish/publish";
 var PUBLISHED_MARKER = "published=true";
-var LOGIN_TIMEOUT_MS = 120000;
-var STEP_TIMEOUT_MS = 30000;
-var PREFLIGHT_TIMEOUT_MS = 30000;
-var POLL_MS = 500;
-var SUBMIT_SETTLE_MS = 2500;
-var SUBMIT_ATTEMPTS = 3;
-var SELECTORS = {
-  imageTab: ['div.creator-tab:has-text("\u56FE\u6587")', "text=\u4E0A\u4F20\u56FE\u6587"],
-  fileInput: ['input[type="file"][accept*=".jpg"]', 'input[type="file"]'],
-  thumbnail: ["img.preivew-image", ".img-preview img"],
-  title: ['input[placeholder*="\u6807\u9898"]', "#title-textarea input"],
-  body: [
-    'div.tiptap[contenteditable="true"]',
-    'div[contenteditable="true"].ql-editor',
-    "#post-textarea",
-    ".ql-editor"
-  ],
-  draftBox: ["text=/\u8349\u7A3F\u7BB1\\(\\d+\\)/", "text=\u8349\u7A3F\u7BB1"],
-  publishConfirm: ["text=\u53D1\u5E03\u6210\u529F", "text=\u5DF2\u53D1\u5E03"]
-};
-var SHADOW_CONTROLS = {
-  draft: ["\u6682\u5B58\u79BB\u5F00", "\u5B58\u8349\u7A3F", "\u4FDD\u5B58\u8349\u7A3F"],
-  publish: ["\u53D1\u5E03"]
+var XHS_OPERATIONS = ["\u4E0A\u4F20\u56FE\u6587", "\u4E0A\u4F20\u89C6\u9891", "\u5199\u957F\u6587", "\u53D1\u64AD\u5BA2"];
+var DEFAULT_XHS_OPERATION = "\u4E0A\u4F20\u56FE\u6587";
+function resolveXhsOperation(options, content) {
+  const raw = options?.operation ?? content?.metadata?.operation;
+  if (raw === undefined)
+    return { operation: DEFAULT_XHS_OPERATION };
+  if (typeof raw !== "string" || !XHS_OPERATIONS.includes(raw)) {
+    return {
+      error: `unsupported operation '${String(raw)}' for ${TARGET}: expected one of ${XHS_OPERATIONS.join(", ")}`
+    };
+  }
+  return { operation: raw };
+}
+var IMAGE_EXTENSIONS = /\.(png|jpe?g|webp)$/i;
+var IMAGE_LIST = "png|jpg|jpeg|webp";
+var VIDEO_EXTENSIONS = /\.(mp4|mov|flv|f4v|mkv|rm|rmvb|m4v|mpg|mpeg|ts)$/i;
+var VIDEO_LIST = "mp4|mov|flv|f4v|mkv|rm|rmvb|m4v|mpg|mpeg|ts";
+var AUDIO_EXTENSIONS = /\.(mp3|wav|aac|flac|m4a)$/i;
+var AUDIO_LIST = "mp3|wav|aac|flac|m4a";
+var XHS_IMAGE_MAX = 18;
+var XHS_NOTE_TITLE_MAX = 20;
+var XHS_NOTE_BODY_MAX = 1000;
+var MODE_LIMITS = {
+  \u{4e0a}\u{4f20}\u{56fe}\u{6587}: { imageMax: XHS_IMAGE_MAX, titleMax: XHS_NOTE_TITLE_MAX, bodyMax: XHS_NOTE_BODY_MAX },
+  \u{4e0a}\u{4f20}\u{89c6}\u{9891}: { titleMax: XHS_NOTE_TITLE_MAX },
+  \u{5199}\u{957f}\u{6587}: {},
+  \u{53d1}\u{64ad}\u{5ba2}: {}
 };
-function fail(error51) {
-  return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
+function artifactPaths(input) {
+  switch (input.operation) {
+    case "\u4E0A\u4F20\u56FE\u6587":
+      return input.images;
+    case "\u4E0A\u4F20\u89C6\u9891":
+      return [input.video];
+    case "\u5199\u957F\u6587":
+      return [];
+    case "\u53D1\u64AD\u5BA2":
+      return [input.audio, input.cover];
+  }
 }
-async function validatePublishInput(content) {
-  const status = content.metadata?.publishStatus;
-  if (status !== undefined && status !== "draft" && status !== "public") {
-    return { error: `images validation: unknown publishStatus '${String(status)}' (expected 'draft' or 'public')` };
+async function resolveMediaPath(content, spec) {
+  const raw = content.metadata?.[spec.key];
+  const path7 = typeof raw === "string" ? raw : typeof raw?.path === "string" ? raw.path : undefined;
+  if (path7 === undefined || path7.length === 0) {
+    return {
+      error: `${spec.label}: Content.metadata.${spec.key} is required (absolute path to an existing ${spec.list} file)`
+    };
+  }
+  if (!isAbsolute(path7)) {
+    return { error: `${spec.label}: Content.metadata.${spec.key} must be absolute, got '${path7}'` };
+  }
+  if (!spec.extensions.test(path7)) {
+    return {
+      error: `${spec.label}: Content.metadata.${spec.key} has unsupported extension (expected ${spec.list}): '${path7}'`
+    };
+  }
+  if (!await createNodeFileSystem().exists(path7)) {
+    return { error: `${spec.label}: Content.metadata.${spec.key} does not exist: '${path7}'` };
   }
+  return { path: path7 };
+}
+async function validatePublishInput(content) {
+  const status = validatePublishStatus(content);
+  if (status.error)
+    return { error: status.error };
   const images = content.metadata?.images;
   if (!Array.isArray(images) || images.length === 0) {
     return { error: "images validation: metadata.images must be a non-empty ordered array" };
   }
-  const fs2 = createNodeFileSystem();
+  const max = XHS_IMAGE_MAX;
+  if (images.length > max) {
+    return {
+      error: `images validation: metadata.images holds ${images.length} entries but the \u4E0A\u4F20\u56FE\u6587 grid accepts \u2264${max}`
+    };
+  }
   const paths = [];
   for (const [i2, image] of images.entries()) {
     const path7 = image?.path;
@@ -30246,20 +30479,163 @@ async function validatePublishInput(content) {
     if (!isAbsolute(path7)) {
       return { error: `images validation: images[${i2}].path must be absolute, got '${path7}'` };
     }
-    if (!/\.(png|jpe?g|webp)$/i.test(path7)) {
+    if (!IMAGE_EXTENSIONS.test(path7)) {
       return {
-        error: `images validation: images[${i2}].path has unsupported extension (expected png|jpg|jpeg|webp): '${path7}'`
+        error: `images validation: images[${i2}].path has unsupported extension (expected ${IMAGE_LIST}): '${path7}'`
       };
     }
-    if (!await fs2.exists(path7)) {
+    if (!await createNodeFileSystem().exists(path7)) {
       return { error: `images validation: images[${i2}].path does not exist: '${path7}'` };
     }
     paths.push(path7);
   }
   return { paths };
 }
+function validatePublishStatus(content) {
+  const status = content.metadata?.publishStatus;
+  if (status !== undefined && status !== "draft" && status !== "public") {
+    return {
+      error: `publishStatus validation: unknown publishStatus '${String(status)}' (expected 'draft' or 'public')`
+    };
+  }
+  return {};
+}
+function validateTitle(content, operation) {
+  const max = MODE_LIMITS[operation].titleMax;
+  if (max === undefined)
+    return {};
+  const title = content.title ?? "";
+  if (title.length > max) {
+    return {
+      error: `title validation: Content.title is ${title.length} chars but ${operation} accepts \u2264${max}`
+    };
+  }
+  return {};
+}
+function validateBody(content, operation) {
+  const max = MODE_LIMITS[operation].bodyMax;
+  if (max === undefined)
+    return {};
+  if (content.body.length > max) {
+    return {
+      error: `body validation: Content.body is ${content.body.length} chars but ${operation} accepts \u2264${max}`
+    };
+  }
+  return {};
+}
+async function validateModeInput(operation, content) {
+  const status = validatePublishStatus(content);
+  if (status.error)
+    return { error: status.error };
+  switch (operation) {
+    case "\u4E0A\u4F20\u56FE\u6587": {
+      const title = validateTitle(content, operation);
+      if (title.error)
+        return { error: title.error };
+      const body = validateBody(content, operation);
+      if (body.error)
+        return { error: body.error };
+      const images = await validatePublishInput(content);
+      if (images.error)
+        return { error: images.error };
+      return { input: { operation, images: images.paths ?? [] } };
+    }
+    case "\u4E0A\u4F20\u89C6\u9891": {
+      const title = validateTitle(content, operation);
+      if (title.error)
+        return { error: title.error };
+      const video = await resolveMediaPath(content, {
+        key: "video",
+        label: "video validation",
+        extensions: VIDEO_EXTENSIONS,
+        list: VIDEO_LIST
+      });
+      if (video.error)
+        return { error: video.error };
+      return { input: { operation, video: video.path ?? "" } };
+    }
+    case "\u5199\u957F\u6587": {
+      if (content.body.trim().length === 0) {
+        return { error: "body validation: Content.body must be non-empty for \u5199\u957F\u6587 (authored in place)" };
+      }
+      return { input: { operation } };
+    }
+    case "\u53D1\u64AD\u5BA2": {
+      const audio = await resolveMediaPath(content, {
+        key: "audio",
+        label: "audio validation",
+        extensions: AUDIO_EXTENSIONS,
+        list: AUDIO_LIST
+      });
+      if (audio.error)
+        return { error: audio.error };
+      const cover = await resolveMediaPath(content, {
+        key: "coverImage",
+        label: "cover validation",
+        extensions: IMAGE_EXTENSIONS,
+        list: IMAGE_LIST
+      });
+      if (cover.error)
+        return { error: cover.error };
+      return { input: { operation, audio: audio.path ?? "", cover: cover.path ?? "" } };
+    }
+  }
+}
+
+// ../../plugins/publishings/xhs-pub/src/page.ts
+var POLL_MS = 500;
+var STEP_TIMEOUT_MS = 30000;
+var CREATOR_TAB_BAR = "div.creator-tab";
+var CREATOR_TAB_COUNT = 4;
+function creatorTabSelector(label) {
+  return `${CREATOR_TAB_BAR}:has-text("${label}")`;
+}
+async function clickCreatorTab(page, label, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? STEP_TIMEOUT_MS;
+  const pollMs = opts.pollMs ?? POLL_MS;
+  const onScreenCount = () => page.countOnScreen(CREATOR_TAB_BAR).catch(() => 0);
+  const mounted = await waitUntil2(() => onScreenCount().then((count2) => count2 >= CREATOR_TAB_COUNT), timeoutMs, pollMs);
+  if (!mounted) {
+    const observed = await onScreenCount();
+    throw new Error(`mode entry: the console tab bar did not mount within ${timeoutMs}ms (${observed} of ${CREATOR_TAB_COUNT} on-screen '${CREATOR_TAB_BAR}' nodes) \u2014 every tab renders aria-hidden and off-viewport clones`);
+  }
+  if (!page.clickInViewport) {
+    throw new Error(`mode entry: this driver cannot read viewport geometry, so the on-screen '${label}' tab cannot be told apart from its off-screen clones`);
+  }
+  const clicked = await page.clickInViewport(creatorTabSelector(label));
+  if (!clicked) {
+    throw new Error(`mode entry: no in-viewport '${label}' tab found (only aria-hidden or off-screen clones matched) \u2014 the mode was not entered`);
+  }
+}
+async function waitUntil2(predicate, timeoutMs, pollMs = POLL_MS) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await predicate())
+      return true;
+    await new Promise((resolve3) => setTimeout(resolve3, pollMs));
+  }
+  return predicate();
+}
 function wrapPlaywrightPage(raw, shadow) {
   const pw = raw;
+  const onScreen = async (selector) => {
+    const viewport = pw.viewportSize?.() ?? null;
+    if (viewport === null)
+      return [];
+    const total = await pw.locator(selector).count();
+    const found = [];
+    for (let index = 0;index < total; index += 1) {
+      const candidate = pw.locator(selector).nth(index);
+      const box = await candidate.boundingBox().catch(() => null);
+      if (!box || box.width === 0 || box.height === 0)
+        continue;
+      const outside = box.x < 0 || box.y < 0 || box.x >= viewport.width || box.y >= viewport.height;
+      if (outside)
+        continue;
+      found.push({ index, box });
+    }
+    return found;
+  };
   return {
     goto: (url2, options) => pw.goto(url2, options),
     locator: (selector) => ({
@@ -30279,84 +30655,384 @@ function wrapPlaywrightPage(raw, shadow) {
     setInputFiles: (selector, paths) => pw.setInputFiles(selector, paths),
     waitForSelector: (selector, options) => pw.waitForSelector(selector, options),
     url: () => pw.url(),
+    evaluate: (expression) => pw.evaluate(expression),
+    countOnScreen: async (selector) => (await onScreen(selector)).length,
     clickInViewport: async (selector) => {
-      const viewport = pw.viewportSize?.() ?? null;
-      if (viewport === null)
+      const [candidate] = await onScreen(selector);
+      if (candidate === undefined)
         return false;
-      const total = await pw.locator(selector).count();
-      for (let index = 0;index < total; index += 1) {
-        const candidate = pw.locator(selector).nth(index);
-        const box = await candidate.boundingBox().catch(() => null);
-        if (!box || box.width === 0)
-          continue;
-        const outside = box.x < 0 || box.y < 0 || box.x >= viewport.width || box.y >= viewport.height;
-        if (outside)
-          continue;
-        await candidate.click({ force: true });
-        return true;
-      }
-      return false;
+      await pw.locator(selector).nth(candidate.index).click({ force: true });
+      return true;
     },
     findShadowControl: async (labels) => shadow ? shadow.findControl(labels) : null,
     clickAt: (x, y) => pw.mouse.click(x, y)
   };
 }
-async function findControlViaCdp(session, labels) {
-  const document = await session.send("DOM.getDocument", { depth: -1, pierce: true });
-  if (!document.root)
-    return null;
-  const wanted = new Set(labels);
-  const text = (node) => node.nodeName === "#text" ? node.nodeValue ?? "" : (node.children ?? []).map(text).join("");
-  const hits = [];
-  const walk = (node) => {
-    if (hits.length > 0)
-      return;
-    for (const shadowRoot of node.shadowRoots ?? []) {
-      walk(shadowRoot);
-      if (hits.length > 0)
-        return;
-    }
-    if (node.nodeName === "BUTTON") {
-      const label = text(node).replace(/\s+/g, "");
-      if (wanted.has(label) && typeof node.backendNodeId === "number") {
-        hits.push({ label, backendNodeId: node.backendNodeId });
-        return;
-      }
+async function findSelector(page, selectors, what, timeoutMs = STEP_TIMEOUT_MS) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const found = await trySelectors(page, selectors);
+    if (found.found && found.selector)
+      return found.selector;
+    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
+  }
+  throw new Error(`${what}: no matching element observed`);
+}
+async function findAttachedSelector(page, selectors, what, timeoutMs = STEP_TIMEOUT_MS) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    for (const selector of selectors) {
+      const attached = await page.locator(selector).count().catch(() => 0);
+      if (attached > 0)
+        return selector;
     }
-    for (const child of node.children ?? []) {
-      walk(child);
-      if (hits.length > 0)
-        return;
+    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
+  }
+  throw new Error(`${what}: no matching element observed`);
+}
+
+// ../../plugins/publishings/xhs-pub/src/flow.ts
+var NOTE_TITLE = [
+  'input.d-text[placeholder="\u586B\u5199\u6807\u9898\u4F1A\u6709\u66F4\u591A\u8D5E\u54E6"]',
+  'input[placeholder*="\u6807\u9898"]',
+  "#title-textarea input"
+];
+var NOTE_BODY = [
+  'div.tiptap[contenteditable="true"]',
+  'div[contenteditable="true"].ql-editor',
+  "#post-textarea",
+  ".ql-editor"
+];
+var NOTE_THUMBNAIL = ["img.preivew-image", ".img-preview img"];
+var IMAGE_FILE_INPUT = [
+  'input[type="file"][accept*=".jpg"]',
+  'input[type="file"].upload-input',
+  'input[type="file"]'
+];
+var VIDEO_FILE_INPUT = ['input[type="file"][accept*=".mp4"]', 'input[type="file"].upload-input'];
+var VIDEO_EDITOR = ["div.tiptap.ProseMirror", 'div.tiptap[contenteditable="true"]', ".ProseMirror"];
+var ARTICLE_NEW = ["text=\u65B0\u7684\u521B\u4F5C", 'button:has-text("\u65B0\u7684\u521B\u4F5C")'];
+var ARTICLE_EDITOR = ["div.tiptap.ProseMirror.ProseMirror-focused", "div.tiptap.ProseMirror", ".ProseMirror"];
+var ARTICLE_LAYOUT = ['button:has-text("\u4E00\u952E\u6392\u7248")', "div.ailayout-btn_wrp", "div.ailayout-btn_label"];
+var PODCAST_OPEN = ["text=\u4E0A\u4F20\u97F3\u9891", 'button:has-text("\u4E0A\u4F20\u97F3\u9891")'];
+var PODCAST_MODAL = ["div.creator-modal-sty", ".d-modal.d-modal-centered", ".d-modal"];
+var PODCAST_AUDIO_INPUT = ['input[type="file"][accept*=".mp3"]', 'input[type="file"][accept*=".wav"]'];
+var PODCAST_COVER_INPUT = ['input[type="file"][accept*=".jpg"]', 'input[type="file"][accept*=".png"]'];
+var PODCAST_MODAL_ADVANCE = ["\u53BB\u53D1\u5E03"];
+var DRAFT_LABELS = ["\u6682\u5B58\u79BB\u5F00", "\u5B58\u8349\u7A3F", "\u4FDD\u5B58\u8349\u7A3F"];
+var PUBLISH_LABELS = ["\u53D1\u5E03"];
+var PUBLISH_CONFIRM = ["\u53D1\u5E03\u6210\u529F", "\u5DF2\u53D1\u5E03"];
+var DRAFT_TOASTS = ["\u4FDD\u5B58\u6210\u529F"];
+var SHADOW_BAR = "the xhs publish bar (closed shadow root)";
+var MODE_ACTION_PATHS = {
+  \u{4e0a}\u{4f20}\u{56fe}\u{6587}: ["shadow"],
+  \u{4e0a}\u{4f20}\u{89c6}\u{9891}: ["shadow"],
+  \u{5199}\u{957f}\u{6587}: ["light", "shadow"],
+  \u{53d1}\u{64ad}\u{5ba2}: ["shadow"]
+};
+function fail(error51) {
+  return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
+}
+function sleep2(ms) {
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
+}
+function asPlaywrightPage(page) {
+  return page;
+}
+async function enterMode(deps, label) {
+  await clickCreatorTab(deps.page, label, { timeoutMs: deps.stepTimeoutMs });
+}
+async function clickShadowControl(page, labels) {
+  if (!page.findShadowControl || !page.clickAt) {
+    return {
+      ok: false,
+      error: `submit control: ${SHADOW_BAR} and this driver has no CDP access to resolve it`
+    };
+  }
+  const control = await page.findShadowControl(labels);
+  if (!control) {
+    return {
+      ok: false,
+      error: `submit control: none of [${labels.join(", ")}] found in ${SHADOW_BAR}`
+    };
+  }
+  await page.clickAt(control.x, control.y);
+  return { ok: true, label: control.label, x: control.x, y: control.y };
+}
+async function clickLightControl(page, labels, timeoutMs, what) {
+  const candidates = labels.flatMap((label2) => [`button:has-text("${label2}")`, `text=${label2}`]);
+  let selector;
+  try {
+    selector = await findSelector(page, candidates, `${what} (light DOM) none of [${labels.join(", ")}]`, timeoutMs);
+  } catch (error51) {
+    return { ok: false, error: error51 instanceof Error ? error51.message : String(error51) };
+  }
+  const label = labels.find((candidate) => selector.includes(candidate)) ?? labels[0];
+  await page.locator(selector).first().click({ timeout: timeoutMs });
+  return { ok: true, label: label ?? "", selector };
+}
+async function clickActionControl(operation, deps, labels, what) {
+  let lastError = "";
+  for (const path7 of MODE_ACTION_PATHS[operation]) {
+    if (path7 === "shadow") {
+      const clicked2 = await clickShadowControl(deps.page, labels);
+      if (clicked2.ok)
+        return { ok: true, path: path7, label: clicked2.label, click: `${clicked2.x},${clicked2.y}` };
+      lastError = clicked2.error;
+      continue;
     }
-  };
-  walk(document.root);
-  const hit = hits[0];
-  if (!hit)
-    return null;
-  const box = await session.send("DOM.getBoxModel", { backendNodeId: hit.backendNodeId });
-  const quad = box.model?.content;
-  if (!quad || quad.length < 8)
-    return null;
-  const [x1 = 0, y1 = 0, x3 = 0, , , y4 = 0] = quad;
-  return {
-    label: hit.label,
-    x: Math.round((x1 + x3) / 2),
-    y: Math.round((y1 + y4) / 2)
-  };
+    const clicked = await clickLightControl(deps.page, labels, deps.stepTimeoutMs, what);
+    if (clicked.ok)
+      return { ok: true, path: path7, label: clicked.label, click: `selector:${clicked.selector}` };
+    lastError = clicked.error;
+  }
+  return { ok: false, error: lastError };
 }
-async function createShadowProbe(context2, page) {
-  if (typeof context2.newCDPSession !== "function")
+async function readDraftCount(page) {
+  for (const selector of ["text=/\u8349\u7A3F\u7BB1\\(\\d+\\)/", "text=\u8349\u7A3F\u7BB1"]) {
+    const attached = await page.locator(selector).count().catch(() => 0);
+    if (attached === 0)
+      continue;
+    const locator = page.locator(selector).first();
+    if (!locator.textContent)
+      continue;
+    const text = await locator.textContent().catch(() => "");
+    const match = /\u8349\u7A3F\u7BB1\s*[\uFF08(]\s*(\d+)\s*[\uFF09)]/.exec(text);
+    if (match?.[1] !== undefined)
+      return Number(match[1]);
+  }
+  return null;
+}
+function draftSavedStamps(now = new Date) {
+  const pad = (value) => String(value).padStart(2, "0");
+  return [0, 1, 2].map((minutesAgo) => {
+    const stamp = new Date(now.getTime() - minutesAgo * 60000);
+    return `\u4FDD\u5B58\u4E8E${stamp.getFullYear()}-${pad(stamp.getMonth() + 1)}-${pad(stamp.getDate())} ${pad(stamp.getHours())}:${pad(stamp.getMinutes())}`;
+  });
+}
+async function readDraftStamps(page) {
+  const present = [];
+  for (const stamp of draftSavedStamps()) {
+    const attached = await page.locator(`text=${stamp}`).count().catch(() => 0);
+    if (attached > 0)
+      present.push(stamp);
+  }
+  return present;
+}
+async function readDraftBaseline(page) {
+  return { count: await readDraftCount(page), stamps: await readDraftStamps(page) };
+}
+async function isDraftRowSaved(page, baseline) {
+  const stamps = await readDraftStamps(page);
+  if (stamps.some((stamp) => !baseline.stamps.includes(stamp)))
+    return true;
+  const after = await readDraftCount(page);
+  if (baseline.count === null || after === null)
+    return false;
+  return after > baseline.count;
+}
+async function draftSignalEvidence(page, baseline) {
+  const toast = await readScopedSignal(asPlaywrightPage(page), DRAFT_TOASTS);
+  if (toast !== null)
+    return `toast:${toast}`;
+  if (await isDraftRowSaved(page, baseline))
+    return "draft-row";
+  return null;
+}
+async function applyNoteTitle(deps) {
+  const selector = await findSelector(deps.page, NOTE_TITLE, "title input", deps.stepTimeoutMs);
+  await deps.page.locator(selector).first().fill(deps.content.title ?? "");
+}
+async function typeNoteBody(deps, selectors, what) {
+  const selector = await findSelector(deps.page, selectors, what, deps.stepTimeoutMs);
+  const body = deps.page.locator(selector).first();
+  const text = deps.content.body ?? "";
+  if (typeof body.type === "function") {
+    await body.click();
+    await body.type(text, { delay: 5 });
     return;
+  }
+  await body.fill(text);
+}
+async function confirmThumbnails(deps, expected) {
+  const selector = await findSelector(deps.page, NOTE_THUMBNAIL, "thumbnail wait", deps.stepTimeoutMs);
+  const matches = await waitUntil2(() => deps.page.locator(selector).count().then((count2) => count2 >= expected), deps.stepTimeoutMs);
+  const observed = await deps.page.locator(selector).count();
+  if (!matches || observed !== expected) {
+    throw new Error(`thumbnail count: expected ${expected}, observed ${observed}`);
+  }
+}
+async function composeImageText(input, deps) {
+  await enterMode(deps, input.operation);
+  const fileSelector = await findAttachedSelector(deps.page, IMAGE_FILE_INPUT, "image file input", deps.stepTimeoutMs);
+  await deps.page.setInputFiles(fileSelector, input.images);
+  await confirmThumbnails(deps, input.images.length);
+  await applyNoteTitle(deps);
+  await typeNoteBody(deps, NOTE_BODY, "note body");
+}
+async function composeVideo(input, deps) {
+  await enterMode(deps, input.operation);
+  const fileSelector = await findAttachedSelector(deps.page, VIDEO_FILE_INPUT, "video file input", deps.stepTimeoutMs);
+  await uploadFile(asPlaywrightPage(deps.page), fileSelector, input.video, { timeoutMs: deps.stepTimeoutMs });
+  await findSelector(deps.page, VIDEO_EDITOR, "video note editor", deps.stepTimeoutMs);
+  await applyNoteTitle(deps);
+  await typeNoteBody(deps, NOTE_BODY, "note body");
+}
+async function composeArticle(deps) {
+  await enterMode(deps, "\u5199\u957F\u6587");
+  const newArticle = await findAttachedSelector(deps.page, ARTICLE_NEW, "\u65B0\u7684\u521B\u4F5C control", deps.stepTimeoutMs);
+  await deps.page.locator(newArticle).first().click();
+  const editor = await findSelector(deps.page, ARTICLE_EDITOR, "long-article editor", deps.stepTimeoutMs);
+  await pasteHtml(asPlaywrightPage(deps.page), editor, markdownToHtml(deps.content.body), {
+    timeoutMs: deps.stepTimeoutMs
+  });
   try {
-    const session = await context2.newCDPSession(page);
-    await session.send("DOM.enable");
-    return { findControl: (labels) => findControlViaCdp(session, labels) };
-  } catch {
+    const layout = await findSelector(deps.page, ARTICLE_LAYOUT, "\u4E00\u952E\u6392\u7248 control", deps.stepTimeoutMs);
+    await deps.page.locator(layout).first().click();
+  } catch {}
+}
+async function isPodcastModalOpen(page) {
+  return trySelectors(page, PODCAST_MODAL).then((found) => found.found).catch(() => false);
+}
+async function leavePodcastModal(deps) {
+  const closed = () => isPodcastModalOpen(deps.page).then((open) => !open);
+  if (await waitUntil2(closed, deps.stepTimeoutMs))
     return;
+  if (deps.publishStatus === "public") {
+    const advance = await clickLightControl(deps.page, PODCAST_MODAL_ADVANCE, deps.stepTimeoutMs, "podcast modal advance");
+    if (!advance.ok)
+      throw new Error(advance.error);
+    if (await waitUntil2(closed, deps.stepTimeoutMs))
+      return;
   }
+  throw new Error(`podcast modal: the \u53D1\u64AD\u5BA2 modal was still open ${deps.stepTimeoutMs}ms after the audio and cover were attached; the only recorded advance control is '${PODCAST_MODAL_ADVANCE[0]}' and a draft run does not click it (it is publish-adjacent)`);
+}
+async function composePodcast(input, deps) {
+  await enterMode(deps, input.operation);
+  const open = await findAttachedSelector(deps.page, PODCAST_OPEN, "\u4E0A\u4F20\u97F3\u9891 control", deps.stepTimeoutMs);
+  await deps.page.locator(open).first().click();
+  await findSelector(deps.page, PODCAST_MODAL, "podcast modal", deps.stepTimeoutMs);
+  const audioInput = await findAttachedSelector(deps.page, PODCAST_AUDIO_INPUT, "podcast audio input", deps.stepTimeoutMs);
+  await uploadFile(asPlaywrightPage(deps.page), audioInput, input.audio, { timeoutMs: deps.stepTimeoutMs });
+  const coverInput = await findAttachedSelector(deps.page, PODCAST_COVER_INPUT, "podcast cover input", deps.stepTimeoutMs);
+  await uploadFile(asPlaywrightPage(deps.page), coverInput, input.cover, { timeoutMs: deps.stepTimeoutMs });
+  await leavePodcastModal(deps);
+}
+async function compose(input, deps) {
+  switch (input.operation) {
+    case "\u4E0A\u4F20\u56FE\u6587":
+      await composeImageText(input, deps);
+      return;
+    case "\u4E0A\u4F20\u89C6\u9891":
+      await composeVideo(input, deps);
+      return;
+    case "\u5199\u957F\u6587":
+      await composeArticle(deps);
+      return;
+    case "\u53D1\u64AD\u5BA2":
+      await composePodcast(input, deps);
+      return;
+  }
+}
+function baseMetadata(input, deps) {
+  return {
+    operation: input.operation,
+    driver: deps.driver,
+    publishStatus: deps.publishStatus,
+    profileDir: deps.profileDir,
+    artifactPaths: artifactPaths(input),
+    ...input.operation === "\u4E0A\u4F20\u56FE\u6587" ? { imageCount: input.images.length } : {}
+  };
+}
+async function saveDraft(input, deps) {
+  let clicked = null;
+  let signal = null;
+  let attempts = 0;
+  while (signal === null && attempts < deps.submitAttempts) {
+    attempts += 1;
+    await sleep2(deps.submitSettleMs);
+    const control = await clickActionControl(input.operation, deps, DRAFT_LABELS, "draft control");
+    if (!control.ok)
+      return fail(control.error);
+    clicked = control;
+    const outcome = await expectOutcome(() => draftSignalEvidence(deps.page, deps.draftBaseline), {
+      timeoutMs: deps.submitSettleMs,
+      label: `draft confirmation '${control.label}'`,
+      pollMs: POLL_MS
+    });
+    if (outcome.ok)
+      signal = outcome.evidence;
+  }
+  const draftCountAfter = await readDraftCount(deps.page);
+  if (signal === null || clicked === null) {
+    return fail(`draft confirmation: '${clicked?.label ?? DRAFT_LABELS[0]}' was clicked ${attempts}\xD7 but neither a fresh ${TARGET} save timestamp, a moved draft counter, nor a scoped '${DRAFT_TOASTS[0]}' toast was observed within ${deps.submitSettleMs}ms (before=${String(deps.draftBaseline.count)}, after=${String(draftCountAfter)})`);
+  }
+  return ResultSchema.parse({
+    ok: true,
+    target: TARGET,
+    message: `${TARGET} draft saved (unpublished) in profile ${deps.profileDir} via '${clicked.label}' (${input.operation})`,
+    metadata: {
+      ...baseMetadata(input, deps),
+      draftControl: clicked.label,
+      draftClick: clicked.click,
+      draftPath: clicked.path,
+      draftAttempts: attempts,
+      draftSignal: signal,
+      draftCountBefore: deps.draftBaseline.count,
+      draftCountAfter
+    }
+  });
+}
+async function publishNote(input, deps) {
+  await sleep2(deps.submitSettleMs);
+  const submitted = await clickActionControl(input.operation, deps, PUBLISH_LABELS, "publish control");
+  if (!submitted.ok)
+    return fail(submitted.error);
+  const urlBeforeSubmit = deps.page.url();
+  const confirmed = await waitUntil2(async () => {
+    if (deps.page.url().includes(PUBLISHED_MARKER))
+      return true;
+    return await readScopedSignal(asPlaywrightPage(deps.page), PUBLISH_CONFIRM) !== null;
+  }, deps.stepTimeoutMs);
+  if (!confirmed) {
+    return fail(`publish submission: state unknown \u2014 the '${submitted.label}' click (${submitted.click}) was sent from ${urlBeforeSubmit} but no success state was observed (now ${deps.page.url()}). Check the ${TARGET} creator note manager before retrying: a retry could duplicate the post.`);
+  }
+  const url2 = deps.page.url();
+  return ResultSchema.parse({
+    ok: true,
+    target: TARGET,
+    ...url2 !== PUBLISH_URL ? { url: url2 } : {},
+    message: `${TARGET} ${input.operation} post published`,
+    metadata: {
+      ...baseMetadata(input, deps),
+      publishControl: submitted.label,
+      publishPath: submitted.path,
+      publishClick: submitted.click,
+      publishSignal: url2.includes(PUBLISHED_MARKER) ? `url:${PUBLISHED_MARKER}` : "toast"
+    }
+  });
+}
+async function runMode(input, deps) {
+  await compose(input, deps);
+  return deps.publishStatus === "public" ? publishNote(input, deps) : saveDraft(input, deps);
+}
+
+// ../../plugins/publishings/xhs-pub/src/index.ts
+var CHANNEL = "xhs";
+var LOGIN_TIMEOUT_MS = 120000;
+var PREFLIGHT_TIMEOUT_MS = 30000;
+var SUBMIT_SETTLE_MS = 2500;
+var SUBMIT_ATTEMPTS = 3;
+var AUTH_GATE = ["div.creator-tab", "text=\u4E0A\u4F20\u56FE\u6587"];
+function fail2(error51) {
+  return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
+}
+async function createShadowProbe(context2, page) {
+  const find = await createShadowFinder(context2, page);
+  return find === undefined ? undefined : { findControl: (labels) => find(labels) };
 }
 async function isXhsConsoleReady(page) {
-  return trySelectors(page, SELECTORS.imageTab).then((r) => r.found);
+  return trySelectors(page, AUTH_GATE).then((r) => r.found);
 }
 var defaultLauncher2 = openPersistentBrowser;
 function makeDefaultOpenPage(launch = defaultLauncher2) {
@@ -30379,67 +31055,16 @@ function makeDefaultOpenPage(launch = defaultLauncher2) {
   };
 }
 var defaultOpenPage = makeDefaultOpenPage();
-async function waitUntil(predicate, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (await predicate())
-      return true;
-    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
-  }
-  return predicate();
-}
-async function findSelector(page, selectors, what, timeoutMs = STEP_TIMEOUT_MS) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    const found = await trySelectors(page, selectors);
-    if (found.found && found.selector)
-      return found.selector;
-    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
-  }
-  throw new Error(`${what}: no matching element observed`);
-}
-async function findAttachedSelector(page, selectors, what, timeoutMs = STEP_TIMEOUT_MS) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    for (const selector of selectors) {
-      const attached = await page.locator(selector).count().catch(() => 0);
-      if (attached > 0)
-        return selector;
-    }
-    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
-  }
-  throw new Error(`${what}: no matching element observed`);
-}
 async function checkXhsProfileSession(opts) {
-  const timeoutMs = opts.timeoutMs ?? PREFLIGHT_TIMEOUT_MS;
-  for (const headless of [true, false]) {
-    try {
-      await withProfilePage({
-        profileDir: opts.profileDir,
-        headless,
-        url: PUBLISH_URL,
-        isAuthenticated: (page) => isXhsConsoleReady(wrapPlaywrightPage(page)),
-        timeoutMs,
-        launcher: opts.launcher
-      }, async () => {
-        return;
-      });
-      return {
-        status: "verified",
-        profileDir: opts.profileDir,
-        detail: `authenticated ${CHANNEL} creator console observed ${headless ? "headlessly" : "via headed fallback"} via profile ${opts.profileDir} (read-only)`
-      };
-    } catch (error51) {
-      if (headless)
-        continue;
-      return {
-        status: "refused",
-        profileDir: opts.profileDir,
-        detail: `headless and headed readiness refused: ${error51 instanceof Error ? error51.message : String(error51)}`
-      };
-    }
-  }
-  throw new Error("unreachable: session check loop must return or throw");
+  return checkChannelSession({
+    channel: CHANNEL,
+    homeUrl: PUBLISH_URL,
+    isAuthenticated: (page) => isXhsConsoleReady(wrapPlaywrightPage(page))
+  }, {
+    profileDir: opts.profileDir,
+    launcher: opts.launcher,
+    timeoutMs: opts.timeoutMs ?? PREFLIGHT_TIMEOUT_MS
+  });
 }
 
 class XhsBrowserTransport {
@@ -30462,91 +31087,34 @@ class XhsBrowserTransport {
     this.automation = opts?.automation ?? createAutomationGuard();
     this.preflight = opts?.preflight ?? ((profileDir) => checkXhsProfileSession({ profileDir }));
   }
-  async readDraftCount(page) {
-    for (const selector of SELECTORS.draftBox) {
-      const attached = await page.locator(selector).count().catch(() => 0);
-      if (attached === 0)
-        continue;
-      const locator = page.locator(selector).first();
-      if (!locator.textContent)
-        continue;
-      const text = await locator.textContent().catch(() => "");
-      const match = /\u8349\u7A3F\u7BB1\s*[\uFF08(]\s*(\d+)\s*[\uFF09)]/.exec(text);
-      if (match?.[1] !== undefined)
-        return Number(match[1]);
-    }
-    return null;
-  }
-  static draftSavedStamps(now = new Date) {
-    const pad = (value) => String(value).padStart(2, "0");
-    return [0, 1, 2].map((minutesAgo) => {
-      const stamp = new Date(now.getTime() - minutesAgo * 60000);
-      return `\u4FDD\u5B58\u4E8E${stamp.getFullYear()}-${pad(stamp.getMonth() + 1)}-${pad(stamp.getDate())} ${pad(stamp.getHours())}:${pad(stamp.getMinutes())}`;
-    });
-  }
-  async readDraftStamps(page) {
-    const present = [];
-    for (const stamp of XhsBrowserTransport.draftSavedStamps()) {
-      const attached = await page.locator(`text=${stamp}`).count().catch(() => 0);
-      if (attached > 0)
-        present.push(stamp);
-    }
-    return present;
-  }
-  async readDraftBaseline(page) {
-    return { count: await this.readDraftCount(page), stamps: await this.readDraftStamps(page) };
-  }
-  async isDraftSaved(page, baseline) {
-    const stamps = await this.readDraftStamps(page);
-    if (stamps.some((stamp) => !baseline.stamps.includes(stamp)))
-      return true;
-    const after = await this.readDraftCount(page);
-    if (baseline.count === null || after === null)
-      return false;
-    return after > baseline.count;
-  }
-  async clickShadowControl(page, labels) {
-    if (!page.findShadowControl || !page.clickAt) {
-      return {
-        ok: false,
-        error: `submit control: the ${CHANNEL} publish bar lives in a closed shadow root and this driver has no CDP access to resolve it`
-      };
-    }
-    const control = await page.findShadowControl(labels);
-    if (!control) {
-      return {
-        ok: false,
-        error: `submit control: none of [${labels.join(", ")}] found in the ${CHANNEL} publish bar (closed shadow root)`
-      };
-    }
-    await page.clickAt(control.x, control.y);
-    return { ok: true, label: control.label, x: control.x, y: control.y };
-  }
   async publish(payload) {
     if (this.driver !== "script") {
-      return fail(`unsupported driver '${this.driver}' for ${TARGET}: image posts require the script driver (Playwright setInputFiles)`);
-    }
-    const override = typeof payload.options?.profileDir === "string" ? payload.options.profileDir : process.env.XHS_PROFILE_DIR ?? process.env.KK_BROWSER_PROFILE_DIR;
-    const profileDir = resolveBrowserProfileDir(CHANNEL, override);
-    const validation = await validatePublishInput(payload.content);
-    if (validation.error)
-      return fail(validation.error);
-    const paths = validation.paths ?? [];
+      return fail2(`unsupported driver '${this.driver}' for ${TARGET}: the console modes (${XHS_OPERATIONS.join(", ")}) require the script driver (Playwright setInputFiles)`);
+    }
+    const requested = resolveXhsOperation(payload.options, payload.content);
+    if (requested.error !== undefined)
+      return fail2(requested.error);
+    const operation = requested.operation;
+    const validation = await validateModeInput(operation, payload.content);
+    if (validation.error !== undefined)
+      return fail2(validation.error);
+    const input = validation.input;
+    const override = typeof payload.options?.profileDir === "string" ? payload.options.profileDir : undefined;
+    const profileDir = resolveChannelProfileDir(CHANNEL, override);
     const publishStatus = payload.content.metadata?.publishStatus === "public" ? "public" : "draft";
-    const base2 = { driver: this.driver, publishStatus, profileDir, imageCount: paths.length };
     const cap = this.automation.allow("publish");
     if (!cap.allowed)
-      return fail(`automation cap: ${cap.reason}`);
+      return fail2(`automation cap: ${cap.reason}`);
     const session = await this.preflight(profileDir);
     if (session.status !== "verified") {
-      return fail(`session preflight refused (no headed visit attempted): ${session.detail}`);
+      return fail2(`session preflight refused (no headed visit attempted): ${session.detail}`);
     }
     this.automation.record("publish");
     let opened;
     try {
       opened = await this.openPage(profileDir);
     } catch (error51) {
-      return fail(error51 instanceof Error ? error51.message : String(error51));
+      return fail2(error51 instanceof Error ? error51.message : String(error51));
     }
     const { page, close } = opened;
     const act = async (what, fn) => {
@@ -30558,101 +31126,24 @@ class XhsBrowserTransport {
     };
     try {
       await act("creator page goto", () => page.goto(PUBLISH_URL, { timeout: this.loginTimeoutMs }));
-      const gated = await waitUntil(() => isXhsConsoleReady(page), this.loginTimeoutMs);
+      const gated = await waitUntil2(() => isXhsConsoleReady(page), this.loginTimeoutMs);
       if (!gated) {
-        return fail(`login timeout after ${this.loginTimeoutMs}ms: no authenticated ${CHANNEL} creator console in ${profileDir}`);
-      }
-      const step = (selectors, what) => findSelector(page, selectors, what, this.stepTimeoutMs);
-      const draftBaseline = publishStatus === "draft" ? await this.readDraftBaseline(page) : { count: null, stamps: [] };
-      const tabSelector = await step(SELECTORS.imageTab, "image-post tab");
-      const clickInViewport = page.clickInViewport;
-      if (clickInViewport) {
-        const switched = await act("image-post tab click", () => clickInViewport.call(page, tabSelector));
-        if (!switched)
-          return fail("image-post tab click: no in-viewport image tab found");
-      } else {
-        await act("image-post tab click", () => page.locator(tabSelector).first().click({ force: true }));
-      }
-      const fileSelector = await findAttachedSelector(page, SELECTORS.fileInput, "image file input", this.stepTimeoutMs);
-      await act("image upload", () => page.setInputFiles(fileSelector, paths));
-      const thumbSelector = await step(SELECTORS.thumbnail, "thumbnail wait");
-      const countMatches = await waitUntil(() => act("thumbnail count read", () => page.locator(thumbSelector).count()).then((n2) => n2 >= paths.length), this.stepTimeoutMs);
-      const thumbCount = await act("thumbnail count read", () => page.locator(thumbSelector).count());
-      if (!countMatches || thumbCount !== paths.length) {
-        return fail(`thumbnail count: expected ${paths.length}, observed ${thumbCount}`);
-      }
-      const titleSelector = await step(SELECTORS.title, "title input");
-      await act("title fill", () => page.locator(titleSelector).first().fill(payload.content.title ?? ""));
-      const bodySelector = await step(SELECTORS.body, "note body");
-      await act("body fill", async () => {
-        const body = page.locator(bodySelector).first();
-        const text = payload.content.body ?? "";
-        if (typeof body.type === "function") {
-          await body.click();
-          await body.type(text, { delay: 5 });
-          return;
-        }
-        await body.fill(text);
-      });
-      if (publishStatus === "draft") {
-        let submitted2 = null;
-        let confirmed2 = false;
-        let attempts = 0;
-        while (!confirmed2 && attempts < this.submitAttempts) {
-          attempts += 1;
-          await new Promise((resolve3) => setTimeout(resolve3, this.submitSettleMs));
-          const clicked = await this.clickShadowControl(page, SHADOW_CONTROLS.draft);
-          if (!clicked.ok)
-            return fail(clicked.error);
-          submitted2 = clicked;
-          confirmed2 = await waitUntil(() => this.isDraftSaved(page, draftBaseline), this.submitSettleMs);
-        }
-        const draftCountAfter = await this.readDraftCount(page);
-        if (!confirmed2 || submitted2 === null) {
-          return fail(`draft confirmation: '${submitted2?.label ?? SHADOW_CONTROLS.draft[0]}' was clicked ${attempts}\xD7 but neither a fresh ${CHANNEL} save timestamp nor a moved draft counter was observed (before=${String(draftBaseline.count)}, after=${String(draftCountAfter)})`);
-        }
-        return ResultSchema.parse({
-          ok: true,
-          target: TARGET,
-          message: `${TARGET} draft saved (unpublished) in profile ${profileDir} via '${submitted2.label}'`,
-          metadata: {
-            ...base2,
-            draftControl: submitted2.label,
-            draftClick: `${submitted2.x},${submitted2.y}`,
-            draftAttempts: attempts,
-            draftCountBefore: draftBaseline.count,
-            draftCountAfter
-          }
-        });
-      }
-      await new Promise((resolve3) => setTimeout(resolve3, this.submitSettleMs));
-      const submitted = await this.clickShadowControl(page, SHADOW_CONTROLS.publish);
-      if (!submitted.ok)
-        return fail(submitted.error);
-      const urlBeforeSubmit = page.url();
-      const confirmed = await waitUntil(async () => {
-        if (page.url().includes(PUBLISHED_MARKER))
-          return true;
-        return trySelectors(page, SELECTORS.publishConfirm).then((r) => r.found).catch(() => false);
-      }, this.stepTimeoutMs);
-      if (!confirmed) {
-        return fail(`publish submission: state unknown \u2014 the '${submitted.label}' click at ${submitted.x},${submitted.y} was sent from ${urlBeforeSubmit} but no success state was observed (now ${page.url()}). Check the ${CHANNEL} creator note manager before retrying: a retry could duplicate the post.`);
-      }
-      const url2 = page.url();
-      return ResultSchema.parse({
-        ok: true,
-        target: TARGET,
-        ...url2 !== PUBLISH_URL ? { url: url2 } : {},
-        message: `${TARGET} post published`,
-        metadata: {
-          ...base2,
-          publishControl: submitted.label,
-          publishClick: `${submitted.x},${submitted.y}`,
-          publishSignal: url2.includes(PUBLISHED_MARKER) ? `url:${PUBLISHED_MARKER}` : "text"
-        }
+        return fail2(`login timeout after ${this.loginTimeoutMs}ms: no authenticated ${CHANNEL} creator console in ${profileDir}`);
+      }
+      const draftBaseline = publishStatus === "draft" ? await readDraftBaseline(page) : { count: null, stamps: [] };
+      return await runMode(input, {
+        page,
+        content: payload.content,
+        publishStatus,
+        profileDir,
+        driver: this.driver,
+        stepTimeoutMs: this.stepTimeoutMs,
+        submitSettleMs: this.submitSettleMs,
+        submitAttempts: this.submitAttempts,
+        draftBaseline
       });
     } catch (error51) {
-      return fail(error51 instanceof Error ? error51.message : String(error51));
+      return fail2(error51 instanceof Error ? error51.message : String(error51));
     } finally {
       await close();
     }
@@ -30682,7 +31173,7 @@ async function processPublishIO(inputPath, outputPath, transport = getPublishTra
     }
   } catch (error51) {
     const message = `Invalid Content input: ${error51 instanceof Error ? error51.message : String(error51)}`;
-    await writePublishResult(outputPath, fail(message));
+    await writePublishResult(outputPath, fail2(message));
     throw new Error(message);
   }
   const result = ResultSchema.parse(await transport.publish({ content, options }));
@@ -30723,10 +31214,16 @@ export {
   getPublishTransport,
   defaultOpenPage,
   defaultLauncher2 as defaultLauncher,
+  creatorTabSelector,
   createShadowProbe,
+  clickCreatorTab,
   checkXhsProfileSession,
   XhsBrowserTransport,
+  XHS_OPERATIONS,
   PUBLISH_URL,
+  MODE_LIMITS,
   LOGIN_TIMEOUT_MS,
+  CREATOR_TAB_COUNT,
+  CREATOR_TAB_BAR,
   CHANNEL
 };