📝 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
@@ -14,6 +14,14 @@

 回答“网格调用现在怎样写，全局缓存最稳的读写方式是什么，以及什么时候缓存值会失效或脱离缓存身份”。

+## Agent 运行时服务/全局缓存判断流程
+
+1. 先判断要用 `#` 网格调用、`timeout` 后缀，还是全局缓存函数。
+2. 运行时服务只照本页已验证最小路径写，不要猜测隐藏参数。
+3. 全局缓存读写要成对出现，并明确 key/value 生命周期。
+4. 普通函数调用回到函数页，不要把运行时服务写成普通语法糖。
+5. 没有已验证代码块时不要发明运行时服务/全局缓存写法。
+
 ## 必须记住的规则

 - 网格调用的最小写法是 `r := #Func(args);`。
@@ -48,6 +56,12 @@ end.
 - `#AddOne(5)` 可以执行
 - `dupvalue(r)` 返回最终结果 `6`

+代码块身份：已验证输出片段
+
+```text
+6
+```
+
 ### 网格调用的 `timeout`

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