@dshtrading/strategies 0.1.5 → 0.2.0

package/lib/paradigms/donchian-breakout.js

@@ -22,6 +22,12 @@ const donchianBreakoutStrategy = {
 	compute(bars, params) {
 		const n1 = Math.max(2, Math.round(params.lookbackEntry ?? 20));
 		const n2 = Math.max(1, Math.round(params.lookbackExit ?? 10));
+		const fmtPrice = (value) => {
+			if (!Number.isFinite(value)) return "—";
+			const abs = Math.abs(value);
+			if (abs < 1) return value.toFixed(abs >= .01 ? 4 : 6);
+			return value.toFixed(Math.abs(Number(value.toFixed(2)) - value) < 1e-9 ? 2 : 3);
+		};
 		const signals = [];
 		let inPosition = false;
 		for (let i = Math.max(n1, n2); i < bars.length; i++) {
@@ -37,12 +43,12 @@ const donchianBreakoutStrategy = {
 					action: "entry",
 					direction: "long",
 					price: currentClose,
-					reason: `收盘价 (${currentClose.toFixed(2)}) 突破前 ${n1} 根最高价 (${highestHigh.toFixed(2)})`,
+					reason: `收盘价 (${fmtPrice(currentClose)}) 突破前 ${n1} 根最高价 (${fmtPrice(highestHigh)})`,
 					reasonKey: "strat.donchian-breakout.reason.entry",
 					reasonParams: {
-						close: currentClose.toFixed(2),
+						close: fmtPrice(currentClose),
 						n: n1,
-						high: highestHigh.toFixed(2)
+						high: fmtPrice(highestHigh)
 					}
 				});
 				inPosition = true;
@@ -53,12 +59,12 @@ const donchianBreakoutStrategy = {
 					action: "exit",
 					direction: "flat",
 					price: currentClose,
-					reason: `收盘价 (${currentClose.toFixed(2)}) 跌破前 ${n2} 根最低价 (${lowestLow.toFixed(2)})`,
+					reason: `收盘价 (${fmtPrice(currentClose)}) 跌破前 ${n2} 根最低价 (${fmtPrice(lowestLow)})`,
 					reasonKey: "strat.donchian-breakout.reason.exit",
 					reasonParams: {
-						close: currentClose.toFixed(2),
+						close: fmtPrice(currentClose),
 						n: n2,
-						low: lowestLow.toFixed(2)
+						low: fmtPrice(lowestLow)
 					}
 				});
 				inPosition = false;

package/lib/paradigms/ema-crossover.js

@@ -1,11 +1,4 @@
-import { ema } from "@dshtrading/indicators";
 //#region src/paradigms/ema-crossover.ts
-/**
-* 双均线趋势跟踪策略（波段）。
-*
-* 入场：EMA(fast) 上穿 EMA(slow) 金叉做多。
-* 出场：EMA(fast) 下穿 EMA(slow) 死叉离场。
-*/
 const emaCrossoverStrategy = {
 	id: "ema-crossover",
 	horizon: "swing",
@@ -29,9 +22,29 @@ const emaCrossoverStrategy = {
 	compute(bars, params) {
 		const fastP = Math.max(2, Math.round(params.fastPeriod ?? 20));
 		const slowP = Math.max(fastP + 1, Math.round(params.slowPeriod ?? 60));
+		const fmtPrice = (value) => {
+			if (!Number.isFinite(value)) return "—";
+			const abs = Math.abs(value);
+			if (abs < 1) return value.toFixed(abs >= .01 ? 4 : 6);
+			return value.toFixed(Math.abs(Number(value.toFixed(2)) - value) < 1e-9 ? 2 : 3);
+		};
+		const emaOf = (values, period) => {
+			const out = new Array(values.length).fill(void 0);
+			if (!Number.isFinite(period) || period < 1 || values.length < period) return out;
+			const k = 2 / (period + 1);
+			let seed = 0;
+			for (let index = 0; index < period; index++) seed += values[index];
+			let prev = seed / period;
+			out[period - 1] = prev;
+			for (let index = period; index < values.length; index++) {
+				prev = values[index] * k + prev * (1 - k);
+				out[index] = prev;
+			}
+			return out;
+		};
 		const closes = bars.map((b) => b.close);
-		const fastEma = ema(closes, fastP);
-		const slowEma = ema(closes, slowP);
+		const fastEma = emaOf(closes, fastP);
+		const slowEma = emaOf(closes, slowP);
 		const signals = [];
 		let inPosition = false;
 		for (let i = 1; i < bars.length; i++) {
@@ -47,13 +60,13 @@ const emaCrossoverStrategy = {
 					action: "entry",
 					direction: "long",
 					price: bars[i].close,
-					reason: `EMA(${fastP}) (${currFast.toFixed(2)}) 上穿 EMA(${slowP}) (${currSlow.toFixed(2)}) 形成金叉`,
+					reason: `EMA(${fastP}) (${fmtPrice(currFast)}) 上穿 EMA(${slowP}) (${fmtPrice(currSlow)}) 形成金叉`,
 					reasonKey: "strat.ema-crossover.reason.entry",
 					reasonParams: {
 						fastP,
-						fast: currFast.toFixed(2),
+						fast: fmtPrice(currFast),
 						slowP,
-						slow: currSlow.toFixed(2)
+						slow: fmtPrice(currSlow)
 					}
 				});
 				inPosition = true;
@@ -64,13 +77,13 @@ const emaCrossoverStrategy = {
 					action: "exit",
 					direction: "flat",
 					price: bars[i].close,
-					reason: `EMA(${fastP}) (${currFast.toFixed(2)}) 下穿 EMA(${slowP}) (${currSlow.toFixed(2)}) 形成死叉`,
+					reason: `EMA(${fastP}) (${fmtPrice(currFast)}) 下穿 EMA(${slowP}) (${fmtPrice(currSlow)}) 形成死叉`,
 					reasonKey: "strat.ema-crossover.reason.exit",
 					reasonParams: {
 						fastP,
-						fast: currFast.toFixed(2),
+						fast: fmtPrice(currFast),
 						slowP,
-						slow: currSlow.toFixed(2)
+						slow: fmtPrice(currSlow)
 					}
 				});
 				inPosition = false;

package/lib/paradigms/momentum-12m.js

@@ -1,11 +1,4 @@
-import { sma } from "@dshtrading/indicators";
 //#region src/paradigms/momentum-12m.ts
-/**
-* 12 个月动量择时策略（长线，Fama-French 动量单标的经典化）。
-*
-* 入场：近 12 个月（约 250 根日 K）累计收益 > 0 且价格高于年线，强动量做多。
-* 出场：动量转负或价格跌破年线，动量衰竭离场。
-*/
 const momentum12mStrategy = {
 	id: "momentum-12m",
 	horizon: "long",
@@ -21,8 +14,24 @@ const momentum12mStrategy = {
 	}],
 	compute(bars, params) {
 		const lookback = Math.max(10, Math.round(params.lookbackBars ?? 250));
-		const closes = bars.map((b) => b.close);
-		const smaValues = sma(closes, lookback);
+		const fmtPrice = (value) => {
+			if (!Number.isFinite(value)) return "—";
+			const abs = Math.abs(value);
+			if (abs < 1) return value.toFixed(abs >= .01 ? 4 : 6);
+			return value.toFixed(Math.abs(Number(value.toFixed(2)) - value) < 1e-9 ? 2 : 3);
+		};
+		const smaOf = (values, period) => {
+			const out = new Array(values.length).fill(void 0);
+			if (!Number.isFinite(period) || period < 1 || values.length < period) return out;
+			let sum = 0;
+			for (let index = 0; index < values.length; index++) {
+				sum += values[index];
+				if (index >= period) sum -= values[index - period];
+				if (index >= period - 1) out[index] = sum / period;
+			}
+			return out;
+		};
+		const smaValues = smaOf(bars.map((b) => b.close), lookback);
 		const signals = [];
 		let inPosition = false;
 		for (let i = lookback; i < bars.length; i++) {
@@ -38,12 +47,12 @@ const momentum12mStrategy = {
 					action: "entry",
 					direction: "long",
 					price: currentClose,
-					reason: `近 ${lookback} 周期动量为正 (+${(momentumReturn * 100).toFixed(1)}%) 且位于均线 (${currentSma.toFixed(2)}) 之上，确认强动量`,
+					reason: `近 ${lookback} 周期动量为正 (+${(momentumReturn * 100).toFixed(1)}%) 且位于均线 (${fmtPrice(currentSma)}) 之上，确认强动量`,
 					reasonKey: "strat.momentum-12m.reason.entry",
 					reasonParams: {
 						n: lookback,
 						pct: (momentumReturn * 100).toFixed(1),
-						sma: currentSma.toFixed(2)
+						sma: fmtPrice(currentSma)
 					}
 				});
 				inPosition = true;
@@ -55,12 +64,12 @@ const momentum12mStrategy = {
 					action: "exit",
 					direction: "flat",
 					price: currentClose,
-					reason: `${exitCause} (${(momentumReturn * 100).toFixed(1)}% / SMA ${currentSma.toFixed(2)})，动量衰减平仓`,
+					reason: `${exitCause} (${(momentumReturn * 100).toFixed(1)}% / SMA ${fmtPrice(currentSma)})，动量衰减平仓`,
 					reasonKey: "strat.momentum-12m.reason.exit",
 					reasonParams: {
 						cause: momentumReturn <= 0 ? "momentumNegative" : "belowBaseline",
 						pct: (momentumReturn * 100).toFixed(1),
-						sma: currentSma.toFixed(2)
+						sma: fmtPrice(currentSma)
 					}
 				});
 				inPosition = false;

package/lib/paradigms/rsi-reversion.js

@@ -1,11 +1,4 @@
-import { rsi } from "@dshtrading/indicators";
 //#region src/paradigms/rsi-reversion.ts
-/**
-* 短周期 RSI 极值均值回归策略（短线，Connors 式）。
-*
-* 入场：RSI(2) < 10 极端超卖入场。
-* 出场：RSI(2) > 60 快速反弹获利了结。
-*/
 const rsiReversionStrategy = {
 	id: "rsi-reversion",
 	horizon: "short",
@@ -41,8 +34,28 @@ const rsiReversionStrategy = {
 		const period = Math.max(2, Math.round(params.rsiPeriod ?? 2));
 		const enterThresh = Number(params.entryThreshold ?? 10);
 		const exitThresh = Number(params.exitThreshold ?? 60);
-		const closes = bars.map((b) => b.close);
-		const rsiValues = rsi(closes, period);
+		const rsiOf = (values, period) => {
+			const out = new Array(values.length).fill(void 0);
+			if (!Number.isFinite(period) || period < 1 || values.length < period) return out;
+			let gain = 0;
+			let loss = 0;
+			for (let index = 1; index <= period; index++) {
+				const delta = values[index] - values[index - 1];
+				if (delta >= 0) gain += delta;
+				else loss -= delta;
+			}
+			gain /= period;
+			loss /= period;
+			out[period] = loss === 0 ? 100 : 100 - 100 / (1 + gain / loss);
+			for (let index = period + 1; index < values.length; index++) {
+				const delta = values[index] - values[index - 1];
+				gain = (gain * (period - 1) + Math.max(delta, 0)) / period;
+				loss = (loss * (period - 1) + Math.max(-delta, 0)) / period;
+				out[index] = loss === 0 ? 100 : 100 - 100 / (1 + gain / loss);
+			}
+			return out;
+		};
+		const rsiValues = rsiOf(bars.map((b) => b.close), period);
 		const signals = [];
 		let inPosition = false;
 		for (let i = 0; i < bars.length; i++) {

package/lib/paradigms/sma-baseline.js

@@ -1,11 +1,4 @@
-import { sma } from "@dshtrading/indicators";
 //#region src/paradigms/sma-baseline.ts
-/**
-* 200 日均线择时基线策略（长线，Meb Faber GTAA 经典）。
-*
-* 入场：收盘价站上 SMA200 牛市生命线，全仓持有。
-* 出场：收盘价跌破 SMA200 熊市防线，空仓避险。
-*/
 const smaBaselineStrategy = {
 	id: "sma-baseline",
 	horizon: "long",
@@ -21,8 +14,24 @@ const smaBaselineStrategy = {
 	}],
 	compute(bars, params) {
 		const period = Math.max(10, Math.round(params.period ?? 200));
-		const closes = bars.map((b) => b.close);
-		const smaValues = sma(closes, period);
+		const fmtPrice = (value) => {
+			if (!Number.isFinite(value)) return "—";
+			const abs = Math.abs(value);
+			if (abs < 1) return value.toFixed(abs >= .01 ? 4 : 6);
+			return value.toFixed(Math.abs(Number(value.toFixed(2)) - value) < 1e-9 ? 2 : 3);
+		};
+		const smaOf = (values, period) => {
+			const out = new Array(values.length).fill(void 0);
+			if (!Number.isFinite(period) || period < 1 || values.length < period) return out;
+			let sum = 0;
+			for (let index = 0; index < values.length; index++) {
+				sum += values[index];
+				if (index >= period) sum -= values[index - period];
+				if (index >= period - 1) out[index] = sum / period;
+			}
+			return out;
+		};
+		const smaValues = smaOf(bars.map((b) => b.close), period);
 		const signals = [];
 		let inPosition = false;
 		for (let i = period - 1; i < bars.length; i++) {
@@ -36,12 +45,12 @@ const smaBaselineStrategy = {
 					action: "entry",
 					direction: "long",
 					price: currentClose,
-					reason: `收盘价 (${currentClose.toFixed(2)}) 站上长期基线 SMA(${period}) (${currentSma.toFixed(2)})，确立多头趋势`,
+					reason: `收盘价 (${fmtPrice(currentClose)}) 站上长期基线 SMA(${period}) (${fmtPrice(currentSma)})，确立多头趋势`,
 					reasonKey: "strat.sma-baseline.reason.entry",
 					reasonParams: {
-						close: currentClose.toFixed(2),
+						close: fmtPrice(currentClose),
 						period,
-						sma: currentSma.toFixed(2)
+						sma: fmtPrice(currentSma)
 					}
 				});
 				inPosition = true;
@@ -52,12 +61,12 @@ const smaBaselineStrategy = {
 					action: "exit",
 					direction: "flat",
 					price: currentClose,
-					reason: `收盘价 (${currentClose.toFixed(2)}) 跌破长期基线 SMA(${period}) (${currentSma.toFixed(2)})，转入防御避险`,
+					reason: `收盘价 (${fmtPrice(currentClose)}) 跌破长期基线 SMA(${period}) (${fmtPrice(currentSma)})，转入防御避险`,
 					reasonKey: "strat.sma-baseline.reason.exit",
 					reasonParams: {
-						close: currentClose.toFixed(2),
+						close: fmtPrice(currentClose),
 						period,
-						sma: currentSma.toFixed(2)
+						sma: fmtPrice(currentSma)
 					}
 				});
 				inPosition = false;

package/lib/plugin.d.ts

@@ -1,15 +1,28 @@
-import { StrategyDefinition } from "./types.js";
+import { StrategyDefinition, StrategyParamSpec } from "./types.js";
 import { CustomStrategyRecord, CustomStrategyStore } from "./custom.js";
+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 { Context } from "@deepseek-ai/cordis";
+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";
 //#region src/plugin.d.ts
 /** Cordis 插件名 = patch 行 id（TEMPLATES §8），市场无关共享行命名空间。 */
 declare const name = "dsh-trading-strategies";
 /** 本插件不硬依赖任何服务（headless 宿主零要求）；tools/注册表经 ctx.inject 声明。 */
 declare const inject: string[];
-/** 默认存储路径：~/.dsh/strategies/custom.json。 */
+/** 默认存储路径：$DSH_HOME/strategies/custom.json（缺省 ~/.dsh）。 */
 declare function defaultStorePath(): string;
+/** 默认墓碑路径：$DSH_HOME/strategies/builtin-tombstones.json（策略管理）。 */
+declare function defaultTombstonesStorePath(): string;
+/** 默认自定义选股器路径：$DSH_HOME/strategies/custom-screeners.json（选股器管理）。 */
+declare function defaultScreenerStorePath(): string;
+/** SDK 服务键：自定义策略 store 单实例（桥与工具共享同一缓存）。 */
+declare const TRADING_STRATEGIES_KEY = "tradingStrategies";
 /** tradingEvents 的最小发布面（鸭式，不定死接口；总线缺席时静默降级）。 */
 interface TradingEventsPublisher {
   emit(store: 'strategies'): void;
@@ -21,24 +34,167 @@ interface StrategyMarketDataResolver {
 declare function createMarketDataResolver(ctx: Context): StrategyMarketDataResolver;
 interface StrategyAuthorToolOptions {
   store: CustomStrategyStore;
+  /** 可选：墓碑表（覆盖内置 id 时顺带恢复删除标记，策略管理语义）。 */
+  tombstones?: BuiltinTombstonesStore;
   /** 可选：策略成功落盘后的回调（issue #30：事件总线 emit('strategies') 接线点）。 */
   onWritten?: (record: CustomStrategyRecord) => void;
 }
 /** strategy_author 工厂（独立导出便于单测）。 */
 declare function createStrategyAuthorTool(options: StrategyAuthorToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+interface StrategyListToolOptions {
+  store: CustomStrategyStore;
+  /** 可选：墓碑表（内置删除状态回显）。 */
+  tombstones?: BuiltinTombstonesStore;
+}
+/**
+ * strategy_list 工厂（issue #86 / G3）：名册 + 覆盖 + 墓碑三态一次读全。
+ * 此前 strategy_delete / strategy_backtest 都要 id 而 agent 拿不到 id，
+ * 只能让用户口述或去读 ~/.dsh-trading/strategies/custom.json。
+ */
+declare function createStrategyListTool(options: StrategyListToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+interface ScreenerListToolOptions {
+  store: CustomScreenerStore;
+  /** 可选：墓碑表（内置选股器删除状态回显）。 */
+  tombstones?: BuiltinTombstonesStore;
+}
+/** screener_list 工厂（issue #86 / G3）：选股器名册三态一次读全。 */
+declare function createScreenerListTool(options: ScreenerListToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
 interface StrategyBacktestToolOptions {
   store: CustomStrategyStore;
+  /** 可选：墓碑表（内置删除后回测拒绝并引导恢复，策略管理语义）。 */
+  tombstones?: BuiltinTombstonesStore;
   marketData: StrategyMarketDataResolver;
 }
-/** 自定义或范式策略 → 回测用 StrategyDefinition（自定义 compute 经编译落定）。 */
-declare function resolveStrategyDefinition(store: CustomStrategyStore, strategyId: string): Promise<StrategyDefinition | undefined>;
+/**
+ * 自定义或范式策略 → 回测用 StrategyDefinition（自定义 compute 经编译落定）。
+ * 覆盖 + 墓碑合成：store 同 id 记录优先（含内置覆盖）；墓碑命中的 id 一律
+ * 视为不存在（含误留覆盖记录的边界——删除语义优先）。
+ */
+declare function resolveStrategyDefinition(store: CustomStrategyStore, strategyId: string, options?: {
+  tombstones?: BuiltinTombstonesStore | undefined;
+}): Promise<StrategyDefinition | undefined>;
 interface StrategyBacktestToolDeps {
   store: CustomStrategyStore;
+  tombstones?: BuiltinTombstonesStore;
   marketData: StrategyMarketDataResolver;
 }
 /** strategy_backtest 工厂（独立导出便于单测）。 */
 declare function createStrategyBacktestTool(deps: StrategyBacktestToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition;
-/** Host plugin body：注册 strategy_author / strategy_backtest（host 平面，全会话可见）。 */
+interface StrategyDeleteToolOptions {
+  store: CustomStrategyStore;
+  tombstones?: BuiltinTombstonesStore;
+  /** 可选：删除成功后的回调（emit('strategies') 接线点；幂等未命中也通知，GUI 对账无害）。 */
+  onDeleted?: (id: string, scope: 'custom' | 'builtin', removed: boolean) => void;
+}
+/**
+ * strategy_delete 工厂（策略管理）：自定义策略 = 移除记录；内置范式 = 落墓碑
+ * （出厂代码不动，strategy_reset 可恢复）。覆盖 + 墓碑模型见 management.ts。
+ */
+declare function createStrategyDeleteTool(options: StrategyDeleteToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+interface StrategyResetToolOptions {
+  store: CustomStrategyStore;
+  tombstones?: BuiltinTombstonesStore;
+  /** 可选：恢复成功后的回调（emit('strategies') 接线点）。 */
+  onReset?: (id: string, changed: boolean) => void;
+}
+/**
+ * strategy_reset 工厂（策略管理）：恢复内置策略出厂默认——清覆盖记录与墓碑。
+ * 仅对内置范式 id 有意义；自定义策略无出厂版本，明确报错引导 strategy_delete。
+ */
+declare function createStrategyResetTool(options: StrategyResetToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+interface ScreenerAuthorToolOptions {
+  store: CustomScreenerStore;
+  /** 可选：墓碑表（覆盖内置选股器时顺带恢复删除标记）。 */
+  tombstones?: BuiltinTombstonesStore;
+  /** 可选：选股器成功落盘后的回调（emit('strategies') 接线点）。 */
+  onWritten?: (record: CustomScreenerRecord) => void;
+}
+/**
+ * screener_author 工厂（选股器管理）：提交 → 结构/语法/多场景试算校验（vm 熔断）
+ * → 落盘。evaluate(bars, params) 返回 ScreenerMatch | null（单时点截面判断，
+ * 无信号序列语义）。id 为内置选股器（'scr.*'）→ 覆盖该内置（strategy_reset/
+ * screener_reset 可恢复出厂）。
+ */
+declare function createScreenerAuthorTool(options: ScreenerAuthorToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+interface ScreenerDeleteToolOptions {
+  store: CustomScreenerStore;
+  tombstones?: BuiltinTombstonesStore;
+  /** 可选：删除成功后的回调（emit('strategies') 接线点）。 */
+  onDeleted?: (id: string, scope: 'custom' | 'builtin', removed: boolean) => void;
+}
+/**
+ * screener_delete 工厂（选股器管理）：自定义选股器 = 移除记录；内置选股器 =
+ * 落墓碑（出厂代码不动，screener_reset 可恢复）。与 strategy_delete 共用墓碑表。
+ */
+declare function createScreenerDeleteTool(options: ScreenerDeleteToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+interface ScreenerResetToolOptions {
+  store: CustomScreenerStore;
+  tombstones?: BuiltinTombstonesStore;
+  /** 可选：恢复成功后的回调（emit('strategies') 接线点）。 */
+  onReset?: (id: string, changed: boolean) => void;
+}
+/**
+ * screener_reset 工厂（选股器管理）：恢复内置选股器出厂默认——清覆盖记录与墓碑。
+ * 仅对内置选股器 id 有意义；自定义选股器无出厂版本，明确报错引导 screener_delete。
+ */
+declare function createScreenerResetTool(options: ScreenerResetToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Host plugin body：provide store 服务 + 注册策略工具族（host 平面，全会话可见）。 */
 declare function apply(ctx: Context): void;
+/** 解析后的选股器：内置（可信代码）或自定义（源码经 vm 熔断 runner 执行）。 */
+type ResolvedScreener = {
+  kind: 'builtin';
+  definition: ScreenerDefinition;
+} | {
+  kind: 'custom';
+  id: string;
+  name: string;
+  summary: string;
+  params: StrategyParamSpec[];
+  columns: ScreenerColumnSpec[];
+  evaluateSource: string;
+};
+/**
+ * 选股器解析（覆盖 + 墓碑合成，与 resolveStrategyDefinition 同模型）：
+ * 墓碑命中 → undefined；自定义记录优先（覆盖内置同 id）；损坏记录回落内置
+ * 出厂定义，非内置损坏记录视为不存在（与名册语义一致）。
+ */
+declare function resolveScreener(store: CustomScreenerStore, screenerId: string, options?: {
+  tombstones?: BuiltinTombstonesStore | undefined;
+}): Promise<ResolvedScreener | undefined>;
+interface ScreenerRunToolDeps {
+  store: CustomScreenerStore;
+  tombstones?: BuiltinTombstonesStore;
+  /** registry-first 解析（provider 标签 + 行情服务）。 */
+  active: (market: string) => {
+    provider: string;
+    service: MarketDataService;
+  } | undefined;
+  /** 老部署回退：市场键直读行情服务（无 registry 时）。 */
+  fallback?: (market: string) => MarketDataService | undefined;
+  /** 单次扫描总预算 ms（缺省 90s；测试注入小值/假时钟）。 */
+  budgetMs?: number;
+  /** 注入时钟（测试用；缺省 Date.now）。 */
+  now?: () => number;
+}
+/**
+ * screener_run 工厂（issue #86 / G4）：把选股器从「只对 UI 可用」提升为 agent 可跑。
+ * 扫描调度 = 名册 → 截断扫描池 → 受限并发拉 500 根日 K → 纯函数 evaluate；
+ * 数据不足（evaluate 返回 null）静默跳过，单标的失败只计数不中断。
+ * 只读行情 + 本地计算，无交易语义（铁律 #3 不涉及）。
+ */
+declare function createScreenerRunTool(deps: ScreenerRunToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** 策略 store 服务（桥与工具的单实例共享点，issue #33 收口模式）。 */
+declare class StrategiesStoreService extends Service {
+  readonly store: CustomStrategyStore;
+  /** 内置墓碑表（策略/选股器管理共用；桥 DELETE/POST /strategies/* 与工具共享）。 */
+  readonly tombstones: BuiltinTombstonesStore;
+  /** 自定义选股器 store（选股器管理）。 */
+  readonly screenerStore: CustomScreenerStore;
+  constructor(ctx: Context, deps: {
+    store: CustomStrategyStore;
+    tombstones: BuiltinTombstonesStore;
+    screenerStore: CustomScreenerStore;
+  }, serviceName?: string);
+}
 //#endregion
-export { StrategyAuthorToolOptions, StrategyBacktestToolDeps, StrategyBacktestToolOptions, StrategyMarketDataResolver, TradingEventsPublisher, apply, createFileCustomStrategyStore, createMarketDataResolver, createStrategyAuthorTool, createStrategyBacktestTool, defaultStorePath, inject, name, resolveStrategyDefinition };
+export { ResolvedScreener, ScreenerAuthorToolOptions, ScreenerDeleteToolOptions, ScreenerListToolOptions, ScreenerResetToolOptions, ScreenerRunToolDeps, StrategiesStoreService, StrategyAuthorToolOptions, StrategyBacktestToolDeps, StrategyBacktestToolOptions, StrategyDeleteToolOptions, StrategyListToolOptions, StrategyMarketDataResolver, StrategyResetToolOptions, TRADING_STRATEGIES_KEY, TradingEventsPublisher, apply, createFileBuiltinTombstonesStore, createFileCustomScreenerStore, createFileCustomStrategyStore, createMarketDataResolver, createScreenerAuthorTool, createScreenerDeleteTool, createScreenerListTool, createScreenerResetTool, createScreenerRunTool, createStrategyAuthorTool, createStrategyBacktestTool, createStrategyDeleteTool, createStrategyListTool, createStrategyResetTool, defaultScreenerStorePath, defaultStorePath, defaultTombstonesStorePath, inject, isBuiltinScreenerId, isBuiltinStrategyId, name, resolveScreener, resolveStrategyDefinition, validateCustomScreenerNode, validateCustomStrategyNode };