playbook/docs/tsl/index.md

3.7 KiB

TSL 文档入口

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

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

按任务跳转

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

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

证据规则

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

停止条件

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