---
name: sessions-analysis
description: 查询指定日期的 QA 客服问答记录。当用户询问「昨天/今天客户问了哪些问题」「某天的问答记录」「QA 记录查询」时使用。默认从 ai-cs-qa 会话日志目录读取。
---

# QA 记录查询

从 ai-cs-qa 会话日志中按日期汇总用户提问与助手回答，用于查看某天的客服问答记录。

## Processing Mode

**STRICT SERIAL PROCESSING ONLY** — 单次顺序执行，不拆分子任务、不并行。

## Prerequisites

- Python 3.10+
- 日志目录可读（默认 `/home/node/.openclaw/agents/ai-cs-qa/sessions/`）

## 默认日志目录

- **默认路径**：`/home/node/.openclaw/agents/ai-cs-qa/sessions/`
- 支持当前日志（`*.jsonl`）与轮转日志（`*.jsonl.reset.YYYY-MM-DDTHH-MM-SS.*`）
- 若需使用其他目录，通过 `--log-dir` / `-d` 指定

## Usage

当用户要查看某天的 QA 记录时：

1. **解析日期**：从用户表述推断查询日期（如「昨天」「今天」「2026-03-05」），格式统一为 `YYYY-MM-DD`。
2. **执行脚本**（在 workspace 或 skill 目录下用 uv 运行）：

```bash
uv run {baseDir}/scripts/ana_logs.py [YYYY-MM-DD] [--log-dir /path/to/sessions] [--json]
```

## Parameters

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `date` | 查询日期，格式 `YYYY-MM-DD` | 当天 |
| `--log-dir` / `-d` | 会话日志所在目录 | `/home/node/.openclaw/agents/ai-cs-qa/sessions/` |
| `--json` | 以 JSON 数组输出 | 否（人类可读文本） |

## Output

**不加 `--json` 时**（默认）：

```
[YYYY-MM-DD HH:MM:SS] Q: 用户问题内容
  A: 助手回答内容

[YYYY-MM-DD HH:MM:SS] Q: 下一个问题
  A: 对应回答
```

**加 `--json` 时**：输出 JSON 数组，每项形如 `{"Q": "问题", "DATE": "YYYY-MM-DD HH:MM:SS", "A": "回答"}`。

**向用户展示时建议**：先说明查询日期与记录条数，再按时间顺序列出「时间 - 问题 - 回答」摘要；若记录较多可只展示前 N 条并注明「共 N 条，仅展示前若干条」。

## Example Workflow

- 用户：「昨天客户都问了哪些问题」
  1. 计算昨天日期，如 `2026-03-05`
  2. 执行：`uv run {baseDir}/scripts/ana_logs.py 2026-03-05`
  3. 解析输出，向用户汇总展示

- 用户：「查一下 3 月 4 号的 QA 记录」
  1. 日期：`2026-03-04`
  2. 执行：`uv run {baseDir}/scripts/ana_logs.py 2026-03-04`
  3. 展示结果

- 用户：「从 /data/qa-logs 查今天的问答」
  1. 日期：当天
  2. 执行：`uv run {baseDir}/scripts/ana_logs.py --log-dir /data/qa-logs`
  3. 展示结果

## Notes

- 脚本仅读取可能包含该日期的日志文件（当前日志视为含「今天+昨天」，轮转日志按文件名日期判断），再按记录内时间戳过滤到指定日期。
- 若目录不存在或无可读日志，脚本不会报错但结果为空；此时可提示用户检查日志目录或日期。
- `{baseDir}` 指本 skill 根目录（如 `skills/sessions-analysis`），调用时替换为实际路径。
