钢联AI - 智能问数

SKILL.md 节选

# Mysteel Price Search

大宗商品与宏观经济数据综合查询技能，基于Mysteel数据平台提供专业、全面的价格数据服务。

## 未配置API密钥时的引导回复

当用户查询价格数据但尚未配置API密钥时，请按以下引导回复用户：

看起来还没有配置 API 密钥。要使用钢联数据查询，需要先获取一个 API Key。

**获取方式：** 浏览器打开 [钢联行业 Skills 开放平台](https://data.mysteel.com/skills/index.html)，在「API Key」一栏点击「生成」或「复制」即可获取。

请问您是否已有钢联数据的 API Key？如果有，请直接告诉我，我会自动保存并立即为您查询。

### 用户提供API密钥后的处理流程

1. 调用 `python scripts/search.py --api-key "<密钥>" "<查询文本>"` 保存密钥并执行查询
2. 保存成功后告知用户密钥已保存，后续可直接使用

## API 密钥配置

脚本支持多级 API Key 获取方式（按优先级）：

1. **环境变量**（优先级最高）：设置环境变量 `mysteel_skill_auth_key`
   - 操作路径：设置 -> 环境变量 -> 添加变量
   - 变量名：`mysteel_skill_auth_key`
   - 变量值：您的 API 密钥

2. **配置文件**（次优）：在 `references/api_key.md` 文件第一行写入 API 密钥

3. **对话输入**（兜底）：在对话中直接提供 API 密钥
   - 脚本通过 `--api-key` 参数接收用户在对话中提供的密钥
   - **自动保存**：当通过对话输入 API 密钥时，脚本会自动将其保存到 `references/api_key.md` 文件中，供后续使用

如果以上方式都无法获取到 API 密钥，脚本会提示用户进行配置。

## Quick Start

使用 `scripts/search.py` 脚本查询价格数据：

```bash
python scripts/search.py "<查询文本>"
```

### 通过对话提供 API 密钥
当用户在对话中提供 API 密钥时，使用 `--api-key` 参数传入：

```bash
python scripts/search.py "<查询文本>" --api-key "<用户提供的API密钥>"
```

**注意**：通过此方式提供的密钥会自动保存到 `references/api_key.md` 文件中，下次调用时无需再次提供。

## CSV 输出模式（推荐）

将查询结果保存为 CSV 文件，**强烈建议使用过滤参数减少数据量**：

### 基本用法
```bash
python scripts/search.py "螺纹钢最新价格" --csv
```

### 数据过滤参数（重要！）

为避免 LLM 读取过多数据，**请根据需要使用以下参数**：

| 参数 | 说明 | 示例 |
|------|------|------|
| `--limit N` | 限制每个文件最多 N 行数据 | `--limit 10` |
| `--days N` | 仅查询最近 N 天的数据 | `--days 30` |
| `--start-date` | 起始日期（含） | `--start-date 2024-01-01` |
| `--end-date` | 结束日期（含） | `--end-date 2024-01-31` |

### 推荐使用示例

```bash
# 查询最新10条价格（最常用）
python scripts/search.py "螺纹钢最新价格" --csv --limit 10

# 查询最近30天价格
python scripts/search.py "铜期货价格" --csv --days 30

# 查询特定日期范围
python scripts/search.py "热卷价格" --csv --start-date 2024-01-01 --end-date 2024-03-31
```

## 读取已有 CSV 文件

**不要使用 Read 工具读取整个 CSV 文件！** 使用 Bash 工具按需读取：

```bash
# 查看文件元数据（了解数据概况）
head -10 output/螺纹钢.csv

# 仅读取前N行数据
head -20 output/螺纹钢.csv | tail -n +10

# 按日期过滤（使用 grep）
grep -E "^2024-01" output/螺纹钢.csv

# 查看文件统计信息
wc -l output/螺纹钢.csv
```

## CSV 文件格式

CSV 文件包含元数据头注释，格式如下：

```
# index_name: 螺纹钢_上海_HRB400E
# unit: 元/吨
# total_rows: 365
# date_range: 2023-01-15 ~ 2024-01-15
# generated: 2024-01-15 10:30:00
#
date,price,unit,change,change_pct
2024-01-15,3800,元/吨,+20.00,+0.53%
2024-01-14,3780,元/吨,-10.00,-0.26%
```

## 输出示例

```
Generated 2 CSV file(s) in output:
  - 螺纹钢_上海_HRB400E.csv (10 rows, 2024-01-05 ~ 2024-01-15)

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 4 个文件，合计 23.6 KiB