Data Cache Inspector

---
name: data-cache-inspector
description: 查询并分析 `data_cache` 下的市场数据（股票、指数、板块、市场元数据、strategy_watch）。支持按日期/列/条件读取实际数据行，并进行对比分析（如两日成交额变化）。
---

# 数据缓存查询与分析器

在不修改文件的前提下查询并分析市场数据缓存。
优先采用只读流程，先确认数据可用性，再读取实际数据并输出结论。

# 工作流程

1. 确认缓存根目录为 `data_cache`，列出一级目录。
2. 使用 `references/data-cache-layout.md` 定位子目录与文件类型。
3. 先做可用性盘点：数量、体积、最新时间戳、Schema 与日期范围。
4. 根据问题调用查询工具读取实际数据行（日期过滤、列过滤、条件筛选）。
5. 计算并输出对比指标（差值、环比、占比、排序等）。
6. 明确指出缺失、空目录、字段缺失或超出缓存范围。

# 读取辅助

- 使用 `utils/data_cache.py` 获取规范路径与辅助方法。
- 使用 `utils/metadata/index_data_manager.py`、`utils/metadata/stock_data_manager.py`、`utils/metadata/sector_data_manager.py` 了解字段与结构。
- Skill 脚本入口：`scripts/data_cache_gateway.py`
- 在 Agent Tool-Calling 中优先使用：
  - `data_cache_query_table`：按表名、日期范围、列名、筛选条件读取实际数据行。
  - `compare_market_turnover_dates`：直接比较两日 `market_metadata` 的 `成交总额`。

# 安全预览规则

- 不修改、不覆盖缓存文件。
- 大型 parquet 仅使用 `head()` 或 `limit()` 采样。
- 读取 `.pkl` 或 `.xlsx` 时仅加载必要行/列。
- 列级 Schema 优先从 parquet 元数据读取（避免全量加载）。

# 输出要求

报告以下信息：

- 查询结果中的关键数值（差值、百分比等）