@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/gov-policy/gov-policy.test.js

@@ -1,224 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { JSDOM } from 'jsdom';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@agentrhq/webcmd/errors';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { extractSearchRows } from './search.js';
-import { extractRecentRows } from './recent.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const SEARCH_FIXTURE = readFileSync(join(__dirname, '__fixtures__/search.html'), 'utf8');
-const RECENT_FIXTURE = readFileSync(join(__dirname, '__fixtures__/recent.html'), 'utf8');
-
-function createPageMock(evaluateResult, overrides = {}) {
-    const evaluate = typeof evaluateResult === 'function'
-        ? vi.fn(evaluateResult)
-        : vi.fn().mockResolvedValue(evaluateResult);
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        wait: vi.fn().mockResolvedValue(undefined),
-        evaluate,
-        ...overrides,
-    };
-}
-
-describe('gov-policy commands — registration', () => {
-    it('registers search and recent as public browser commands', () => {
-        const search = getRegistry().get('gov-policy/search');
-        const recent = getRegistry().get('gov-policy/recent');
-
-        expect(search).toBeDefined();
-        expect(recent).toBeDefined();
-        expect(search.browser).toBe(true);
-        expect(recent.browser).toBe(true);
-        expect(search.strategy).toBe('public');
-        expect(recent.strategy).toBe('public');
-        expect(search.columns).toEqual(['rank', 'title', 'description', 'date', 'url']);
-        expect(recent.columns).toEqual(['rank', 'title', 'date', 'source', 'url']);
-    });
-
-    it('rejects empty search queries before browser navigation', async () => {
-        const search = getRegistry().get('gov-policy/search');
-        const page = { goto: vi.fn() };
-        await expect(search.func(page, { query: '   ' })).rejects.toThrow(ArgumentError);
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-
-    it('rejects invalid limits before browser navigation', async () => {
-        const search = getRegistry().get('gov-policy/search');
-        const recent = getRegistry().get('gov-policy/recent');
-        const page = createPageMock({ ok: true, rows: [] });
-
-        await expect(search.func(page, { query: '数字经济', limit: '0' })).rejects.toThrow(ArgumentError);
-        await expect(search.func(page, { query: '数字经济', limit: '1.5' })).rejects.toThrow(ArgumentError);
-        await expect(search.func(page, { query: '数字经济', limit: '21' })).rejects.toThrow(ArgumentError);
-        await expect(recent.func(page, { limit: 'abc' })).rejects.toThrow(ArgumentError);
-        expect(page.goto).not.toHaveBeenCalled();
-        expect(page.evaluate).not.toHaveBeenCalled();
-    });
-
-    it('maps empty search pages, selector drift, and browser failures to typed errors', async () => {
-        const search = getRegistry().get('gov-policy/search');
-        const recent = getRegistry().get('gov-policy/recent');
-
-        await expect(search.func(createPageMock({
-            ok: false,
-            sample: '很抱歉，没有找到与 数字经济 相关的结果',
-            url: 'https://sousuo.www.gov.cn/sousuo/search.shtml?searchWord=x',
-        }), { query: '数字经济' })).rejects.toThrow(EmptyResultError);
-
-        await expect(recent.func(createPageMock({
-            ok: false,
-            sample: '<main>unexpected government page shell</main>',
-            url: 'https://www.gov.cn/zhengce/zuixin/index.htm',
-        }), {})).rejects.toThrow(CommandExecutionError);
-
-        await expect(search.func(createPageMock(
-            { ok: true, rows: [] },
-            { goto: vi.fn().mockRejectedValue(new Error('browser disconnected')) },
-        ), { query: '数字经济' })).rejects.toThrow(CommandExecutionError);
-    });
-});
-
-/**
- * In-browser DOM extractors against frozen sanitized HTML fixtures.
- *
- * Mocked-page.evaluate tests can't catch silent bugs that live inside the
- * extractor, since they feed pre-baked results to the func and the real
- * DOM walk never runs.
- *
- * These tests replay the real (sanitized) HTML through JSDOM so changes
- * to the extractor logic that re-introduce a silent regression fail in CI.
- */
-describe('gov-policy adapter — extractors against frozen HTML fixtures', () => {
-    let originalDocument;
-    let originalLocation;
-
-    beforeEach(() => {
-        originalDocument = globalThis.document;
-        originalLocation = globalThis.location;
-    });
-
-    afterEach(() => {
-        globalThis.document = originalDocument;
-        globalThis.location = originalLocation;
-    });
-
-    function loadFixture(html, url) {
-        const dom = new JSDOM(html, { url });
-        globalThis.document = dom.window.document;
-        globalThis.location = dom.window.location;
-        return dom;
-    }
-
-    it('extractSearchRows returns three result-shaped rows with title, description, date, url', () => {
-        loadFixture(SEARCH_FIXTURE, 'https://sousuo.www.gov.cn/sousuo/search.shtml?searchWord=%E6%95%B0%E5%AD%97%E7%BB%8F%E6%B5%8E');
-
-        const result = extractSearchRows();
-
-        expect(result.ok).toBe(true);
-        expect(result.rows).toHaveLength(3);
-
-        // Rank 1 + 3 are the homogeneous "type tag + emphasized title" cards
-        // whose .description div carries only the date span (no real snippet).
-        expect(result.rows[0]).toMatchObject({
-            rank: 1,
-            title: '要闻经济数据速览：10组数字看一季度中国经济',
-            date: '2026-4-16',
-            url: 'https://www.gov.cn/zhengce/jiedu/tujie/202604/content_7065945.htm',
-        });
-        // Description for these rows is just the publish-time line.
-        expect(result.rows[0].description).toContain('发布时间');
-        expect(result.rows[0].description).toContain('2026-4-16');
-
-        // Rank 2 has a real article snippet inside .description > .detail > p,
-        // and the extractor must capture it (sliced to 120 chars).
-        expect(result.rows[1]).toMatchObject({
-            rank: 2,
-            title: '要闻何立峰会见法国经济、财政和工业、能源与数字主权部部长莱斯屈尔',
-            date: '2026-3-17',
-            url: 'https://www.gov.cn/yaowen/liebiao/202603/content_7062985.htm',
-        });
-        expect(result.rows[1].description.length).toBeLessThanOrEqual(120);
-        expect(result.rows[1].description).toContain('新华社巴黎');
-
-        expect(result.rows[2]).toMatchObject({
-            rank: 3,
-            title: '要闻经济数据速览：7组数字看1—2月份中国经济',
-            date: '2026-3-16',
-            url: 'https://www.gov.cn/zhengce/jiedu/tujie/202603/content_7062831.htm',
-        });
-
-        // Lock the no-collapse contract on the title: the type_title prefix
-        // ('要闻') is fused into the textContent because we read the whole <a>.
-        // If a future refactor strips the prefix, this assertion catches it
-        // before any field-level downstream surprises.
-        for (const row of result.rows) {
-            expect(row.title.startsWith('要闻')).toBe(true);
-        }
-    });
-
-    it('extractRecentRows returns five rows with title, date, url and empty source', () => {
-        loadFixture(RECENT_FIXTURE, 'https://www.gov.cn/zhengce/zuixin/index.htm');
-
-        const result = extractRecentRows();
-
-        expect(result.ok).toBe(true);
-        expect(result.rows).toHaveLength(5);
-
-        expect(result.rows[0]).toMatchObject({
-            rank: 1,
-            title: '中共中央办公厅 国务院办公厅关于加强新就业群体服务管理的意见',
-            date: '2026-04-26',
-            url: 'https://www.gov.cn/zhengce/202604/content_7066998.htm',
-        });
-        expect(result.rows[1]).toMatchObject({
-            rank: 2,
-            date: '2026-04-23',
-        });
-        expect(result.rows[4]).toMatchObject({
-            rank: 5,
-            date: '2026-04-17',
-        });
-
-        // gov.cn/zhengce/zuixin layout has no .source / .from elements, so
-        // the source field is always an empty string. Lock that contract:
-        // a future selector change that picks up unrelated text would break
-        // it and fail this assertion.
-        for (const row of result.rows) {
-            expect(row.source).toBe('');
-        }
-    });
-
-    it('extractSearchRows signals ok:false with a sample when result list is empty', () => {
-        loadFixture(
-            '<html><head><title>blocked</title></head><body><main>访问受限，请稍后再试</main></body></html>',
-            'https://sousuo.www.gov.cn/sousuo/search.shtml?searchWord=zzz',
-        );
-
-        const result = extractSearchRows();
-
-        expect(result.ok).toBe(false);
-        expect(result.url).toBe('https://sousuo.www.gov.cn/sousuo/search.shtml?searchWord=zzz');
-        expect(result.sample).toContain('访问受限');
-    });
-
-    it('extractRecentRows signals ok:false with a sample when listing is empty', () => {
-        loadFixture(
-            '<html><head><title>not found</title></head><body><main>页面正在加载</main></body></html>',
-            'https://www.gov.cn/zhengce/zuixin/index.htm',
-        );
-
-        const result = extractRecentRows();
-
-        expect(result.ok).toBe(false);
-        expect(result.url).toBe('https://www.gov.cn/zhengce/zuixin/index.htm');
-        expect(result.sample).toContain('页面正在加载');
-    });
-});

package/clis/gov-policy/recent.js

@@ -1,90 +0,0 @@
-/**
- * gov-policy recent — latest State Council policy releases.
- *
- * Targets www.gov.cn/zhengce/zuixin/index.htm. The listing is rendered
- * server-side into one of `.news_box li`, `.list li`, `.list_item`,
- * `.news-list li` (the page rotates between layouts).
- *
- * The DOM extractor is defined as a top-level function and injected
- * into `page.evaluate` via `.toString()`, so the same code is exercised
- * by a JSDOM-against-frozen-fixture unit test (see gov-policy.test.js).
- */
-
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import {
-    classifyExtractorFailure,
-    parseGovPolicyLimit,
-    requireRows,
-    wrapBrowserError,
-} from './utils.js';
-
-/**
- * Pure DOM extractor for the gov-policy "latest policies" listing page.
- *
- * Uses bare `document` / `location` so it runs identically in:
- *   - the live browser (injected via `${extractRecentRows.toString()}`)
- *   - JSDOM unit tests (which swap `globalThis.document` / `globalThis.location`)
- */
-export function extractRecentRows() {
-    const normalize = (v) => (v || '').replace(/\s+/g, ' ').trim();
-    const items = document.querySelectorAll('.news_box li, .list li, .list_item, .news-list li');
-    if (items.length === 0) {
-        const body = document.body;
-        const sampleText = (body && (body.innerText || body.textContent)) || '';
-        return {
-            ok: false,
-            sample: sampleText.slice(0, 800),
-            url: location.href,
-        };
-    }
-    const rows = [];
-    for (const el of items) {
-        const titleEl = el.querySelector('a');
-        const title = normalize(titleEl?.textContent);
-        if (!title || title.length < 4) continue;
-
-        let url = titleEl?.getAttribute('href') || '';
-        if (url && !url.startsWith('http')) url = 'https://www.gov.cn' + url;
-
-        const date = (el.textContent || '').match(/(\d{4}[-./]\d{1,2}[-./]\d{1,2})/)?.[1] || '';
-        const source = normalize(el.querySelector('.source, .from')?.textContent);
-
-        rows.push({ rank: rows.length + 1, title, date, source, url });
-    }
-    return { ok: true, rows };
-}
-
-cli({
-    site: 'gov-policy',
-    name: 'recent',
-    access: 'read',
-    description: '国务院最新政策文件',
-    domain: 'www.gov.cn',
-    strategy: Strategy.PUBLIC,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
-    ],
-    columns: ['rank', 'title', 'date', 'source', 'url'],
-    func: async (page, kwargs) => {
-        const limit = parseGovPolicyLimit(kwargs.limit, 'recent');
-        try {
-            await page.goto('https://www.gov.cn/zhengce/zuixin/index.htm');
-            await page.wait(4);
-            // Poll until the SSR listing mounts.
-            await page.evaluate(`
-      (async () => {
-        for (let i = 0; i < 20; i++) {
-          if (document.querySelector('.news_box li, .list li, .list_item, .news-list li')) break;
-          await new Promise(r => setTimeout(r, 500));
-        }
-      })()
-    `);
-            const result = await page.evaluate(`(${extractRecentRows.toString()})()`);
-            if (!result || !result.ok) classifyExtractorFailure('recent', result);
-            return requireRows('recent', result.rows).slice(0, limit);
-        } catch (error) {
-            wrapBrowserError('recent', error);
-        }
-    },
-});

package/clis/gov-policy/search.js

@@ -1,91 +0,0 @@
-/**
- * gov-policy search — Chinese government policy full-text search.
- *
- * Targets sousuo.www.gov.cn. Results are server-rendered into
- * `.basic_result_content .item` cards.
- *
- * The DOM extractor is defined as a top-level function and injected
- * into `page.evaluate` via `.toString()`, so the same code is exercised
- * by a JSDOM-against-frozen-fixture unit test (see gov-policy.test.js).
- */
-
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requireNonEmptyQuery } from '../_shared/common.js';
-import {
-    classifyExtractorFailure,
-    parseGovPolicyLimit,
-    requireRows,
-    wrapBrowserError,
-} from './utils.js';
-
-/**
- * Pure DOM extractor for the gov-policy search-results page.
- *
- * Uses bare `document` / `location` so it runs identically in:
- *   - the live browser (injected via `${extractSearchRows.toString()}`)
- *   - JSDOM unit tests (which swap `globalThis.document` / `globalThis.location`)
- */
-export function extractSearchRows() {
-    const normalize = (v) => (v || '').replace(/\s+/g, ' ').trim();
-    const items = document.querySelectorAll('.basic_result_content .item, .js_basic_result_content .item');
-    if (items.length === 0) {
-        const body = document.body;
-        const sampleText = (body && (body.innerText || body.textContent)) || '';
-        return {
-            ok: false,
-            sample: sampleText.slice(0, 800),
-            url: location.href,
-        };
-    }
-    const rows = [];
-    for (const el of items) {
-        const titleEl = el.querySelector('a.title, .title a, a.log-anchor');
-        const title = normalize(titleEl?.textContent).replace(/<[^>]+>/g, '');
-        if (!title || title.length < 4) continue;
-
-        let url = titleEl?.getAttribute('href') || '';
-        if (url && !url.startsWith('http')) url = 'https://www.gov.cn' + url;
-
-        const description = normalize(el.querySelector('.description')?.textContent).slice(0, 120);
-        const date = (el.textContent || '').match(/(\d{4}[-./]\d{1,2}[-./]\d{1,2})/)?.[1] || '';
-        rows.push({ rank: rows.length + 1, title, description, date, url });
-    }
-    return { ok: true, rows };
-}
-
-cli({
-    site: 'gov-policy',
-    name: 'search',
-    access: 'read',
-    description: '中国政府网政策文件搜索',
-    domain: 'sousuo.www.gov.cn',
-    strategy: Strategy.PUBLIC,
-    browser: true,
-    args: [
-        { name: 'query', positional: true, required: true, help: '搜索关键词' },
-        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
-    ],
-    columns: ['rank', 'title', 'description', 'date', 'url'],
-    func: async (page, kwargs) => {
-        const limit = parseGovPolicyLimit(kwargs.limit, 'search');
-        const query = requireNonEmptyQuery(kwargs.query);
-        try {
-            await page.goto(`https://sousuo.www.gov.cn/sousuo/search.shtml?code=17da70961a7&dataTypeId=107&searchWord=${encodeURIComponent(query)}`);
-            await page.wait(5);
-            // Poll until the SSR result list mounts.
-            await page.evaluate(`
-      (async () => {
-        for (let i = 0; i < 30; i++) {
-          if (document.querySelectorAll('.basic_result_content .item, .js_basic_result_content .item').length > 0) break;
-          await new Promise(r => setTimeout(r, 500));
-        }
-      })()
-    `);
-            const result = await page.evaluate(`(${extractSearchRows.toString()})()`);
-            if (!result || !result.ok) classifyExtractorFailure('search', result);
-            return requireRows('search', result.rows).slice(0, limit);
-        } catch (error) {
-            wrapBrowserError('search', error);
-        }
-    },
-});

package/clis/gov-policy/utils.js

@@ -1,54 +0,0 @@
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-
-const EMPTY_RESULT_PATTERNS = [
-    /没有找到/,
-    /暂无/,
-    /无相关/,
-    /未找到/,
-    /搜索结果为\s*0/,
-    /很抱歉/,
-];
-
-export function parseGovPolicyLimit(raw, command) {
-    const value = raw ?? 10;
-    const limit = Number(value);
-    if (!Number.isInteger(limit) || limit < 1) {
-        throw new ArgumentError(`gov-policy ${command} --limit must be a positive integer`);
-    }
-    if (limit > 20) {
-        throw new ArgumentError(`gov-policy ${command} --limit must be <= 20`);
-    }
-    return limit;
-}
-
-export function classifyExtractorFailure(command, result) {
-    const sample = String(result?.sample || '').replace(/\s+/g, ' ').trim();
-    const url = String(result?.url || '').trim();
-    if (command === 'search' && EMPTY_RESULT_PATTERNS.some((pattern) => pattern.test(sample))) {
-        throw new EmptyResultError('gov-policy search', sample ? sample.slice(0, 160) : undefined);
-    }
-    const context = [url && `url=${url}`, sample && `sample=${sample.slice(0, 160)}`]
-        .filter(Boolean)
-        .join('; ');
-    throw new CommandExecutionError(
-        `gov-policy ${command} page did not expose readable result rows`,
-        context || 'The page structure may have changed or the page did not finish rendering.',
-    );
-}
-
-export function requireRows(command, rows) {
-    if (!Array.isArray(rows) || rows.length === 0) {
-        throw new CommandExecutionError(
-            `gov-policy ${command} extractor returned no result rows`,
-            'The page structure may have changed or all result cards were missing required title fields.',
-        );
-    }
-    return rows;
-}
-
-export function wrapBrowserError(command, error) {
-    if (error instanceof ArgumentError || error instanceof EmptyResultError || error instanceof CommandExecutionError) {
-        throw error;
-    }
-    throw new CommandExecutionError(`gov-policy ${command} browser extraction failed: ${error?.message ?? error}`);
-}

package/clis/guazi/__fixtures__/detail.html

@@ -1,7 +0,0 @@
-<!doctype html><html><head>
-<meta property="og:title" content="【准新车】二手奔腾T90 2025款 龙耀版 1.5T 舒享型报价，真实车源图片/视频 - 瓜子二手车"/>
-</head><body><script>
-ess=image/quality,q_88/resize,m_fill,w_750,h_750\"}],\"type\":2}],\"videoList\":[],\"videoAbResult\":true,\"videoFeedsSwitch\":true,\"imageCropRatio1x1\":false},\"carRecordInfo\":{\"simpleSummary\":[{\"label\":\"首次上牌\",\"value\":\"2024-12\",\"fullRow\":false},{\"label\":\"表显里程\",\"value\":\"0.17万公里\",\"fullRow\":false},{\"label\":\"过户次数\",\"value\":\"0次\",\"fullRow\":false,\"bottomBall\":{\"title\":\"关于过户次数\",\"desc\":\"部分商家为周转车辆会临时过户至他人名下，建议通过视频看车功能直接与商家确认最新状态。\"}},{\"label\":\"车源地\",\"value\":\"苏州\",\"fullRow\":false}],\"carParamsSummary\":[{\"label\":\"发动机\",\"value\":\"1.5T\",\"fullRow\":false},{\"label\":\"变速箱\",\"value\":\"自动\",\"fullRow\":false},{\"key\":\"emission\",\"label\":\"排放标准\",\"value\":\"国六b\",\"fullRow\":false},{\"label\":\"驱动方式\",\"value\":\"前置前驱\",\"fullRow\":false}],\"archiveSummary\":[{\"key\":\"emission\",\"label\":\"排放标准\",\"value\":\"国六b\",\"fullRow\":false},{\"label\":\"车源地\",\"value\":\"苏州\",\"fullRow\":false},{\"label\":\"车身颜色\",\"value\":\"白色\",\"fullRow\":false},{\"label\":\"车源编号\",\"value\":\"162563585\",\"fullRow\":false}],\"highlightConfigItem\":[{\"id\":5,\"title\":\"方向盘加热\",\"image\":\"https://image1.guazistatic.com/qn2105181024035ead3ad6da599924f0d05a54e3f30885.png\",\"desc\":\"由方向盘内的加热系统实现，由方向盘或中控台上的按钮开启或关闭。属于较高的舒适型配置。\"},{\"id\":11,\"title\":\"自适应巡航\",\"image\":\"https://image1.guazistatic.com/qn2105181212480a405f49434fc91994a49bed6888e181.png\",\"desc\":\"Adaptive Cruise Control简称ACC，可依所设定速度行驶，还可保持预设跟车距离，随着车距变化自动加速与减速。\"},{\"id\":13,\"title\":\"自适应远近光\",\"image\":\"https://image1.guazistatic.com/qn210518121604812071c5c5251de8b33dcf01a5319478.png\",\"desc\":\"开启大灯时，行驶中传感器判断对向或同向车辆情况，自动切换远近光灯，有效保护其他车辆行车安全。\"},{\"id\":14,\"title\":\"并线辅
-s://m.guazi.com/car-detail/c162563585115789.html","price":73800,"priceCurrency":"CNY","priceValidUnt
-1年6个月，车况S，基础车况极品/理赔0次/过户0次，瓜子二手车，每车必检，超200项官方检测认证，
-</script></body></html>

package/clis/guazi/__fixtures__/list.html

@@ -1,5 +0,0 @@
-<!doctype html><html><body><div class="list">
-<a class="text-gz-black-303740" href="/car-detail/c168029452296957.html"><section class="mb-20 flex justify-between gap-12"><div class="overflow-hidden rounded-md w-114 h-85"><div class="rounded-md object-cover w-114 h-85" style="position:relative;overflow:hidden"><img alt="创维汽车 创维HT-i 2024款 1.5L PHEV 115KM 泰道版" loading="lazy" width="114" height="85" decoding="async" data-nimg="1" class="object-cover" style="color:transparent;position:absolute;width:100%;height:100%;top:0;left:0;opacity:0;transition:opacity 0.3s ease" src="https://image-public.guazistatic.com/qnbdp7206xf2022ab5473b42ad9bced3eb032b23b71780880135.jpg?x-bce-process=image/quality,q_88/resize,m_fill,w_280,h_210"/></div></div><div class="flex-1"><h4 class="line-height-1.5 line-clamp-2"><img alt="icon" loading="lazy" width="41" height="14" decoding="async" data-nimg="1" class="mr-5 inline-block h-14 w-41 -translate-y-1.5" style="color:transparent" src="https://image-public.guazistatic.com/qnbdp1066x2bcdce4af34c493db02eddd6babff42e1754566654.png"/>创维汽车 创维HT-i 2024款 1.5L PHEV 115KM 泰道版</h4><div class="flex h-20 flex-wrap gap-y-10 overflow-hidden whitespace-nowrap w-274 py-4"><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="已检测" style="color:#009B3F;border-color:#99D7B2">已检测</span><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="插电混动" style="color:#009B3F;border-color:#99D7B2">插电混动</span></div><p class="text-11 text-gz-gray-999 leading-11"><span>2025年</span><span>｜</span><span>0.64万公里</span><span>｜</span><span>北京</span></p><div class="flex justify-start pt-4 leading-12"><div class="flex items-end justify-start"><span class="text-gz-red-f22a18 font-din text-18 leading-12 font-bold">6.85</span><span class="text-gz-red-f22a18 text-12 mr-2">万</span></div><div class="flex flex-1 items-end justify-between"><span class="text-gz-glod-997147 text-12 ml-4">首付<!-- -->0.69万</span></div></div></div></section></a>
-<a class="text-gz-black-303740" href="/car-detail/c168569647231900.html"><section class="mb-20 flex justify-between gap-12"><div class="overflow-hidden rounded-md w-114 h-85"><div class="rounded-md object-cover w-114 h-85" style="position:relative;overflow:hidden"><img alt="雪佛兰 科帕奇 2014款 2.4L 四驱旗舰版 7座" loading="lazy" width="114" height="85" decoding="async" data-nimg="1" class="object-cover" style="color:transparent;position:absolute;width:100%;height:100%;top:0;left:0;opacity:0;transition:opacity 0.3s ease" src="https://image-public.guazistatic.com/qnbdp7206x97a811e2903f49e09bb878a57fdcbd0b1781747835.jpg?x-bce-process=image/quality,q_88/resize,m_fill,w_280,h_210"/></div></div><div class="flex-1"><h4 class="line-height-1.5 line-clamp-2"><img alt="icon" loading="lazy" width="41" height="14" decoding="async" data-nimg="1" class="mr-5 inline-block h-14 w-41 -translate-y-1.5" style="color:transparent" src="https://image-public.guazistatic.com/qnbdp1066x1ee05047385e452c90ad8ae7a264a0b51754566654.png"/>雪佛兰 科帕奇 2014款 2.4L 四驱旗舰版 7座</h4><div class="flex h-20 flex-wrap gap-y-10 overflow-hidden whitespace-nowrap w-274 py-4"><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="已检测" style="color:#009B3F;border-color:#99D7B2">已检测</span><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="顶配" style="color:#303741;border-color:#DFE0E2">顶配</span></div><p class="text-11 text-gz-gray-999 leading-11"><span>2015年</span><span>｜</span><span>18.27万公里</span><span>｜</span><span>北京</span></p><div class="flex justify-start pt-4 leading-12"><div class="flex items-end justify-start"><span class="text-gz-red-f22a18 font-din text-18 leading-12 font-bold">1.41</span><span class="text-gz-red-f22a18 text-12 mr-2">万</span></div><div class="flex flex-1 items-end justify-between"><span class="text-gz-glod-997147 text-12 ml-4">首付<!-- -->0.14万</span></div></div></div></section></a>
-<a class="text-gz-black-303740" href="/car-detail/c168109339309545.html"><section class="mb-20 flex justify-between gap-12"><div class="overflow-hidden rounded-md w-114 h-85"><div class="rounded-md object-cover w-114 h-85" style="position:relative;overflow:hidden"><img alt="吉利银河 银河A7 2026款 EV 550km 臻享版" loading="lazy" width="114" height="85" decoding="async" data-nimg="1" class="object-cover" style="color:transparent;position:absolute;width:100%;height:100%;top:0;left:0;opacity:0;transition:opacity 0.3s ease" src="https://image-public.guazistatic.com/qnbdp7206xfeffa252cc524361918effe5eca6e18b1780731400.jpg?x-bce-process=image/quality,q_88/resize,m_fill,w_280,h_210"/></div></div><div class="flex-1"><h4 class="line-height-1.5 line-clamp-2"><img alt="icon" loading="lazy" width="41" height="14" decoding="async" data-nimg="1" class="mr-5 inline-block h-14 w-41 -translate-y-1.5" style="color:transparent" src="https://image-public.guazistatic.com/qnbdp1066x2bcdce4af34c493db02eddd6babff42e1754566654.png"/>吉利银河 银河A7 2026款 EV 550km 臻享版</h4><div class="flex h-20 flex-wrap gap-y-10 overflow-hidden whitespace-nowrap w-274 py-4"><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="已检测" style="color:#009B3F;border-color:#99D7B2">已检测</span><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="纯电动" style="color:#009B3F;border-color:#99D7B2">纯电动</span></div><p class="text-11 text-gz-gray-999 leading-11"><span>2026年</span><span>｜</span><span>300公里</span><span>｜</span><span>北京</span></p><div class="flex justify-start pt-4 leading-12"><div class="flex items-end justify-start"><span class="text-gz-red-f22a18 font-din text-18 leading-12 font-bold">10.08</span><span class="text-gz-red-f22a18 text-12 mr-2">万</span></div><div class="flex flex-1 items-end justify-between"><span class="text-gz-glod-997147 text-12 ml-4">首付<!-- -->1.01万</span></div></div></div></section></a>
-</div></body></html>

package/clis/guazi/browse.js

@@ -1,95 +0,0 @@
-/**
- * guazi browse — list used cars for sale in a city.
- *
- * Reads the mobile SSR list page `https://m.guazi.com/<city>/buy/`. Each
- * listing is an `<a href="/car-detail/c<clueId>.html">` whose `<img alt>`
- * holds the full title and whose visible text carries price / down-payment
- * / mileage / year / city. Parsing is a pure HTML→rows function (no DOM,
- * no network) so it runs identically in the unit test against a frozen page.
- */
-
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import {
-    BROWSE_COLUMNS,
-    CommandExecutionError,
-    GUAZI_M_BASE,
-    clean,
-    guaziFetch,
-    requireStableId,
-    requireText,
-    requireLimit,
-    resolveCityCode,
-} from './utils.js';
-
-/** Energy types Guazi tags on a card. */
-const ENERGY = ['插电混动', '纯电动', '油电混动', '增程式', '汽油', '柴油'];
-
-/**
- * Pure parser: list-page HTML → listing rows. Exported for unit testing.
- */
-export function parseListings(html, limit) {
-    const anchors = String(html || '').match(/<a[^>]+href="\/car-detail\/c\d+\.html"[\s\S]*?<\/a>/g) || [];
-    const rows = [];
-    const seen = new Set();
-    for (const a of anchors) {
-        const idM = a.match(/car-detail\/c(\d+)\.html/);
-        if (!idM) continue;
-        const clueId = requireStableId(idM[1], `guazi listing row ${rows.length + 1}`);
-        if (seen.has(clueId)) continue;
-        seen.add(clueId);
-
-        const altM = a.match(/<img[^>]+alt="([^"]+)"/);
-        const title = requireText(altM && altM[1], `guazi listing ${clueId} title`);
-
-        const text = clean(a.replace(/<[^>]+>/g, ' '));
-        const priceM = text.match(/(\d+(?:\.\d+)?)\s*万\s*首付/);
-        const downM = text.match(/首付\s*(\d+(?:\.\d+)?)\s*万/);
-        const mileM = text.match(/(\d+(?:\.\d+)?万公里|\d+公里)/);
-        const yearM = text.match(/(\d{4})年/);
-        // city sits between the mileage and the price ("… ｜ 北京 6.85 万 首付 …")
-        const cityM = text.match(/[｜|]\s*([^｜|]{1,8}?)\s+\d+(?:\.\d+)?\s*万\s*首付/);
-        const energy = ENERGY.find((e) => text.includes(e)) || '';
-
-        rows.push({
-            rank: rows.length + 1,
-            clue_id: clueId,
-            title,
-            price: priceM ? `${priceM[1]}万` : '',
-            down_payment: downM ? `${downM[1]}万` : '',
-            mileage: mileM ? mileM[1] : '',
-            year: yearM ? yearM[1] : '',
-            city: cityM ? clean(cityM[1]) : energy,
-            url: `${GUAZI_M_BASE}/car-detail/c${clueId}.html`,
-        });
-        if (rows.length >= limit) break;
-    }
-    return rows;
-}
-
-cli({
-    site: 'guazi',
-    name: 'browse',
-    access: 'read',
-    aliases: ['list'],
-    description: '瓜子二手车在售车源列表（按城市，含售价/首付/里程/年份）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'city', positional: true, help: '城市名（北京/上海/...）或瓜子城市码（bj/sh/...）。默认 bj 北京' },
-        { name: 'limit', type: 'int', default: 20, help: '返回的车源数量（最多 40，单页 SSR 上限）' },
-    ],
-    columns: BROWSE_COLUMNS,
-    func: async (args) => {
-        const code = resolveCityCode(args.city);
-        const limit = requireLimit(args.limit, 20, 40);
-        const html = await guaziFetch(`/${code}/buy/`, `browse ${code}`);
-        const rows = parseListings(html, limit);
-        if (rows.length === 0) {
-            throw new CommandExecutionError(
-                `guazi browse ${code}`,
-                'No SSR listing anchors found on a successful Guazi mobile page; the mobile layout may have changed.',
-            );
-        }
-        return rows;
-    },
-});