@dshtrading/kit-crypto 0.2.1 → 0.3.0

package/lib/api/lib/index.d.ts

@@ -584,6 +584,10 @@ declare module '@deepseek-ai/cordis' {
     tradingCnMarketData: MarketDataService;
     /** hk 市场行情服务（由腾讯连接器同包双实例提供，config.market 分流；cn+hk 切片 2026-08-31 补齐）。 */
     tradingHkMarketData: MarketDataService;
+    /** futures 市场行情服务（由同花顺期货连接器提供，issue #97；日K + 当日分时聚合）。 */
+    tradingFuturesMarketData: MarketDataService;
+    /** 全球品种行情（global 市场：大宗/外汇/海外指数；@dshtrading/connector-jin10 dataplane 行提供）。 */
+    tradingGlobalMarketData: MarketDataService;
     /**
      * crypto 市场交易服务（R3 2026-08-29 补齐，crypto 市场第一个真实 TradeService）：
      * 由 connector-okx 实现（签名 demo/live 下单），与 connector-binance 经
@@ -614,6 +618,8 @@ declare module '@deepseek-ai/cordis' {
      * 各市场 Kit apply 时注册 aggregateNews 纯函数，GUI 行情桥按市场获取。
      */
     tradingNewsRegistry: TradingNewsRegistry;
+    /** 跨市场快讯源（@dshtrading/connector-jin10 提供；缺席 = 未安装快讯连接器）。 */
+    tradingFlashFeed: FlashFeedService;
   }
 }
 /**
@@ -689,6 +695,8 @@ interface NewsItem {
   readonly publishedAt: string;
   /** 关联标的代码（可选，格式随源不同）。 */
   readonly relatedCodes?: readonly string[];
+  /** 热度等级（可选；金十快讯网页版 火/热/沸/爆，其他源不填）。 */
+  readonly hot?: string;
 }
 /** 新闻聚合请求选项。 */
 interface AggregateNewsOptions {
@@ -700,6 +708,11 @@ interface AggregateNewsOptions {
   symbol?: string | undefined;
   /** CryptoPanic API token（仅 crypto 市场使用，可选）。 */
   cryptoPanicKey?: string | undefined;
+  /**
+   * 启用的新闻/公告源 id 列表（issue #96 源配置化；各 kit 的 NewsSource 词汇）。
+   * 缺省 = 该市场全部默认源；空数组 = 显式关闭（返回空结果）。
+   */
+  sources?: readonly string[] | undefined;
 }
 /** 新闻聚合结果。 */
 interface AggregateNewsResult {
@@ -710,6 +723,29 @@ interface AggregateNewsResult {
 }
 /** 新闻聚合器函数签名（各 Kit 导出的 aggregateNews 符合此形状）。 */
 type NewsAggregator = (options?: AggregateNewsOptions) => Promise<AggregateNewsResult>;
+/**
+ * 跨市场快讯源契约（2026-09-13 金十接入）：host 平面由快讯连接器 provide
+ * tradingFlashFeed，GUI 快讯面板（桥 /dshtrading/api/flash）与 agent 快讯工具
+ * 共用同一取数实现；服务缺席 = 未安装/未启用该数据源 → 消费方报
+ * TRADING_NOT_IMPLEMENTED，绝不把「没有数据源」伪装成「没有快讯」。
+ */
+interface FlashFeedService {
+  /**
+   * 最新快讯流（cursor 翻页）；条目只含元数据（标题/时间/链接）。
+   * `hot` 非空时按热度等级服务端过滤（金十网页版 火/热/沸/爆）。
+   */
+  listFlash(options?: {
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    hot?: readonly string[] | undefined;
+  }): Promise<{
+    readonly items: readonly NewsItem[];
+    readonly nextCursor?: string | undefined;
+    readonly hasMore: boolean;
+  }>;
+  /** 关键词搜快讯（上游一次性返回、不支持翻页）。 */
+  searchFlash(keyword: string, limit?: number | undefined): Promise<readonly NewsItem[]>;
+}
 /** 新闻聚合器注册表契约（Issue #37，router 插件提供）。 */
 interface TradingNewsRegistry {
   register(market: string, aggregator: NewsAggregator): () => void;
@@ -717,4 +753,4 @@ interface TradingNewsRegistry {
   markets(): string[];
 }
 //#endregion
-export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, ForecastSummary, FundamentalsPackage, HolderNumSummary, InsiderTradeItem, InstitutionalHoldingItem, Interval, Kline, LimitUpPoolItem, MainOperationSegment, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingNewsRegistry };
+export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, InsiderTradeItem, InstitutionalHoldingItem, Interval, Kline, LimitUpPoolItem, MainOperationSegment, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingNewsRegistry };

package/lib/index.d.ts

@@ -10,14 +10,14 @@ declare const provider: SkillProvider;
 interface Config {
   dryRun: boolean;
   liveTrading: boolean;
-  /** 角色预设按需收窄技能面；缺省保持全量捆绑目录。 */
-  skills?: string[];
+  /** 角色预设按需收窄技能面；字段缺席保持全量捆绑目录，显式空数组才表示不下发任何技能。 */
+  skills?: string[] | null;
 }
 declare const Config: Schema<Config>;
 declare const inject: string[];
 declare const name = "dsh-trading-crypto-kit";
 /** 白名单视图：未知名 fail-fast 不静默缩面；白名单外的 get 拒绝分发。 */
-declare function providerForSkills(allowed?: readonly string[]): SkillProvider;
+declare function providerForSkills(allowed?: readonly string[] | null): SkillProvider;
 declare function apply(ctx: Context, config: Config): void;
 declare function createGetDerivativesTool(options?: {
   fetch?: typeof globalThis.fetch;
@@ -41,6 +41,7 @@ declare function createGetFundamentalsTool(options?: {
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
 declare function createGetNewsTool(toolOptions?: {
   cryptoPanicKey?: string;
+  getSources?: () => readonly string[] | undefined;
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
 //#endregion
 export { AggregateNewsOptions, AggregateNewsResult, Config, CryptoFundamentalsOptions, CryptoFundamentalsResult, DerivativesFetchOptions, DerivativesResult, NewsItem, NewsSource, aggregateNews, apply, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };

package/lib/index.js

@@ -131,7 +131,7 @@ const provider = {
 const Config = Schema.object({
 	dryRun: Schema.boolean().default(true),
 	liveTrading: Schema.boolean().default(false),
-	skills: Schema.array(Schema.string())
+	skills: Schema.union([Schema.array(Schema.string()), Schema.const(null)]).default(null)
 });
 const inject = ["skills", "tools"];
 const name = "dsh-trading-crypto-kit";
@@ -219,7 +219,12 @@ function apply(ctx, config) {
 	};
 	registerOnce(fundingTool);
 	const router = ctx.get?.("tradingMarketRouter", false);
-	registerOnce(createGetNewsTool({ cryptoPanicKey: router?.newsKey?.() }));
+	const routerCtx = ctx;
+	const readNewsSources = () => (routerCtx.get?.("tradingMarketRouter", false))?.newsSources?.("crypto");
+	registerOnce(createGetNewsTool({
+		cryptoPanicKey: router?.newsKey?.(),
+		getSources: readNewsSources
+	}));
 	registerOnce(createGetDerivativesTool());
 	registerOnce(createGetFundamentalsTool());
 	registerOnce(createGetDerivativesHistoryTool({ getRegistry: () => resolveCryptoMarketDataRegistry(ctx) }));
@@ -397,7 +402,8 @@ function createGetNewsTool(toolOptions = {}) {
 				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,
-				cryptoPanicKey: toolOptions.cryptoPanicKey
+				cryptoPanicKey: toolOptions.cryptoPanicKey,
+				sources: toolOptions.getSources?.()
 			};
 			const { items, unavailable } = await aggregateNews(options);
 			if (items.length === 0 && unavailable.length === 0) return "crypto_get_news: no news items found within the requested window.";

package/lib/news.d.ts

@@ -34,6 +34,8 @@ interface AggregateNewsOptions {
   now?: number | undefined;
   /** WS2c：CryptoPanic API token。有值时加测 CryptoPanic 免费层（B 增强）；无值 = 仅公共源。 */
   cryptoPanicKey?: string | undefined;
+  /** 启用源 id 列表（issue #96 源配置化）；缺省 = 全部默认源，空数组 = 显式关闭。 */
+  sources?: readonly string[] | undefined;
 }
 interface AggregateNewsResult {
   items: NewsItem[];

package/lib/news.js

@@ -161,15 +161,16 @@ async function aggregateNews(options = {}) {
 	const windowMs = clampNumber(options.windowHours, DEFAULT_WINDOW_HOURS, 1, 168) * 36e5;
 	const limit = clampNumber(options.limit, DEFAULT_LIMIT, 1, MAX_LIMIT);
 	const tokens = deriveSymbolTokens(options.symbol);
-	const fetchers = [
-		fetchBinanceNews(fetchImpl),
-		fetchOkxNews(fetchImpl),
-		fetchRssNews(fetchImpl, "coindesk", COINDESK_RSS_URL),
-		fetchRssNews(fetchImpl, "theblock", THEBLOCK_RSS_URL),
-		fetchRssNews(fetchImpl, "cointelegraph", COINTELEGRAPH_RSS_URL),
-		fetchRssNews(fetchImpl, "decrypt", DECRYPT_RSS_URL)
-	];
-	if (options.cryptoPanicKey && options.cryptoPanicKey.trim()) {
+	const enabled = options.sources;
+	const isEnabled = (id) => enabled === void 0 || enabled.includes(id);
+	const fetchers = [];
+	if (isEnabled("binance")) fetchers.push(fetchBinanceNews(fetchImpl));
+	if (isEnabled("okx")) fetchers.push(fetchOkxNews(fetchImpl));
+	if (isEnabled("coindesk")) fetchers.push(fetchRssNews(fetchImpl, "coindesk", COINDESK_RSS_URL));
+	if (isEnabled("theblock")) fetchers.push(fetchRssNews(fetchImpl, "theblock", THEBLOCK_RSS_URL));
+	if (isEnabled("cointelegraph")) fetchers.push(fetchRssNews(fetchImpl, "cointelegraph", COINTELEGRAPH_RSS_URL));
+	if (isEnabled("decrypt")) fetchers.push(fetchRssNews(fetchImpl, "decrypt", DECRYPT_RSS_URL));
+	if (options.cryptoPanicKey && options.cryptoPanicKey.trim() && isEnabled("cryptopanic")) {
 		const currencies = [...new Set(tokens.map((t) => t.replace(/[-_]?(?:SWAP|PERP|FUTURES|DEFAULT)$/i, "")).map((t) => t.replace(/(?:USDT|USDC|BUSD|FDUSD|USD)$/i, "")))].filter(Boolean).join(",");
 		fetchers.push(fetchCryptoPanicNews(fetchImpl, options.cryptoPanicKey.trim(), currencies));
 	}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/kit-crypto",
   "description": "Crypto toolkit plugin for dsh-trading: market-specific tools and bundled trading skills (skill provider); runs as a crypto-trader preset row (session-scoped)",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,8 +18,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/knowledge": "0.2.1",
-    "@dshtrading/indicators": "0.2.1"
+    "@dshtrading/indicators": "0.3.0",
+    "@dshtrading/knowledge": "0.3.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
@@ -30,7 +30,7 @@
   "devDependencies": {
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0",
-    "@dshtrading/api": "0.2.1"
+    "@dshtrading/api": "0.3.0"
   },
   "scripts": {
     "build": "tsdown",