protheus-reference

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Protheus Reference

Protheus 参考指南

This skill is a quick-lookup reference guide for the TOTVS Protheus ecosystem: native function syntax/parameters/return values across categories (String, Date/Time, Array, Database, Interface, Network, JsonObject, ExecAuto, etc.), the SX data dictionary (SX1 Perguntas through SXB/SIX), REST API patterns (FWRest annotations vs. legacy WsRestFul), and MV_* system parameters.

Activate this skill when the user needs to confirm how a native function works, validate a custom field against SX3, check REST endpoint conventions, or verify a function isn't on the restricted/internal-only list (checked first, always, before recommending any function). The lookup strategy is local-first (native-functions.md, sx-dictionary.md, sx3-common-fields.md, rest-api-reference.md), falling back to a tiered TDN online search (WebFetch API, then Playwright API JSON, then Playwright HTML) via the

tdn-lookup

skill when not found locally.

It does not cover business-process context for why a table/field is used (see

protheus-business

), writing the SQL to query these tables (see

embedded-sql

), or generating documentation that references these functions (see

documentation-patterns

Reference file	Read when
reference.md	Always -- function category index, data dictionary overview, REST API pattern summary, and the local-first/TDN lookup strategy
native-functions.md	Looking up exact syntax, parameters, and return value of a specific native function
sx-dictionary.md	Understanding SX1-SX9/SIX table structure and programmatic usage of the data dictionary
sx3-common-fields.md	Validating whether a custom or standard field exists on a table before referencing it in code
restricted-functions.md	Checking whether a function/class is internal-only or blocked from compilation before recommending it
rest-api-reference.md	Building or documenting a REST endpoint (FWRest annotations or legacy WsRestFul)

本技能是TOTVS Protheus生态的快速查询参考指南，涵盖各类别的原生函数语法/参数/返回值（字符串、日期/时间、数组、数据库、界面、网络、JsonObject、ExecAuto等）、SX数据字典（SX1 Perguntas至SXB/SIX）、REST API模式（FWRest注解与传统WsRestFul对比）以及MV_*系统参数。

当用户需要确认原生函数的工作方式、对照SX3验证自定义字段、检查REST端点规范，或核实某个函数不在受限/仅内部使用列表中时（推荐任何函数前务必优先检查此项），可激活本技能。查询策略采用本地优先原则（优先查询native-functions.md、sx-dictionary.md、sx3-common-fields.md、rest-api-reference.md），若本地未找到，则通过

tdn-lookup

技能执行分层TDN在线搜索（依次使用WebFetch API、Playwright API JSON、Playwright HTML）。

本技能不涵盖表/字段使用场景的业务流程上下文（请参见

protheus-business

）、编写查询这些表的SQL语句（请参见

embedded-sql

），也不生成引用这些函数的文档（请参见

documentation-patterns

）。

参考文件	读取场景
reference.md	始终读取 —— 包含函数类别索引、数据字典概览、REST API模式总结，以及本地优先/TDN查询策略
native-functions.md	查询特定原生函数的确切语法、参数和返回值
sx-dictionary.md	了解SX1-SX9/SIX表结构以及数据字典的编程用法
sx3-common-fields.md	在代码中引用字段前，验证表中是否存在某个自定义或标准字段
restricted-functions.md	在推荐函数/类之前，检查其是否为仅内部使用或禁止编译的
rest-api-reference.md	构建或编写REST端点文档（FWRest注解或传统WsRestFul）