📝 docs(tsl): rebuild canonical syntax and routing manual

docs/tsl/modules/tsbacktesting.md

@@ -1,66 +1,53 @@
 # 策略回测框架 TSBackTesting
 
-## 定位
+文档类型：模块摘要
+是否可直接用于生成代码：否
+是否含已验证可执行示例：否
+是否含已验证反例：否
+遇到不确定时跳转到：项目实际接口定义、[../finance/backtest_and_trade_flow.md](../finance/backtest_and_trade_flow.md)、[index.md](index.md)
 
-- 提供统一的策略回测框架（股票/期货/期权/组合等），覆盖资金、交易约束、清算与绩效输出。
+本页不足以直接生成回测代码，只用于确认回测任务的组织顺序，以及哪些地方必须回到项目实际接口定义继续核对。
 
-## 结构索引
+- 只要任务已经进入对象创建、交易输入入口、结果读取方法或项目封装差异，就先停止生成，直接回项目实际接口定义，不要先拼调用链。
 
-- 策略回测流程
-- 成员变量
-- 成员方法
-- 查询用接口
-- 回测范例
-- 债券品种回测说明
-- 期权组合策略回测说明
-- 常见问题
+## 适用场景
 
-## 回测流程概览
+- 任务已经进入“回测框架怎么配置、怎么执行、怎么读结果”。
+- 你处理的是组合型任务，而不是单纯的表达式或单次筛选。
+- 你已经知道自己要做比例类组合还是数量类组合，或者正在先判断这件事。
 
-- 组合类型选择 → 交易数据准备 → 回测执行 → 结果查询与分析。
+## 当前只确认的范围
 
-## 组合类型
+- 当前页已经确认的范围是：对象名 `TSBackTesting`、典型任务顺序、组合类型差异、常见字段组和常见结果接口类别。
+- 下面出现的字段名和结果接口名，只用于检索候选和理解类别，不是可以直接假定存在的项目接口真值。
+- 任务顺序可以先按这条主线理解：组合类型选择 → 交易数据准备 → 回测执行 → 结果查询与分析。
+- 组合类型先按两类理解：比例类组合提供目标权重，数量类组合提供成交量或成交价等交易明细。
+- 常见字段组可以先按以下几类检索：
+  - 时间与周期：`FBegT`、`FEndT`、`FCycle`
+  - 组合类型：`FGroupType`
+  - 资金与价格：`FIniCash`、`FPriceType`、`FPriceType1..4`
+  - 交易约束：`FNoZT`、`FNoDT`、`FMinVol`、`FMinAmount`、`FMaxVolPercent`、`FMaxAmountPercent`
+  - 费用与分红：`FFeeType`、`FlowestFeeType`、`FDividendType`
+  - 基准与输出：`FBMType`、`FBMDetail`、`FBMOption`、`FHFDataOutPut`
+- 常见结果接口可以先按以下类别检索：`GetTimeSeries`、`GetTradeOrder`、`GetNetAssetValue` / `GetAssetData` / `GetHoldData`、`GetPercent`、`GetIRRReturn`、`ReturnBenchmark`。
 
-- 比例类组合：提供目标权重。
-- 数量类组合：提供成交量/成交价等交易明细。
+## 任务骨架（非代码模板）
 
-## 关键成员变量（分组摘要）
+1. 先判断任务属于比例类组合还是数量类组合。
+2. 然后先回到项目实际接口定义，确认最小可用对象模型、对象创建方式、最小必填项和交易数据输入入口。
+3. 再确认起止时间、组合类型和初始资金是不是项目里的最小必填项。
+4. 执行回测。
+5. 最后先按项目实际接口定义确认结果读取链路，再读取净值时间序列、成交结果或持仓结果，再补看绩效指标。
 
-- **时间与周期**：`FBegT`、`FEndT`、`FCycle`
-- **组合类型**：`FGroupType`（比例类/数量类）
-- **资金与价格**：`FIniCash`、`FPriceType`、`FPriceType1..4`
-- **交易约束**：`FNoZT`、`FNoDT`、`FMinVol`、`FMinAmount`、`FMaxVolPercent`、`FMaxAmountPercent`
-- **费用与分红**：`FFeeType`、`FlowestFeeType`、`FDividendType`
-- **期权与期货特性**：`FOptionRs`、`FMainFutureMap`
-- **基准与输出**：`FBMType`、`FBMDetail`、`FBMOption`、`FHFDataOutPut`
+## 不要猜的部分
 
-> 详细取值及说明以实际接口定义为准。
+- 当前页没有确认的范围是：对象创建方式、最小必填字段的强制集合、交易数据入口名、最小输入结构、结果读取完整链路。
+- 如果没有项目实际接口定义，不要根据本页直接写 `new TSBackTesting()`、`SetTradeData(...)` 或其他具体调用链。
+- 各字段可选值和更细接口，以实际接口定义为准；当前页只负责告诉你要核对哪些位置，不负责补全细节。
 
-## 关键成员方法（常用）
+## 跳转指引
 
-- `BackTest`：执行回测
-- `GetTimeSeries`：返回净值/收益率时间序列
-- `GetTradeOrder`：返回调仓/成交数据
-- `GetNetAssetValue` / `GetAssetData` / `GetHoldData`：资产与持仓
-- `GetPercent`、`GetIRRReturn`、`ReturnBenchmark`：绩效指标
-- `GetClearancePrice` / `GetIntVol` / `GetOtherData`：扩展查询
-
-## 最小流程示例（概念化）
-
-```tsl
-// 1) 初始化参数
-backtest := new TSBackTesting();
-backtest.FBegT := 20240101T;
-backtest.FEndT := 20241231T;
-backtest.FGroupType := 1; // 比例类
-backtest.FIniCash := 1000000;
-
-// 2) 设置交易数据（比例类：目标持仓）
-// backtest.SetTradeData(trade_data);
-
-// 3) 执行回测
-backtest.BackTest();
-
-// 4) 获取结果
-return backtest.GetTimeSeries();
-```
+- 业务组织问题：见 [../finance/backtest_and_trade_flow.md](../finance/backtest_and_trade_flow.md)
+- 具体字段、交易数据入口、对象创建方式和结果接口真值：回项目实际接口定义
+- 回到模块入口：见 [index.md](index.md)
+- 只在需要查 TSL 通用函数归类时，才回 [../reference/index.md](../reference/index.md)