# 数据直查层（`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`

示例：
```json
{ "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`。