@dshtrading/kit-hk 0.1.0

package/lib/fundamentals.d.ts

@@ -0,0 +1,28 @@
+import { FinancialReportMatrix, FundamentalsPackage, StockFundamentals } from "./api/lib/index.js";
+//#region src/fundamentals.d.ts
+interface HkFundamentalsOptions {
+  symbol: string;
+  fetch?: typeof globalThis.fetch;
+}
+interface HkFundamentalsResult {
+  data?: StockFundamentals;
+  amplitudePercent?: number;
+  turnoverValueHkd?: number;
+  nameEn?: string;
+  unavailable?: string[];
+}
+/** 规范化港股代码：接受 00700 / 700 / 00700.HK / 700.hk，输出 5 位补零代码与规范符号 00700.HK。 */
+declare function normalizeHkSymbol(input: string): {
+  code5: string;
+  canonical: string;
+};
+declare function fetchHkFundamentals(options: HkFundamentalsOptions): Promise<HkFundamentalsResult>;
+/** 格式化港股财报日期为期别标签（YYYY/Q1, YYYY/H1, YYYY/Q3, YYYY/FY）。 */
+declare function formatHkReportPeriod(dateStr: string): string;
+/** 从东财/公开端点动态拉取港股多期财务指标。 */
+declare function fetchHkFinancialMatrix(symbol: string, fetchImpl?: typeof globalThis.fetch): Promise<FinancialReportMatrix | undefined>;
+/** 获取完整港股基本面数据包。 */
+declare function fetchHkFundamentalsPackage(symbol: string, fetchImpl?: typeof globalThis.fetch): Promise<FundamentalsPackage>;
+declare function renderHkFundamentals(result: HkFundamentalsResult, requestedSymbol: string): string;
+//#endregion
+export { HkFundamentalsOptions, HkFundamentalsResult, fetchHkFinancialMatrix, fetchHkFundamentals, fetchHkFundamentalsPackage, formatHkReportPeriod, normalizeHkSymbol, renderHkFundamentals };

package/lib/fundamentals.js

@@ -0,0 +1,216 @@
+//#region src/fundamentals.ts
+const TENCENT_HK_QUOTE_BASE = "https://qt.gtimg.cn/q=r_hk";
+/**
+* 东财公开端点统一取数（2026-09-02 审查整改）：最小 UA（不做浏览器伪装/伪造
+* Referer，docs/replication.md 数据源边界）+ 10s AbortSignal 超时（对齐
+* connector-tencent 模式，防爬取端点挂起拖死桥请求）。
+*/
+const UPSTREAM_TIMEOUT_MS = 1e4;
+async function fetchJsonUpstream(url, fetchImpl) {
+	const res = await fetchImpl(url, {
+		headers: { "User-Agent": "Mozilla/5.0" },
+		signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)
+	});
+	if (!res.ok) return void 0;
+	return await res.json();
+}
+/** 规范化港股代码：接受 00700 / 700 / 00700.HK / 700.hk，输出 5 位补零代码与规范符号 00700.HK。 */
+function normalizeHkSymbol(input) {
+	const raw = input.trim().toLowerCase().replace(/\.hk$/, "");
+	if (!/^\d{1,5}$/.test(raw)) throw new Error(`hk_get_fundamentals: invalid HK stock symbol ${JSON.stringify(input)} — expected e.g. 00700, 700, 00700.HK`);
+	const code5 = raw.padStart(5, "0");
+	return {
+		code5,
+		canonical: `${code5}.HK`
+	};
+}
+function num(val) {
+	if (val === void 0 || val === "") return void 0;
+	const n = Number(val);
+	return Number.isFinite(n) ? n : void 0;
+}
+async function fetchHkFundamentals(options) {
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	const { code5, canonical } = normalizeHkSymbol(options.symbol);
+	const unavailable = [];
+	try {
+		const res = await fetchImpl(`${TENCENT_HK_QUOTE_BASE}${code5}`);
+		if (!res.ok) throw new Error(`HTTP ${res.status}`);
+		const buf = await res.arrayBuffer();
+		const text = new TextDecoder("gbk").decode(buf);
+		const match = /="([^"]+)"/.exec(text);
+		if (!match || !match[1]) throw new Error(`no quote data returned for r_hk${code5}`);
+		const fields = match[1].split("~");
+		if (fields.length < 45) throw new Error(`incomplete quote data received for r_hk${code5} (fields: ${fields.length})`);
+		const name = fields[1];
+		num(fields[3]);
+		const turnoverValueHkd = num(fields[37]);
+		const peDynamic = num(fields[39]);
+		const amplitudePercent = num(fields[43]);
+		const totalMarketCapYi = num(fields[44]);
+		const floatMarketCapYi = num(fields[45]);
+		const nameEn = fields[46];
+		const dividendYield = num(fields[47]);
+		const fiftyTwoWeekHigh = num(fields[48]);
+		const fiftyTwoWeekLow = num(fields[49]);
+		const peTtm = num(fields[57]) ?? peDynamic;
+		const pb = num(fields[58]);
+		const turnoverRate = num(fields[59]);
+		return {
+			data: {
+				symbol: canonical,
+				name,
+				marketCap: totalMarketCapYi ? totalMarketCapYi * 1e8 : void 0,
+				floatMarketCap: floatMarketCapYi ? floatMarketCapYi * 1e8 : void 0,
+				peTtm,
+				peDynamic,
+				pb,
+				dividendYield: dividendYield ? dividendYield / 100 : void 0,
+				turnoverRate,
+				fiftyTwoWeekHigh,
+				fiftyTwoWeekLow,
+				timestamp: Date.now()
+			},
+			amplitudePercent,
+			turnoverValueHkd,
+			nameEn,
+			unavailable
+		};
+	} catch (err) {
+		unavailable.push(`tencent-hk-quote: ${err instanceof Error ? err.message : String(err)}`);
+		return { unavailable };
+	}
+}
+/** 格式化港股财报日期为期别标签（YYYY/Q1, YYYY/H1, YYYY/Q3, YYYY/FY）。 */
+function formatHkReportPeriod(dateStr) {
+	if (!dateStr) return "";
+	const m = /(\d{4})[-/](\d{2})[-/](\d{2})/.exec(dateStr);
+	if (!m) return dateStr.slice(0, 7);
+	const [, y, mo] = m;
+	if (mo === "03" || mo === "3") return `${y}/Q1`;
+	if (mo === "06" || mo === "6") return `${y}/H1`;
+	if (mo === "09" || mo === "9") return `${y}/Q3`;
+	if (mo === "12") return `${y}/FY`;
+	return `${y}/${mo}`;
+}
+/** 从东财/公开端点动态拉取港股多期财务指标。 */
+async function fetchHkFinancialMatrix(symbol, fetchImpl = globalThis.fetch) {
+	try {
+		const { code5 } = normalizeHkSymbol(symbol);
+		const json = await fetchJsonUpstream(`https://datacenter-web.eastmoney.com/api/data/v1/get?reportName=RPT_HKF10_FN_MAININDICATOR&columns=ALL&filter=(SECUCODE%3D%22${code5}.HK%22)&pageNumber=1&pageSize=8&sortTypes=-1&sortColumns=REPORT_DATE`, fetchImpl);
+		if (json === void 0) return void 0;
+		const rawRows = json.result?.data;
+		if (!Array.isArray(rawRows) || rawRows.length === 0) return void 0;
+		const list = [...rawRows].reverse();
+		const periods = list.map((r) => formatHkReportPeriod(String(r.REPORT_DATE ?? "")));
+		const latestPeriod = periods[periods.length - 1] ?? "";
+		const latestReportTitle = latestPeriod ? `${latestPeriod.replace("/", "财年")} 财报` : void 0;
+		const makeRow = (id, name, valKey, yoyKey, unit) => {
+			const values = {};
+			list.forEach((r, idx) => {
+				const p = periods[idx];
+				const rawVal = r[valKey];
+				const val = typeof rawVal === "number" && Number.isFinite(rawVal) ? rawVal : void 0;
+				let changePercent;
+				if (yoyKey && typeof r[yoyKey] === "number") changePercent = r[yoyKey];
+				values[p] = {
+					value: val,
+					changePercent
+				};
+			});
+			return {
+				id,
+				name,
+				unit,
+				values
+			};
+		};
+		return {
+			currency: "HKD",
+			latestReportTitle,
+			periods,
+			groups: [
+				{
+					id: "per_share",
+					title: "每股指标",
+					rows: [
+						makeRow("bps", "每股净资产", "BPS", "BPS_YOY", "HKD"),
+						makeRow("basic_eps", "基本每股收益", "BASIC_EPS", "BASIC_EPS_YOY", "HKD"),
+						makeRow("dividend_ps", "每股股息", "DPS", void 0, "HKD")
+					]
+				},
+				{
+					id: "profitability",
+					title: "盈利能力",
+					rows: [
+						makeRow("gross_margin", "销售毛利率", "GROSS_PROFIT_RATIO", void 0, "%"),
+						makeRow("net_margin", "销售净利率", "NET_PROFIT_RATIO", void 0, "%"),
+						makeRow("roe", "净资产收益率 (ROE)", "ROE", void 0, "%"),
+						makeRow("roa", "总资产收益率 (ROA)", "ROA", void 0, "%")
+					]
+				},
+				{
+					id: "growth",
+					title: "收益与成长",
+					rows: [makeRow("revenue", "营业总收入", "TOTAL_OPERATE_INCOME", "TOTAL_OPERATE_INCOME_YOY", "HKD"), makeRow("net_profit", "股东应占溢利/净利润", "PARENT_NETPROFIT", "PARENT_NETPROFIT_YOY", "HKD")]
+				}
+			]
+		};
+	} catch {
+		return;
+	}
+}
+/** 获取完整港股基本面数据包。 */
+async function fetchHkFundamentalsPackage(symbol, fetchImpl = globalThis.fetch) {
+	const { canonical } = normalizeHkSymbol(symbol);
+	const [quoteRes, matrix] = await Promise.all([fetchHkFundamentals({
+		symbol,
+		fetch: fetchImpl
+	}), fetchHkFinancialMatrix(symbol, fetchImpl)]);
+	const stock = quoteRes.data ? {
+		...quoteRes.data,
+		amplitudePercent: quoteRes.amplitudePercent
+	} : void 0;
+	return {
+		market: "hk",
+		symbol: canonical,
+		stock,
+		matrix,
+		profile: stock ? {
+			symbol: canonical,
+			name: stock.name ?? quoteRes.nameEn,
+			description: `${stock.name ?? canonical}（港股上市公司），包含港股每股指标、盈利能力与历史多期财报。`
+		} : void 0
+	};
+}
+function renderHkFundamentals(result, requestedSymbol) {
+	const { data, amplitudePercent, turnoverValueHkd, nameEn, unavailable = [] } = result;
+	if (!data) return `hk_get_fundamentals ${requestedSymbol}: no fundamental data available.${unavailable.length > 0 ? ` (errors: ${unavailable.join("; ")})` : ""}`;
+	const lines = [`hk_get_fundamentals ${data.symbol}${data.name ? ` (${data.name})` : ""}${nameEn ? ` [${nameEn}]` : ""}:`];
+	if (data.marketCap !== void 0) {
+		const yi = (data.marketCap / 1e8).toFixed(2);
+		lines.push(`- 总市值: ${yi} 亿港元 (HKD)`);
+	}
+	if (data.floatMarketCap !== void 0) {
+		const yi = (data.floatMarketCap / 1e8).toFixed(2);
+		lines.push(`- 流通市值: ${yi} 亿港元 (HKD)`);
+	}
+	if (data.peTtm !== void 0) lines.push(`- 滚动市盈率 (PE TTM): ${data.peTtm.toFixed(2)}`);
+	if (data.peDynamic !== void 0) lines.push(`- 动态市盈率: ${data.peDynamic.toFixed(2)}`);
+	if (data.pb !== void 0) lines.push(`- 市净率 (PB): ${data.pb.toFixed(2)}`);
+	if (data.dividendYield !== void 0) {
+		const pct = (data.dividendYield * 100).toFixed(2);
+		lines.push(`- 股息率 (Dividend Yield): ${pct}%`);
+	}
+	if (data.turnoverRate !== void 0) lines.push(`- 换手率: ${data.turnoverRate.toFixed(2)}%`);
+	if (amplitudePercent !== void 0) lines.push(`- 振幅: ${amplitudePercent.toFixed(2)}%`);
+	if (turnoverValueHkd !== void 0) {
+		const yi = (turnoverValueHkd / 1e8).toFixed(2);
+		lines.push(`- 今日成交额: ${yi} 亿港元`);
+	}
+	if (data.fiftyTwoWeekLow !== void 0 && data.fiftyTwoWeekHigh !== void 0) lines.push(`- 52 周最高/最低: HK$${data.fiftyTwoWeekLow.toFixed(3)} ~ HK$${data.fiftyTwoWeekHigh.toFixed(3)}`);
+	if (unavailable.length > 0) lines.push(`  (errors: ${unavailable.join("; ")})`);
+	return lines.join("\n");
+}
+//#endregion
+export { fetchHkFinancialMatrix, fetchHkFundamentals, fetchHkFundamentalsPackage, formatHkReportPeriod, normalizeHkSymbol, renderHkFundamentals };

package/lib/index.d.ts

@@ -0,0 +1,21 @@
+import { HkFundamentalsOptions, HkFundamentalsResult, fetchHkFinancialMatrix, fetchHkFundamentals, fetchHkFundamentalsPackage, formatHkReportPeriod, normalizeHkSymbol, renderHkFundamentals } from "./fundamentals.js";
+import { AggregateNewsOptions, AggregateNewsResult, NewsItem, NewsSource, aggregateNews, isHkRelevant, parseHkShowTime, parseHkexDateTime, resetHkexAnnouncementMemo } from "./news.js";
+import Schema from "@deepseek-ai/schemastery";
+import { SkillProvider } from "@deepseek-ai/dsh-skill";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+declare const provider: SkillProvider;
+interface Config {
+  dryRun: boolean;
+  liveTrading: boolean;
+}
+declare const Config: Schema<Config>;
+declare const inject: string[];
+declare const name = "dsh-trading-hk-kit";
+declare function apply(ctx: Context, _config: Config): void;
+declare function createGetNewsTool(): import("@deepseek-ai/dsh-tools").ToolDefinition;
+declare function createGetFundamentalsTool(options?: {
+  fetch?: typeof globalThis.fetch;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//#endregion
+export { AggregateNewsOptions, AggregateNewsResult, Config, HkFundamentalsOptions, HkFundamentalsResult, NewsItem, NewsSource, aggregateNews, apply, createGetFundamentalsTool, createGetNewsTool, fetchHkFinancialMatrix, fetchHkFundamentals, fetchHkFundamentalsPackage, formatHkReportPeriod, inject, isHkRelevant, name, normalizeHkSymbol, parseHkShowTime, parseHkexDateTime, provider, renderHkFundamentals, resetHkexAnnouncementMemo };

package/lib/index.js

@@ -0,0 +1,224 @@
+import { aggregateNews, isHkRelevant, parseHkShowTime, parseHkexDateTime, resetHkexAnnouncementMemo } from "./news.js";
+import { fetchHkFinancialMatrix, fetchHkFundamentals, fetchHkFundamentalsPackage, formatHkReportPeriod, normalizeHkSymbol, renderHkFundamentals } from "./fundamentals.js";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import Schema from "@deepseek-ai/schemastery";
+import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import { createGetIndicatorsTool } from "@dshtrading/indicators/tool";
+//#region src/index.ts
+/**
+* HK 工具箱插件（dsh-trading hk 切片）。
+*
+* 包含：
+*   1. skill provider：hk-risk-checklist、indicator-authoring、trading-strategy-paradigms、knowledge-curation 与 trading-notes-setup 随包分发；
+*   2. hk_get_news 与 hk_get_fundamentals 工具；
+*   3. indicator_author 创作工具（Issue #19）；
+*   4. knowledge_ingest 与 knowledge_search 知识库工具（Issue #24）。
+*
+* @module @dshtrading/kit-hk
+*/
+const PROVIDER_NAME = "dsh-trading-hk";
+const SKILL_BODY_URL = new URL("../assets/skills/hk-risk-checklist.md", import.meta.url);
+const AUTHORING_BODY_URL = new URL("../assets/skills/indicator-authoring.md", import.meta.url);
+const STRATEGY_BODY_URL = new URL("../assets/skills/trading-strategy-paradigms.md", import.meta.url);
+const KNOWLEDGE_CURATION_BODY_URL = new URL("../assets/skills/knowledge-curation.md", import.meta.url);
+const JOURNAL_BODY_URL = new URL("../assets/skills/trading-notes-setup.md", import.meta.url);
+const RESOURCE_BASE = {
+	kind: "directory",
+	path: fileURLToPath(new URL("../assets/skills/", import.meta.url))
+};
+const CANDIDATE = {
+	name: "hk-risk-checklist",
+	description: "港股交易风控检查清单：开仓前逐项核对 T+0 回转与无涨跌幅限制、碎股（board lot）与手数、供股/配股摊薄、窝轮牛熊证杠杆与强制收回、港元汇率与港股通差异。",
+	invocation: {
+		modelInvocable: true,
+		userInvocable: true
+	},
+	provider: PROVIDER_NAME,
+	source: "bundled",
+	resourceBase: RESOURCE_BASE,
+	rank: BUNDLED_SKILL_RANK,
+	locator: SKILL_BODY_URL
+};
+const SKILL_CANDIDATES = [
+	CANDIDATE,
+	{
+		name: "indicator-authoring",
+		description: "自定义技术指标创作指南：根据用户自然语言需求生成符合契约的指标代码（TD9/SuperTrend/OBV+MA等），并通过 indicator_author 工具验证与落库。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: AUTHORING_BODY_URL
+	},
+	{
+		name: "trading-strategy-paradigms",
+		description: "经典交易策略参考范式指南：提供短线（唐奇安突破/RSI极值回归）、波段（EMA双均线/布林带下轨回归）、长线（200日均线基线/12月动量）6大策略原理、参数调优、8项回测指标研读与风险防范 SOP。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: STRATEGY_BODY_URL
+	},
+	{
+		name: "knowledge-curation",
+		description: "财经观点沉淀与知识库策展指南：基于 Content Insight 事实核查产物，规范化提取知识卡片字段、受控词表对齐、查重与关联建立，通过 knowledge_ingest 工具入库。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: KNOWLEDGE_CURATION_BODY_URL
+	},
+	{
+		name: "trading-notes-setup",
+		description: "交易日志建立与记录规范：检查/创建工作区 .trading-journal/ 双轨目录（agent 轨 + human 轨），分别记录 agent 与人类各自的操作。会话启动检查发现工作区没有交易日志目录时调用本技能建立骨架；记录条目格式以本技能为权威。",
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		},
+		provider: PROVIDER_NAME,
+		source: "bundled",
+		resourceBase: RESOURCE_BASE,
+		rank: BUNDLED_SKILL_RANK,
+		locator: JOURNAL_BODY_URL
+	}
+];
+const provider = {
+	name: PROVIDER_NAME,
+	list: () => Promise.resolve(SKILL_CANDIDATES),
+	async get(candidate) {
+		const target = SKILL_CANDIDATES.find((c) => c.name === candidate.name) ?? CANDIDATE;
+		return {
+			name: target.name,
+			description: target.description,
+			invocation: target.invocation,
+			provider: target.provider,
+			source: target.source,
+			resourceBase: RESOURCE_BASE,
+			content: await readFile(target.locator, "utf8")
+		};
+	}
+};
+const Config = Schema.object({
+	dryRun: Schema.boolean().default(true),
+	liveTrading: Schema.boolean().default(false)
+});
+const inject = ["skills", "tools"];
+const name = "dsh-trading-hk-kit";
+function apply(ctx, _config) {
+	ctx.skills.registerProvider(() => provider);
+	const newsTool = createGetNewsTool();
+	const fundamentalsTool = createGetFundamentalsTool();
+	const tools = ctx.tools;
+	const registerOnce = (tool) => {
+		if (tools.get(tool.name) !== void 0) {
+			ctx.logger("dsh-trading-hk-kit").info("[dsh-trading-hk-kit] tool %s already registered by another provider — skipped (mutual exclusion)", tool.name);
+			return;
+		}
+		tools.register(tool);
+	};
+	registerOnce(newsTool);
+	registerOnce(fundamentalsTool);
+	const serviceGetter = ctx;
+	const marketData = (serviceGetter.get?.("tradingMarketDataRegistry", false))?.active("hk")?.service ?? serviceGetter.get?.("tradingHkMarketData", false);
+	if (marketData !== void 0) registerOnce(createGetIndicatorsTool({
+		marketData,
+		market: "hk"
+	}));
+	const lifecycle = ctx;
+	lifecycle.inject?.(["tradingNewsRegistry"], (scope) => {
+		const registry = scope.tradingNewsRegistry;
+		if (registry && typeof registry.register === "function") lifecycle.effect?.(() => registry.register("hk", aggregateNews), "kit-hk news registration");
+	});
+}
+const DEFAULT_NEWS_WINDOW_HOURS = 24;
+const DEFAULT_NEWS_LIMIT = 20;
+function renderNewsItem(item) {
+	return `[${item.source}] ${item.publishedAt}  ${item.title}\n  ${item.url}`;
+}
+function createGetNewsTool() {
+	return defineTool({
+		name: "hk_get_news",
+		description: "Get recent Hong Kong stock market news, derived from Eastmoney financial fast-news (HK column) filtered to HK-relevant items (HKEX-listed marketId=116 codes or HK keywords). DEGRADED SOURCE — Eastmoney is a unified CN financial feed; HK coverage is PARTIAL (HK news without an HK-listed code or HK keyword is not captured; not a dedicated HK news source). Each item carries source name (东方财富), publish time and a link for traceability; fetches metadata only, never redistributes article bodies. Optionally filter by symbol (HK code, e.g. 00700 / 00700.HK) and by a time window. No credentials required.",
+		parameters: {
+			symbol: {
+				type: "string",
+				description: "Optional symbol to filter by, market-canonical vocabulary, e.g. 00700 or 00700.HK (Tencent). Best-effort matched against HK-listed stock codes."
+			},
+			windowHours: {
+				type: "number",
+				description: `Only keep items published within the last N hours (1-168, default ${DEFAULT_NEWS_WINDOW_HOURS}).`,
+				default: DEFAULT_NEWS_WINDOW_HOURS
+			},
+			limit: {
+				type: "number",
+				description: `Max items to return (1-50, default ${DEFAULT_NEWS_LIMIT}).`,
+				default: DEFAULT_NEWS_LIMIT
+			}
+		},
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const options = {
+				symbol: typeof args.symbol === "string" ? args.symbol : void 0,
+				windowHours: typeof args.windowHours === "number" ? args.windowHours : void 0,
+				limit: typeof args.limit === "number" ? args.limit : void 0
+			};
+			const { items, unavailable } = await aggregateNews(options);
+			if (items.length === 0 && unavailable.length === 0) return "hk_get_news: no news items found within the requested window (degraded source: Eastmoney HK column may have no HK-relevant items in-window).";
+			const symbolNote = options.symbol ? ` symbol=${options.symbol.trim()}` : "";
+			const lines = [`hk_get_news — ${items.length} item(s)${symbolNote}, window=${options.windowHours ?? DEFAULT_NEWS_WINDOW_HOURS}h (newest-first; DEGRADED — Eastmoney HK column, partial HK coverage):`, ...items.map(renderNewsItem)];
+			if (unavailable.length > 0) lines.push("  (source(s) unavailable this call: " + unavailable.join("; ") + ")");
+			return lines.join("\n");
+		}
+	});
+}
+function createGetFundamentalsTool(options = {}) {
+	return defineTool({
+		name: "hk_get_fundamentals",
+		description: "Get fundamental valuation and financial indicators for Hong Kong stocks (Total Market Cap, Float Market Cap, Dynamic P/E, Trailing P/E, P/B, Dividend Yield, Turnover Rate, Amplitude, Turnover Value, 52-Week Range) via Tencent HK public market quote API. Accepts market-canonical code (e.g. 00700.HK) or 1-5 digit code (700, 00700). No credentials required.",
+		parameters: { symbol: {
+			type: "string",
+			required: true,
+			description: "Hong Kong stock symbol or code, market-canonical vocabulary, e.g. 00700.HK, 09988.HK, 00700, 700"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: String(value)
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const symbol = typeof args.symbol === "string" ? args.symbol.trim() : "";
+			if (!symbol) throw new Error("hk_get_fundamentals: symbol parameter is required (e.g. 00700.HK or 00700)");
+			const result = await fetchHkFundamentals({
+				symbol,
+				fetch: options.fetch
+			});
+			return renderHkFundamentals(result, symbol);
+		}
+	});
+}
+//#endregion
+export { Config, aggregateNews, apply, createGetFundamentalsTool, createGetNewsTool, fetchHkFinancialMatrix, fetchHkFundamentals, fetchHkFundamentalsPackage, formatHkReportPeriod, inject, isHkRelevant, name, normalizeHkSymbol, parseHkShowTime, parseHkexDateTime, provider, renderHkFundamentals, resetHkexAnnouncementMemo };

package/lib/news.d.ts

@@ -0,0 +1,51 @@
+//#region src/news.d.ts
+/**
+ * hk_get_news 取数层（WS4 #1：#6 子工作流；spike EVIDENCE 判定 hk 无干净公共源 → 采用「降级」方案）。
+ *
+ * 降级口径（用户裁决 2026-08-30）：用东方财富快讯第 103 列（「港股」列，但实为统一 CN 金融流、覆盖不纯），
+ * 客户端按 `stockList` 中的**港交所 marketId=116** 代码 + 标题港股关键词过滤出港股相关标的新闻。诚实标注：
+ * 覆盖**部分**（港股新闻若不带港股关联代码/关键词则不捕获），非专用港股新闻源；与 CryptoPanic 的降级同理。
+ *
+ * 公告双源（2026-09-03，多供应商冗余裁决；spikes/impl-hk-cn-announce-sources/ EVIDENCE）：
+ * 东财 ann_type=H（主源，秒级时间）+ HKEX 披露易 titleSearchServlet（备份源），allSettled 并行 +
+ * 跨源去重（±24h 内：归一化标题全文等值，或共同前缀 ≥6 字且共同后缀 ≥2 字——
+ * 2026-09-03 评审 M1 收紧：裸类别短标题/严格前缀对/泛化日期头同日不同文件不判重，
+ * 失败方向宁漏勿误，繁体经映射表转简体后比对）。
+ *
+ * 铁律 #5：只引 title/showTime/链接（元数据），不取 summary/正文，不再分发。每源失败 fail-soft。
+ */
+type NewsSource = 'eastmoney' | 'eastmoney-announcement' | 'hkex-announcement';
+interface NewsItem {
+  source: string;
+  title: string;
+  url: string;
+  publishedAt: string;
+  relatedCodes?: string[];
+}
+interface AggregateNewsOptions {
+  /** 标的（市场规范词汇，如 00700 / 00700.HK / 0700）；缺省 = 不过滤。 */
+  symbol?: string | undefined;
+  windowHours?: number | undefined;
+  limit?: number | undefined;
+  fetch?: typeof globalThis.fetch | undefined;
+  now?: number | undefined;
+  /** CryptoPanic API token（桥面透传，hk 聚合器忽略；对齐 api 契约形状）。 */
+  cryptoPanicKey?: string | undefined;
+}
+interface AggregateNewsResult {
+  items: NewsItem[];
+  unavailable: string[];
+}
+declare function parseHkShowTime(showTime: string): number;
+/** 港股相关性：stockList 含 116. 前缀代码（港交所），或 title 含港股关键词。 */
+declare function isHkRelevant(item: {
+  title: string;
+  relatedCodes?: string[];
+}): boolean;
+/** 清空 HKEX stockId memo（单测隔离用；生产运行期不需要调用）。 */
+declare function resetHkexAnnouncementMemo(): void;
+/** HKEX 披露易 DATE_TIME：`DD/MM/YYYY HH:MM`（日/月倒序，港图时间东八区）→ 毫秒。 */
+declare function parseHkexDateTime(value: string): number;
+declare function aggregateNews(options?: AggregateNewsOptions): Promise<AggregateNewsResult>;
+//#endregion
+export { AggregateNewsOptions, AggregateNewsResult, NewsItem, NewsSource, aggregateNews, isHkRelevant, parseHkShowTime, parseHkexDateTime, resetHkexAnnouncementMemo };