@dshtrading/connector-jin10 0.3.0

package/lib/mcp.js

@@ -0,0 +1,222 @@
+import { Jin10Error, TOKEN_HINT, codeForUpstreamMessage } from "./errors.js";
+//#region src/mcp.ts
+/**
+* MCP 传输层（Streamable HTTP / JSON-RPC 2.0）。
+*
+* 标准流程（用户 2026-09-13 给定契约，本出口实测复核）：
+*   initialize → notifications/initialized → tools/list / resources/list / resources/read → tools/call
+* 响应形态两种都要吃：`application/json` 直出 JSON，或 `text/event-stream` 里
+* `event: message` + 单行 `data: {…}`（金十本出口实测为后者）。若上游回
+* `mcp-session-id` 头则后续请求原样回带（本出口当前无会话头，属可选能力）。
+*
+* 结果读取：`result.structuredContent` 优先，`result.content[].text` 仅在
+* structuredContent 缺席时作可读文本兜底（用户契约 3/4）。
+*/
+const DEFAULT_ENDPOINT = "https://mcp.jin10.com/mcp";
+const DEFAULT_PROTOCOL_VERSION = "2025-11-25";
+const DEFAULT_TIMEOUT_MS = 15e3;
+/** 把响应体解析成 JSON-RPC 消息（直出 JSON 或 SSE 单行 data 均可）。 */
+function parseMcpBody(text) {
+	const trimmed = text.trim();
+	if (trimmed.length === 0) return void 0;
+	if (trimmed.startsWith("{")) {
+		const parsed = JSON.parse(trimmed);
+		return isRecord(parsed) ? parsed : void 0;
+	}
+	const candidates = [];
+	const pending = [];
+	const flush = () => {
+		if (pending.length === 0) return;
+		const payload = pending.join("\n").trim();
+		pending.length = 0;
+		if (payload.length === 0) return;
+		try {
+			const parsed = JSON.parse(payload);
+			if (isRecord(parsed)) candidates.push(parsed);
+		} catch {}
+	};
+	for (const line of trimmed.split(/\r?\n/)) if (line.startsWith("data:")) pending.push(line.slice(5).replace(/^ /, ""));
+	else if (line.trim().length === 0) flush();
+	flush();
+	const message = candidates[candidates.length - 1];
+	if (message === void 0) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp: response is neither JSON nor a JSON-RPC SSE message — ${trimmed.slice(0, 200)}`);
+	return message;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function networkError(method, cause) {
+	const reason = cause instanceof Error ? cause.message : String(cause);
+	const timedOut = cause instanceof Error && (cause.name === "TimeoutError" || cause.name === "AbortError");
+	return new Jin10Error("TRADING_NETWORK", `jin10 mcp ${method}: ${timedOut ? "request timed out" : "network failure"} — ${reason}`, cause);
+}
+var Jin10McpClient = class {
+	endpoint;
+	token;
+	timeoutMs;
+	fetchImpl;
+	protocolVersion;
+	clientName;
+	clientVersion;
+	nextId = 1;
+	sessionId;
+	handshake;
+	constructor(options) {
+		this.endpoint = options.endpoint ?? "https://mcp.jin10.com/mcp";
+		this.token = options.token;
+		this.timeoutMs = options.timeoutMs ?? 15e3;
+		this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+		this.protocolVersion = options.protocolVersion ?? "2025-11-25";
+		this.clientName = options.clientName ?? "dsh-trading-connector-jin10";
+		this.clientVersion = options.clientVersion ?? "0.2.1";
+	}
+	async listTools() {
+		const result = await this.rpc("tools/list", {});
+		const tools = isRecord(result) ? result.tools : void 0;
+		if (!Array.isArray(tools)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 mcp tools/list: unexpected payload (expected result.tools[])");
+		return tools.filter(isRecord).map((tool) => ({
+			name: String(tool.name ?? ""),
+			...typeof tool.description === "string" ? { description: tool.description } : {},
+			...tool.inputSchema !== void 0 ? { inputSchema: tool.inputSchema } : {},
+			...tool.outputSchema !== void 0 ? { outputSchema: tool.outputSchema } : {}
+		}));
+	}
+	async listResources() {
+		const result = await this.rpc("resources/list", {});
+		const resources = isRecord(result) ? result.resources : void 0;
+		if (!Array.isArray(resources)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 mcp resources/list: unexpected payload (expected result.resources[])");
+		return resources.filter(isRecord).map((resource) => ({
+			uri: String(resource.uri ?? ""),
+			...typeof resource.name === "string" ? { name: resource.name } : {},
+			...typeof resource.mimeType === "string" ? { mimeType: resource.mimeType } : {},
+			...typeof resource.description === "string" ? { description: resource.description } : {}
+		}));
+	}
+	/** 读资源正文（quote://codes 等；返回全部 text 段拼接）。 */
+	async readResource(uri) {
+		const result = await this.rpc("resources/read", { uri });
+		const contents = isRecord(result) ? result.contents : void 0;
+		if (!Array.isArray(contents)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp resources/read ${uri}: unexpected payload (expected result.contents[])`);
+		return contents.filter(isRecord).map((entry) => typeof entry.text === "string" ? entry.text : "").join("");
+	}
+	/** 原始 tools/call（不做业务解包；协议/HTTP 错误在此抛出）。 */
+	async callTool(tool, args = {}) {
+		const result = await this.rpc("tools/call", {
+			name: tool,
+			arguments: args
+		});
+		if (!isRecord(result)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp tools/call ${tool}: unexpected payload (expected result object)`);
+		return {
+			...result.structuredContent !== void 0 ? { structuredContent: result.structuredContent } : {},
+			...Array.isArray(result.content) ? { content: result.content.filter(isRecord) } : {},
+			...typeof result.isError === "boolean" ? { isError: result.isError } : {}
+		};
+	}
+	/**
+	* 业务取数：structuredContent 优先，text 兜底；`isError`/`status !== 200`/`data === null`
+	* 都按上游业务错误抛出（含限流文案识别）。返回上游 `data` 字段。
+	*/
+	async callToolData(tool, args = {}) {
+		const result = await this.callTool(tool, args);
+		const envelope = result.structuredContent ?? textEnvelope(result);
+		if (envelope === void 0) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp tools/call ${tool}: no structuredContent and no machine-readable text payload`);
+		if (!isRecord(envelope)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp tools/call ${tool}: unexpected payload (expected an object envelope)`);
+		const message = typeof envelope.message === "string" ? envelope.message : "";
+		const status = typeof envelope.status === "number" ? envelope.status : void 0;
+		if (result.isError === true) throw new Jin10Error(codeForUpstreamMessage(message), `jin10 ${tool}: ${message || "upstream reported isError=true"}${status !== void 0 ? ` (status ${status})` : ""}`);
+		if (status !== void 0 && status !== 200) throw new Jin10Error(codeForUpstreamMessage(message), `jin10 ${tool}: upstream status ${status}${message ? ` — ${message}` : ""}`);
+		if (envelope.data === null || envelope.data === void 0) throw new Jin10Error(codeForUpstreamMessage(message), `jin10 ${tool}: upstream returned no data${message ? ` — ${message}` : ""}`);
+		return envelope.data;
+	}
+	async ensureHandshake() {
+		if (this.handshake === void 0) this.handshake = this.performHandshake().catch((error) => {
+			this.handshake = void 0;
+			throw error;
+		});
+		return this.handshake;
+	}
+	async performHandshake() {
+		await this.rpc("initialize", {
+			protocolVersion: this.protocolVersion,
+			capabilities: {},
+			clientInfo: {
+				name: this.clientName,
+				version: this.clientVersion
+			}
+		}, { skipHandshake: true });
+		await this.rpc("notifications/initialized", void 0, {
+			notification: true,
+			skipHandshake: true
+		});
+	}
+	async rpc(method, params, options = {}) {
+		if (options.skipHandshake !== true) await this.ensureHandshake();
+		const token = this.token();
+		if (token === void 0 || token.trim().length === 0) throw new Jin10Error("TRADING_CREDENTIALS_MISSING", `jin10 mcp ${method}: missing MCP token. ${TOKEN_HINT}`);
+		const payload = {
+			jsonrpc: "2.0",
+			method
+		};
+		if (options.notification !== true) payload.id = this.nextId++;
+		if (params !== void 0) payload.params = params;
+		let response;
+		try {
+			response = await this.fetchImpl(this.endpoint, {
+				method: "POST",
+				headers: {
+					"content-type": "application/json",
+					accept: "application/json, text/event-stream",
+					authorization: `Bearer ${token.trim()}`,
+					...this.sessionId !== void 0 ? { "mcp-session-id": this.sessionId } : {}
+				},
+				body: JSON.stringify(payload),
+				signal: AbortSignal.timeout(this.timeoutMs)
+			});
+		} catch (error) {
+			throw networkError(method, error);
+		}
+		const sessionId = response.headers.get("mcp-session-id");
+		if (sessionId !== null && sessionId.length > 0) this.sessionId = sessionId;
+		if (response.status === 401 || response.status === 403) {
+			const body = await response.text().catch(() => "");
+			throw new Jin10Error("TRADING_AUTH_FAILED", `jin10 mcp ${method}: HTTP ${response.status} — invalid or expired MCP token. ${TOKEN_HINT}${body ? ` (${body.slice(0, 160)})` : ""}`);
+		}
+		if (response.status === 429) {
+			const body = await response.text().catch(() => "");
+			throw new Jin10Error("TRADING_RATE_LIMITED", `jin10 mcp ${method}: HTTP 429 — rate limited${body ? ` — ${body.slice(0, 160)}` : ""}`);
+		}
+		if (!response.ok) {
+			const body = await response.text().catch(() => "");
+			throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp ${method}: HTTP ${response.status}${body ? ` — ${body.slice(0, 200)}` : ""}`);
+		}
+		const message = parseMcpBody(await response.text().catch((error) => {
+			throw networkError(method, error);
+		}));
+		if (message === void 0) return void 0;
+		if (isRecord(message.error)) {
+			const code = codeOf(message.error.code);
+			const detail = typeof message.error.message === "string" ? message.error.message : "JSON-RPC error";
+			throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 mcp ${method}: JSON-RPC error ${code ?? ""} — ${detail}`.replace("  ", " "), message.error);
+		}
+		return message.result;
+	}
+};
+function codeOf(value) {
+	return typeof value === "number" || typeof value === "string" ? value : void 0;
+}
+/** structuredContent 缺席时的可读文本兜底：content[].text 若能解析成 JSON 信封则采用。 */
+function textEnvelope(result) {
+	for (const part of result.content ?? []) {
+		if (typeof part.text !== "string") continue;
+		const text = part.text.trim();
+		if (!text.startsWith("{")) continue;
+		try {
+			const parsed = JSON.parse(text);
+			if (isRecord(parsed) && ("data" in parsed || "status" in parsed || "message" in parsed)) return parsed;
+		} catch {
+			continue;
+		}
+	}
+}
+//#endregion
+export { DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, Jin10McpClient, parseMcpBody };

package/lib/parse.d.ts

@@ -0,0 +1,78 @@
+import { NewsItem } from "@dshtrading/api";
+//#region src/parse.d.ts
+/** 快讯/资讯条目（NewsItem 契约 + 金十来源标识）。 */
+interface Jin10NewsItem extends NewsItem {
+  readonly source: 'jin10';
+}
+/** 资讯文章摘要条目（带 id，供 news_get 下钻）。 */
+interface Jin10ArticleSummary extends Jin10NewsItem {
+  readonly id: string;
+}
+interface Jin10NewsPage<T> {
+  items: T[];
+  nextCursor?: string;
+  hasMore: boolean;
+}
+interface Jin10ArticleDetail {
+  id: string;
+  title: string;
+  url: string;
+  publishedAt: string;
+  introduction?: string;
+}
+interface Jin10CalendarEntry {
+  publishedAt: string;
+  star: number;
+  title: string;
+  previous?: string;
+  consensus?: string;
+  actual?: string;
+  revised?: string;
+  affect?: string;
+}
+interface Jin10Instrument {
+  code: string;
+  name: string;
+}
+interface Jin10Quote {
+  code: string;
+  name?: string;
+  time?: string;
+  open?: number;
+  close?: number;
+  high?: number;
+  low?: number;
+  volume?: number;
+  change?: number;
+  changePercent?: number;
+}
+interface Jin10Kline {
+  time: number;
+  open?: number;
+  high?: number;
+  low?: number;
+  close?: number;
+  volume?: number;
+}
+/** 快讯标题：【标题】正文 → 取括号内；无括号 → 首段文本截断（正文绝不下发）。 */
+declare function flashTitle(content: string, maxLength?: number): string | undefined;
+/** 金十时间 → ISO：既吃 ISO（带 +08:00 偏移），也吃财经日历的无时区本地格式（按东八区解释）。 */
+declare function parseJin10Time(value: unknown): string | undefined;
+/** list_flash / search_flash 条目 → NewsItem（正文丢弃，只留标题/时间/链接）。 */
+declare function parseFlashItems(data: unknown, context?: string, limit?: number): Jin10NewsItem[];
+declare function parseFlashPage(data: unknown, context?: string, limit?: number): Jin10NewsPage<Jin10NewsItem>;
+/** list_news / search_news 条目 → 文章摘要（id/title/时间/链接）。 */
+declare function parseNewsItems(data: unknown, context?: string, limit?: number): Jin10ArticleSummary[];
+declare function parseNewsPage(data: unknown, context?: string, limit?: number): Jin10NewsPage<Jin10ArticleSummary>;
+/** get_news 详情：导语（introduction）作摘要下发；正文 content 按铁律 #5 丢弃。 */
+declare function parseArticle(data: unknown): Jin10ArticleDetail;
+/** list_calendar：data 为数组；pub_time 无时区，按东八区解释。 */
+declare function parseCalendar(data: unknown, limit?: number): Jin10CalendarEntry[];
+/** quote://codes 资源正文 → 品种表（`{data:[{code,name}]}`）。 */
+declare function parseQuoteCodes(resourceText: string): Jin10Instrument[];
+/** get_quote：价格字段是字符串，转数字；code 缺失视为形状异常。 */
+declare function parseQuote(data: unknown): Jin10Quote;
+/** get_kline：分钟级数组（time 为秒级时间戳）；空数组是合法结果（窗口内无数据）。 */
+declare function parseKlines(data: unknown, limit?: number): Jin10Kline[];
+//#endregion
+export { Jin10ArticleDetail, Jin10ArticleSummary, Jin10CalendarEntry, Jin10Instrument, Jin10Kline, Jin10NewsItem, Jin10NewsPage, Jin10Quote, flashTitle, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes };

package/lib/parse.js

@@ -0,0 +1,229 @@
+import { Jin10Error } from "./errors.js";
+//#region src/parse.ts
+/** 快讯标题：【标题】正文 → 取括号内；无括号 → 首段文本截断（正文绝不下发）。 */
+function flashTitle(content, maxLength = 120) {
+	const text = content.trim();
+	if (text.length === 0) return void 0;
+	const title = (/^【([^】]+)】/.exec(text)?.[1] ?? text.replace(/\s+/g, " ").split("。")[0] ?? text).trim();
+	if (title.length === 0) return void 0;
+	return title.length > maxLength ? `${title.slice(0, maxLength)}…` : title;
+}
+/** 金十时间 → ISO：既吃 ISO（带 +08:00 偏移），也吃财经日历的无时区本地格式（按东八区解释）。 */
+function parseJin10Time(value) {
+	if (typeof value !== "string") return void 0;
+	const text = value.trim();
+	if (text.length === 0) return void 0;
+	const local = /^(\d{4}-\d{2}-\d{2})[ T](\d{2}:\d{2})(?::(\d{2}))?$/.exec(text);
+	const candidate = local === null ? text : `${local[1] ?? ""}T${local[2] ?? ""}:${local[3] ?? "00"}+08:00`;
+	const ms = Date.parse(candidate);
+	return Number.isFinite(ms) ? new Date(ms).toISOString() : void 0;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function text(value) {
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+function numberValue(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	if (typeof value === "string") {
+		const parsed = Number(value.trim());
+		return value.trim().length > 0 && Number.isFinite(parsed) ? parsed : void 0;
+	}
+}
+function payloadItems(data, context) {
+	if (!isRecord(data)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 ${context}: unexpected payload (expected an object with items[])`);
+	const items = data.items;
+	if (!Array.isArray(items)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 ${context}: unexpected payload (expected data.items[])`);
+	return items;
+}
+function pageMeta(data) {
+	const record = isRecord(data) ? data : {};
+	const cursor = record.next_cursor;
+	return {
+		...typeof cursor === "string" && cursor.length > 0 ? { nextCursor: cursor } : {},
+		hasMore: record.has_more === true
+	};
+}
+function capItems(items, limit) {
+	if (limit === void 0 || items.length <= limit) return items;
+	return items.slice(0, limit);
+}
+/** list_flash / search_flash 条目 → NewsItem（正文丢弃，只留标题/时间/链接）。 */
+function parseFlashItems(data, context = "list_flash", limit) {
+	const items = [];
+	for (const entry of payloadItems(data, context)) {
+		if (!isRecord(entry)) continue;
+		const title = typeof entry.content === "string" ? flashTitle(entry.content) : void 0;
+		const publishedAt = parseJin10Time(entry.time);
+		const url = text(entry.url);
+		if (title === void 0 || publishedAt === void 0 || url === void 0) continue;
+		items.push({
+			source: "jin10",
+			title,
+			url,
+			publishedAt
+		});
+	}
+	return capItems(items, limit);
+}
+function parseFlashPage(data, context = "list_flash", limit) {
+	const meta = pageMeta(data);
+	return {
+		items: parseFlashItems(data, context, limit),
+		...meta
+	};
+}
+/** list_news / search_news 条目 → 文章摘要（id/title/时间/链接）。 */
+function parseNewsItems(data, context = "list_news", limit) {
+	const items = [];
+	for (const entry of payloadItems(data, context)) {
+		if (!isRecord(entry)) continue;
+		const id = text(entry.id);
+		const title = text(entry.title);
+		const publishedAt = parseJin10Time(entry.time);
+		const url = text(entry.url);
+		if (id === void 0 || title === void 0 || publishedAt === void 0 || url === void 0) continue;
+		items.push({
+			source: "jin10",
+			id,
+			title,
+			url,
+			publishedAt
+		});
+	}
+	return capItems(items, limit);
+}
+function parseNewsPage(data, context = "list_news", limit) {
+	const meta = pageMeta(data);
+	return {
+		items: parseNewsItems(data, context, limit),
+		...meta
+	};
+}
+/** get_news 详情：导语（introduction）作摘要下发；正文 content 按铁律 #5 丢弃。 */
+function parseArticle(data) {
+	if (!isRecord(data)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_news: unexpected payload (expected an object)");
+	const id = text(data.id);
+	const title = text(data.title);
+	const url = text(data.url);
+	const publishedAt = parseJin10Time(data.time);
+	if (id === void 0 || title === void 0 || url === void 0 || publishedAt === void 0) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_news: unexpected payload (missing id/title/url/time)");
+	const introduction = text(data.introduction);
+	return {
+		id,
+		title,
+		url,
+		publishedAt,
+		...introduction !== void 0 ? { introduction } : {}
+	};
+}
+/** list_calendar：data 为数组；pub_time 无时区，按东八区解释。 */
+function parseCalendar(data, limit) {
+	if (!Array.isArray(data)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 list_calendar: unexpected payload (expected an array)");
+	const entries = [];
+	for (const entry of data) {
+		if (!isRecord(entry)) continue;
+		const title = text(entry.title);
+		const publishedAt = parseJin10Time(entry.pub_time);
+		if (title === void 0 || publishedAt === void 0) continue;
+		const star = numberValue(entry.star);
+		const previous = text(entry.previous);
+		const consensus = text(entry.consensus);
+		const actual = text(entry.actual);
+		const revised = text(entry.revised);
+		const affect = text(entry.affect_txt);
+		entries.push({
+			publishedAt,
+			star: star ?? 0,
+			title,
+			...previous !== void 0 ? { previous } : {},
+			...consensus !== void 0 ? { consensus } : {},
+			...actual !== void 0 ? { actual } : {},
+			...revised !== void 0 ? { revised } : {},
+			...affect !== void 0 ? { affect } : {}
+		});
+	}
+	return capItems(entries, limit);
+}
+/** quote://codes 资源正文 → 品种表（`{data:[{code,name}]}`）。 */
+function parseQuoteCodes(resourceText) {
+	let parsed;
+	try {
+		parsed = JSON.parse(resourceText);
+	} catch {
+		throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 quote://codes: resource is not valid JSON");
+	}
+	const data = isRecord(parsed) ? parsed.data : parsed;
+	if (!Array.isArray(data)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 quote://codes: unexpected payload (expected data[])");
+	const instruments = [];
+	for (const entry of data) {
+		if (!isRecord(entry)) continue;
+		const code = text(entry.code);
+		if (code === void 0) continue;
+		instruments.push({
+			code,
+			name: text(entry.name) ?? code
+		});
+	}
+	return instruments;
+}
+/** get_quote：价格字段是字符串，转数字；code 缺失视为形状异常。 */
+function parseQuote(data) {
+	if (!isRecord(data)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_quote: unexpected payload (expected an object)");
+	const code = text(data.code);
+	if (code === void 0) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_quote: unexpected payload (missing code)");
+	const name = text(data.name);
+	const time = parseJin10Time(data.time);
+	const open = numberValue(data.open);
+	const close = numberValue(data.close);
+	const high = numberValue(data.high);
+	const low = numberValue(data.low);
+	const volume = numberValue(data.volume);
+	const change = numberValue(data.ups_price);
+	const changePercent = numberValue(data.ups_percent);
+	return {
+		code,
+		...name !== void 0 ? { name } : {},
+		...time !== void 0 ? { time } : {},
+		...open !== void 0 ? { open } : {},
+		...close !== void 0 ? { close } : {},
+		...high !== void 0 ? { high } : {},
+		...low !== void 0 ? { low } : {},
+		...volume !== void 0 ? { volume } : {},
+		...change !== void 0 ? { change } : {},
+		...changePercent !== void 0 ? { changePercent } : {}
+	};
+}
+/** get_kline：分钟级数组（time 为秒级时间戳）；空数组是合法结果（窗口内无数据）。 */
+function parseKlines(data, limit) {
+	if (!isRecord(data)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_kline: unexpected payload (expected an object)");
+	const raw = data.klines;
+	if (!Array.isArray(raw)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_kline: unexpected payload (expected data.klines[])");
+	const klines = [];
+	for (const entry of raw) {
+		if (!isRecord(entry)) continue;
+		const time = numberValue(entry.time);
+		if (time === void 0) continue;
+		const open = numberValue(entry.open);
+		const high = numberValue(entry.high);
+		const low = numberValue(entry.low);
+		const close = numberValue(entry.close);
+		const volume = numberValue(entry.volume);
+		if (open === void 0 && high === void 0 && low === void 0 && close === void 0) continue;
+		klines.push({
+			time,
+			...open !== void 0 ? { open } : {},
+			...high !== void 0 ? { high } : {},
+			...low !== void 0 ? { low } : {},
+			...close !== void 0 ? { close } : {},
+			...volume !== void 0 ? { volume } : {}
+		});
+	}
+	klines.sort((a, b) => a.time - b.time);
+	return capItems(klines, limit);
+}
+//#endregion
+export { flashTitle, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes };

package/lib/plugin.d.ts

@@ -0,0 +1,17 @@
+import "./service.js";
+import Schema from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/plugin.d.ts
+/** Cordis 插件名 = patch 行 id（TEMPLATES §8）。 */
+declare const name = "dsh-trading-connector-jin10";
+declare const inject: string[];
+interface Config {
+  enabled: boolean;
+  endpoint: string;
+  tokenRef: string;
+  timeoutMs: number;
+}
+declare const Config: Schema<Config>;
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, apply, inject, name };

package/lib/plugin.js

@@ -0,0 +1,39 @@
+import { TRADING_FLASH_FEED_KEY, createJin10FlashFeed } from "./flash-service.js";
+import { DEFAULT_ENDPOINT, DEFAULT_TIMEOUT_MS, Jin10McpClient } from "./mcp.js";
+import { Jin10Service } from "./service.js";
+import { createJin10Tools } from "./tools.js";
+import Schema from "@deepseek-ai/schemastery";
+//#region src/plugin.ts
+/** Cordis 插件名 = patch 行 id（TEMPLATES §8）。 */
+const name = "dsh-trading-connector-jin10";
+const inject = ["tools"];
+const Config = Schema.object({
+	enabled: Schema.boolean().default(true).description("是否注册金十数据 MCP 工具"),
+	endpoint: Schema.string().default(DEFAULT_ENDPOINT).description("金十数据 MCP 服务地址"),
+	tokenRef: Schema.string().default("JIN10_MCP_TOKEN").description("金十 MCP Token 的环境变量名（BYOK）"),
+	timeoutMs: Schema.number().default(DEFAULT_TIMEOUT_MS).description("单次 MCP 请求超时（ms）")
+});
+/** 惰性凭证源：provider 键固定 `jin10`（settings credentials 字典的键）。 */
+function createTokenProvider(ctx, tokenRef) {
+	return () => {
+		return (ctx.get?.("tradingMarketRouter", false))?.getCredential?.("jin10")?.token || process.env[tokenRef];
+	};
+}
+/** 组装取数服务（测试可直接注入 fetchImpl 的 MCP 客户端）。 */
+function createJin10Service(ctx, config, overrides = {}) {
+	return new Jin10Service(new Jin10McpClient({
+		endpoint: config.endpoint,
+		token: createTokenProvider(ctx, config.tokenRef),
+		timeoutMs: config.timeoutMs,
+		...overrides.fetchImpl !== void 0 ? { fetchImpl: overrides.fetchImpl } : {}
+	}));
+}
+function apply(ctx, config) {
+	if (!config.enabled) return;
+	const service = createJin10Service(ctx, config);
+	ctx.reflect.provide(TRADING_FLASH_FEED_KEY, createJin10FlashFeed(service));
+	const tools = ctx.tools;
+	for (const tool of createJin10Tools(service)) if (tools.get(tool.name) === void 0) tools.register(tool);
+}
+//#endregion
+export { Config, apply, createJin10Service, createTokenProvider, inject, name };

package/lib/service.d.ts

@@ -0,0 +1,53 @@
+import { Jin10McpClient } from "./mcp.js";
+import { Jin10ArticleDetail, Jin10ArticleSummary, Jin10CalendarEntry, Jin10Instrument, Jin10Kline, Jin10NewsItem, Jin10NewsPage, Jin10Quote } from "./parse.js";
+import { Jin10FlashItem, Jin10HeatLevel } from "./web-flash.js";
+//#region src/service.d.ts
+/** 快讯/资讯单页上限（上游 list_* 每页 20 条；search_flash 一次性最多 150 条且不可翻页）。 */
+declare const FLASH_PAGE_SIZE = 20;
+declare const SEARCH_FLASH_MAX = 150;
+/** 品种代码表缓存 TTL（静态名册，按小时级缓存；失败不缓存，下次调用重试）。 */
+declare const INSTRUMENT_CACHE_TTL_MS = 3600000;
+interface Jin10PageOptions {
+  cursor?: string | undefined;
+  limit?: number | undefined;
+}
+declare class Jin10Service {
+  private readonly client;
+  private readonly webFetch;
+  private readonly webTimeoutMs;
+  private instruments;
+  constructor(client: Jin10McpClient, web?: {
+    fetchImpl?: typeof globalThis.fetch | undefined;
+    timeoutMs?: number | undefined;
+  });
+  /**
+   * 按热度取快讯（金十网页版服务端过滤，火/热/沸/爆）：官方 MCP 的 list_flash
+   * 无热度参数，故热度路径走网页版接口（见 web-flash.ts）。cursor = 上一页
+   * 最旧一条的 time 原串。
+   */
+  listFlashByHeat(options: {
+    hot: readonly Jin10HeatLevel[];
+    cursor?: string | undefined;
+  }): Promise<Jin10NewsPage<Jin10FlashItem>>;
+  /** 最新快讯流（cursor 翻页；正文不下发，只留标题/时间/链接）。 */
+  listFlash(options?: Jin10PageOptions): Promise<Jin10NewsPage<Jin10NewsItem>>;
+  /** 关键词搜快讯：上游一次性返回（最多 150 条，不支持翻页），故无 cursor。 */
+  searchFlash(keyword: string, limit?: number): Promise<Jin10NewsItem[]>;
+  listNews(options?: Jin10PageOptions): Promise<Jin10NewsPage<Jin10ArticleSummary>>;
+  searchNews(keyword: string, options?: Jin10PageOptions): Promise<Jin10NewsPage<Jin10ArticleSummary>>;
+  /** 文章详情：标题/导语/时间/链接（正文按铁律 #5 不下发）。 */
+  getArticle(id: string): Promise<Jin10ArticleDetail>;
+  /** 本周财经日历（周一~周日；上游一次返回整周）。 */
+  listCalendar(limit?: number): Promise<Jin10CalendarEntry[]>;
+  /** 品种名册（quote://codes 资源）；query 按代码或中文名过滤。 */
+  listInstruments(query?: string): Promise<Jin10Instrument[]>;
+  getQuote(code: string): Promise<Jin10Quote>;
+  /** 分钟级 K 线：`time` = 起始秒级时间戳（从此往后取，窗口 24h 内），count ≤ 100。 */
+  getKlines(code: string, options?: {
+    time?: number | undefined;
+    count?: number | undefined;
+  }): Promise<Jin10Kline[]>;
+  private instrumentCatalog;
+}
+//#endregion
+export { FLASH_PAGE_SIZE, INSTRUMENT_CACHE_TTL_MS, Jin10PageOptions, Jin10Service, SEARCH_FLASH_MAX };