📝 docs(tsl): align agent-facing guidance

This commit is contained in:
csh
2026-05-28 19:12:34 +08:00
parent c48354e0cb
commit d8eb418277
63 changed files with 1921 additions and 371 deletions
@@ -21,6 +21,14 @@
- `NameSpace "..."``tsl.conf``-LIBPATH` 怎样影响 `.tsf` 查找
- `syssettsllibpath()` / `sysgettsllibpath()` 怎样在运行时改查找路径
## Agent 命名空间/Libpath 判断流程
1. 先判断任务是单元命名空间访问、`-LIBPATH` 查找,还是配置文件查找。
2. 路径和查找顺序只写平台中立规则,不写某个开发机或容器路径。
3. `-LIBPATH` 只作为运行时部署/查找规则,不写进普通语法示例。
4. 未验证的路径替换和父目录继承不要当成稳定规则。
5. 没有已验证代码块时不要发明命名空间/Libpath 写法。
## 必须记住的规则
- 完整 `unit` 形态可以包含 `interface``implementation``initialization``finalization`,并以 `end.` 结束。
@@ -86,6 +94,18 @@ end.
- 这说明顶层写了 `uses DemoUnit;` 之后,`initialization` 不是立刻执行,而是在第一次真正读 `DemoUnit` 成员时触发。
- `finalization` 在脚本主体输出结束后触发。
代码块身份:已验证输出片段
```text
BEFORE
INIT
7
1
101
11
FINAL
```
### `unit` 成员的读取边界
直接限定读取: