@gobing-ai/knowledge-kit 0.0.33 → 0.0.35

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

@@ -2,7 +2,7 @@
     "name": "wechatmp-pub",
     "kind": "publish",
     "entry": "./dist/index.js",
-    "check": "./src/profile-check.ts",
+    "check": "./dist/profile-check.js",
     "version": "1.0.0",
     "description": "Publish plugin for the WeChat MP console via ts-browser-automation: draft-box first (ADR-022), headed publish behind a session preflight"
 }

package/plugins/publishings/wechatmp-pub/src/enrich.ts

@@ -1,6 +1,5 @@
 import { trySelectors } from '@gobing-ai/publish-harness';
-import { waitUntil } from '@gobing-ai/publish-harness/browser';
-import { clickSelector, fillSelector, POLL_MS, type WechatPage } from './page';
+import { clickSelector, fillSelector, type WechatPage, waitForVisible } from './page';
 
 /**
  * The 文章 operation's `metadata.wechatmp` enrichment rail (2026-09-29, ADR-026).
@@ -19,16 +18,28 @@ import { clickSelector, fillSelector, POLL_MS, type WechatPage } from './page';
 
 const DIALOG = '.weui-desktop-dialog:visible';
 const CONFIRM = `${DIALOG} button:has-text("确认"), ${DIALOG} button:has-text("确定")`;
-const ORIGINAL_SWITCH = '.setting-group__switch.js_edit_ori';
-const TAG_ROW = '.allow_click_opr.js_article_tags_label';
+/**
+ * Every settings row follows one shape (operator walk 2026-10-10): a row control that opens a dialog,
+ * an action inside it, then 确定. The row's own label is listed alongside its `>` expander because both
+ * dispatch the same handler; the first selector that resolves wins.
+ */
+const ROW_ORIGINAL = ['.setting-group__switch.js_edit_ori', '.js_edit_ori', 'text=原创'];
+const ROW_REWARD = ['.setting-group__switch.js_can_reward', '.js_can_reward', 'text=赞赏'];
+const ROW_COLLECTION = ['.allow_click_opr.js_article_tags_label', 'text=合集'];
+const ROW_URL = ['.allow_click_opr.js_url_checkbox', 'text=原文链接'];
+const ROW_CLAIM = ['#js_claim_source_area .frm_checkbox_label', 'text=创作来源'];
+const DIALOG_CONFIRM = CONFIRM;
 const TAG_INPUT = 'input[placeholder*="合集"]';
-const CLAIM_SOURCE = '#js_claim_source_area .frm_checkbox_label';
-const AUDIO_MENU = 'li.js_insertaudio';
-const AUDIO_DIALOG = '.audio_dialog';
-/** The 素材库 rows stream in after the dialog opens, so the dedupe probe retries while they load. */
-const AUDIO_DIALOG_TIMEOUT_MS = 15_000;
-const AUDIO_ROW_RETRIES = 2;
-const AUDIO_ROW_SETTLE_MS = 1_200;
+/** The 赞赏 dialog's account field, filled only when the platform leaves it empty. */
+const REWARD_ACCOUNT = [
+    `${DIALOG} input[placeholder*="赞赏"]`,
+    `${DIALOG} input[placeholder*="账户"]`,
+    `${DIALOG} input.frm_input`,
+];
+/** The 原文链接 dialog's URL field. */
+const URL_INPUT = [`${DIALOG} input[type="url"]`, `${DIALOG} input[placeholder*="链接"]`, `${DIALOG} input.frm_input`];
+/** The 原创 dialog's declaration choice; the dialog validates on 确定 alone for this account. */
+const ORIGINAL_DECLARATION = `${DIALOG} :text("文字原创")`;
 /** The 合集 picker's options load after the dialog opens (the pre-ADR-029 settle, kept). */
 const COLLECTION_SETTLE_MS = 1_200;
 /** The settings panel re-renders after a dialog confirm and can briefly detach rows. */
@@ -36,16 +47,15 @@ const STEP_RETRY_SETTLE_MS = 1_000;
 const SWEEP_SETTLE_MS = 400;
 
 /**
- * Set the operator's draft metadata (原创/作者/合集/创作来源) in the v2 editor.
+ * Set the operator's draft metadata (原创/赞赏/合集/原文链接/创作来源) in the v2 editor.
  *
  * Runs on a FRESH draft only — the toggles are not state-aware (no idempotency for re-runs).
- * Per-field failures are collected into warnings and surfaced in the `Result`; the draft still
- * saves. Dialog mapping evidence (probes 2026-09-29, drafts 100000805/808): 原创 + 赞赏 share ONE
- * dialog (声明类型 radios, 作者 input, 确定) and the 赞赏 switch stays hidden for this account, so
- * 赞赏 is a manual step; the 合集 dialog is a 请选择合集 input + 确认; 创作来源 is an inline checkbox
- * (no dialog). The 原创 dialog only closes when WeChat's own validation passes — the author must be
- * the reward (赏) account picked from its search, which does not resolve headless for this account,
- * so a non-closing dialog is swept and surfaced as a warning.
+ * Per-field failures are collected into warnings and surfaced in the `Result`; the draft still saves.
+ *
+ * Every step follows the operator's measured shape (2026-10-10): open the row, act in the dialog,
+ * click 确定. The previous rail modelled 原创 as "choose the declaration, then the author must resolve
+ * to the 赏 account" and skipped 赞赏 / 原文链接 entirely — which is why 作者, 原创 and 赞赏 all came
+ * back unset on the daily run.
  */
 export async function enrichArticle(page: WechatPage, meta: Record<string, unknown>): Promise<string[]> {
     const warnings: string[] = [];
@@ -54,17 +64,33 @@ export async function enrichArticle(page: WechatPage, meta: Record<string, unkno
     // Sweep any leaked dialog so the next step (especially 保存为草稿) is never overlay-blocked.
     const sweep = async () => {
         const cancel = await trySelectors(page, ['button:has-text("取消")']);
-        if (cancel.found)
-            await page
-                .locator(cancel.selector ?? '')
-                .first()
-                .click({ timeout: 2_000 })
-                .catch(() => undefined);
+        if (cancel.found) {
+            try {
+                await page
+                    .locator(cancel.selector ?? '')
+                    .first()
+                    .click({ timeout: 2_000 });
+            } catch {
+                // The dialog may already be gone; the sweep is best-effort.
+            }
+        }
         await page.press?.('Escape');
         await page.waitForTimeout?.(SWEEP_SETTLE_MS);
     };
-    // One retry per step: the settings panel re-renders after dialog confirms and can briefly
-    // detach rows (observed on the tags row right after the original-declaration confirm).
+    /** Open a settings row: its label or `>` expander, whichever the build exposes. */
+    const openRow = async (row: readonly string[], what: string) => {
+        for (const selector of row) {
+            // `trySelectors` already absorbs a throwing probe and returns {found:false}, so a
+            // `.catch()` here would be unreachable.
+            const found = await trySelectors(page, [selector]);
+            if (found.found) {
+                await clickSelector(page, selector, 8_000);
+                return;
+            }
+        }
+        throw new Error(`no ${what} row control among [${row.join(' | ')}]`);
+    };
+    /** One retry per step: the panel re-renders after a dialog confirm and can briefly detach rows. */
     const step = async (name: string, fn: () => Promise<void>) => {
         try {
             await fn();
@@ -81,149 +107,84 @@ export async function enrichArticle(page: WechatPage, meta: Record<string, unkno
             await sweep();
         }
     };
+    /** True once every dialog has closed — the platform's own validation gate on a settings dialog. */
+    const dialogsClosed = async () =>
+        (await page.evaluate(`[...document.querySelectorAll('.weui-desktop-dialog')].every((d) => !d.offsetWidth)`)) !==
+        false;
 
     if (on('original')) {
         await step('原创声明', async () => {
-            await clickSelector(page, ORIGINAL_SWITCH, 10_000);
-            await clickSelector(page, `${DIALOG} :text("文字原创")`, 8_000);
+            await openRow(ROW_ORIGINAL, '原创声明');
+            // The declaration radio only exists on some builds; 确定 alone is the documented action.
+            const declaration = await trySelectors(page, [ORIGINAL_DECLARATION]).catch(() => ({ found: false }));
+            if (declaration.found) await clickSelector(page, ORIGINAL_DECLARATION, 5_000);
+            await clickSelector(page, DIALOG_CONFIRM, 8_000);
+        });
+        if (!(await dialogsClosed())) warnings.push('原创声明: dialog did not close — check the draft');
+    }
+
+    if (on('reward')) {
+        await step('赞赏', async () => {
+            await openRow(ROW_REWARD, '赞赏');
+            // 赞赏账户 defaults from 作者; fill it only when the platform left it empty.
             const author = str('author');
-            if (author !== '') await fillSelector(page, `${DIALOG} input[placeholder*="作者"]`, author);
-            await clickSelector(page, CONFIRM, 8_000);
+            if (author !== '') {
+                for (const selector of REWARD_ACCOUNT) {
+                    const found = await trySelectors(page, [selector]).catch(() => ({ found: false, selector: null }));
+                    if (!found.found) continue;
+                    const empty = await page.evaluate(
+                        `(() => { const el = document.querySelector(${JSON.stringify(selector)}); return !el || (el.value ?? '').trim() === ''; })()`,
+                    );
+                    if (empty === true) await fillSelector(page, selector, author);
+                    break;
+                }
+            }
+            await clickSelector(page, DIALOG_CONFIRM, 8_000);
         });
-        const committed = await page.evaluate(
-            `[...document.querySelectorAll('.weui-desktop-dialog')].every((d) => !d.offsetWidth)`,
-        );
-        if (committed === false) {
-            warnings.push('原创声明: 未生效 - 作者须为赞赏账户(搜索选择)，请手动设置');
-            await sweep();
-        }
+        if (!(await dialogsClosed())) warnings.push('赞赏: dialog did not close — check the draft');
     }
 
     const collection = str('collection');
     if (collection !== '') {
         await step('合集', async () => {
-            await clickSelector(page, TAG_ROW, 8_000);
+            await openRow(ROW_COLLECTION, '合集');
             await waitForVisible(page, TAG_INPUT, 8_000);
             await fillSelector(page, TAG_INPUT, collection);
             await page.waitForTimeout?.(COLLECTION_SETTLE_MS);
             await clickSelector(page, `${DIALOG} :text("${collection}")`, 8_000);
-            await clickSelector(page, CONFIRM, 8_000);
+            await clickSelector(page, DIALOG_CONFIRM, 8_000);
         });
+        if (!(await dialogsClosed())) warnings.push('合集: dialog did not close — check the draft');
     }
 
-    if (on('aiGenerated')) {
+    const originalUrl = str('originalUrl');
+    if (originalUrl !== '') {
+        await step('原文链接', async () => {
+            await openRow(ROW_URL, '原文链接');
+            const field = await trySelectors(page, URL_INPUT);
+            if (!field.found) throw new Error('no URL field in the 原文链接 dialog');
+            await fillSelector(page, field.selector ?? URL_INPUT.join(', '), originalUrl);
+            await clickSelector(page, DIALOG_CONFIRM, 8_000);
+        });
+        if (!(await dialogsClosed())) warnings.push('原文链接: dialog did not close — check the draft');
+    }
+
+    // 创作来源 is the operator's chosen stance (`个人观点，仅供参考` for this column), not a fixed
+    // "AI generated" declaration — the label is the metadata value so the operator owns the wording.
+    const claimSource = str('claimSource');
+    if (claimSource !== '') {
         await step('创作来源', async () => {
-            await clickSelector(page, CLAIM_SOURCE, 8_000);
-            // Probes show no dialog on current builds — the checkbox alone declares AI generation.
+            await openRow(ROW_CLAIM, '创作来源');
             const dialog = await waitForVisible(page, DIALOG, 3_000, { required: false });
             if (dialog !== undefined) {
-                await clickSelector(page, `${DIALOG} :text("内容由AI生成")`, 8_000);
-                await clickSelector(page, CONFIRM, 8_000);
+                await clickSelector(page, `${DIALOG} :text("${claimSource}")`, 8_000);
+                await clickSelector(page, DIALOG_CONFIRM, 8_000);
             }
         });
         const checked = await page.evaluate(`!!document.querySelector('#js_claim_source_area input:checked')`);
-        if (checked === false) warnings.push('创作来源: 勾选未生效，请手动设置');
+        if (checked === false) warnings.push('创作来源: 未生效，请手动设置');
     }
 
     await sweep();
     return warnings;
 }
-
-/**
- * Audio embed at the article top (operator request 2026-09-29): open the editor's audio menu (a
- * hover dropdown — a JS click bypasses the hover gate), reuse an existing same-title 素材库
- * material, and insert it at the caret (placed at the article start first).
- *
- * Uploading a missing material is deliberately manual: docs/04 records the 上传音频 form as
- * iframe-based and unmapped, and the walk did not re-measure it. Fail-soft — every non-committed
- * outcome returns a warning string, `''` means placed at the top.
- */
-export async function insertAudio(page: WechatPage, title: string): Promise<string> {
-    const CARET = `(() => {
-            const pm = [...document.querySelectorAll('.ProseMirror')].find((e) => !(e.getAttribute('data-placeholder') ?? '').includes('标题'));
-            if (!pm || !pm.firstChild) return;
-            const r = document.createRange();
-            r.setStart(pm.firstChild, 0);
-            r.collapse(true);
-            const sel = window.getSelection();
-            sel?.removeAllRanges();
-            sel?.addRange(r);
-        })()`;
-    const DEDUPE = `(() => {
-            const want = ${JSON.stringify(title)}.replace(/\\s+/g, '');
-            const hit = [...document.querySelectorAll('label.frm_checkbox_label.audio_item')]
-                .find((l) => (l.textContent ?? '').replace(/\\s+/g, '').includes(want));
-            if (!hit) return 'missing';
-            const cb = (hit.closest('li') ?? hit.parentElement)?.querySelector('input[type=checkbox]');
-            if (!cb) return 'nobox';
-            cb.click();
-            return 'checked';
-        })()`;
-    const INSERT = `(() => {
-            const btn = [...document.querySelectorAll('button')].find((b) => (b.textContent ?? '').trim() === '插入' && b.offsetWidth > 0);
-            if (!btn) return false;
-            btn.click();
-            return true;
-        })()`;
-    const CANCEL = `(() => {
-            const btn = [...document.querySelectorAll('button')].find((b) => (b.textContent ?? '').trim() === '取消' && b.offsetWidth > 0);
-            btn?.click();
-        })()`;
-    const VERIFY = `(() => {
-            const pm = [...document.querySelectorAll('.ProseMirror')].find((e) => !(e.getAttribute('data-placeholder') ?? '').includes('标题'));
-            if (!pm) return 'noeditor';
-            const node = pm.querySelector('mpvoice, [class*="audio"]');
-            if (!node) return 'absent';
-            const first = pm.firstElementChild;
-            return first && (first === node || first.contains(node)) ? 'top' : 'notop';
-        })()`;
-
-    try {
-        await page.evaluate(CARET);
-        await page.evaluate(`document.querySelector(${JSON.stringify(AUDIO_MENU)})?.click()`);
-        await waitForVisible(page, AUDIO_DIALOG, AUDIO_DIALOG_TIMEOUT_MS);
-        // The 素材库 list loads async after the dialog opens — retry while rows stream in.
-        let dedupe = String(await page.evaluate(DEDUPE));
-        for (let i = 0; dedupe === 'missing' && i < AUDIO_ROW_RETRIES; i += 1) {
-            await page.waitForTimeout?.(AUDIO_ROW_SETTLE_MS);
-            dedupe = String(await page.evaluate(DEDUPE));
-        }
-        if (dedupe !== 'checked') {
-            await page.evaluate(CANCEL);
-            return dedupe === 'missing'
-                ? '音频: 素材库无同名音频，请手动上传后插入'
-                : '音频: 同名素材行未找到勾选框，请手动插入';
-        }
-        if ((await page.evaluate(INSERT)) !== true) {
-            await page.evaluate(CANCEL);
-            return '音频: 插入按钮未找到，请手动插入';
-        }
-        await page.waitForTimeout?.(2_000);
-        const state = String(await page.evaluate(VERIFY));
-        if (state === 'absent' || state === 'noeditor') return '音频: 插入未生效，请手动检查';
-        if (state === 'notop') return '音频: 已插入但未在文首，请手动调整位置';
-        return '';
-    } catch {
-        return '音频: 自动插入失败，请手动插入';
-    }
-}
-
-/** Polls a selector for visibility; optionally returns `undefined` instead of throwing. */
-async function waitForVisible(
-    page: WechatPage,
-    selector: string,
-    timeoutMs: number,
-    opts: { required?: boolean } = {},
-): Promise<string | undefined> {
-    const visible = await waitUntil(
-        async () => {
-            const found = await trySelectors(page, [selector]).catch(() => ({ found: false, selector: null }));
-            return found.found;
-        },
-        timeoutMs,
-        POLL_MS,
-    );
-    if (visible) return selector;
-    if (opts.required === false) return undefined;
-    throw new Error(`${selector}: not visible within ${timeoutMs}ms`);
-}