@jackwener/opencli 1.7.4 → 1.7.6

package/clis/deepseek/utils.js

@@ -0,0 +1,291 @@
+export const DEEPSEEK_DOMAIN = 'chat.deepseek.com';
+export const DEEPSEEK_URL = 'https://chat.deepseek.com/';
+export const TEXTAREA_SELECTOR = 'textarea[placeholder*="DeepSeek"]';
+export const MESSAGE_SELECTOR = '.ds-message';
+
+export async function isOnDeepSeek(page) {
+    const url = await page.evaluate('window.location.href').catch(() => '');
+    if (typeof url !== 'string' || !url) return false;
+    try {
+        const h = new URL(url).hostname;
+        return h === 'deepseek.com' || h.endsWith('.deepseek.com');
+    } catch {
+        return false;
+    }
+}
+
+export async function ensureOnDeepSeek(page) {
+    if (!(await isOnDeepSeek(page))) {
+        await page.goto(DEEPSEEK_URL);
+        await page.wait(3);
+    }
+}
+
+export async function getPageState(page) {
+    return page.evaluate(`(() => {
+        const url = window.location.href;
+        const title = document.title;
+        const textarea = document.querySelector('${TEXTAREA_SELECTOR}');
+        const avatar = document.querySelector('img[src*="user-avatar"]');
+        return {
+            url,
+            title,
+            hasTextarea: !!textarea,
+            isLoggedIn: !!avatar,
+        };
+    })()`);
+}
+
+export async function selectModel(page, modelName) {
+    return page.evaluate(`(() => {
+        const radios = document.querySelectorAll('div[role="radio"]');
+        for (const radio of radios) {
+            const span = radio.querySelector('span');
+            if (span && span.textContent.trim().toLowerCase() === '${modelName}'.toLowerCase()) {
+                const alreadySelected = radio.getAttribute('aria-checked') === 'true';
+                if (!alreadySelected) radio.click();
+                return { ok: true, toggled: !alreadySelected };
+            }
+        }
+        return { ok: false };
+    })()`);
+}
+
+export async function setFeature(page, featureName, enabled) {
+    return page.evaluate(`(() => {
+        const btns = document.querySelectorAll('div[role="button"]');
+        for (const btn of btns) {
+            const span = btn.querySelector('span');
+            if (span && span.textContent.trim() === '${featureName}') {
+                const isActive = btn.classList.contains('ds-toggle-button--selected');
+                if (${enabled} !== isActive) btn.click();
+                return { ok: true, toggled: ${enabled} !== isActive };
+            }
+        }
+        return { ok: false };
+    })()`);
+}
+
+export async function sendMessage(page, prompt) {
+    const promptJson = JSON.stringify(prompt);
+    return page.evaluate(`(async () => {
+        const box = document.querySelector('${TEXTAREA_SELECTOR}');
+        if (!box) return { ok: false, reason: 'textarea not found' };
+
+        box.focus();
+        box.value = '';
+        document.execCommand('selectAll');
+        document.execCommand('insertText', false, ${promptJson});
+        await new Promise(r => setTimeout(r, 800));
+
+        const btns = document.querySelectorAll('div[role="button"]');
+        for (const btn of btns) {
+            if (btn.getAttribute('aria-disabled') === 'false') {
+                const svgs = btn.querySelectorAll('svg');
+                if (svgs.length > 0 && btn.closest('div')?.querySelector('textarea')) {
+                    btn.click();
+                    return { ok: true };
+                }
+            }
+        }
+
+        box.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+        return { ok: true, method: 'enter' };
+    })()`);
+}
+
+export async function getBubbleCount(page) {
+    const count = await page.evaluate(`(() => {
+        return document.querySelectorAll('${MESSAGE_SELECTOR}').length;
+    })()`);
+    return count || 0;
+}
+
+export async function waitForResponse(page, baselineCount, prompt, timeoutMs) {
+    const startTime = Date.now();
+    let lastText = '';
+    let stableCount = 0;
+
+    while (Date.now() - startTime < timeoutMs) {
+        await page.wait(3);
+
+        let result;
+        try {
+            result = await page.evaluate(`(() => {
+                const bubbles = document.querySelectorAll('${MESSAGE_SELECTOR}');
+                const texts = Array.from(bubbles).map(b => (b.innerText || '').trim()).filter(Boolean);
+                return { count: texts.length, last: texts[texts.length - 1] || '' };
+            })()`);
+        } catch {
+            continue;
+        }
+
+        if (!result) continue;
+
+        const candidate = result.last;
+        if (candidate && result.count > baselineCount && candidate !== prompt.trim()) {
+            if (candidate === lastText) {
+                stableCount++;
+                if (stableCount >= 3) return candidate;
+            } else {
+                stableCount = 0;
+            }
+            lastText = candidate;
+        }
+    }
+
+    return lastText || null;
+}
+
+export async function getVisibleMessages(page) {
+    const result = await page.evaluate(`(() => {
+        const msgs = document.querySelectorAll('${MESSAGE_SELECTOR}');
+        return Array.from(msgs).map(m => {
+            // User messages carry an extra hash-class alongside ds-message
+            const isUser = m.className.split(/\\s+/).length > 2;
+            return {
+                Role: isUser ? 'user' : 'assistant',
+                Text: (m.innerText || '').trim(),
+            };
+        }).filter(m => m.Text);
+    })()`);
+    return Array.isArray(result) ? result : [];
+}
+
+export async function getConversationList(page) {
+    await ensureOnDeepSeek(page);
+    // Expand sidebar if collapsed
+    await page.evaluate(`(() => {
+        if (document.querySelectorAll('a[href*="/a/chat/s/"]').length === 0) {
+            const btn = document.querySelector('div[tabindex="0"][role="button"]');
+            if (btn) btn.click();
+        }
+    })()`);
+    for (let attempt = 0; attempt < 5; attempt++) {
+        await page.wait(2);
+        const items = await page.evaluate(`(() => {
+            const items = [];
+            const links = document.querySelectorAll('a[href*="/a/chat/s/"]');
+            links.forEach((link, i) => {
+                const titleEl = link.querySelector('div');
+                const title = titleEl ? titleEl.textContent.trim() : '';
+                const href = link.getAttribute('href') || '';
+                const idMatch = href.match(/\\/s\\/([a-f0-9-]+)/);
+                items.push({
+                    Index: i + 1,
+                    Id: idMatch ? idMatch[1] : href,
+                    Title: title || '(untitled)',
+                    Url: 'https://chat.deepseek.com' + href,
+                });
+            });
+            return items;
+        })()`);
+        if (Array.isArray(items) && items.length > 0) return items;
+    }
+    return [];
+}
+
+async function waitForFilePreview(page, fileName) {
+    for (let attempt = 0; attempt < 8; attempt++) {
+        await page.wait(2);
+        const ready = await page.evaluate(`(() => {
+            const name = ${JSON.stringify(fileName)};
+            return Array.from(document.querySelectorAll('div'))
+                .some((el) => el.children.length === 0 && (el.textContent || '').trim() === name);
+        })()`);
+        if (ready) return true;
+    }
+    return false;
+}
+
+export async function sendWithFile(page, filePath, prompt) {
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const absPath = path.default.resolve(filePath);
+
+    if (!fs.default.existsSync(absPath)) {
+        return { ok: false, reason: `File not found: ${absPath}` };
+    }
+
+    const stats = fs.default.statSync(absPath);
+    if (stats.size > 100 * 1024 * 1024) {
+        return { ok: false, reason: `File too large (${(stats.size / 1024 / 1024).toFixed(1)} MB). Max: 100 MB` };
+    }
+
+    const fileName = path.default.basename(absPath);
+
+    // Collapse sidebar to keep DOM simple for send button matching
+    await page.evaluate(`(() => {
+        if (document.querySelectorAll('a[href*="/a/chat/s/"]').length > 0) {
+            const btn = document.querySelector('div[tabindex="0"][role="button"]');
+            if (btn) btn.click();
+        }
+    })()`);
+    await page.wait(0.5);
+
+    let uploaded = false;
+    if (page.setFileInput) {
+        try {
+            await page.setFileInput([absPath], 'input[type="file"]');
+            uploaded = true;
+        } catch (err) {
+            const msg = String(err?.message || err);
+            if (!msg.includes('Unknown action') && !msg.includes('not supported')) {
+                throw err;
+            }
+        }
+    }
+
+    if (!uploaded) {
+        const content = fs.default.readFileSync(absPath);
+        const base64 = content.toString('base64');
+        const fallbackResult = await page.evaluate(`(async () => {
+            var binary = atob('${base64}');
+            var bytes = new Uint8Array(binary.length);
+            for (var i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+
+            var file = new File([bytes], ${JSON.stringify(fileName)});
+            var dt = new DataTransfer();
+            dt.items.add(file);
+
+            var inp = document.querySelector('input[type="file"]');
+            if (!inp) return { ok: false, reason: 'file input not found' };
+
+            var propsKey = Object.keys(inp).find(function(k) { return k.startsWith('__reactProps$'); });
+            if (!propsKey || typeof inp[propsKey].onChange !== 'function') {
+                return { ok: false, reason: 'React onChange not found' };
+            }
+
+            inp.files = dt.files;
+            inp[propsKey].onChange({ target: { files: dt.files } });
+            return { ok: true };
+        })()`);
+        if (fallbackResult && !fallbackResult.ok) return fallbackResult;
+    }
+
+    const ready = await waitForFilePreview(page, fileName);
+    if (!ready) return { ok: false, reason: 'file preview did not appear' };
+
+    return sendMessage(page, prompt);
+}
+
+// Retries on CDP "Promise was collected" errors caused by DeepSeek's SPA router transitions.
+export async function withRetry(fn, retries = 2) {
+    for (let i = 0; i <= retries; i++) {
+        try {
+            return await fn();
+        } catch (err) {
+            const msg = String(err?.message || err);
+            if (i < retries && msg.includes('Promise was collected')) {
+                await new Promise(r => setTimeout(r, 2000));
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+
+export function parseBoolFlag(value) {
+    if (typeof value === 'boolean') return value;
+    return String(value ?? '').trim().toLowerCase() === 'true';
+}

package/clis/deepseek/utils.test.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { sendWithFile } from './utils.js';
+
+describe('deepseek sendWithFile', () => {
+  const tempDirs = [];
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+    while (tempDirs.length) {
+      fs.rmSync(tempDirs.pop(), { recursive: true, force: true });
+    }
+  });
+
+  it('prefers page.setFileInput over base64-in-evaluate when supported', async () => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-deepseek-'));
+    tempDirs.push(dir);
+    const filePath = path.join(dir, 'report.txt');
+    fs.writeFileSync(filePath, 'hello');
+
+    const page = {
+      setFileInput: vi.fn().mockResolvedValue(undefined),
+      wait: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn()
+        .mockResolvedValueOnce(undefined)
+        .mockResolvedValueOnce(true)
+        .mockResolvedValueOnce({ ok: true }),
+    };
+
+    const result = await sendWithFile(page, filePath, 'summarize this');
+
+    expect(result).toEqual({ ok: true });
+    expect(page.setFileInput).toHaveBeenCalledWith([filePath], 'input[type="file"]');
+  });
+});

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,
+      }));
+  },
+});