trading-sim-engine

A 股交易模拟执行器——纯计算、零依赖、零 I/O 的 TypeScript 引擎。 自 trading-logic 拆出（git filter-repo，历史完整）。

它是什么

给定一段 K 线序列和初始资金，模拟「在真实市场里下单会发生什么」： 撮合时点（信号棒收盘决策 → 次日开盘成交）、滑点与最小价差、佣金 印花税、T+1、手数、涨跌停/停牌闸门、做空与保证金、风控强平、 光标推进、有序事件流与账户投影。

它不是：策略框架（不识别形态）、训练器（不管脱敏/呈现）、 行情源（K 线由调用方注入）。

用法

import { Engine } from 'trading-sim-engine';

const e = new Engine({ bars, symbol: 'X.SH', startIdx: 0, endIdx: n, capital: 1e5 });
e.seek(20);
e.buy({ pct: 0.5, stopLoss: -0.05 });   // 风控参数平铺，见 BuyOptions
e.hold();
const result = e.settle();

完整语义见源码仓 contracts/semantics.md（R1-R45 + I1-I8）； HTTP 服务化形状见 contracts/openapi.yaml（均未随包分发）。

测试

npm test            # 引擎套件：规则断言 + 不变量 + 黄金指纹 + 模块守卫
npm run typecheck
npm run lint:md

黄金快照是漂移探测器：npm run golden:update 只在行为变更有意时跑， diff 本身就是变更审计单。