@gobing-ai/knowledge-kit 0.0.35 → 0.0.37

package/plugins/publishings/xhs-pub/package.json

@@ -14,6 +14,6 @@
         "playwright": "catalog:"
     },
     "devDependencies": {
-        "@types/bun": "1.3.14"
+        "@types/bun": "1.4.3"
     }
 }

package/plugins/publishings/xhs-pub/plugin.json

@@ -4,5 +4,9 @@
     "entry": "./dist/index.js",
     "check": "./dist/profile-check.js",
     "version": "1.0.0",
-    "description": "Publish plugin for Xiaohongshu (xhs): one creator console, four validated operations (上传图文 ≤18 images | 上传视频 | 写长文 | 发播客 audio+cover) saved as a draft via 暂存离开 or published live via 发布, over the Playwright script transport"
+    "description": "Publish plugin for Xiaohongshu (xhs): one creator console, four validated operations (上传图文 ≤18 images | 上传视频 | 写长文 | 发播客 audio+cover) saved as a draft via 暂存离开 or published live via 发布, over the Playwright script transport",
+    "browserSession": {
+        "profileName": "xhs",
+        "homeUrl": "https://creator.xiaohongshu.com/publish/publish"
+    }
 }

package/plugins/publishings/xhs-pub/src/profile-check.ts

@@ -21,9 +21,11 @@
  * `bun plugins/publishings/xhs-pub/src/profile-check.ts check` on the same profile;
  * the full recipe lives in docs/design/xhs-image-cards.md.
  */
+
 import { parseArgs } from 'node:util';
 import { kkBrowserLauncher, resolveChannelProfileDir } from '@gobing-ai/publish-harness/browser';
-import { type BrowserLauncher, loginWithProfile } from '@gobing-ai/ts-browser-automation';
+import { type BrowserLauncher, loginWithProfile, openPersistentBrowser } from '@gobing-ai/ts-browser-automation';
+import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echo, echoError } from '@gobing-ai/ts-utils';
 import { type AutomationGuard, createAutomationGuard } from './automation-guard';
 import {
@@ -68,12 +70,50 @@ export async function loginProfile(opts: ProfileLoginOptions): Promise<void> {
 /** Exit 2 with the human usage on stderr and the ADR-032 `error` verdict as the last stdout line. */
 function usageError(message: string): number {
     echoError(
-        `profile-check: ${message} — usage: profile-check.ts [login|check] [--profile <dir>] [--timeout <ms>] [--headed]`,
+        `profile-check: ${message} — usage: profile-check.ts [login|check|open] [--profile <dir>] [--url <url>] [--timeout <ms>] [--headed]`,
     );
     echo(JSON.stringify({ status: 'error', detail: message }));
     return 2;
 }
 
+/**
+ * Bot-mode open (0277): headed, operator-interactive reopen of an existing profile — no readiness
+ * assertion and no automation-guard record (an open is neither a publish nor a check visit, so it
+ * draws no 2h budget, ADR-025). A missing profile is refused: nothing is fabricated.
+ */
+export async function openXhsSession(opts: {
+    profileDir: string;
+    url?: string;
+    launcher?: BrowserLauncher;
+}): Promise<void> {
+    if (!(await createNodeFileSystem().exists(opts.profileDir))) {
+        throw new Error(`no profile at ${opts.profileDir} — run the login command first`);
+    }
+    const raw = await openPersistentBrowser({
+        profileDir: opts.profileDir,
+        headless: false,
+        launcher: opts.launcher ?? kkBrowserLauncher,
+    });
+    // Structural seam (same pattern as makeDefaultOpenPage): this plugin's tsconfig has no DOM lib
+    // and its playwright resolution differs from the harness', so only the touched surface is named.
+    const context = raw as unknown as {
+        pages(): unknown[];
+        newPage(): Promise<unknown>;
+        once(event: 'close', listener: () => void): unknown;
+    };
+    const page = (context.pages()[0] ?? (await context.newPage())) as {
+        goto(url: string, options?: { waitUntil: 'commit'; timeout: number }): Promise<unknown>;
+    };
+    try {
+        await page.goto(opts.url ?? PUBLISH_URL, { waitUntil: 'commit', timeout: 30_000 });
+    } catch {
+        // The operator is watching the window; keep it open even if the target is slow.
+    }
+    await new Promise<void>((resolveClose) => {
+        context.once('close', resolveClose);
+    });
+}
+
 /** `login|check [--profile <dir>] [--timeout <ms>] [--headed]`; profile precedence matches the publish flow. */
 export async function main(
     argv: string[] = process.argv.slice(2),
@@ -84,6 +124,7 @@ export async function main(
     let profileDir: string;
     let timeoutMs: number | undefined;
     let headed = false;
+    let sessionUrl: string | undefined;
     try {
         const { positionals, values } = parseArgs({
             args: argv,
@@ -92,10 +133,15 @@ export async function main(
                 profile: { type: 'string' },
                 timeout: { type: 'string' },
                 headed: { type: 'boolean' },
+                url: { type: 'string' },
             },
         });
         command = positionals[0] ?? 'check';
         headed = values.headed === true;
+        if (command === 'open' && values.profile === undefined) {
+            throw new Error('open requires an explicit --profile <dir>');
+        }
+        sessionUrl = values.url;
         if (values.timeout !== undefined) {
             timeoutMs = Number(values.timeout);
             if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {
@@ -110,12 +156,36 @@ export async function main(
         try {
             await loginProfile({ profileDir, timeoutMs, launcher });
             echo(`xhs profile login verified: ${profileDir}`);
+            // Bot mode (`kk bot login` supplies --url): the parent persists a default URL only from
+            // this LAST-line verdict, and only the plugin-owned creator console is canonical — never
+            // the operator's URL. Without --url the operator-mode output stands unchanged.
+            if (sessionUrl !== undefined) {
+                echo(JSON.stringify({ status: 'verified', profileDir, defaultUrl: PUBLISH_URL }));
+            }
             return 0;
         } catch (error) {
             echoError(`xhs profile login failed: ${error instanceof Error ? error.message : String(error)}`);
             return 1;
         }
     }
+    if (command === 'open') {
+        try {
+            await openXhsSession({ profileDir, url: sessionUrl, launcher });
+        } catch (error) {
+            const detail = `xhs profile open refused: ${error instanceof Error ? error.message : String(error)}`;
+            echoError(detail);
+            echo(JSON.stringify({ status: 'refused', profileDir, detail }));
+            return 1;
+        }
+        echo(
+            JSON.stringify({
+                status: 'verified',
+                profileDir,
+                detail: `xhs profile session closed by the operator: ${profileDir}`,
+            }),
+        );
+        return 0;
+    }
     if (command !== 'check') {
         return usageError(`unknown command '${command}'`);
     }