@gobing-ai/knowledge-kit 0.0.37 → 0.1.0

package/plugins/publishings/bilibili-pub/src/index.ts

@@ -0,0 +1,139 @@
+/**
+ * bilibili-pub — Bilibili video uploads and dynamic posts publish plugin surface (task 0297).
+ *
+ * Implements the manifest-facing plugin surface:
+ * - Declared operations list (`BILIBILI_OPERATIONS`: `['shortVideo', 'dynamic']`)
+ * - Operation and driver resolution BEFORE browser or profile initialization
+ * - `getPublishTransport`: returns FakeBrowserTransport under KNOWLEDGE_KIT_PUBLISH_TRANSPORT=fake
+ *   or BilibiliBrowserTransport
+ * - `--in/--out` IO contract in `processPublishIO`
+ * - CLI `main` entrypoint
+ */
+
+import { dirname } from 'node:path';
+import { parseArgs } from 'node:util';
+import { type Content, ContentSchema, type Result, ResultSchema } from '@gobing-ai/kk-core';
+import { type BrowserDriver, FakeBrowserTransport, type PublishTransport } from '@gobing-ai/publish-harness';
+import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
+import { echoError } from '@gobing-ai/ts-utils';
+import { BilibiliBrowserTransport, bounded, boundedDetail, errorMessage, fail } from './flow';
+import { BILI_TARGET, BILIBILI_OPERATIONS, type BilibiliOperation } from './selectors';
+
+export { BILIBILI_OPERATIONS, type BilibiliOperation };
+
+/**
+ * Resolves the requested operation (`options.operation ?? content.metadata.operation ?? 'shortVideo'`)
+ * BEFORE any browser or profile is created. Undeclared values are refused by name.
+ */
+export function resolveOperation(
+    options?: Record<string, unknown>,
+    content?: Content,
+): { operation: BilibiliOperation; error?: undefined } | { operation?: undefined; error: string } {
+    const raw = options?.operation ?? content?.metadata?.operation ?? 'shortVideo';
+    if (typeof raw !== 'string' || !(BILIBILI_OPERATIONS as readonly string[]).includes(raw)) {
+        return {
+            error: `unsupported operation '${bounded(raw)}' for ${BILI_TARGET}: expected one of ${BILIBILI_OPERATIONS.join(', ')}`,
+        };
+    }
+    return { operation: raw as BilibiliOperation };
+}
+
+/**
+ * Resolves the driver from `options.driver ?? 'script'`. Only 'script' is supported.
+ */
+function resolveDriver(
+    options?: Record<string, unknown>,
+): { driver: BrowserDriver; error?: undefined } | { driver?: undefined; error: string } {
+    const raw = options?.driver ?? 'script';
+    if (raw !== 'script') {
+        return {
+            error: `unsupported driver '${bounded(raw)}' for ${BILI_TARGET}: expected one of script (the bilibili-pub browser flow has no agent path)`,
+        };
+    }
+    return { driver: 'script' };
+}
+
+/**
+ * Resolves the channel transport: FakeBrowserTransport when KNOWLEDGE_KIT_PUBLISH_TRANSPORT=fake,
+ * or BilibiliBrowserTransport.
+ */
+export function getPublishTransport(
+    operation: BilibiliOperation = 'shortVideo',
+    driver: BrowserDriver = 'script',
+): PublishTransport {
+    if (process.env.KNOWLEDGE_KIT_PUBLISH_TRANSPORT === 'fake') return new FakeBrowserTransport('script');
+    return new BilibiliBrowserTransport(operation, driver);
+}
+
+/** Writes the Result to `--out`, creating parent directories if needed. */
+async function writePublishResult(outputPath: string, result: Result): Promise<void> {
+    const outDir = dirname(outputPath);
+    if (outDir && outDir !== '.') await createNodeFileSystem().ensureDir(outDir);
+    await createNodeFileSystem().writeFile(outputPath, JSON.stringify(result, null, 2));
+}
+
+/**
+ * Process `--in/--out` publish IO contract.
+ */
+export async function processPublishIO(
+    inputPath: string,
+    outputPath: string,
+    transport?: PublishTransport,
+): Promise<void> {
+    await createNodeFileSystem().deleteFile(outputPath);
+    let content: Content;
+    let options: Record<string, unknown> | undefined;
+    try {
+        const raw = JSON.parse(await createNodeFileSystem().readFile(inputPath)) as Record<string, unknown>;
+        content = ContentSchema.parse(raw);
+        if (raw.options !== undefined && typeof raw.options === 'object' && raw.options !== null) {
+            options = raw.options as Record<string, unknown>;
+        }
+    } catch (error: unknown) {
+        const message = boundedDetail(`Invalid Content input: ${errorMessage(error)}`);
+        await writePublishResult(outputPath, fail(BILI_TARGET, message));
+        throw new Error(message);
+    }
+    const mode = resolveOperation(options, content);
+    if (mode.error !== undefined) {
+        await writePublishResult(outputPath, fail(BILI_TARGET, mode.error));
+        throw new Error(mode.error);
+    }
+    const driverMode = resolveDriver(options);
+    if (driverMode.error !== undefined) {
+        await writePublishResult(outputPath, fail(BILI_TARGET, driverMode.error));
+        throw new Error(driverMode.error);
+    }
+    const resolved = transport ?? getPublishTransport(mode.operation, driverMode.driver);
+    const result = ResultSchema.parse(await resolved.publish({ content, options }));
+    await writePublishResult(outputPath, result);
+    if (!result.ok) throw new Error(result.error ?? 'Publish failed');
+}
+
+/**
+ * CLI entry point: `--in <content.json> --out <result.json>`.
+ */
+export async function main(): Promise<number> {
+    let values: { in?: string; out?: string };
+    try {
+        ({ values } = parseArgs({ options: { in: { type: 'string' }, out: { type: 'string' } } }));
+    } catch (error: unknown) {
+        echoError(`Invalid arguments: ${errorMessage(error)}`);
+        return 1;
+    }
+    if (!values.in || !values.out) {
+        echoError('Missing required arguments: --in and --out');
+        return 1;
+    }
+    try {
+        await processPublishIO(values.in, values.out);
+        return 0;
+    } catch (error: unknown) {
+        echoError(`bilibili-pub failed: ${boundedDetail(errorMessage(error))}`);
+        return 1;
+    }
+}
+
+if (import.meta.main) {
+    process.exit(await main());
+}

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

@@ -0,0 +1,19 @@
+/**
+ * bilibili profile-session capability (task 0297, Chunk A).
+ *
+ * `login` opens the Bilibili member creator home (https://member.bilibili.com/,
+ * see `src/selectors.ts`) in a headed browser and resolves only once the site readiness predicate
+ * passes; `check` reopens the profile (headlessly, unless the operator passes `--headed` or the
+ * config sets `checkHeadedOnly`) and reports `verified` or `refused`; `open` just brings the
+ * window up. Arg parsing, profile precedence (`--profile` > `BILIBILI_PROFILE_DIR` >
+ * `KK_BROWSER_PROFILE_DIR` > `~/.config/kk/browser-profiles/bilibili`) and exit codes
+ * (0 verified, 1 refused, 2 usage error) all live in the shared `runProfileCli`, so the publish
+ * preflight and this CLI apply one gate.
+ */
+
+import { runProfileCli } from '@gobing-ai/publish-harness/browser';
+import { BILI_CONFIG } from './selectors';
+
+if (import.meta.main) {
+    process.exit(await runProfileCli(BILI_CONFIG, Bun.argv.slice(2)));
+}

package/plugins/publishings/bilibili-pub/src/selectors.ts

@@ -0,0 +1,222 @@
+/**
+ * bilibili-pub selectors — selector/URL/regex/timeout constants for Bilibili video uploads and
+ * dynamic posts (task 0297).
+ *
+ * Grounding: the recovered Bilibili platform adapters
+ * `.spur/run/yijianfa-source/platforms/bilibili.js` (810 lines) and
+ * `.spur/run/yijianfa-source/platforms/bilibili-main.js` (86 lines) pin the creator mechanics cited
+ * below:
+ * - Dynamic post composer at t.bilibili.com (bilibili.js:158-287, bilibili-main.js:33-86):
+ *   the contenteditable editor (bilibili.js:171, 209), image cleanup (bilibili.js:174-184),
+ *   image upload entry and preview readback (bilibili.js:231, 238, 257; the vendor injects the file
+ *   through a MAIN-world message bridge, bilibili-main.js:54-81 — deliberately NOT reproduced),
+ *   and the launch button (bilibili.js:273).
+ * - Video cover dialog (bilibili.js:290-360):
+ *   div.cover-main entry (bilibili.js:292-293), file input in modal (bilibili.js:312), modal
+ *   " 完成 " submit button (bilibili.js:342-346), and preview change detection (bilibili.js:296-301,
+ *   348-356).
+ * - Short video upload at member.bilibili.com (bilibili.js:365-556):
+ *   video file input (bilibili.js:397, 401) and its file injection (bilibili.js:417), title input up
+ *   to 80 chars (bilibili.js:431), description editor (bilibili.js:454), tags input and readback
+ *   (bilibili.js:485, 488, 501-507), "自制" radio button (bilibili.js:520), and submit button
+ *   (bilibili.js:548).
+ * The partition/category chooser has NO source control: the adapter only ever writes the API field
+ * `form.append("category", "daily")` (bilibili.js:571), and no partition/dropdown selector appears
+ * anywhere in the recovered file — the partition selectors below are therefore Provisional and fail
+ * closed.
+ * Anything the evidence does not pin is Provisional and fails closed: a missing control is a loud
+ * typed refusal, never a silent no-op or broad fallback.
+ */
+
+import type { ChannelBrowserConfig } from '@gobing-ai/publish-harness/browser';
+import { waitUntil } from '@gobing-ai/publish-harness/browser';
+import type { IsAuthenticatedPredicate } from '@gobing-ai/ts-browser-automation';
+
+/** Site-owned target slug; also the profile channel key (`BILIBILI_PROFILE_DIR`). */
+export const BILI_TARGET = 'bilibili';
+
+/**
+ * Fixed member home entry (task 0297 Design freeze): Bilibili Creator Studio.
+ * Grounded entry for shortVideo operation.
+ */
+export const BILI_MEMBER_HOME_URL = 'https://member.bilibili.com/';
+
+/**
+ * Fixed dynamic home entry (task 0297 Design freeze): Bilibili Dynamic Feed.
+ * Grounded entry for dynamic operation.
+ */
+export const BILI_DYNAMIC_HOME_URL = 'https://t.bilibili.com/';
+
+/**
+ * Login/passport redirect marker.
+ * Matches passport login or account authentication gateways.
+ */
+export const BILI_LOGIN_URL_RE = /(passport\.bilibili\.com\/login|account\.bilibili\.com\/login|\/(signin|login))/;
+
+/**
+ * Supported operations for bilibili-pub (task 0297 Design freeze).
+ * 'shortVideo' publishes to member.bilibili.com; 'dynamic' publishes to t.bilibili.com.
+ */
+export const BILIBILI_OPERATIONS = ['shortVideo', 'dynamic'] as const;
+export type BilibiliOperation = (typeof BILIBILI_OPERATIONS)[number];
+
+/**
+ * Video upload form selectors (bilibili.js:290-360, 365-556).
+ */
+export const BILI_VIDEO_SELECTORS = {
+    /** Video file input candidates (bilibili.js:397, 401). */
+    videoInput: [
+        'input[type="file"][accept*="video"]',
+        'input[type="file"][accept*=".mp4"]',
+        'input[type="file"][accept*=".mov"]',
+        'input[type="file"]',
+    ],
+    /** Video title input candidates: max 80 chars (bilibili.js:431). */
+    titleInput: ['input[maxlength="80"][type="text"]', 'input[placeholder*="标题"]'],
+    /** Video description editor (bilibili.js:454). */
+    descriptionEditor: ['div.ql-editor[contenteditable="true"]', '[contenteditable="true"].ql-editor'],
+    /**
+     * Partition / category selection candidates — **Provisional**: the recovered adapter has no
+     * partition UI control at all; it only writes the API field `form.append("category", "daily")`
+     * (bilibili.js:571). These candidates are probed read-only and a missing chooser is a typed
+     * refusal, never a silently skipped partition.
+     */
+    partitionCandidates: [
+        'div.select-item',
+        'div.category-item',
+        'div.drop-cascader-item',
+        'div.video-type-item',
+        'div.select-controller',
+        'div.radio-item',
+    ],
+    /** Tag input candidates (bilibili.js:485). */
+    tagInput: ['input[placeholder="按回车键Enter创建标签"]', 'input[placeholder*="创建标签"]'],
+    /** Tag elements container / labels for cleanup and readback (bilibili.js:479, 503). */
+    tagItems: 'div.tag-pre-wrp > div.label-item-v2-container',
+    /** "自制" (original) radio button (bilibili.js:520). */
+    originalRadio: 'span.check-radio-v2-name',
+    /** Cover main container (bilibili.js:292-293). */
+    coverMain: 'div.cover-main',
+    coverSlot: '.cover-slot',
+    coverImg: '.cover-img',
+    coverEntries: ['更换封面', '封面设置', '添加封面'],
+    /** Cover upload file input inside modal (bilibili.js:312). */
+    coverFileInput: [
+        "div.bcc-upload-wrapper > input[type='file'][accept='image/png, image/jpeg']",
+        "div.bcc-upload-wrapper input[type='file']",
+        "input[type='file'][accept*='image']",
+    ],
+    /** Cover modal completion submit button (bilibili.js:342-346). */
+    coverSubmit: 'div.submit',
+    /** Public video submission button (bilibili.js:548). */
+    submitAdd: [
+        'span.submit-add',
+        'button.submit-add',
+        'span:text-is("立即投稿")',
+        'button:text-is("立即投稿")',
+        'span:text-is("投稿")',
+        'button:text-is("投稿")',
+    ],
+    /** Save draft button for draft status (provisional — draft requires observed save draft control). */
+    saveDraft: [
+        'span.submit-draft',
+        'button.submit-draft',
+        'button:text-is("存草稿")',
+        'button:text-is("保存草稿")',
+        'span:text-is("存草稿")',
+        'span:text-is("保存草稿")',
+    ],
+} as const;
+
+/**
+ * Dynamic post composer selectors (bilibili.js:158-287, bilibili-main.js:33-86).
+ */
+export const BILI_DYNAMIC_SELECTORS = {
+    /** Dynamic composer container (bilibili.js:270-271). */
+    composer: '.bili-dyn-publishing',
+    /** Dynamic text editor (bilibili.js:171, 209). */
+    editor: [
+        'div[placeholder="有什么想和大家分享的？"][contenteditable="true"]',
+        'div.bili-dyn-publishing div[contenteditable="true"]',
+    ],
+    /** Optional title input for dynamic posts (bilibili.js:187). */
+    titleInput: 'input[maxlength="20"][placeholder="好的标题更容易获得支持，选填20字"]',
+    /** Remove button for existing images (bilibili.js:178). */
+    removeImageBtn: 'div.bili-pics-uploader__item__remove',
+    /** Image upload entry container (bilibili.js:231). */
+    imageUploadEntry: 'div.bili-dyn-publishing__image-upload',
+    /** Native file input for dynamic images (bilibili-main.js:54-81). */
+    imageInput: [
+        'div.bili-dyn-publishing__image-upload input[type="file"]',
+        '.bili-pics-uploader input[type="file"]',
+        'input[type="file"][name="upload"]',
+        'input[type="file"][accept*="image"]',
+    ],
+    /** Add image button (bilibili-main.js:75). */
+    imageAddBtn: '.bili-pics-uploader__add',
+    /** Preview items for dynamic images (bilibili.js:238, 257). */
+    imagePreviews: '.bili-pics-uploader__item, .bili-dyn-publishing__image-item',
+    /** Publish / Launch button for dynamic posts (bilibili.js:273). */
+    launchButton: ['button.bili-dyn-publishing__action__launch', 'button:text-is("发布")'],
+} as const;
+
+/**
+ * Receipt-shaped URLs for shortVideo and dynamic publishing.
+ * shortVideo pending-review receipt matches upload manager or video BV URL.
+ * dynamic receipt matches opus / t.bilibili.com post URL.
+ */
+export const BILI_RECEIPT_URL_RES = [
+    /member\.bilibili\.com\/platform\/upload-manager\/article/,
+    /member\.bilibili\.com\/video\/BV[0-9a-zA-Z]+/,
+    /bilibili\.com\/video\/BV[0-9a-zA-Z]+/,
+    /member\.bilibili\.com\/platform\/upload\/video\/success/,
+    /t\.bilibili\.com\/[0-9]+/,
+    /t\.bilibili\.com\/opus\/[0-9]+/,
+    /bilibili\.com\/opus\/[0-9]+/,
+] as const;
+
+/** Upload and media processing timeout ceiling (600 seconds = 10 minutes). */
+export const BILI_UPLOAD_TIMEOUT_MS = 600_000;
+
+/** Login timeout for profile CLI checks. */
+export const BILI_LOGIN_TIMEOUT_MS = 180_000;
+
+/**
+ * Checks whether the current page session is authenticated for Bilibili creator surfaces.
+ * Returns false if redirected to passport login; checks for creator navigation/avatar or
+ * composer presence within 15 seconds.
+ */
+export const isBilibiliAuthenticated: IsAuthenticatedPredicate = async (page) => {
+    if (BILI_LOGIN_URL_RE.test(page.url())) return false;
+    return waitUntil(
+        async () => {
+            if (BILI_LOGIN_URL_RE.test(page.url())) return false;
+            const authenticated = await page.evaluate(`(() => {
+                const isLoginPage = Boolean(
+                    document.querySelector('.login-box, .bili-mini-login, .login-container') ||
+                        window.location.href.includes('passport.bilibili.com'),
+                );
+                if (isLoginPage) return false;
+                return Boolean(
+                    document.querySelector(
+                        '.header-entry-avatar, .nav-user-info, .bili-avatar, a[href*="space.bilibili.com"], .bili-dyn-publishing, div[placeholder="有什么想和大家分享的？"], input[type="file"]',
+                    ),
+                );
+            })()`);
+            return Boolean(authenticated);
+        },
+        15_000,
+        500,
+    );
+};
+
+/**
+ * Site-owned config for shared session check and operator CLI (ADR-032).
+ */
+export const BILI_CONFIG: ChannelBrowserConfig = {
+    channel: BILI_TARGET,
+    homeUrl: BILI_MEMBER_HOME_URL,
+    isAuthenticated: isBilibiliAuthenticated,
+    loginTimeoutMs: BILI_LOGIN_TIMEOUT_MS,
+    checkHeadedOnly: false,
+};

package/plugins/publishings/bilibili-pub/tsconfig.json

@@ -0,0 +1,4 @@
+{
+    "extends": "../../../tooling/typescript/base.json",
+    "include": ["src"]
+}