@jackwener/opencli 1.7.4 → 1.7.5

package/clis/eastmoney/money-flow.js

@@ -0,0 +1,78 @@
+// eastmoney money-flow — main-force net inflow ranking (沪深A今日/5日/10日).
+//
+//   opencli eastmoney money-flow
+//   opencli eastmoney money-flow --range 5d --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const A_MARKET = 'm:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23,m:0+t:81+s:2048';
+
+// (main, super, big, medium, small) net inflow amount fields
+const RANGES = {
+  today: { fid: 'f62', fields: { net: 'f62', netPct: 'f184', super: 'f66', big: 'f72', medium: 'f78', small: 'f84' } },
+  '5d':  { fid: 'f164', fields: { net: 'f164', netPct: 'f165', super: 'f166', big: 'f169', medium: 'f172', small: 'f175' } },
+  '10d': { fid: 'f174', fields: { net: 'f174', netPct: 'f175', super: 'f176', big: 'f179', medium: 'f182', small: 'f185' } },
+};
+
+cli({
+  site: 'eastmoney',
+  name: 'money-flow',
+  description: '主力资金净流入排行（今日/5日/10日）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'range', type: 'string', default: 'today', help: '周期：today / 5d / 10d' },
+    { name: 'order', type: 'string', default: 'desc', help: '排序：desc (净流入排行) / asc (净流出)' },
+    { name: 'limit', type: 'int', default: 20, help: '返回数量 (max 100)' },
+  ],
+  columns: ['rank', 'code', 'name', 'price', 'changePercent', 'mainNet', 'mainNetRatio', 'superNet', 'bigNet', 'mediumNet', 'smallNet'],
+  func: async (_page, args) => {
+    const rangeKey = String(args.range ?? 'today').toLowerCase();
+    const range = RANGES[rangeKey];
+    if (!range) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown range "${rangeKey}". Valid: ${Object.keys(RANGES).join(', ')}`);
+    }
+    const po = String(args.order ?? 'desc').toLowerCase() === 'asc' ? '0' : '1';
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const fieldList = [
+      'f12', 'f14', 'f2', 'f3',
+      range.fields.net, range.fields.netPct,
+      range.fields.super, range.fields.big, range.fields.medium, range.fields.small,
+    ];
+
+    const url = new URL('https://push2.eastmoney.com/api/qt/clist/get');
+    url.searchParams.set('pn', '1');
+    url.searchParams.set('pz', String(limit));
+    url.searchParams.set('po', po);
+    url.searchParams.set('np', '1');
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('invt', '2');
+    url.searchParams.set('fid', range.fid);
+    url.searchParams.set('fs', A_MARKET);
+    url.searchParams.set('fields', fieldList.join(','));
+    url.searchParams.set('ut', 'b2884a393a59ad64002292a3e90d46a5');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `money-flow failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no money-flow data');
+
+    return diff.slice(0, limit).map((it, i) => ({
+      rank: i + 1,
+      code: it.f12,
+      name: it.f14,
+      price: it.f2,
+      changePercent: it.f3,
+      mainNet: it[range.fields.net],
+      mainNetRatio: it[range.fields.netPct],
+      superNet: it[range.fields.super],
+      bigNet: it[range.fields.big],
+      mediumNet: it[range.fields.medium],
+      smallNet: it[range.fields.small],
+    }));
+  },
+});

package/clis/eastmoney/northbound.js

@@ -0,0 +1,57 @@
+// eastmoney northbound — live realtime cross-border capital flow (北向/南向).
+//
+// Returns the latest non-empty minute snapshot of cumulative net flow in 万元.
+//   opencli eastmoney northbound
+//   opencli eastmoney northbound --direction south
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+cli({
+  site: 'eastmoney',
+  name: 'northbound',
+  description: '沪深港通北向/南向资金当日分时净流入（万元）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'direction', type: 'string', default: 'north', help: '方向：north (北向，即外资买A) / south (南向，即内地买港)' },
+    { name: 'limit',     type: 'int',    default: 10,      help: '返回最近 N 分钟' },
+  ],
+  columns: ['time', 'cumulativeNetYi', 'minuteNetYi', 'totalNetYi'],
+  func: async (_page, args) => {
+    const dir = String(args.direction ?? 'north').toLowerCase();
+    if (!['north', 'south', 'n', 's'].includes(dir)) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown direction "${dir}". Valid: north / south`);
+    }
+    const limit = Math.max(1, Math.min(Number(args.limit) || 10, 240));
+
+    const url = new URL('https://push2.eastmoney.com/api/qt/kamtbs.rtmin/get');
+    url.searchParams.set('fields1', 'f1,f2,f3,f4');
+    url.searchParams.set('fields2', 'f51,f52,f54,f56');
+    url.searchParams.set('ut', 'b2884a393a59ad64002292a3e90d46a5');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `northbound failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const key = (dir === 'south' || dir === 's') ? 's2n' : 'n2s';
+    /** @type {string[]} */
+    const rows = Array.isArray(data?.data?.[key]) ? data.data[key] : [];
+    if (rows.length === 0) throw new CliError('NO_DATA', `No ${key} data returned`);
+
+    // CSV fields per entry: "HH:MM,cumulative_net(万), minute_net(万), total_net(万)"
+    // Drop rows with '-' (after market close or before open). Convert 万元 → 亿元 for readability.
+    const valid = rows
+      .map((r) => r.split(','))
+      .filter((c) => c.length >= 4 && c[1] !== '-');
+    if (valid.length === 0) {
+      throw new CliError('NO_DATA', `${key} has no valid minute data yet (markets may not be open)`);
+    }
+    return valid.slice(-limit).map(([time, cum, min, total]) => ({
+      time,
+      cumulativeNetYi: +(Number(cum) / 10000).toFixed(4),
+      minuteNetYi: +(Number(min) / 10000).toFixed(4),
+      totalNetYi: +(Number(total) / 10000).toFixed(4),
+    }));
+  },
+});

package/clis/eastmoney/quote.js

@@ -0,0 +1,107 @@
+// eastmoney quote — live quote for one or more stocks (A/HK/US).
+//
+// Data source: push2.eastmoney.com (Tier 1 public JSON, no auth).
+// Supported inputs (comma / space separated):
+//   600000, sh600000, 000001, sz000001, 00700.HK, hk00700, AAPL, us.AAPL
+//
+//   opencli eastmoney quote 600000 --fields all
+//   opencli eastmoney quote "sh600000,sz000001,00700.HK"
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+import { resolveSecid, splitSymbols } from './_secid.js';
+
+const FIELDS = [
+  'f12', // code
+  'f13', // market
+  'f14', // name
+  'f2',  // price
+  'f3',  // changePercent
+  'f4',  // change
+  'f5',  // volume (手)
+  'f6',  // turnover (CNY)
+  'f7',  // amplitude %
+  'f8',  // turnoverRate %
+  'f9',  // peDynamic
+  'f10', // volumeRatio
+  'f15', // high
+  'f16', // low
+  'f17', // open
+  'f18', // prevClose
+  'f20', // marketCap
+  'f21', // floatMarketCap
+  'f23', // priceBook
+].join(',');
+
+function marketLabel(f13) {
+  if (f13 === 1) return 'SH';
+  if (f13 === 0) return 'SZ/BJ';
+  if (f13 === 116) return 'HK';
+  if (f13 === 105 || f13 === 106 || f13 === 107) return 'US';
+  return String(f13 ?? '');
+}
+
+cli({
+  site: 'eastmoney',
+  name: 'quote',
+  description: '个股实时行情（A股 / 港股 / 美股）— 来自 push2.eastmoney.com',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbols', required: true, positional: true, help: '股票代码（可用逗号/空格分隔多个）' },
+  ],
+  columns: [
+    'code', 'name', 'market', 'price', 'changePercent', 'change',
+    'open', 'high', 'low', 'prevClose', 'volume', 'turnover',
+    'turnoverRate', 'amplitude', 'peDynamic', 'priceBook',
+    'marketCap', 'floatMarketCap',
+  ],
+  func: async (_page, args) => {
+    const raw = splitSymbols(args.symbols);
+    if (raw.length === 0) {
+      throw new CliError('INVALID_ARGUMENT', 'At least one symbol is required');
+    }
+
+    /** @type {string[]} */
+    const secids = [];
+    for (const s of raw) {
+      try { secids.push(resolveSecid(s)); }
+      catch (err) { throw new CliError('INVALID_ARGUMENT', `Unrecognized symbol "${s}"`); }
+    }
+
+    // Multi-stock in one call via ulist.np
+    const url = new URL('https://push2.eastmoney.com/api/qt/ulist.np/get');
+    url.searchParams.set('secids', secids.join(','));
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('fields', FIELDS);
+    url.searchParams.set('ut', 'bd1d9ddb04089700cf9c27f6f7426281');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `eastmoney quote failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no quotes', `Check symbols: ${raw.join(', ')}`);
+
+    return diff.map((it) => ({
+      code: it.f12,
+      name: it.f14,
+      market: marketLabel(it.f13),
+      price: it.f2,
+      changePercent: it.f3,
+      change: it.f4,
+      open: it.f17,
+      high: it.f15,
+      low: it.f16,
+      prevClose: it.f18,
+      volume: it.f5,
+      turnover: it.f6,
+      turnoverRate: it.f8,
+      amplitude: it.f7,
+      peDynamic: it.f9,
+      priceBook: it.f23,
+      marketCap: it.f20,
+      floatMarketCap: it.f21,
+    }));
+  },
+});

package/clis/eastmoney/rank.js

@@ -0,0 +1,94 @@
+// eastmoney rank — market mover list across common segments.
+//
+// Data source: push2.eastmoney.com/api/qt/clist/get (Tier 1 public JSON).
+//   opencli eastmoney rank
+//   opencli eastmoney rank --market cyb --sort turnover --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const MARKETS = {
+  'hs-a':   'm:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23,m:0+t:81+s:2048', // 沪深 A
+  'sh-a':   'm:1+t:2,m:1+t:23',                                   // 沪 A
+  'sz-a':   'm:0+t:6,m:0+t:80',                                   // 深 A
+  'bj-a':   'm:0+t:81+s:2048',                                    // 北证 A
+  'cyb':    'm:0+t:80',                                           // 创业板
+  'kcb':    'm:1+t:23',                                           // 科创板
+  'hk':     'm:116+t:3,m:116+t:4,m:116+t:1,m:116+t:2',            // 港股
+  'us':     'm:105,m:106,m:107',                                  // 美股
+};
+
+const SORTS = {
+  change: { fid: 'f3',  order: 'desc' }, // 涨幅榜
+  drop:   { fid: 'f3',  order: 'asc'  }, // 跌幅榜
+  turnover:{ fid: 'f6', order: 'desc' }, // 成交额
+  volume: { fid: 'f5',  order: 'desc' }, // 成交量
+  amplitude:{ fid:'f7', order: 'desc' }, // 振幅
+  rate:   { fid: 'f8',  order: 'desc' }, // 换手率
+};
+
+const FIELDS =
+  'f2,f3,f4,f5,f6,f7,f8,f9,f10,f12,f13,f14,f15,f16,f17,f18,f20,f21,f23';
+
+cli({
+  site: 'eastmoney',
+  name: 'rank',
+  description: '东财市场涨跌/成交排行（沪深/北证/创/科/港/美）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'market', type: 'string', default: 'hs-a', help: '市场：hs-a / sh-a / sz-a / bj-a / cyb / kcb / hk / us' },
+    { name: 'sort',   type: 'string', default: 'change', help: '排序：change / drop / turnover / volume / amplitude / rate' },
+    { name: 'limit',  type: 'int',    default: 20,       help: '返回数量 (max 100)' },
+  ],
+  columns: ['rank', 'code', 'name', 'price', 'changePercent', 'change', 'turnover', 'volume', 'turnoverRate', 'peDynamic', 'marketCap'],
+  func: async (_page, args) => {
+    const market = String(args.market ?? 'hs-a').toLowerCase();
+    const sortKey = String(args.sort ?? 'change').toLowerCase();
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const fs = MARKETS[market];
+    if (!fs) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown market "${market}". Valid: ${Object.keys(MARKETS).join(', ')}`);
+    }
+    const sort = SORTS[sortKey];
+    if (!sort) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown sort "${sortKey}". Valid: ${Object.keys(SORTS).join(', ')}`);
+    }
+
+    const url = new URL('https://push2.eastmoney.com/api/qt/clist/get');
+    url.searchParams.set('pn', '1');
+    url.searchParams.set('pz', String(limit));
+    url.searchParams.set('po', sort.order === 'desc' ? '1' : '0');
+    url.searchParams.set('np', '1');
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('invt', '2');
+    url.searchParams.set('fid', sort.fid);
+    url.searchParams.set('fs', fs);
+    url.searchParams.set('fields', FIELDS);
+    url.searchParams.set('ut', 'bd1d9ddb04089700cf9c27f6f7426281');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `eastmoney rank failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) {
+      throw new CliError('NO_DATA', 'eastmoney returned no rank data', `market=${market} sort=${sortKey}`);
+    }
+
+    return diff.slice(0, limit).map((it, i) => ({
+      rank: i + 1,
+      code: it.f12,
+      name: it.f14,
+      price: it.f2,
+      changePercent: it.f3,
+      change: it.f4,
+      turnover: it.f6,
+      volume: it.f5,
+      turnoverRate: it.f8,
+      peDynamic: it.f9,
+      marketCap: it.f20,
+    }));
+  },
+});

package/clis/eastmoney/sectors.js

@@ -0,0 +1,76 @@
+// eastmoney sectors — industry / concept / region sector board ranking.
+//
+//   opencli eastmoney sectors
+//   opencli eastmoney sectors --type concept --sort money-flow --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const SECTOR_TYPES = {
+  industry: 'm:90+t:2',
+  concept:  'm:90+t:3',
+  region:   'm:90+t:1',
+};
+
+const SORTS = {
+  change: { fid: 'f3', order: 'desc' },
+  drop:   { fid: 'f3', order: 'asc' },
+  'money-flow': { fid: 'f62', order: 'desc' },
+  'out-flow':   { fid: 'f62', order: 'asc' },
+  turnover: { fid: 'f6', order: 'desc' },
+};
+
+cli({
+  site: 'eastmoney',
+  name: 'sectors',
+  description: '板块排行（行业/概念/地域）按涨跌幅、主力资金或成交额排序',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'type', type: 'string', default: 'industry', help: '板块类型：industry / concept / region' },
+    { name: 'sort', type: 'string', default: 'change',   help: '排序：change / drop / money-flow / out-flow / turnover' },
+    { name: 'limit', type: 'int',   default: 20,         help: '返回数量 (max 100)' },
+  ],
+  columns: ['rank', 'code', 'name', 'price', 'changePercent', 'mainNet', 'leadStock', 'leadChangePercent', 'upCount', 'downCount'],
+  func: async (_page, args) => {
+    const typeKey = String(args.type ?? 'industry').toLowerCase();
+    const fs = SECTOR_TYPES[typeKey];
+    if (!fs) throw new CliError('INVALID_ARGUMENT', `Unknown sector type "${typeKey}". Valid: ${Object.keys(SECTOR_TYPES).join(', ')}`);
+    const sortKey = String(args.sort ?? 'change').toLowerCase();
+    const sort = SORTS[sortKey];
+    if (!sort) throw new CliError('INVALID_ARGUMENT', `Unknown sort "${sortKey}". Valid: ${Object.keys(SORTS).join(', ')}`);
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const url = new URL('https://push2.eastmoney.com/api/qt/clist/get');
+    url.searchParams.set('pn', '1');
+    url.searchParams.set('pz', String(limit));
+    url.searchParams.set('po', sort.order === 'desc' ? '1' : '0');
+    url.searchParams.set('np', '1');
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('invt', '2');
+    url.searchParams.set('fid', sort.fid);
+    url.searchParams.set('fs', fs);
+    url.searchParams.set('fields', 'f12,f14,f2,f3,f62,f104,f105,f128,f136,f140,f141');
+    url.searchParams.set('ut', 'b2884a393a59ad64002292a3e90d46a5');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `sectors failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no sector data');
+
+    return diff.slice(0, limit).map((it, i) => ({
+      rank: i + 1,
+      code: it.f12,
+      name: it.f14,
+      price: it.f2,
+      changePercent: it.f3,
+      mainNet: it.f62,
+      leadStock: it.f128,
+      leadChangePercent: it.f136,
+      upCount: it.f104,
+      downCount: it.f105,
+    }));
+  },
+});

package/clis/google-scholar/search.js

@@ -0,0 +1,58 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
+
+cli({
+    site: 'google-scholar',
+    name: 'search',
+    description: 'Google Scholar 学术搜索',
+    domain: 'scholar.google.com',
+    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', 'authors', 'source', 'year', 'cited', 'url'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const limit = clampInt(kwargs.limit, 10, 1, 20);
+        const query = requireNonEmptyQuery(kwargs.query);
+        await page.goto(`https://scholar.google.com/scholar?q=${encodeURIComponent(query)}&hl=zh-CN`);
+        await page.wait(3);
+        const data = await page.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const results = [];
+        for (const el of document.querySelectorAll('.gs_r.gs_or.gs_scl, .gs_ri')) {
+          const container = el.querySelector('.gs_ri') || el;
+          const titleEl = container.querySelector('.gs_rt a, h3 a');
+          const title = normalize(titleEl?.textContent);
+          if (!title) continue;
+
+          const url = titleEl?.getAttribute('href') || '';
+          const infoLine = normalize(container.querySelector('.gs_a')?.textContent);
+          const parts = infoLine.split(' - ');
+          const authors = (parts[0] || '').trim();
+          const sourceParts = (parts[1] || '').split(',');
+          const source = sourceParts.slice(0, -1).join(',').trim() || sourceParts[0]?.trim() || '';
+          const year = infoLine.match(/(19|20)\\d{2}/)?.[0] || '';
+          const citedText = normalize(container.querySelector('.gs_fl a[href*="cites"]')?.textContent);
+          const cited = citedText.match(/(\\d+)/)?.[1] || '0';
+
+          results.push({
+            rank: results.length + 1,
+            title,
+            authors: authors.slice(0, 80),
+            source: source.slice(0, 60),
+            year,
+            cited,
+            url,
+          });
+          if (results.length >= ${limit}) break;
+        }
+        return results;
+      })()
+    `);
+        return Array.isArray(data) ? data : [];
+    },
+});

package/clis/google-scholar/search.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './search.js';
+
+describe('google-scholar search command', () => {
+    const command = getRegistry().get('google-scholar/search');
+
+    it('registers as a public browser command', () => {
+        expect(command).toBeDefined();
+        expect(command.site).toBe('google-scholar');
+        expect(command.strategy).toBe('public');
+        expect(command.browser).toBe(true);
+    });
+
+    it('rejects empty queries before browser navigation', async () => {
+        const page = { goto: vi.fn() };
+        await expect(command.func(page, { query: '   ' })).rejects.toMatchObject({
+            name: 'ArgumentError',
+            code: 'ARGUMENT',
+        });
+        expect(page.goto).not.toHaveBeenCalled();
+    });
+});

package/clis/gov-law/commands.test.js

@@ -0,0 +1,39 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './search.js';
+import './recent.js';
+
+describe('gov-law commands', () => {
+    const search = getRegistry().get('gov-law/search');
+    const recent = getRegistry().get('gov-law/recent');
+
+    it('registers both commands as public browser commands', () => {
+        expect(search).toBeDefined();
+        expect(recent).toBeDefined();
+        expect(search.strategy).toBe('public');
+        expect(recent.strategy).toBe('public');
+        expect(search.browser).toBe(true);
+        expect(recent.browser).toBe(true);
+    });
+
+    it('rejects empty search queries before browser navigation', async () => {
+        const page = { goto: vi.fn() };
+        await expect(search.func(page, { query: '   ' })).rejects.toMatchObject({
+            name: 'ArgumentError',
+            code: 'ARGUMENT',
+        });
+        expect(page.goto).not.toHaveBeenCalled();
+    });
+
+    it('throws a descriptive error when Vue Router is unavailable', async () => {
+        const page = {
+            goto: vi.fn(),
+            wait: vi.fn(),
+            evaluate: vi.fn().mockResolvedValue(false),
+        };
+        await expect(recent.func(page, { limit: 3 })).rejects.toMatchObject({
+            name: 'CliError',
+            code: 'FRAMEWORK_CHANGED',
+        });
+    });
+});

package/clis/gov-law/recent.js

@@ -0,0 +1,22 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt } from '../_shared/common.js';
+import { extractLawResults, navigateViaVueRouter } from './shared.js';
+
+cli({
+    site: 'gov-law',
+    name: 'recent',
+    description: '最新法律法规',
+    domain: 'flk.npc.gov.cn',
+    strategy: Strategy.PUBLIC,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
+    ],
+    columns: ['rank', 'title', 'status', 'publish_date', 'type', 'department'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const limit = clampInt(kwargs.limit, 10, 1, 20);
+        await navigateViaVueRouter(page, {});
+        return extractLawResults(page, limit);
+    },
+});

package/clis/gov-law/search.js

@@ -0,0 +1,41 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
+import { extractLawResults, navigateViaVueRouter } from './shared.js';
+
+cli({
+    site: 'gov-law',
+    name: 'search',
+    description: '国家法律法规数据库搜索',
+    domain: 'flk.npc.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', 'status', 'publish_date', 'type', 'department'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const limit = clampInt(kwargs.limit, 10, 1, 20);
+        const query = requireNonEmptyQuery(kwargs.query);
+        await navigateViaVueRouter(page, { searchWord: query });
+
+        const encodedQuery = JSON.stringify(query);
+        await page.evaluate(`
+      (async () => {
+        const input = document.querySelector('.el-input__inner');
+        if (input && !input.value) {
+          const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
+          setter.call(input, ${encodedQuery});
+          input.dispatchEvent(new Event('input', { bubbles: true }));
+          input.dispatchEvent(new Event('change', { bubbles: true }));
+          await new Promise(r => setTimeout(r, 300));
+          input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', keyCode: 13, bubbles: true }));
+          input.dispatchEvent(new KeyboardEvent('keyup', { key: 'Enter', keyCode: 13, bubbles: true }));
+        }
+      })()
+    `);
+        await page.wait(3);
+        return extractLawResults(page, limit);
+    },
+});

package/clis/gov-law/shared.js

@@ -0,0 +1,51 @@
+import { CliError } from '@jackwener/opencli/errors';
+
+export async function navigateViaVueRouter(page, query) {
+    await page.goto('https://flk.npc.gov.cn/index.html');
+    await page.wait(4);
+
+    const routerAvailable = await page.evaluate(`
+      (async () => {
+        const app = document.querySelector('#app');
+        const router = app?.__vue_app__?.config?.globalProperties?.$router;
+        if (!router) return false;
+        await router.push({ path: '/search', query: ${JSON.stringify(query)} });
+        return true;
+      })()
+    `);
+
+    if (!routerAvailable) {
+        throw new CliError(
+            'FRAMEWORK_CHANGED',
+            'Could not access Vue Router on flk.npc.gov.cn — the site may have been restructured.',
+            'Please report this issue so the adapter can be updated.',
+        );
+    }
+
+    await page.wait(5);
+}
+
+export async function extractLawResults(page, limit) {
+    const data = await page.evaluate(`
+      (async () => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        for (let i = 0; i < 40; i++) {
+          if (document.querySelectorAll('.result-item').length > 0) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+        const results = [];
+        for (const el of document.querySelectorAll('.result-item')) {
+          const title = normalize(el.querySelector('.title-content')?.textContent);
+          if (!title) continue;
+          const status = normalize(el.querySelector('[class*="status"]')?.textContent);
+          const publish_date = normalize(el.querySelector('.publish-time')?.textContent).replace(/^公布日期[：:]\\s*/, '');
+          const type = normalize(el.querySelector('.type')?.textContent);
+          const department = normalize(el.querySelector('.department')?.textContent);
+          results.push({ rank: results.length + 1, title, status, publish_date, type, department });
+          if (results.length >= ${limit}) break;
+        }
+        return results;
+      })()
+    `);
+    return Array.isArray(data) ? data : [];
+}