📝 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,485 @@
+# 资源访问函数 - 进程相关函数
+
+文档类型：函数事实页
+是否可直接用于生成代码：是；本页函数条目均包含参数表
+遇到不确定时：回到 [../resource.md](../resource.md)、[../../index.md](../../index.md)
+
+## 进程相关函数
+
+### `sysPutenv(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `sysParamStr(i)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `i`    | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysErrorMessage(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysgetenv(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `sysWaitForMultipleObjects(arg1, arg2, arg3)`
+
+用途：进程相关函数相关函数。
+
+参数个数：3
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 数组     | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+| 3        | `arg3` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysTerminate()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理结果
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysCreateMutex(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `sysReleaseMutex(ret)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `ret`  | 是   | 变量引用 | 按源文档示例顺序传入 |
+
+### `sysProcessID()`
+
+用途：获取当前进程 ID（PID）。
+
+参数个数：0
+返回值：进程 ID（整数）
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysParamcount()`
+
+用途：获取命令行传入参数的个数。
+
+参数个数：0
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysThreadID()`
+
+用途：获取当前线程 ID。
+
+参数个数：0
+返回值：线程 ID（整数）
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sleep(arg1)`
+
+用途：让当前线程休眠指定毫秒数。
+
+参数个数：1
+返回值：无
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysWaitForSingleObject(hand1, arg2)`
+
+用途：进程相关函数相关函数。
+
+参数个数：2
+返回值：处理后的结果值
+
+| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
+| -------- | ------- | ---- | -------- | -------------------- |
+| 1        | `hand1` | 是   | 任意值   | 按源文档示例顺序传入 |
+| 2        | `arg2`  | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysGetenvs()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysexecGetenvs()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysexecDeletepipe(hand)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `hand` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysexecSetenvs(arg1, arg2)`
+
+用途：进程相关函数相关函数。
+
+参数个数：2
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 数组     | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysexecNewpipe(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `dbglocalrunning()`
+
+用途：返回本地解释器正在运行的任务列表与调用栈信息。
+
+参数个数：0
+返回值：任务信息数组（包含 StartInfo/CallStack）
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `dbglocalcancel(task_id)`
+
+用途：根据任务 ID 终止本地运行中的任务。
+
+参数个数：1
+返回值：成功返回 1，失败返回 0
+
+| 参数位置 | 参数名    | 必填 | 接收类型 | 说明                 |
+| -------- | --------- | ---- | -------- | -------------------- |
+| 1        | `task_id` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysThreadSelf()`
+
+用途：获取当前线程 ID（Linux 下为 pthread_t）。
+
+参数个数：0
+返回值：线程 ID（整数）
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `syslinuxkrnlclosemutex(arg1, arg2)`
+
+用途：关闭并清理指定互斥量（Linux），用于移除互斥相关的系统信号量与临时文件。
+
+参数个数：2
+返回值：成功返回 1，失败返回 0
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysSetThreadPriority(arg1[, arg2])`
+
+用途：进程相关函数相关函数。
+
+参数个数：1 到 2
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                                           |
+| -------- | ------ | ---- | -------- | ---------------------------------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入                           |
+| 2        | `arg2` | 否   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `tid` |
+
+### `sysGetThreadPriority(pri[, arg2])`
+
+用途：进程相关函数相关函数。
+
+参数个数：1 到 2
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `pri`  | 是   | 任意值   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 否   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysSetProcessPriority(arg1[, arg2])`
+
+用途：进程相关函数相关函数。
+
+参数个数：1 到 2
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+| 2        | `arg2` | 否   | 整数     | 按源文档示例顺序传入 |
+
+### `sysGetProcessPriority(pri[, arg2])`
+
+用途：进程相关函数相关函数。
+
+参数个数：1 到 2
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `pri`  | 是   | 任意值   | 按源文档示例顺序传入 |
+| 2        | `arg2` | 否   | 整数     | 按源文档示例顺序传入 |
+
+### `sysGetProcessList()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysGetProcessListw()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysGetProcessNamePath(path)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `path` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `sysGetProcessNamePathw(path)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `path` | 是   | 字符串   | 按源文档示例顺序传入 |
+
+### `sysGetProcessCmdLine(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysGetProcessCmdLinew(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysSetThreadName(arg1[, arg2])`
+
+用途：设置线程名称（Linux 仅支持当前线程）。
+
+参数个数：1 到 2
+返回值：成功返回 0，失败返回非 0
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                                           |
+| -------- | ------ | ---- | -------- | ---------------------------------------------- |
+| 1        | `arg1` | 是   | 字符串   | 按源文档示例顺序传入                           |
+| 2        | `arg2` | 否   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `tid` |
+
+### `sysGetThreadName([arg1])`
+
+用途：获取线程名称。
+
+参数个数：0 到 1
+返回值：线程名称字符串；失败返回 nil 或空串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 否   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysGetThreads()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysPPid()`
+
+用途：进程相关函数相关函数。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysGetSubProcesses()`
+
+用途：进行字符串提取或替换处理。
+
+参数个数：0
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysKill(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysPidOfTid(tid)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `tid`  | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysPidOfHandle(handle)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名   | 必填 | 接收类型 | 说明                 |
+| -------- | -------- | ---- | -------- | -------------------- |
+| 1        | `handle` | 是   | 任意值   | 按源文档示例顺序传入 |
+
+### `sysHandleOfPid(arg1)`
+
+用途：进程相关函数相关函数。
+
+参数个数：1
+返回值：处理后的结果值
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
+| -------- | ------ | ---- | -------- | -------------------- |
+| 1        | `arg1` | 是   | 整数     | 按源文档示例顺序传入 |
+
+### `sysGetLastError()`
+
+用途：获取最近一次系统错误码。
+
+参数个数：0
+返回值：整数
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysCmdLine()`
+
+用途：获取当前进程命令行。
+
+参数个数：0
+返回值：字符串
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |
+
+### `sysClientInfo()`
+
+用途：获取客户端信息。
+
+参数个数：0
+返回值：客户端信息或 nil
+
+| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
+| -------- | ------ | ---- | -------- | ---- |