@dshtrading/strategies 0.1.4 → 0.1.6

package/lib/plugin.js

@@ -1,12 +1,16 @@
 import { run } from "./engine.js";
 import { compileStrategySource } from "./validate.js";
 import { getStrategyById } from "./paradigms/index.js";
+import { isBuiltinScreenerId, isBuiltinStrategyId } from "./management.js";
 import "./index.js";
 import { createFileCustomStrategyStore } from "./custom-fs.js";
-import { validateCustomStrategyNode } from "./validate-node.js";
+import { createFileBuiltinTombstonesStore } from "./builtin-tombstones-fs.js";
+import { createFileCustomScreenerStore } from "./custom-screener-fs.js";
+import { validateCustomScreenerNode, validateCustomStrategyNode } from "./validate-node.js";
+import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import os from "node:os";
 import path from "node:path";
+import { dshHomeDir } from "@dshtrading/dsh-home";
 //#region src/plugin.ts
 /** Cordis 插件名 = patch 行 id（TEMPLATES §8），市场无关共享行命名空间。 */
 const name = "dsh-trading-strategies";
@@ -19,10 +23,20 @@ const MARKET_SERVICE_KEYS = {
 	cn: "tradingCnMarketData",
 	hk: "tradingHkMarketData"
 };
-/** 默认存储路径：~/.dsh/strategies/custom.json。 */
+/** 默认存储路径：$DSH_HOME/strategies/custom.json（缺省 ~/.dsh）。 */
 function defaultStorePath() {
-	return path.join(os.homedir(), ".dsh", "strategies", "custom.json");
+	return path.join(dshHomeDir(), "strategies", "custom.json");
 }
+/** 默认墓碑路径：$DSH_HOME/strategies/builtin-tombstones.json（策略管理）。 */
+function defaultTombstonesStorePath() {
+	return path.join(dshHomeDir(), "strategies", "builtin-tombstones.json");
+}
+/** 默认自定义选股器路径：$DSH_HOME/strategies/custom-screeners.json（选股器管理）。 */
+function defaultScreenerStorePath() {
+	return path.join(dshHomeDir(), "strategies", "custom-screeners.json");
+}
+/** SDK 服务键：自定义策略 store 单实例（桥与工具共享同一缓存）。 */
+const TRADING_STRATEGIES_KEY = "tradingStrategies";
 function eventsOf(ctx) {
 	return ctx.get?.("tradingEvents", false);
 }
@@ -36,15 +50,15 @@ function createMarketDataResolver(ctx) {
 }
 /** strategy_author 工厂（独立导出便于单测）。 */
 function createStrategyAuthorTool(options) {
-	const { store, onWritten } = options;
+	const { store, tombstones, onWritten } = options;
 	return defineTool({
 		name: "strategy_author",
-		description: "Author, validate, and persist a custom trading strategy from JavaScript compute source. compute(bars, params) must return StrategySignal[] (entry/exit at bar close, filled at next bar open by the backtest engine). The validator runs sandbox trial calculations across multiple kline scenarios and replays the signal sequence for engine-replayability. If valid, the strategy is persisted and immediately available for backtesting and the strategy roster.",
+		description: "Author, validate, and persist a custom trading strategy from JavaScript compute source. compute(bars, params) must return StrategySignal[] (entry/exit at bar close, filled at next bar open by the backtest engine). The validator runs sandbox trial calculations across multiple kline scenarios and replays the signal sequence for engine-replayability. If valid, the strategy is persisted and immediately available for backtesting and the strategy roster. Submitting an id equal to a built-in paradigm id (donchian-breakout / rsi-reversion / ema-crossover / bollinger-reversion / sma-baseline / momentum-12m) OVERRIDES that built-in strategy (the factory default stays recoverable via strategy_reset).",
 		parameters: {
 			id: {
 				type: "string",
 				required: true,
-				description: "Unique strategy id (2-32 chars: lowercase letters/digits/underscore/hyphen, e.g. \"ema-stop-takeprofit\"); the 6 built-in paradigm ids are reserved"
+				description: "Unique strategy id (2-32 chars: lowercase letters/digits/underscore/hyphen, e.g. \"ema-stop-takeprofit\"); a built-in paradigm id means overriding that built-in strategy"
 			},
 			title: {
 				type: "string",
@@ -91,15 +105,31 @@ function createStrategyAuthorTool(options) {
 			};
 			const result = await validateCustomStrategyNode(candidate);
 			if (!result.ok) return `[strategy_author] Validation failed: ${result.reason}\nReview the requirements: compute(bars, params) returns StrategySignal[]; each signal confirms at bar close (price === bars[index].close, time === bars[index].openTime), indices strictly increase, the sequence starts with entry and strictly alternates entry/exit (the engine fills at the next bar's open).`;
+			const overridesBuiltin = isBuiltinStrategyId(result.record.id);
+			if (overridesBuiltin) {
+				if (await store.get(result.record.id) !== void 0) await store.remove(result.record.id, true);
+				await tombstones?.remove(result.record.id);
+			}
 			await store.save(result.record);
 			onWritten?.(result.record);
 			const specSummary = result.definition.params.map((p) => `${p.key}=${p.default}`).join(", ");
-			return `[strategy_author] Successfully authored strategy "${result.record.title}" (id: ${result.record.id}, horizon: ${result.record.horizon}${specSummary ? `, params: ${specSummary}` : ""}). The strategy passed sandbox trials across 5 kline scenarios with engine-replayable signal sequences and is now persisted — call strategy_backtest with this id to backtest it.`;
+			const scopeNote = overridesBuiltin ? "This id is a built-in paradigm — the factory default remains recoverable via strategy_reset." : "Call strategy_backtest with this id to backtest it.";
+			return `[strategy_author] Successfully authored strategy "${result.record.title}" (id: ${result.record.id}, horizon: ${result.record.horizon}${specSummary ? `, params: ${specSummary}` : ""}). The strategy passed sandbox trials across 5 kline scenarios with engine-replayable signal sequences and is now persisted — ` + scopeNote;
 		}
 	});
 }
-/** 自定义或范式策略 → 回测用 StrategyDefinition（自定义 compute 经编译落定）。 */
-async function resolveStrategyDefinition(store, strategyId) {
+/** 查询墓碑表（缺席或未命中 = 未删）。 */
+async function isTombstoned(tombstones, id) {
+	if (tombstones === void 0) return false;
+	return (await tombstones.list()).includes(id);
+}
+/**
+* 自定义或范式策略 → 回测用 StrategyDefinition（自定义 compute 经编译落定）。
+* 覆盖 + 墓碑合成：store 同 id 记录优先（含内置覆盖）；墓碑命中的 id 一律
+* 视为不存在（含误留覆盖记录的边界——删除语义优先）。
+*/
+async function resolveStrategyDefinition(store, strategyId, options) {
+	if (await isTombstoned(options?.tombstones, strategyId)) return void 0;
 	const record = await store.get(strategyId);
 	if (record !== void 0) {
 		let params = [];
@@ -109,14 +139,19 @@ async function resolveStrategyDefinition(store, strategyId) {
 		} catch {
 			params = [];
 		}
-		return {
-			id: record.id,
-			horizon: record.horizon,
-			name: record.title,
-			summary: record.summary,
-			params,
-			compute: compileStrategySource(record.computeSource)
-		};
+		try {
+			return {
+				id: record.id,
+				horizon: record.horizon,
+				name: record.title,
+				summary: record.summary,
+				params,
+				compute: compileStrategySource(record.computeSource)
+			};
+		} catch {
+			if (isBuiltinStrategyId(record.id)) return getStrategyById(record.id);
+			return;
+		}
 	}
 	return getStrategyById(strategyId);
 }
@@ -165,8 +200,11 @@ function createStrategyBacktestTool(deps) {
 			const interval = typeof args.interval === "string" && args.interval.trim() ? args.interval.trim() : "1d";
 			const limit = typeof args.limit === "number" && Number.isFinite(args.limit) && args.limit > 0 ? Math.min(Math.floor(args.limit), 1e3) : 200;
 			if (!strategyId || !market || !symbol) throw new Error("strategy_backtest: strategyId, market and symbol are required");
-			const definition = await resolveStrategyDefinition(deps.store, strategyId);
-			if (definition === void 0) throw new Error(`strategy_backtest: unknown strategyId "${strategyId}" — author one with strategy_author first, or use a built-in paradigm id (donchian-breakout, rsi-reversion, ema-crossover, bollinger-reversion, sma-baseline, momentum-12m)`);
+			const definition = await resolveStrategyDefinition(deps.store, strategyId, { tombstones: deps.tombstones });
+			if (definition === void 0) {
+				if (await isTombstoned(deps.tombstones, strategyId)) throw new Error(`strategy_backtest: strategy "${strategyId}" has been deleted by the user — call strategy_reset with this id to restore the factory default, or strategy_author to re-create it.`);
+				throw new Error(`strategy_backtest: unknown strategyId "${strategyId}" — author one with strategy_author first, or use a built-in paradigm id (donchian-breakout, rsi-reversion, ema-crossover, bollinger-reversion, sma-baseline, momentum-12m)`);
+			}
 			const service = deps.marketData(market);
 			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);
@@ -192,23 +230,326 @@ function createStrategyBacktestTool(deps) {
 		}
 	});
 }
-/** Host plugin body：注册 strategy_author / strategy_backtest（host 平面，全会话可见）。 */
+/**
+* strategy_delete 工厂（策略管理）：自定义策略 = 移除记录；内置范式 = 落墓碑
+* （出厂代码不动，strategy_reset 可恢复）。覆盖 + 墓碑模型见 management.ts。
+*/
+function createStrategyDeleteTool(options) {
+	const { store, tombstones, onDeleted } = options;
+	return defineTool({
+		name: "strategy_delete",
+		description: "Delete a strategy by id. Custom strategies (authored via strategy_author) are removed from the library; built-in paradigm ids (donchian-breakout / rsi-reversion / ema-crossover / bollinger-reversion / sma-baseline / momentum-12m) are tombstoned instead — the built-in disappears from the roster and backtest but stays recoverable via strategy_reset. Deleting a built-in also discards any user override of it. The GUI strategy roster refreshes live over the SSE channel.",
+		parameters: { id: {
+			type: "string",
+			required: true,
+			description: "Strategy id to delete (a custom id or a built-in paradigm id)"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const id = typeof args.id === "string" ? args.id.trim() : "";
+			if (!id) throw new Error("strategy_delete: id is required");
+			if (isBuiltinStrategyId(id)) {
+				await tombstones?.add(id);
+				const discardedOverride = await store.remove(id, true);
+				onDeleted?.(id, "builtin", true);
+				return JSON.stringify({
+					ok: true,
+					scope: "builtin",
+					deleted: true,
+					discardedOverride,
+					note: `Built-in strategy "${id}" is now tombstoned — hidden from the roster and backtest. Call strategy_reset to restore the factory default.`
+				});
+			}
+			const removed = await store.remove(id);
+			onDeleted?.(id, "custom", removed);
+			return JSON.stringify({
+				ok: true,
+				scope: "custom",
+				deleted: removed,
+				note: removed ? `Deleted custom strategy "${id}".` : `"${id}" was not found in the custom strategy library (built-in ids are handled by tombstone — double-check the id).`
+			});
+		}
+	});
+}
+/**
+* strategy_reset 工厂（策略管理）：恢复内置策略出厂默认——清覆盖记录与墓碑。
+* 仅对内置范式 id 有意义；自定义策略无出厂版本，明确报错引导 strategy_delete。
+*/
+function createStrategyResetTool(options) {
+	const { store, tombstones, onReset } = options;
+	return defineTool({
+		name: "strategy_reset",
+		description: "Restore a built-in paradigm strategy (donchian-breakout / rsi-reversion / ema-crossover / bollinger-reversion / sma-baseline / momentum-12m) to its factory default: any user override is discarded and a deletion tombstone is lifted. Custom strategy ids have no factory default — use strategy_delete for those.",
+		parameters: { id: {
+			type: "string",
+			required: true,
+			description: "Built-in paradigm strategy id to restore"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const id = typeof args.id === "string" ? args.id.trim() : "";
+			if (!id) throw new Error("strategy_reset: id is required");
+			if (!isBuiltinStrategyId(id)) throw new Error(`strategy_reset: "${id}" is not a built-in paradigm strategy id — custom strategies have no factory default; use strategy_delete to remove them`);
+			const removedOverride = await store.remove(id, true);
+			const liftedTombstone = await tombstones?.remove(id) ?? false;
+			const changed = removedOverride || liftedTombstone;
+			onReset?.(id, changed);
+			return JSON.stringify({
+				ok: true,
+				reset: true,
+				changed,
+				removedOverride,
+				liftedTombstone,
+				note: changed ? `Built-in strategy "${id}" restored to factory default (override/tombstone cleared).` : `"${id}" was already at factory default — nothing to restore.`
+			});
+		}
+	});
+}
+/**
+* screener_author 工厂（选股器管理）：提交 → 结构/语法/多场景试算校验（vm 熔断）
+* → 落盘。evaluate(bars, params) 返回 ScreenerMatch | null（单时点截面判断，
+* 无信号序列语义）。id 为内置选股器（'scr.*'）→ 覆盖该内置（strategy_reset/
+* screener_reset 可恢复出厂）。
+*/
+function createScreenerAuthorTool(options) {
+	const { store, tombstones, onWritten } = options;
+	return defineTool({
+		name: "screener_author",
+		description: "Author, validate, and persist a custom stock screener from JavaScript evaluate source. evaluate(bars, params) is a single-point cross-section predicate: return a ScreenerMatch ({ metrics: Record<string, number> with keys declared in columns, reason }) or null when the symbol does not match / lacks data. The validator runs sandbox trial calculations across multiple kline scenarios. If valid, the screener is persisted and immediately available in the GUI screener roster. Submitting an id equal to a built-in screener id (scr.ma-bull-align / scr.volume-breakout / scr.rsi-oversold / scr.near-high / scr.above-ma) OVERRIDES that built-in screener (factory default stays recoverable via screener_reset).",
+		parameters: {
+			id: {
+				type: "string",
+				required: true,
+				description: "Unique screener id with \"scr.\" prefix (e.g. \"scr.custom-momentum\"); a built-in screener id means overriding that built-in"
+			},
+			title: {
+				type: "string",
+				required: true,
+				description: "Display name (1-32 chars), e.g. \"量价双确认\""
+			},
+			summary: {
+				type: "string",
+				required: true,
+				description: "One-sentence idea summary (≤120 chars), shown in the screener roster"
+			},
+			paramsJson: {
+				type: "string",
+				description: "JSON string of StrategyParamSpec[] (optional, default []). Each spec: { key, label, default, min, max } with numeric default/min/max and min < max."
+			},
+			columnsJson: {
+				type: "string",
+				required: true,
+				description: "JSON string of ScreenerColumnSpec[] (1-8 columns). Each spec: { key, label, format?: \"percent\" | \"number\" }. Match metrics keys must be declared here. JSON example: [{\"key\":\"volRatio\",\"label\":\"量比(倍)\"}]"
+			},
+			evaluateSource: {
+				type: "string",
+				required: true,
+				description: "JavaScript pure function source, signature (bars, params) => ScreenerMatch | null. bars has { openTime, open, high, low, close, volume }. Return null to skip the symbol (no match or insufficient data). metrics values must be finite numbers with keys declared in columnsJson; reason is a non-empty human-readable string."
+			}
+		},
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const candidate = {
+				id: typeof args.id === "string" ? args.id : "",
+				title: typeof args.title === "string" ? args.title : "",
+				horizon: "swing",
+				summary: typeof args.summary === "string" ? args.summary : "",
+				paramsJson: typeof args.paramsJson === "string" && args.paramsJson.trim() ? args.paramsJson.trim() : "[]",
+				columnsJson: typeof args.columnsJson === "string" ? args.columnsJson : "",
+				evaluateSource: typeof args.evaluateSource === "string" ? args.evaluateSource : "",
+				createdAt: Date.now()
+			};
+			const result = await validateCustomScreenerNode(candidate);
+			if (!result.ok) return `[screener_author] Validation failed: ${result.reason}\nReview the requirements: evaluate(bars, params) returns ScreenerMatch | null; metrics keys must be declared in columnsJson with finite number values; reason must be a non-empty string; return null to skip a symbol.`;
+			const overridesBuiltin = isBuiltinScreenerId(result.record.id);
+			if (overridesBuiltin) {
+				if (await store.get(result.record.id) !== void 0) await store.remove(result.record.id, true);
+				await tombstones?.remove(result.record.id);
+			}
+			await store.save(result.record);
+			onWritten?.(result.record);
+			const columnKeys = result.definition.columns.map((c) => c.key).join(", ");
+			return `[screener_author] Successfully authored screener "${result.record.title}" (id: ${result.record.id}` + (columnKeys ? `, columns: ${columnKeys}` : "") + "). The screener passed sandbox trials across 5 kline scenarios and is now persisted to the GUI screener roster. " + (overridesBuiltin ? "This id is a built-in screener — the factory default remains recoverable via screener_reset." : "Run scans from the GUI screener pane.");
+		}
+	});
+}
+/**
+* screener_delete 工厂（选股器管理）：自定义选股器 = 移除记录；内置选股器 =
+* 落墓碑（出厂代码不动，screener_reset 可恢复）。与 strategy_delete 共用墓碑表。
+*/
+function createScreenerDeleteTool(options) {
+	const { store, tombstones, onDeleted } = options;
+	return defineTool({
+		name: "screener_delete",
+		description: "Delete a screener by id. Custom screeners (authored via screener_author) are removed from the library; built-in screener ids (scr.ma-bull-align / scr.volume-breakout / scr.rsi-oversold / scr.near-high / scr.above-ma) are tombstoned instead — the built-in disappears from the GUI screener roster but stays recoverable via screener_reset. Deleting a built-in also discards any user override of it.",
+		parameters: { id: {
+			type: "string",
+			required: true,
+			description: "Screener id to delete (a custom id or a built-in screener id)"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const id = typeof args.id === "string" ? args.id.trim() : "";
+			if (!id) throw new Error("screener_delete: id is required");
+			if (isBuiltinScreenerId(id)) {
+				await tombstones?.add(id);
+				const discardedOverride = await store.remove(id, true);
+				onDeleted?.(id, "builtin", true);
+				return JSON.stringify({
+					ok: true,
+					scope: "builtin",
+					deleted: true,
+					discardedOverride,
+					note: `Built-in screener "${id}" is now tombstoned — hidden from the GUI screener roster. Call screener_reset to restore the factory default.`
+				});
+			}
+			const removed = await store.remove(id);
+			onDeleted?.(id, "custom", removed);
+			return JSON.stringify({
+				ok: true,
+				scope: "custom",
+				deleted: removed,
+				note: removed ? `Deleted custom screener "${id}".` : `"${id}" was not found in the custom screener library (built-in ids are handled by tombstone — double-check the id).`
+			});
+		}
+	});
+}
+/**
+* screener_reset 工厂（选股器管理）：恢复内置选股器出厂默认——清覆盖记录与墓碑。
+* 仅对内置选股器 id 有意义；自定义选股器无出厂版本，明确报错引导 screener_delete。
+*/
+function createScreenerResetTool(options) {
+	const { store, tombstones, onReset } = options;
+	return defineTool({
+		name: "screener_reset",
+		description: "Restore a built-in screener (scr.ma-bull-align / scr.volume-breakout / scr.rsi-oversold / scr.near-high / scr.above-ma) to its factory default: any user override is discarded and a deletion tombstone is lifted. Custom screener ids have no factory default — use screener_delete for those.",
+		parameters: { id: {
+			type: "string",
+			required: true,
+			description: "Built-in screener id to restore"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(raw) {
+			const args = raw ?? {};
+			const id = typeof args.id === "string" ? args.id.trim() : "";
+			if (!id) throw new Error("screener_reset: id is required");
+			if (!isBuiltinScreenerId(id)) throw new Error(`screener_reset: "${id}" is not a built-in screener id — custom screeners have no factory default; use screener_delete to remove them`);
+			const removedOverride = await store.remove(id, true);
+			const liftedTombstone = await tombstones?.remove(id) ?? false;
+			const changed = removedOverride || liftedTombstone;
+			onReset?.(id, changed);
+			return JSON.stringify({
+				ok: true,
+				reset: true,
+				changed,
+				removedOverride,
+				liftedTombstone,
+				note: changed ? `Built-in screener "${id}" restored to factory default (override/tombstone cleared).` : `"${id}" was already at factory default — nothing to restore.`
+			});
+		}
+	});
+}
+/** Host plugin body：provide store 服务 + 注册策略工具族（host 平面，全会话可见）。 */
 function apply(ctx) {
 	const store = createFileCustomStrategyStore(defaultStorePath());
+	const tombstones = createFileBuiltinTombstonesStore(defaultTombstonesStorePath());
+	const screenerStore = createFileCustomScreenerStore(defaultScreenerStorePath());
+	new StrategiesStoreService(ctx, {
+		store,
+		tombstones,
+		screenerStore
+	});
 	ctx.inject(["tools"], (toolCtx) => {
 		const tools = toolCtx.tools;
 		if (!tools || typeof tools.register !== "function") return;
-		const authorTool = createStrategyAuthorTool({
+		const events = () => eventsOf(ctx)?.emit("strategies");
+		const register = (tool) => {
+			if (tools.get(tool.name) === void 0) tools.register(tool);
+		};
+		register(createStrategyAuthorTool({
 			store,
-			onWritten: () => eventsOf(ctx)?.emit("strategies")
-		});
-		if (tools.get(authorTool.name) === void 0) tools.register(authorTool);
-		const backtestTool = createStrategyBacktestTool({
+			tombstones,
+			onWritten: () => events()
+		}));
+		register(createStrategyBacktestTool({
 			store,
+			tombstones,
 			marketData: createMarketDataResolver(ctx)
-		});
-		if (tools.get(backtestTool.name) === void 0) tools.register(backtestTool);
+		}));
+		register(createStrategyDeleteTool({
+			store,
+			tombstones,
+			onDeleted: () => events()
+		}));
+		register(createStrategyResetTool({
+			store,
+			tombstones,
+			onReset: () => events()
+		}));
+		register(createScreenerAuthorTool({
+			store: screenerStore,
+			tombstones,
+			onWritten: () => events()
+		}));
+		register(createScreenerDeleteTool({
+			store: screenerStore,
+			tombstones,
+			onDeleted: () => events()
+		}));
+		register(createScreenerResetTool({
+			store: screenerStore,
+			tombstones,
+			onReset: () => events()
+		}));
 	});
 }
+/** 策略 store 服务（桥与工具的单实例共享点，issue #33 收口模式）。 */
+var StrategiesStoreService = class extends Service {
+	store;
+	/** 内置墓碑表（策略/选股器管理共用；桥 DELETE/POST /strategies/* 与工具共享）。 */
+	tombstones;
+	/** 自定义选股器 store（选股器管理）。 */
+	screenerStore;
+	constructor(ctx, deps, serviceName = TRADING_STRATEGIES_KEY) {
+		super(ctx, serviceName);
+		this.store = deps.store;
+		this.tombstones = deps.tombstones;
+		this.screenerStore = deps.screenerStore;
+	}
+};
 //#endregion
-export { apply, createFileCustomStrategyStore, createMarketDataResolver, createStrategyAuthorTool, createStrategyBacktestTool, defaultStorePath, inject, name, resolveStrategyDefinition };
+export { StrategiesStoreService, TRADING_STRATEGIES_KEY, apply, createFileBuiltinTombstonesStore, createFileCustomScreenerStore, createFileCustomStrategyStore, createMarketDataResolver, createScreenerAuthorTool, createScreenerDeleteTool, createScreenerResetTool, createStrategyAuthorTool, createStrategyBacktestTool, createStrategyDeleteTool, createStrategyResetTool, defaultScreenerStorePath, defaultStorePath, defaultTombstonesStorePath, inject, isBuiltinScreenerId, isBuiltinStrategyId, name, resolveStrategyDefinition, validateCustomScreenerNode, validateCustomStrategyNode };

package/lib/price-format.d.ts

@@ -0,0 +1,16 @@
+//#region src/price-format.d.ts
+/**
+ * 标的价格显示小数位（自适应，全局显示约定单一来源）：
+ * ≥1 默认 2 位；当 2 位舍入会丢失第 3 位有效小数（如港股 0.001 tick、
+ * 低价权证/债券）时升到 3 位；<1 按量级 4/6 位（低价加密对）。
+ * 1e-9 容差只滤浮点表示噪声——常规价位下它比第 3 位小数量级低多个数量级。
+ *
+ * client-ui-trading / client-ui-strategies 经本包复用同一规则；范式策略的
+ * compute 因需自包含（compute.toString() 导出可编译源码）内联同式实现，
+ * 两处改动必须同步。
+ */
+declare function priceDigits(value: number | undefined): number;
+/** 价格文本：undefined/NaN → '—'，否则按 priceDigits 定点舍入。 */
+declare function fmtPrice(value: number | undefined): string;
+//#endregion
+export { fmtPrice, priceDigits };

package/lib/price-format.js

@@ -0,0 +1,25 @@
+//#region src/price-format.ts
+/**
+* 标的价格显示小数位（自适应，全局显示约定单一来源）：
+* ≥1 默认 2 位；当 2 位舍入会丢失第 3 位有效小数（如港股 0.001 tick、
+* 低价权证/债券）时升到 3 位；<1 按量级 4/6 位（低价加密对）。
+* 1e-9 容差只滤浮点表示噪声——常规价位下它比第 3 位小数量级低多个数量级。
+*
+* client-ui-trading / client-ui-strategies 经本包复用同一规则；范式策略的
+* compute 因需自包含（compute.toString() 导出可编译源码）内联同式实现，
+* 两处改动必须同步。
+*/
+function priceDigits(value) {
+	if (value === void 0 || !Number.isFinite(value)) return 2;
+	const abs = Math.abs(value);
+	if (abs < 1) return abs >= .01 ? 4 : 6;
+	const rounded = Number(value.toFixed(2));
+	return Math.abs(rounded - value) < 1e-9 ? 2 : 3;
+}
+/** 价格文本：undefined/NaN → '—'，否则按 priceDigits 定点舍入。 */
+function fmtPrice(value) {
+	if (value === void 0 || !Number.isFinite(value)) return "—";
+	return value.toFixed(priceDigits(value));
+}
+//#endregion
+export { fmtPrice, priceDigits };

package/lib/screeners/above-ma.js

@@ -1,9 +1,4 @@
-import { sma } from "@dshtrading/indicators";
 //#region src/screeners/above-ma.ts
-/**
-* 牛熊线之上：现价站上长期均线且均线自身斜率向上——与量化「200 日均线
-* 牛熊择时基线」同源的长线标的筛选（Faber GTAA 的截面版）。
-*/
 const aboveMaScreener = {
 	id: "scr.above-ma",
 	name: "站上牛熊线",
@@ -37,8 +32,18 @@ const aboveMaScreener = {
 		const slopeBars = Math.max(5, Math.round(params.slopeBars ?? 20));
 		const i = bars.length - 1;
 		if (i < period + slopeBars - 1) return null;
-		const closes = bars.map((b) => b.close);
-		const maSeries = sma(closes, period);
+		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 maSeries = smaOf(bars.map((b) => b.close), period);
 		const ma = maSeries[i];
 		const maPrev = maSeries[i - slopeBars];
 		if (ma === void 0 || maPrev === void 0 || !(maPrev > 0)) return null;

package/lib/screeners/ma-bull-align.js

@@ -1,9 +1,4 @@
-import { sma } from "@dshtrading/indicators";
 //#region src/screeners/ma-bull-align.ts
-/**
-* 均线多头排列：现价站上三线，且短中期均线自上而下依次压制
-* （SMA(短) > SMA(中) > SMA(长)），趋势结构完整的顺势筛选。
-*/
 const maBullAlignScreener = {
 	id: "scr.ma-bull-align",
 	name: "均线多头排列",
@@ -45,10 +40,21 @@ const maBullAlignScreener = {
 		const n3 = Math.max(n2, Math.round(params.n3 ?? 120));
 		const i = bars.length - 1;
 		if (i + 1 < n3) return null;
+		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 closes = bars.map((b) => b.close);
-		const s1 = sma(closes, n1)[i];
-		const s2 = sma(closes, n2)[i];
-		const s3 = sma(closes, n3)[i];
+		const s1 = smaOf(closes, n1)[i];
+		const s2 = smaOf(closes, n2)[i];
+		const s3 = smaOf(closes, n3)[i];
 		if (s1 === void 0 || s2 === void 0 || s3 === void 0) return null;
 		const close = bars[i].close;
 		if (!(close > s1 && s1 > s2 && s2 > s3)) return null;

package/lib/screeners/rsi-oversold.js

@@ -1,9 +1,4 @@
-import { rsi } from "@dshtrading/indicators";
 //#region src/screeners/rsi-oversold.ts
-/**
-* RSI 超卖：RSI(period) 跌入阈值以下的逆势关注筛选——超卖≠见底，
-* 定位是「值得盯的反转候选池」，命中理由里明示是逆势信号。
-*/
 const rsiOversoldScreener = {
 	id: "scr.rsi-oversold",
 	name: "RSI 超卖",
@@ -32,7 +27,28 @@ const rsiOversoldScreener = {
 		const threshold = Math.min(50, Math.max(10, params.threshold ?? 30));
 		const i = bars.length - 1;
 		if (i < period) return null;
-		const value = rsi(bars.map((b) => b.close), period)[i];
+		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 value = rsiOf(bars.map((b) => b.close), period)[i];
 		if (value === void 0) return null;
 		if (!(value < threshold)) return null;
 		return {

package/lib/screeners/volume-breakout.js

@@ -1,9 +1,4 @@
-import { sma } from "@dshtrading/indicators";
 //#region src/screeners/volume-breakout.ts
-/**
-* 放量突破：收盘价创 lookback 日新高，且成交量 ≥ 均量的 volMultiple 倍——
-* 突破有效性的量能确认（无量突破不入选）。量比口径跨市场可比（比值无量纲）。
-*/
 const volumeBreakoutScreener = {
 	id: "scr.volume-breakout",
 	name: "放量突破",
@@ -36,10 +31,20 @@ const volumeBreakoutScreener = {
 		const volMultiple = Math.max(1, params.volMultiple ?? 2);
 		const i = bars.length - 1;
 		if (i < lookback) return null;
+		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 window = bars.slice(i - lookback, i);
 		const priorHigh = Math.max(...window.map((b) => b.high));
-		const volumes = bars.map((b) => b.volume);
-		const avgVolume = sma(volumes, lookback)[i];
+		const avgVolume = smaOf(bars.map((b) => b.volume), lookback)[i];
 		if (avgVolume === void 0 || avgVolume <= 0) return null;
 		const close = bars[i].close;
 		const volume = bars[i].volume;