用途
TDN Lookup 是一个面向 ADVPL/TLPP 开发的检索策略技能,用于在本地参考资料不足时查找 TOTVS 官方文档。其目标站点为 TDN(tdn.totvs.com),这是一个公开的 Confluence Data Center 7.19 站点,提供无需身份验证的 REST API。
该技能本身不包含领域知识,只负责编排搜索过程。实际的原生函数、入口点和错误目录位于 protheus-reference、advpl-code-generation、advpl-debugging 和 protheus-business 中。
主要能力
该技能定义了一套标准化的五层升级搜索策略:
- 第一层:始终先检查相关的本地缓存文件,包括原生函数、SX 字典、常见错误、入口点、业务模块。
- 第二层:通过 WebFetch 直接调用 Confluence REST 搜索 API,并构造 CQL 查询。
- 第三层:当 WebFetch 被阻止时,改用 Playwright 访问同一 API。
- 第四层:当 CQL 搜索无结果时,使用 WebSearch 配合 Playwright 导航。
- 第五层:作为最后手段,在 TDN 站点上进行手动/可视化搜索。
使用方式
当原生函数、入口点、错误代码或业务流程在本地参考文件中未找到(或仅部分找到)时,或当用户明确要求 TOTVS 官方文档时,应激活此技能。
技能附带参考文件 reference.md,应始终阅读。该文件包含逐层的搜索策略、CQL 查询构造方法、HTML/JSON 解析步骤以及每一层的回退条件。
适用场景
适用于 ADVPL/TLPP 开发过程中需要查询 TOTVS 官方文档的场景,尤其是本地参考资料无法覆盖原生函数、入口点、错误代码或业务流程的情况。
限制
该技能本身不包含领域知识,仅编排搜索流程。其搜索能力依赖外部工具(WebFetch、Playwright、WebSearch)以及 TDN 站点的公开 REST API。关于收费、价格、平台支持范围等信息,资料中暂未提供。