@dshtrading/strategies 0.6.1 → 0.6.3

package/lib/builtin-tombstones-fs.js

@@ -1,49 +1,50 @@
-import { SKIP_WRITE, transactStore } from "@dshtrading/dsh-home";
-import { readFile } from "node:fs/promises";
+import { SKIP_WRITE, createRecordStoreAdapter, readStoreText } from "@dshtrading/dsh-home";
 //#region src/builtin-tombstones-fs.ts
 /**
 * 文件持久化版内置策略/选股器墓碑存储（Node.js 宿主侧使用，
 * 落 ~/.dsh/strategies/builtin-tombstones.json，形状 { deleted: string[] }）。
 *
-* 整表持久化经 `@dshtrading/dsh-home` 的 {@link transactStore}——跨进程排他锁 +
-* 锁内新鲜读盘 + 原子写（2026-10-09 多进程互相覆盖事故修复）：两进程各自删除的
-* 内置策略都留下来，后到者不会用陈旧墓碑集合覆盖。旧宿主从未写过该文件，
-* 无迁移问题（ENOENT 视为空表）。
+* 读写骨架经 `@dshtrading/dsh-home` 的 {@link createRecordStoreAdapter}——跨进程排他锁 +
+* 锁内新鲜读盘 + 原子写 + 落盘成功后才发布缓存（2026-10-09 多进程互相覆盖事故修复）：
+* 两进程各自删除的内置策略都留下来，后到者不会用陈旧墓碑集合覆盖。旧宿主从未写过该
+* 文件，无迁移问题（ENOENT 视为空表）。
 */
 const LOG_PREFIX = "[dsh-trading/strategies] failed to atomic flush builtin tombstones to";
 function createFileBuiltinTombstonesStore(filePath) {
-	let cache = null;
-	/** 新鲜读盘（坏 JSON 降级空表）；供 load 与锁内重读共用。 */
-	async function readFromDisk() {
+	/** 读盘/解析失败的日志前缀（坏 JSON 与非 ENOENT 读失败同一条，与既有 load 口径逐字一致）。 */
+	const READ_FAILED = `[dsh-trading/strategies] failed to read builtin tombstones from ${filePath}:`;
+	/**
+	* 文本 → 墓碑集合：只收容器里的 `deleted` 字符串数组，去空串、去重；坏 JSON 降级空集
+	* 并打日志，坏形（容器不是 `{ deleted: [] }`）静默降级空集。Set 形态是本 store 的差异。
+	*/
+	function decode(text) {
+		if (text === void 0) return /* @__PURE__ */ new Set();
 		try {
-			const content = await readFile(filePath, "utf8");
-			const parsed = JSON.parse(content);
+			const parsed = JSON.parse(text);
 			const set = /* @__PURE__ */ new Set();
 			if (Array.isArray(parsed?.deleted)) {
 				for (const id of parsed.deleted) if (typeof id === "string" && id) set.add(id);
 			}
 			return set;
 		} catch (err) {
-			if (err?.code !== "ENOENT") console.error(`[dsh-trading/strategies] failed to read builtin tombstones from ${filePath}:`, err);
+			console.error(READ_FAILED, err);
 			return /* @__PURE__ */ new Set();
 		}
 	}
-	async function load() {
-		if (cache !== null) return cache;
-		cache = await readFromDisk();
-		return cache;
-	}
-	async function commit(mutate) {
-		cache = await transactStore(filePath, readFromDisk, mutate, (set) => ({ deleted: [...set] }), LOG_PREFIX);
-		return cache;
-	}
+	const store = createRecordStoreAdapter({
+		filePath,
+		logPrefix: LOG_PREFIX,
+		readFromDisk: () => readStoreText(filePath, READ_FAILED),
+		decode,
+		encode: (set) => ({ deleted: [...set] })
+	});
 	return {
 		async list() {
-			return [...await load()];
+			return [...await store.load()];
 		},
 		async add(id) {
 			let fresh = false;
-			await commit((onDisk) => {
+			await store.commit((onDisk) => {
 				fresh = !onDisk.has(id);
 				if (fresh) onDisk.add(id);
 				return fresh ? onDisk : SKIP_WRITE;
@@ -52,7 +53,7 @@ function createFileBuiltinTombstonesStore(filePath) {
 		},
 		async remove(id) {
 			let existed = false;
-			await commit((onDisk) => {
+			await store.commit((onDisk) => {
 				existed = onDisk.delete(id);
 				return existed ? onDisk : SKIP_WRITE;
 			});

package/lib/custom-fs.js

@@ -1,51 +1,51 @@
 import { dirname } from "node:path";
-import { SKIP_WRITE, transactStore } from "@dshtrading/dsh-home";
-import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { SKIP_WRITE, createRecordStoreAdapter, readStoreText } from "@dshtrading/dsh-home";
+import { appendFile, mkdir } from "node:fs/promises";
 //#region src/custom-fs.ts
 /**
 * 文件持久化版自定义策略存储（Node.js 宿主侧使用，落 ~/.dsh/strategies/custom.json）。
 *
-* 整表持久化经 `@dshtrading/dsh-home` 的 {@link transactStore}——跨进程排他锁 +
-* 锁内新鲜读盘 + 原子写（2026-10-09 多进程互相覆盖事故修复；issue #31 落盘形状不变）。
+* 读写骨架经 `@dshtrading/dsh-home` 的 {@link createRecordStoreAdapter}——跨进程排他锁 +
+* 锁内新鲜读盘 + 原子写 + 落盘成功后才发布缓存（2026-10-09 多进程互相覆盖事故修复；
+* issue #31 落盘形状不变）。
 * remove(archive=true) 会先把被删记录归档到 sidecar 文件（<path>.archive.jsonl，
 * JSONL 追加）——策略管理（覆盖 + 墓碑）丢弃用户 override 时可找回（2026-09-07）。
 */
 const LOG_PREFIX = "[dsh-trading/strategies] failed to atomic flush custom strategies to";
 function createFileCustomStrategyStore(filePath) {
-	let cache = null;
-	/** 新鲜读盘（坏 JSON/坏形同既有 load 口径降级空表）；供 load 与锁内重读共用。 */
-	async function readFromDisk() {
+	/** 读盘/解析失败的日志前缀（坏 JSON 与非 ENOENT 读失败同一条，与既有 load 口径逐字一致）。 */
+	const READ_FAILED = `[dsh-trading/strategies] failed to read custom strategies from ${filePath}:`;
+	/** 文本 → 表：坏 JSON 降级空表并打日志，坏形状（非数组 / 缺 id）静默丢弃（不外包）。 */
+	function decode(text) {
+		if (text === void 0) return /* @__PURE__ */ new Map();
 		try {
-			const content = await readFile(filePath, "utf8");
-			const parsed = JSON.parse(content);
+			const parsed = JSON.parse(text);
 			const map = /* @__PURE__ */ new Map();
 			if (Array.isArray(parsed)) {
 				for (const item of parsed) if (item && typeof item.id === "string") map.set(item.id, item);
 			}
 			return map;
 		} catch (err) {
-			if (err?.code !== "ENOENT") console.error(`[dsh-trading/strategies] failed to read custom strategies from ${filePath}:`, err);
+			console.error(READ_FAILED, err);
 			return /* @__PURE__ */ new Map();
 		}
 	}
-	async function load() {
-		if (cache !== null) return cache;
-		cache = await readFromDisk();
-		return cache;
-	}
-	async function commit(mutate) {
-		cache = await transactStore(filePath, readFromDisk, mutate, (table) => [...table.values()], LOG_PREFIX);
-		return cache;
-	}
+	const store = createRecordStoreAdapter({
+		filePath,
+		logPrefix: LOG_PREFIX,
+		readFromDisk: () => readStoreText(filePath, READ_FAILED),
+		decode,
+		encode: (table) => [...table.values()]
+	});
 	return {
 		async list() {
-			return [...(await load()).values()];
+			return [...(await store.load()).values()];
 		},
 		async get(id) {
-			return (await load()).get(id);
+			return (await store.load()).get(id);
 		},
 		async save(record) {
-			await commit((onDisk) => {
+			await store.commit((onDisk) => {
 				onDisk.set(record.id, { ...record });
 				return onDisk;
 			});
@@ -53,7 +53,7 @@ function createFileCustomStrategyStore(filePath) {
 		async remove(id, archive = false) {
 			let existed = false;
 			let removedRecord;
-			await commit((onDisk) => {
+			await store.commit((onDisk) => {
 				removedRecord = onDisk.get(id);
 				existed = onDisk.delete(id);
 				return existed ? onDisk : SKIP_WRITE;

package/lib/custom-screener-fs.js

@@ -1,52 +1,51 @@
 import { dirname } from "node:path";
-import { SKIP_WRITE, transactStore } from "@dshtrading/dsh-home";
-import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { SKIP_WRITE, createRecordStoreAdapter, readStoreText } from "@dshtrading/dsh-home";
+import { appendFile, mkdir } from "node:fs/promises";
 //#region src/custom-screener-fs.ts
 /**
 * 文件持久化版自定义选股器存储（Node.js 宿主侧使用，
 * 落 ~/.dsh/strategies/custom-screeners.json）。
 *
-* 整表持久化经 `@dshtrading/dsh-home` 的 {@link transactStore}——跨进程排他锁 +
-* 锁内新鲜读盘 + 原子写（2026-10-09 多进程互相覆盖事故修复）。
+* 读写骨架经 `@dshtrading/dsh-home` 的 {@link createRecordStoreAdapter}——跨进程排他锁 +
+* 锁内新鲜读盘 + 原子写 + 落盘成功后才发布缓存（2026-10-09 多进程互相覆盖事故修复）。
 * remove(archive=true) 先把被删记录归档到 sidecar（<path>.archive.jsonl，JSONL
 * 追加）——选股器管理丢弃用户 override 时可找回（2026-09-07 审查补强）。
 */
 const LOG_PREFIX = "[dsh-trading/strategies] failed to atomic flush custom screeners to";
 function createFileCustomScreenerStore(filePath) {
-	let cache = null;
-	/** 新鲜读盘（坏 JSON/坏形同既有 load 口径降级空表）；供 load 与锁内重读共用。 */
-	async function readFromDisk() {
+	/** 读盘/解析失败的日志前缀（坏 JSON 与非 ENOENT 读失败同一条，与既有 load 口径逐字一致）。 */
+	const READ_FAILED = `[dsh-trading/strategies] failed to read custom screeners from ${filePath}:`;
+	/** 文本 → 表：坏 JSON 降级空表并打日志，坏形状（非数组 / 缺 id）静默丢弃（不外包）。 */
+	function decode(text) {
+		if (text === void 0) return /* @__PURE__ */ new Map();
 		try {
-			const content = await readFile(filePath, "utf8");
-			const parsed = JSON.parse(content);
+			const parsed = JSON.parse(text);
 			const map = /* @__PURE__ */ new Map();
 			if (Array.isArray(parsed)) {
 				for (const item of parsed) if (item && typeof item.id === "string") map.set(item.id, item);
 			}
 			return map;
 		} catch (err) {
-			if (err?.code !== "ENOENT") console.error(`[dsh-trading/strategies] failed to read custom screeners from ${filePath}:`, err);
+			console.error(READ_FAILED, err);
 			return /* @__PURE__ */ new Map();
 		}
 	}
-	async function load() {
-		if (cache !== null) return cache;
-		cache = await readFromDisk();
-		return cache;
-	}
-	async function commit(mutate) {
-		cache = await transactStore(filePath, readFromDisk, mutate, (table) => [...table.values()], LOG_PREFIX);
-		return cache;
-	}
+	const store = createRecordStoreAdapter({
+		filePath,
+		logPrefix: LOG_PREFIX,
+		readFromDisk: () => readStoreText(filePath, READ_FAILED),
+		decode,
+		encode: (table) => [...table.values()]
+	});
 	return {
 		async list() {
-			return [...(await load()).values()];
+			return [...(await store.load()).values()];
 		},
 		async get(id) {
-			return (await load()).get(id);
+			return (await store.load()).get(id);
 		},
 		async save(record) {
-			await commit((onDisk) => {
+			await store.commit((onDisk) => {
 				onDisk.set(record.id, { ...record });
 				return onDisk;
 			});
@@ -54,7 +53,7 @@ function createFileCustomScreenerStore(filePath) {
 		async remove(id, archive = false) {
 			let existed = false;
 			let removedRecord;
-			await commit((onDisk) => {
+			await store.commit((onDisk) => {
 				removedRecord = onDisk.get(id);
 				existed = onDisk.delete(id);
 				return existed ? onDisk : SKIP_WRITE;

package/lib/plugin.d.ts

@@ -4,12 +4,12 @@ import { ScreenerColumnSpec, ScreenerDefinition } from "./screeners/types.js";
 import { CustomScreenerRecord, CustomScreenerStore } from "./custom-screener.js";
 import { isBuiltinScreenerId, isBuiltinStrategyId } from "./management.js";
 import { BuiltinTombstonesStore } from "./builtin-tombstones.js";
-import { MarketDataService } from "./api/lib/index.js";
 import { createFileCustomStrategyStore } from "./custom-fs.js";
 import { createFileBuiltinTombstonesStore } from "./builtin-tombstones-fs.js";
 import { createFileCustomScreenerStore } from "./custom-screener-fs.js";
 import { validateCustomScreenerNode, validateCustomStrategyNode } from "./validate-node.js";
 import { Context, Service } from "@deepseek-ai/cordis";
+import { MarketDataService } from "@dshtrading/api";
 //#region src/plugin.d.ts
 /** Cordis 插件名 = patch 行 id（TEMPLATES §8），市场无关共享行命名空间。 */
 declare const name = "dsh-trading-strategies";

package/lib/plugin.js

@@ -172,22 +172,9 @@ function createStrategyListTool(options) {
 		}
 	});
 }
-/** 选股器记录 → 名册条目（paramsJson/columnsJson 解析在读取边界，坏数据降级为空数组）。 */
+/** 选股器记录 → 名册条目（paramsJson/columnsJson 解析复用 parseScreenerSpecs，坏数据降级为空数组）。 */
 function screenerRecordEntry(record) {
-	let params = [];
-	let columns = [];
-	try {
-		const parsed = JSON.parse(record.paramsJson);
-		if (Array.isArray(parsed)) params = parsed;
-	} catch {
-		params = [];
-	}
-	try {
-		const parsed = JSON.parse(record.columnsJson);
-		if (Array.isArray(parsed)) columns = parsed;
-	} catch {
-		columns = [];
-	}
+	const { params, columns } = parseScreenerSpecs(record);
 	return {
 		id: record.id,
 		title: record.title,
@@ -349,28 +336,7 @@ function createStrategyBacktestTool(deps) {
 			if (service === void 0) throw new Error(`strategy_backtest: no market data service for market "${market}" — install/activate a market connector first`);
 			const bars = await service.getKlines(symbol, interval, limit);
 			if (!Array.isArray(bars) || bars.length === 0) throw new Error(`strategy_backtest: no klines returned for ${symbol} (${market}, ${interval}) — check the symbol/interval vocabulary`);
-			const requested = {};
-			const paramsOverride = {};
-			const paramsJson = typeof args.paramsJson === "string" && args.paramsJson.trim() ? args.paramsJson.trim() : void 0;
-			if (paramsJson !== void 0) {
-				let parsed;
-				try {
-					parsed = JSON.parse(paramsJson);
-				} catch {
-					throw new Error("strategy_backtest: paramsJson must be a JSON object string like {\"fast\":10,\"slow\":30}");
-				}
-				if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("strategy_backtest: paramsJson must be a JSON object string like {\"fast\":10,\"slow\":30}");
-				const specs = new Map(definition.params.map((spec) => [spec.key, spec]));
-				for (const [key, value] of Object.entries(parsed)) {
-					const spec = specs.get(key);
-					if (spec === void 0) throw new Error(`strategy_backtest: unknown param ${JSON.stringify(key)} for strategy "${definition.id}" — valid keys: ` + (definition.params.length > 0 ? definition.params.map((item) => item.key).join(", ") : "(this strategy declares no params)"));
-					if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`strategy_backtest: param ${JSON.stringify(key)} must be a finite number (got ${JSON.stringify(value)})`);
-					requested[key] = value;
-					paramsOverride[key] = Math.min(spec.max, Math.max(spec.min, value));
-				}
-			}
-			const effectiveParams = {};
-			for (const spec of definition.params) effectiveParams[spec.key] = paramsOverride[spec.key] ?? spec.default;
+			const { requested, effective: effectiveParams, override: paramsOverride } = parseParamsOverride(typeof args.paramsJson === "string" && args.paramsJson.trim() ? args.paramsJson.trim() : void 0, definition.params, "strategy_backtest", definition.id);
 			const result = run(bars, definition, paramsOverride);
 			return JSON.stringify({
 				ok: true,
@@ -797,7 +763,7 @@ async function withTimeout(promise, ms, label) {
 		if (timer !== void 0) clearTimeout(timer);
 	}
 }
-/** 解析 paramsJson（与 strategy_backtest 同口径：声明键校验 + clamp）。 */
+/** 解析 paramsJson（strategy_backtest / screener_run 共用：声明键校验 + clamp + 默认值补齐）。 */
 function parseParamsOverride(paramsJson, specs, tool, ownerId) {
 	const requested = {};
 	const override = {};
@@ -822,7 +788,8 @@ function parseParamsOverride(paramsJson, specs, tool, ownerId) {
 	for (const spec of specs) effective[spec.key] = override[spec.key] ?? spec.default;
 	return {
 		requested,
-		effective
+		effective,
+		override
 	};
 }
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/strategies",
   "description": "Trading strategies kernel for dsh-trading: pure math backtesting engine, strategy contracts, and 6 reference paradigms (short, swing, long). Pure library (zero runtime dependencies, browser-packable).",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,18 +21,19 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/dsh-home": "^0.6.1",
-    "@dshtrading/indicators": "0.6.1"
+    "@dshtrading/dsh-home": "^0.6.3",
+    "@dshtrading/indicators": "0.6.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2"
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2"
   },
   "devDependencies": {
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0",
     "typescript": "^5.5.0",
-    "@dshtrading/api": "0.6.1"
+    "@dshtrading/api": "0.6.3",
+    "@dshtrading/test-support": "0.6.3"
   },
   "scripts": {
     "build": "tsdown",

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

@@ -1,636 +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[];
-}
-/** 股票市场标的基本面与财务估值快照（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;
-}
-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, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, FlashFeedService, InstrumentAssetClass, InstrumentContract, InstrumentForm, InstrumentRef, Interval, Kline, LeverageSetting, MacroCalendarEntry, MacroFeedService, MacroRateEntry, MarginMode, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, SetLeverageRequest, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingNewsRegistry };

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

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