📦 deps(tsl): sync tsl-playbook from 94d968d6

Source-Commit: 94d968d68d
2026-07-08 05:17:37 +00:00
parent 296ea0fc40
commit a744e72c61
252 changed files with 12 additions and 182790 deletions
@@ -473,7 +473,7 @@ writeLn(result);

 - `%d` 是整数占位符
 - `%s` 是字符串占位符
- `format` 的完整占位符规范见 [../codegen/builtin/base/string.md](../codegen/builtin/base/string.md)
+- `format` 的完整占位符规范使用 `tsl-api-reference` skill 按名查询。

 ### `formatdatetime` 日期格式化

@@ -498,7 +498,7 @@ writeLn(result);
 - `yyyy` 表示四位年份
 - `mm` 表示两位月份
 - `dd` 表示两位日期
- `formatdatetime` 的完整格式说明见 [../codegen/builtin/base/datetime.md](../codegen/builtin/base/datetime.md)
+- `formatdatetime` 的完整格式说明使用 `tsl-api-reference` skill 按名查询。

 ## 默认生成模板

@@ -4,7 +4,7 @@
 是否可直接用于生成代码：仅部分
 是否含可直接照写示例：是
 是否含不可照写反例：是
-遇到不确定时：先按本页候选页继续判断；[05_functions_and_calls.md](05_functions_and_calls.md)、[06_expressions_and_operators.md](06_expressions_and_operators.md)、[14_ts_sql.md](14_ts_sql.md)、[15_debug_and_profiler.md](15_debug_and_profiler.md)、[19_namespace_libpath_and_unit_runtime.md](19_namespace_libpath_and_unit_runtime.md)、[21_builtin_runtime_objects.md](21_builtin_runtime_objects.md)、[../codegen/dotnet/datawarehouse/](../codegen/dotnet/datawarehouse/)；仍不命中时回到语法路由中心 [index.md](index.md)；如果问题已经超出语法层，回到 TSL 总入口 [../index.md](../index.md)
+遇到不确定时：先按本页候选页继续判断；[05_functions_and_calls.md](05_functions_and_calls.md)、[06_expressions_and_operators.md](06_expressions_and_operators.md)、[14_ts_sql.md](14_ts_sql.md)、[15_debug_and_profiler.md](15_debug_and_profiler.md)、[19_namespace_libpath_and_unit_runtime.md](19_namespace_libpath_and_unit_runtime.md)、[21_builtin_runtime_objects.md](21_builtin_runtime_objects.md)；函数事实使用 `tsl-api-reference` skill；仍不命中时回到语法路由中心 [index.md](index.md)；如果问题已经超出语法层，回到 TSL 总入口 [../index.md](../index.md)

 这一篇只处理运行时环境参数、块环境 `with` 语句、`with` 后缀、`#` 网格调用、`timeout` 后缀、`dupvalue(...)` 和全局缓存，不处理任何金融业务语义。

@@ -36,11 +36,11 @@
 - `with array(...)` 只在该次调用里临时覆盖对应键，调用结束后会恢复外部原值。
 - 如果外部原值本来不存在，`with array(...)` 调用结束后，对应键会恢复成 `nil`。
 - 不要把上面的后缀 `with` 直接泛化成“任何本地函数调用后面都能接 `with array(...)`”；本地函数后缀 `with` 属于反例。
- 本页只收通用键的例子；像 `pn_stock()`、`pn_date()` 这类金融上下文参数，统一到 [../codegen/dotnet/datawarehouse/](../codegen/dotnet/datawarehouse/) 查函数事实。
+- 本页只收通用键的例子；像 `pn_stock()`、`pn_date()` 这类金融上下文参数，统一使用 `tsl-api-reference` skill 查函数事实。
 - 网格调用的最小写法是 `r := #Func(args);`。
 - 网格调用返回的不是最终值；用 `dupvalue(r)` 取回结果。
 - `timeout N` 后缀可直接接在网格调用后面。
- 全局缓存函数的参数规格见 [../codegen/builtin/system/runtime.md](../codegen/builtin/system/runtime.md) 和 [../codegen/builtin/base/type_conversion.md](../codegen/builtin/base/type_conversion.md)；本页只保留缓存引用的运行时行为示例。
+- 全局缓存函数的参数规格使用 `tsl-api-reference` skill 按名查询；本页只保留缓存引用的运行时行为示例。
 - 写入和读取全局缓存成功时返回 `1`。
 - 从全局缓存取出的值，`ifCache(v)` 会返回 `1`。
 - 一旦对取出的缓存值做本地写入，它会立刻实例化；写入后 `ifCache(v)` 返回 `0`。
@@ -18,7 +18,7 @@
 2. 字段访问优先照本页明确的字符串键或结果集字段形态写。
 3. 复杂查询需求优先跳转到 [14_ts_sql.md](14_ts_sql.md)，不要把查询语法硬塞进过滤函数。
 4. `in` / `sqlin` / `union2` / `intersect` / `minus` / `outersect` 这类去重型集合关系跳转到 [12_matrix_and_collections.md](12_matrix_and_collections.md)。
-5. 金融数据筛选要先确认数据来源；函数事实见 [../codegen/dotnet/datawarehouse/](../codegen/dotnet/datawarehouse/)，项目字段和业务上下文回项目实际接口。
+5. 金融数据筛选要先确认数据来源；函数事实使用 `tsl-api-reference` skill 查询，项目字段和业务上下文回项目实际接口。
 6. 没有对应代码块时不要发明结果集/过滤写法。

 ## 核心规则
@@ -847,7 +847,7 @@ end;
 - `TSQLInsert` / `TSQLSetValue` / `TSQLBatchInsert` / `TSQLEdit` / `TSQLPost` / `TSQLFinal` 对象被 TS-SQL 查询的回调机制
 - 面向 SQL 表、业务表或时间序列的数据查询与写回（`marketTable` / `infoTable` / `tradeTable` / `sqlTable` / `hugeSqlTable` 等数据源）

-这些内容不作为本页可生成事实；业务数据源先查 [../codegen/dotnet/datawarehouse/](../codegen/dotnet/datawarehouse/)、[../modules/pytsl_api.md](../modules/pytsl_api.md) 或项目实际接口。
+这些内容不作为本页可生成事实；业务数据源先查 `tsl-api-reference` skill、[../modules/pytsl_api.md](../modules/pytsl_api.md) 或项目实际接口。

 ## 默认生成模板

@@ -28,7 +28,7 @@
 - `debugRunEnv(0)` 和 `debugRunEnv(1)` 可直接调用；它们面向调试客户端的副作用，不作为本页输出事实。
 - `debugRunEnvDo Func(...)` 可直接写，并且会返回被调用函数的结果。
 - `mtic` 会生成一个计时起点；`mtoc` 和 `mtoc(tick)` 都会返回秒数。
- `setProfiler(...)` 和 `getProfilerInfo(...)` 的参数规格见 [../codegen/builtin/system/runtime.md](../codegen/builtin/system/runtime.md)；本页只保留性能分析器行为示例。
+- `setProfiler(...)` 和 `getProfilerInfo(...)` 的参数规格使用 `tsl-api-reference` skill 按名查询；本页只保留性能分析器行为示例。
 - `setProfiler(7)` 配合 `getProfilerInfo(1)`，可以在不弹窗的情况下拿到性能分析器信息。
 - `__line__` 会返回所在代码行号。
 - `__stack_frame` 会返回调用栈帧数组；最小 `toStn(...)` 观察结果里，每一项是 `(line, "function")` 这一类二元组。
@@ -35,7 +35,7 @@
 - 直接写 `DemoUnit.Member` 时，可以读到 `interface` 和 `implementation` 里的常量、变量。
 - `findFunction("DemoUnit")` 拿到的是 `unit` 对象入口；本页只把它稳定暴露 `interface` 成员写成文档事实。
 - `DemoUnit.var_name := value` 这种限定赋值不作为可写事实；如果要改 `unit` 状态，应导出函数或方法来改。
- `tslfilename()` 的参数规格见 [../codegen/builtin/system/runtime.md](../codegen/builtin/system/runtime.md)；本页只保留它返回正在执行的 `.tsl` 主脚本完整路径这一行为事实。
+- `tslfilename()` 的参数规格使用 `tsl-api-reference` skill 按名查询；本页只保留它返回正在执行的 `.tsl` 主脚本完整路径这一行为事实。
 - `namespace "DemoNS";` 会选择 `Hello@DemoNS.tsf` 这类命名空间函数文件。
 - `tsl.conf` 的 `[system] Namespace=...` 可以设置默认命名空间；脚本里的 `namespace "..."` 会覆盖配置值。
 - 当全局 `Hello.tsf` 和 `Hello@StmtNS.tsf` 同时存在时，启用 `StmtNS` 后会优先命中命名空间版本。
@@ -26,7 +26,7 @@

 ## 核心规则

- 矩阵初始化函数的参数规格见 [../codegen/builtin/math/matrix.md](../codegen/builtin/math/matrix.md)；本页只保留矩阵行为示例和返回形态边界。
+- 矩阵初始化函数的参数规格使用 `tsl-api-reference` skill 按名查询；本页只保留矩阵行为示例和返回形态边界。
 - `zeros(...)`、`ones(...)`、`rand(...)`、`nils(...)`、`eye(...)` 都可以直接用于矩阵初始化。
 - `zeros(3)`、`ones(3)`、`nils(2)` 这类单参数写法可以直接生成一维结果。
 - `zeros(2, 3)`、`rand(2, 3)` 这类双参数写法可以直接生成二维矩阵。
@@ -25,7 +25,7 @@
 - `fmarray[...]` 可以直接构造 `FMArray` 常量。
 - `dataType(v)` 对 `FMArray` 返回 `27`。
 - `dataType(v, 1)` 可以读出 `FMArray` 单元格类型；本页文档类型包括 `0` 整型、`1` 浮点、`20` 64 位整型。
- FMArray 相关函数的参数规格见 [../codegen/builtin/base/type_conversion.md](../codegen/builtin/base/type_conversion.md) 和 [../codegen/builtin/math/matrix.md](../codegen/builtin/math/matrix.md)；本页只保留 FMArray 行为示例和返回形态边界。
+- FMArray 相关函数的参数规格使用 `tsl-api-reference` skill 按名查询；本页只保留 FMArray 行为示例和返回形态边界。
 - `ifFmarray(v)` 可直接判断值是否为 `FMArray`。
 - `mInit`、`mInitDiag`、`mRand` 都可直接生成 `FMArray`。
 - `arrayToFm` 和 `matrixToArray` 可在 `Array` / `FMArray` 间互转。