@v587d/capital-generation 2.15.0 → 2.16.0

package/lib/index.js

@@ -49,12 +49,13 @@ const RetrieverSchema = z.object({
         .description('PaddleOCR 文档解析（ocr 工具）配置；Token 走 credentials 引用 PADDLE_OCR_TOKEN'),
 });
 const AutomationSchema = z.object({
-    tickMs: z.number().default(60_000).description('投研自动化调度间隔毫秒（30000–3600000）'),
-    runTimeoutMinutes: z.number().default(30).description('单次运行 wall-clock 上限分钟（5–120）'),
+    tickMs: z.number().default(60_000).description('投研自动化自动检查间隔（毫秒，30000–3600000）'),
+    runTimeoutMinutes: z.number().default(60).description('单次运行最长运行时间（分钟，5–120）'),
     idleTimeoutMinutes: z.number().default(5).description('单次运行空闲超时分钟（1–30）'),
-    maxSteps: z.number().default(300).description('单次运行最大步骤数（10–2000）'),
-    maxToolCalls: z.number().default(1_200).description('单次运行最大工具调用数（10–6000）'),
+    maxSteps: z.number().default(300).description('单次运行最大步骤数（100–2000）'),
+    maxToolCalls: z.number().default(1_200).description('单次运行最大工具调用数（100–5000）'),
     inAppNotifications: z.boolean().default(true).description('是否写入应用内通知'),
+    defaultWorkspaceId: z.string().default('').description('统一默认工作区 id；空 = 专属默认工作区'),
 });
 // Derive toggles from the catalog: a hand-copied list silently drops defaults at the entry→plugin boundary.
 const SelectedSkillsSchema = z.object(Object.fromEntries(SELECTED_SKILL_CATALOG.map(({ key, name }) => [
@@ -77,11 +78,12 @@ export const Config = z.object({
         .description('FTShare（非凸科技）credentials 引用名，空 = FTSHARE_API_KEY'),
     automation: AutomationSchema.default({
         tickMs: 60_000,
-        runTimeoutMinutes: 30,
+        runTimeoutMinutes: 60,
         idleTimeoutMinutes: 5,
         maxSteps: 300,
         maxToolCalls: 1_200,
         inAppNotifications: true,
+        defaultWorkspaceId: '',
     }).description('投研自动化默认值；任务级覆盖优先'),
     retriever: RetrieverSchema.default({ baseURL: '', credentialRef: 'ANYSEARCH_API_KEY', windDocs: { endpoint: '', credentialRef: 'WIND_API_KEY', timeoutMs: 60000 }, localFetch: { ...LOCAL_FETCH_DEFAULTS }, paddleOcr: { ...PADDLE_OCR_DEFAULTS } })
         .description('web_retriever 配置（可选；缺省使用 AnySearch 默认地址与凭据名）'),

package/lib/sources/tencent-http.js

@@ -3,7 +3,7 @@ import { getDataTimeContract } from '../time/tools.js';
 import { isLikelyIndex, normalizeSecurityCodes, parseSecurityCode, requireTencentSecurity } from './security-code.js';
 // Shared core holds HK/US snapshots, smartbox and the one throttle chain; this file only defines
 // capabilities and K-line/tick orchestration. Two throttles = no throttle.
-import { QUOTE_URL, fetchOffshoreIndexQuotes, fetchOffshoreQuotes, isRecord, normalizeHkCode, normalizeOffshoreIndexCode, normalizeUsCode, numberOrNull, requiredNumber, resolveUsKlineSymbol, sourceError, tencentGetText as getText, } from './tencent-public-core.js';
+import { QUOTE_URL, aShareQuoteTime, fetchOffshoreIndexQuotes, fetchOffshoreQuotes, isRecord, normalizeHkCode, normalizeOffshoreIndexCode, normalizeUsCode, numberOrNull, requiredNumber, resolveUsKlineSymbol, sourceError, tencentGetText as getText, } from './tencent-public-core.js';
 const TICK_URL = 'https://stock.gtimg.cn/data/index.php';
 const KLINE_HOSTS = [
     'https://web.ifzq.gtimg.cn',
@@ -43,6 +43,7 @@ const quoteOutput = {
             limit_down: { oneOf: [{ type: 'number' }, { type: 'null' }] },
             vol_ratio: { oneOf: [{ type: 'number' }, { type: 'null' }] },
             pe_static: { oneOf: [{ type: 'number' }, { type: 'null' }] },
+            quote_time: { type: 'string', description: '交易所当地时间（北京时间），不是抓取时刻' },
             is_stale: { type: 'boolean' },
             stale_reason: { oneOf: [{ type: 'string' }, { type: 'null' }] },
         },
@@ -196,6 +197,9 @@ function parseQuoteRows(text, requested) {
         const values = match[3].split('~');
         if (values.length < 53)
             throw sourceError(`Tencent quote ${symbol} returned ${values.length} fields, expected at least 53`, 'tencent_invalid_response');
+        const quoteTime = aShareQuoteTime(values[30]);
+        if (quoteTime === null)
+            throw sourceError(`Tencent quote ${symbol} has an unreadable timestamp ${JSON.stringify(values[30] ?? '')}`, 'tencent_invalid_response');
         const value = (index) => numberOrNull(values[index]);
         const row = {
             code: code.canonical,
@@ -219,6 +223,7 @@ function parseQuoteRows(text, requested) {
             limit_down: value(48),
             vol_ratio: value(49),
             pe_static: value(52),
+            quote_time: quoteTime,
         };
         const stale = row.amount_wan === 0 && row.price !== null && row.price === row.last_close;
         row.is_stale = stale;
@@ -733,7 +738,7 @@ export function createTencentSources() {
             cacheMaxAgeMs: 60_000,
             name: 'get_tencent_quote',
             summary: '腾讯实时行情、估值、涨跌停和 ETF 快照',
-            description: '批量获取 SH/SZ 股票、指数或 ETF 的腾讯实时快照。输入 codes 为完整证券代码数组（如 600519.SH、000001.SZ、000001.SH、510300.SH），返回保留腾讯字段语义的行数组：价格、涨跌、成交额（万元）、换手率、PE/PB、市值和涨跌停价。44 为流通市值、45 为总市值；43 为振幅，不是 PB。腾讯返回成交额为 0 且最新价等于昨收时标记 is_stale=true，不把它当作当日有效成交。BJ 代码当前明确拒绝。',
+            description: '批量获取 SH/SZ 股票、指数或 ETF 的腾讯实时快照。输入 codes 为完整证券代码数组（如 600519.SH、000001.SZ、000001.SH、510300.SH），返回保留腾讯字段语义的行数组：价格、涨跌、成交额（万元）、换手率、PE/PB、市值和涨跌停价。quote_time 是交易所当地时间（北京时间）的最后成交时刻，不是抓取时刻；判断“数据是不是今天”要用它，不要用 captured_at 代替。44 为流通市值、45 为总市值；43 为振幅，不是 PB。腾讯返回成交额为 0 且最新价等于昨收时标记 is_stale=true，不把它当作当日有效成交。BJ 代码当前明确拒绝。',
             inputSchema: { type: 'object', properties: { codes: { type: 'array', minItems: 1, maxItems: 50, items: { type: 'string', description: '完整证券代码，如 600519.SH' } } }, required: ['codes'], additionalProperties: false },
             outputSchema: quoteOutput,
             paginated: false,

package/lib/sources/tencent-public-core.d.ts

@@ -14,6 +14,8 @@ export declare const HK_QUOTE_FIELDS = 78;
 export declare const US_QUOTE_FIELDS = 73;
 /** Exchange-local time; separator drifts per row (`/` vs `-`), normalize to hyphen. */
 export declare function offshoreQuoteTime(value: unknown): string | null;
+/** A-share snapshots give a compact `YYYYMMDDHHMMSS` (Beijing time), not the HK/US spaced form. */
+export declare function aShareQuoteTime(value: unknown): string | null;
 export declare function snapshotRows(text: string, requested: Set<string>): Array<{
     symbol: string;
     fields: string[];

package/lib/sources/tencent-public-core.js

@@ -56,6 +56,11 @@ export function offshoreQuoteTime(value) {
     const match = /^(\d{4})[-/](\d{2})[-/](\d{2}) (\d{2}:\d{2}:\d{2})$/.exec(String(value ?? '').trim());
     return match ? `${match[1]}-${match[2]}-${match[3]} ${match[4]}` : null;
 }
+/** A-share snapshots give a compact `YYYYMMDDHHMMSS` (Beijing time), not the HK/US spaced form. */
+export function aShareQuoteTime(value) {
+    const match = /^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/.exec(String(value ?? '').trim());
+    return match ? `${match[1]}-${match[2]}-${match[3]} ${match[4]}:${match[5]}:${match[6]}` : null;
+}
 export function snapshotRows(text, requested) {
     const rows = [];
     for (const line of text.split(';')) {

package/lib/sources/wind-mcp.js

@@ -472,7 +472,7 @@ export function createWindSources(resolveApiKey) {
             tool: 'search_economic_indicator',
             server: 'economic_data',
             cacheMaxAgeMs: 6 * 3_600_000,
-            summary: 'Wind EDB 宏观/行业/汇率指标检索（只找码不取数）',
+            summary: '[计费] Wind EDB 宏观/行业/汇率指标检索（只找码不取数）',
             description: EDB_SEARCH_DESCRIPTION,
             inputSchema: {
                 type: 'object',
@@ -491,7 +491,7 @@ export function createWindSources(resolveApiKey) {
             tool: 'query_economic_indicator_data',
             server: 'economic_data',
             cacheMaxAgeMs: 6 * 3_600_000,
-            summary: 'Wind EDB 指标时间序列（宏观/行业/汇率，按日期区间）',
+            summary: '[计费] Wind EDB 指标时间序列（宏观/行业/汇率，按日期区间）',
             description: EDB_QUERY_DESCRIPTION,
             inputSchema: {
                 type: 'object',
@@ -514,7 +514,7 @@ export function createWindSources(resolveApiKey) {
             tool: 'get_stock_kline',
             server: 'stock_data',
             cacheMaxAgeMs: 60_000,
-            summary: 'Wind 日周月与 1–30 分钟 K 线（按日期区间，A股+港股+美股）',
+            summary: '[计费] Wind 日周月与 1–30 分钟 K 线（按日期区间，A股+港股+美股）',
             description: KLINE_DESCRIPTION,
             inputSchema: {
                 type: 'object',

package/lib/sources-entry.d.ts

@@ -1,5 +1,5 @@
 /**
- * `tools/retrieve-sources` row: the nine named-source tools, gated by
+ * `tools/retrieve-sources` row: the eleven named-source tools, gated by
  * `localFetch.enabled`. When disabled they stay registered and fail loudly per call;
  * unregistering at boot would freeze one config read for the process lifetime.
  */

package/lib/web-retriever/local-fetch.d.ts

@@ -3,7 +3,7 @@
  * Known limit: DNS resolves per request but the IP is not pinned to the connection,
  * so a rebinding window remains (same trade-off as dsh-search-first).
  */
-export declare const LOCAL_FETCH_CLIENT_VERSION = "2.15.0";
+export declare const LOCAL_FETCH_CLIENT_VERSION = "2.16.0";
 export declare const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export type LocalFetchErrorCode = 'ABORTED' | 'TIMEOUT' | 'INVALID_URL' | 'BLOCKED_URL' | 'DNS' | 'REDIRECT' | 'HTTP' | 'TOO_LARGE' | 'UNSUPPORTED_CONTENT_TYPE';
 export declare class LocalFetchError extends Error {

package/lib/web-retriever/local-fetch.js

@@ -4,7 +4,7 @@
  * so a rebinding window remains (same trade-off as dsh-search-first).
  */
 import { htmlToMarkdown, stripInvisibleText } from './html-markdown.js';
-export const LOCAL_FETCH_CLIENT_VERSION = '2.15.0';
+export const LOCAL_FETCH_CLIENT_VERSION = '2.16.0';
 export const LOCAL_FETCH_MAX_URL_LENGTH = 2048;
 export class LocalFetchError extends Error {
     code;

package/lib/web-retriever/sources.d.ts

@@ -128,6 +128,64 @@ export declare function eastmoneyReports(client: EastmoneyClient, input: {
     pageNo: number;
     signal?: AbortSignal;
 }): Promise<SourceOutcome>;
+export type AnnouncementMarket = 'A' | 'H' | 'U';
+export interface NormalizedAnnouncementCode {
+    code: string;
+    market: AnnouncementMarket;
+}
+/**
+ * Accept the forms users actually paste (`600519.SH` / `SH600519` / `0700.HK` / `AAPL.O`).
+ * The market is inferred only from an unambiguous shape; a mixed list is rejected rather
+ * than silently sent to one `ann_type`.
+ */
+export declare function normalizeAnnouncementCode(value: unknown, market?: AnnouncementMarket | 'auto'): NormalizedAnnouncementCode;
+export declare function normalizeAnnouncementCodes(values: unknown, market?: AnnouncementMarket | 'auto'): {
+    codes: string[];
+    market: AnnouncementMarket;
+};
+/**
+ * Eastmoney republishes issuer announcements; it is a complete issuer-scoped list by day,
+ * whereas Wind's NL RAG is semantic and can miss the newest item. The list is the primary
+ * path for "what was disclosed"; the authoritative PDF remains cninfo / the issuer.
+ */
+export declare function eastmoneyAnnouncements(client: EastmoneyClient, input: {
+    codes: string[];
+    market: AnnouncementMarket;
+    startDate: string;
+    endDate: string;
+    cursor: number;
+    pageSize: number;
+    signal?: AbortSignal;
+}): Promise<SourceOutcome>;
+export interface AnnouncementBody {
+    source: 'eastmoney';
+    operation: 'announcement_body';
+    art_code: string;
+    page: number;
+    offset: number;
+    page_chars: number;
+    total_pages: number;
+    content: string;
+    next_offset?: number;
+    next_page?: number;
+    done: boolean;
+    pdf_url?: string;
+    title?: string;
+    notice_date?: string;
+    note?: string;
+}
+/**
+ * The detail API returns at most 5,000 characters per `page_index`; `page_size` is the
+ * total page count, so `done` is knowable without fetching a sentinel page. US filings
+ * often return an empty body while still carrying a PDF — that is a fact, not an error.
+ */
+export declare function eastmoneyAnnouncementBody(client: EastmoneyClient, input: {
+    artCode: string;
+    page: number;
+    offset: number;
+    limit: number;
+    signal?: AbortSignal;
+}): Promise<AnnouncementBody>;
 /**
  * Always add the exchange prefix: bare codes get a fake empty page for STAR/ChiNext.
  * That page is HTTP 200 and looks like "no reports", so also verify the numbered row count.

package/lib/web-retriever/sources.js

@@ -780,6 +780,296 @@ export async function eastmoneyReports(client, input) {
         note: `东财研报库共 ${hits} 篇；列表不含摘要，正文在各条的 pdf_url（研报 PDF）里，交 ocr 解析（整篇一次算完）`,
     };
 }
+const EM_ANNOUNCEMENT_LIST_URL = 'https://np-anotice-stock.eastmoney.com/api/security/ann';
+const EM_ANNOUNCEMENT_BODY_URL = 'https://np-cnotice-stock.eastmoney.com/api/content/ann';
+const EM_ANNOUNCEMENT_REFERER = 'https://data.eastmoney.com/';
+const EM_ANNOUNCEMENT_PAGE_SIZE = 100;
+/** Scan cap: a 7-day watchlist window rarely needs more; the note must say when it is hit. */
+const EM_ANNOUNCEMENT_MAX_SCAN_PAGES = 5;
+/**
+ * Accept the forms users actually paste (`600519.SH` / `SH600519` / `0700.HK` / `AAPL.O`).
+ * The market is inferred only from an unambiguous shape; a mixed list is rejected rather
+ * than silently sent to one `ann_type`.
+ */
+export function normalizeAnnouncementCode(value, market = 'auto') {
+    const raw = typeof value === 'string' ? value.trim().toUpperCase() : '';
+    if (raw.length === 0)
+        throw new Error('announcement code is required');
+    if (raw.length > 32)
+        throw new Error(`announcement code is too long: ${raw.slice(0, 32)}…`);
+    const suffix = /\.(SH|SZ|BJ|HK|O|N|US)$/u.exec(raw)?.[1];
+    let body = suffix === undefined ? raw : raw.slice(0, -(suffix.length + 1));
+    const prefix = /^(SH|SZ|BJ|HK)(?=\d)/u.exec(body)?.[1];
+    if (prefix !== undefined)
+        body = body.slice(prefix.length);
+    if (body.length === 0)
+        throw new Error(`announcement code is empty after removing prefix/suffix: ${raw}`);
+    const suffixMarket = suffix === undefined && prefix === undefined
+        ? undefined
+        : suffix === 'HK' || prefix === 'HK' ? 'H'
+            : suffix === 'O' || suffix === 'N' || suffix === 'US' ? 'U'
+                : 'A';
+    const shaped = /^\d{6}$/u.test(body)
+        ? 'A'
+        : /^\d{1,5}$/u.test(body)
+            ? 'H'
+            : /^[A-Z][A-Z0-9.-]{0,9}$/u.test(body) && !body.includes('..')
+                ? 'U'
+                : undefined;
+    if (shaped === undefined)
+        throw new Error(`announcement code shape not recognized: ${raw}`);
+    if (suffixMarket !== undefined && suffixMarket !== shaped && !(suffixMarket === 'A' && shaped === 'H')) {
+        throw new Error(`announcement code ${raw} has a suffix for ${suffixMarket} but a ${shaped} code; pass the right market or fix the code`);
+    }
+    const target = market === 'auto' ? (suffixMarket ?? shaped) : market;
+    if (target === 'A' && !/^\d{6}$/u.test(body))
+        throw new Error(`A-share announcement code must be six digits: ${raw}`);
+    if (target === 'H') {
+        if (!/^\d{1,5}$/u.test(body))
+            throw new Error(`HK announcement code must be 1–5 digits: ${raw}`);
+        body = body.padStart(5, '0');
+    }
+    if (target === 'U' && !(/^[A-Z][A-Z0-9.-]{0,9}$/u.test(body) && !body.includes('..'))) {
+        throw new Error(`US announcement ticker is invalid: ${raw}`);
+    }
+    return { code: body, market: target };
+}
+export function normalizeAnnouncementCodes(values, market = 'auto') {
+    if (!Array.isArray(values) || values.length === 0)
+        throw new Error('codes must be a non-empty array');
+    if (values.length > 50)
+        throw new Error('codes accepts at most 50 codes per call');
+    const normalized = values.map((value) => normalizeAnnouncementCode(value, market));
+    const markets = new Set(normalized.map((item) => item.market));
+    if (markets.size !== 1) {
+        throw new Error('codes must be from one market per call (A / H / U); split mixed lists and call once per market');
+    }
+    return { codes: [...new Set(normalized.map((item) => item.code))], market: normalized[0].market };
+}
+function announcementDate(value, field) {
+    const text = value.trim().slice(0, 10);
+    if (!/^\d{4}-\d{2}-\d{2}$/u.test(text))
+        throw new Error(`parameter ${field} must be YYYY-MM-DD`);
+    const check = new Date(`${text}T00:00:00Z`);
+    if (Number.isNaN(check.getTime()) || check.toISOString().slice(0, 10) !== text) {
+        throw new Error(`parameter ${field} must be a valid YYYY-MM-DD date`);
+    }
+    return text;
+}
+function announcementRowDate(row) {
+    const display = typeof row.display_time === 'string' ? row.display_time.trim() : '';
+    const notice = typeof row.notice_date === 'string' ? row.notice_date.trim() : '';
+    const raw = display || notice;
+    if (raw.length < 10)
+        throw new SourceError('eastmoney', 'INVALID_RESPONSE', '东财公告条目缺少 display_time / notice_date');
+    const date = raw.slice(0, 10);
+    const check = new Date(`${date}T00:00:00Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/u.test(date) || Number.isNaN(check.getTime()) || check.toISOString().slice(0, 10) !== date) {
+        throw new SourceError('eastmoney', 'INVALID_RESPONSE', `东财公告条目的时间不可解析：${JSON.stringify(raw.slice(0, 40))}`);
+    }
+    return { date, publishedAt: display || notice };
+}
+function announcementOwner(row, codes) {
+    const list = Array.isArray(row.codes) ? row.codes : [];
+    for (const raw of list) {
+        const item = asRecord(raw);
+        const code = typeof item?.stock_code === 'string' ? item.stock_code.trim() : '';
+        if (codes.includes(code)) {
+            return { code, name: typeof item?.short_name === 'string' ? item.short_name : '' };
+        }
+    }
+    const first = asRecord(list[0]);
+    return {
+        code: typeof first?.stock_code === 'string' ? first.stock_code : codes[0],
+        name: typeof first?.short_name === 'string' ? first.short_name : '',
+    };
+}
+/**
+ * Eastmoney republishes issuer announcements; it is a complete issuer-scoped list by day,
+ * whereas Wind's NL RAG is semantic and can miss the newest item. The list is the primary
+ * path for "what was disclosed"; the authoritative PDF remains cninfo / the issuer.
+ */
+export async function eastmoneyAnnouncements(client, input) {
+    const start = announcementDate(input.startDate, 'start_date');
+    const end = announcementDate(input.endDate, 'end_date');
+    if (start > end)
+        throw new Error('parameter start_date must not be later than end_date');
+    const byArtCode = new Map();
+    let totalHits = 0;
+    let scannedPages = 0;
+    let reachedOlder = false;
+    let oldestScanned;
+    for (let page = 1; page <= EM_ANNOUNCEMENT_MAX_SCAN_PAGES; page += 1) {
+        const params = new URLSearchParams({
+            sr: '-1',
+            page_size: String(EM_ANNOUNCEMENT_PAGE_SIZE),
+            page_index: String(page),
+            ann_type: input.market,
+            client_source: 'web',
+            stock_list: input.codes.join(','),
+        });
+        const outcome = await client.fetchText(`${EM_ANNOUNCEMENT_LIST_URL}?${params.toString()}`, {
+            headers: { referer: EM_ANNOUNCEMENT_REFERER },
+            ...(input.signal === undefined ? {} : { signal: input.signal }),
+        });
+        const body = asRecord(parseJson(outcome.text, 'eastmoney', '东财公告列表响应'));
+        const data = asRecord(body?.data);
+        if (!data)
+            throw new SourceError('eastmoney', 'INVALID_RESPONSE', '东财公告列表缺少 data（上游结构可能已变）');
+        if (data.list !== null && data.list !== undefined && !Array.isArray(data.list)) {
+            throw new SourceError('eastmoney', 'INVALID_RESPONSE', '东财公告列表 data.list 不是数组（上游结构可能已变）');
+        }
+        const rows = Array.isArray(data.list) ? data.list : [];
+        totalHits = typeof data.total_hits === 'number' ? data.total_hits : rows.length;
+        scannedPages = page;
+        for (const raw of rows) {
+            const row = asRecord(raw);
+            if (!row)
+                continue;
+            const { date, publishedAt } = announcementRowDate(row);
+            if (oldestScanned === undefined || date < oldestScanned)
+                oldestScanned = date;
+            if (date < start) {
+                reachedOlder = true;
+                continue;
+            }
+            if (date > end)
+                continue;
+            const artCode = typeof row.art_code === 'string' ? row.art_code.trim() : '';
+            if (artCode.length === 0)
+                throw new SourceError('eastmoney', 'INVALID_RESPONSE', '东财公告条目缺少 art_code');
+            if (byArtCode.has(artCode))
+                continue;
+            const owner = announcementOwner(row, input.codes);
+            const category = Array.isArray(row.columns)
+                ? row.columns.map((column) => (asRecord(column)?.column_name)).filter((name) => typeof name === 'string').join('/')
+                : '';
+            const item = {
+                code: owner.code,
+                name: clip(owner.name),
+                market: input.market,
+                date,
+                published_at: publishedAt,
+                title: clip(stripHtml(typeof row.title === 'string' ? row.title : '')),
+                category: clip(category),
+                art_code: clip(artCode),
+                url: itemUrl(`https://data.eastmoney.com/notices/detail/${owner.code}/${artCode}.html`),
+            };
+            byArtCode.set(artCode, item);
+        }
+        if (reachedOlder || rows.length < EM_ANNOUNCEMENT_PAGE_SIZE || page * EM_ANNOUNCEMENT_PAGE_SIZE >= totalHits)
+            break;
+    }
+    const sorted = [...byArtCode.values()].sort((left, right) => {
+        const byTime = String(right.published_at ?? '').localeCompare(String(left.published_at ?? ''));
+        return byTime !== 0 ? byTime : String(right.date ?? '').localeCompare(String(left.date ?? ''));
+    });
+    const offset = Number.isSafeInteger(input.cursor) && input.cursor >= 0 ? input.cursor : 0;
+    const items = sorted.slice(offset, offset + input.pageSize);
+    const windowOutOfRange = !reachedOlder && oldestScanned !== undefined && oldestScanned > end;
+    const notes = ['东财公告是官方披露的转载；权威原文用巨潮 PDF / 发行人页面；正文用 eastmoney_announcement_body；窗口按 display_time（北京时间）过滤'];
+    if (sorted.length === 0 && !windowOutOfRange)
+        notes.push('窗口内没有公告（合法空结果；东财列表只覆盖最近若干页）');
+    if (windowOutOfRange) {
+        notes.push(`窗口未被覆盖：只扫描到最近 ${scannedPages * EM_ANNOUNCEMENT_PAGE_SIZE} 条（最早 ${oldestScanned}），所请求窗口早于此；请缩小日期/代码范围，或改用巨潮 PDF`);
+    }
+    if (offset + items.length < sorted.length) {
+        notes.push(`窗口内共 ${sorted.length} 条，本次返回第 ${offset + 1}–${offset + items.length} 条；继续翻页传 cursor=${offset + items.length}`);
+    }
+    if (!reachedOlder && !windowOutOfRange && totalHits > scannedPages * EM_ANNOUNCEMENT_PAGE_SIZE) {
+        notes.push(`本次只扫描前 ${scannedPages * EM_ANNOUNCEMENT_PAGE_SIZE} 条，窗口内可能仍有更早公告；请缩小日期窗或代码数`);
+    }
+    return {
+        source: 'eastmoney',
+        operation: 'announcements',
+        items: clipItems(items),
+        ...(offset + items.length < sorted.length ? { next_cursor: String(offset + items.length) } : {}),
+        note: notes.join('；'),
+    };
+}
+/**
+ * The detail API returns at most 5,000 characters per `page_index`; `page_size` is the
+ * total page count, so `done` is knowable without fetching a sentinel page. US filings
+ * often return an empty body while still carrying a PDF — that is a fact, not an error.
+ */
+export async function eastmoneyAnnouncementBody(client, input) {
+    const artCode = input.artCode.trim().toUpperCase();
+    if (!/^AN\d{6,}$/u.test(artCode))
+        throw new Error('art_code must look like AN202611021831320924');
+    if (!Number.isSafeInteger(input.page) || input.page < 1)
+        throw new Error('page must be a positive integer');
+    if (!Number.isSafeInteger(input.offset) || input.offset < 0)
+        throw new Error('offset must be a non-negative integer');
+    if (!Number.isSafeInteger(input.limit) || input.limit < 1)
+        throw new Error('limit must be a positive integer');
+    const page = input.page;
+    const params = new URLSearchParams({ art_code: artCode, client_source: 'web', page_index: String(page) });
+    const outcome = await client.fetchText(`${EM_ANNOUNCEMENT_BODY_URL}?${params.toString()}`, {
+        headers: { referer: EM_ANNOUNCEMENT_REFERER },
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+    });
+    const body = asRecord(parseJson(outcome.text, 'eastmoney', '东财公告正文响应'));
+    const data = asRecord(body?.data);
+    if (!data)
+        throw new SourceError('eastmoney', 'NOT_FOUND', `东财公告正文没有 art_code=${artCode} 的数据（公告不存在或上游结构已变）`);
+    const content = stripHtml(typeof data.notice_content === 'string' ? data.notice_content : '');
+    const pageCount = Number(data.page_size);
+    const totalPages = Number.isSafeInteger(pageCount) && pageCount > 0 ? pageCount : 1;
+    const pdfUrl = itemUrl(data.attach_url_web ?? data.attach_url);
+    const title = clip(data.notice_title);
+    const noticeDate = clip(data.notice_date);
+    const base = {
+        source: 'eastmoney',
+        operation: 'announcement_body',
+        art_code: artCode,
+        page,
+        offset: input.offset,
+        page_chars: content.length,
+        total_pages: totalPages,
+        ...(pdfUrl.length > 0 ? { pdf_url: pdfUrl } : {}),
+        ...(title.length > 0 ? { title } : {}),
+        ...(noticeDate.length > 0 ? { notice_date: noticeDate } : {}),
+    };
+    if (content.length === 0) {
+        return {
+            ...base,
+            content: '',
+            done: true,
+            note: '该公告正文接口没有返回文本（美股公告常见；若为 A/H 公告，可能是上游结构变更）；正文在 PDF/附件，用 ocr 解析，别把标题当正文',
+        };
+    }
+    if (page > totalPages) {
+        return { ...base, content: '', done: true, note: `page 超过总页数 ${totalPages}（该公告只有 ${totalPages} 页）` };
+    }
+    if (input.offset >= content.length) {
+        const nextPage = page < totalPages ? page + 1 : undefined;
+        return {
+            ...base,
+            content: '',
+            ...(nextPage === undefined ? {} : { next_page: nextPage }),
+            done: nextPage === undefined,
+            note: nextPage === undefined ? '已到文末' : `本页已读完；下一页传 page=${nextPage}、offset=0`,
+        };
+    }
+    const limit = Math.min(input.limit, 4_000);
+    const slice = content.slice(input.offset, input.offset + limit);
+    const nextOffset = input.offset + slice.length < content.length ? input.offset + slice.length : undefined;
+    const nextPage = nextOffset === undefined && page < totalPages ? page + 1 : undefined;
+    const done = nextOffset === undefined && nextPage === undefined;
+    const notes = [];
+    if (totalPages > 1)
+        notes.push(`全文共 ${totalPages} 页（每页约 5,000 字符）；用 next_offset / next_page 继续读`);
+    if (pdfUrl.length > 0)
+        notes.push('PDF 直链在 pdf_url；权威引用请用巨潮/发行人原文');
+    return {
+        ...base,
+        content: slice,
+        ...(nextOffset === undefined ? {} : { next_offset: nextOffset }),
+        ...(nextPage === undefined ? {} : { next_page: nextPage }),
+        done,
+        ...(notes.length === 0 ? {} : { note: notes.join('；') }),
+    };
+}
 const SINA_REPORT_URL = 'https://vip.stock.finance.sina.com.cn/q/go.php/vReport_List/kind';
 const SINA_REFERER = 'https://finance.sina.com.cn/';
 /**