@dshtrading/kit-hk 0.1.0

package/lib/news.js

@@ -0,0 +1,485 @@
+//#region src/news.ts
+const EASTMONEY_URL = "https://np-listapi.eastmoney.com/comm/web/getFastNewsList";
+const HKEX_BASE = "https://www1.hkexnews.hk";
+const DEFAULT_WINDOW_HOURS = 24;
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 50;
+const UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (dsh-trading/hk_get_news)";
+/** 下钻 fetch 统一 10s 超时（docs/replication.md §9；上游挂起不得拖垮 60s 轮询链）。 */
+const UPSTREAM_TIMEOUT_MS = 1e4;
+/** 港交所 marketId（stockList 前缀，如 '116.00700'）。 */
+const HK_MARKET_ID = "116.";
+/** 港股关键词（无关联代码时仍判为港股相关）。 */
+const HK_KEYWORDS = [
+	"港股",
+	"港交所",
+	"香港",
+	"恒指",
+	"恒生"
+];
+/** 公告放宽时间窗：上市公司公告 90 天（一季度）内有效（媒体快讯仍按 24h 窗）。 */
+const ANNOUNCEMENT_MAX_AGE_MS = 7776e6;
+/** HKEX 公告检索请求窗：宽于 90 天过滤窗，避免时区/日期边界裁剪（DATE_TIME 港图时间）。 */
+const HKEX_REQUEST_WINDOW_MS = 8208e6;
+function parseHkShowTime(showTime) {
+	const t = Date.parse(showTime.trim().replace(" ", "T") + "+08:00");
+	return Number.isFinite(t) ? t : NaN;
+}
+/** 港股相关性：stockList 含 116. 前缀代码（港交所），或 title 含港股关键词。 */
+function isHkRelevant(item) {
+	if (item.relatedCodes?.some((c) => c.startsWith(HK_MARKET_ID))) return true;
+	const title = item.title.toUpperCase();
+	return HK_KEYWORDS.some((k) => title.includes(k.toUpperCase()));
+}
+async function fetchEastmoneyHk(fetchImpl, limit) {
+	const url = new URL(EASTMONEY_URL);
+	url.searchParams.set("client", "web");
+	url.searchParams.set("biz", "web_724");
+	url.searchParams.set("sortEnd", "");
+	url.searchParams.set("req_trace", "1");
+	url.searchParams.set("fastColumn", "103");
+	url.searchParams.set("pageSize", String(Math.max(limit * 2, 40)));
+	const response = await fetchImpl(url, {
+		headers: {
+			accept: "application/json",
+			"user-agent": UA
+		},
+		signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+	});
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new Error(`eastmoney: HTTP ${response.status}${body ? ` — ${body.slice(0, 160)}` : ""}`);
+	}
+	const list = JSON.parse(await response.text()).data?.fastNewsList;
+	if (!Array.isArray(list)) throw new Error("eastmoney: unexpected payload (expected data.fastNewsList[])");
+	const items = [];
+	for (const it of list) {
+		if (!it.title || it.code === void 0) continue;
+		const ts = typeof it.showTime === "string" ? parseHkShowTime(it.showTime) : NaN;
+		if (!Number.isFinite(ts)) continue;
+		const relatedCodes = Array.isArray(it.stockList) ? it.stockList.filter((s) => typeof s === "string" && s.includes(".")) : void 0;
+		const candidate = {
+			source: "eastmoney",
+			title: it.title,
+			url: `https://finance.eastmoney.com/a/${encodeURIComponent(String(it.code))}.html`,
+			publishedAt: new Date(ts).toISOString(),
+			...relatedCodes && relatedCodes.length > 0 ? { relatedCodes } : {}
+		};
+		if (isHkRelevant(candidate)) items.push(candidate);
+	}
+	return items;
+}
+function inWindow(publishedAt, nowMs, windowMs) {
+	const ts = Date.parse(publishedAt);
+	if (!Number.isFinite(ts)) return false;
+	return ts >= nowMs - windowMs && ts <= nowMs + 6e4;
+}
+function matchesSymbol(item, rawSymbol) {
+	const needle = rawSymbol?.trim();
+	if (!needle) return true;
+	const title = item.title.toUpperCase();
+	const normalizedNeedle = needle.toUpperCase().replace(/\.HK$/i, "").replace(/^0+/, "");
+	const tokens = [needle.toUpperCase(), normalizedNeedle];
+	if (tokens.some((t) => t && title.includes(t))) return true;
+	if (item.relatedCodes) return tokens.some((t) => t && item.relatedCodes.some((c) => c.startsWith("116.") && c.slice(4).replace(/^0+/, "") === t));
+	return false;
+}
+function clampNumber(value, fallback, min, max) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+	return Math.min(Math.max(Math.trunc(value), min), max);
+}
+async function fetchEastmoneyHkAnnouncements(fetchImpl, rawSymbol, limit) {
+	const clean = rawSymbol.trim().replace(/\.HK$/i, "").padStart(5, "0");
+	if (!/^\d{5}$/.test(clean)) return [];
+	const url = new URL("https://np-anotice-stock.eastmoney.com/api/security/ann");
+	url.searchParams.set("page_size", String(Math.max(limit, 20)));
+	url.searchParams.set("page_index", "1");
+	url.searchParams.set("ann_type", "H");
+	url.searchParams.set("client_source", "web");
+	url.searchParams.set("stock_list", clean);
+	const response = await fetchImpl(url, {
+		headers: {
+			accept: "application/json",
+			"user-agent": UA
+		},
+		signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+	});
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new Error(`eastmoney-announcement: HTTP ${response.status}${body ? ` — ${body.slice(0, 160)}` : ""}`);
+	}
+	const list = JSON.parse(await response.text()).data?.list;
+	if (!Array.isArray(list)) throw new Error("eastmoney-announcement: unexpected payload (expected data.list[])");
+	const items = [];
+	for (const it of list) {
+		const title = it.title_ch || it.title;
+		if (!title || !it.art_code) continue;
+		const ts = parseHkShowTime((it.display_time || it.notice_date || "").slice(0, 19));
+		if (!Number.isFinite(ts)) continue;
+		items.push({
+			source: "eastmoney-announcement",
+			title,
+			url: `https://data.eastmoney.com/notices/detail/${clean}/${encodeURIComponent(it.art_code)}.html`,
+			publishedAt: new Date(ts).toISOString(),
+			relatedCodes: [`116.${clean}`]
+		});
+	}
+	return items;
+}
+/**
+* 股票代码 → HKEX stockId 内码 memo。prefix.do 冷请求 ~3.7s，stockId 是稳定静态
+* 映射（kit 层参考数据，非行情缓存，不违铁律 #5 桥无状态语义）；仅缓存成功值。
+* 失败负缓存 5 分钟（评审 L1）+ in-flight promise 合并并发（评审 L1）。
+*/
+const hkexStockIdMemo = /* @__PURE__ */ new Map();
+const hkexStockIdFailureMemo = /* @__PURE__ */ new Map();
+const hkexStockIdInflight = /* @__PURE__ */ new Map();
+/** 失败负缓存 TTL：5 分钟内不重试失败的 stockId lookup。 */
+const LOOKUP_FAILURE_TTL_MS = 3e5;
+/** 清空 HKEX stockId memo（单测隔离用；生产运行期不需要调用）。 */
+function resetHkexAnnouncementMemo() {
+	hkexStockIdMemo.clear();
+	hkexStockIdFailureMemo.clear();
+	hkexStockIdInflight.clear();
+}
+/** HKEX 披露易 DATE_TIME：`DD/MM/YYYY HH:MM`（日/月倒序，港图时间东八区）→ 毫秒。 */
+function parseHkexDateTime(value) {
+	const m = /^(\d{2})\/(\d{2})\/(\d{4})\s+(\d{2}):(\d{2})$/.exec(value.trim());
+	if (m === null) return NaN;
+	const t = Date.parse(`${m[3]}-${m[2]}-${m[1]}T${m[4]}:${m[5]}:00+08:00`);
+	return Number.isFinite(t) ? t : NaN;
+}
+async function fetchHkexStockId(fetchImpl, code) {
+	const cached = hkexStockIdMemo.get(code);
+	if (cached !== void 0) return cached;
+	const failedAt = hkexStockIdFailureMemo.get(code);
+	if (failedAt !== void 0 && Date.now() - failedAt < LOOKUP_FAILURE_TTL_MS) throw new Error("hkex: lookup recently failed (negative cache, retry later)");
+	let inflight = hkexStockIdInflight.get(code);
+	if (inflight === void 0) {
+		inflight = fetchHkexStockIdUncached(fetchImpl, code).finally(() => {
+			hkexStockIdInflight.delete(code);
+		});
+		hkexStockIdInflight.set(code, inflight);
+	}
+	return inflight;
+}
+async function fetchHkexStockIdUncached(fetchImpl, code) {
+	const url = new URL(`${HKEX_BASE}/search/prefix.do`);
+	url.searchParams.set("callback", "callback");
+	url.searchParams.set("lang", "ZH");
+	url.searchParams.set("type", "A");
+	url.searchParams.set("name", code);
+	url.searchParams.set("market", "SEHK");
+	let response;
+	try {
+		response = await fetchImpl(url, {
+			headers: {
+				accept: "*/*",
+				"user-agent": UA
+			},
+			signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+		});
+	} catch (err) {
+		hkexStockIdFailureMemo.set(code, Date.now());
+		throw err;
+	}
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		hkexStockIdFailureMemo.set(code, Date.now());
+		throw new Error(`hkex: HTTP ${response.status}${body ? ` — ${body.slice(0, 160)}` : ""}`);
+	}
+	const text = await response.text();
+	let parsed;
+	try {
+		parsed = JSON.parse(text.replace(/^callback\(/, "").replace(/\);\s*$/, ""));
+	} catch {
+		hkexStockIdFailureMemo.set(code, Date.now());
+		throw new Error("hkex: unexpected payload (invalid JSONP)");
+	}
+	const list = parsed.stockInfo;
+	const hit = Array.isArray(list) ? list.find((it) => it.code === code) : void 0;
+	if (typeof hit?.stockId !== "number") {
+		hkexStockIdFailureMemo.set(code, Date.now());
+		throw new Error("hkex: unexpected payload (expected stockInfo[].stockId for exact code match)");
+	}
+	hkexStockIdMemo.set(code, hit.stockId);
+	return hit.stockId;
+}
+/** 请求窗日期串（YYYYMMDD，东八区日历日，评审 M3：HKEX fromDate/toDate 按港图 +08:00 日界截窗，UTC 日期会在每天 00:00–07:59 漏掉当日披露）。 */
+function ymdHkCompact(ms) {
+	return new Date(ms + 288e5).toISOString().slice(0, 10).replace(/-/g, "");
+}
+async function fetchHkexAnnouncements(fetchImpl, rawSymbol, limit, nowMs) {
+	const clean = rawSymbol.trim().replace(/\.HK$/i, "").padStart(5, "0");
+	if (!/^\d{5}$/.test(clean)) return [];
+	const stockId = await fetchHkexStockId(fetchImpl, clean);
+	const now = nowMs;
+	const url = new URL(`${HKEX_BASE}/search/titleSearchServlet.do`);
+	url.searchParams.set("sortDir", "0");
+	url.searchParams.set("sortByOptions", "DateTime");
+	url.searchParams.set("category", "0");
+	url.searchParams.set("market", "SEHK");
+	url.searchParams.set("stockId", String(stockId));
+	url.searchParams.set("documentType", "-1");
+	url.searchParams.set("fromDate", ymdHkCompact(now - HKEX_REQUEST_WINDOW_MS));
+	url.searchParams.set("toDate", ymdHkCompact(now));
+	url.searchParams.set("title", "");
+	url.searchParams.set("searchType", "1");
+	url.searchParams.set("t1code", "-2");
+	url.searchParams.set("t2Gcode", "-2");
+	url.searchParams.set("t2code", "-2");
+	url.searchParams.set("rowRange", String(Math.max(limit, 20)));
+	url.searchParams.set("lang", "ZH");
+	const response = await fetchImpl(url, {
+		headers: {
+			accept: "*/*",
+			"user-agent": UA
+		},
+		signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+	});
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new Error(`hkex-announcement: HTTP ${response.status}${body ? ` — ${body.slice(0, 160)}` : ""}`);
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(await response.text());
+	} catch {
+		throw new Error("hkex-announcement: unexpected payload (invalid JSON)");
+	}
+	const result = parsed.result;
+	let rows;
+	try {
+		rows = typeof result === "string" ? JSON.parse(result) : Array.isArray(result) ? result : [];
+	} catch {
+		throw new Error("hkex-announcement: unexpected payload (invalid nested result JSON)");
+	}
+	if (!Array.isArray(rows)) throw new Error("hkex-announcement: unexpected payload (expected result[])");
+	const items = [];
+	for (const row of rows) {
+		if (!row.TITLE || !row.FILE_LINK) continue;
+		if (typeof row.STOCK_CODE === "string" && !row.STOCK_CODE.startsWith(clean)) continue;
+		const ts = parseHkexDateTime(row.DATE_TIME ?? "");
+		if (!Number.isFinite(ts)) continue;
+		items.push({
+			source: "hkex-announcement",
+			title: row.TITLE,
+			url: `${HKEX_BASE}${row.FILE_LINK}`,
+			publishedAt: new Date(ts).toISOString(),
+			relatedCodes: [`116.${clean}`]
+		});
+	}
+	return items;
+}
+/** 繁→简映射（HKEX 标题为繁体、东财转简体）：仅覆盖公告标题高频字，缺字即原样保留。 */
+const TRAD_TO_SIMP = {
+	報: "报",
+	變: "变",
+	動: "动",
+	購: "购",
+	會: "会",
+	業: "业",
+	資: "资",
+	訊: "讯",
+	關: "关",
+	聯: "联",
+	營: "营",
+	運: "运",
+	財: "财",
+	務: "务",
+	長: "长",
+	開: "开",
+	東: "东",
+	門: "门",
+	項: "项",
+	證: "证",
+	淨: "净",
+	虧: "亏",
+	損: "损",
+	積: "积",
+	極: "极",
+	環: "环",
+	場: "场",
+	標: "标",
+	題: "题",
+	續: "续",
+	職: "职",
+	執: "执",
+	導: "导",
+	師: "师",
+	顧: "顾",
+	問: "问",
+	講: "讲",
+	評: "评",
+	議: "议",
+	決: "决",
+	賠: "赔",
+	償: "偿",
+	質: "质",
+	貸: "贷",
+	結: "结",
+	費: "费",
+	訂: "订",
+	閱: "阅",
+	億: "亿",
+	兩: "两",
+	廣: "广",
+	廠: "厂",
+	銀: "银",
+	聲: "声",
+	識: "识",
+	體: "体",
+	總: "总",
+	經: "经",
+	銷: "销",
+	產: "产",
+	賣: "卖",
+	買: "买",
+	賬: "账",
+	戶: "户",
+	權: "权",
+	讓: "让",
+	擔: "担",
+	託: "托",
+	約: "约",
+	訴: "诉",
+	訟: "讼",
+	詢: "询",
+	復: "复",
+	對: "对",
+	審: "审",
+	計: "计",
+	備: "备",
+	稅: "税",
+	應: "应",
+	鏈: "链",
+	儲: "储",
+	據: "据",
+	領: "领",
+	補: "补",
+	貼: "贴",
+	凍: "冻",
+	註: "注",
+	績: "绩",
+	預: "预",
+	減: "减",
+	轉: "转",
+	離: "离",
+	辭: "辞",
+	選: "选",
+	舉: "举",
+	臨: "临",
+	時: "时",
+	間: "间",
+	規: "规",
+	則: "则",
+	範: "范",
+	貨: "货",
+	價: "价",
+	錄: "录",
+	屬: "属",
+	區: "区",
+	歲: "岁",
+	萬: "万",
+	與: "与",
+	內: "内",
+	實: "实",
+	濟: "济",
+	狀: "状",
+	況: "况",
+	顯: "显",
+	釋: "释",
+	說: "说",
+	詳: "详",
+	壓: "压",
+	風: "风",
+	險: "险",
+	靈: "灵",
+	遠: "远",
+	遜: "逊",
+	達: "达",
+	遲: "迟",
+	劃: "划",
+	歷: "历",
+	歸: "归",
+	當: "当",
+	鐘: "钟",
+	頭: "头",
+	發: "发",
+	電: "电",
+	龍: "龙"
+};
+/**
+* 公告标题归一化：去公司名前缀（东财习惯 `公司:标题`）→ 繁转简 → 去全部标点/符号/空白。
+* 归一化后跨源比对（同源不去重：同日两份同名披露是合法的不同文件）。
+*/
+function normalizeAnnouncementTitle(title) {
+	const stripped = title.replace(/^[^：:]*[：:]\s*/, "");
+	let converted = "";
+	for (const ch of stripped) converted += TRAD_TO_SIMP[ch] ?? ch;
+	return converted.replace(/[\s\p{P}\p{S}]+/gu, "");
+}
+/**
+* 公告标题以类别开头（翌日披露报表/中期报告…），繁简转换与括注差异使全文等值不可靠。
+* 前缀判重的收紧口径（2026-09-03 评审 M1）：共同前缀 ≥6 字之外还要求**共同后缀 ≥2 字**。
+* 真实误删对因此被排除（证据 hkex-titlesearch-00700.body）：裸类别 `翌日披露报表`（恰 6 字）vs
+* 长标题（长边结尾不同）、同族不同文件（`…已发行股份变动` vs `…变动及股份购回`，中段分叉）、
+* 泛化日期头（`截至二零二六年七月…月报表` vs `截至二零二六年六月三十日…业绩公布`）。仍能兜住
+* 真实变体对（同一文件两源的括注/繁简/措辞差异，头尾主体一致）——失败方向只剩漏去重
+* （重复展示），不是误删（宁漏勿误）。
+*/
+function isCrossSourceDup(a, b) {
+	if (a.source === b.source) return false;
+	if (!a.source.includes("announcement") || !b.source.includes("announcement")) return false;
+	const ta = Date.parse(a.publishedAt);
+	const tb = Date.parse(b.publishedAt);
+	if (!Number.isFinite(ta) || !Number.isFinite(tb)) return false;
+	if (Math.abs(ta - tb) > 864e5) return false;
+	const na = normalizeAnnouncementTitle(a.title);
+	const nb = normalizeAnnouncementTitle(b.title);
+	if (na.length === 0 || nb.length === 0) return false;
+	if (na === nb) return true;
+	const n = Math.min(na.length, nb.length);
+	if (n < 8) return false;
+	let common = 0;
+	while (common < n && na[common] === nb[common]) common++;
+	if (common < 6) return false;
+	if (na.startsWith(nb) || nb.startsWith(na)) return false;
+	let suffix = 0;
+	while (suffix < n - common && na[na.length - 1 - suffix] === nb[nb.length - 1 - suffix]) suffix++;
+	return suffix >= 2;
+}
+function dedupeCrossSourceAnnouncements(items) {
+	const kept = [];
+	for (const item of items) if (!kept.some((k) => isCrossSourceDup(k, item))) kept.push(item);
+	return kept;
+}
+async function aggregateNews(options = {}) {
+	const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+	const now = options.now ?? Date.now();
+	const windowMs = clampNumber(options.windowHours, DEFAULT_WINDOW_HOURS, 1, 168) * 36e5;
+	const limit = clampNumber(options.limit, DEFAULT_LIMIT, 1, MAX_LIMIT);
+	const fetchers = [fetchEastmoneyHk(fetchImpl, limit)];
+	if (options.symbol && options.symbol.trim()) {
+		fetchers.push(fetchEastmoneyHkAnnouncements(fetchImpl, options.symbol, limit));
+		fetchers.push(fetchHkexAnnouncements(fetchImpl, options.symbol, limit, now));
+	}
+	const results = await Promise.allSettled(fetchers);
+	const items = [];
+	const unavailable = [];
+	for (const result of results) if (result.status === "fulfilled") for (const item of result.value) {
+		const maxAge = item.source.includes("announcement") ? ANNOUNCEMENT_MAX_AGE_MS : windowMs;
+		if (!inWindow(item.publishedAt, now, maxAge)) continue;
+		if (!matchesSymbol(item, options.symbol)) continue;
+		items.push(item);
+	}
+	else unavailable.push(result.reason instanceof Error ? result.reason.message : String(result.reason));
+	const deduped = dedupeCrossSourceAnnouncements(items);
+	deduped.sort((a, b) => Date.parse(b.publishedAt) - Date.parse(a.publishedAt));
+	return {
+		items: deduped.slice(0, limit),
+		unavailable
+	};
+}
+//#endregion
+export { aggregateNews, isHkRelevant, parseHkShowTime, parseHkexDateTime, resetHkexAnnouncementMemo };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dshtrading/kit-hk",
+  "description": "Hong Kong market toolkit plugin for dsh-trading: HK risk checklist skill provider and HK fast-news (degraded) / fundamentals tools; runs as an hk-trader preset row (session-scoped)",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "assets"
+  ],
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "dependencies": {
+    "@dshtrading/knowledge": "0.1.0",
+    "@dshtrading/indicators": "0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/dsh-skill": ">=0.1.2-alpha.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.1",
+    "@deepseek-ai/schemastery": ">=3.18.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.0",
+    "vitest": "^3.0.0",
+    "@dshtrading/api": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}