thinglinks-skills

Use when developing the ThingLinks frontend console repo thinglinks-web-pro (Vue3 + Vben Admin + Ant Design Vue + Vite + TypeScript + Pinia): building IoT pages under src/views/iot (device / product / rule / OTA / operationMaintenance debug / accessControl), defining API calls with defHttp, using shared IoT components (IotProductPicker, IotDevicePicker, ProductTopicPicker, ScriptDebugPanel, ScriptTemplatePicker), the rule script Groovy debug panel, Vben BasicForm/BasicTable/BasicModal with useForm/useTable/ useModal, the CodeEditor (codemirror), menu-driven routing + v-hasPermission, adding i18n (zh-CN/en-US/ja), or drawing flow diagrams (Excalidraw). Trigger whenever the user works on the 前端 / 控制台 / Vue page / 脚本调试面板 / 物模型编辑 of ThingLinks.

Use when developing the ThingLinks BifroMQ MQTT broker plugins repo bifromq-plugin-pro (com.mqttsnet.thinglinks, BifroMQ 3.3.5 SPI): the auth-provider plugin (IAuthProvider — device connect authentication + publish/subscribe ACL with fast-path metadata rules, HTTP fallback, Caffeine cache, MqttTopicMatcher + placeholder replacement), the event-collector plugin (IEventCollector — report() → EventTypeEnum → Kafka topics feeding mqs, connect/close/kicked/ping/sub/pub/dist events), the setting-provider plugin (ISettingProvider, -Dsetting_provide_init_value=true), or the resource-throttler plugin (IResourceThrottler). Trigger whenever the user works on BifroMQ auth/ACL, device connect/disconnect events, the EventTypeEnum ↔ DeviceActionTypeEnum mapping, Kafka event topics, or deploying plugins into BifroMQ (standalone.yml FQN).

Use when developing on the ThingLinks cloud platform (com.mqttsnet.thinglinks), across three domains. (1) IoT: Groovy device-uplink rule scripts (规则脚本), the protocol envelope (head/dataBody/dataSign, cipherFlag), custom uplink TopicHandler, downlink commands via DeviceDownlinkFacade, thing-model, device/product cache, TDengine + device shadow, ACL / MQTT topic matching, WS downlink broadcast, the uplink bus (DeviceEventProcessor / TopicHandler). (2) System foundation: the reactive WebFlux gateway (Sa-Token auth, Nacos routing, Sentinel), oauth login/token (Sa-Token grant types), the system/base modules (Def* vs Base*), the boot/cloud Facade duality, and the DATASOURCE_COLUMN multi-tenant model (dynamic datasource + created_org_id tenant line). (3) Video: the GB28181 streaming platform (ZLMediaKit hooks, SIP, RTP). Trigger whenever the user mentions ThingLinks, 规则脚本, 设备上行/下行, 物模型, 设备影子, 网关/鉴权/Sa-Token, 多租户, 流媒体/GB28181, or the gateway/oauth/system/base/broker/mqs/rule/ link/video modules — even without saying

Use when working on the ThingLinks framework foundation repo thinglinks-util-pro (com.mqttsnet.basic): the protocol-starter (ProtocolMessageAdapter / envelope encode & decode / SM4 & AES encryption / SHA256 dataSign / EncryptionDetailsDTO), the groovy-engine-starter (EngineExecutor / ExecuteParams binding / GroovyCompiler / ScriptRegistry hot-reload cache), or thinglinks-core utilities (SnowflakeIdUtil, LampJacksonModule Long-to-String serialization, MqttTopicMatcher, TopicPlaceholders, DateUtils, JsonUtil, Sm3/Sm4/AES crypto). Trigger whenever the user touches the protocol envelope codec, the Groovy script engine internals, or shared util classes — especially changes with global blast radius (Jackson serialization, snowflake IDs, topic matching).