csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

📝 docs(markdown): format tracked markdown and drop stale templates

Browse Source
This commit is contained in:
csh
2026-05-18 16:06:21 +08:00
parent 2325409f53
commit c1702a667a
16 changed files with 184 additions and 421 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/tsl/finance/index.md
+7 -7
View File
@@ -18,13 +18,13 @@
## 按任务跳转
| 当前任务 | 先读哪里 |
| --- | --- |
| 先判断是否该进入业务层 | [entry_decision.md](entry_decision.md)（决策页，不是代码页） |
| 理解市场数据上下文与运行场景 | [market_data_context.md](market_data_context.md) |
| 理解序列、指标、时序计算模型 | [series_and_indicator_model.md](series_and_indicator_model.md) |
| 写选股、信号、筛选表达模式 | [selection_and_signal_patterns.md](selection_and_signal_patterns.md) |
| 写回测对象、交易流程、结果读取 | [backtest_and_trade_flow.md](backtest_and_trade_flow.md) |
| 当前任务 | 先读哪里 |
| ------------------------------ | -------------------------------------------------------------------- |
| 先判断是否该进入业务层 | [entry_decision.md](entry_decision.md)（决策页，不是代码页） |
| 理解市场数据上下文与运行场景 | [market_data_context.md](market_data_context.md) |
| 理解序列、指标、时序计算模型 | [series_and_indicator_model.md](series_and_indicator_model.md) |
| 写选股、信号、筛选表达模式 | [selection_and_signal_patterns.md](selection_and_signal_patterns.md) |
| 写回测对象、交易流程、结果读取 | [backtest_and_trade_flow.md](backtest_and_trade_flow.md) |
## 切换到别的层
docs/tsl/index.md
+18 -18
View File
@@ -80,25 +80,25 @@
## 最短跳转
| 当前任务 | 先读哪里 |
| --- | --- |
| 我要系统入门 TSL | [syntax/index.md](syntax/index.md) |
| 我要先核对语言核心事实 | [syntax/02_quickstart.md](syntax/02_quickstart.md) |
| 我要写最短可运行骨架 | [syntax/02_quickstart.md](syntax/02_quickstart.md) |
| 我要判断“这句语法能不能写” | [syntax/index.md](syntax/index.md) |
| 我要核对较新写法 / 新能力并入 / 资料冲突 / 解释器版本边界 | [syntax/index.md](syntax/index.md)，再按主题跳到对应语法页 |
| 我要核对高频误写 / 反例 / 负向边界 | [syntax/12_pitfalls.md](syntax/12_pitfalls.md) |
| 我要知道正式语法手册现在还差什么 | [syntax/coverage_map.md](syntax/coverage_map.md) |
| 我要写金融指标 / 选股 / 回测 | [finance/index.md](finance/index.md) |
| 我要看模块 / 集成 / 互操作入口 | [modules/index.md](modules/index.md) |
| 当前任务 | 先读哪里 |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| 我要系统入门 TSL | [syntax/index.md](syntax/index.md) |
| 我要先核对语言核心事实 | [syntax/02_quickstart.md](syntax/02_quickstart.md) |
| 我要写最短可运行骨架 | [syntax/02_quickstart.md](syntax/02_quickstart.md) |
| 我要判断“这句语法能不能写” | [syntax/index.md](syntax/index.md) |
| 我要核对较新写法 / 新能力并入 / 资料冲突 / 解释器版本边界 | [syntax/index.md](syntax/index.md)，再按主题跳到对应语法页 |
| 我要核对高频误写 / 反例 / 负向边界 | [syntax/12_pitfalls.md](syntax/12_pitfalls.md) |
| 我要知道正式语法手册现在还差什么 | [syntax/coverage_map.md](syntax/coverage_map.md) |
| 我要写金融指标 / 选股 / 回测 | [finance/index.md](finance/index.md) |
| 我要看模块 / 集成 / 互操作入口 | [modules/index.md](modules/index.md) |
| 我要确认账户体系 / 真实接口 / 部署方式 / 脚本入口 / 环境变量 / CI / 验证命令 | 项目自身文档、`scripts/*` 入口脚本、CI 配置；当前项目已补齐时再看 [toolchain.md](toolchain.md) |
| 我要看回测框架模块 | [modules/tsbacktesting.md](modules/tsbacktesting.md) |
| 我要看 Python 互操作 | [modules/tsl_python_interop.md](modules/tsl_python_interop.md) |
| 我要看微信消息推送 | [modules/wechat_message.md](modules/wechat_message.md) |
| 我要看 Python API | [modules/pytsl_api.md](modules/pytsl_api.md) |
| 我要查函数库 | [reference/index.md](reference/index.md) |
| 当前项目已补齐工具链时，看工具链 / 项目执行辅证 | [toolchain.md](toolchain.md) |
| 我要避开高频误写 | [syntax/12_pitfalls.md](syntax/12_pitfalls.md) |
| 我要看回测框架模块 | [modules/tsbacktesting.md](modules/tsbacktesting.md) |
| 我要看 Python 互操作 | [modules/tsl_python_interop.md](modules/tsl_python_interop.md) |
| 我要看微信消息推送 | [modules/wechat_message.md](modules/wechat_message.md) |
| 我要看 Python API | [modules/pytsl_api.md](modules/pytsl_api.md) |
| 我要查函数库 | [reference/index.md](reference/index.md) |
| 当前项目已补齐工具链时，看工具链 / 项目执行辅证 | [toolchain.md](toolchain.md) |
| 我要避开高频误写 | [syntax/12_pitfalls.md](syntax/12_pitfalls.md) |
## 进入之后怎么读
docs/tsl/modules/index.md
+9 -9
View File
@@ -28,13 +28,13 @@
## 最短跳转
| 当前任务 | 先读哪里 |
| --- | --- |
| 我要看回测框架 | [tsbacktesting.md](tsbacktesting.md) |
| 我要看 Python 互操作 | [tsl_python_interop.md](tsl_python_interop.md) |
| 我要看微信消息推送 | [wechat_message.md](wechat_message.md) |
| 我要看 Python API | [pytsl_api.md](pytsl_api.md) |
| 当前任务 | 先读哪里 |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| 我要看回测框架 | [tsbacktesting.md](tsbacktesting.md) |
| 我要看 Python 互操作 | [tsl_python_interop.md](tsl_python_interop.md) |
| 我要看微信消息推送 | [wechat_message.md](wechat_message.md) |
| 我要看 Python API | [pytsl_api.md](pytsl_api.md) |
| 我要确认模块的真实接入参数 / 账号来源 / 部署依赖 / 脚本入口 | 项目自身文档、`scripts/*` 入口脚本、CI 配置；当前项目已补齐时再看 [../toolchain.md](../toolchain.md) |
| 我要回到业务主线 | [../finance/index.md](../finance/index.md) |
| 我要回到语法主线 | [../syntax/index.md](../syntax/index.md) |
| 我要查函数库 | [../reference/index.md](../reference/index.md) |
| 我要回到业务主线 | [../finance/index.md](../finance/index.md) |
| 我要回到语法主线 | [../syntax/index.md](../syntax/index.md) |
| 我要查函数库 | [../reference/index.md](../reference/index.md) |
docs/tsl/modules/tsl_python_interop.md
+5 -5
View File
@@ -17,11 +17,11 @@
## 怎么选路
| 场景 | 先选哪条路 | 最小前置条件 | 常见失败点 |
| --- | --- | --- | --- |
| Python 作为主控，远程执行或调用 TSL | Python 调 TSL | Python 环境、TSLPy 模块、可用连接方式（COM / 远程登录） | 位数不一致、环境变量没配好、服务器未登录 |
| TSL 脚本里需要调用现有 Python 代码 | TSL 调 Python | TSL 与 Python 位数一致、`PYTHONHOME` 等环境正确 | Python 环境未就绪、模块找不到、网格场景不支持 |
| 落地服务器侧长期提供 Python 能力 | 落地服务器开启 Python 服务 | 服务端环境、部署权限、可维护的脚本入口 | 服务端环境和本地环境不一致、依赖未部署、运行权限不足 |
| 场景 | 先选哪条路 | 最小前置条件 | 常见失败点 |
| ----------------------------------- | -------------------------- | ------------------------------------------------------- | ---------------------------------------------------- |
| Python 作为主控，远程执行或调用 TSL | Python 调 TSL | Python 环境、TSLPy 模块、可用连接方式（COM / 远程登录） | 位数不一致、环境变量没配好、服务器未登录 |
| TSL 脚本里需要调用现有 Python 代码 | TSL 调 Python | TSL 与 Python 位数一致、`PYTHONHOME` 等环境正确 | Python 环境未就绪、模块找不到、网格场景不支持 |
| 落地服务器侧长期提供 Python 能力 | 落地服务器开启 Python 服务 | 服务端环境、部署权限、可维护的脚本入口 | 服务端环境和本地环境不一致、依赖未部署、运行权限不足 |
## 结构索引
docs/tsl/reference/catalog/index.md
+12 -12
View File
@@ -11,18 +11,18 @@
## 模块目录
| 模块 | 分类页 | 范围 | 函数数 |
| --- | --- | --- | --- |
| 基础函数 | [base.md](base.md) | 字符串、数组、日期时间、类型转换与常用基础能力 | 574 |
| 数学函数 | [math.md](math.md) | 数值计算、统计分析、矩阵处理与数学算法 | 518 |
| 系统相关函数 | [system.md](system.md) | 数据类型、表达式调用、性能与运行时能力 | 57 |
| 资源访问函数 | [resource.md](resource.md) | 文件、数据库、网络与外部资源访问 | 136 |
| 平台函数 | [platform.md](platform.md) | 平台相关功能与系统接口 | 19 |
| 客户端函数 | [client.md](client.md) | 客户端交互、界面控制与前端协作能力 | 19 |
| 图形函数 | [graphics.md](graphics.md) | 图表、绘图与可视化相关函数 | 27 |
| 压缩和解压函数 | [compression.md](compression.md) | 压缩、解压与归档能力 | 5 |
| 信息摘要及编码 | [digest_encoding.md](digest_encoding.md) | 哈希、摘要、编码与转换能力 | 7 |
| 第三方交互函数 | [third_party.md](third_party.md) | 第三方库与外部程序交互能力 | 8 |
| 模块 | 分类页 | 范围 | 函数数 |
| -------------- | ---------------------------------------- | ---------------------------------------------- | ------ |
| 基础函数 | [base.md](base.md) | 字符串、数组、日期时间、类型转换与常用基础能力 | 574 |
| 数学函数 | [math.md](math.md) | 数值计算、统计分析、矩阵处理与数学算法 | 518 |
| 系统相关函数 | [system.md](system.md) | 数据类型、表达式调用、性能与运行时能力 | 57 |
| 资源访问函数 | [resource.md](resource.md) | 文件、数据库、网络与外部资源访问 | 136 |
| 平台函数 | [platform.md](platform.md) | 平台相关功能与系统接口 | 19 |
| 客户端函数 | [client.md](client.md) | 客户端交互、界面控制与前端协作能力 | 19 |
| 图形函数 | [graphics.md](graphics.md) | 图表、绘图与可视化相关函数 | 27 |
| 压缩和解压函数 | [compression.md](compression.md) | 压缩、解压与归档能力 | 5 |
| 信息摘要及编码 | [digest_encoding.md](digest_encoding.md) | 哈希、摘要、编码与转换能力 | 7 |
| 第三方交互函数 | [third_party.md](third_party.md) | 第三方库与外部程序交互能力 | 8 |
## 说明
docs/tsl/reference/index.md
+7 -7
View File
@@ -25,10 +25,10 @@
## 按任务跳转
| 当前任务 | 先读哪里 |
| --- | --- |
| 查函数库入口 | [catalog/index.md](catalog/index.md) |
| 直接按模块查函数 | [catalog/index.md](catalog/index.md) |
| 回到语法层 | [../syntax/index.md](../syntax/index.md) |
| 回到金融层 | [../finance/index.md](../finance/index.md) |
| 回到模块层 | [../modules/index.md](../modules/index.md) |
| 当前任务 | 先读哪里 |
| ---------------- | ------------------------------------------ |
| 查函数库入口 | [catalog/index.md](catalog/index.md) |
| 直接按模块查函数 | [catalog/index.md](catalog/index.md) |
| 回到语法层 | [../syntax/index.md](../syntax/index.md) |
| 回到金融层 | [../finance/index.md](../finance/index.md) |
| 回到模块层 | [../modules/index.md](../modules/index.md) |
docs/tsl/syntax/02_quickstart.md
+7 -7
View File
@@ -30,16 +30,16 @@
## 术语对照
- 文档里出现的“顶层 `function / procedure`”“顶层函数骨架”“顶层函数定义体”，指的是同一类顶层模型：文件以顶层 `function` / `procedure` 为主体。
- 文档里出现的 ``class function`` 和“类方法”，指的是同一件事：前者是代码关键字写法，后者是中文描述。
- 文档里出现的 `class function` 和“类方法”，指的是同一件事：前者是代码关键字写法，后者是中文描述。
## 先选哪一种骨架
| 当前任务 | 起手骨架 |
| --- | --- |
| 只写一段一次性脚本逻辑 | 顶层松散语句 |
| 先沉淀一个可复用逻辑块 | 顶层 `function` |
| 需要对象状态、字段、方法 | `type Name = class` |
| 需要把接口和实现组织进一个模块 | `unit` |
| 当前任务 | 起手骨架 |
| ------------------------------ | ------------------- |
| 只写一段一次性脚本逻辑 | 顶层松散语句 |
| 先沉淀一个可复用逻辑块 | 顶层 `function` |
| 需要对象状态、字段、方法 | `type Name = class` |
| 需要把接口和实现组织进一个模块 | `unit` |
默认建议：
docs/tsl/syntax/coverage_map.md
+10 -10
View File
@@ -16,16 +16,16 @@
## 8 章吸收总表
| 旧章节 | 主线页 | 专题页 | 说明 |
| --- | --- | --- | --- |
| `01_language_basics.md` | [01_introduction.md](01_introduction.md), [03_core_model.md](03_core_model.md), [04_values_and_literals.md](04_values_and_literals.md), [05_variables_and_constants.md](05_variables_and_constants.md), [07_expressions_and_operators.md](07_expressions_and_operators.md), [11_runtime_context_and_with.md](11_runtime_context_and_with.md), [13_matrix_and_collections.md](13_matrix_and_collections.md) | [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md), [19_types_and_conversions.md](19_types_and_conversions.md), [20_strings_and_text.md](20_strings_and_text.md) | 语言基础主干在主线，词法 / 类型 / 字符串边界放进深水专题 |
| `02_control_flow.md` | [08_control_flow.md](08_control_flow.md) | [16_debug_and_profiler.md](16_debug_and_profiler.md) | 控制流在主线，调试与 profiler 单列专题 |
| `03_functions.md` | [06_functions_and_calls.md](06_functions_and_calls.md) | [21_external_calls_and_threads.md](21_external_calls_and_threads.md) | 普通函数在主线，`external` / 动态库 / 线程放进专题 |
| `04_modules_and_namespace.md` | [10_units_and_scope.md](10_units_and_scope.md) | [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) | `unit` / `uses` 在主线，运行时查找路径与 `Libpath` 放进专题 |
| `05_object_model.md` | [09_objects_and_classes.md](09_objects_and_classes.md) | [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md), [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md), [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 类基础语法在主线，运行时 / 内置对象 / 重载能力拆到专题 |
| `06_extended_syntax.md` | [13_matrix_and_collections.md](13_matrix_and_collections.md), [14_resultset_and_filters.md](14_resultset_and_filters.md), [15_ts_sql.md](15_ts_sql.md) | [25_set_operations.md](25_set_operations.md), [26_matrix_deep_dive.md](26_matrix_deep_dive.md), [27_fmarray.md](27_fmarray.md), [28_ts_sql_core.md](28_ts_sql_core.md), [29_ts_sql_advanced.md](29_ts_sql_advanced.md) | 主线先建立数组 / 结果集 / TS-SQL 入口，集合 / 矩阵 / FMArray / TS-SQL 深水内容进入专题 |
| `07_debug_and_profiler.md` | [16_debug_and_profiler.md](16_debug_and_profiler.md) | [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) | 调试入口在主线，运行时服务与全局缓存单列专题 |
| `08_new_generation.md` | [07_expressions_and_operators.md](07_expressions_and_operators.md), [09_objects_and_classes.md](09_objects_and_classes.md) | [31_complex_and_weakref.md](31_complex_and_weakref.md), [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 较新语法相关内容已分散吸收到表达式 / 对象主线，复数 / 弱引用 / 对象重载保留在专题 |
| 旧章节 | 主线页 | 专题页 | 说明 |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
| `01_language_basics.md` | [01_introduction.md](01_introduction.md), [03_core_model.md](03_core_model.md), [04_values_and_literals.md](04_values_and_literals.md), [05_variables_and_constants.md](05_variables_and_constants.md), [07_expressions_and_operators.md](07_expressions_and_operators.md), [11_runtime_context_and_with.md](11_runtime_context_and_with.md), [13_matrix_and_collections.md](13_matrix_and_collections.md) | [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md), [19_types_and_conversions.md](19_types_and_conversions.md), [20_strings_and_text.md](20_strings_and_text.md) | 语言基础主干在主线，词法 / 类型 / 字符串边界放进深水专题 |
| `02_control_flow.md` | [08_control_flow.md](08_control_flow.md) | [16_debug_and_profiler.md](16_debug_and_profiler.md) | 控制流在主线，调试与 profiler 单列专题 |
| `03_functions.md` | [06_functions_and_calls.md](06_functions_and_calls.md) | [21_external_calls_and_threads.md](21_external_calls_and_threads.md) | 普通函数在主线，`external` / 动态库 / 线程放进专题 |
| `04_modules_and_namespace.md` | [10_units_and_scope.md](10_units_and_scope.md) | [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) | `unit` / `uses` 在主线，运行时查找路径与 `Libpath` 放进专题 |
| `05_object_model.md` | [09_objects_and_classes.md](09_objects_and_classes.md) | [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md), [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md), [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 类基础语法在主线，运行时 / 内置对象 / 重载能力拆到专题 |
| `06_extended_syntax.md` | [13_matrix_and_collections.md](13_matrix_and_collections.md), [14_resultset_and_filters.md](14_resultset_and_filters.md), [15_ts_sql.md](15_ts_sql.md) | [25_set_operations.md](25_set_operations.md), [26_matrix_deep_dive.md](26_matrix_deep_dive.md), [27_fmarray.md](27_fmarray.md), [28_ts_sql_core.md](28_ts_sql_core.md), [29_ts_sql_advanced.md](29_ts_sql_advanced.md) | 主线先建立数组 / 结果集 / TS-SQL 入口，集合 / 矩阵 / FMArray / TS-SQL 深水内容进入专题 |
| `07_debug_and_profiler.md` | [16_debug_and_profiler.md](16_debug_and_profiler.md) | [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) | 调试入口在主线，运行时服务与全局缓存单列专题 |
| `08_new_generation.md` | [07_expressions_and_operators.md](07_expressions_and_operators.md), [09_objects_and_classes.md](09_objects_and_classes.md) | [31_complex_and_weakref.md](31_complex_and_weakref.md), [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 较新语法相关内容已分散吸收到表达式 / 对象主线，复数 / 弱引用 / 对象重载保留在专题 |
## 读取原则
docs/tsl/syntax/index.md
+57 -57
View File
@@ -50,7 +50,7 @@
14. [14_resultset_and_filters.md](14_resultset_and_filters.md)
15. [15_ts_sql.md](15_ts_sql.md)
16. [16_debug_and_profiler.md](16_debug_and_profiler.md)
这条顺序对应“先建立整体读法，再写值、变量、函数、表达式、流程，随后进入类、unit、运行时边界，再按需进入进阶专题”。
这条顺序对应“先建立整体读法，再写值、变量、函数、表达式、流程，随后进入类、unit、运行时边界，再按需进入进阶专题”。
编号说明：主线 `01-16`，深水 `18-32`，无 `17` 号正文页；历史 `17` 号位保留为空。
@@ -58,67 +58,67 @@
以下专题默认不要预读。只有主线页不够、或者任务已经明确命中对应场景时，再进入。
| 专题 | 什么时候进入 |
| --- | --- |
| [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md) | 只有涉及注释规则、条件编译、编译选项或词法边界时才读 |
| [19_types_and_conversions.md](19_types_and_conversions.md) | 只有涉及显式类型、转换规则或类型兼容问题时才读 |
| [20_strings_and_text.md](20_strings_and_text.md) | 只有涉及字符串处理、编码或文本细节时才读 |
| [21_external_calls_and_threads.md](21_external_calls_and_threads.md) | 只有涉及 `external`、DLL、线程或外部调用时才读 |
| [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) | 只有涉及 `namespace`、`Libpath`、unit 运行时或查找路径时才读 |
| [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md) | 只有涉及对象运行时、自省或反射能力时才读 |
| [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md) | 只有涉及内置运行时对象时才读 |
| [25_set_operations.md](25_set_operations.md) | 只有涉及集合运算专题时才读 |
| [26_matrix_deep_dive.md](26_matrix_deep_dive.md) | 只有涉及矩阵运算且 [13_matrix_and_collections.md](13_matrix_and_collections.md) 不够用时才读 |
| [27_fmarray.md](27_fmarray.md) | 只有涉及 `FMArray` 专题时才读 |
| [28_ts_sql_core.md](28_ts_sql_core.md) | 只有开始写 TS-SQL 核心语法时才读 |
| [29_ts_sql_advanced.md](29_ts_sql_advanced.md) | 只有 TS-SQL 基础页不够、问题进入进阶能力时才读 |
| [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) | 只有涉及网格计算、运行时服务或全局缓存时才读 |
| [31_complex_and_weakref.md](31_complex_and_weakref.md) | 只有涉及复数或弱引用时才读 |
| [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 只有涉及对象算符重载或遍历重载时才读 |
| 专题 | 什么时候进入 |
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md) | 只有涉及注释规则、条件编译、编译选项或词法边界时才读 |
| [19_types_and_conversions.md](19_types_and_conversions.md) | 只有涉及显式类型、转换规则或类型兼容问题时才读 |
| [20_strings_and_text.md](20_strings_and_text.md) | 只有涉及字符串处理、编码或文本细节时才读 |
| [21_external_calls_and_threads.md](21_external_calls_and_threads.md) | 只有涉及 `external`、DLL、线程或外部调用时才读 |
| [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) | 只有涉及 `namespace`、`Libpath`、unit 运行时或查找路径时才读 |
| [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md) | 只有涉及对象运行时、自省或反射能力时才读 |
| [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md) | 只有涉及内置运行时对象时才读 |
| [25_set_operations.md](25_set_operations.md) | 只有涉及集合运算专题时才读 |
| [26_matrix_deep_dive.md](26_matrix_deep_dive.md) | 只有涉及矩阵运算且 [13_matrix_and_collections.md](13_matrix_and_collections.md) 不够用时才读 |
| [27_fmarray.md](27_fmarray.md) | 只有涉及 `FMArray` 专题时才读 |
| [28_ts_sql_core.md](28_ts_sql_core.md) | 只有开始写 TS-SQL 核心语法时才读 |
| [29_ts_sql_advanced.md](29_ts_sql_advanced.md) | 只有 TS-SQL 基础页不够、问题进入进阶能力时才读 |
| [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) | 只有涉及网格计算、运行时服务或全局缓存时才读 |
| [31_complex_and_weakref.md](31_complex_and_weakref.md) | 只有涉及复数或弱引用时才读 |
| [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) | 只有涉及对象算符重载或遍历重载时才读 |
这组页面承担旧 8 章里没有被主线正文完整吃掉的深水内容，目标是让新 session 只靠 `docs/tsl/syntax/` 就能覆盖旧语法章节，但默认首跳仍应先走主线页。
## 按任务跳转
| 当前任务 | 先读哪里 |
| --- | --- |
| 先建立整体读法 | [01_introduction.md](01_introduction.md) |
| 写最短骨架 | [02_quickstart.md](02_quickstart.md) |
| 判断顶层模型 / 文件模型 | [03_core_model.md](03_core_model.md) |
| 写值、数组、字符串 | [04_values_and_literals.md](04_values_and_literals.md) |
| 写变量、常量、显式声明 | [05_variables_and_constants.md](05_variables_and_constants.md) |
| 写 `function` / `procedure`、参数修饰、默认参数、命名参数、变参、`external` | [06_functions_and_calls.md](06_functions_and_calls.md) |
| 写赋值、比较、`if` 表达式 | [07_expressions_and_operators.md](07_expressions_and_operators.md) |
| 写 `?.` 等较新表达式 | [07_expressions_and_operators.md](07_expressions_and_operators.md) |
| 写条件、循环、异常控制 | [08_control_flow.md](08_control_flow.md) |
| 写类、继承、property、静态字段 | [09_objects_and_classes.md](09_objects_and_classes.md) |
| 写 `unit` / `uses` | [10_units_and_scope.md](10_units_and_scope.md) |
| 写运行时环境参数、`SysParams[...]`、`#Func() with array(...)` | [11_runtime_context_and_with.md](11_runtime_context_and_with.md) |
| 先避开高频误写 | [12_pitfalls.md](12_pitfalls.md) |
| 写数组扩展、键表、矩阵样数据 | [13_matrix_and_collections.md](13_matrix_and_collections.md) |
| 写结果集过滤专题 | [14_resultset_and_filters.md](14_resultset_and_filters.md) |
| 写 TS-SQL 专题 | [15_ts_sql.md](15_ts_sql.md) |
| 看调试与 profiler 专题 | [16_debug_and_profiler.md](16_debug_and_profiler.md) |
| 看词法、注释、编译选项 | [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md) |
| 看类型与转换 | [19_types_and_conversions.md](19_types_and_conversions.md) |
| 看字符串与编码专题 | [20_strings_and_text.md](20_strings_and_text.md) |
| 看 `external`、DLL 与多线程 | [21_external_calls_and_threads.md](21_external_calls_and_threads.md) |
| 看 `namespace`、单元运行时、`Libpath`、查找路径 | [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) |
| 看对象运行时和反射 | [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md) |
| 看运行时内置对象 | [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md) |
| 看集合运算 | [25_set_operations.md](25_set_operations.md) |
| 看矩阵深水专题 | [26_matrix_deep_dive.md](26_matrix_deep_dive.md) |
| 看 `FMArray` | [27_fmarray.md](27_fmarray.md) |
| 看 TS-SQL 基础 | [28_ts_sql_core.md](28_ts_sql_core.md) |
| 看 TS-SQL 进阶 | [29_ts_sql_advanced.md](29_ts_sql_advanced.md) |
| 看网格计算与全局缓存 | [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) |
| 看复数与弱引用 | [31_complex_and_weakref.md](31_complex_and_weakref.md) |
| 看对象算符与遍历重载 | [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) |
| 看较新表达式或表达式边界 | [07_expressions_and_operators.md](07_expressions_and_operators.md) |
| 看较新对象能力或类边界 | [09_objects_and_classes.md](09_objects_and_classes.md) |
| 看资料冲突 / 解释器差异 | 先留在当前页，对照上面的主线与深水进入条件后，再按主题进入相应页面 |
| 看高频误写 / 反例 / 负向边界 | [12_pitfalls.md](12_pitfalls.md) |
| 看正式语法手册当前覆盖范围与成熟度 | [coverage_map.md](coverage_map.md) |
| 当前任务 | 先读哪里 |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| 先建立整体读法 | [01_introduction.md](01_introduction.md) |
| 写最短骨架 | [02_quickstart.md](02_quickstart.md) |
| 判断顶层模型 / 文件模型 | [03_core_model.md](03_core_model.md) |
| 写值、数组、字符串 | [04_values_and_literals.md](04_values_and_literals.md) |
| 写变量、常量、显式声明 | [05_variables_and_constants.md](05_variables_and_constants.md) |
| 写 `function` / `procedure`、参数修饰、默认参数、命名参数、变参、`external` | [06_functions_and_calls.md](06_functions_and_calls.md) |
| 写赋值、比较、`if` 表达式 | [07_expressions_and_operators.md](07_expressions_and_operators.md) |
| 写 `?.` 等较新表达式 | [07_expressions_and_operators.md](07_expressions_and_operators.md) |
| 写条件、循环、异常控制 | [08_control_flow.md](08_control_flow.md) |
| 写类、继承、property、静态字段 | [09_objects_and_classes.md](09_objects_and_classes.md) |
| 写 `unit` / `uses` | [10_units_and_scope.md](10_units_and_scope.md) |
| 写运行时环境参数、`SysParams[...]`、`#Func() with array(...)` | [11_runtime_context_and_with.md](11_runtime_context_and_with.md) |
| 先避开高频误写 | [12_pitfalls.md](12_pitfalls.md) |
| 写数组扩展、键表、矩阵样数据 | [13_matrix_and_collections.md](13_matrix_and_collections.md) |
| 写结果集过滤专题 | [14_resultset_and_filters.md](14_resultset_and_filters.md) |
| 写 TS-SQL 专题 | [15_ts_sql.md](15_ts_sql.md) |
| 看调试与 profiler 专题 | [16_debug_and_profiler.md](16_debug_and_profiler.md) |
| 看词法、注释、编译选项 | [18_lexical_structure_and_compile_options.md](18_lexical_structure_and_compile_options.md) |
| 看类型与转换 | [19_types_and_conversions.md](19_types_and_conversions.md) |
| 看字符串与编码专题 | [20_strings_and_text.md](20_strings_and_text.md) |
| 看 `external`、DLL 与多线程 | [21_external_calls_and_threads.md](21_external_calls_and_threads.md) |
| 看 `namespace`、单元运行时、`Libpath`、查找路径 | [22_namespace_libpath_and_unit_runtime.md](22_namespace_libpath_and_unit_runtime.md) |
| 看对象运行时和反射 | [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md) |
| 看运行时内置对象 | [24_builtin_runtime_objects.md](24_builtin_runtime_objects.md) |
| 看集合运算 | [25_set_operations.md](25_set_operations.md) |
| 看矩阵深水专题 | [26_matrix_deep_dive.md](26_matrix_deep_dive.md) |
| 看 `FMArray` | [27_fmarray.md](27_fmarray.md) |
| 看 TS-SQL 基础 | [28_ts_sql_core.md](28_ts_sql_core.md) |
| 看 TS-SQL 进阶 | [29_ts_sql_advanced.md](29_ts_sql_advanced.md) |
| 看网格计算与全局缓存 | [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md) |
| 看复数与弱引用 | [31_complex_and_weakref.md](31_complex_and_weakref.md) |
| 看对象算符与遍历重载 | [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md) |
| 看较新表达式或表达式边界 | [07_expressions_and_operators.md](07_expressions_and_operators.md) |
| 看较新对象能力或类边界 | [09_objects_and_classes.md](09_objects_and_classes.md) |
| 看资料冲突 / 解释器差异 | 先留在当前页，对照上面的主线与深水进入条件后，再按主题进入相应页面 |
| 看高频误写 / 反例 / 负向边界 | [12_pitfalls.md](12_pitfalls.md) |
| 看正式语法手册当前覆盖范围与成熟度 | [coverage_map.md](coverage_map.md) |
## 旧 8 章在正式手册中的落点