✨ feat(tsl-api-reference): improve tagged API discovery

2026-07-31 12:37:59 +08:00
parent 736d1a8ad7
commit 29d110110b
5 changed files with 136 additions and 67 deletions
@@ -30,6 +30,8 @@

 带回车地输出字符串，如果在平台运行，会输出信息到客户端。

+<!-- tags: 打印 输出 output print write writeln -->
+
 | 参数 | 类型   | 说明           |
 | ---- | ------ | -------------- |
 | `p1` | string | string 字符串1 |
@@ -40,13 +42,9 @@
 ### 示例

 ```tsl
-// 先输出111222，接着另起一行显示空白，再接着另起一行输出333
+// 需平台运行环境查看客户端输出
 writeln("111", "222");
 writeln("333");
-{结果页面中，运行信息下打印：
-111222
-333
-}
 ```

 ## `write(p1, pn)`
@@ -55,6 +53,8 @@ writeln("333");

 输出字符串，如果在平台运行，会输出信息到客户端。

+<!-- tags: 打印 输出 output print write writeln -->
+
 | 参数 | 类型   | 说明           |
 | ---- | ------ | -------------- |
 | `p1` | string | string 字符串1 |
@@ -65,13 +65,10 @@ writeln("333");
 ### 示例

 ```tsl
-// 先输出123456，接着另起一行输出789
+// 需平台运行环境查看客户端输出
 write("123", "456");
 write("789");
 return;
-{在结果页面中打印：
-123456
-789}
 ```

 ## `httpGetContent()`
@@ -1459,6 +1459,8 @@ return fieldCountOfStrSubscript(s);

 1、返回一维数组中最大值所在下标

+<!-- tags: 数组 列表 array list 最大值 最大 maximum max 下标 索引 位置 index position -->
+
 | 参数 | 类型             | 说明         |
 | ---- | ---------------- | ------------ |
 | `x`  | array,tablearray | 一维数字数组 |
@@ -1469,7 +1471,8 @@ return fieldCountOfStrSubscript(s);

 ```tsl
 x := array(9, 8, 10);
-return argmax(x); // 2
+return argmax(x);
+// 输出：2
 ```

 ## `argmin(x)`
@@ -2688,6 +2691,8 @@ return groupDemeanIt(t, 'G', array('V1', 'V2'));

 数组去重(包含NAN)。

+<!-- tags: 数组 列表 array list 去重 删除重复 deduplicate duplicate dropduplicate -->
+
 | 参数   | 类型  | 说明                 |
 | ------ | ----- | -------------------- |
 | `data` | array | 数据表类型。数据表。 |
@@ -2699,7 +2704,7 @@ return groupDemeanIt(t, 'G', array('V1', 'V2'));
 ```tsl
 data := array(("A": 1, "B": nan), ("A": 1, "B": 2), ("A": 1, "B": nan), ("A": 1, "B": 2));
 return arrDropDuplicate(data);
-// 结果：array(("A":1,"B":NAN),("A":1,"B":2))
+// 输出：array(("A":1,"B":NAN),("A":1,"B":2))
 ```

 ## `getSubTableByField(t)`