playbook/docs/tsl/reference/index.md

Reference Index

文档类型：检索页 是否可直接用于生成代码：否 遇到不确定时跳转到：catalog/index.md、../syntax/index.md、../finance/index.md

这里是函数查阅层，不是默认通读入口。现在这一页本身就是函数总入口，不再要求先跳到额外的中转页。

reference 的目标是确认每个方法的参数类型，让 agent 写代码时知道该传什么。文档只保留 agent 生成代码需要的函数事实。

Agent 函数使用规则

• 只从 verified 函数页读取参数类型、返回值和调用约束。
• catalog 只是候选函数索引，不能把 catalog 里的函数名直接当成可调用事实。
• 函数没有进入 verified 函数页时，不要根据函数名猜参数，也不要生成调用代码。
• 函数参数必须按正确类型传入；TSL 本身弱类型，不等于函数参数无类型。
• 如果函数被记录为当前测试环境不支持，不要使用该函数生成代码。

检索策略

1. 先看 catalog/index.md 的模块目录，确定候选大类。
2. 进入对应模块页，在页内搜索具体候选函数名。
3. 先看 verified/index.md，再进入具体 verified 函数页读取参数类型、返回值和调用约束；当前核心函数页是 verified/core.md。
4. 如果候选函数没有进入 verified 函数页，不要生成调用代码。
5. 当前测试环境不支持的方法见 unavailable_methods.md。
6. 如果目录和定向检索都找不到函数，不要发明函数名，也不要默认它是 TSL 内建函数；回 ../syntax/index.md、../finance/index.md、../modules/index.md 或项目文档确认来源。

按任务跳转

当前任务	先读哪里
查函数库入口	catalog/index.md
直接按模块查函数	catalog/index.md
查可调用函数参数类型	verified/index.md
查当前测试环境不支持方法	unavailable_methods.md
回到语法层	../syntax/index.md
回到金融层	../finance/index.md
回到模块层	../modules/index.md