📝 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.
2026-06-09 17:24:30 +08:00
parent 9c194170a1
commit 540b3c0a1b
192 changed files with 32929 additions and 13533 deletions
@@ -0,0 +1,383 @@
+# 基础函数 - 多语言支持函数
+
+文档类型：函数事实页
+是否可直接用于生成代码：是；本页函数条目均包含参数表
+遇到不确定时：回到 [../base.md](../base.md)、[../../index.md](../../index.md)
+
+## 多语言支持函数
+
+### `nextCharIndex(s, arg2)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：2
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `ansiToUTF8(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `utf8ToAnsi(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `charToByteIndex(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `byteToCharLen(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `ansiQuotedStr(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `ansiPos(arg1, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `ansiDequotedStr(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `charToByteLen(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `charLength(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `byteToCharIndex(s, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `byteType(arg1, arg2)`
+
+用途：字符串相关函数。
+
+参数个数：2
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `booltostrw(value)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
+| -------- | ------- | ---- | -------- | -------------------- |
+| 1        | `value` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `unicodeESC(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `unUnicodeESC2(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `floattoStrw(value)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
+| -------- | ------- | ---- | -------- | -------------------- |
+| 1        | `value` | 是   | 实数     | 按源文档示例顺序传入 |
+
+### `unicodeESC2()`
+
+用途：多语言支持函数相关函数。
+
+参数个数：0
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `unUnicodeESCw(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `unicodetoUTF8(arg1)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `currtoStrw(value)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
+| -------- | ------- | ---- | -------- | -------------------- |
+| 1        | `value` | 是   | 实数     | 按源文档示例顺序传入 |
+
+### `inttostrw(value)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
+| -------- | ------- | ---- | -------- | -------------------- |
+| 1        | `value` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `booltostrw2(value)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
+| -------- | ------- | ---- | -------- | -------------------- |
+| 1        | `value` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `strw(value, s)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：2
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                                         |
+| -------- | ------- | ---- | -------- | -------------------------------------------- |
+| 1        | `value` | 是   | 实数     | 按源文档示例顺序传入                         |
+| 2        | `s`     | 是   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `s` |
+
+### `inttohexw(arg1, arg2)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：2
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `multibytetoUnicodew(arg1, arg2)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：2
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `utf8toUnicode(arg1)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `exportjsonstring(s)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 数组     | 按源文档示例顺序传入 |
+
+### `importjsonstring(json)`
+
+用途：将 JSON 字符串解析为 TSL 数据。
+
+参数个数：1
+返回值：任意值；JSON 字符串返回字符串，JSON 整数返回整数，JSON 数组返回数组
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `json` | 是   | 字符串   | 待解析的 JSON 字符串 |
+
+### `unUnicodeESC2w(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `unUnicodeESC(arg1)`
+
+用途：字符串相关函数。
+
+参数个数：1
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `ifwstring(value[, arg2])`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1 到 2
+返回值：处理结果
+
+| 参数位置 | 参数名  | 必填 | 接收类型         | 说明                 |
+| -------- | ------- | ---- | ---------------- | -------------------- |
+| 1        | `value` | 是   | 整数/字符串/数组 | 按源文档示例顺序传入 |
+| 2        | `arg2`  | 否   | 整数             | 按源文档示例顺序传入 |
+
+### `exportJsonStringUTF8(a)`
+
+用途：多语言支持函数相关函数。
+
+参数个数：1
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `a`    | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `exportJSONStringMBCS(s)`
+
+用途：将字符串或数组序列化为 JSON 字符串，保留中文原码（MBCS），不转义为 \\uXXXX。
+
+参数个数：1
+返回值：JSON 字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `s`    | 是   | 数组     | 按源文档示例顺序传入 |