FranklinWH-Toolbox/deploy/kiro/skills/fwh-toolbox-workflow/references/data-direct-query.md

数据直查层（data_* 数据库 / 缓存 / 上游）

直接读数据库、缓存或上游平台，跳过 Service 层。全部只读。仅当 service_* 工具无法满足（自定义 filter、聚合统计、上游原始数据）时使用。

MongoDB

工具	参数	说明
data_mongo_find	collection(必填)、filter(JSON)、limit(默认10,最大100)、skip、sort(JSON)	查询集合文档
data_mongo_count	collection(必填)、filter(JSON,可空)	统计符合条件的文档数

collection 白名单（仅以下集合可查）： SiteInfoManageData、SiteInfoManageRecord、SimCardManage、SimCardMonthlyData、BatchDownloadConfig、SiteAnalysisConfig、StatisticsShutdown、StatisticsAlarm、SiteMonitorConfig、UserInfo、AutoUpdateConfigOption、AutoUpdateConfig、AiChatSessions

示例：

{ "collection": "SiteInfoManageData", "filter": "{\"sn\": \"xxx\"}", "limit": 10, "sort": "{\"createdAt\": -1}" }

用法提示：

• filter / sort 是 JSON 字符串（如 "{\"sn\":\"xxx\"}"）。
• 分页用 skip + limit。
• 优先用对应的 service_* 工具（如站点分析用 service_site_analysis_*），直查仅用于灵活筛选/聚合计数。

Redis

工具	参数	说明
data_redis_get	key、type(string默认/hash/list/set)	读取 key 的值（仅支持 string 和 hash）
data_redis_exists	key	检查 key 是否存在并返回 TTL

PostgreSQL（告警快照）

工具	参数	说明
data_pgsql_query_snapshot_data	sn、date	按 SN 和日期查告警快照数据
data_pgsql_query_snapshot_file_record	file_name	查告警快照文件的解析记录

EMS 参数字典

工具	参数	说明
data_emspara_pid_info	id(PID ID 数字字符串)	通过 PID ID 查宏名和描述
data_emspara_vid_info	id(VID ID 数字字符串)	通过 VID ID 查宏名和描述

用于把 EMS 日志/参数中的数字 PID/VID 翻译成可读含义。

SIM 上游平台

优先用 service_sim_*（见主 SKILL.md 第 4 节）；需上游原始数据时用：

Acceleronix | 工具 | 参数 | 说明 | |------|------|------| | data_sim_acceleronix_card_info | iccid | 单张 SIM 详情 | | data_sim_acceleronix_card_list | page、size | SIM 卡列表 | | data_sim_acceleronix_batch_data_info | iccid_list(逗号分隔)、month(YYYYMM) | 批量用量信息 | | data_sim_acceleronix_data_pool_list | page、size | 流量池列表 | | data_sim_acceleronix_data_pool_sim_info | data_pool_id、page、size | 流量池中的 SIM 详情 |

SmartHub | 工具 | 参数 | 说明 | |------|------|------| | data_sim_smarthub_card_info | giccid | 单张 SIM 详细信息 | | data_sim_smarthub_batch_info | page、size | 批量 SIM 信息 |

注意：Acceleronix 用 iccid，SmartHub 用 giccid；月份参数 Acceleronix 批量用量为 YYYYMM。