@sovovs/bycli 1.8.0

package/clis/weixin/create-draft.js

@@ -0,0 +1,226 @@
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { CommandExecutionError } from '@sovovs/bycli/errors';
+
+const WEIXIN_DOMAIN = 'mp.weixin.qq.com';
+const WEIXIN_HOME = 'https://mp.weixin.qq.com/';
+
+async function getToken(page) {
+    return page.evaluate(`(window.location.href.match(/token=(\\d+)/)||[])[1]`);
+}
+
+async function navigateToEditor(page) {
+    await page.goto(WEIXIN_HOME);
+    await page.wait(3);
+    const token = await getToken(page);
+    if (!token) {
+        throw new CommandExecutionError('Could not extract session token. Please log in to mp.weixin.qq.com');
+    }
+    await page.goto(`https://mp.weixin.qq.com/cgi-bin/appmsg?t=media/appmsg_edit_v2&action=edit&isNew=1&type=77&token=${token}&lang=zh_CN`);
+    await page.wait(4);
+    const hasTitle = await page.evaluate('!!document.querySelector("textarea#title")');
+    if (!hasTitle) {
+        throw new CommandExecutionError('Article editor did not load. Session may have expired');
+    }
+}
+
+async function fillField(page, selector, value) {
+    return page.evaluate(`(() => {
+        var el = document.querySelector('${selector}');
+        if (!el) return { ok: false, reason: 'not found: ${selector}' };
+        el.focus();
+        var proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
+        var setter = Object.getOwnPropertyDescriptor(proto, 'value');
+        if (setter && setter.set) setter.set.call(el, ${JSON.stringify(value)});
+        else el.value = ${JSON.stringify(value)};
+        el.dispatchEvent(new InputEvent('input', { bubbles: true, data: ${JSON.stringify(value)} }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+        el.blur();
+        return { ok: true };
+    })()`);
+}
+
+async function fillContent(page, text) {
+    return page.evaluate(`(() => {
+        var editors = document.querySelectorAll('div[contenteditable="true"]');
+        var editor = editors[editors.length - 1];
+        if (!editor) return { ok: false, reason: 'content editor not found' };
+        editor.focus();
+        if (editor.querySelector('[contenteditable="false"]')) editor.innerHTML = '';
+        document.execCommand('selectAll', false, null);
+        document.execCommand('insertText', false, ${JSON.stringify(text)});
+        editor.dispatchEvent(new InputEvent('input', { bubbles: true }));
+        return { ok: true };
+    })()`);
+}
+
+async function uploadContentImage(page, imagePath) {
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const absPath = path.default.resolve(imagePath);
+    if (!fs.default.existsSync(absPath)) {
+        throw new CommandExecutionError(`Image not found: ${absPath}`);
+    }
+    if (!page.setFileInput) {
+        throw new CommandExecutionError('Image upload requires Browser Bridge with CDP support');
+    }
+
+    await page.evaluate(`(() => {
+        var li = document.querySelector('#js_editor_insertimage');
+        if (li) li.click();
+    })()`);
+    await page.wait(1);
+    await page.evaluate(`(() => {
+        var items = document.querySelectorAll('.js_img_dropdown_menu .tpl_dropdown_menu_item');
+        if (items[0]) items[0].click();
+    })()`);
+    await page.wait(1);
+
+    await page.setFileInput([absPath], 'input[type="file"][name="file"]');
+    await page.wait(8);
+
+    const cdnCount = await page.evaluate(`(() => {
+        var editor = document.querySelector('#ueditor_0');
+        return editor ? editor.querySelectorAll('img[src*="mmbiz"]').length : 0;
+    })()`);
+    if (cdnCount === 0) {
+        throw new CommandExecutionError('Image did not upload to WeChat CDN');
+    }
+}
+
+async function selectCoverFromContent(page) {
+    await page.evaluate('document.querySelector("#js_cover_description_area")?.scrollIntoView()');
+    await page.wait(1);
+
+    await page.evaluate('document.querySelector(".js_cover_btn_area")?.click()');
+    await page.wait(1);
+
+    await page.evaluate(`(() => {
+        var links = document.querySelectorAll('a.pop-opr__button');
+        for (var i = 0; i < links.length; i++) {
+            if (links[i].textContent.trim() === '从正文选择') { links[i].click(); return; }
+        }
+    })()`);
+    await page.wait(2);
+
+    await page.evaluate(`(() => {
+        var img = document.querySelector('.weui-desktop-dialog_img-picker .appmsg_content_img');
+        if (img) img.click();
+    })()`);
+    await page.wait(1);
+
+    await page.evaluate(`(() => {
+        var btns = document.querySelectorAll('.weui-desktop-dialog_img-picker button');
+        for (var i = 0; i < btns.length; i++) {
+            if (btns[i].textContent.trim() === '下一步' && !btns[i].disabled) { btns[i].click(); return; }
+        }
+    })()`);
+
+    // Crop dialog image rendering can be slow
+    for (let attempt = 0; attempt < 8; attempt++) {
+        await page.wait(2);
+        const ready = await page.evaluate(`(() => {
+            var btns = document.querySelectorAll('button');
+            for (var i = 0; i < btns.length; i++) {
+                if (btns[i].textContent.trim() === '确认' && btns[i].offsetHeight > 0 && !btns[i].disabled) return true;
+            }
+            return false;
+        })()`);
+        if (ready) break;
+    }
+
+    await page.evaluate(`(() => {
+        var btns = document.querySelectorAll('button');
+        for (var i = 0; i < btns.length; i++) {
+            if (btns[i].textContent.trim() === '确认' && btns[i].offsetHeight > 0 && !btns[i].disabled) { btns[i].click(); return; }
+        }
+    })()`);
+    await page.wait(2);
+    const hasCover = await page.evaluate(`(() => {
+        var area = document.querySelector('#js_cover_area');
+        if (!area) return false;
+        var found = false;
+        area.querySelectorAll('*').forEach(function(el) {
+            var bg = window.getComputedStyle(el).backgroundImage;
+            if (bg && bg.includes('mmbiz')) found = true;
+        });
+        return found;
+    })()`);
+    return hasCover;
+}
+
+async function clickSaveDraft(page) {
+    const result = await page.evaluate(`(() => {
+        var btns = document.querySelectorAll('span, button, a');
+        for (var i = 0; i < btns.length; i++) {
+            if ((btns[i].textContent || '').trim() === '保存为草稿') { btns[i].click(); return { ok: true }; }
+        }
+        return { ok: false };
+    })()`);
+    if (!result?.ok) throw new CommandExecutionError('Save draft button not found');
+
+    for (let attempt = 0; attempt < 5; attempt++) {
+        await page.wait(2);
+        const saved = await page.evaluate(`(() => {
+            var el = document.querySelector('#js_save_success');
+            if (el && window.getComputedStyle(el).display !== 'none') return true;
+            return document.body.innerText.includes('已保存');
+        })()`);
+        if (saved) return true;
+    }
+    return false;
+}
+
+export const createDraftCommand = cli({
+    site: 'weixin',
+    name: 'create-draft',
+    access: 'write',
+    description: '创建微信公众号图文草稿',
+    domain: WEIXIN_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        { name: 'title', required: true, help: '文章标题 (最长64字)' },
+        { name: 'content', required: true, positional: true, help: '文章正文' },
+        { name: 'author', help: '作者名 (最长8字)' },
+        { name: 'cover-image', help: '封面图片路径 (会先上传到正文再设为封面)' },
+        { name: 'summary', help: '文章摘要' },
+        { name: 'timeout', type: 'int', required: false, default: 180, help: 'Max seconds for the overall command (default: 180)' },
+    ],
+    columns: ['status', 'detail'],
+
+    func: async (page, kwargs) => {
+        await navigateToEditor(page);
+
+        const titleResult = await fillField(page, 'textarea#title', kwargs.title);
+        if (!titleResult?.ok) throw new CommandExecutionError('Failed to fill title');
+
+        if (kwargs.author) {
+            const authorResult = await fillField(page, 'input#author', kwargs.author);
+            if (!authorResult?.ok) throw new CommandExecutionError('Failed to fill author');
+        }
+
+        const contentResult = await fillContent(page, kwargs.content);
+        if (!contentResult?.ok) throw new CommandExecutionError('Failed to fill content');
+
+        if (kwargs['cover-image']) {
+            await uploadContentImage(page, kwargs['cover-image']);
+            const coverSet = await selectCoverFromContent(page);
+            if (!coverSet) {
+                // Non-fatal: draft can be saved without cover
+            }
+        }
+
+        if (kwargs.summary) {
+            await fillField(page, 'textarea#js_description', kwargs.summary);
+        }
+
+        await page.wait(1);
+        const success = await clickSaveDraft(page);
+
+        return [{
+            status: success ? 'draft saved' : 'save attempted, check browser to confirm',
+            detail: `"${kwargs.title}"${kwargs.author ? ` by ${kwargs.author}` : ''}${kwargs['cover-image'] ? ' (with cover)' : ''}`,
+        }];
+    },
+});

package/clis/weixin/download.js

@@ -0,0 +1,323 @@
+/**
+ * WeChat article download — export WeChat Official Account articles to Markdown.
+ *
+ * Ported from jackwener/wechat-article-to-markdown (JS version) to byCLI adapter.
+ *
+ * Usage:
+ *   bycli weixin download --url "https://mp.weixin.qq.com/s/xxx" --output ./weixin
+ */
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { downloadArticle } from '@sovovs/bycli/download/article-download';
+// ============================================================
+// URL Normalization
+// ============================================================
+/**
+ * Normalize a pasted WeChat article URL.
+ */
+export function normalizeWechatUrl(raw) {
+    let s = (raw || '').trim();
+    if (!s)
+        return s;
+    // Strip wrapping quotes / angle brackets
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        s = s.slice(1, -1).trim();
+    }
+    if (s.startsWith('<') && s.endsWith('>')) {
+        s = s.slice(1, -1).trim();
+    }
+    // Remove backslash escapes before URL-significant characters
+    s = s.replace(/\\+([:/&?=#%])/g, '$1');
+    // Decode HTML entities
+    s = s.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"');
+    // Allow bare hostnames
+    if (s.startsWith('mp.weixin.qq.com/') || s.startsWith('//mp.weixin.qq.com/')) {
+        s = 'https://' + s.replace(/^\/+/, '');
+    }
+    // Force https for mp.weixin.qq.com
+    try {
+        const parsed = new URL(s);
+        if (['http:', 'https:'].includes(parsed.protocol) && parsed.hostname.toLowerCase() === 'mp.weixin.qq.com') {
+            parsed.protocol = 'https:';
+            s = parsed.toString();
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return s;
+}
+/**
+ * Format a WeChat article timestamp as a UTC+8 datetime string.
+ * Accepts either Unix seconds or milliseconds.
+ */
+export function formatWechatTimestamp(rawTimestamp) {
+    const ts = Number.parseInt(rawTimestamp, 10);
+    if (!Number.isFinite(ts) || ts <= 0)
+        return '';
+    const timestampMs = rawTimestamp.length === 13 ? ts : ts * 1000;
+    const d = new Date(timestampMs);
+    const pad = (n) => String(n).padStart(2, '0');
+    const utc8 = new Date(d.getTime() + 8 * 3600 * 1000);
+    return (`${utc8.getUTCFullYear()}-` +
+        `${pad(utc8.getUTCMonth() + 1)}-` +
+        `${pad(utc8.getUTCDate())} ` +
+        `${pad(utc8.getUTCHours())}:` +
+        `${pad(utc8.getUTCMinutes())}:` +
+        `${pad(utc8.getUTCSeconds())}`);
+}
+/**
+ * Extract the raw create_time value from supported WeChat inline script formats.
+ */
+export function extractWechatCreateTimeValue(htmlStr) {
+    const jsDecodeMatch = htmlStr.match(/create_time\s*:\s*JsDecode\('([^']+)'\)(?=[\s,;}]|$)/);
+    if (jsDecodeMatch)
+        return jsDecodeMatch[1];
+    const directValueMatch = htmlStr.match(/create_time\s*[:=]\s*(?:"([^"]+)"|'([^']+)'|([0-9A-Za-z]+))(?=[\s,;}]|$)/);
+    if (!directValueMatch)
+        return '';
+    return directValueMatch[1] || directValueMatch[2] || directValueMatch[3] || '';
+}
+/**
+ * Extract the publish time from DOM text first, then fall back to numeric create_time values.
+ */
+export function extractWechatPublishTime(publishTimeText, htmlStr) {
+    const normalizedPublishTime = (publishTimeText || '').trim();
+    if (normalizedPublishTime)
+        return normalizedPublishTime;
+    const rawCreateTime = extractWechatCreateTimeValue(htmlStr);
+    if (!/^\d{10}$|^\d{13}$/.test(rawCreateTime))
+        return '';
+    return formatWechatTimestamp(rawCreateTime);
+}
+/**
+ * Detect WeChat anti-bot / verification gate pages before we try to parse the article.
+ */
+export function detectWechatAccessIssue(pageText, htmlStr) {
+    const normalizedText = (pageText || '').replace(/\s+/g, ' ').trim();
+    if (/环境异常/.test(normalizedText) &&
+        /(完成验证后即可继续访问|去验证)/.test(normalizedText)) {
+        return 'environment verification required';
+    }
+    if (/secitptpage\/verify\.html/.test(htmlStr) || /id=["']js_verify["']/.test(htmlStr)) {
+        return 'environment verification required';
+    }
+    return '';
+}
+export function pickFirstWechatMetaText(...candidates) {
+    for (const candidate of candidates) {
+        const normalized = (candidate || '').replace(/\s+/g, ' ').trim();
+        if (normalized && normalized !== 'Name cleared')
+            return normalized;
+    }
+    return '';
+}
+/**
+ * Build a self-contained helper for execution inside page.evaluate().
+ */
+export function buildExtractWechatPublishTimeJs() {
+    return `(${function extractWechatPublishTimeInPage(publishTimeText, htmlStr) {
+        function formatWechatTimestamp(rawTimestamp) {
+            const ts = Number.parseInt(rawTimestamp, 10);
+            if (!Number.isFinite(ts) || ts <= 0)
+                return '';
+            const timestampMs = rawTimestamp.length === 13 ? ts : ts * 1000;
+            const d = new Date(timestampMs);
+            const pad = (n) => String(n).padStart(2, '0');
+            const utc8 = new Date(d.getTime() + 8 * 3600 * 1000);
+            return (`${utc8.getUTCFullYear()}-` +
+                `${pad(utc8.getUTCMonth() + 1)}-` +
+                `${pad(utc8.getUTCDate())} ` +
+                `${pad(utc8.getUTCHours())}:` +
+                `${pad(utc8.getUTCMinutes())}:` +
+                `${pad(utc8.getUTCSeconds())}`);
+        }
+        function extractWechatCreateTimeValue(html) {
+            const jsDecodeMatch = html.match(/create_time\s*:\s*JsDecode\('([^']+)'\)(?=[\s,;}]|$)/);
+            if (jsDecodeMatch)
+                return jsDecodeMatch[1];
+            const directValueMatch = html.match(/create_time\s*[:=]\s*(?:"([^"]+)"|'([^']+)'|([0-9A-Za-z]+))(?=[\s,;}]|$)/);
+            if (!directValueMatch)
+                return '';
+            return directValueMatch[1] || directValueMatch[2] || directValueMatch[3] || '';
+        }
+        const normalizedPublishTime = (publishTimeText || '').trim();
+        if (normalizedPublishTime)
+            return normalizedPublishTime;
+        const rawCreateTime = extractWechatCreateTimeValue(htmlStr);
+        if (!/^\d{10}$|^\d{13}$/.test(rawCreateTime))
+            return '';
+        return formatWechatTimestamp(rawCreateTime);
+    }.toString()})`;
+}
+/**
+ * Build a self-contained access-issue detector for execution inside page.evaluate().
+ */
+export function buildDetectWechatAccessIssueJs() {
+    return `(${function detectWechatAccessIssueInPage(pageText, htmlStr) {
+        const normalizedText = (pageText || '').replace(/\s+/g, ' ').trim();
+        if (/环境异常/.test(normalizedText) &&
+            /(完成验证后即可继续访问|去验证)/.test(normalizedText)) {
+            return 'environment verification required';
+        }
+        if (/secitptpage\/verify\.html/.test(htmlStr) || /id=["']js_verify["']/.test(htmlStr)) {
+            return 'environment verification required';
+        }
+        return '';
+    }.toString()})`;
+}
+// ============================================================
+// CLI Registration
+// ============================================================
+cli({
+    site: 'weixin',
+    name: 'download',
+    access: 'read',
+    description: '下载微信公众号文章为 Markdown 格式',
+    domain: 'mp.weixin.qq.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'url', required: true, help: 'WeChat article URL (mp.weixin.qq.com/s/xxx)' },
+        { name: 'output', default: './weixin-articles', help: 'Output directory' },
+        { name: 'download-images', type: 'boolean', default: true, help: 'Download images locally' },
+    ],
+    columns: ['title', 'author', 'publish_time', 'status', 'size', 'saved'],
+    func: async (page, kwargs) => {
+        const rawUrl = kwargs.url;
+        const url = normalizeWechatUrl(rawUrl);
+        if (!url.startsWith('https://mp.weixin.qq.com/')) {
+            return [{ title: 'Error', author: '-', publish_time: '-', status: 'invalid URL', size: '-', saved: '-' }];
+        }
+        // Navigate and wait for content to load
+        await page.goto(url);
+        await page.wait(5);
+        // Extract article data in browser context
+        const data = await page.evaluate(`
+      (() => {
+        const result = {
+          title: '',
+          author: '',
+          publishTime: '',
+          errorHint: '',
+          contentHtml: '',
+          codeBlocks: [],
+          imageUrls: []
+        };
+
+        const pickFirstText = (...selectors) => {
+          for (const selector of selectors) {
+            const text = document.querySelector(selector)?.textContent?.replace(/\\s+/g, ' ').trim() || '';
+            if (text && text !== 'Name cleared') return text;
+          }
+          return '';
+        };
+
+        // WeChat has multiple article templates. Newer pages use #js_text_title.
+        result.title = pickFirstText(
+          '#activity-name',
+          '#js_text_title',
+          '.rich_media_title',
+        );
+
+        result.author = pickFirstText(
+          '#js_name',
+          '.wx_follow_nickname',
+          '#profileBt .profile_nickname',
+          '.rich_media_meta.rich_media_meta_nickname',
+          '.rich_media_meta_nickname',
+        );
+
+        // Publish time: prefer the rendered DOM text, then fall back to numeric create_time values.
+        const publishTimeEl = document.querySelector('#publish_time');
+        const extractWechatPublishTime = ${buildExtractWechatPublishTimeJs()};
+        result.publishTime = extractWechatPublishTime(
+          publishTimeEl ? publishTimeEl.textContent : '',
+          document.documentElement.innerHTML,
+        );
+
+        const detectWechatAccessIssue = ${buildDetectWechatAccessIssueJs()};
+        result.errorHint = detectWechatAccessIssue(
+          document.body ? document.body.innerText : '',
+          document.documentElement.innerHTML,
+        );
+        if (result.errorHint) return result;
+
+        // Content processing
+        const contentEl = document.querySelector('#js_content');
+        if (!contentEl) return result;
+
+        // Fix lazy-loaded images: data-src -> src
+        contentEl.querySelectorAll('img').forEach(img => {
+          const dataSrc = img.getAttribute('data-src');
+          if (dataSrc) img.setAttribute('src', dataSrc);
+        });
+
+        // Extract code blocks with placeholder replacement
+        const codeBlocks = [];
+        contentEl.querySelectorAll('.code-snippet__fix').forEach(el => {
+          el.querySelectorAll('.code-snippet__line-index').forEach(li => li.remove());
+          const pre = el.querySelector('pre[data-lang]');
+          const lang = pre ? (pre.getAttribute('data-lang') || '') : '';
+          const lines = [];
+          el.querySelectorAll('code').forEach(codeTag => {
+            const text = codeTag.textContent;
+            if (/^[ce]?ounter\\(line/.test(text)) return;
+            lines.push(text);
+          });
+          if (lines.length === 0) lines.push(el.textContent);
+          const placeholder = 'CODEBLOCK-PLACEHOLDER-' + codeBlocks.length;
+          codeBlocks.push({ lang, code: lines.join('\\n') });
+          const p = document.createElement('p');
+          p.textContent = placeholder;
+          el.replaceWith(p);
+        });
+        result.codeBlocks = codeBlocks;
+
+        // Remove noise elements
+        ['script', 'style', '.qr_code_pc', '.reward_area'].forEach(sel => {
+          contentEl.querySelectorAll(sel).forEach(tag => tag.remove());
+        });
+
+        // Collect image URLs (deduplicated)
+        const seen = new Set();
+        contentEl.querySelectorAll('img[src]').forEach(img => {
+          const src = img.getAttribute('src');
+          if (src && !seen.has(src)) {
+            seen.add(src);
+            result.imageUrls.push(src);
+          }
+        });
+
+        result.contentHtml = contentEl.innerHTML;
+        return result;
+      })()
+    `);
+        if (data?.errorHint === 'environment verification required') {
+            return [{
+                    title: 'Error',
+                    author: '-',
+                    publish_time: '-',
+                    status: 'failed — verification required in WeChat browser page',
+                    size: '-',
+                    saved: '-',
+                }];
+        }
+        return downloadArticle({
+            title: data?.title || '',
+            author: data?.author,
+            publishTime: data?.publishTime,
+            sourceUrl: url,
+            contentHtml: data?.contentHtml || '',
+            codeBlocks: data?.codeBlocks,
+            imageUrls: data?.imageUrls,
+        }, {
+            output: kwargs.output,
+            downloadImages: kwargs['download-images'],
+            imageHeaders: { Referer: 'https://mp.weixin.qq.com/' },
+            frontmatterLabels: { author: '公众号' },
+            detectImageExt: (url) => {
+                const m = url.match(/wx_fmt=(\w+)/) || url.match(/\.(\w{3,4})(?:\?|$)/);
+                return m ? m[1] : 'png';
+            },
+        });
+    },
+});

package/clis/weixin/drafts.js

@@ -0,0 +1,66 @@
+import { AuthRequiredError, EmptyResultError } from '@sovovs/bycli/errors';
+import { cli, Strategy } from '@sovovs/bycli/registry';
+
+const WEIXIN_DOMAIN = 'mp.weixin.qq.com';
+
+export const draftsCommand = cli({
+    site: 'weixin',
+    name: 'drafts',
+    access: 'read',
+    description: '列出微信公众号草稿箱',
+    domain: WEIXIN_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        { name: 'limit', type: 'int', default: 10, help: '最多显示条数' },
+        { name: 'timeout', type: 'int', required: false, default: 60, help: 'Max seconds for the overall command (default: 60)' },
+    ],
+    columns: ['Index', 'Title', 'Time'],
+
+    func: async (page, kwargs) => {
+        await page.goto('https://mp.weixin.qq.com/');
+        await page.wait(3);
+        const token = await page.evaluate(`(window.location.href.match(/token=(\\d+)/)||[])[1]`);
+        if (!token) {
+            throw new AuthRequiredError(WEIXIN_DOMAIN, '微信公众号草稿箱需要已登录的 mp.weixin.qq.com 会话');
+        }
+
+        await page.goto(`https://mp.weixin.qq.com/cgi-bin/appmsg?begin=0&count=${kwargs.limit}&type=77&action=list_card&token=${token}&lang=zh_CN`);
+        await page.wait(4);
+
+        const drafts = await page.evaluate(`(() => {
+            var results = [];
+            var idx = 0;
+
+            var cards = document.querySelectorAll('.weui-desktop-card');
+            for (var i = 0; i < cards.length; i++) {
+                if (cards[i].className.includes('card_new')) continue;
+                var titleEl = cards[i].querySelector('[class*=title]');
+                var timeEl = cards[i].querySelector('[class*=tips]');
+                var title = titleEl ? titleEl.textContent.trim() : '';
+                var time = timeEl ? timeEl.textContent.trim().replace(/\\s+/g, ' ') : '';
+                if (title) results.push({ Index: ++idx, Title: title, Time: time });
+            }
+            if (results.length > 0) return results;
+
+            var rows = document.querySelectorAll('tr, [class*=appmsg_item], [class*=list_item]');
+            rows.forEach(function(row) {
+                var titleEl = row.querySelector('[class*=title] a, [class*=title], h4');
+                var timeEl = row.querySelector('[class*=time], td:nth-child(2)');
+                var title = titleEl ? titleEl.textContent.trim() : '';
+                var time = timeEl ? timeEl.textContent.trim() : '';
+                if (title && title !== '内容' && title.length < 80) {
+                    results.push({ Index: ++idx, Title: title, Time: time });
+                }
+            });
+            return results;
+        })()`);
+
+        if (!drafts || drafts.length === 0) {
+            throw new EmptyResultError('weixin drafts', 'No structured drafts found in the current Weixin Official Account backend');
+        }
+
+        return drafts.slice(0, kwargs.limit);
+    },
+});

package/clis/weixin/drafts.test.js

@@ -0,0 +1,69 @@
+import { describe, expect, it, vi } from 'vitest';
+import { AuthRequiredError, EmptyResultError } from '@sovovs/bycli/errors';
+import { getRegistry } from '@sovovs/bycli/registry';
+import './create-draft.js';
+import './drafts.js';
+import './search.js';
+
+function createPageMock(overrides = {}) {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        wait: vi.fn().mockResolvedValue(undefined),
+        evaluate: overrides.evaluate ?? vi.fn().mockResolvedValue(undefined),
+        setFileInput: vi.fn().mockResolvedValue(undefined),
+    };
+}
+
+describe('weixin command registration', () => {
+    it('registers create-draft and drafts commands', () => {
+        const registry = getRegistry();
+        const values = [...registry.values()];
+        expect(values.find(c => c.site === 'weixin' && c.name === 'create-draft')).toBeDefined();
+        const draftsCommand = values.find(c => c.site === 'weixin' && c.name === 'drafts');
+        expect(draftsCommand).toBeDefined();
+        expect(draftsCommand.args.find((arg) => arg.name === 'timeout')).toMatchObject({ type: 'int', default: 60 });
+        expect(values.find(c => c.site === 'weixin' && c.name === 'search')).toBeDefined();
+    });
+});
+
+describe('weixin drafts command', () => {
+    it('throws AuthRequiredError when no session token is available', async () => {
+        const command = getRegistry().get('weixin/drafts');
+        const page = createPageMock({
+            evaluate: vi.fn().mockResolvedValueOnce(undefined),
+        });
+
+        await expect(command.func(page, { limit: 10 })).rejects.toBeInstanceOf(AuthRequiredError);
+    });
+
+    it('fails instead of scraping arbitrary body text when structured selectors miss', async () => {
+        const command = getRegistry().get('weixin/drafts');
+        const evaluate = vi.fn()
+            .mockResolvedValueOnce('123456')
+            .mockImplementationOnce(async (script) => {
+                expect(script).not.toContain('document.body.innerText');
+                return [];
+            });
+        const page = createPageMock({ evaluate });
+
+        await expect(command.func(page, { limit: 10 })).rejects.toBeInstanceOf(EmptyResultError);
+    });
+
+    it('returns structured drafts and respects the requested limit', async () => {
+        const command = getRegistry().get('weixin/drafts');
+        const page = createPageMock({
+            evaluate: vi.fn()
+                .mockResolvedValueOnce('123456')
+                .mockResolvedValueOnce([
+                    { Index: 1, Title: '第一篇草稿', Time: '2026-04-24 10:00' },
+                    { Index: 2, Title: '第二篇草稿', Time: '2026-04-24 11:00' },
+                ]),
+        });
+
+        const result = await command.func(page, { limit: 1 });
+
+        expect(result).toEqual([
+            { Index: 1, Title: '第一篇草稿', Time: '2026-04-24 10:00' },
+        ]);
+    });
+});