playbook/skills/tsl-syntax-reference/references/24_client_remote_calls.md

TSL 客户端远程调用

这一篇只处理 RDo / RDo2 调用客户端本地函数的语法外形、等待行为、系统参数后缀和超时后缀。

本篇职责

回答“怎样从平台调用客户端本地函数、RDo 与 RDo2 有什么区别、With 与 TimeOut 写在哪里，以及为什么不能写成 RDo(...) / RDo2(...)”。

核心规则

• RDo 和 RDo2 是客户端远程调用关键字，不是普通函数。
• 两者都写在被调用的本地函数之前；圆括号属于本地函数调用，不属于 RDo / RDo2。
• RDo 只提交任务，不等待本地函数执行完成，也不取得函数返回值。
• RDo2 等待本地函数执行完成，并把该函数的结果作为整个表达式的值。
• 本地函数需要系统参数时，在调用后追加 With SysParams。
• RDo2 默认超时为 300 秒；需要自定义时，在末尾追加 TimeOut Seconds。文档定义的后缀顺序是先 With、后 TimeOut。
• RDo2 在客户机执行时需要用户权限许可；依赖客户端资源的函数不能在无 GUI 的命令行解释器中验证其交互结果。
• 被调用函数的精确签名、参数写回、返回值及运行时 scope 必须使用 tsl-api-reference skill 单独查询；本页只拥有 RDo / RDo2 的语法形态。

RDo / RDo2 语法与示例

原文定义使用下面的元语法；方括号表示可选部分，不是需要写进 TSL 源码的字符：

代码块身份：配置片段 / 概念骨架

RDo LocalFunctionName(P1; P2; …) [With SysParams];
RDo2 LocalFunctionName(P1; P2; …) [With SysParams] [TimeOut Seconds]: Any;

RDo2 调用客户端 InputQuery 的原文范例可整理为：

代码块身份：可直接照写示例 代码块说明：需要平台客户端交互环境、用户权限许可，并要求目标环境提供 InputQuery；无 GUI 的命令行解释器不能验证弹窗结果。

value := "";
if rdo2 InputQuery("Input", "Hint", value) then
    return value;
else
    return "Canceled";

结果说明：

• 用户确认时，InputQuery 返回真，输入内容写回 value，脚本返回该字符串。
• 用户取消时，InputQuery 返回假，脚本返回 Canceled。
• 这段代码证明的是前缀形态 rdo2 InputQuery(...)；InputQuery 的 API 事实仍需按目标 scope 单独查询。

禁止项

• 把关键字建模成 RDo() 或 RDo2(...) 普通函数。
• 把被调用本地函数的参数误写成 RDo2 自身的参数表。
• 声称 RDo 会返回客户端函数结果。
• 忽略 RDo2 的客户端权限与交互环境要求。