playbook/docs/tsl/syntax/index.md

TSL 语法入口

文档类型：检索页 是否可直接用于生成代码：否 是否含可直接照写示例：否 是否含不可照写反例：否 遇到不确定时：先按本文“按任务跳转”做语法层分流；写最短骨架看 01_quickstart.md，判断文件模型看 02_core_model.md，判断表达式看 06_expressions_and_operators.md，判断类/对象看 08_objects_and_classes.md，核对反例和负向边界看 11_pitfalls.md；如果问题已经超出语法层，回到 TSL 总入口 ../index.md。

本页只做语法层路由。生成代码时不要顺序读完整套语法文档；先判断任务命中哪一类，再进入最小专题页。

元数据与代码块身份

• 页头 是否可直接用于生成代码 只做页面级粗判断；落代码时以块级 代码块身份 为准。
• 代码块身份 固定只用四种值：可直接照写示例、输出片段、反例 / 不可照写、配置片段 / 概念骨架。
• 普通语法专题页的 遇到不确定时 先按候选页继续判断，仍不命中再回本语法入口页；本页例外，必须先按“按任务跳转”分流。

智能体语法判断流程

1. 先判断文件模型；完整规则看 02_core_model.md。
2. 用户已给 .tsl / .tsf 后缀时，后缀就是判断依据；未给后缀时，入口流程或一次性脚本初判为 .tsl，可复用交付物初判为 .tsf。
3. 文件模型会影响正确性且目标不明确时，先向用户确认。
4. 识别关键词属于值/变量、函数、类、unit、表达式、控制流、运行时、TS-SQL 或进阶专题。
5. 只进入命中的最小页面；写代码前优先参考该页的可直接照写示例。
6. 命中反例或负向边界时，先看 11_pitfalls.md 和对应专题页；仍无结论时不要发明语法。

按任务跳转

任务	先读哪里
写最短骨架 / 语言核心事实	01_quickstart.md
判断 .tsl / .tsf、顶层语句区、声明区、文件模型	02_core_model.md
写值、数组、字符串、字符串编码边界	03_values_and_literals.md
写变量、常量、显式声明	04_variables_and_constants.md
写 function / procedure、参数、默认参数、命名参数、变参	05_functions_and_calls.md
写赋值、比较、条件表达式、较新表达式、运算符边界	06_expressions_and_operators.md
写条件、循环、异常控制	07_control_flow.md
写类、继承、property、静态字段、较新对象能力或类边界	08_objects_and_classes.md
写 unit / uses	09_units_and_scope.md
写运行时环境参数、sysParams[...]、with array(...)、网格调用或全局缓存	10_runtime_context_and_with.md
核对高频误写 / 反例 / 负向边界	11_pitfalls.md
写数组扩展、键表、集合运算、矩阵样数据	12_matrix_and_collections.md
写结果集过滤专题	13_resultset_and_filters.md
写 TS-SQL 专题	14_ts_sql.md
看调试与性能分析器专题	15_debug_and_profiler.md
看注释、条件编译、编译选项或词法边界	16_lexical_structure_and_compile_options.md
看显式类型、转换规则、复数	17_types_and_conversions.md
看 external、DLL 与多线程	18_external_calls_and_threads.md
看 namespace、Libpath、unit 运行时、查找路径	19_namespace_libpath_and_unit_runtime.md
看对象运行时、自省、反射、弱引用	20_object_runtime_and_introspection.md
看运行时内置对象	21_builtin_runtime_objects.md
看矩阵进阶专题	22_matrix_deep_dive.md
看 FMArray	23_fmarray.md
看对象算符重载或遍历重载	24_object_overloads_and_iteration.md

入口禁止项

• 不要跳过“智能体语法判断流程”和“按任务跳转”直接顺序读完整套。
• 不要把本入口页当成可直接生成代码的语法事实页。
• 不要从多个专题页拼接未写入文档的新骨架；生成前优先使用单页里的可直接照写示例。
• 不要把数据仓库函数查询、模块集成或项目执行问题留在语法层处理。

切换到别的层

• 数据仓库金融函数：见 ../reference/catalog/datawarehouse.md
• 模块 / 集成 / 互操作：见 ../modules/index.md
• 函数库查找：见 ../reference/index.md