📦 deps(tsl): sync tsl-playbook from f90faa10

Source-Commit: f90faa10c3
2026-08-13 15:37:54 +08:00
parent 85a9d8ee40
commit 2c38c5fc06
21 changed files with 721 additions and 1825 deletions
@@ -18,7 +18,7 @@
 - `setSysParam(key, value)` 和 `getSysParam(key)` 可以直接用字符串键。
 - `sysParams[key]` 可以直接读写这些运行时参数。
 - 块环境语句可写成 `with *, sys_param_values do begin ... end` 或 `with **, sys_param_values do begin ... end`。
- `with *` 会把提供的系统参数合并进当前运行时上下文；不要依赖它在块结束后自动恢复外层值。
+- `with *` 会把提供的系统参数合并进当前运行时上下文。普通自定义键可能在块后保留新值；特殊系统环境变量会在块结束后恢复，因此不要把两类键的恢复行为混为一谈。
 - `with **` 会用提供的系统参数建立隔离块环境；块结束后恢复外层系统参数。
 - 后缀 `with` 形式写在函数文件调用后面：`#Func() with array(...)`。
 - `with array(...)` 只在该次调用里临时覆盖对应键，调用结束后会恢复外部原值。
@@ -110,7 +110,8 @@ writeLn(getSysParam("b"));

 - 块内输出 `2`、`3`
 - 块后输出 `2`、`3`
- 说明 `with *` 会把传入键合并进当前系统参数上下文；不要把它当成自动恢复外层值的隔离块
+- 这组实验只证明普通自定义键 `"a"` / `"b"` 会合并并在块后保留新值
+- 特殊系统环境变量在块结束后会恢复；不要用普通字符串键的结果外推股票、日期等特殊环境

 `with *, SysParamArray do` 使用当前所有系统参数：

@@ -443,7 +444,7 @@ end;

 - 把系统参数页直接写成金融函数页。
 - 把 `#Func() with array(...)` 误判成也能直接套在本地函数 `Demo()` 后面。
- 把 `with *` 误判成会自动恢复外层系统参数。
+- 以为 `with *` 对所有键都统一“不恢复”或统一“恢复”；普通自定义键与特殊系统环境变量的边界不同。
 - 以为 `with array(...)` 改的是全局永久值，不会恢复外层原环境。
 - 把网格句柄直接当最终值用，而不做 `dupvalue(...)`。
 - 以为从全局缓存取出的值，本地写入后仍然保持缓存身份。