@dshtrading/connector-jin10 0.3.0 → 0.4.1

package/lib/global-plugin.d.ts

@@ -0,0 +1,8 @@
+import { Config } from "./plugin.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/global-plugin.d.ts
+declare const name = "dsh-trading-global-connector-jin10";
+declare const inject: string[];
+declare function apply(ctx: Context, config?: Partial<Config>): void;
+//#endregion
+export { Config, apply, inject, name };

package/lib/global-plugin.js

@@ -0,0 +1,17 @@
+import { TRADING_GLOBAL_MARKET_DATA_KEY, createJin10GlobalMarketDataService } from "./market-data.js";
+import "./mcp.js";
+import { Config, createJin10Service } from "./plugin.js";
+//#region src/global-plugin.ts
+const name = "dsh-trading-global-connector-jin10";
+const inject = [];
+function apply(ctx, config) {
+	if (config?.enabled === false) return;
+	const service = createJin10GlobalMarketDataService(createJin10Service(ctx, {
+		endpoint: config?.endpoint ?? "https://mcp.jin10.com/mcp",
+		tokenRef: config?.tokenRef ?? "JIN10_MCP_TOKEN",
+		timeoutMs: config?.timeoutMs ?? 15e3
+	}));
+	ctx.reflect.provide(TRADING_GLOBAL_MARKET_DATA_KEY, service);
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/index.d.ts

@@ -1,10 +1,13 @@
 import { DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, Jin10McpClient, Jin10McpOptions, McpContentPart, McpResourceDescriptor, McpToolDescriptor, McpToolResult, parseMcpBody } from "./mcp.js";
 import { Jin10ArticleDetail, Jin10ArticleSummary, Jin10CalendarEntry, Jin10Instrument, Jin10Kline, Jin10NewsItem, Jin10NewsPage, Jin10Quote, flashTitle, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes } from "./parse.js";
 import { JIN10_HEAT_LEVELS, JIN10_WEB_APP_ID, JIN10_WEB_FLASH_CHANNELS, JIN10_WEB_FLASH_ENDPOINT, JIN10_WEB_PAGE_SIZE, JIN10_WEB_X_VERSION, Jin10FlashItem, Jin10HeatLevel, Jin10HotFlashOptions, fetchJin10HotFlash, isJin10HeatLevel, parseWebFlashItems } from "./web-flash.js";
+import { JIN10_RATES_APP_ID, JIN10_RATES_ENDPOINT, JIN10_RATES_X_VERSION, Jin10RateEntry, fetchJin10Rates, parseWebRates } from "./web-rates.js";
 import { FLASH_PAGE_SIZE, INSTRUMENT_CACHE_TTL_MS, Jin10PageOptions, Jin10Service, SEARCH_FLASH_MAX } from "./service.js";
 import { Config, apply, inject, name } from "./plugin.js";
 import { Jin10Error, TOKEN_HINT, codeForUpstreamMessage } from "./errors.js";
 import { TRADING_FLASH_FEED_KEY, createJin10FlashFeed } from "./flash-service.js";
+import { MACRO_CALENDAR_MAX, TRADING_MACRO_FEED_KEY, createJin10MacroFeed } from "./macro-service.js";
 import { GLOBAL_MARKET, JIN10_PROVIDER, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, TICKER_POLL_MS, TRADING_GLOBAL_MARKET_DATA_KEY, aggregateKlines, createJin10GlobalMarketDataService, resolveIntervalMinutes, tickerFromQuote } from "./market-data.js";
+import { JIN10_REGIONS, Jin10Region, regionOfFlagUrl, regionOfTitle } from "./regions.js";
 import { createJin10Tools } from "./tools.js";
-export { Config, DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, FLASH_PAGE_SIZE, GLOBAL_MARKET, INSTRUMENT_CACHE_TTL_MS, JIN10_HEAT_LEVELS, JIN10_PROVIDER, JIN10_WEB_APP_ID, JIN10_WEB_FLASH_CHANNELS, JIN10_WEB_FLASH_ENDPOINT, JIN10_WEB_PAGE_SIZE, JIN10_WEB_X_VERSION, Jin10ArticleDetail, Jin10ArticleSummary, Jin10CalendarEntry, Jin10Error, Jin10FlashItem, Jin10HeatLevel, Jin10HotFlashOptions, Jin10Instrument, Jin10Kline, Jin10McpClient, Jin10McpOptions, Jin10NewsItem, Jin10NewsPage, Jin10PageOptions, Jin10Quote, Jin10Service, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, McpContentPart, McpResourceDescriptor, McpToolDescriptor, McpToolResult, SEARCH_FLASH_MAX, TICKER_POLL_MS, TOKEN_HINT, TRADING_FLASH_FEED_KEY, TRADING_GLOBAL_MARKET_DATA_KEY, aggregateKlines, apply, codeForUpstreamMessage, createJin10FlashFeed, createJin10GlobalMarketDataService, createJin10Tools, fetchJin10HotFlash, flashTitle, inject, isJin10HeatLevel, name, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseMcpBody, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes, parseWebFlashItems, resolveIntervalMinutes, tickerFromQuote };
+export { Config, DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, FLASH_PAGE_SIZE, GLOBAL_MARKET, INSTRUMENT_CACHE_TTL_MS, JIN10_HEAT_LEVELS, JIN10_PROVIDER, JIN10_RATES_APP_ID, JIN10_RATES_ENDPOINT, JIN10_RATES_X_VERSION, JIN10_REGIONS, JIN10_WEB_APP_ID, JIN10_WEB_FLASH_CHANNELS, JIN10_WEB_FLASH_ENDPOINT, JIN10_WEB_PAGE_SIZE, JIN10_WEB_X_VERSION, Jin10ArticleDetail, Jin10ArticleSummary, Jin10CalendarEntry, Jin10Error, Jin10FlashItem, Jin10HeatLevel, Jin10HotFlashOptions, Jin10Instrument, Jin10Kline, Jin10McpClient, Jin10McpOptions, Jin10NewsItem, Jin10NewsPage, Jin10PageOptions, Jin10Quote, Jin10RateEntry, Jin10Region, Jin10Service, MACRO_CALENDAR_MAX, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, McpContentPart, McpResourceDescriptor, McpToolDescriptor, McpToolResult, SEARCH_FLASH_MAX, TICKER_POLL_MS, TOKEN_HINT, TRADING_FLASH_FEED_KEY, TRADING_GLOBAL_MARKET_DATA_KEY, TRADING_MACRO_FEED_KEY, aggregateKlines, apply, codeForUpstreamMessage, createJin10FlashFeed, createJin10GlobalMarketDataService, createJin10MacroFeed, createJin10Tools, fetchJin10HotFlash, fetchJin10Rates, flashTitle, inject, isJin10HeatLevel, name, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseMcpBody, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes, parseWebFlashItems, parseWebRates, regionOfFlagUrl, regionOfTitle, resolveIntervalMinutes, tickerFromQuote };

package/lib/index.js

@@ -1,10 +1,13 @@
 import { Jin10Error, TOKEN_HINT, codeForUpstreamMessage } from "./errors.js";
+import { JIN10_REGIONS, regionOfFlagUrl, regionOfTitle } from "./regions.js";
 import { flashTitle, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes } from "./parse.js";
 import { JIN10_HEAT_LEVELS, JIN10_WEB_APP_ID, JIN10_WEB_FLASH_CHANNELS, JIN10_WEB_FLASH_ENDPOINT, JIN10_WEB_PAGE_SIZE, JIN10_WEB_X_VERSION, fetchJin10HotFlash, isJin10HeatLevel, parseWebFlashItems } from "./web-flash.js";
 import { TRADING_FLASH_FEED_KEY, createJin10FlashFeed } from "./flash-service.js";
+import { MACRO_CALENDAR_MAX, TRADING_MACRO_FEED_KEY, createJin10MacroFeed } from "./macro-service.js";
 import { GLOBAL_MARKET, JIN10_PROVIDER, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, TICKER_POLL_MS, TRADING_GLOBAL_MARKET_DATA_KEY, aggregateKlines, createJin10GlobalMarketDataService, resolveIntervalMinutes, tickerFromQuote } from "./market-data.js";
 import { DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, Jin10McpClient, parseMcpBody } from "./mcp.js";
+import { JIN10_RATES_APP_ID, JIN10_RATES_ENDPOINT, JIN10_RATES_X_VERSION, fetchJin10Rates, parseWebRates } from "./web-rates.js";
 import { FLASH_PAGE_SIZE, INSTRUMENT_CACHE_TTL_MS, Jin10Service, SEARCH_FLASH_MAX } from "./service.js";
 import { createJin10Tools } from "./tools.js";
 import { Config, apply, inject, name } from "./plugin.js";
-export { Config, DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, FLASH_PAGE_SIZE, GLOBAL_MARKET, INSTRUMENT_CACHE_TTL_MS, JIN10_HEAT_LEVELS, JIN10_PROVIDER, JIN10_WEB_APP_ID, JIN10_WEB_FLASH_CHANNELS, JIN10_WEB_FLASH_ENDPOINT, JIN10_WEB_PAGE_SIZE, JIN10_WEB_X_VERSION, Jin10Error, Jin10McpClient, Jin10Service, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, SEARCH_FLASH_MAX, TICKER_POLL_MS, TOKEN_HINT, TRADING_FLASH_FEED_KEY, TRADING_GLOBAL_MARKET_DATA_KEY, aggregateKlines, apply, codeForUpstreamMessage, createJin10FlashFeed, createJin10GlobalMarketDataService, createJin10Tools, fetchJin10HotFlash, flashTitle, inject, isJin10HeatLevel, name, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseMcpBody, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes, parseWebFlashItems, resolveIntervalMinutes, tickerFromQuote };
+export { Config, DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, FLASH_PAGE_SIZE, GLOBAL_MARKET, INSTRUMENT_CACHE_TTL_MS, JIN10_HEAT_LEVELS, JIN10_PROVIDER, JIN10_RATES_APP_ID, JIN10_RATES_ENDPOINT, JIN10_RATES_X_VERSION, JIN10_REGIONS, JIN10_WEB_APP_ID, JIN10_WEB_FLASH_CHANNELS, JIN10_WEB_FLASH_ENDPOINT, JIN10_WEB_PAGE_SIZE, JIN10_WEB_X_VERSION, Jin10Error, Jin10McpClient, Jin10Service, MACRO_CALENDAR_MAX, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, SEARCH_FLASH_MAX, TICKER_POLL_MS, TOKEN_HINT, TRADING_FLASH_FEED_KEY, TRADING_GLOBAL_MARKET_DATA_KEY, TRADING_MACRO_FEED_KEY, aggregateKlines, apply, codeForUpstreamMessage, createJin10FlashFeed, createJin10GlobalMarketDataService, createJin10MacroFeed, createJin10Tools, fetchJin10HotFlash, fetchJin10Rates, flashTitle, inject, isJin10HeatLevel, name, parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseJin10Time, parseKlines, parseMcpBody, parseNewsItems, parseNewsPage, parseQuote, parseQuoteCodes, parseWebFlashItems, parseWebRates, regionOfFlagUrl, regionOfTitle, resolveIntervalMinutes, tickerFromQuote };

package/lib/macro-service.d.ts

@@ -0,0 +1,10 @@
+import { Jin10Service } from "./service.js";
+import { MacroFeedService } from "@dshtrading/api";
+//#region src/macro-service.d.ts
+declare const TRADING_MACRO_FEED_KEY = "tradingMacroFeed";
+/** 日历全周截尾上限（上游一页即整周；桥侧同值校验。整周实测已到 254 条，250 会裁掉周尾）。 */
+declare const MACRO_CALENDAR_MAX = 400;
+/** 宏观/利率源实现（桥与工具面共用同一 Jin10Service）。 */
+declare function createJin10MacroFeed(feed: Jin10Service): MacroFeedService;
+//#endregion
+export { MACRO_CALENDAR_MAX, TRADING_MACRO_FEED_KEY, createJin10MacroFeed };

package/lib/macro-service.js

@@ -0,0 +1,19 @@
+//#region src/macro-service.ts
+const TRADING_MACRO_FEED_KEY = "tradingMacroFeed";
+/** 日历全周截尾上限（上游一页即整周；桥侧同值校验。整周实测已到 254 条，250 会裁掉周尾）。 */
+const MACRO_CALENDAR_MAX = 400;
+/** 宏观/利率源实现（桥与工具面共用同一 Jin10Service）。 */
+function createJin10MacroFeed(feed) {
+	return {
+		/** 当周经济日历（MCP list_calendar；地区已按标题前缀推断）。 */
+		async listCalendar(limit) {
+			return feed.listCalendar(limit);
+		},
+		/** 央行最新利率（网页版接口全量，客户端按地区过滤）。 */
+		async listRates() {
+			return feed.listRates();
+		}
+	};
+}
+//#endregion
+export { MACRO_CALENDAR_MAX, TRADING_MACRO_FEED_KEY, createJin10MacroFeed };

package/lib/parse.d.ts

@@ -24,6 +24,8 @@ interface Jin10CalendarEntry {
   publishedAt: string;
   star: number;
   title: string;
+  /** 地区（标题前缀推断，见 regions.ts；未识别 = 空串——GUI 地区过滤用）。 */
+  region: string;
   previous?: string;
   consensus?: string;
   actual?: string;

package/lib/parse.js

@@ -1,4 +1,5 @@
 import { Jin10Error } from "./errors.js";
+import { regionOfTitle } from "./regions.js";
 //#region src/parse.ts
 /** 快讯标题：【标题】正文 → 取括号内；无括号 → 首段文本截断（正文绝不下发）。 */
 function flashTitle(content, maxLength = 120) {
@@ -139,6 +140,7 @@ function parseCalendar(data, limit) {
 			publishedAt,
 			star: star ?? 0,
 			title,
+			region: regionOfTitle(title),
 			...previous !== void 0 ? { previous } : {},
 			...consensus !== void 0 ? { consensus } : {},
 			...actual !== void 0 ? { actual } : {},

package/lib/plugin.js

@@ -1,4 +1,5 @@
 import { TRADING_FLASH_FEED_KEY, createJin10FlashFeed } from "./flash-service.js";
+import { TRADING_MACRO_FEED_KEY, createJin10MacroFeed } from "./macro-service.js";
 import { DEFAULT_ENDPOINT, DEFAULT_TIMEOUT_MS, Jin10McpClient } from "./mcp.js";
 import { Jin10Service } from "./service.js";
 import { createJin10Tools } from "./tools.js";
@@ -32,6 +33,7 @@ function apply(ctx, config) {
 	if (!config.enabled) return;
 	const service = createJin10Service(ctx, config);
 	ctx.reflect.provide(TRADING_FLASH_FEED_KEY, createJin10FlashFeed(service));
+	ctx.reflect.provide(TRADING_MACRO_FEED_KEY, createJin10MacroFeed(service));
 	const tools = ctx.tools;
 	for (const tool of createJin10Tools(service)) if (tools.get(tool.name) === void 0) tools.register(tool);
 }

package/lib/regions.d.ts

@@ -0,0 +1,22 @@
+//#region src/regions.d.ts
+/**
+ * 金十地区词汇（2026-09-15，宏观/利率数据面的地区归属推断）。
+ *
+ * 两条推断路径（spikes/impl-jin10-macro-rates/EVIDENCE.md）：
+ * - 日历条目：MCP list_calendar 无 country 字段，但标题一律以地区名开头
+ *   （「日本8月外汇储备(亿美元)」），按前缀匹配；
+ * - 央行利率：flagImgUrl 文件名即地区名（`…/flag/美国.png`）。
+ * 词汇表是封闭小集合（实测 indicator_list 字典 33 个 country 取值的母集）；
+ * 匹配一律按**长度降序**（「中国香港」「中国台湾」「印度尼西亚」不会被
+ * 「中国」「印度」截胡——手写顺序不算数，见 2026-09-15 评审 M4）。未命中
+ * 返回空串（= 仅「全部」视图可见），绝不猜。
+ */
+/** 地区词汇（封闭集合；匹配顺序由长度降序推导，与书写顺序无关）。 */
+declare const JIN10_REGIONS: readonly ["美国", "中国", "日本", "欧元区", "德国", "法国", "英国", "中国香港", "中国台湾", "韩国", "新加坡", "澳大利亚", "加拿大", "瑞士", "印度尼西亚", "印度", "意大利", "西班牙", "印尼", "俄罗斯", "巴西", "墨西哥", "南非", "新西兰", "土耳其", "瑞典", "挪威", "丹麦", "波兰", "匈牙利", "捷克", "乌克兰", "以色列", "菲律宾", "泰国", "马来西亚", "越南", "沙特", "智利", "哥伦比亚", "尼日利亚", "罗马尼亚", "全球", "OECD"];
+type Jin10Region = (typeof JIN10_REGIONS)[number];
+/** 日历标题 → 地区（前缀命中；未命中 = 空串）。 */
+declare function regionOfTitle(title: string): string;
+/** 利率 flagImgUrl → 地区（取文件名去扩展名，别名归一；空串 = 无法识别）。 */
+declare function regionOfFlagUrl(flagUrl: string): string;
+//#endregion
+export { JIN10_REGIONS, Jin10Region, regionOfFlagUrl, regionOfTitle };

package/lib/regions.js

@@ -0,0 +1,79 @@
+//#region src/regions.ts
+/**
+* 金十地区词汇（2026-09-15，宏观/利率数据面的地区归属推断）。
+*
+* 两条推断路径（spikes/impl-jin10-macro-rates/EVIDENCE.md）：
+* - 日历条目：MCP list_calendar 无 country 字段，但标题一律以地区名开头
+*   （「日本8月外汇储备(亿美元)」），按前缀匹配；
+* - 央行利率：flagImgUrl 文件名即地区名（`…/flag/美国.png`）。
+* 词汇表是封闭小集合（实测 indicator_list 字典 33 个 country 取值的母集）；
+* 匹配一律按**长度降序**（「中国香港」「中国台湾」「印度尼西亚」不会被
+* 「中国」「印度」截胡——手写顺序不算数，见 2026-09-15 评审 M4）。未命中
+* 返回空串（= 仅「全部」视图可见），绝不猜。
+*/
+/** 地区词汇（封闭集合；匹配顺序由长度降序推导，与书写顺序无关）。 */
+const JIN10_REGIONS = [
+	"美国",
+	"中国",
+	"日本",
+	"欧元区",
+	"德国",
+	"法国",
+	"英国",
+	"中国香港",
+	"中国台湾",
+	"韩国",
+	"新加坡",
+	"澳大利亚",
+	"加拿大",
+	"瑞士",
+	"印度尼西亚",
+	"印度",
+	"意大利",
+	"西班牙",
+	"印尼",
+	"俄罗斯",
+	"巴西",
+	"墨西哥",
+	"南非",
+	"新西兰",
+	"土耳其",
+	"瑞典",
+	"挪威",
+	"丹麦",
+	"波兰",
+	"匈牙利",
+	"捷克",
+	"乌克兰",
+	"以色列",
+	"菲律宾",
+	"泰国",
+	"马来西亚",
+	"越南",
+	"沙特",
+	"智利",
+	"哥伦比亚",
+	"尼日利亚",
+	"罗马尼亚",
+	"全球",
+	"OECD"
+];
+/** 上游同义写法 → 规范地区名（两条推断路径共用，同一国家只有一个标签）。 */
+const REGION_ALIASES = { "印尼": "印度尼西亚" };
+/** 匹配顺序：长名在前（前缀匹配的唯一要求；书写顺序不参与语义）。 */
+const MATCH_ORDER = [...JIN10_REGIONS].sort((a, b) => b.length - a.length);
+function canonical(region) {
+	return REGION_ALIASES[region] ?? region;
+}
+/** 日历标题 → 地区（前缀命中；未命中 = 空串）。 */
+function regionOfTitle(title) {
+	for (const region of MATCH_ORDER) if (title.startsWith(region)) return canonical(region);
+	return "";
+}
+/** 利率 flagImgUrl → 地区（取文件名去扩展名，别名归一；空串 = 无法识别）。 */
+function regionOfFlagUrl(flagUrl) {
+	const base = (flagUrl.trim().split("/").pop() ?? "").replace(/\.[a-zA-Z]+$/, "");
+	return base.length > 0 ? canonical(base) : "";
+}
+//#endregion
+export { JIN10_REGIONS, regionOfFlagUrl, regionOfTitle };

package/lib/service.d.ts

@@ -1,6 +1,7 @@
 import { Jin10McpClient } from "./mcp.js";
 import { Jin10ArticleDetail, Jin10ArticleSummary, Jin10CalendarEntry, Jin10Instrument, Jin10Kline, Jin10NewsItem, Jin10NewsPage, Jin10Quote } from "./parse.js";
 import { Jin10FlashItem, Jin10HeatLevel } from "./web-flash.js";
+import { Jin10RateEntry } from "./web-rates.js";
 //#region src/service.d.ts
 /** 快讯/资讯单页上限（上游 list_* 每页 20 条；search_flash 一次性最多 150 条且不可翻页）。 */
 declare const FLASH_PAGE_SIZE = 20;
@@ -39,6 +40,8 @@ declare class Jin10Service {
   getArticle(id: string): Promise<Jin10ArticleDetail>;
   /** 本周财经日历（周一~周日；上游一次返回整周）。 */
   listCalendar(limit?: number): Promise<Jin10CalendarEntry[]>;
+  /** 央行最新利率（网页版接口，30 家全量；地区按 flag 名推断）。 */
+  listRates(): Promise<Jin10RateEntry[]>;
   /** 品种名册（quote://codes 资源）；query 按代码或中文名过滤。 */
   listInstruments(query?: string): Promise<Jin10Instrument[]>;
   getQuote(code: string): Promise<Jin10Quote>;

package/lib/service.js

@@ -2,6 +2,7 @@ import { Jin10Error } from "./errors.js";
 import { parseArticle, parseCalendar, parseFlashItems, parseFlashPage, parseKlines, parseNewsPage, parseQuote, parseQuoteCodes } from "./parse.js";
 import { fetchJin10HotFlash } from "./web-flash.js";
 import "./mcp.js";
+import { fetchJin10Rates } from "./web-rates.js";
 //#region src/service.ts
 /**
 * 取数层：把 MCP 工具名（list_flash / search_flash / list_news / search_news / get_news /
@@ -68,6 +69,10 @@ var Jin10Service = class {
 	async listCalendar(limit) {
 		return parseCalendar(await this.client.callToolData("list_calendar", {}), limit);
 	}
+	/** 央行最新利率（网页版接口，30 家全量；地区按 flag 名推断）。 */
+	async listRates() {
+		return fetchJin10Rates(this.webFetch, { timeoutMs: this.webTimeoutMs });
+	}
 	/** 品种名册（quote://codes 资源）；query 按代码或中文名过滤。 */
 	async listInstruments(query) {
 		const items = await this.instrumentCatalog();

package/lib/web-rates.d.ts

@@ -0,0 +1,23 @@
+//#region src/web-rates.d.ts
+declare const JIN10_RATES_ENDPOINT = "https://e0430d16720e4211b5e072c26205c890.z3c.jin10.com/web/interest_rates";
+/** 网页版日历客户端 x-app-id / x-version（bundle 内常量，请求原样复刻）。 */
+declare const JIN10_RATES_APP_ID = "sKKYe29sFuJaeOCJ";
+declare const JIN10_RATES_X_VERSION = "2.0";
+/** 央行最新利率条目（地区由 flagImgUrl 文件名推断，未识别 = 空串）。 */
+interface Jin10RateEntry {
+  readonly region: string;
+  readonly bankName: string;
+  /** 最新利率（上游原样字符串）。 */
+  readonly rate: string;
+  /** 公布日（上游原样 YYYY-MM-DD）。 */
+  readonly publishedAt: string;
+  /** 所属指标名（如「美联储利率决定(上限)」；部分央行上游缺省）。 */
+  readonly indicatorName?: string;
+}
+/** 网页版条目 → Jin10RateEntry（缺央行名/利率/公布日的残条丢弃，绝不编数）。 */
+declare function parseWebRates(payload: unknown): Jin10RateEntry[];
+declare function fetchJin10Rates(fetchImpl: typeof globalThis.fetch, config: {
+  timeoutMs: number;
+}): Promise<Jin10RateEntry[]>;
+//#endregion
+export { JIN10_RATES_APP_ID, JIN10_RATES_ENDPOINT, JIN10_RATES_X_VERSION, Jin10RateEntry, fetchJin10Rates, parseWebRates };

package/lib/web-rates.js

@@ -0,0 +1,84 @@
+import { Jin10Error } from "./errors.js";
+import { regionOfFlagUrl } from "./regions.js";
+//#region src/web-rates.ts
+/**
+* 金十网页版「央行利率」取数（2026-09-15）。
+*
+* 官方 MCP 没有利率读数工具，而金十日历网页版（rili.jin10.com）有全量 30 家
+* 央行最新利率接口。本模块复刻网页版实际请求（bundle getInterestRate 逆向 +
+* 真实网络复核，见 spikes/impl-jin10-macro-rates/EVIDENCE.md）：
+*
+*   GET https://e0430d16720e4211b5e072c26205c890.z3c.jin10.com/web/interest_rates
+*   headers: x-app-id: sKKYe29sFuJaeOCJ, x-version: 2.0
+*   响应   : { status: 200, message, data: { list: [{ id, bankName, flagImgUrl,
+*              interestRate, publishTime, fromIndicatorId?, fromIndicatorName? }], updated_at } }
+*
+* 与热度快讯（web-flash.ts）同款边界：非官方 MCP 契约的网页版公开接口，仅用于
+* GUI 读数；利率是数值元数据，无正文再分发问题。interestRate 保留上游原样字符串
+* （"2.5"/"0"），不做数值化——展示诚实优先。
+*/
+const JIN10_RATES_ENDPOINT = "https://e0430d16720e4211b5e072c26205c890.z3c.jin10.com/web/interest_rates";
+/** 网页版日历客户端 x-app-id / x-version（bundle 内常量，请求原样复刻）。 */
+const JIN10_RATES_APP_ID = "sKKYe29sFuJaeOCJ";
+const JIN10_RATES_X_VERSION = "2.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;
+}
+/** 网页版条目 → Jin10RateEntry（缺央行名/利率/公布日的残条丢弃，绝不编数）。 */
+function parseWebRates(payload) {
+	if (!isRecord(payload)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 rates: unexpected payload (expected an object)");
+	if (payload.status !== 200) {
+		const message = typeof payload.message === "string" && payload.message.length > 0 ? payload.message : "unknown upstream error";
+		throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 rates: upstream status ${String(payload.status)} — ${message}`);
+	}
+	const list = (isRecord(payload.data) ? payload.data : void 0)?.list;
+	if (!Array.isArray(list)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 rates: unexpected payload (expected data.list[])");
+	const items = [];
+	for (const raw of list) {
+		if (!isRecord(raw)) continue;
+		const bankName = text(raw.bankName);
+		const rate = text(raw.interestRate);
+		const publishedAt = text(raw.publishTime);
+		if (bankName === void 0 || rate === void 0 || publishedAt === void 0) continue;
+		const region = typeof raw.flagImgUrl === "string" ? regionOfFlagUrl(raw.flagImgUrl) : "";
+		const indicatorName = text(raw.fromIndicatorName);
+		items.push({
+			region,
+			bankName,
+			rate,
+			publishedAt,
+			...indicatorName !== void 0 ? { indicatorName } : {}
+		});
+	}
+	return items;
+}
+async function fetchJin10Rates(fetchImpl, config) {
+	const response = await fetchImpl(JIN10_RATES_ENDPOINT, {
+		headers: {
+			accept: "application/json",
+			"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124 Safari/537.36",
+			"x-app-id": JIN10_RATES_APP_ID,
+			"x-version": "2.0",
+			referer: "https://rili.jin10.com/"
+		},
+		signal: AbortSignal.timeout(config.timeoutMs)
+	});
+	if (!response.ok) {
+		const body = await response.text().catch(() => "");
+		throw new Jin10Error("TRADING_EXCHANGE_ERROR", `jin10 rates: HTTP ${response.status}${body ? ` — ${body.slice(0, 160)}` : ""}`);
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(await response.text());
+	} catch {
+		throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 rates: upstream returned non-JSON body");
+	}
+	return parseWebRates(parsed);
+}
+//#endregion
+export { JIN10_RATES_APP_ID, JIN10_RATES_ENDPOINT, JIN10_RATES_X_VERSION, fetchJin10Rates, parseWebRates };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-jin10",
   "description": "金十数据 MCP 连接器：把 mcp.jin10.com 的行情/快讯/资讯/财经日历封装成本仓的连接器（市场无关，host 面工具行）",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,6 +14,10 @@
       "types": "./lib/dataplane.d.ts",
       "default": "./lib/dataplane.js"
     },
+    "./global-plugin": {
+      "types": "./lib/global-plugin.d.ts",
+      "default": "./lib/global-plugin.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -21,7 +25,7 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.3.0"
+    "@dshtrading/api": "^0.4.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",