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

♻️ refactor(tsl): rebuild codegen taxonomy

Browse Source 
Move generated builtin and dotnet function docs into the upgraded taxonomy, remove legacy route pages, and regenerate function_index.tsv from markdown headings.
This commit is contained in:
csh
2026-07-07 16:36:08 +08:00
parent 54c1c11e77
commit b6160676b4
763 changed files with 179921 additions and 154583 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/tsl/index.md
+9 -36
View File
@@ -1,43 +1,16 @@
# 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 文档，没有项目事实 |
本表只做「任务 → 文档区」分流；区内细分交给各区 `index.md`。多行命中时，自上而下取第一个命中行。
项目执行事实条件：只有目标项目已真实填写且没有 `<...>` 占位符的 [toolchain.md](toolchain.md) 才可作为执行依据。
## 证据规则
- 页头元数据只做页面级粗判断；生成代码时以块级 `代码块身份` 为准。
- `可直接照写示例` 用于代码外形、语句顺序和块级结构。
- `输出片段` 只表示结果或错误形态。
- `反例 / 不可照写` 只用于避开错法，不反推新语法。
- `配置片段 / 概念骨架` 只表示结构提示，不代表可运行源码。
- 语法页不承载执行环境、账户体系、真实接口或验证命令。
## 停止条件
- 代码外形缺少 `代码块身份：可直接照写示例`。
- 无文档事实、文件模型不明或项目执行事实缺失。
- 需要复制反例、输出片段或概念骨架才能完成。
- 需要凭 Pascal、Python、JavaScript、TypeScript 或 SQL 直觉补语法。
- 项目执行信息会被写成通用 TSL 事实。
| 任务信号 | 入口 | 阻断条件 |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------- |
| 要生成或编写 TSL 代码、先定文件模型与起手骨架 | [syntax/01_quickstart.md](syntax/01_quickstart.md) | 不写代码，只查语法、函数或命名事实 |
| 取金融数据：行情、财务、板块、选股 | [codegen/dotnet/datawarehouse/index.md](codegen/dotnet/datawarehouse/index.md) | 不是取数，是语法或通用函数 |
| 查语法写法、语言规则、排查语法错误 | [syntax/index.md](syntax/index.md) | 要找的是函数，不是语法 |
| 命名与代码风格：变量、函数、类型、文件取名，注释与代码组织 | 取名看 [naming.md](naming.md)；注释与组织看 [code_style.md](code_style.md) | 要查的是语法或函数事实 |
| 查函数的名字、参数、返回值 | [codegen/index.md](codegen/index.md) | 该函数属金融数据仓库或模块 API |
| 具体模块能力：Python 调 TSL、策略回测、微信通知/告警 | [modules/index.md](modules/index.md) | 只是纯语法或普通取数 |