@dshtrading/kit-us 0.6.0 → 0.6.2

package/lib/fundamentals.d.ts

@@ -1,4 +1,4 @@
-import { CompanyProfile, FinancialReportMatrix, FundamentalsPackage, StockFundamentals } from "./api/lib/index.js";
+import { StockFundamentals } from "@dshtrading/api";
 //#region src/fundamentals.d.ts
 interface UsFundamentalsOptions {
   symbol: string;
@@ -18,11 +18,11 @@ declare function normalizeUsSymbol(input: string): string;
 declare function fetchUsFundamentals(options: UsFundamentalsOptions): Promise<UsFundamentalsResult>;
 /** 从 Yahoo Finance quoteSummary 动态拉取美股多期财务报表与指标矩阵。 */
 declare function fetchUsFinancialMatrix(symbol: string, fetchImpl?: typeof globalThis.fetch): Promise<{
-  matrix?: FinancialReportMatrix;
-  profile?: CompanyProfile;
+  matrix?: import('@dshtrading/api').FinancialReportMatrix;
+  profile?: import('@dshtrading/api').CompanyProfile;
 }>;
 /** 获取完整美股基本面数据包。 */
-declare function fetchUsFundamentalsPackage(symbol: string, fetchImpl?: typeof globalThis.fetch): Promise<FundamentalsPackage>;
+declare function fetchUsFundamentalsPackage(symbol: string, fetchImpl?: typeof globalThis.fetch): Promise<import('@dshtrading/api').FundamentalsPackage>;
 declare function renderUsFundamentals(result: UsFundamentalsResult, requestedSymbol: string): string;
 //#endregion
 export { UsFundamentalsOptions, UsFundamentalsResult, fetchUsFinancialMatrix, fetchUsFundamentals, fetchUsFundamentalsPackage, normalizeUsSymbol, renderUsFundamentals };

package/lib/index.d.ts

@@ -1,21 +1,17 @@
 import { UsFundamentalsOptions, UsFundamentalsResult, fetchUsFinancialMatrix, fetchUsFundamentals, fetchUsFundamentalsPackage, normalizeUsSymbol, renderUsFundamentals } from "./fundamentals.js";
 import { AggregateNewsOptions, AggregateNewsResult, NewsItem, NewsSource, aggregateNews, parseGoogleNewsRss, parseSecEdgarAtom } from "./news.js";
-import Schema from "@deepseek-ai/schemastery";
 import { SkillProvider } from "@deepseek-ai/dsh-skill";
+import { KitConfig } from "@dshtrading/base/role-skills";
 import { Context } from "@deepseek-ai/cordis";
+import Schema from "@deepseek-ai/schemastery";
 //#region src/index.d.ts
 declare const provider: SkillProvider;
-interface Config {
-  dryRun: boolean;
-  liveTrading: boolean;
-  /** 角色预设按需收窄技能面；字段缺席保持全量捆绑目录，显式空数组才表示不下发任何技能。 */
-  skills?: string[] | null;
-}
+type Config = KitConfig;
 declare const Config: Schema<Config>;
 declare const inject: string[];
 declare const name = "dsh-trading-us-kit";
-/** 白名单视图：未知名 fail-fast 不静默缩面；白名单外的 get 拒绝分发。 */
-declare function providerForSkills(allowed?: readonly string[] | null): SkillProvider;
+/** 白名单视图（三态语义与注册骨架见 @dshtrading/base/role-skills）。 */
+declare const providerForSkills: (allowed?: readonly string[] | null) => SkillProvider;
 declare function apply(ctx: Context, config: Config): void;
 declare function createGetNewsTool(toolOptions?: {
   getSources?: () => readonly string[] | undefined;

package/lib/index.js

@@ -2,9 +2,9 @@ import { aggregateNews, parseGoogleNewsRss, parseSecEdgarAtom } from "./news.js"
 import { fetchUsFinancialMatrix, fetchUsFundamentals, fetchUsFundamentalsPackage, normalizeUsSymbol, renderUsFundamentals } 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 { kitConfigSchema, kitSkillMessages, registerSkillProvider, skillWhitelistView } from "@dshtrading/base/role-skills";
 import { createGetIndicatorsTool } from "@dshtrading/indicators/tool";
 //#region src/index.ts
 /**
@@ -112,30 +112,13 @@ const provider = {
 		};
 	}
 };
-const Config = Schema.object({
-	dryRun: Schema.boolean().default(true),
-	liveTrading: Schema.boolean().default(false),
-	skills: Schema.union([Schema.array(Schema.string()), Schema.const(null)]).default(null)
-});
+const Config = kitConfigSchema();
 const inject = ["skills", "tools"];
 const name = "dsh-trading-us-kit";
-/** 白名单视图：未知名 fail-fast 不静默缩面；白名单外的 get 拒绝分发。 */
-function providerForSkills(allowed) {
-	if (!allowed) return provider;
-	const unknown = allowed.filter((name) => !SKILL_CANDIDATES.some((c) => c.name === name));
-	if (unknown.length > 0) throw new Error(`[${PROVIDER_NAME}] unknown skills in whitelist: ${unknown.join(", ")}`);
-	const active = SKILL_CANDIDATES.filter((c) => allowed.includes(c.name));
-	return {
-		name: provider.name,
-		list: () => Promise.resolve(active),
-		async get(candidate, options) {
-			if (!active.some((c) => c.name === candidate.name)) throw new Error(`[${PROVIDER_NAME}] skill not in whitelist: ${candidate.name}`);
-			return provider.get(candidate, options);
-		}
-	};
-}
+/** 白名单视图（三态语义与注册骨架见 @dshtrading/base/role-skills）。 */
+const providerForSkills = skillWhitelistView(provider, SKILL_CANDIDATES, kitSkillMessages(PROVIDER_NAME));
 function apply(ctx, config) {
-	ctx.skills.registerProvider(() => providerForSkills(config.skills));
+	registerSkillProvider(ctx, config, providerForSkills);
 	const routerCtx = ctx;
 	const readNewsSources = () => (routerCtx.get?.("tradingMarketRouter", false))?.newsSources?.("us");
 	const newsTool = createGetNewsTool({ getSources: readNewsSources });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/kit-us",
   "description": "US market toolkit plugin for dsh-trading: US risk checklist skill provider and US news / fundamentals tools; runs as a us-trader preset row (session-scoped)",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,19 +18,20 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/indicators": "0.6.0",
-    "@dshtrading/knowledge": "0.6.0"
+    "@dshtrading/base": "0.6.2",
+    "@dshtrading/indicators": "0.6.2",
+    "@dshtrading/knowledge": "0.6.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-skill": ">=0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-skill": ">=0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2",
     "@deepseek-ai/schemastery": ">=3.18.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0",
-    "@dshtrading/api": "0.6.0"
+    "@dshtrading/api": "0.6.2"
   },
   "scripts": {
     "build": "tsdown",

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

@@ -1,895 +0,0 @@
-import "./instrument-form.js";
-import "@deepseek-ai/cordis";
-//#region ../api/lib/index.d.ts
-//#region src/index.d.ts
-/** K线周期（Binance 现货/合约 interval 词汇）。 */
-type Interval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M';
-/** 最新行情快照（公共数据，无需凭证）。 */
-interface Ticker {
-  /** 交易对符号，**市场规范词汇**（docs/symbol-vocabulary.md：crypto=BTCUSDT，us=AAPL，cn=600519.SH，hk=00700.HK）。 */
-  readonly symbol: string;
-  /** 标的/公司名称（如“紫光股份”、“苹果”、“腾讯控股”；部分数据源可缺省）。 */
-  readonly name?: string;
-  /** 最新成交价。 */
-  readonly price: number;
-  /** 最优买价（部分数据源可缺省）。 */
-  readonly bid?: number;
-  /** 最优卖价（部分数据源可缺省）。 */
-  readonly ask?: number;
-  /** 24h 成交量（base 资产计）。 */
-  readonly volume?: number;
-  /** 快照时间（epoch ms）。 */
-  readonly timestamp: number;
-  /** 官方昨收（涨跌基准锚点；部分数据源可缺省，缺省时消费方退回日 K 自算）。 */
-  readonly prevClose?: number;
-  /** 相对昨收的涨跌幅（百分比，如 -0.89 表示 -0.89%；部分数据源可缺省）。 */
-  readonly changePercent?: number;
-}
-/** 单根 K 线。 */
-interface Kline {
-  readonly openTime: number;
-  readonly open: number;
-  readonly high: number;
-  readonly low: number;
-  readonly close: number;
-  readonly volume: number;
-  readonly closeTime: number;
-}
-/** 衍生品市场指标快照（持仓量/多空比/资金费等）。 */
-interface DerivativesData {
-  /** 交易对符号，市场规范词汇（如 BTCUSDT 或 BTCUSDT-SWAP）。 */
-  readonly symbol: string;
-  /** 数据来源（如 binance / okx）。 */
-  readonly source: string;
-  /** 未平仓合约量（Open Interest，base 币数或张数）。 */
-  readonly openInterest?: number;
-  /** 未平仓合约总价值（USD 或 quote 计价）。 */
-  readonly openInterestValue?: number;
-  /** 多空人数比（Long/Short Account Ratio）。 */
-  readonly longShortRatio?: number;
-  /** 大户持仓多空比（Top Trader Long/Short Position Ratio）。 */
-  readonly topTraderLongShortRatio?: number;
-  /** 主动买入/卖出量比（Taker Buy/Sell Volume Ratio）。 */
-  readonly takerBuySellRatio?: number;
-  /** 最新资金费率（小数，如 0.0001 表示 0.01%）。 */
-  readonly fundingRate?: number;
-  /** 预测（下一期）资金费率（小数；交易所未发布预测时缺省，issue #54）。 */
-  readonly nextFundingRate?: number;
-  /** 下一期资金费率结算时间（epoch ms，GUI 倒计时用，issue #54）。 */
-  readonly nextFundingTime?: number;
-  /** 标记价格（Mark Price，永续合约；issue #54 基差卡用）。 */
-  readonly markPrice?: number;
-  /** 指数价格（Index Price，现货指数；与 markPrice 配对计算基差）。 */
-  readonly indexPrice?: number;
-  /** 快照时间（epoch ms）。 */
-  readonly timestamp: number;
-}
-/** 衍生品时序数据点（资金费率历史 / OI 历史共用词汇，issue #54）。 */
-interface DerivativesPoint {
-  /** 采样时间（epoch ms）。 */
-  readonly time: number;
-  /** 采样值（费率序列为小数费率；OI 序列单位与快照 openInterest 同语义）。 */
-  readonly value: number;
-}
-/**
- * 衍生品历史序列（GUI「衍生品」页签趋势卡用，issue #54）：
- * 资金费率历史 + 未平仓量历史，时间一律升序（旧→新，与 K 线序列同向）。
- * 可选方法 getDerivativesHistory 的返回面；任一序列不可得时该字段缺省，
- * 消费方按卡降级（隐藏趋势图、保留快照读数）。
- */
-interface DerivativesHistory {
-  /** 交易对符号，市场规范词汇（如 BTCUSDT-SWAP）。 */
-  readonly symbol: string;
-  /** 数据来源（如 binance / okx）。 */
-  readonly source: string;
-  /** 资金费率历史（时间升序，value 为小数费率）。 */
-  readonly fundingRates?: DerivativesPoint[];
-  /** OI 历史（时间升序，value 单位与 DerivativesData.openInterest 同语义）。 */
-  readonly openInterest?: DerivativesPoint[];
-}
-/** 加密标的代币经济学与基本面快照。 */
-interface CryptoFundamentals {
-  /** 规范符号或代币代码（如 BTCUSDT 或 BTC）。 */
-  readonly symbol: string;
-  /** 标的资产名称（如 Bitcoin）。 */
-  readonly name?: string;
-  /** 全球市值排名（Market Cap Rank）。 */
-  readonly rank?: number;
-  /** 流通市值（USD 计价）。 */
-  readonly marketCapUsd?: number;
-  /** 完全稀释估值（FDV，USD 计价）。 */
-  readonly fdvUsd?: number;
-  /** 流通供应量。 */
-  readonly circulatingSupply?: number;
-  /** 总供应量 / 最大供应量。 */
-  readonly totalSupply?: number;
-  /** 24h 交易量（USD 计价）。 */
-  readonly volume24hUsd?: number;
-  /** 快照时间（epoch ms）。 */
-  readonly timestamp: number;
-}
-/** 股票市场标的基本面与财务估值快照（US/CN/HK）。 */
-interface StockFundamentals {
-  /** 标的规范符号（如 AAPL, 600519.SH, 00700.HK）。 */
-  readonly symbol: string;
-  /** 公司/标的名称。 */
-  readonly name?: string;
-  /** 总市值（本位币计价）。 */
-  readonly marketCap?: number;
-  /** 流通市值（A 股/港股适用）。 */
-  readonly floatMarketCap?: number;
-  /** 滚动市盈率 PE (TTM)。 */
-  readonly peTtm?: number;
-  /** 静态市盈率 PE (静)。 */
-  readonly peStatic?: number;
-  /** 动态/预测市盈率 Forward / Dynamic PE。 */
-  readonly peDynamic?: number;
-  /** 市净率 PB。 */
-  readonly pb?: number;
-  /** 市销率 PS。 */
-  readonly ps?: number;
-  /** 每股收益 EPS。 */
-  readonly eps?: number;
-  /** 每股净资产 BPS。 */
-  readonly bps?: number;
-  /** 股息率（小数，如 0.015 表示 1.5%）。 */
-  readonly dividendYield?: number;
-  /** 换手率（小数或百分比）。 */
-  readonly turnoverRate?: number;
-  /** 振幅（百分比）。 */
-  readonly amplitudePercent?: number;
-  /** 涨停价（A 股适用）。 */
-  readonly limitUpPrice?: number;
-  /** 跌停价（A 股适用）。 */
-  readonly limitDownPrice?: number;
-  /** 52 周最高价。 */
-  readonly fiftyTwoWeekHigh?: number;
-  /** 52 周最低价。 */
-  readonly fiftyTwoWeekLow?: number;
-  /** 快照时间（epoch ms）。 */
-  readonly timestamp: number;
-}
-/** 盘口档位（价格 + 挂单量，量单位=标的基准单位：股票股、crypto 币）。 */
-interface OrderbookLevel {
-  readonly price: number;
-  readonly amount: number;
-}
-/**
- * 盘口快照（GUI「盘口」竖栏用，issue #39）。实现保证：bids 按价格降序（买一在前）、
- * asks 按价格升序（卖一在前），档位数由数据源决定（沪深五档、crypto 常见 5~20 档）。
- */
-interface Orderbook {
-  readonly symbol: string;
-  readonly bids: readonly OrderbookLevel[];
-  readonly asks: readonly OrderbookLevel[];
-  /** 快照时间（epoch ms）。 */
-  readonly timestamp: number;
-}
-/** 逐笔成交（taker 视角：side 为主动方；流水单条）。 */
-interface TradeTick {
-  /** 交易所成交 id（字符串透传，排序稳定性由时间戳保证）。 */
-  readonly id: string;
-  readonly symbol: string;
-  readonly price: number;
-  /** 成交量（基准单位，同 OrderbookLevel.amount）。 */
-  readonly amount: number;
-  /** 主动方向：buy=主动买（外盘）、sell=主动卖（内盘）；数据源缺方向时 unknown。 */
-  readonly side: 'buy' | 'sell' | 'unknown';
-  readonly timestamp: number;
-}
-/** 单期财务指标数值与同比变动。 */
-interface FinancialCell {
-  /** 指标数值（如 14.18 元 或 19.02%）。 */
-  readonly value?: number;
-  /** 同比增长率（百分比，如 -3.69 表示 -3.69%，+522.77 表示 +522.77%）。 */
-  readonly changePercent?: number;
-}
-/** 单个财务指标行（多期序列）。 */
-interface FinancialIndicatorRow {
-  readonly id: string;
-  readonly name: string;
-  readonly unit?: string;
-  /** 期别映射 -> 该期读数与同比（key 对应 periods 数组中的元素，如 '2025/H1'）。 */
-  readonly values: Record<string, FinancialCell>;
-}
-/** 财务指标大类分组（如“每股指标”、“盈利能力”、“现金流量”等）。 */
-interface FinancialReportGroup {
-  readonly id: string;
-  readonly title: string;
-  readonly rows: FinancialIndicatorRow[];
-}
-/** 历史多期财务报表与指标矩阵（富途牛牛同款）。 */
-interface FinancialReportMatrix {
-  /** 币种（如 CNY / HKD / USD）。 */
-  readonly currency: string;
-  /** 最新报告期标题（如 "2026财年H1 财报"）。 */
-  readonly latestReportTitle?: string;
-  /** 报告期有序列表（由远及近，如 ['2024/H1', '2024/Q3', '2024/FY', '2025/H1', '2025/Q3', '2025/FY', '2026/Q1', '2026/H1']）。 */
-  readonly periods: string[];
-  /** 分组列表。 */
-  readonly groups: FinancialReportGroup[];
-}
-/** 股东持股信息行。 */
-interface ShareholderItem {
-  readonly name: string;
-  readonly shares?: number;
-  readonly ratio?: number;
-  readonly change?: string;
-}
-/** 公司/标的简况信息。 */
-interface CompanyProfile {
-  readonly symbol: string;
-  readonly name?: string;
-  readonly fullName?: string;
-  readonly nameEn?: string;
-  readonly industry?: string;
-  readonly sector?: string;
-  readonly legalRepresentative?: string;
-  readonly chairman?: string;
-  readonly generalManager?: string;
-  readonly boardSecretary?: string;
-  readonly registeredCapital?: string;
-  readonly address?: string;
-  readonly businessScope?: string;
-  readonly employeeCount?: string;
-  readonly description?: string;
-  readonly listingDate?: string;
-  readonly website?: string;
-  readonly executives?: Array<{
-    name: string;
-    title: string;
-  }>;
-}
-/** 机构盈利预测与目标价一致预期（富途 预测）。 */
-interface ForecastSummary {
-  readonly epsCurrentYear?: number;
-  readonly epsNextYear?: number;
-  readonly revenueGrowthAvg?: number;
-  readonly netProfitGrowthAvg?: number;
-  readonly targetPriceAvg?: number;
-  readonly buyRatingCount?: number;
-  readonly holdRatingCount?: number;
-  readonly sellRatingCount?: number;
-  readonly totalOrgs?: number;
-  readonly items?: Array<{
-    readonly year: string;
-    readonly eps: number;
-    readonly revenue: number;
-    readonly netProfit: number;
-    readonly orgCount?: number;
-  }>;
-}
-/** 研报精选（富途 晨星研报/券商研报）。 */
-interface ResearchReportItem {
-  readonly id: string;
-  readonly title: string;
-  readonly orgName: string;
-  readonly author?: string;
-  readonly rating?: string;
-  readonly publishDate: string;
-  readonly summary?: string;
-  readonly url?: string;
-}
-/** 主营构成（富途 经营分析/主营构成）。 */
-interface MainOperationSegment {
-  readonly segmentName: string;
-  readonly classification: 'product' | 'industry' | 'region';
-  readonly revenue: number;
-  readonly revenueRatio: number;
-  readonly grossProfit?: number;
-  readonly grossMargin?: number;
-}
-/** 经营效率指标（富途 经营分析/经营效率）。 */
-interface OperatingEfficiency {
-  readonly inventoryTurnoverDays?: number;
-  readonly accountsReceivableTurnoverDays?: number;
-  readonly operatingCycleDays?: number;
-  readonly totalAssetTurnover?: number;
-  readonly netProfitMargin?: number;
-  readonly grossProfitMargin?: number;
-  readonly currentRatio?: number;
-  readonly quickRatio?: number;
-  readonly roe?: number;
-}
-/** 股东增减持 / 内部人交易（富途 聪明钱/股东增减持）。 */
-interface InsiderTradeItem {
-  readonly holderName: string;
-  readonly changeType: '增持' | '减持' | '不变' | '新进' | string;
-  readonly changeShares: number;
-  readonly changeRatio?: number;
-  readonly postHoldingRatio?: number;
-  readonly date?: string;
-  readonly averagePrice?: number;
-}
-/** 机构持股明细（富途 聪明钱/机构持股）。 */
-interface InstitutionalHoldingItem {
-  readonly orgName?: string;
-  readonly orgType: string;
-  readonly orgCount?: number;
-  readonly holdingShares: number;
-  readonly holdingRatio: number;
-  readonly marketCap?: number;
-  readonly change?: string;
-  readonly changeRatio?: number;
-}
-/** 分红派息方案（富途 公司行动/分红派息）。 */
-interface DividendItem {
-  readonly planYear: string;
-  readonly dividendPlan: string;
-  readonly cashDividend?: number;
-  readonly exDividendDate?: string;
-  readonly dividendDate?: string;
-  readonly recordDate?: string;
-  readonly dividendYield?: number;
-}
-/** 股份回购方案（富途 公司行动/回购）。 */
-interface BuybackItem {
-  readonly date: string;
-  readonly buybackAmount?: number;
-  readonly buybackShares?: number;
-  readonly priceRange?: string;
-  readonly status: string;
-}
-/** 拆股并股 / 送转（富途 公司行动/拆股并股）。 */
-interface SplitItem {
-  readonly date: string;
-  readonly ratio: string;
-  readonly description: string;
-}
-/** 股东户数与筹码集中度（富途 聪明钱）。 */
-interface HolderNumSummary {
-  readonly totalHolders?: number;
-  readonly totalHoldersChangeRatio?: number;
-  readonly avgFreeShares?: number;
-  readonly avgHoldAmount?: number;
-  readonly concentration?: string;
-  readonly reportDate?: string;
-}
-/** 集合竞价快照与强弱基准（同花顺 A 股竞价数据面）。 */
-interface AuctionSnapshot {
-  readonly symbol: string;
-  readonly matchPrice?: number;
-  readonly matchVolume?: number;
-  readonly unmatchedVolume?: number;
-  readonly unmatchedSide?: 'buy' | 'sell';
-  readonly strengthIndex?: number;
-  readonly stage?: 'call' | 'final';
-  readonly timestamp: number;
-}
-/** 涨跌停池与连板天梯条目（同花顺特色短线数据面）。 */
-interface LimitUpPoolItem {
-  readonly symbol: string;
-  readonly name: string;
-  readonly price: number;
-  readonly changePercent: number;
-  readonly limitType: 'up' | 'down' | 'broken';
-  readonly firstLimitTime?: string;
-  readonly lastLimitTime?: string;
-  readonly limitOrderVolume?: number;
-  readonly limitOrderAmount?: number;
-  readonly consecutiveBoards?: number;
-  readonly breakCount?: number;
-  readonly sectorConcept?: string;
-}
-/** 龙虎榜席位与机构明细条目（同花顺特色资金数据面）。 */
-interface DragonTigerItem {
-  readonly symbol: string;
-  readonly name: string;
-  readonly closePrice: number;
-  readonly changePercent: number;
-  readonly reason: string;
-  readonly netBuyAmount: number;
-  readonly buyAmount: number;
-  readonly sellAmount: number;
-  readonly institutionalNetBuy?: number;
-  readonly topBrokers?: Array<{
-    readonly rank: number;
-    readonly brokerName: string;
-    readonly type: 'buy' | 'sell';
-    readonly buyAmount: number;
-    readonly sellAmount: number;
-    readonly isInstitutional: boolean;
-  }>;
-  readonly tradeDate: string;
-}
-/** 聚合基本面数据包（供 Bridge 端点向前端全量交付）。 */
-interface FundamentalsPackage {
-  readonly market: string;
-  readonly symbol: string;
-  readonly stock?: StockFundamentals;
-  readonly crypto?: CryptoFundamentals;
-  readonly matrix?: FinancialReportMatrix;
-  readonly profile?: CompanyProfile;
-  readonly shareholders?: ShareholderItem[];
-  readonly forecast?: ForecastSummary;
-  readonly reports?: ResearchReportItem[];
-  readonly mainOperations?: MainOperationSegment[];
-  readonly efficiency?: OperatingEfficiency;
-  readonly insiderTrades?: InsiderTradeItem[];
-  readonly institutionalHoldings?: InstitutionalHoldingItem[];
-  readonly holderSummary?: HolderNumSummary;
-  readonly dividends?: DividendItem[];
-  readonly buybacks?: BuybackItem[];
-  readonly splits?: SplitItem[];
-  readonly auction?: AuctionSnapshot;
-  readonly limitUpItem?: LimitUpPoolItem;
-  readonly dragonTiger?: DragonTigerItem;
-}
-type PositionSide = 'long' | 'short';
-/**
- * 保证金模式（合约交易语义，P7）：`cross` = 全仓、`isolated` = 逐仓。
- * 现货（cash）不使用该字段——缺席即「非保证金/未设置」。
- */
-type MarginMode = 'cross' | 'isolated';
-/** 持仓快照。 */
-interface Position {
-  readonly symbol: string;
-  readonly side: PositionSide;
-  /** 仓位数量（正数；方向由 side 表达）。合约仓位是 **base 币数**（连接器已按合约乘数 ctVal 由张换算）。 */
-  readonly size: number;
-  readonly entryPrice: number;
-  readonly markPrice?: number;
-  readonly unrealizedPnl?: number;
-  readonly leverage?: number;
-  /**
-   * 强平价（交易所回传原样透传；交易所未提供或不适用时缺席，绝不本地推算强平价——
-   * 强平口径与保证金模式、账户级保证金、维持保证金率有关，本地公式会给出错误的安全感）。
-   */
-  readonly liquidationPrice?: number;
-  /** 维持保证金率（OKX `mgnRatio`；口径由交易所定义，原样透传，不在本地换算或反推）。 */
-  readonly marginRatio?: number;
-  /** 该仓位的保证金模式；现货持仓与交易所未提供时缺席。 */
-  readonly marginMode?: MarginMode;
-  /** 名义价值（USD，交易所口径；用于敞口核对，不参与本地风控公式）。 */
-  readonly notionalUsd?: number;
-  readonly timestamp: number;
-}
-type OrderSide = 'buy' | 'sell';
-type OrderType = 'limit' | 'market';
-type OrderStatus = 'new' | 'partially_filled' | 'filled' | 'canceled' | 'rejected' | 'expired';
-/** 下单请求（安全闸门：dryRun 缺省视为 true）。 */
-interface OrderRequest {
-  readonly symbol: string;
-  readonly side: OrderSide;
-  readonly type: OrderType;
-  /** **base 币数量**：合约（永续）由连接器按合约乘数换算成张，消费方恒用币数语义。 */
-  readonly quantity: number;
-  /** limit 单必填。 */
-  readonly price?: number;
-  /**
-   * 合约订单的保证金模式（缺省 `cross`）。仅对永续（`-SWAP`）有效：
-   * 现货订单只允许 cash 语义，传该字段由连接器结构化拒绝
-   * （现货逐仓/杠杆是另一个产品面，本仓未接线）。
-   * `isolated` 需先在交易所侧设好该标的的逐仓杠杆（OKX `setLeverage`）。
-   */
-  readonly marginMode?: MarginMode;
-  /** 缺省/true 时仅模拟，不触碰交易所。实盘还受 @dshtrading/authority 的人工签署授权与 approval 约束 [S4]。 */
-  readonly dryRun?: boolean;
-}
-/** 订单回执/状态。 */
-interface Order {
-  readonly id: string;
-  readonly symbol: string;
-  readonly side: OrderSide;
-  readonly type: OrderType;
-  readonly status: OrderStatus;
-  readonly price?: number;
-  readonly quantity: number;
-  readonly filledQuantity?: number;
-  /** 本次订单是否为模拟单（回执必须显式回带，防 dry-run 语义丢失）。 */
-  readonly dryRun: boolean;
-  readonly timestamp: number;
-}
-interface AccountBalance {
-  readonly asset: string;
-  readonly free: number;
-  readonly locked: number;
-}
-/** 成交流水单条（GUI 交易台「成交历史」用，issue #40）。 */
-interface TradeFill {
-  /** 交易所成交 id。 */
-  readonly id: string;
-  readonly symbol: string;
-  readonly side: OrderSide;
-  readonly price: number;
-  /** 成交量（base 币数）。 */
-  readonly amount: number;
-  /** 手续费（绝对值，币种由 feeAsset 表达）。 */
-  readonly fee?: number;
-  readonly feeAsset?: string;
-  readonly timestamp: number;
-}
-/** 订阅句柄：dispose 即退订（连接器用 ctx.effect/cordis 生命周期托管）。 */
-interface Disposable {
-  dispose(): void;
-}
-/**
- * 标的形态轴（2026-10-08 加密永续与 TradFi 永续落地）：与 `market` 正交，**不新增市场键**。
- * 缺省 = `spot`——已存自选、localStorage 与 iOS 冻结契约因此零迁移。
- *
- * 形态由规范符号后缀承载（`-SWAP` = 永续），见 docs/guides/symbol-vocabulary.md；
- * `form` 只出现在名册/检索/wire 元数据里，行情方法不新增 form 形参。
- */
-type InstrumentForm = 'spot' | 'perp';
-/**
- * 标的资产类别标签（仅展示与检索排序用，不承载交易语义）。
- * **只信交易所元数据**（OKX `instCategory`、Binance `underlyingType`+`underlyingSubType`）；
- * 取不到时留空，禁止按符号字面猜（`SPX` 在 OKX 是迷因币 SPX6900，标普 500 是 `US500`）。
- */
-type InstrumentAssetClass = 'crypto' | 'equity' | 'commodity' | 'index';
-/** 合约专有元数据（仅 `form=perp` 有值）：交易所元数据原样透传，不本地推断。 */
-interface InstrumentContract {
-  /** 合约乘数（OKX ctVal / Binance contractSize）。 */
-  readonly multiplier?: number;
-  /** 最小价格变动。 */
-  readonly tickSize?: number;
-  /** 最小下单量/张数步长。 */
-  readonly lotSize?: number;
-  /** 交易所允许的最大杠杆。 */
-  readonly maxLeverage?: number;
-  /** 结算币种（如 USDT）。 */
-  readonly settleCcy?: string;
-}
-/**
- * 标的检索结果的最小元数据（名册/搜索/wire 共用）。
- * 元素形状对既有 `{ symbol, name? }` 实现向后兼容：`form`/`assetClass`/`contract` 全可选。
- */
-interface InstrumentRef {
-  /** 市场规范词汇符号（docs/guides/symbol-vocabulary.md）。 */
-  readonly symbol: string;
-  readonly name?: string;
-  /** 缺省 = spot（老数据零迁移）。 */
-  readonly form?: InstrumentForm;
-  readonly assetClass?: InstrumentAssetClass;
-  readonly contract?: InstrumentContract;
-}
-/**
- * 行情服务契约：由市场连接器实现，注册到按市场命名空间的 ctx 键（如 ctx.tradingCrypto）。
- * 符号词汇（2026-08-31 规范，docs/guides/symbol-vocabulary.md）：入参接受市场规范形与连接器原生形，
- * 输出 `symbol` 一律市场规范形——消费方（GUI/Agent/工作流）与数据源方言解耦。
- */
-interface MarketDataService {
-  getTicker(symbol: string): Promise<Ticker>;
-  getKlines(symbol: string, interval: Interval, limit?: number): Promise<Kline[]>;
-  subscribeTicker(symbol: string, cb: (ticker: Ticker) => void): Disposable;
-  /**
-   * 查询本市场/交易所支持的全部标的名册（动态全集，Issue #15）。
-   * 输出 `symbol` 一律市场规范词汇（docs/guides/symbol-vocabulary.md），形态由符号后缀承载
-   * （`-SWAP` = 永续，`instrumentFormOf` 是唯一裁决实现）；每行可带
-   * `form`/`assetClass`/`contract` 元数据（InstrumentRef），缺省 = 现货。
-   * 可选方法：无公开全集端点的数据源（如 tencent/yahoo/stooq）可缺省或由桥/前端回退。
-   */
-  listInstruments?(): Promise<InstrumentRef[]>;
-  /**
-   * 标的基本面与估值快照（GUI「基本面」页签用，2026-09-02）。
-   * 可选方法：仅当数据源在同一公共端点里携带基本面字段时实现
-   * （腾讯行情行 cn/hk 已实现）；未实现的市场由消费方降级为派生数据（日K 52 周高低）。
-   * 输出 `symbol` 一律市场规范词汇（docs/symbol-vocabulary.md）。
-   */
-  getFundamentals?(symbol: string): Promise<StockFundamentals>;
-  /**
-   * 衍生品市场指标快照（GUI「衍生品」面板用，issue #38，2026-09-02）：持仓量/
-   * 多空比/资金费等微观结构数据，crypto 永续合约市场专属。
-   * 可选方法：现货/股票数据源不实现；未实现时消费方直接隐藏面板（不降级不报错）。
-   * 入参接受规范形与连接器原生形，输出 `symbol` 一律规范词汇 SWAP 形（BTCUSDT-SWAP）。
-   */
-  getDerivatives?(symbol: string): Promise<DerivativesData>;
-  /**
-   * 衍生品历史序列（GUI「衍生品」页签趋势卡用，issue #54）：资金费率历史 +
-   * OI 历史，时间升序。可选方法：无公开历史端点的数据源不实现；未实现或失败
-   * 时消费方隐藏趋势图、保留快照读数（与快照同族的降级纪律）。
-   * 入参接受规范形与连接器原生形，输出 symbol 一律规范词汇 SWAP 形。
-   */
-  getDerivativesHistory?(symbol: string): Promise<DerivativesHistory>;
-  /**
-   * 盘口快照（GUI「盘口」竖栏用，issue #39）：档位词汇见 Orderbook。可选方法：
-   * 数据源无盘口能力时不实现（如 stooq/yahoo、腾讯 r_hk 港股行档位全 0）。
-   * 入参接受规范形与连接器原生形，输出 `symbol` 一律市场规范词汇。
-   */
-  getOrderbook?(symbol: string): Promise<Orderbook>;
-  /**
-   * 最近逐笔成交流水（GUI「分笔」用，issue #39）：取最近 limit 笔（缺省 ≤50），
-   * **时间升序（旧→新）**，与 K 线序列同向；方向缺省的数据源 side='unknown'。
-   * 可选方法：无公共逐笔端点的数据源（腾讯沪深行情行）不实现。
-   */
-  getRecentTrades?(symbol: string, limit?: number): Promise<TradeTick[]>;
-}
-/**
- * 杠杆设置请求（合约交易语义，P7；仅 `form=perp` 的标的可传）。
- * dryRun 缺省视为 true：只回本地模拟回执，不触碰交易所（与 placeOrder 同语义）。
- */
-interface SetLeverageRequest {
-  readonly symbol: string;
-  /** 目标杠杆倍数（> 0；上限以交易所规格 `InstrumentContract.maxLeverage` 为准，超出即结构化拒绝）。 */
-  readonly leverage: number;
-  readonly marginMode: MarginMode;
-  /** 双向持仓模式下的方向（OKX `posSide`）；净持仓模式下缺席。 */
-  readonly posSide?: 'long' | 'short';
-  /** 全仓模式下按币种设置杠杆时的保证金币（OKX `ccy`）；逐仓与净持仓模式缺席。 */
-  readonly ccy?: string;
-  /** 缺省/true 时仅模拟。实盘还受 @dshtrading/authority 的人工签署授权与 approval 约束 [S4]。 */
-  readonly dryRun?: boolean;
-}
-/** 杠杆设置回执（dryRun=true 时是本地模拟回执，不触网）。 */
-interface LeverageSetting {
-  readonly symbol: string;
-  readonly leverage: number;
-  readonly marginMode: MarginMode;
-  readonly posSide?: 'long' | 'short';
-  readonly ccy?: string;
-  /** 本次是否为模拟回执（回执必须显式回带，防 dry-run 语义丢失）。 */
-  readonly dryRun: boolean;
-  readonly timestamp: number;
-}
-/**
- * 交易服务契约：placeOrder 默认 dry-run；实盘前必须过 @dshtrading/authority 的人工签署授权与
- * ctx.approval.request（交互形态；headless 下 ask=deny，fail-closed [S4]）。
- *
- * R3（okx 切片 2026-08-29）修订：cancelOrder 增加可选 symbol、新增 getOrder——
- * OKX 按 (instId, ordId) 双键定位订单，单参 id 形态不够；无其他实现方，扩展向后兼容。
- *
- * P7（合约交易 Tier 2，2026-10-08）修订：新增可选 `setLeverage`——杠杆/保证金模式变更
- * 是实盘动作，必须与下单同门槛（服务缝三态闸门 + base 审批闸门 + 人工签署授权）。
- */
-interface TradeService {
-  placeOrder(req: OrderRequest): Promise<Order>;
-  /** 撤单。symbol 可选：按 (symbol, id) 双键定位订单的交易所（如 OKX）必须提供。 */
-  cancelOrder(id: string, symbol?: string): Promise<void>;
-  /** 查询单笔订单状态（按 (symbol, id) 双键）。 */
-  getOrder(symbol: string, id: string): Promise<Order>;
-  getPositions(): Promise<Position[]>;
-  /**
-   * 账户余额快照（issue #40 GUI 交易台；只读，需凭证）。
-   * 可选方法：实现方已有只读余额面时实现（connector-okx 的 crypto_get_balance 同源）。
-   */
-  getBalances?(): Promise<AccountBalance[]>;
-  /**
-   * 当前挂单列表（issue #40 GUI 交易台；只读，需凭证）。
-   * 可选方法：无批量挂单端点的实现方可缺省（GUI 隐藏挂单区）。
-   * 输出 `symbol` 一律市场规范词汇；status 只含 new / partially_filled。
-   */
-  listOpenOrders?(symbol?: string): Promise<Order[]>;
-  /**
-   * 最近成交流水（issue #40 GUI 交易台；只读，需凭证）。
-   * 可选方法：时间升序（旧→新），最多 limit 条（缺省 ≤50）。
-   */
-  listTradeFills?(symbol?: string, limit?: number): Promise<TradeFill[]>;
-  /**
-   * 设置合约杠杆与保证金模式（P7 合约交易 Tier 2；仅支持合约的交易所实现）。
-   * 可选方法：不实现的连接器缺席即可，消费方按 TRADING_NOT_IMPLEMENTED 语义处理。
-   * 这是会改变账户真实风险参数的实盘动作：dryRun 缺省 true（只回本地模拟回执），
-   * dryRun=false 必须同时具备人工签署的实盘授权，并经 base 审批闸门。
-   */
-  setLeverage?(req: SetLeverageRequest): Promise<LeverageSetting>;
-}
-/**
- * Cordis Context 服务键（能力三角色之「声明」）：市场命名空间键由契约包统一声明，
- * 连接器 provide、消费方 inject 时获得完整类型。此处仅类型增强——本包保持
- * 零运行时依赖，不产生任何 JS 输出。
- */
-declare module '@deepseek-ai/cordis' {
-  interface Context {
-    /** crypto 市场行情服务（由 Binance 连接器以公共 REST 提供，无需凭证）。 */
-    tradingCryptoMarketData: MarketDataService;
-    /** us 市场行情服务（由 Stooq 连接器以公共 CSV 端点提供，无需凭证；us 复制 2026-08-31 补齐）。 */
-    tradingUsMarketData: MarketDataService;
-    /** cn 市场行情服务（由腾讯连接器以公共端点提供，无需凭证；cn+hk 切片 2026-08-31 补齐）。 */
-    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 经
-     * Config.enabled 互斥激活同一 tradingCryptoMarketData 键时一并 provide。
-     */
-    tradingCryptoTrade: TradeService;
-    /**
-     * 交易服务注册表（issue #40 GUI 交易台，@dshtrading/api 类型声明）：
-     * 与 tradingMarketDataRegistry 同构的宿主平面注册面——交易连接器 host 面数据行
-     * 注册，GUI 桥按路由当前值惰性解析。**注册不改变安全语义**：placeOrder 的
-     * 服务缝闸门（dryRun 缺省 true + @dshtrading/authority 人工签署授权）随服务实例生效；
-     * GUI 桥只放行 dry-run 下单与只读查询，实盘路径仍走 Agent 工具的 base 审批闸门。
-     */
-    tradingTradeRegistry: TradeRegistry;
-    /**
-     * 市场路由服务（R5 2026-08-29 补齐，@dshtrading/router 提供）：
-     * 连接器 apply 时 consult activeProvider(market) 决定是否激活——用户设置
-     * dshtrading.markets.<market>.provider 选谁谁激活（docs/exchange-routing.md）。
-     */
-    tradingMarketRouter: MarketRouterService;
-    /**
-     * 行情服务注册表（2026-08-30 注册表模式定稿，@dshtrading/router 同插件提供）：
-     * 连接器 host 面数据行注册，GUI 行情桥按路由当前值惰性解析（热切换）。
-     */
-    tradingMarketDataRegistry: MarketDataRegistry;
-    /**
-     * 新闻聚合器注册表（Issue #37，@dshtrading/router 同插件提供）：
-     * 各市场 Kit apply 时注册 aggregateNews 纯函数，GUI 行情桥按市场获取。
-     */
-    tradingNewsRegistry: TradingNewsRegistry;
-    /** 跨市场快讯源（@dshtrading/connector-jin10 提供；缺席 = 未安装快讯连接器）。 */
-    tradingFlashFeed: FlashFeedService;
-    /** 宏观/利率源（@dshtrading/connector-jin10 提供；缺席 = 未安装金十连接器）。 */
-    tradingMacroFeed: MacroFeedService;
-  }
-}
-/**
- * 行情服务注册表契约（router 插件提供，2026-08-30 注册表模式定稿）：
- * 连接器 host 面数据行不再互斥式 provide 市场键，而是全部注册进本注册表；
- * 消费方（GUI 行情桥）经 active() 按路由当前值惰性解析——settings 变更即刻生效
- * （GUI 热切换），无 watch、无进程重启。preset 平面不走注册表：会话内数据源
- * 一致性是有意语义，切交易所对会话 = 新建会话生效（docs/exchange-routing.md §2.2）。
- *
- * 与 tradeProvider 预留的衔接：本注册表只承载 MarketDataService；数据/交易分离
- * 落地时 TradeService 走独立注册面（不复用本键），铁律 #4 到时再抽象。
- */
-interface MarketDataRegistration {
-  /** 市场 slug（crypto/us/cn/hk；开放词汇，新市场 = 新键）。 */
-  readonly market: string;
-  /** 提供者 slug（binance/okx/…；开放词汇，第三方连接器可注册新 slug）。 */
-  readonly provider: string;
-  readonly service: MarketDataService;
-}
-interface MarketDataRegistry {
-  /**
-   * 注册一个市场的某 provider 行情服务；同 (market, provider) 重复注册抛错
-   * （配置错误必须响亮）。返回注销函数（调用方包进 ctx.effect 随 fiber 注销）。
-   */
-  register(market: string, provider: string, service: MarketDataService): () => void;
-  /**
-   * 路由裁决后的当前激活注册项：router 选中的 provider 已注册 → 返回之；
-   * 选中了但未注册（包未装/enabled=false）→ undefined（调用方面向用户报错，
-   * 不静默降级到别家——用户设置是权威）；router 无该市场路由（未知市场键）
-   * 且恰好一个注册项 → 返回之（新市场零配置可用）；否则 undefined。
-   */
-  active(market: string): MarketDataRegistration | undefined;
-  /** 某市场全部注册项（诊断/设置 UI 展示用）。 */
-  list(market: string): readonly MarketDataRegistration[];
-}
-/** 交易服务注册项（tradingTradeRegistry 的条目，issue #40）。 */
-interface TradeRegistration {
-  readonly market: string;
-  readonly provider: string;
-  readonly service: TradeService;
-}
-/**
- * 交易服务注册表（router 插件同款注册模式，issue #40）：交易连接器在 host 面
- * 数据行注册（凭证经 ctx.credentials / 环境变量解析，缺失时只读方法 fail-closed
- * 报 TRADING_CREDENTIALS_MISSING）；注册面本身不做安全裁决——闸门在服务缝
- * （placeOrder 三态）与桥层（GUI 只放行 dry-run）。
- */
-interface TradeRegistry {
-  register(market: string, provider: string, service: TradeService): () => void;
-  active(market: string): TradeRegistration | undefined;
-  list(market: string): readonly TradeRegistration[];
-}
-/**
- * 市场路由服务契约（router 插件提供）：按市场查询当前激活的数据/交易所提供方。
- * 用户设置（dshtrading namespace，settings.yaml）是权威；无设置时 = 组合默认值
- * （现状零变化）。供应商取值与连接器的 provider slug 比对，相符者激活。
- */
-interface MarketRouterService {
-  /** 某市场当前激活的 provider slug（settings resolved：用户层赢，缺省 base 默认）。 */
-  activeProvider(market: string): string | undefined;
-  /** 订阅激活变化（settings commit 驱动）。 */
-  watch(cb: (next: string | undefined, prev: string | undefined) => void): () => void;
-}
-/** 新闻/快讯条目（各市场 Kit 统一输出形状）。 */
-interface NewsItem {
-  /** 来源标识（如 'eastmoney'、'yahoo'、'googlenews'、'binance'、'coindesk' 等）。 */
-  readonly source: string;
-  /** 新闻/快讯标题。 */
-  readonly title: string;
-  /** 详情页 URL。 */
-  readonly url: string;
-  /** ISO 8601 发布时间。 */
-  readonly publishedAt: string;
-  /** 关联标的代码（可选，格式随源不同）。 */
-  readonly relatedCodes?: readonly string[];
-  /** 热度等级（可选；金十快讯网页版 火/热/沸/爆，其他源不填）。 */
-  readonly hot?: string;
-}
-/** 新闻聚合请求选项。 */
-interface AggregateNewsOptions {
-  /** 输出条数上限（1~50，默认 20）。 */
-  limit?: number | undefined;
-  /** 时间窗口（小时，1~168，默认 24）。 */
-  windowHours?: number | undefined;
-  /** 按标的代码过滤（可选）。 */
-  symbol?: string | undefined;
-  /** CryptoPanic API token（仅 crypto 市场使用，可选）。 */
-  cryptoPanicKey?: string | undefined;
-  /**
-   * 启用的新闻/公告源 id 列表（issue #96 源配置化；各 kit 的 NewsSource 词汇）。
-   * 缺省 = 该市场全部默认源；空数组 = 显式关闭（返回空结果）。
-   */
-  sources?: readonly string[] | undefined;
-}
-/** 新闻聚合结果。 */
-interface AggregateNewsResult {
-  /** 按发布时间倒序的新闻条目。 */
-  readonly items: readonly NewsItem[];
-  /** 失败的数据源名称（fail-soft 容错：可用源正常返回，不可用源记录在此）。 */
-  readonly unavailable: readonly string[];
-}
-/** 新闻聚合器函数签名（各 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[]>;
-}
-/**
- * 宏观经济日历条目（金十当周经济数据，2026-09-15）：数值均为上游快照原样字符串，
- * `actual` 缺省 = 未公布。
- */
-interface MacroCalendarEntry {
-  /** ISO 8601 公布时间（东八区解释，同 NewsItem 口径）。 */
-  readonly publishedAt: string;
-  /** 重要度（上游 star，0–5）。 */
-  readonly star: number;
-  /** 地区（标题前缀推断，如 美国/日本/中国；未识别 = 空串）。 */
-  readonly region: string;
-  readonly title: string;
-  readonly previous?: string;
-  readonly consensus?: string;
-  readonly actual?: string;
-  readonly revised?: string;
-  /** 上游公布影响词（利多/利空/影响较小…；原样透传）。 */
-  readonly affect?: string;
-}
-/** 央行最新利率条目（金十网页版，2026-09-15）。 */
-interface MacroRateEntry {
-  /** 地区（flag 名推断，如 美国/日本/中国；未识别 = 空串）。 */
-  readonly region: string;
-  readonly bankName: string;
-  /** 最新利率（上游原样字符串，如 "3.75"/"0"）。 */
-  readonly rate: string;
-  /** 公布日（上游原样 YYYY-MM-DD）。 */
-  readonly publishedAt: string;
-  /** 所属指标名（如「美联储利率决定(上限)」；部分央行缺省）。 */
-  readonly indicatorName?: string;
-}
-/**
- * 宏观/利率源契约（2026-09-15 金十接入）：host 平面由金十连接器 provide
- * tradingMacroFeed，GUI 宏观面板（桥 /dshtrading/api/macro/*）消费；服务缺席 =
- * 未安装/未启用该数据源 → 消费方报 TRADING_NOT_IMPLEMENTED，绝不把「没有数据源」
- * 伪装成「没有数据」。日历走官方 MCP（list_calendar），利率走网页版公开接口
- * （spikes/impl-jin10-macro-rates/EVIDENCE.md）。
- */
-interface MacroFeedService {
-  /** 当周经济日历（周一~周日，北京时间；limit 截尾，缺省全周）。 */
-  listCalendar(limit?: number | undefined): Promise<readonly MacroCalendarEntry[]>;
-  /** 央行最新利率（全量，客户端按地区过滤）。 */
-  listRates(): Promise<readonly MacroRateEntry[]>;
-}
-/** 新闻聚合器注册表契约（Issue #37，router 插件提供）。 */
-interface TradingNewsRegistry {
-  register(market: string, aggregator: NewsAggregator): () => void;
-  get(market: string): NewsAggregator | undefined;
-  markets(): string[];
-}
-//#endregion
-export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, InsiderTradeItem, InstitutionalHoldingItem, InstrumentAssetClass, InstrumentContract, InstrumentForm, InstrumentRef, Interval, Kline, LeverageSetting, LimitUpPoolItem, MacroCalendarEntry, MacroFeedService, MacroRateEntry, MainOperationSegment, MarginMode, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, SetLeverageRequest, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingNewsRegistry };

package/lib/api/lib/instrument-form.d.ts

@@ -1 +0,0 @@
-import "./index.js";