@dshtrading/connector-jin10 0.3.0

package/LICENSE

@@ -0,0 +1,75 @@
+Copyright (c) 2026 zhu1090093659 (dsh-trading)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/README.md

@@ -0,0 +1,76 @@
+# @dshtrading/connector-jin10
+
+金十数据（Jin10）MCP 连接器：把 `https://mcp.jin10.com/mcp` 的**市场快讯、财经资讯、财经日历与全球品种行情**封装成本仓的 agent 工具面。
+
+与交易所连接器的区别：本包**没有行情/交易服务面**（不 provide `trading<Market>MarketData`，不进市场路由），只注册只读工具——金十内容是跨市场的（宏观/大宗/外汇/A 股/地缘），故为**市场无关共享行**，归 `@dshtrading/base` 所有（README 设计铁律 #1）。
+
+## 工具面
+
+| 工具 | 上游 MCP 工具 | 说明 |
+| :--- | :--- | :--- |
+| `flash_list` | `list_flash` | 最新快讯流，`cursor` 翻页 |
+| `flash_search` | `search_flash` | 关键词搜快讯（一次最多 150 条，上游不支持翻页） |
+| `news_list` | `list_news` | 最新财经资讯列表，`cursor` 翻页 |
+| `news_search` | `search_news` | 关键词搜资讯，`cursor` 翻页 |
+| `news_get` | `get_news` | 单篇资讯元数据（标题/时间/链接/导语） |
+| `econ_calendar` | `list_calendar` | 本周财经日历（时间/星级/前值/预期/公布/影响） |
+| `global_instruments` | `quote://codes` 资源 | 品种代码名册（现货/能源/外汇/指数），可关键词过滤 |
+| `global_quote` | `get_quote` | 单品种实时报价 |
+| `global_klines` | `get_kline` | 分钟级 K 线（`time` 起点后 24h 窗内，`count` ≤ 100） |
+
+工具名不带 provider 名：换快讯源不改工具面（与 `symbol_search`、`knowledge_search` 同族的跨市场命名）。
+
+## 配置（Config）
+
+```yaml
+- id: dsh-trading-connector-jin10
+  name: '@dshtrading/connector-jin10'
+  config:
+    enabled: true                                   # 缺省 true
+    endpoint: https://mcp.jin10.com/mcp             # 缺省即此
+    tokenRef: JIN10_MCP_TOKEN                       # 环境变量名（BYOK）
+    timeoutMs: 15000
+```
+
+凭证解析（BYOK，不内置密钥）：设置中心 `dshtrading.credentials.jin10.token` 优先，`process.env[tokenRef]` 兜底；**每次请求惰性解析**，所以 settings 用户层在插件 apply 之后加载/修改同样生效。缺凭证时调用报 `TRADING_CREDENTIALS_MISSING`，消息里带配置路径。
+
+## 上游契约（2026-09-13 实测，证据见 `spikes/impl-jin10-mcp/EVIDENCE/`）
+
+- 传输：Streamable HTTP，JSON-RPC 2.0；响应是 `text/event-stream` 里的单行 `data: {...}`（也吃直出 JSON）。协议版本 `2025-11-25`，`initialize → notifications/initialized → tools/list / resources/list / resources/read → tools/call`。
+- 鉴权：`Authorization: Bearer <token>`；上游当前不返回 `mcp-session-id`（有则该头原样回带）。
+- 结果读取：`result.structuredContent` 优先；`result.content[].text` 只在 structuredContent 缺席时作机器可读兜底。
+- 分页：请求 `cursor`、响应 `data.next_cursor` + `data.has_more`（不传未声明参数，例如不要用 `offset`）。
+- 错误：`isError=true`、`status !== 200`、`data === null` 一律抛错（不冒充空数据）；限流文案「今日该工具调用次数已达上限」映射 `TRADING_RATE_LIMITED`，未知品种映射 `TRADING_UNSUPPORTED_SYMBOL`。
+- 限流：每用户每工具每北京时间自然日 1500 次。
+
+## global 市场数据面（行情接市场路由，2026-09-13）
+
+同包还有一个数据面插件行，把金十行情接进本仓的市场路由：
+
+```yaml
+- id: dsh-trading-global-dataplane-jin10
+  name: '@dshtrading/connector-jin10/dataplane'
+```
+
+- 市场 id `global`（provider slug `jin10`）：provide `tradingGlobalMarketData` + 向 `tradingMarketDataRegistry` 注册 `(global, jin10)`；GUI 行情面板/自选/图表与 `router` 的 `DEFAULT_MARKETS.global` 由此生效。
+- 实现（`market-data.ts`）：`get_quote` → Ticker（昨收由 `close - ups_price` 反推）、`get_kline` → Kline、`quote://codes` → `listInstruments`（97 品种，1h 缓存）、`subscribeTicker` 5s 轮询。
+- **周期与深度**：上游只有分钟 K 线，单次上限 100 根且语义是「从 time 往后取」，本层最多拼 300 分钟窗口（3 次上游调用）→ 支持 `1m/3m/5m/15m/30m/1h`，`1d` 及以上显式报错（不换源、不用单日分钟冒充历史）。闭市窗口返回空序列（上游 `klines: []`，合法结果）。
+- 凭证与主行同源（`credentials.jin10.token` / `JIN10_MCP_TOKEN`，逐请求惰性解析）；未配置时面板/桥报凭证缺失，不伪装成空行情。
+
+## 数据边界（铁律 #5 数据零再分发）
+
+- 快讯只下发**标题（从 `【标题】正文` 提取）/时间/链接**，`content` 正文丢弃；
+- 资讯下发标题/时间/链接/`id`，详情额外给上游 `introduction`（导语），`content` 正文丢弃；
+- 时间解析失败一律丢弃该条，绝不回退「现在」；
+- 不缓存、不落盘、不批量抓取。
+
+## 验证
+
+```sh
+pnpm --filter @dshtrading/connector-jin10 test     # 67 例：传输/握手/错误映射/解析/工具渲染/插件接线/快讯面/数据面
+JIN10_TOKEN=sk-... node spikes/impl-jin10-mcp/verify.mjs   # 出网验证（构建产物 + 真实 MCP）
+```
+
+`verify.mjs` 覆盖资源 → 快讯两页翻页 → 快讯搜索 → 资讯列表/搜索/详情 → 财经日历 → 报价 → K 线，以及缺凭证/非法 code 两条错误语义；证据 JSON 落 `spikes/impl-jin10-mcp/EVIDENCE/`。
+
+已知限制：闭市（周末）上游对全部品种回 `status: 200` + `klines: []`（工具与 `global` 市场数据面照实回空序列，属真实语义而非故障）；2026-09-13（周日）实测全品种为空，分钟 K 线的拼窗口与本地聚合路径待交易日复测。`global` 市场只上 `1m/5m/15m` 周期（上游单窗口 100 根、本层最多拼 300 分钟），深度上限见上文数据面节。

package/lib/dataplane.d.ts

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

package/lib/dataplane.js

@@ -0,0 +1,23 @@
+import { GLOBAL_MARKET, JIN10_PROVIDER, TRADING_GLOBAL_MARKET_DATA_KEY, createJin10GlobalMarketDataService } from "./market-data.js";
+import "./mcp.js";
+import { Config, createJin10Service } from "./plugin.js";
+//#region src/dataplane.ts
+const inject = [];
+function resolveMarketDataRegistry(ctx) {
+	const candidate = ctx.get?.("tradingMarketDataRegistry", false);
+	return candidate !== void 0 ? candidate : void 0;
+}
+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);
+	const registry = resolveMarketDataRegistry(ctx);
+	if (registry === void 0) return;
+	ctx.effect(() => registry.register(GLOBAL_MARKET, JIN10_PROVIDER, service));
+}
+//#endregion
+export { Config, apply, inject };

package/lib/errors.d.ts

@@ -0,0 +1,18 @@
+import { TradingErrorCode } from "@dshtrading/api";
+//#region src/errors.d.ts
+/** 本连接器的凭证提示（错误消息里必须给出可执行的配置路径 —— BYOK 铁律）。 */
+declare const TOKEN_HINT = "配置金十 MCP Token：设置中心 dshtrading.credentials.jin10.token，或环境变量 JIN10_MCP_TOKEN。";
+/** 错误词汇对齐 @dshtrading/api（本包不做跨包 Error 类基座，与 connector-eastmoney 同款）。 */
+declare class Jin10Error extends Error {
+  readonly code: TradingErrorCode;
+  constructor(code: TradingErrorCode, message: string, cause?: unknown);
+}
+/**
+ * 上游业务错误消息 → 错误码。
+ * 限流文案必须单独识别（决定「今天别再试」的语义）；「不支持该品种」= 代码不在
+ * quote://codes 名册内（本出口实测文案，2026-09-13），映射到 UNSUPPORTED_SYMBOL
+ * 让工具层语义与市场工具族一致。
+ */
+declare function codeForUpstreamMessage(message: string): TradingErrorCode;
+//#endregion
+export { Jin10Error, TOKEN_HINT, codeForUpstreamMessage };

package/lib/errors.js

@@ -0,0 +1,26 @@
+//#region src/errors.ts
+/** 本连接器的凭证提示（错误消息里必须给出可执行的配置路径 —— BYOK 铁律）。 */
+const TOKEN_HINT = "配置金十 MCP Token：设置中心 dshtrading.credentials.jin10.token，或环境变量 JIN10_MCP_TOKEN。";
+/** 错误词汇对齐 @dshtrading/api（本包不做跨包 Error 类基座，与 connector-eastmoney 同款）。 */
+var Jin10Error = class extends Error {
+	code;
+	constructor(code, message, cause) {
+		super(message);
+		this.name = "Jin10Error";
+		this.code = code;
+		if (cause !== void 0) this.cause = cause;
+	}
+};
+/**
+* 上游业务错误消息 → 错误码。
+* 限流文案必须单独识别（决定「今天别再试」的语义）；「不支持该品种」= 代码不在
+* quote://codes 名册内（本出口实测文案，2026-09-13），映射到 UNSUPPORTED_SYMBOL
+* 让工具层语义与市场工具族一致。
+*/
+function codeForUpstreamMessage(message) {
+	if (/上限|限流|频率|rate.?limit|too many/i.test(message)) return "TRADING_RATE_LIMITED";
+	if (/不支持该品种|unsupported (instrument|code|symbol)/i.test(message)) return "TRADING_UNSUPPORTED_SYMBOL";
+	return "TRADING_EXCHANGE_ERROR";
+}
+//#endregion
+export { Jin10Error, TOKEN_HINT, codeForUpstreamMessage };

package/lib/flash-service.d.ts

@@ -0,0 +1,8 @@
+import { Jin10Service } from "./service.js";
+import { FlashFeedService } from "@dshtrading/api";
+//#region src/flash-service.d.ts
+declare const TRADING_FLASH_FEED_KEY = "tradingFlashFeed";
+/** 快讯源实现（桥与工具面共用同一 Jin10Service）。 */
+declare function createJin10FlashFeed(feed: Jin10Service): FlashFeedService;
+//#endregion
+export { TRADING_FLASH_FEED_KEY, createJin10FlashFeed };

package/lib/flash-service.js

@@ -0,0 +1,30 @@
+import { isJin10HeatLevel } from "./web-flash.js";
+//#region src/flash-service.ts
+const TRADING_FLASH_FEED_KEY = "tradingFlashFeed";
+/** 快讯源实现（桥与工具面共用同一 Jin10Service）。 */
+function createJin10FlashFeed(feed) {
+	return {
+		/**
+		* 最新快讯流（cursor 翻页；条目只含元数据，正文零再分发）。
+		* `hot` 含有效热度等级时走网页版服务端过滤（火/热/沸/爆）；否则走 MCP 全量流。
+		*/
+		async listFlash(options = {}) {
+			const hot = (options.hot ?? []).filter(isJin10HeatLevel);
+			const page = hot.length > 0 ? await feed.listFlashByHeat({
+				hot,
+				...options.cursor !== void 0 ? { cursor: options.cursor } : {}
+			}) : await feed.listFlash(options);
+			return {
+				items: page.items,
+				hasMore: page.hasMore,
+				...page.nextCursor !== void 0 ? { nextCursor: page.nextCursor } : {}
+			};
+		},
+		/** 关键词搜快讯（上游一次性返回、不支持翻页）。 */
+		async searchFlash(keyword, limit) {
+			return feed.searchFlash(keyword, limit);
+		}
+	};
+}
+//#endregion
+export { TRADING_FLASH_FEED_KEY, createJin10FlashFeed };

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+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 { 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 { 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 { 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 };

package/lib/index.js

@@ -0,0 +1,10 @@
+import { Jin10Error, TOKEN_HINT, codeForUpstreamMessage } from "./errors.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 { 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 { 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 };

package/lib/market-data.d.ts

@@ -0,0 +1,27 @@
+import { Jin10Quote } from "./parse.js";
+import { Jin10Service } from "./service.js";
+import { Kline, MarketDataService, Ticker } from "@dshtrading/api";
+//#region src/market-data.d.ts
+/** 市场 id：全局品种（大宗/外汇/海外指数），与 crypto/us/cn/hk/futures 同级。 */
+declare const GLOBAL_MARKET = "global";
+/** 路由 provider slug（router PROVIDER_VOCABULARY 同步登记）。 */
+declare const JIN10_PROVIDER = "jin10";
+/** Context 服务键（与其余市场 trading<Market>MarketData 命名一致）。 */
+declare const TRADING_GLOBAL_MARKET_DATA_KEY = "tradingGlobalMarketData";
+/** 上游单次 get_kline 上限（count 1..100，从 time 往后取）。 */
+declare const MINUTE_BARS_PER_CALL = 100;
+/** 本仓最多拼的分钟窗口（3 次上游调用）；再深的历史上游没有，不做假数据。 */
+declare const MAX_MINUTE_WINDOW = 300;
+/** Ticker 轮询周期（上游无推送通道）。 */
+declare const TICKER_POLL_MS = 5000;
+declare function resolveIntervalMinutes(interval: string): number | undefined;
+/** 按分钟数聚合（桶起点 = 本地时间轴对齐；量能求和，缺量按 0）。 */
+declare function aggregateKlines(bars: readonly Kline[], minutes: number): Kline[];
+/** get_quote → Ticker（缺失最新价 = 上游形状异常，如实报错，不编价格）。 */
+declare function tickerFromQuote(quote: Jin10Quote): Ticker;
+/** global 市场数据面实现（纯对象；与快讯面同款，避免 Service 构造签名的类型漂移）。 */
+declare function createJin10GlobalMarketDataService(feed: Jin10Service, options?: {
+  pollMs?: number;
+}): MarketDataService;
+//#endregion
+export { GLOBAL_MARKET, JIN10_PROVIDER, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, TICKER_POLL_MS, TRADING_GLOBAL_MARKET_DATA_KEY, aggregateKlines, createJin10GlobalMarketDataService, resolveIntervalMinutes, tickerFromQuote };

package/lib/market-data.js

@@ -0,0 +1,160 @@
+import { Jin10Error } from "./errors.js";
+//#region src/market-data.ts
+/** 市场 id：全局品种（大宗/外汇/海外指数），与 crypto/us/cn/hk/futures 同级。 */
+const GLOBAL_MARKET = "global";
+/** 路由 provider slug（router PROVIDER_VOCABULARY 同步登记）。 */
+const JIN10_PROVIDER = "jin10";
+/** Context 服务键（与其余市场 trading<Market>MarketData 命名一致）。 */
+const TRADING_GLOBAL_MARKET_DATA_KEY = "tradingGlobalMarketData";
+/** 上游单次 get_kline 上限（count 1..100，从 time 往后取）。 */
+const MINUTE_BARS_PER_CALL = 100;
+/** 本仓最多拼的分钟窗口（3 次上游调用）；再深的历史上游没有，不做假数据。 */
+const MAX_MINUTE_WINDOW = 300;
+/** Ticker 轮询周期（上游无推送通道）。 */
+const TICKER_POLL_MS = 5e3;
+/** 支持的周期 → 每根分钟数（api Interval 的子集：分钟级来源能诚实支撑的部分）。 */
+const INTERVAL_MINUTES = {
+	"1m": 1,
+	"3m": 3,
+	"5m": 5,
+	"15m": 15,
+	"30m": 30,
+	"1h": 60
+};
+function resolveIntervalMinutes(interval) {
+	return INTERVAL_MINUTES[interval];
+}
+/** 按分钟数聚合（桶起点 = 本地时间轴对齐；量能求和，缺量按 0）。 */
+function aggregateKlines(bars, minutes) {
+	if (minutes <= 1) return bars.map((bar) => ({ ...bar }));
+	const bucketMs = minutes * 6e4;
+	const out = [];
+	for (const bar of bars) {
+		const start = Math.floor(bar.openTime / bucketMs) * bucketMs;
+		const last = out[out.length - 1];
+		if (last !== void 0 && last.openTime === start) {
+			out[out.length - 1] = {
+				openTime: last.openTime,
+				closeTime: bar.closeTime,
+				open: last.open,
+				high: Math.max(last.high, bar.high),
+				low: Math.min(last.low, bar.low),
+				close: bar.close,
+				volume: last.volume + bar.volume
+			};
+			continue;
+		}
+		out.push({
+			...bar,
+			openTime: start,
+			closeTime: start + bucketMs - 1
+		});
+	}
+	return out;
+}
+/** get_quote → Ticker（缺失最新价 = 上游形状异常，如实报错，不编价格）。 */
+function tickerFromQuote(quote) {
+	const price = quote.close;
+	if (price === void 0 || !Number.isFinite(price)) throw new Jin10Error("TRADING_EXCHANGE_ERROR", "jin10 get_quote: " + quote.code + " has no latest price (market closed or symbol unavailable)");
+	const change = quote.change;
+	const prevClose = change === void 0 ? void 0 : Number((price - change).toFixed(6));
+	const parsedTime = quote.time === void 0 ? NaN : Date.parse(quote.time);
+	return {
+		symbol: quote.code.toUpperCase(),
+		...quote.name !== void 0 ? { name: quote.name } : {},
+		price,
+		...prevClose !== void 0 ? { prevClose } : {},
+		...quote.changePercent !== void 0 ? { changePercent: quote.changePercent } : {},
+		...quote.volume !== void 0 ? { volume: quote.volume } : {},
+		timestamp: Number.isFinite(parsedTime) ? parsedTime : Date.now()
+	};
+}
+/**
+* 单根分钟 K → 契约 Kline（openTime/closeTime 毫秒，量缺省 0）。
+* 上游字段可缺省 → 缺 OHLC 的残根返回 undefined（丢弃，不编价格）。
+*/
+function minuteBarToKline(bar) {
+	const { open, high, low, close } = bar;
+	if (open === void 0 || high === void 0 || low === void 0 || close === void 0) return void 0;
+	const openTime = bar.time * 1e3;
+	return {
+		openTime,
+		closeTime: openTime + 6e4 - 1,
+		open,
+		high,
+		low,
+		close,
+		volume: bar.volume ?? 0
+	};
+}
+/** global 市场数据面实现（纯对象；与快讯面同款，避免 Service 构造签名的类型漂移）。 */
+function createJin10GlobalMarketDataService(feed, options = {}) {
+	const pollMs = options.pollMs ?? 5e3;
+	const requireCode = (symbol) => {
+		const trimmed = symbol.trim().toUpperCase();
+		if (trimmed === "") throw new Jin10Error("TRADING_UNKNOWN", "jin10 global: symbol must not be empty");
+		return trimmed;
+	};
+	const loadTicker = async (symbol) => tickerFromQuote(await feed.getQuote(requireCode(symbol)));
+	/** 拼分钟窗口（从 time 往后取，最多 3 次上游调用；按时间戳去重后升序）。 */
+	const loadMinuteWindow = async (symbol, minutes) => {
+		const start = Math.floor(Date.now() / 1e3) - minutes * 60;
+		const calls = Math.max(1, Math.min(Math.ceil(minutes / 100), Math.ceil(3)));
+		const seen = /* @__PURE__ */ new Set();
+		const collected = [];
+		for (let index = 0; index < calls; index += 1) {
+			const from = start + index * 100 * 60;
+			const raw = await feed.getKlines(symbol, {
+				time: from,
+				count: 100
+			});
+			for (const bar of raw) {
+				if (seen.has(bar.time)) continue;
+				const kline = minuteBarToKline(bar);
+				if (kline === void 0) continue;
+				seen.add(bar.time);
+				collected.push(kline);
+			}
+		}
+		return collected.sort((a, b) => a.openTime - b.openTime);
+	};
+	return {
+		async getTicker(symbol) {
+			return loadTicker(symbol);
+		},
+		async getKlines(symbol, interval, limit = 120) {
+			const minutes = resolveIntervalMinutes(interval);
+			if (minutes === void 0) throw new Jin10Error("TRADING_UNKNOWN", "jin10 global: unsupported interval \"" + interval + "\" (upstream serves minute bars only: 1m/3m/5m/15m/30m/1h)");
+			const wanted = Math.max(1, Math.min(Math.floor(limit), Math.floor(300 / minutes)));
+			return aggregateKlines(await loadMinuteWindow(requireCode(symbol), wanted * minutes), minutes).slice(-wanted);
+		},
+		subscribeTicker(symbol, listener) {
+			let stopped = false;
+			const tick = async () => {
+				if (stopped) return;
+				try {
+					const ticker = await loadTicker(symbol);
+					if (!stopped) listener(ticker);
+				} catch (error) {
+					if (!stopped) console.warn("[dsh-trading] jin10 ticker poll failed for " + symbol + ":", error);
+				}
+			};
+			tick();
+			const timer = setInterval(() => {
+				tick();
+			}, pollMs);
+			return { dispose() {
+				stopped = true;
+				clearInterval(timer);
+			} };
+		},
+		async listInstruments() {
+			return (await feed.listInstruments()).map((item) => ({
+				symbol: item.code.toUpperCase(),
+				name: item.name
+			}));
+		}
+	};
+}
+//#endregion
+export { GLOBAL_MARKET, JIN10_PROVIDER, MAX_MINUTE_WINDOW, MINUTE_BARS_PER_CALL, TICKER_POLL_MS, TRADING_GLOBAL_MARKET_DATA_KEY, aggregateKlines, createJin10GlobalMarketDataService, resolveIntervalMinutes, tickerFromQuote };

package/lib/mcp.d.ts

@@ -0,0 +1,81 @@
+//#region src/mcp.d.ts
+declare const DEFAULT_ENDPOINT = "https://mcp.jin10.com/mcp";
+declare const DEFAULT_PROTOCOL_VERSION = "2025-11-25";
+declare const DEFAULT_TIMEOUT_MS = 15000;
+interface McpToolDescriptor {
+  name: string;
+  description?: string;
+  inputSchema?: unknown;
+  outputSchema?: unknown;
+}
+interface McpResourceDescriptor {
+  uri: string;
+  name?: string;
+  mimeType?: string;
+  description?: string;
+}
+/** 可读文本段（structuredContent 缺席时的兜底来源）。 */
+interface McpContentPart {
+  type?: string;
+  text?: string;
+}
+/** `tools/call` 的原始结果（structuredContent 优先，content 只作文本兜底）。 */
+interface McpToolResult {
+  structuredContent?: unknown;
+  content?: readonly McpContentPart[];
+  isError?: boolean;
+}
+interface Jin10McpOptions {
+  endpoint?: string;
+  /** 惰性凭证源：每次请求解析（settings 热切换/异步加载晚于插件 apply 亦生效）。 */
+  token: () => string | undefined;
+  /** 单次请求超时（ms），缺省 15s。 */
+  timeoutMs?: number;
+  /** 依赖注入的 fetch（测试用 mock；缺省 globalThis.fetch）。 */
+  fetchImpl?: typeof globalThis.fetch;
+  /** 协议版本（缺省 2025-11-25）。 */
+  protocolVersion?: string;
+  clientName?: string;
+  clientVersion?: string;
+}
+interface JsonRpcMessage {
+  jsonrpc?: string;
+  id?: unknown;
+  result?: unknown;
+  error?: {
+    code?: unknown;
+    message?: unknown;
+    data?: unknown;
+  };
+}
+/** 把响应体解析成 JSON-RPC 消息（直出 JSON 或 SSE 单行 data 均可）。 */
+declare function parseMcpBody(text: string): JsonRpcMessage | undefined;
+declare class Jin10McpClient {
+  private readonly endpoint;
+  private readonly token;
+  private readonly timeoutMs;
+  private readonly fetchImpl;
+  private readonly protocolVersion;
+  private readonly clientName;
+  private readonly clientVersion;
+  private nextId;
+  private sessionId;
+  private handshake;
+  constructor(options: Jin10McpOptions);
+  listTools(): Promise<McpToolDescriptor[]>;
+  listResources(): Promise<McpResourceDescriptor[]>;
+  /** 读资源正文（quote://codes 等；返回全部 text 段拼接）。 */
+  readResource(uri: string): Promise<string>;
+  /** 原始 tools/call（不做业务解包；协议/HTTP 错误在此抛出）。 */
+  callTool(tool: string, args?: Record<string, unknown>): Promise<McpToolResult>;
+  /**
+   * 业务取数：structuredContent 优先，text 兜底；`isError`/`status !== 200`/`data === null`
+   * 都按上游业务错误抛出（含限流文案识别）。返回上游 `data` 字段。
+   */
+  callToolData(tool: string, args?: Record<string, unknown>): Promise<unknown>;
+  private ensureHandshake;
+  private performHandshake;
+  private rpc;
+}
+//#endregion
+export { DEFAULT_ENDPOINT, DEFAULT_PROTOCOL_VERSION, DEFAULT_TIMEOUT_MS, Jin10McpClient, Jin10McpOptions, McpContentPart, McpResourceDescriptor, McpToolDescriptor, McpToolResult, parseMcpBody };