📝 docs(tsl): align agent-facing guidance

2026-05-28 19:12:34 +08:00
parent c48354e0cb
commit d8eb418277
63 changed files with 1921 additions and 371 deletions
@@ -20,6 +20,14 @@
 - 多个 `unit` 里有同名接口时，未限定调用到底命中谁
 - 怎样显式指定要调用哪个 `unit` 的接口

+## Agent unit/作用域判断流程
+
+1. 先判断当前交付是 `.tsl` 可执行脚本、`.tsf` 扩展模块，还是 `unit` 文件。
+2. `unit` 文件只描述可复用单元；脚本入口仍放在 `.tsl`。
+3. `uses` 必须放在普通语句之前；普通语句后不要再追加顶层 `uses`。
+4. 默认参数、接口段、实现段和作用域边界只照本页已验证形态写。
+5. 没有已验证代码块时不要发明 unit/作用域写法。
+
 ## 必须记住的规则

 - `unit` 是完整的顶层主体；常见完整形态是 `unit Name; interface ... implementation ... end.`。
@@ -58,6 +66,14 @@ end.
 - 上面这就是当前解释器可通过的最小完整 `unit` 骨架。
 - `unit` 文件结尾要用 `end.`，不是普通函数或类的 `end;`。

+如果该 `unit` 被脚本 `uses DemoUnit;` 后调用 `WriteLn(Ping());`，可观察输出为：
+
+代码块身份：已验证输出片段
+
+```text
+1
+```
+
 ### 简写 `unit`

 代码块身份：已验证可执行示例