publishport-opencli 1.8.4-pp.1

package/clis/xianyu/im.js

@@ -0,0 +1,322 @@
+import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
+
+export const DEFAULT_INBOX_LIMIT = 20;
+export const MAX_INBOX_LIMIT = 100;
+export const DEFAULT_MESSAGE_LIMIT = 50;
+export const MAX_MESSAGE_LIMIT = 200;
+
+export function normalizeLimit(value, defaultValue = DEFAULT_INBOX_LIMIT, maxValue = MAX_INBOX_LIMIT, label = 'limit') {
+    const raw = String(value ?? '').trim();
+    if (!raw) return defaultValue;
+    if (!/^\d+$/.test(raw)) {
+        throw new ArgumentError(`xianyu ${label} must be an integer between 1 and ${maxValue}`);
+    }
+    const n = Number(raw);
+    if (!Number.isSafeInteger(n) || n < 1 || n > maxValue) {
+        throw new ArgumentError(`xianyu ${label} must be an integer between 1 and ${maxValue}`);
+    }
+    return n;
+}
+
+export function normalizeRank(value) {
+    const raw = String(value ?? '').trim();
+    if (!raw) return 0;
+    if (!/^\d+$/.test(raw)) {
+        throw new ArgumentError('xianyu rank must be a positive integer from xianyu inbox');
+    }
+    const n = Number(raw);
+    if (!Number.isSafeInteger(n) || n < 1) {
+        throw new ArgumentError('xianyu rank must be a positive integer from xianyu inbox');
+    }
+    return n;
+}
+
+export function requireText(value, label) {
+    const text = String(value ?? '').replace(/\s+/g, ' ').trim();
+    if (!text) {
+        throw new ArgumentError(`${label} cannot be empty`);
+    }
+    return text;
+}
+
+export function requireEvaluateObject(payload, label) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+        throw new CommandExecutionError(`Xianyu ${label} returned malformed browser payload`);
+    }
+    return payload;
+}
+
+export function requireClickResult(payload, label) {
+    const result = requireEvaluateObject(payload, label);
+    if (result.ok !== true) {
+        throw new CommandExecutionError(`Xianyu ${label} failed: ${result.reason || 'unknown-reason'}`);
+    }
+    return result;
+}
+
+export function buildChatUrl(itemId, peerUserId) {
+    return `https://www.goofish.com/im?itemId=${encodeURIComponent(itemId)}&peerUserId=${encodeURIComponent(peerUserId)}`;
+}
+
+export function buildInboxUrl() {
+    return 'https://www.goofish.com/im';
+}
+
+export function buildClickInboxConversationEvaluate(index) {
+    return `
+    (() => {
+      const rows = Array.from(document.querySelectorAll('#conv-list-scrollable [class*="conversation-item"], a[href*="/im"], a[href*="itemId="][href*="peerUserId="]'));
+      const row = rows[${index}];
+      if (!row) return { ok: false, reason: 'row-not-found' };
+      row.dispatchEvent(new MouseEvent('mouseover', { bubbles: true, cancelable: true, view: window }));
+      row.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true, view: window }));
+      row.click();
+      row.dispatchEvent(new MouseEvent('mouseup', { bubbles: true, cancelable: true, view: window }));
+      return { ok: true };
+    })()
+  `;
+}
+
+export function buildReadCurrentConversationUrlEvaluate() {
+    return `
+    (() => {
+      const url = location.href || '';
+      const params = new URL(url).searchParams;
+      return {
+        url,
+        item_id: params.get('itemId') || '',
+        peer_user_id: params.get('peerUserId') || '',
+      };
+    })()
+  `;
+}
+
+export function buildExtractInboxEvaluate(limit) {
+    return `
+    (() => {
+      const clean = (value) => String(value ?? '').replace(/\\s+/g, ' ').trim();
+      const bodyText = document.body?.innerText || '';
+      const requiresAuth = /请先登录|登录后|璇峰厛鐧诲綍|鐧诲綍鍚?/.test(bodyText);
+      const blocked = /验证码|安全验证|异常访问|楠岃瘉鐮亅瀹夊叏楠岃瘉|寮傚父璁块棶/.test(bodyText);
+
+      const absoluteUrl = (url) => {
+        try {
+          return new URL(url, location.href).href;
+        } catch {
+          return '';
+        }
+      };
+
+      const readId = (url, key) => {
+        try {
+          return new URL(url, location.href).searchParams.get(key) || '';
+        } catch {
+          const match = String(url || '').match(new RegExp('[?&]' + key + '=(\\\\d+)'));
+          return match ? match[1] : '';
+        }
+      };
+
+      const pick = (root, selectors) => {
+        for (const selector of selectors) {
+          const node = root.querySelector(selector);
+          const text = clean(node?.getAttribute?.('title') || node?.textContent || '');
+          if (text) return text;
+        }
+        return '';
+      };
+
+      const leafTexts = (root) => Array.from(root.querySelectorAll('div, span'))
+        .filter((node) => !Array.from(node.children || []).some((child) => ['DIV', 'SPAN'].includes(child.tagName)))
+        .map((node) => clean(node.textContent || ''))
+        .filter(Boolean);
+
+      const looksLikeTime = (text) => /^(刚刚|\\d+分钟前|\\d+小时前|\\d+天前|昨天|前天|\\d{1,2}:\\d{2}|\\d{4}-\\d{1,2}-\\d{1,2})$/.test(text);
+
+      const links = Array.from(document.querySelectorAll('a[href*="/im"], a[href*="itemId="][href*="peerUserId="]'));
+      const seen = new Set();
+      const items = [];
+      for (const link of links) {
+        const href = link.href || link.getAttribute('href') || '';
+        const itemId = readId(href, 'itemId');
+        const peerUserId = readId(href, 'peerUserId');
+        if (!itemId || !peerUserId) continue;
+        const key = itemId + ':' + peerUserId;
+        if (seen.has(key)) continue;
+        seen.add(key);
+
+        const root = link.closest('[class*="conversation"], [class*="session"], [class*="contact"], [class*="chat"], li, [role="listitem"]') || link;
+        const peerName = pick(root, ['[class*="name"]', '[class*="nick"]', '[class*="user"]', '[class*="text1"]']);
+        const itemTitle = pick(root, ['[class*="title"]', '[class*="item"] [class*="desc"]', '[class*="desc"]']);
+        const price = pick(root, ['[class*="money"]', '[class*="price"]']);
+        const lastMessage = pick(root, ['[class*="message"]', '[class*="msg"]', '[class*="content"]', '[class*="summary"]']);
+        const rootText = clean(root.textContent || '');
+        const unreadText = pick(root, ['[class*="badge"]', '[class*="unread"]', '[class*="red"]']);
+        const unreadCount = Number.parseInt(unreadText.replace(/\\D/g, ''), 10) || (unreadText ? 1 : 0);
+
+        items.push({
+          row_index: items.length,
+          peer_name: peerName,
+          peer_user_id: peerUserId,
+          item_id: itemId,
+          item_title: itemTitle,
+          price,
+          last_message: lastMessage || rootText,
+          unread: unreadCount > 0 || /unread|未读/.test(String(root.className || '') + ' ' + rootText),
+          unread_count: unreadCount,
+          url: absoluteUrl(href),
+        });
+        if (items.length >= ${limit}) break;
+      }
+
+      if (!items.length) {
+        const rows = Array.from(document.querySelectorAll('#conv-list-scrollable [class*="conversation-item"]')).slice(0, ${limit});
+        for (const row of rows) {
+          const texts = leafTexts(row)
+            .filter((text) => !/^\\d+$/.test(text) || row.querySelector('sup[title="' + text.replace(/"/g, '\\"') + '"]') == null);
+          const time = [...texts].reverse().find(looksLikeTime) || '';
+          const unreadTitle = clean(row.querySelector('sup')?.getAttribute('title') || row.querySelector('[class*="badge"], [class*="unread"]')?.textContent || '');
+          const unreadCount = Number.parseInt(unreadTitle.replace(/\\D/g, ''), 10) || (unreadTitle ? 1 : 0);
+          const peerName = texts.find((text) => text !== time && text !== unreadTitle && !/^\\[.*\\]$/.test(text)) || '';
+          const lastMessage = texts.find((text) => text !== peerName && text !== time && text !== unreadTitle) || '';
+          if (!peerName && !lastMessage) continue;
+          items.push({
+            row_index: items.length,
+            peer_name: peerName,
+            peer_user_id: '',
+            item_id: '',
+            item_title: '',
+            price: '',
+            last_message: lastMessage,
+            unread: unreadCount > 0,
+            unread_count: unreadCount,
+            url: '',
+            time,
+          });
+          if (items.length >= ${limit}) break;
+        }
+      }
+
+      return { requiresAuth, blocked, empty: !items.length, items };
+    })()
+  `;
+}
+
+export function buildExtractChatStateEvaluate(limit = DEFAULT_MESSAGE_LIMIT) {
+    return `
+    (() => {
+      const clean = (value) => String(value ?? '').replace(/\\s+/g, ' ').trim();
+      const bodyText = document.body?.innerText || '';
+      const requiresAuth = /请先登录|登录后|璇峰厛鐧诲綍|鐧诲綍鍚?/.test(bodyText);
+
+      const textarea = document.querySelector('textarea');
+      const normalizeBtn = (s) => String(s || '').replace(/\\s+/g, '').trim();
+      const sendButton = Array.from(document.querySelectorAll('button'))
+        .find((btn) => /^(发送|鍙戦€?)$/.test(normalizeBtn(btn.textContent || '')));
+      const topbar = document.querySelector('[class*="message-topbar"]');
+      const itemCard = Array.from(document.querySelectorAll('a[href*="/item?id="]'))
+        .find((el) => el.closest('main')) || document.querySelector('a[href*="/item?id="]');
+      const itemTitleNode =
+        document.querySelector('[class*="container"] [class*="title"]')
+        || document.querySelector('[class*="item-main-info"] [class*="desc"]')
+        || document.querySelector('[class*="headSkuInfo"]')
+        || itemCard?.querySelector('[class*="title"]')
+        || itemCard?.previousElementSibling?.querySelector?.('[class*="title"]');
+
+      const messageRoot = document.querySelector('#message-list-scrollable') || document.querySelector('[class*="message-list"]');
+      let visibleMessages = Array.from((messageRoot || document).querySelectorAll('[class*="message-row"]'))
+        .map((row) => {
+          const textNode = row.querySelector('[class*="message-text"]');
+          return clean(textNode?.textContent || '');
+        })
+        .filter(Boolean);
+
+      if (!visibleMessages.length) {
+        visibleMessages = Array.from(
+          (messageRoot || document).querySelectorAll('[class*="message"], [class*="msg"], [class*="bubble"]')
+        ).map((el) => clean(el.textContent || ''));
+      }
+
+      visibleMessages = visibleMessages
+        .filter(Boolean)
+        .filter((text) => !['发送', '闲鱼号', '立即购买', '鍙戦€?', '闂查奔鍙?', '绔嬪嵆璐拱'].includes(text))
+        .filter((text) => !/^消息\\d*\\+?$/.test(text) && !/^娑堟伅\\d*\\+?$/.test(text))
+        .slice(-${limit});
+
+      return {
+        requiresAuth,
+        title: clean(document.title || ''),
+        peer_name: clean(topbar?.querySelector('[class*="text1"]')?.textContent || ''),
+        peer_masked_id: clean(topbar?.querySelector('[class*="text2"]')?.textContent || '').replace(/^\\(|\\)$/g, ''),
+        item_title: clean(itemTitleNode?.textContent || ''),
+        item_url: itemCard?.href || '',
+        price: clean(itemCard?.querySelector('[class*="money"], [class*="price"]')?.textContent || ''),
+        location: clean(itemCard?.querySelector('[class*="delivery"] + [class*="delivery"], [class*="delivery"]:last-child')?.textContent || ''),
+        can_input: Boolean(textarea && !textarea.disabled),
+        can_send: Boolean(sendButton),
+        visible_messages: visibleMessages,
+        messages: visibleMessages.map((text, index) => ({ index: index + 1, text })),
+      };
+    })()
+  `;
+}
+
+export function buildSendMessageEvaluate(text) {
+    return `
+    (async () => {
+      const clean = (value) => String(value ?? '').replace(/\\s+/g, ' ').trim();
+      const readMessages = () => {
+        const messageRoot = document.querySelector('#message-list-scrollable') || document.querySelector('[class*="message-list"]');
+        let messages = Array.from((messageRoot || document).querySelectorAll('[class*="message-row"]'))
+          .map((row) => clean(row.querySelector('[class*="message-text"]')?.textContent || ''))
+          .filter(Boolean);
+        if (!messages.length) {
+          messages = Array.from(
+            (messageRoot || document).querySelectorAll('[class*="message"], [class*="msg"], [class*="bubble"]')
+          ).map((el) => clean(el.textContent || '')).filter(Boolean);
+        }
+        return messages
+          .filter((item) => !['发送', '闲鱼号', '立即购买', '鍙戦€?', '闂查奔鍙?', '绔嬪嵆璐拱'].includes(item))
+          .filter((item) => !/^消息\\d*\\+?$/.test(item) && !/^娑堟伅\\d*\\+?$/.test(item));
+      };
+
+      const textarea = document.querySelector('textarea');
+      if (!textarea || textarea.disabled) {
+        return { ok: false, reason: 'input-not-found' };
+      }
+
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value')?.set;
+      if (!setter) {
+        return { ok: false, reason: 'textarea-setter-not-found' };
+      }
+
+      const beforeMessages = readMessages();
+      textarea.click();
+      textarea.focus();
+      setter.call(textarea, ${JSON.stringify(text)});
+      textarea.dispatchEvent(new Event('input', { bubbles: true }));
+      textarea.dispatchEvent(new Event('change', { bubbles: true }));
+
+      const normalizeBtn = (s) => String(s || '').replace(/\\s+/g, '').trim();
+      let sendButton = null;
+      for (let i = 0; i < 30; i++) {
+        sendButton = Array.from(document.querySelectorAll('button'))
+          .find((btn) => /^(发送|鍙戦€?)$/.test(normalizeBtn(btn.textContent || '')));
+        if (sendButton) break;
+        await new Promise(r => setTimeout(r, 100));
+      }
+      if (!sendButton) {
+        return { ok: false, reason: 'send-button-not-found' };
+      }
+
+      sendButton.click();
+      for (let i = 0; i < 30; i++) {
+        await new Promise(r => setTimeout(r, 100));
+        const afterMessages = readMessages();
+        if (afterMessages.length > beforeMessages.length && afterMessages.at(-1) === ${JSON.stringify(text)}) {
+          return { ok: true };
+        }
+      }
+      return { ok: false, reason: 'send-postcondition-timeout' };
+    })()
+  `;
+}

package/clis/xianyu/im.test.js

@@ -0,0 +1,253 @@
+import { JSDOM } from 'jsdom';
+import { describe, expect, it } from 'vitest';
+import {
+    buildChatUrl,
+    buildExtractChatStateEvaluate,
+    buildExtractInboxEvaluate,
+    buildSendMessageEvaluate,
+    normalizeLimit,
+    normalizeRank,
+} from './im.js';
+import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
+import './messages.js';
+import './reply.js';
+import { getRegistry } from '@jackwener/opencli/registry';
+
+async function runBrowserScript(html, script, { url = 'https://www.goofish.com/im', beforeEval } = {}) {
+    const dom = new JSDOM(html, { url, runScripts: 'outside-only' });
+    beforeEval?.(dom.window);
+    return dom.window.eval(script);
+}
+
+describe('xianyu im shared helpers', () => {
+    it('strictly validates limits and ranks before browser side effects', () => {
+        expect(normalizeLimit(undefined, 20, 100)).toBe(20);
+        expect(normalizeLimit('', 20, 100)).toBe(20);
+        expect(normalizeLimit('100', 20, 100)).toBe(100);
+        expect(() => normalizeLimit(0, 20, 100)).toThrow(ArgumentError);
+        expect(() => normalizeLimit(3.8, 20, 100)).toThrow(ArgumentError);
+        expect(() => normalizeLimit(999, 20, 100)).toThrow(ArgumentError);
+        expect(normalizeRank(undefined)).toBe(0);
+        expect(normalizeRank(1)).toBe(1);
+        expect(() => normalizeRank(0)).toThrow(ArgumentError);
+        expect(() => normalizeRank('1.5')).toThrow(ArgumentError);
+    });
+
+    it('extracts recent inbox conversations from visible IM rows', async () => {
+        const result = await runBrowserScript(`
+            <main>
+              <a href="/im?itemId=10001&peerUserId=90001" class="conversation unread">
+                <div class="name">张三</div>
+                <div class="title">MacBook Pro 14</div>
+                <div class="money">¥5999</div>
+                <div class="message">还在吗？</div>
+                <span class="badge">2</span>
+              </a>
+              <a href="https://www.goofish.com/im?itemId=10002&peerUserId=90002" class="conversation">
+                <div class="name">李四</div>
+                <div class="title">iPhone 15</div>
+                <div class="message">明天能发货</div>
+              </a>
+            </main>
+        `, buildExtractInboxEvaluate(10));
+
+        expect(result.requiresAuth).toBe(false);
+        expect(result.items).toEqual([
+            {
+                peer_name: '张三',
+                peer_user_id: '90001',
+                item_id: '10001',
+                item_title: 'MacBook Pro 14',
+                price: '¥5999',
+                last_message: '还在吗？',
+                unread: true,
+                unread_count: 2,
+                url: 'https://www.goofish.com/im?itemId=10001&peerUserId=90001',
+                row_index: 0,
+            },
+            {
+                peer_name: '李四',
+                peer_user_id: '90002',
+                item_id: '10002',
+                item_title: 'iPhone 15',
+                price: '',
+                last_message: '明天能发货',
+                unread: false,
+                unread_count: 0,
+                url: 'https://www.goofish.com/im?itemId=10002&peerUserId=90002',
+                row_index: 1,
+            },
+        ]);
+    });
+
+    it('extracts inbox conversations from the real virtualized conversation row shape', async () => {
+        const result = await runBrowserScript(`
+            <main>
+              <div id="conv-list-scrollable">
+                <div class="rc-virtual-list">
+                  <div class="rc-virtual-list-holder">
+                    <div class="rc-virtual-list-holder-inner">
+                      <div class="conversation-item--abc">
+                        <div>
+                          <div><span><sup title="3"><span>3</span></sup></span></div>
+                          <div>
+                            <div><div>通知消息</div></div>
+                            <div>订单即将自动确认收货</div>
+                            <div>3小时前</div>
+                          </div>
+                        </div>
+                      </div>
+                      <div class="conversation-item--abc">
+                        <div>
+                          <div>
+                            <div><div>隔壁猫小小</div></div>
+                            <div>亲，喜欢可以拍下，有问题留言哦～会尽快回复</div>
+                            <div>21小时前</div>
+                          </div>
+                        </div>
+                      </div>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </main>
+        `, buildExtractInboxEvaluate(10));
+
+        expect(result.items).toEqual([
+            expect.objectContaining({
+                peer_name: '通知消息',
+                last_message: '订单即将自动确认收货',
+                unread: true,
+                unread_count: 3,
+            }),
+            expect.objectContaining({
+                peer_name: '隔壁猫小小',
+                last_message: '亲，喜欢可以拍下，有问题留言哦～会尽快回复',
+                unread: false,
+            }),
+        ]);
+    });
+
+    it('extracts all visible messages for a specific chat', async () => {
+        const state = await runBrowserScript(`
+            <main>
+              <textarea></textarea>
+              <button>发送</button>
+              <div class="message-topbar"><span class="text1">张三</span><span class="text2">(90001)</span></div>
+              <a href="/item?id=10001"><span class="title">MacBook Pro 14</span><span class="money">¥5999</span></a>
+              <div id="message-list-scrollable">
+                <div class="bubble">你好</div>
+                <div class="message">还在吗？</div>
+                <div class="msg">在的</div>
+              </div>
+            </main>
+        `, buildExtractChatStateEvaluate());
+
+        expect(state.peer_name).toBe('张三');
+        expect(state.peer_masked_id).toBe('90001');
+        expect(state.item_title).toBe('MacBook Pro 14');
+        expect(state.messages).toEqual([
+            { index: 1, text: '你好' },
+            { index: 2, text: '还在吗？' },
+            { index: 3, text: '在的' },
+        ]);
+        expect(state.visible_messages).toEqual(['你好', '还在吗？', '在的']);
+    });
+
+    it('extracts messages from the real Xianyu message-row shape', async () => {
+        const state = await runBrowserScript(`
+            <main>
+              <textarea></textarea>
+              <button>发 送</button>
+              <div id="message-list-scrollable">
+                <div class="message-list-reverse--x">
+                  <div class="message-row--a">
+                    <div class="ant-dropdown-trigger message-content--b">
+                      <div class="message-text--c message-text-right--d"><span>我发出的消息</span></div>
+                      <div class="read-status-text--e">已读</div>
+                    </div>
+                  </div>
+                  <div class="message-row--a">
+                    <div class="ant-dropdown-trigger message-content--b">
+                      <div class="message-text--c message-text-left--d"><span>对方回复</span></div>
+                    </div>
+                  </div>
+                </div>
+              </div>
+            </main>
+        `, buildExtractChatStateEvaluate());
+
+        expect(state.can_send).toBe(true);
+        expect(state.messages).toEqual([
+            { index: 1, text: '我发出的消息' },
+            { index: 2, text: '对方回复' },
+        ]);
+    });
+
+
+    it('registers reply as an explicit write command', () => {
+        const command = getRegistry().get('xianyu/reply');
+        expect(command?.access).toBe('write');
+        expect(command?.columns).toEqual(['status', 'peer_name', 'item_title', 'price', 'location', 'message']);
+    });
+
+    it('builds chat URLs and requires post-submit message evidence', async () => {
+        expect(buildChatUrl('10001', '90001')).toBe('https://www.goofish.com/im?itemId=10001&peerUserId=90001');
+
+        let clicked = false;
+        const result = await runBrowserScript(`
+            <textarea></textarea>
+            <button>发送</button>
+            <div id="message-list-scrollable"></div>
+        `, buildSendMessageEvaluate('你好'), {
+            beforeEval(window) {
+                window.document.querySelector('button').addEventListener('click', () => {
+                    clicked = true;
+                    const row = window.document.createElement('div');
+                    row.className = 'message-row';
+                    row.innerHTML = '<div class="message-text">你好</div>';
+                    window.document.querySelector('#message-list-scrollable').append(row);
+                });
+            },
+        });
+
+        expect(result).toEqual({ ok: true });
+        expect(clicked).toBe(true);
+
+        await expect(runBrowserScript('<textarea></textarea><button>发送</button>', buildSendMessageEvaluate('没证据'), {
+            beforeEval(window) {
+                window.setTimeout = (fn) => {
+                    fn();
+                    return 0;
+                };
+            },
+        }))
+            .resolves.toEqual({ ok: false, reason: 'send-postcondition-timeout' });
+    });
+
+    it('requires an explicit conversation target for messages and reply', async () => {
+        const messages = getRegistry().get('xianyu/messages');
+        const reply = getRegistry().get('xianyu/reply');
+        const page = {
+            goto: () => { throw new Error('should not navigate'); },
+            wait: () => {},
+            evaluate: () => ({}),
+        };
+
+        await expect(messages.func(page, { limit: 1 })).rejects.toBeInstanceOf(ArgumentError);
+        await expect(reply.func(page, { text: 'hello' })).rejects.toBeInstanceOf(ArgumentError);
+        await expect(messages.func(page, { item_id: '10001', user_id: '90001', rank: 1 })).rejects.toBeInstanceOf(ArgumentError);
+    });
+
+    it('treats malformed evaluate payloads as command failures', async () => {
+        const messages = getRegistry().get('xianyu/messages');
+        const page = {
+            goto: () => {},
+            wait: () => {},
+            evaluate: () => null,
+        };
+
+        await expect(messages.func(page, { item_id: '10001', user_id: '90001', limit: 1 }))
+            .rejects.toBeInstanceOf(CommandExecutionError);
+    });
+});

package/clis/xianyu/inbox.js

@@ -0,0 +1,96 @@
+import { AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import {
+    buildClickInboxConversationEvaluate,
+    buildExtractInboxEvaluate,
+    buildInboxUrl,
+    buildReadCurrentConversationUrlEvaluate,
+    DEFAULT_INBOX_LIMIT,
+    MAX_INBOX_LIMIT,
+    normalizeLimit,
+    requireClickResult,
+    requireEvaluateObject,
+} from './im.js';
+
+cli({
+    site: 'xianyu',
+    name: 'inbox',
+    access: 'read',
+    description: '列出闲鱼最近私信会话',
+    domain: 'www.goofish.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: DEFAULT_INBOX_LIMIT, help: 'Number of conversations to return' },
+        { name: 'unread-only', type: 'bool', default: false, help: 'Return only conversations with unread messages' },
+        { name: 'resolve-ids', type: 'bool', default: false, help: 'Click each visible conversation to resolve item_id and peer_user_id from the chat URL' },
+    ],
+    columns: ['rank', 'peer_name', 'peer_user_id', 'item_id', 'item_title', 'price', 'last_message', 'unread', 'unread_count', 'url'],
+    func: async (page, kwargs) => {
+        const limit = normalizeLimit(kwargs.limit, DEFAULT_INBOX_LIMIT, MAX_INBOX_LIMIT, 'inbox --limit');
+        const unreadOnly = Boolean(kwargs['unread-only']);
+        const resolveIds = Boolean(kwargs['resolve-ids']);
+        let currentUrl = '';
+        if (page.getCurrentUrl) {
+            try {
+                currentUrl = await page.getCurrentUrl();
+            } catch {
+                currentUrl = '';
+            }
+        }
+        if (!/https:\/\/www\.goofish\.com\/im\b/.test(currentUrl)) {
+            await page.goto(buildInboxUrl());
+        }
+        await page.wait(4);
+        const payload = requireEvaluateObject(await page.evaluate(buildExtractInboxEvaluate(limit)), 'inbox');
+        if (payload?.requiresAuth) {
+            throw new AuthRequiredError('www.goofish.com', 'Xianyu inbox requires a logged-in browser session');
+        }
+        if (payload?.blocked) {
+            throw new AuthRequiredError('www.goofish.com', 'Xianyu inbox is blocked by verification or risk control');
+        }
+        if (!Array.isArray(payload.items)) {
+            throw new CommandExecutionError('Xianyu inbox returned malformed conversation list');
+        }
+        const items = payload.items;
+        if (!items.length) {
+            throw new EmptyResultError('xianyu inbox', 'No Xianyu inbox conversations were found');
+        }
+        let conversations = items.slice(0, limit);
+        if (unreadOnly) {
+            conversations = conversations.filter((item) => Boolean(item.unread));
+        }
+        if (resolveIds) {
+            for (const item of conversations) {
+                if (item.item_id && item.peer_user_id) continue;
+                const rowIndex = Number(item.row_index);
+                if (!Number.isInteger(rowIndex) || rowIndex < 0) continue;
+                requireClickResult(await page.evaluate(buildClickInboxConversationEvaluate(rowIndex)), 'inbox resolve-ids click');
+                await page.wait(1);
+                const current = requireEvaluateObject(await page.evaluate(buildReadCurrentConversationUrlEvaluate()), 'inbox current-url');
+                item.item_id = current?.item_id || item.item_id || '';
+                item.peer_user_id = current?.peer_user_id || item.peer_user_id || '';
+                item.url = current?.url || item.url || '';
+            }
+        }
+        return conversations.map((item, index) => ({
+            rank: index + 1,
+            peer_name: item.peer_name || '',
+            peer_user_id: item.peer_user_id || '',
+            item_id: item.item_id || '',
+            item_title: item.item_title || '',
+            price: item.price || '',
+            last_message: item.last_message || '',
+            unread: Boolean(item.unread),
+            unread_count: Number(item.unread_count || 0),
+            url: item.url || '',
+        }));
+    },
+});
+
+export const __test__ = {
+    buildInboxUrl,
+    buildExtractInboxEvaluate,
+    normalizeLimit,
+};