✨ feat(tsl-api-reference): expand API and module coverage

skills/tsl-api-reference/references/codegen/dotnet/financial/financial_analysis-common.md

@@ -1,5 +1,30 @@
 # 金融 / 财务分析 / 常用
 
+## `bk_finacialItemTopN(r_date, info_id, show_number)`
+
+声明：function
+
+按指定财务指标对当前系统板块的股票降序排列并返回前 N 名
+
+<!-- tags: 金融 财务分析 常用 板块 财务指标 排名 前N名 TopN 基本面 -->
+
+| 参数          | 类型    | 说明                  |
+| ------------- | ------- | --------------------- |
+| `r_date`      | integer | 报告期                |
+| `info_id`     | integer | 用于排序的财务指标 ID |
+| `show_number` | integer | 返回的股票数量        |
+
+返回：table_array
+
+### 示例
+
+范例01：查询上证 A 股 2017 年三季报营业收入前八名
+
+```tsl
+setSysParam(pn_bk(), "上证A股");
+return bk_finacialItemTopN(20170930, 46002, 8);
+```
+
 ## `financialIncreaseRatio(rep_1, rep_2, report_id)`
 
 声明：function
@@ -382,3 +407,36 @@ setsysparam(pn_stock(), "SZ000002");
 return MagicSum2(array(46024, 46033), 0, 2003);
 // 输出：万科A上市至2003年利润总额、净利润两科目分别的和
 ```
+
+## `zxCompareReturn_pgm(beg_year, end_year, type, info_id_arr)`
+
+声明：function
+
+返回当前系统股票在指定年度区间和报告期类型下的财务指标纵向对比数据
+
+<!-- tags: 金融 财务分析 常用 财务指标 纵向对比 年度区间 报告期 基本面 -->
+
+| 参数          | 类型    | 说明                    |
+| ------------- | ------- | ----------------------- |
+| `beg_year`    | integer | 开始年份                |
+| `end_year`    | integer | 结束年份                |
+| `type`        | integer | 报告期类型，取值见下    |
+| `info_id_arr` | array   | 需要比较的基本面数据 ID |
+
+type 取值
+
+- `1` — 一季报
+- `2` — 中报
+- `3` — 三季报
+- `4` — 年报
+
+返回：table_array
+
+### 示例
+
+范例01：查询万科 A 2015 至 2017 年年报的摊薄每股收益
+
+```tsl
+setSysParam(pn_stock(), "SZ000002");
+return zxCompareReturn_pgm(2015, 2017, 4, array(42002));
+```