# TSL 文档入口

文档类型：跨层路由页
是否可直接用于生成代码：否
是否含可直接照写示例：否
是否含不可照写反例：否
遇到不确定时：先按“按任务跳转”分层；语法问题看 [syntax/index.md](syntax/index.md)，命名问题看 [naming.md](naming.md)，函数库查询看 [reference/index.md](reference/index.md)，模块 / 集成看 [modules/index.md](modules/index.md)，项目执行问题回项目自身文档、`scripts/*` 入口脚本和 CI 配置

本页只决定第一跳。不要在这里生成代码，不要通读全部 TSL 文档，不要用相似语言补全 TSL 事实。

## 按任务跳转

| 任务信号                                          | 入口                                                                     | 阻断条件                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------ |
| 写最短可运行骨架、核对语言核心事实                | [syntax/01_quickstart.md](syntax/01_quickstart.md)                       | `.tsl` / `.tsf` 文件模型不明               |
| 判断语法能不能写、查语言写法                      | [syntax/index.md](syntax/index.md)                                       | 没有命中具体语法专题                       |
| 给变量、函数、类型、unit 或 `.tsf` 文件取名        | [naming.md](naming.md)                                                   | 文件模型或顶层声明规则不明                 |
| 核对高频误写、反例、负向边界                      | [syntax/11_pitfalls.md](syntax/11_pitfalls.md)                           | 反例没有指向正确专题                       |
| 查行情、财务、板块、选股等金融函数                | [reference/catalog/datawarehouse.md](reference/catalog/datawarehouse.md) | 没有命中带参数表的函数事实条目             |
| 查通用函数库函数名、参数、返回值                  | [reference/index.md](reference/index.md)                                 | catalog 没有正式函数条目                   |
| 用 Python 调 TSL、调用服务器函数、批量或异步取数  | [modules/pytsl_api.md](modules/pytsl_api.md)                             | 真实账号、服务地址、业务字段来自项目上下文 |
| 写回测框架、组合回测、读取回测结果                | [modules/tsbacktesting.md](modules/tsbacktesting.md)                     | 策略信号、证券池、资金参数缺失             |
| 看模块、集成、互操作入口                          | [modules/index.md](modules/index.md)                                     | 模块 API 与项目执行边界不清                |
| 确认账户、真实接口、部署、脚本入口、环境变量或 CI | 项目自身文档、`scripts/*` 入口脚本、CI 配置                              | 只有通用 TSL 文档，没有项目事实            |

项目执行事实条件：只有目标项目已真实填写且没有 `<...>` 占位符的 [toolchain.md](toolchain.md) 才可作为执行依据。

## 证据规则

- 页头元数据只做页面级粗判断；生成代码时以块级 `代码块身份` 为准。
- `可直接照写示例` 用于代码外形、语句顺序和块级结构。
- `输出片段` 只表示结果或错误形态。
- `反例 / 不可照写` 只用于避开错法，不反推新语法。
- `配置片段 / 概念骨架` 只表示结构提示，不代表可运行源码。
- 语法页不承载执行环境、账户体系、真实接口或验证命令。

## 停止条件

- 代码外形缺少 `代码块身份：可直接照写示例`。
- 无文档事实、文件模型不明或项目执行事实缺失。
- 需要复制反例、输出片段或概念骨架才能完成。
- 需要凭 Pascal、Python、JavaScript、TypeScript 或 SQL 直觉补语法。
- 项目执行信息会被写成通用 TSL 事实。
