@dshtrading/strategies 0.1.4 → 0.1.6

package/lib/builtin-tombstones-fs.d.ts

@@ -0,0 +1,5 @@
+import { BuiltinTombstonesStore } from "./builtin-tombstones.js";
+//#region src/builtin-tombstones-fs.d.ts
+declare function createFileBuiltinTombstonesStore(filePath: string): BuiltinTombstonesStore;
+//#endregion
+export { createFileBuiltinTombstonesStore };

package/lib/builtin-tombstones-fs.js

@@ -0,0 +1,75 @@
+import { dirname } from "node:path";
+import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+//#region src/builtin-tombstones-fs.ts
+/**
+* 文件持久化版内置策略/选股器墓碑存储（Node.js 宿主侧使用，
+* 落 ~/.dsh/strategies/builtin-tombstones.json，形状 { deleted: string[] }）。
+*
+* 与 custom-fs.ts 同款 tmp + rename 原子写入模式；旧宿主从未写过该文件，
+* 无迁移问题（ENOENT 视为空表）。
+*/
+function createFileBuiltinTombstonesStore(filePath) {
+	let cache = null;
+	async function load() {
+		if (cache !== null) return cache;
+		try {
+			const content = await readFile(filePath, "utf8");
+			const parsed = JSON.parse(content);
+			const set = /* @__PURE__ */ new Set();
+			if (Array.isArray(parsed?.deleted)) {
+				for (const id of parsed.deleted) if (typeof id === "string" && id) set.add(id);
+			}
+			cache = set;
+			return set;
+		} catch (err) {
+			if (err?.code !== "ENOENT") console.error(`[dsh-trading/strategies] failed to read builtin tombstones from ${filePath}:`, err);
+			cache = /* @__PURE__ */ new Set();
+			return cache;
+		}
+	}
+	async function flush(set) {
+		const dir = dirname(filePath);
+		const tmpPath = `${filePath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
+		const data = JSON.stringify({ deleted: [...set] }, null, 2);
+		try {
+			await mkdir(dir, { recursive: true });
+			await writeFile(tmpPath, data, "utf8");
+			let lastError;
+			for (let attempt = 0; attempt < 3; attempt++) try {
+				await rename(tmpPath, filePath);
+				return;
+			} catch (err) {
+				if (err?.code !== "EPERM" && err?.code !== "EBUSY") throw err;
+				lastError = err;
+				await new Promise((resolve) => setTimeout(resolve, 25 * (attempt + 1)));
+			}
+			throw lastError;
+		} catch (error) {
+			console.error(`[dsh-trading/strategies] failed to atomic flush builtin tombstones to ${filePath}:`, error);
+			await unlink(tmpPath).catch(() => {});
+			throw error;
+		}
+	}
+	return {
+		async list() {
+			return [...await load()];
+		},
+		async add(id) {
+			const set = await load();
+			const fresh = !set.has(id);
+			if (fresh) {
+				set.add(id);
+				await flush(set);
+			}
+			return fresh;
+		},
+		async remove(id) {
+			const set = await load();
+			const existed = set.delete(id);
+			if (existed) await flush(set);
+			return existed;
+		}
+	};
+}
+//#endregion
+export { createFileBuiltinTombstonesStore };

package/lib/builtin-tombstones.d.ts

@@ -0,0 +1,24 @@
+//#region src/builtin-tombstones.d.ts
+/**
+ * 内置策略/选股器墓碑存储（策略管理，2026-09-07）。
+ *
+ * 语义（覆盖 + 墓碑模型）：内置策略与选股器保持代码常量作为出厂默认；
+ * 用户「删除内置」不删代码，只落一条 id 墓碑——名册合成时剔除，恢复默认
+ * 即移除墓碑。策略（paradigm id）与选股器（'scr.' 前缀 id）id 空间天然
+ * 隔离，共用同一墓碑表。覆盖（修改内置）不用墓碑——覆盖记录落在
+ * CustomStrategyStore（同 id 记录替换内置），此处只承载「删除」。
+ *
+ * 纯类型 + 内存版，零 Node 依赖，浏览器安全；file 版在 ./builtin-tombstones-fs.ts。
+ */
+interface BuiltinTombstonesStore {
+  /** 全部墓碑 id（策略与选股器混合，顺序 = 删除顺序）。 */
+  list(): Promise<string[]>;
+  /** 新增墓碑；返回是否为新删（重复删除幂等返回 false）。 */
+  add(id: string): Promise<boolean>;
+  /** 移除墓碑（恢复出厂）；返回是否存在。 */
+  remove(id: string): Promise<boolean>;
+}
+/** 内存版墓碑存储（纯浏览器与单测用）。 */
+declare function createMemoryBuiltinTombstonesStore(initial?: readonly string[]): BuiltinTombstonesStore;
+//#endregion
+export { BuiltinTombstonesStore, createMemoryBuiltinTombstonesStore };

package/lib/builtin-tombstones.js

@@ -0,0 +1,16 @@
+//#region src/builtin-tombstones.ts
+/** 内存版墓碑存储（纯浏览器与单测用）。 */
+function createMemoryBuiltinTombstonesStore(initial = []) {
+	const tombstones = new Set(initial);
+	return {
+		list: async () => [...tombstones],
+		add: async (id) => {
+			const fresh = !tombstones.has(id);
+			tombstones.add(id);
+			return fresh;
+		},
+		remove: async (id) => tombstones.delete(id)
+	};
+}
+//#endregion
+export { createMemoryBuiltinTombstonesStore };

package/lib/custom-fs.js

@@ -1,10 +1,12 @@
 import { dirname } from "node:path";
-import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { appendFile, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
 //#region src/custom-fs.ts
 /**
 * 文件持久化版自定义策略存储（Node.js 宿主侧使用，落 ~/.dsh/strategies/custom.json）。
 *
 * 与 indicators/src/custom-fs.ts 同款 tmp + rename 原子写入模式（issue #31 规格）。
+* remove(archive=true) 会先把被删记录归档到 sidecar 文件（<path>.archive.jsonl，
+* JSONL 追加）——策略管理（覆盖 + 墓碑）丢弃用户 override 时可找回（2026-09-07）。
 */
 function createFileCustomStrategyStore(filePath) {
 	let cache = null;
@@ -60,10 +62,20 @@ function createFileCustomStrategyStore(filePath) {
 			map.set(record.id, { ...record });
 			await flush(map);
 		},
-		async remove(id) {
+		async remove(id, archive = false) {
 			const map = await load();
+			const removedRecord = map.get(id);
 			const existed = map.delete(id);
-			if (existed) await flush(map);
+			if (existed) {
+				if (archive && removedRecord !== void 0) try {
+					const archivePath = `${filePath}.archive.jsonl`;
+					await mkdir(dirname(filePath), { recursive: true });
+					await appendFile(archivePath, `${JSON.stringify(removedRecord)}\n`);
+				} catch (error) {
+					console.error("[dsh-trading/strategies] failed to archive removed strategy record:", error);
+				}
+				await flush(map);
+			}
 			return existed;
 		}
 	};

package/lib/custom-screener-fs.d.ts

@@ -0,0 +1,5 @@
+import { CustomScreenerStore } from "./custom-screener.js";
+//#region src/custom-screener-fs.d.ts
+declare function createFileCustomScreenerStore(filePath: string): CustomScreenerStore;
+//#endregion
+export { createFileCustomScreenerStore };

package/lib/custom-screener-fs.js

@@ -0,0 +1,85 @@
+import { dirname } from "node:path";
+import { appendFile, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+//#region src/custom-screener-fs.ts
+/**
+* 文件持久化版自定义选股器存储（Node.js 宿主侧使用，
+* 落 ~/.dsh/strategies/custom-screeners.json）。
+*
+* 与 custom-fs.ts 同款 tmp + rename 原子写入模式。
+* remove(archive=true) 先把被删记录归档到 sidecar（<path>.archive.jsonl，JSONL
+* 追加）——选股器管理丢弃用户 override 时可找回（2026-09-07 审查补强）。
+*/
+function createFileCustomScreenerStore(filePath) {
+	let cache = null;
+	async function load() {
+		if (cache !== null) return cache;
+		try {
+			const content = await readFile(filePath, "utf8");
+			const parsed = JSON.parse(content);
+			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);
+			}
+			cache = map;
+			return map;
+		} catch (err) {
+			if (err?.code !== "ENOENT") console.error(`[dsh-trading/strategies] failed to read custom screeners from ${filePath}:`, err);
+			cache = /* @__PURE__ */ new Map();
+			return cache;
+		}
+	}
+	async function flush(map) {
+		const dir = dirname(filePath);
+		const tmpPath = `${filePath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
+		const data = JSON.stringify([...map.values()], null, 2);
+		try {
+			await mkdir(dir, { recursive: true });
+			await writeFile(tmpPath, data, "utf8");
+			let lastError;
+			for (let attempt = 0; attempt < 3; attempt++) try {
+				await rename(tmpPath, filePath);
+				return;
+			} catch (err) {
+				if (err?.code !== "EPERM" && err?.code !== "EBUSY") throw err;
+				lastError = err;
+				await new Promise((resolve) => setTimeout(resolve, 25 * (attempt + 1)));
+			}
+			throw lastError;
+		} catch (error) {
+			console.error(`[dsh-trading/strategies] failed to atomic flush custom screeners to ${filePath}:`, error);
+			await unlink(tmpPath).catch(() => {});
+			throw error;
+		}
+	}
+	return {
+		async list() {
+			return [...(await load()).values()];
+		},
+		async get(id) {
+			return (await load()).get(id);
+		},
+		async save(record) {
+			const map = await load();
+			map.set(record.id, { ...record });
+			await flush(map);
+		},
+		async remove(id, archive = false) {
+			const map = await load();
+			const removedRecord = map.get(id);
+			const existed = map.delete(id);
+			if (existed) {
+				if (archive && removedRecord !== void 0) try {
+					const archivePath = `${filePath}.archive.jsonl`;
+					await mkdir(dirname(filePath), { recursive: true });
+					await appendFile(archivePath, `${JSON.stringify(removedRecord)}\n`);
+				} catch (error) {
+					console.error("[dsh-trading/strategies] failed to archive removed screener record:", error);
+				}
+				await flush(map);
+			}
+			return existed;
+		}
+	};
+}
+//#endregion
+export { createFileCustomScreenerStore };

package/lib/custom-screener.d.ts

@@ -0,0 +1,31 @@
+import { StrategyHorizon } from "./types.js";
+//#region src/custom-screener.d.ts
+interface CustomScreenerRecord {
+  /** 选股器唯一 ID，强制 'scr.' 前缀（如 'scr.custom-momentum'） */
+  id: string;
+  /** 展示名，如 '量价双确认' */
+  title: string;
+  /** 预留与策略记录同构的期限词汇（选股器当前不分组，恒 'swing'） */
+  horizon: StrategyHorizon;
+  /** 一句话思路 */
+  summary: string;
+  /** 参数规格数组（StrategyParamSpec[]）的 JSON 字符串 */
+  paramsJson: string;
+  /** 结果动态列（ScreenerColumnSpec[]）的 JSON 字符串 */
+  columnsJson: string;
+  /** JavaScript 纯函数源码，接收 (bars, params) 返回 ScreenerMatch | null */
+  evaluateSource: string;
+  /** 创建时间戳 */
+  createdAt: number;
+}
+interface CustomScreenerStore {
+  list(): Promise<CustomScreenerRecord[]>;
+  get(id: string): Promise<CustomScreenerRecord | undefined>;
+  save(record: CustomScreenerRecord): Promise<void>;
+  /** archive = 删除前把记录归档（file 版落 .archive.jsonl；memory 版忽略）。 */
+  remove(id: string, archive?: boolean): Promise<boolean>;
+}
+/** 内存版自定义选股器存储（纯浏览器与单测用）。 */
+declare function createMemoryCustomScreenerStore(initial?: CustomScreenerRecord[]): CustomScreenerStore;
+//#endregion
+export { CustomScreenerRecord, CustomScreenerStore, createMemoryCustomScreenerStore };

package/lib/custom-screener.js

@@ -0,0 +1,16 @@
+//#region src/custom-screener.ts
+/** 内存版自定义选股器存储（纯浏览器与单测用）。 */
+function createMemoryCustomScreenerStore(initial = []) {
+	const map = /* @__PURE__ */ new Map();
+	for (const item of initial) map.set(item.id, item);
+	return {
+		list: async () => [...map.values()],
+		get: async (id) => map.get(id),
+		save: async (record) => {
+			map.set(record.id, { ...record });
+		},
+		remove: async (id) => map.delete(id)
+	};
+}
+//#endregion
+export { createMemoryCustomScreenerStore };

package/lib/custom.d.ts

@@ -20,7 +20,8 @@ interface CustomStrategyStore {
   list(): Promise<CustomStrategyRecord[]>;
   get(id: string): Promise<CustomStrategyRecord | undefined>;
   save(record: CustomStrategyRecord): Promise<void>;
-  remove(id: string): Promise<boolean>;
+  /** archive = 删除前把记录归档（file 版落 .archive.jsonl；memory 版忽略）。 */
+  remove(id: string, archive?: boolean): Promise<boolean>;
 }
 /** 内存版自定义策略存储（纯浏览器与单测用）。 */
 declare function createMemoryCustomStrategyStore(initial?: CustomStrategyRecord[]): CustomStrategyStore;

package/lib/index.d.ts

@@ -1,8 +1,12 @@
 import { BacktestMetrics, BacktestOptions, BacktestResult, EquityPoint, Kline, SignalAction, StrategyDefinition, StrategyHorizon, StrategyParamSpec, StrategySignal, TradeRecord } from "./types.js";
 import { run } from "./engine.js";
+import { fmtPrice, priceDigits } from "./price-format.js";
 import { CustomStrategyRecord, CustomStrategyStore, createMemoryCustomStrategyStore } from "./custom.js";
-import { StrategyValidationResult, compileStrategySource, validateCustomStrategy, validateSignalSequence } from "./validate.js";
 import { ScreenerColumnSpec, ScreenerDefinition, ScreenerMatch } from "./screeners/types.js";
+import { CustomScreenerRecord, CustomScreenerStore, createMemoryCustomScreenerStore } from "./custom-screener.js";
+import { ScreenerValidationResult, StrategyValidationResult, compileStrategySource, validateCustomScreener, validateCustomStrategy, validateSignalSequence } from "./validate.js";
+import { BUILTIN_SCREENER_IDS, BUILTIN_STRATEGY_IDS, applyScreenerManagement, applyStrategyManagement, builtinScreenerRecord, builtinScreenerSource, builtinStrategyRecord, builtinStrategySource, isBuiltinScreenerId, isBuiltinStrategyId } from "./management.js";
+import { BuiltinTombstonesStore, createMemoryBuiltinTombstonesStore } from "./builtin-tombstones.js";
 import { getScreenerById, screenerParadigms } from "./screeners/index.js";
 import { donchianBreakoutStrategy } from "./paradigms/donchian-breakout.js";
 import { rsiReversionStrategy } from "./paradigms/rsi-reversion.js";
@@ -11,4 +15,5 @@ import { bollingerReversionStrategy } from "./paradigms/bollinger-reversion.js";
 import { smaBaselineStrategy } from "./paradigms/sma-baseline.js";
 import { momentum12mStrategy } from "./paradigms/momentum-12m.js";
 import { getStrategyById, strategyParadigms } from "./paradigms/index.js";
-export { type BacktestMetrics, type BacktestOptions, type BacktestResult, type CustomStrategyRecord, type CustomStrategyStore, type EquityPoint, type Kline, type ScreenerColumnSpec, type ScreenerDefinition, type ScreenerMatch, type SignalAction, type StrategyDefinition, type StrategyHorizon, type StrategyParamSpec, type StrategySignal, type StrategyValidationResult, type TradeRecord, bollingerReversionStrategy, compileStrategySource, createMemoryCustomStrategyStore, donchianBreakoutStrategy, emaCrossoverStrategy, getScreenerById, getStrategyById, momentum12mStrategy, rsiReversionStrategy, run, screenerParadigms, smaBaselineStrategy, strategyParadigms, validateCustomStrategy, validateSignalSequence };
+import { workerComputeRunner } from "@dshtrading/indicators";
+export { BUILTIN_SCREENER_IDS, BUILTIN_STRATEGY_IDS, type BacktestMetrics, type BacktestOptions, type BacktestResult, type BuiltinTombstonesStore, type CustomScreenerRecord, type CustomScreenerStore, type CustomStrategyRecord, type CustomStrategyStore, type EquityPoint, type Kline, type ScreenerColumnSpec, type ScreenerDefinition, type ScreenerMatch, type ScreenerValidationResult, type SignalAction, type StrategyDefinition, type StrategyHorizon, type StrategyParamSpec, type StrategySignal, type StrategyValidationResult, type TradeRecord, applyScreenerManagement, applyStrategyManagement, bollingerReversionStrategy, builtinScreenerRecord, builtinScreenerSource, builtinStrategyRecord, builtinStrategySource, compileStrategySource, createMemoryBuiltinTombstonesStore, createMemoryCustomScreenerStore, createMemoryCustomStrategyStore, donchianBreakoutStrategy, emaCrossoverStrategy, fmtPrice, getScreenerById, getStrategyById, isBuiltinScreenerId, isBuiltinStrategyId, momentum12mStrategy, priceDigits, rsiReversionStrategy, run, screenerParadigms, smaBaselineStrategy, strategyParadigms, validateCustomScreener, validateCustomStrategy, validateSignalSequence, workerComputeRunner };

package/lib/index.js

@@ -1,7 +1,7 @@
 import { run } from "./engine.js";
+import { fmtPrice, priceDigits } from "./price-format.js";
 import { createMemoryCustomStrategyStore } from "./custom.js";
-import { compileStrategySource, validateCustomStrategy, validateSignalSequence } from "./validate.js";
-import { getScreenerById, screenerParadigms } from "./screeners/index.js";
+import { compileStrategySource, validateCustomScreener, validateCustomStrategy, validateSignalSequence } from "./validate.js";
 import { donchianBreakoutStrategy } from "./paradigms/donchian-breakout.js";
 import { rsiReversionStrategy } from "./paradigms/rsi-reversion.js";
 import { emaCrossoverStrategy } from "./paradigms/ema-crossover.js";
@@ -9,4 +9,9 @@ import { bollingerReversionStrategy } from "./paradigms/bollinger-reversion.js";
 import { smaBaselineStrategy } from "./paradigms/sma-baseline.js";
 import { momentum12mStrategy } from "./paradigms/momentum-12m.js";
 import { getStrategyById, strategyParadigms } from "./paradigms/index.js";
-export { bollingerReversionStrategy, compileStrategySource, createMemoryCustomStrategyStore, donchianBreakoutStrategy, emaCrossoverStrategy, getScreenerById, getStrategyById, momentum12mStrategy, rsiReversionStrategy, run, screenerParadigms, smaBaselineStrategy, strategyParadigms, validateCustomStrategy, validateSignalSequence };
+import { getScreenerById, screenerParadigms } from "./screeners/index.js";
+import { BUILTIN_SCREENER_IDS, BUILTIN_STRATEGY_IDS, applyScreenerManagement, applyStrategyManagement, builtinScreenerRecord, builtinScreenerSource, builtinStrategyRecord, builtinStrategySource, isBuiltinScreenerId, isBuiltinStrategyId } from "./management.js";
+import { createMemoryBuiltinTombstonesStore } from "./builtin-tombstones.js";
+import { createMemoryCustomScreenerStore } from "./custom-screener.js";
+import { workerComputeRunner } from "@dshtrading/indicators";
+export { BUILTIN_SCREENER_IDS, BUILTIN_STRATEGY_IDS, applyScreenerManagement, applyStrategyManagement, bollingerReversionStrategy, builtinScreenerRecord, builtinScreenerSource, builtinStrategyRecord, builtinStrategySource, compileStrategySource, createMemoryBuiltinTombstonesStore, createMemoryCustomScreenerStore, createMemoryCustomStrategyStore, donchianBreakoutStrategy, emaCrossoverStrategy, fmtPrice, getScreenerById, getStrategyById, isBuiltinScreenerId, isBuiltinStrategyId, momentum12mStrategy, priceDigits, rsiReversionStrategy, run, screenerParadigms, smaBaselineStrategy, strategyParadigms, validateCustomScreener, validateCustomStrategy, validateSignalSequence, workerComputeRunner };

package/lib/management.d.ts

@@ -0,0 +1,46 @@
+import { StrategyDefinition } from "./types.js";
+import { CustomStrategyRecord } from "./custom.js";
+import { ScreenerDefinition } from "./screeners/types.js";
+import { CustomScreenerRecord } from "./custom-screener.js";
+//#region src/management.d.ts
+/** 内置范式策略 id 集合（稳定词汇；选股器 id 带 'scr.' 前缀，不在此列）。 */
+declare const BUILTIN_STRATEGY_IDS: ReadonlySet<string>;
+/** 内置选股器 id 集合（'scr.' 前缀词汇）。 */
+declare const BUILTIN_SCREENER_IDS: ReadonlySet<string>;
+declare function isBuiltinStrategyId(id: string): boolean;
+declare function isBuiltinScreenerId(id: string): boolean;
+/**
+ * 名册合成：内置 − 墓碑，覆盖记录原位替换同 id 内置，自定义按传入顺序追加。
+ * @param paradigms 出厂默认名册（生产传 strategyParadigms，单测可传定制名册）
+ * @param defs 自定义 store 校验后的定义（含覆盖内置的同 id 记录）
+ * @param deletedIds 墓碑 id（内置删除标记；命中者从名册剔除）
+ */
+declare function applyStrategyManagement(paradigms: readonly StrategyDefinition[], defs: readonly StrategyDefinition[], deletedIds: readonly string[]): StrategyDefinition[];
+/**
+ * 内置策略 compute 源码导出（GUI「编辑内置」预填用）。
+ *
+ * 前提：内置 compute 一律自包含（指标数学内联，不引用外部闭包），方法速记
+ * 形态 `compute(bars, params) { ... }` 归一为箭头形态 `(bars, params) => { ... }`
+ * ——后者是 compileStrategySource 直接接受的形状。打包器若改写为箭头/function
+ * 形态则原样透传（同样被 compileStrategySource 支持）。
+ */
+declare function builtinStrategySource(def: StrategyDefinition): string;
+/**
+ * 内置策略 → 可编辑记录预填（GUI 编辑器初值）。params 序列化保留 step，
+ * 让覆盖保存后参数步进与出厂一致（校验器接受合法 step）。
+ */
+declare function builtinStrategyRecord(def: StrategyDefinition): CustomStrategyRecord;
+/**
+ * 选股器名册合成（覆盖 + 墓碑，与 applyStrategyManagement 同模型）：
+ * 内置 − 墓碑，覆盖记录原位替换同 id 内置，自定义按传入顺序追加。
+ */
+declare function applyScreenerManagement(builtins: readonly ScreenerDefinition[], defs: readonly ScreenerDefinition[], deletedIds: readonly string[]): ScreenerDefinition[];
+/**
+ * 内置选股器 evaluate 源码导出（GUI「编辑内置」预填用），归一化规则同
+ * builtinStrategySource：方法速记 `evaluate(bars, params) { ... }` → 箭头形态。
+ */
+declare function builtinScreenerSource(def: ScreenerDefinition): string;
+/** 内置选股器 → 可编辑记录预填（columns 序列化保真）。 */
+declare function builtinScreenerRecord(def: ScreenerDefinition): CustomScreenerRecord;
+//#endregion
+export { BUILTIN_SCREENER_IDS, BUILTIN_STRATEGY_IDS, applyScreenerManagement, applyStrategyManagement, builtinScreenerRecord, builtinScreenerSource, builtinStrategyRecord, builtinStrategySource, isBuiltinScreenerId, isBuiltinStrategyId };

package/lib/management.js

@@ -0,0 +1,135 @@
+import { strategyParadigms } from "./paradigms/index.js";
+import { screenerParadigms } from "./screeners/index.js";
+//#region src/management.ts
+/**
+* 策略管理名册合成与内置源码导出（策略管理，2026-09-07）。
+*
+* 覆盖 + 墓碑模型的唯一合成逻辑：内置范式（代码常量）为出厂默认层，
+* 自定义 store 中同 id 的记录是覆盖层，墓碑表是删除层。agent 侧
+* （resolveStrategyDefinition）与 GUI 侧（StrategyView）共用本模块，
+* 保证两侧名册一致。纯函数、零 Node 依赖，浏览器安全。
+*/
+/** 内置范式策略 id 集合（稳定词汇；选股器 id 带 'scr.' 前缀，不在此列）。 */
+const BUILTIN_STRATEGY_IDS = new Set(strategyParadigms.map((d) => d.id));
+/** 内置选股器 id 集合（'scr.' 前缀词汇）。 */
+const BUILTIN_SCREENER_IDS = new Set(screenerParadigms.map((d) => d.id));
+function isBuiltinStrategyId(id) {
+	return BUILTIN_STRATEGY_IDS.has(id);
+}
+function isBuiltinScreenerId(id) {
+	return BUILTIN_SCREENER_IDS.has(id);
+}
+/**
+* 名册合成：内置 − 墓碑，覆盖记录原位替换同 id 内置，自定义按传入顺序追加。
+* @param paradigms 出厂默认名册（生产传 strategyParadigms，单测可传定制名册）
+* @param defs 自定义 store 校验后的定义（含覆盖内置的同 id 记录）
+* @param deletedIds 墓碑 id（内置删除标记；命中者从名册剔除）
+*/
+function applyStrategyManagement(paradigms, defs, deletedIds) {
+	const deleted = new Set(deletedIds);
+	const overrides = /* @__PURE__ */ new Map();
+	const customs = [];
+	for (const def of defs) if (BUILTIN_STRATEGY_IDS.has(def.id)) overrides.set(def.id, def);
+	else customs.push(def);
+	const roster = [];
+	for (const builtin of paradigms) {
+		if (deleted.has(builtin.id)) continue;
+		roster.push(overrides.get(builtin.id) ?? builtin);
+	}
+	return [...roster, ...customs];
+}
+/**
+* 内置策略 compute 源码导出（GUI「编辑内置」预填用）。
+*
+* 前提：内置 compute 一律自包含（指标数学内联，不引用外部闭包），方法速记
+* 形态 `compute(bars, params) { ... }` 归一为箭头形态 `(bars, params) => { ... }`
+* ——后者是 compileStrategySource 直接接受的形状。打包器若改写为箭头/function
+* 形态则原样透传（同样被 compileStrategySource 支持）。
+*/
+function builtinStrategySource(def) {
+	const raw = def.compute.toString().trim();
+	const method = raw.match(/^compute\s*\(([^)]*)\)\s*\{([\s\S]*)\}$/);
+	if (method !== null) return `(${method[1]}) => {${method[2]}}`;
+	return raw;
+}
+/**
+* 内置策略 → 可编辑记录预填（GUI 编辑器初值）。params 序列化保留 step，
+* 让覆盖保存后参数步进与出厂一致（校验器接受合法 step）。
+*/
+function builtinStrategyRecord(def) {
+	const params = def.params.map((p) => ({
+		key: p.key,
+		label: p.label,
+		default: p.default,
+		min: p.min,
+		max: p.max,
+		step: p.step
+	}));
+	return {
+		id: def.id,
+		title: def.name,
+		horizon: def.horizon,
+		summary: def.summary,
+		paramsJson: JSON.stringify(params),
+		computeSource: builtinStrategySource(def),
+		createdAt: Date.now()
+	};
+}
+/**
+* 选股器名册合成（覆盖 + 墓碑，与 applyStrategyManagement 同模型）：
+* 内置 − 墓碑，覆盖记录原位替换同 id 内置，自定义按传入顺序追加。
+*/
+function applyScreenerManagement(builtins, defs, deletedIds) {
+	const deleted = new Set(deletedIds);
+	const overrides = /* @__PURE__ */ new Map();
+	const customs = [];
+	for (const def of defs) if (BUILTIN_SCREENER_IDS.has(def.id)) overrides.set(def.id, def);
+	else customs.push(def);
+	const roster = [];
+	for (const builtin of builtins) {
+		if (deleted.has(builtin.id)) continue;
+		roster.push(overrides.get(builtin.id) ?? builtin);
+	}
+	return [...roster, ...customs];
+}
+/**
+* 内置选股器 evaluate 源码导出（GUI「编辑内置」预填用），归一化规则同
+* builtinStrategySource：方法速记 `evaluate(bars, params) { ... }` → 箭头形态。
+*/
+function builtinScreenerSource(def) {
+	const raw = def.evaluate.toString().trim();
+	const method = raw.match(/^evaluate\s*\(([^)]*)\)\s*\{([\s\S]*)\}$/);
+	if (method !== null) return `(${method[1]}) => {${method[2]}}`;
+	return raw;
+}
+/** 内置选股器 → 可编辑记录预填（columns 序列化保真）。 */
+function builtinScreenerRecord(def) {
+	const params = def.params.map((p) => ({
+		key: p.key,
+		label: p.label,
+		default: p.default,
+		min: p.min,
+		max: p.max,
+		step: p.step
+	}));
+	const columns = def.columns.map((c) => c.format === void 0 ? {
+		key: c.key,
+		label: c.label
+	} : {
+		key: c.key,
+		label: c.label,
+		format: c.format
+	});
+	return {
+		id: def.id,
+		title: def.name,
+		horizon: "swing",
+		summary: def.summary,
+		paramsJson: JSON.stringify(params),
+		columnsJson: JSON.stringify(columns),
+		evaluateSource: builtinScreenerSource(def),
+		createdAt: Date.now()
+	};
+}
+//#endregion
+export { BUILTIN_SCREENER_IDS, BUILTIN_STRATEGY_IDS, applyScreenerManagement, applyStrategyManagement, builtinScreenerRecord, builtinScreenerSource, builtinStrategyRecord, builtinStrategySource, isBuiltinScreenerId, isBuiltinStrategyId };

package/lib/paradigms/bollinger-reversion.js

@@ -1,11 +1,4 @@
-import { bollinger } from "@dshtrading/indicators";
 //#region src/paradigms/bollinger-reversion.ts
-/**
-* 布林带下轨均值回归策略（波段）。
-*
-* 入场：收盘价跌破布林线下轨（超卖错杀）。
-* 出场：收盘价回归至布林带中轨（均线目标位平仓）。
-*/
 const bollingerReversionStrategy = {
 	id: "bollinger-reversion",
 	horizon: "swing",
@@ -29,8 +22,47 @@ const bollingerReversionStrategy = {
 	compute(bars, params) {
 		const period = Math.max(5, Math.round(params.period ?? 20));
 		const k = Number(params.multiplier ?? 2);
+		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 stdevOf = (values, period) => {
+			const out = new Array(values.length).fill(void 0);
+			if (!Number.isFinite(period) || period < 1 || values.length < period) return out;
+			for (let index = period - 1; index < values.length; index++) {
+				let mean = 0;
+				for (let offset = 0; offset < period; offset++) mean += values[index - offset];
+				mean /= period;
+				let variance = 0;
+				for (let offset = 0; offset < period; offset++) {
+					const delta = values[index - offset] - mean;
+					variance += delta * delta;
+				}
+				out[index] = Math.sqrt(variance / period);
+			}
+			return out;
+		};
 		const closes = bars.map((b) => b.close);
-		const { mid, lower } = bollinger(closes, period, k);
+		const mid = smaOf(closes, period);
+		const sd = stdevOf(closes, period);
+		const lower = closes.map((_, index) => {
+			const base = mid[index];
+			const dev = sd[index];
+			return base === void 0 || dev === void 0 ? void 0 : base - k * dev;
+		});
 		const signals = [];
 		let inPosition = false;
 		for (let i = period - 1; i < bars.length; i++) {
@@ -45,11 +77,11 @@ const bollingerReversionStrategy = {
 					action: "entry",
 					direction: "long",
 					price: currentClose,
-					reason: `收盘价 (${currentClose.toFixed(2)}) 跌破布林下轨 (${currentLower.toFixed(2)})，触发波段均值回归`,
+					reason: `收盘价 (${fmtPrice(currentClose)}) 跌破布林下轨 (${fmtPrice(currentLower)})，触发波段均值回归`,
 					reasonKey: "strat.bollinger-reversion.reason.entry",
 					reasonParams: {
-						close: currentClose.toFixed(2),
-						band: currentLower.toFixed(2)
+						close: fmtPrice(currentClose),
+						band: fmtPrice(currentLower)
 					}
 				});
 				inPosition = true;
@@ -60,11 +92,11 @@ const bollingerReversionStrategy = {
 					action: "exit",
 					direction: "flat",
 					price: currentClose,
-					reason: `收盘价 (${currentClose.toFixed(2)}) 成功回归至布林中轨 (${currentMid.toFixed(2)})，完成目标止盈`,
+					reason: `收盘价 (${fmtPrice(currentClose)}) 成功回归至布林中轨 (${fmtPrice(currentMid)})，完成目标止盈`,
 					reasonKey: "strat.bollinger-reversion.reason.exit",
 					reasonParams: {
-						close: currentClose.toFixed(2),
-						mid: currentMid.toFixed(2)
+						close: fmtPrice(currentClose),
+						mid: fmtPrice(currentMid)
 					}
 				});
 				inPosition = false;