---
name: hisense-sept-qa-raw-query
description: >-
  Query Hisense September agentic projects for qa_raw and qa_product_raw
  (HISENSE-HIST). Before any API call, must confirm BOTH batch date and project
  id together. Returns id, project_name, total, qa_raw_list, qa_product_raw_list.
  Use when user asks for 9月项目、问答底表、商品卡、qa_raw、qa_product_raw、
  HISENSE-HIST、temp0923, or 批次日期 / 项目id.
---

# 海信 9 月 qa_raw / qa_product_raw 查询

从 `https://resource-api.cemeta.cn` 拉 9 月项目，再按批次查问答底表与商品卡表，组装返回 JSON。

配置：`config/config.dev.yaml` → `haoxian.base_url` / `haoxian.token`（Header `x-token`）。本机可用 `http://localhost:9999` 代替 base（路径相同）。

## 必选前置输入（缺一不可，须同时确认）

**使用本 skill 时，执行任何接口调用之前，必须先同时拿到下面 1 和 2。缺任意一项都停下来，两项齐了再继续后续流程。不要猜、不要沿用上次对话默认值、不要只拿到一个就先跑一半。**

| # | 必选项 | 示例 |
|---|--------|------|
| 1 | 查询的批次日期 | `20260919`（`YYYYMMDD`） |
| 2 | 项目 id | `1096` |

**一次性原文提示用户（同一条消息里同时确认两项）：**

> 请同时确认后回复：
> 1. 查询的批次日期（示例：20260919）
> 2. 项目id（示例：1096）

用户在同一轮或连续回复中给出 1 和 2 后，再执行下方「执行流程」。若只给了一项，用同样提示补要缺失项，仍不要开查。

## 执行流程

### 1. 拉 9 月项目列表

```
GET {base_url}/api/agentic-project/project?page=1&page_size=999&listed=all
Header: x-token
```

过滤（必须同时满足）：

- `listed = 1`
- `status = 'running'`
- `end_month = '2026-09'`

取出全部 `id`、`project_name`。用用户输入的项目 id 在列表中解析 `project_name`（找不到也继续查表，name 可为空并注明）。

### 2. 拼接 crawl_batch_id

```
HISENSE-HIST-{project_id}-{批次日期}
```

例：`HISENSE-HIST-1096-20260919`

### 3. 查问答底表 qa_raw

```
GET {base_url}/api/geo_label/l1/qa_raw?project_id={id}&crawl_batch_id={crawl_batch_id}&page=1&page_size=50
Header: x-token
```

翻页直到收齐 `data.total`。接口列表字段为 `data.items`。

### 4. 查商品卡表 qa_product_raw

```
GET {base_url}/api/geo_label/l1/qa_product_raw?project_id={id}&crawl_batch_id={crawl_batch_id}&page=1&page_size=50
Header: x-token
```

同样翻页收齐；接口列表字段为 `data.items`。

### 5. 组装返回 JSON

**对外不要输出 `items`。** `data.items` 分别映射为：

- qa_raw → `qa_raw_list`
- qa_product_raw → `qa_product_raw_list`

`total` 取 **qa_raw** 的 `data.total`。

```json
{
  "id": 1096,
  "project_name": "500L左右冰箱推荐",
  "total": 227,
  "code": 0,
  "ok": true,
  "crawl_batch_id": "HISENSE-HIST-1096-20260919",
  "qa_raw_list": [],
  "qa_product_raw_list": []
}
```

必须包含：`id`、`project_name`、`total`、`qa_raw_list`（全量明细）、`qa_product_raw_list`（全量明细）。体积大时落盘并告知路径，例如：

`haoxian/skills/temp0923/data/qa_raw_{批次}/{id}_response.json`

## 推荐脚本

```bash
# 可选：刷新 9 月项目缓存
python3 haoxian/skills/temp0923/scripts/query_qa_raw.py list-projects

# 必选参数：--batch、--id
python3 haoxian/skills/temp0923/scripts/query_qa_raw.py project --batch 20260919 --id 1096
```

脚本 stdout 即为上述返回结构。本地缓存目录：`haoxian/skills/temp0923/data/`。

## 注意

- Token 只读配置，勿写入 skill、勿提交仓库。
- `total=0` 或空列表均为有效结果。
- 翻页建议 `page_size=50`，失败重试，避免一次过大导致断连。