📝 docs(tsl): restructure agent-facing reference

Rework TSL syntax, catalog, modules, and routing docs around deterministic agent lookup and generation.

Split large catalog pages into focused function fact pages, remove obsolete pending/verified/unavailable paths, and update consistency tests for the new structure.
This commit is contained in:
csh
2026-06-09 17:24:30 +08:00
parent 9c194170a1
commit 540b3c0a1b
192 changed files with 32929 additions and 13533 deletions
@@ -0,0 +1,292 @@
# 数据仓库金融函数 - 向导函数
文档类型:函数事实页
是否可直接用于生成代码:是;本页函数条目均包含参数表
遇到不确定时:回到 [../datawarehouse.md](../datawarehouse.md)、[../../index.md](../../index.md)
## 向导函数
### `relativeStrengthOfIndustry()`
用途:向导函数相关函数。
参数个数:0
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |
### `specSysParams(expression, date_value_2, cycle, arg4, arg5)`
用途:向导函数相关函数。
参数个数:5
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `date_value_2` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 3 | `cycle` | 是 | 周期值 | 按源文档示例顺序传入;示例参数形态为 `cy_day()` |
| 4 | `arg4` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
| 5 | `arg5` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
### `relativeStrengthOfSector(expression, arg2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------ | ---- | ---------- | -------------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@stockzf3()` |
| 2 | `arg2` | 是 | 字符串 | 按源文档示例顺序传入;示例参数形态为 `'A股'` |
### `reportOfListed(info_id, date_value_2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | -------- | ----------------------------------------------- |
| 1 | `info_id` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `46002` |
| 2 | `date_value_2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `20160331` |
### `reportPerShareOfListed(info_id, date_value_2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | -------- | ----------------------------------------------- |
| 1 | `info_id` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `46033` |
| 2 | `date_value_2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `20160331` |
### `derivative1(expression, arg2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------ | ---- | ---------- | ----------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
### `positionOfSector(expression, arg2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------ | ---- | ---------- | ----------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `arg2` | 是 | 字符串 | 按源文档示例顺序传入;示例参数形态为 `'A股'` |
### `reduceWithHighestOfPeriod(expression, date_value_2, date_value_3, arg4)`
用途:向导函数相关函数。
参数个数:4
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `date_value_2` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 3 | `date_value_3` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180803T` |
| 4 | `arg4` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
### `occuredRepIdOfRepPeriod(expression, date_value_2, arg3)`
用途:向导函数相关函数。
参数个数:3
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ---------- | --------------------------------------------------------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@reportofall(42002, GetSysParam('DefaultRepID')) > 1.5` |
| 2 | `date_value_2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `20101231` |
| 3 | `arg3` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `2018` |
### `continuedMatchOfRepPeriod(expression, date_value_2, arg3)`
用途:向导函数相关函数。
参数个数:3
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ---------- | --------------------------------------------------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@reportofall(46002, GetSysParam('DefaultRepID'))` |
| 2 | `date_value_2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `20140331` |
| 3 | `arg3` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `2018` |
### `growthOfRepPeriod(expression, date_value_2, arg3)`
用途:向导函数相关函数。
参数个数:3
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ---------- | --------------------------------------------------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@reportofall(46002, GetSysParam('DefaultRepID'))` |
| 2 | `date_value_2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `20150331` |
| 3 | `arg3` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `1` |
### `relativeStrengthOfSectorDesc(expression, arg2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------ | ---- | ---------- | ----------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `arg2` | 是 | 字符串 | 按源文档示例顺序传入;示例参数形态为 `'A股'` |
### `positionOfSectorDesc(expression, arg2)`
用途:向导函数相关函数。
参数个数:2
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------ | ---- | ---------- | ----------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `arg2` | 是 | 字符串 | 按源文档示例顺序传入;示例参数形态为 `'A股'` |
### `growthWithLowestOfPeriod(expression, date_value_2, date_value_3, arg4)`
用途:向导函数相关函数。
参数个数:4
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `date_value_2` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 3 | `date_value_3` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180903T` |
| 4 | `arg4` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
### `sumOfSector(expression, date_value_2, date_value_3, arg4, arg5, arg6, arg7)`
用途:向导函数相关函数。
参数个数:7
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `date_value_2` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 3 | `date_value_3` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 4 | `arg4` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `1` |
| 5 | `arg5` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
| 6 | `arg6` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
| 7 | `arg7` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
### `positionOfIndustry()`
用途:向导函数相关函数。
参数个数:0
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |
### `avgOfSector(expression, arg2, date_value_3, date_value_4, arg5, arg6, arg7, arg8)`
用途:向导函数相关函数。
参数个数:8
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `2` |
| 3 | `date_value_3` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 4 | `date_value_4` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 5 | `arg5` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `1` |
| 6 | `arg6` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
| 7 | `arg7` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
| 8 | `arg8` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `0` |
### `occuredTimeOfPeriod(expression, date_value_2, date_value_3)`
用途:向导函数相关函数。
参数个数:3
返回值:日期或时间值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
| 2 | `date_value_2` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 3 | `date_value_3` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180810T` |
### `specDateValue(date_value, expression_2)`
用途:向导函数相关函数。
参数个数:2
返回值:日期或时间值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | ------------------------------------------------ |
| 1 | `date_value` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20180801T` |
| 2 | `expression_2` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
### `derivative2(expression)`
用途:向导函数相关函数。
参数个数:1
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------ | ---- | ---------- | ----------------------------------------------- |
| 1 | `expression` | 是 | 表达式对象 | 按源文档示例顺序传入;示例参数形态为 `@close()` |
### `stockTrailingAvgByEndT(end_time, ref_type, expression_3, is_exclude_i_p_o, n)`
用途:向导函数相关函数。
参数个数:5
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------------------ | ---- | ------------ | ------------------------------------------------- |
| 1 | `end_time` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20210714T` |
| 2 | `ref_type` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `4` |
| 3 | `expression_3` | 是 | 表达式字符串 | 按源文档示例顺序传入;示例参数形态为 `"Amount()"` |
| 4 | `is_exclude_i_p_o` | 是 | 任意值 | 按源文档示例顺序传入;示例参数形态为 `1` |
| 5 | `n` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `3` |
### `stockTrailingStdByEndT(end_time, ref_type, expression_3)`
用途:向导函数相关函数。
参数个数:3
返回值:处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | -------------- | ---- | ------------ | --------------------------------------------------- |
| 1 | `end_time` | 是 | 日期或时间值 | 按源文档示例顺序传入;示例参数形态为 `20210714T` |
| 2 | `ref_type` | 是 | 整数 | 按源文档示例顺序传入;示例参数形态为 `4` |
| 3 | `expression_3` | 是 | 表达式字符串 | 按源文档示例顺序传入;示例参数形态为 `"stockzf3()"` |