@jackwener/opencli 1.7.3 → 1.7.5

package/clis/doubao/utils.test.js

@@ -1,5 +1,41 @@
-import { describe, expect, it } from 'vitest';
-import { mergeTranscriptSnapshots, parseDoubaoConversationId } from './utils.js';
+import { describe, expect, it, vi } from 'vitest';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
+import {
+    __test__,
+    collectDoubaoTranscriptAdditions,
+    mergeTranscriptSnapshots,
+    parseDoubaoConversationId,
+    sendDoubaoMessage,
+    waitForDoubaoResponse,
+} from './utils.js';
+
+function createPageMock() {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn(),
+        getCookies: vi.fn().mockResolvedValue([]),
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        scrollTo: vi.fn().mockResolvedValue(undefined),
+        getFormState: vi.fn().mockResolvedValue({}),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        selectTab: vi.fn().mockResolvedValue(undefined),
+        networkRequests: vi.fn().mockResolvedValue([]),
+        consoleMessages: vi.fn().mockResolvedValue([]),
+        scroll: vi.fn().mockResolvedValue(undefined),
+        autoScroll: vi.fn().mockResolvedValue(undefined),
+        installInterceptor: vi.fn().mockResolvedValue(undefined),
+        getInterceptedRequests: vi.fn().mockResolvedValue([]),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
+        screenshot: vi.fn().mockResolvedValue(''),
+        nativeType: vi.fn().mockResolvedValue(undefined),
+        nativeKeyPress: vi.fn().mockResolvedValue(undefined),
+    };
+}
+
 describe('parseDoubaoConversationId', () => {
     it('extracts the numeric id from a full conversation URL', () => {
         expect(parseDoubaoConversationId('https://www.doubao.com/chat/1234567890123')).toBe('1234567890123');
@@ -8,6 +44,209 @@ describe('parseDoubaoConversationId', () => {
         expect(parseDoubaoConversationId('1234567890123')).toBe('1234567890123');
     });
 });
+describe('doubao send strategy', () => {
+    it('prefers native CDP text insertion and button submission when a send button is available', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        const nativeType = vi.mocked(page.nativeType);
+        const nativeKeyPress = vi.mocked(page.nativeKeyPress);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce(true)
+            .mockResolvedValueOnce({ detected: false });
+        const result = await sendDoubaoMessage(page, '你好');
+        expect(nativeType).toHaveBeenCalledWith('你好');
+        expect(nativeKeyPress).not.toHaveBeenCalled();
+        expect(result).toBe('button');
+    });
+    it('falls back to DOM insertion when native insertion does not update the composer', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        const nativeType = vi.mocked(page.nativeType);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: false, text: '' })
+            .mockResolvedValueOnce({ hasText: false, text: '' })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce(true)
+            .mockResolvedValueOnce({ detected: false });
+        const result = await sendDoubaoMessage(page, '你好');
+        expect(nativeType).toHaveBeenCalledWith('你好');
+        expect(evaluate).toHaveBeenCalledTimes(7);
+        expect(result).toBe('button');
+    });
+    it('falls back to DOM insertion when native insertion text does not match the requested prompt', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: true, text: '你' })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce(true)
+            .mockResolvedValueOnce({ detected: false });
+        const result = await sendDoubaoMessage(page, '你好');
+        expect(result).toBe('button');
+    });
+    it('falls back to native Enter when no clickable submit button is found', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        const nativeKeyPress = vi.mocked(page.nativeKeyPress);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce(false)
+            .mockResolvedValueOnce({ detected: false });
+        const result = await sendDoubaoMessage(page, '你好');
+        expect(nativeKeyPress).toHaveBeenCalledWith('Enter');
+        expect(result).toBe('enter');
+    });
+    it('does not throw verification errors just because the prompt mentions verification terms', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: true, text: '请解释 CAPTCHA verification 是什么' })
+            .mockResolvedValueOnce({ hasText: true, text: '请解释 CAPTCHA verification 是什么' })
+            .mockResolvedValueOnce(true)
+            .mockResolvedValueOnce({ detected: false, reason: '' });
+        await expect(sendDoubaoMessage(page, '请解释 CAPTCHA verification 是什么')).resolves.toBe('button');
+    });
+    it('does not throw verification errors for ordinary chinese prompts mentioning security terms', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: true, text: '请解释人机验证和完成安全验证的区别' })
+            .mockResolvedValueOnce({ hasText: true, text: '请解释人机验证和完成安全验证的区别' })
+            .mockResolvedValueOnce(true)
+            .mockResolvedValueOnce({ detected: false, reason: '' });
+        await expect(sendDoubaoMessage(page, '请解释人机验证和完成安全验证的区别')).resolves.toBe('button');
+    });
+    it('throws a command error when Doubao shows a verification challenge after submit', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        evaluate
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce({ ok: true })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce({ hasText: true, text: '你好' })
+            .mockResolvedValueOnce(true)
+            .mockResolvedValueOnce({ detected: true, reason: '请完成安全验证' });
+        await expect(sendDoubaoMessage(page, '你好')).rejects.toBeInstanceOf(CommandExecutionError);
+    });
+});
+describe('collectDoubaoTranscriptAdditions', () => {
+    it('ignores landing-page capability chips that are not assistant content', () => {
+        const before = ['older'];
+        const current = [
+            'older',
+            '测试一下，只回复OK快速视频生成深入研究图像生成帮我写作音乐生成更多',
+            '测试一下，只回复OK',
+        ];
+        expect(collectDoubaoTranscriptAdditions(before, current, '测试一下，只回复OK')).toBe('');
+    });
+    it('filters prompt-contaminated chip lines for arbitrary prompts', () => {
+        const before = ['older'];
+        const current = [
+            'older',
+            '你好快速视频生成深入研究图像生成帮我写作音乐生成更多',
+        ];
+        expect(collectDoubaoTranscriptAdditions(before, current, '你好')).toBe('');
+    });
+    it('filters whitespace-normalized multiline prompt echoes and prompt-plus-chip artifacts', () => {
+        const before = ['older'];
+        const prompt = '第一行\n第二行';
+        expect(collectDoubaoTranscriptAdditions(before, ['older', '第一行 第二行'], prompt)).toBe('');
+        expect(collectDoubaoTranscriptAdditions(before, ['older', '第一行 第二行快速视频生成深入研究图像生成帮我写作音乐生成更多'], prompt)).toBe('');
+    });
+    it('keeps legitimate replies that discuss Doubao features', () => {
+        const before = ['older'];
+        const current = [
+            'older',
+            '图像生成和音乐生成目前都支持，但适用场景不同。',
+        ];
+        expect(collectDoubaoTranscriptAdditions(before, current, 'irrelevant prompt')).toBe('图像生成和音乐生成目前都支持，但适用场景不同。');
+    });
+    it('keeps an exact chip string when it is the assistant reply rather than prompt contamination', () => {
+        const before = ['older'];
+        const current = [
+            'older',
+            '快速视频生成深入研究图像生成帮我写作音乐生成更多',
+        ];
+        expect(collectDoubaoTranscriptAdditions(before, current, '测试一下，只回复OK')).toBe('快速视频生成深入研究图像生成帮我写作音乐生成更多');
+    });
+    it('filters combined sidebar chrome that appears as a new transcript line', () => {
+        const before = ['older'];
+        const current = [
+            'older',
+            'AI 创作云盘更多历史对话',
+        ];
+        expect(collectDoubaoTranscriptAdditions(before, current, '测试一下，只回复OK')).toBe('');
+    });
+    it('filters transcript lines that only differ because the prompt was appended to existing page chrome', () => {
+        const before = [
+            '有什么我能帮你的吗？资讯：韩国三大运营商允许超流量用基本数据服务快速视频生成深入研究图像生成帮我写作音乐生成更多',
+        ];
+        const current = [
+            '有什么我能帮你的吗？资讯：韩国三大运营商允许超流量用基本数据服务快速视频生成深入研究图像生成帮我写作音乐生成更多测试一下，只回复OK',
+        ];
+        expect(collectDoubaoTranscriptAdditions(before, current, '测试一下，只回复OK', (value) => value.replace('测试一下，只回复OK', '').trim())).toBe('');
+    });
+    it('treats only the exact landing-page chip string as UI noise', () => {
+        expect(__test__.clickSendButtonScript()).not.toContain('document,');
+        expect(__test__.clickSendButtonScript()).toContain('bestScore >= 200');
+        expect(__test__.clickSendButtonScript()).not.toContain("|| !!button.closest('.chat-input-button')");
+        expect(__test__.clickSendButtonScript()).toContain("button.getAttribute('type') === 'submit') score += 1200");
+        expect(__test__.composerStateScript()).toContain("(composer.innerText || '').trim() || (composer.textContent || '').trim()");
+        expect(__test__.detectDoubaoVerificationScript()).not.toContain('document.body?.innerText');
+        expect(__test__.detectDoubaoVerificationScript()).not.toContain('[class*=\"verify\"]');
+        expect(__test__.detectDoubaoVerificationScript()).not.toContain('[class*=\"captcha\"]');
+        expect(__test__.detectDoubaoVerificationScript()).not.toContain('document.body?.children');
+    });
+});
+describe('waitForDoubaoResponse', () => {
+    it('allows transcript fallback on local chat urls when new transcript lines appear', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        const wait = vi.mocked(page.wait);
+        evaluate
+            .mockResolvedValueOnce({ detected: false })
+            .mockResolvedValueOnce('https://www.doubao.com/chat/local_123')
+            .mockResolvedValueOnce([])
+            .mockResolvedValueOnce('https://www.doubao.com/chat/local_123')
+            .mockResolvedValueOnce(['older', '真正的回答']);
+        const result = await waitForDoubaoResponse(page, ['older'], [], '测试一下，只回复OK', 2);
+        expect(wait).toHaveBeenCalled();
+        expect(result).toBe('真正的回答');
+    });
+    it('does not suppress assistant turns that happen to match landing-page chip text', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        evaluate
+            .mockResolvedValueOnce({ detected: false })
+            .mockResolvedValueOnce('https://www.doubao.com/chat')
+            .mockResolvedValueOnce([
+            { Role: 'Assistant', Text: '快速视频生成深入研究图像生成帮我写作音乐生成更多' },
+        ]);
+        const result = await waitForDoubaoResponse(page, [], [], '测试一下，只回复OK', 2);
+        expect(result).toBe('快速视频生成深入研究图像生成帮我写作音乐生成更多');
+    });
+    it('raises a command error when a verification challenge appears during polling', async () => {
+        const page = createPageMock();
+        const evaluate = vi.mocked(page.evaluate);
+        evaluate.mockResolvedValueOnce({ detected: true, reason: '请完成安全验证' });
+        await expect(waitForDoubaoResponse(page, [], [], '你好', 2)).rejects.toBeInstanceOf(CommandExecutionError);
+    });
+});
 describe('mergeTranscriptSnapshots', () => {
     it('extends the transcript when the next snapshot overlaps with the tail', () => {
         const merged = mergeTranscriptSnapshots('Alice 00:00\nHello team\nBob 00:05\nHi', 'Bob 00:05\nHi\nAlice 00:10\nNext topic');

package/clis/eastmoney/_secid.js

@@ -0,0 +1,78 @@
+// Shared helpers for resolving eastmoney "secid" (市场.代码).
+//
+// Markets:
+//   1.XXXXXX → Shanghai A (SSE)
+//   0.XXXXXX → Shenzhen A (SZSE) or Beijing (BSE) — eastmoney groups both under 0
+//   116.XXXXX → Hong Kong
+//   105.SYMBOL → NASDAQ
+//   106.SYMBOL → NYSE
+//   107.SYMBOL → AMEX (US)
+
+const A_PREFIX_TO_MARKET = /** @param {string} c */ (c) => {
+  if (/^(60|68|90|113|900)/.test(c)) return '1';          // SH (A + STAR + old B)
+  if (/^(00|30|20)/.test(c)) return '0';                  // SZ (A + ChiNext + B)
+  if (/^(4|8|920|83|87)/.test(c)) return '0';             // BJ (eastmoney uses 0.)
+  return '0';
+};
+
+/**
+ * Resolve various user inputs to an eastmoney `secid`.
+ *  - "600000"         → "1.600000"
+ *  - "sh600000"       → "1.600000"
+ *  - "sz000001"       → "0.000001"
+ *  - "bj430047"       → "0.430047"
+ *  - "hk00700" / "00700.HK" → "116.00700"
+ *  - "us.AAPL" / "AAPL" → "105.AAPL"
+ *  - "1.600000"       → passed through
+ * @param {string} input
+ * @returns {string}
+ */
+// Known eastmoney market numeric prefixes. Narrow whitelist so that inputs like
+// "00700.HK" are NOT mistakenly treated as secids just because they look like
+// "<digits>.<alphanumeric>".
+const KNOWN_MARKET_PREFIXES = new Set(['0', '1', '100', '105', '106', '107', '116', '140', '150', '151', '152', '155', '156']);
+
+export function resolveSecid(input) {
+  const raw = String(input || '').trim();
+  if (!raw) throw new Error('empty symbol');
+  const secidMatch = raw.match(/^(\d{1,3})\.([A-Za-z0-9]+)$/);
+  if (secidMatch && KNOWN_MARKET_PREFIXES.has(secidMatch[1])) return raw; // already a secid
+  const lower = raw.toLowerCase();
+
+  // market-prefixed Chinese code
+  const pref = lower.match(/^(sh|sz|bj)(\d{6})$/);
+  if (pref) {
+    const [, mk, code] = pref;
+    return (mk === 'sh' ? '1' : '0') + '.' + code;
+  }
+
+  // hk prefix
+  const hk = lower.match(/^hk(\d{4,5})$/) || lower.match(/^(\d{4,5})\.hk$/);
+  if (hk) return '116.' + hk[1].padStart(5, '0');
+
+  // us.SYMBOL or SYMBOL.N/.O  (treat all as NASDAQ by default; .N as NYSE)
+  const usDot = lower.match(/^([a-z.\-]+)\.([no])$/);
+  if (usDot) return (usDot[2] === 'n' ? '106' : '105') + '.' + usDot[1].toUpperCase();
+  const usPref = lower.match(/^us\.([a-z.\-]+)$/);
+  if (usPref) return '105.' + usPref[1].toUpperCase();
+
+  // bare 6-digit Chinese code
+  if (/^\d{6}$/.test(raw)) return A_PREFIX_TO_MARKET(raw) + '.' + raw;
+
+  // bare US ticker — uppercase letters only
+  if (/^[A-Z.\-]{1,8}$/.test(raw)) return '105.' + raw;
+
+  throw new Error(`Unrecognized symbol: ${input}`);
+}
+
+/**
+ * Normalize a list of user inputs separated by comma / space / Chinese comma.
+ * @param {string} s
+ * @returns {string[]}
+ */
+export function splitSymbols(s) {
+  return String(s || '')
+    .split(/[,，\s]+/)
+    .map((x) => x.trim())
+    .filter(Boolean);
+}

package/clis/eastmoney/announcement.js

@@ -0,0 +1,52 @@
+// eastmoney announcement — listed company filings/announcements feed.
+//
+//   opencli eastmoney announcement
+//   opencli eastmoney announcement --market SHA --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+cli({
+  site: 'eastmoney',
+  name: 'announcement',
+  description: '上市公司公告（按交易所筛选）',
+  domain: 'np-anotice-stock.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'market', type: 'string', default: 'SHA,SZA,BJA', help: '交易所：SHA (沪) / SZA (深) / BJA (北) 可逗号分隔' },
+    { name: 'limit',  type: 'int',    default: 20,            help: '返回数量 (max 100)' },
+  ],
+  columns: ['time', 'code', 'name', 'title', 'category', 'url'],
+  func: async (_page, args) => {
+    const market = String(args.market ?? 'SHA,SZA,BJA').trim() || 'SHA,SZA,BJA';
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const url = new URL('https://np-anotice-stock.eastmoney.com/api/security/ann');
+    url.searchParams.set('page_size', String(limit));
+    url.searchParams.set('page_index', '1');
+    url.searchParams.set('ann_type', market);
+    url.searchParams.set('client_source', 'web');
+    url.searchParams.set('f_node', '0');
+    url.searchParams.set('s_node', '0');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `announcement failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const list = Array.isArray(data?.data?.list) ? data.data.list : [];
+    if (list.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no announcement data');
+
+    return list.slice(0, limit).map((it) => {
+      const primary = Array.isArray(it.codes) && it.codes.length > 0 ? it.codes[0] : {};
+      const cat = Array.isArray(it.columns) && it.columns.length > 0 ? it.columns[0]?.column_name : '';
+      return {
+        time: String(it.notice_date || it.display_time || '').slice(0, 19),
+        code: primary.stock_code || '',
+        name: primary.short_name || '',
+        title: it.title || it.title_ch || '',
+        category: cat || '',
+        url: `https://data.eastmoney.com/notices/detail/${primary.stock_code || ''}/${it.art_code || ''}.html`,
+      };
+    });
+  },
+});

package/clis/eastmoney/convertible.js

@@ -0,0 +1,73 @@
+// eastmoney convertible — on-market convertible bond listing.
+//
+//   opencli eastmoney convertible
+//   opencli eastmoney convertible --sort premium --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const SORTS = {
+  change:   { fid: 'f3',   order: 'desc' },
+  drop:     { fid: 'f3',   order: 'asc' },
+  turnover: { fid: 'f6',   order: 'desc' },
+  price:    { fid: 'f2',   order: 'desc' },
+  premium:  { fid: 'f237', order: 'desc' }, // 转股溢价率
+  value:    { fid: 'f236', order: 'desc' }, // 转股价值
+  ytm:      { fid: 'f239', order: 'desc' }, // 到期收益率
+};
+
+cli({
+  site: 'eastmoney',
+  name: 'convertible',
+  description: '可转债行情列表（默认按成交额排序）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'sort',  type: 'string', default: 'turnover', help: '排序：turnover / change / drop / price / premium' },
+    { name: 'limit', type: 'int',    default: 20,         help: '返回数量 (max 100)' },
+  ],
+  columns: ['rank', 'bondCode', 'bondName', 'bondPrice', 'bondChangePct', 'stockCode', 'stockName', 'stockPrice', 'stockChangePct', 'convPrice', 'convValue', 'convPremiumPct', 'remainingYears', 'ytm', 'listDate'],
+  func: async (_page, args) => {
+    const sortKey = String(args.sort ?? 'turnover').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', 'b:MK0354');
+    url.searchParams.set('fields', 'f12,f14,f2,f3,f6,f229,f230,f232,f234,f235,f236,f237,f238,f239,f243');
+    url.searchParams.set('ut', 'bd1d9ddb04089700cf9c27f6f7426281');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `convertible 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 convertible data');
+
+    return diff.slice(0, limit).map((it, i) => ({
+      rank: i + 1,
+      bondCode: it.f12,
+      bondName: it.f14,
+      bondPrice: it.f2,
+      bondChangePct: it.f3,
+      stockCode: it.f232,
+      stockName: it.f234,
+      stockPrice: it.f229,
+      stockChangePct: it.f230,
+      convPrice: it.f235,
+      convValue: it.f236,
+      convPremiumPct: it.f237,
+      remainingYears: it.f238,
+      ytm: it.f239,
+      listDate: String(it.f243 ?? ''),
+    }));
+  },
+});

package/clis/eastmoney/etf.js

@@ -0,0 +1,65 @@
+// eastmoney etf — ETF ranking by change / turnover.
+//
+//   opencli eastmoney etf
+//   opencli eastmoney etf --sort change --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const SORTS = {
+  turnover: { fid: 'f6', order: 'desc' },
+  change:   { fid: 'f3', order: 'desc' },
+  drop:     { fid: 'f3', order: 'asc' },
+  volume:   { fid: 'f5', order: 'desc' },
+  rate:     { fid: 'f8', order: 'desc' },
+};
+
+cli({
+  site: 'eastmoney',
+  name: 'etf',
+  description: 'ETF 列表按成交额/涨跌幅排行',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'sort', type: 'string', default: 'turnover', help: '排序：turnover / change / drop / volume / rate' },
+    { name: 'limit', type: 'int',   default: 20,         help: '返回数量 (max 100)' },
+  ],
+  columns: ['rank', 'code', 'name', 'price', 'changePercent', 'change', 'turnover', 'volume', 'turnoverRate'],
+  func: async (_page, args) => {
+    const sortKey = String(args.sort ?? 'turnover').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', 'b:MK0021'); // 场内ETF
+    url.searchParams.set('fields', 'f12,f14,f2,f3,f4,f5,f6,f8');
+    url.searchParams.set('ut', 'bd1d9ddb04089700cf9c27f6f7426281');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `etf 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 ETF data');
+
+    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,
+    }));
+  },
+});

package/clis/eastmoney/holders.js

@@ -0,0 +1,78 @@
+// eastmoney holders — top-10 float shareholders of an A-share (F10 data).
+//
+//   opencli eastmoney holders 600519
+//   opencli eastmoney holders sh600519 --limit 10
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+/**
+ * Convert a bare A-share symbol to eastmoney's SECUCODE form ("600519.SH").
+ * Accepts "600519", "sh600519", "sz000001", "bj430047", or full "600519.SH".
+ * @param {string} input
+ * @returns {string}
+ */
+function toSecucode(input) {
+  const raw = String(input || '').trim().toUpperCase();
+  if (/^\d{6}\.(SH|SZ|BJ)$/.test(raw)) return raw;
+  const pref = raw.match(/^(SH|SZ|BJ)(\d{6})$/);
+  if (pref) return `${pref[2]}.${pref[1]}`;
+  if (/^\d{6}$/.test(raw)) {
+    if (/^(60|68|90|113|900)/.test(raw)) return `${raw}.SH`;
+    if (/^(4|8|920|83|87)/.test(raw))    return `${raw}.BJ`;
+    return `${raw}.SZ`;
+  }
+  throw new Error(`Unrecognized A-share symbol: ${input}`);
+}
+
+cli({
+  site: 'eastmoney',
+  name: 'holders',
+  description: '十大流通股东（A股 F10 数据）',
+  domain: 'datacenter-web.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', required: true, positional: true, help: 'A股代码（600519 / sh600519 等）' },
+    { name: 'limit',  type: 'int',    default: 10,      help: '返回股东数（默认十大流通股东）' },
+  ],
+  columns: ['rank', 'reportDate', 'name', 'holdNum', 'floatRatio', 'change'],
+  func: async (_page, args) => {
+    /** @type {string} */
+    let secucode;
+    try { secucode = toSecucode(args.symbol); }
+    catch (err) { throw new CliError('INVALID_ARGUMENT', `${err instanceof Error ? err.message : err}`); }
+    const limit = Math.max(1, Math.min(Number(args.limit) || 10, 50));
+
+    const url = new URL('https://datacenter-web.eastmoney.com/api/data/v1/get');
+    url.searchParams.set('sortColumns', 'END_DATE,HOLDER_RANK');
+    url.searchParams.set('sortTypes', '-1,1');
+    url.searchParams.set('pageSize', String(Math.max(limit, 10)));
+    url.searchParams.set('pageNumber', '1');
+    url.searchParams.set('reportName', 'RPT_F10_EH_FREEHOLDERS');
+    url.searchParams.set('columns', 'SECUCODE,SECURITY_CODE,END_DATE,HOLDER_RANK,HOLDER_NAME,HOLD_NUM,FREE_HOLDNUM_RATIO,HOLD_NUM_CHANGE');
+    url.searchParams.set('source', 'HSF10');
+    url.searchParams.set('client', 'PC');
+    url.searchParams.set('filter', `(SECUCODE="${secucode}")`);
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `holders failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const rows = Array.isArray(data?.result?.data) ? data.result.data : [];
+    if (rows.length === 0) throw new CliError('NO_DATA', `No shareholder data for ${secucode}`);
+
+    // Only the most recent reporting period
+    const latest = String(rows[0].END_DATE || '').slice(0, 10);
+    return rows
+      .filter((it) => String(it.END_DATE || '').slice(0, 10) === latest)
+      .slice(0, limit)
+      .map((it) => ({
+        rank: it.HOLDER_RANK,
+        reportDate: latest,
+        name: it.HOLDER_NAME,
+        holdNum: it.HOLD_NUM,
+        floatRatio: it.FREE_HOLDNUM_RATIO,
+        change: it.HOLD_NUM_CHANGE,
+      }));
+  },
+});

package/clis/eastmoney/hot-rank.js

@@ -0,0 +1,50 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'eastmoney',
+  name: 'hot-rank',
+  description: '东方财富热股榜',
+  domain: 'guba.eastmoney.com',
+  strategy: Strategy.COOKIE,
+  navigateBefore: true,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: '返回数量' },
+  ],
+  columns: ['rank', 'symbol', 'name', 'price', 'changePercent', 'heat', 'url'],
+  func: async (page, kwargs) => {
+    await page.goto('https://guba.eastmoney.com/rank/');
+    await page.wait({ selector: '#rankCont', timeout: 15000 });
+    const data = await page.evaluate(`
+      (() => {
+        const cleanText = (el) => (el?.textContent || '').replace(/\\s+/g, ' ').trim();
+        const rows = document.querySelectorAll('table.rank_table tbody tr');
+        const results = [];
+        const seen = new Set();
+        let rank = 0;
+        rows.forEach((row) => {
+          const codeEl = row.querySelector('a.stock_code');
+          const href = codeEl?.getAttribute('href') || '';
+          const symbolMatch = href.match(/(\\d{6})/);
+          if (!symbolMatch) return;
+          const symbol = symbolMatch[1];
+          if (seen.has(symbol)) return;
+          seen.add(symbol);
+          rank++;
+          const tds = row.querySelectorAll('td');
+          results.push({
+            rank,
+            symbol,
+            name: row.querySelector('td.nametd a[title]')?.getAttribute('title') || cleanText(row.querySelector('td.nametd')),
+            price: tds[6] ? cleanText(tds[6]) : '',
+            changePercent: tds[8] ? cleanText(tds[8]) : '',
+            heat: cleanText(row.querySelector('td.fans')),
+            url: 'https://guba.eastmoney.com/list,' + symbol + '.html',
+          });
+        });
+        return results;
+      })()
+    `);
+    if (!Array.isArray(data)) return [];
+    return data.slice(0, kwargs.limit);
+  },
+});