# 常见 Use Cases

这份文件是给 Agent 看的快速案例库。

原则：

- 先找和用户问题最接近的案例
- 先用 [能力矩阵](capability-matrix.md) 判断当前问题属于哪一类能力
- 所有数据查询都必须先完成 iFinD 鉴权
- 能用 `smart-query` 时不要先手写 `api-call`
- 如果案例和当前请求明显不匹配，就回到 `routing.md`

## 1. 个股最新价

用户问法：

- `看看贵州茅台现在股价`
- `宁德时代最新价`
- `查一下 600519 行情`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "看看贵州茅台现在股价"
```

预期路由：

- intent: `quote_realtime`
- endpoint: `/real_time_quotation`
- if iFinD fail: 返回 iFinD 错误，不使用其它数据源

## 2. 个股近一段时间走势

用户问法：

- `看下宁德时代近一个月走势`
- `贵州茅台最近一周表现`
- `看 300750 历史行情`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "看下宁德时代近一个月走势"
```

预期路由：

- intent: `quote_history`
- endpoint: `/cmd_history_quotation`
- if iFinD fail: 返回 iFinD 错误，不使用其它数据源

## 3. 大盘或指数快照

用户问法：

- `看一下大盘`
- `看看指数`
- `沪深300现在怎么样`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "看一下大盘"
```

预期路由：

- intent: `market_snapshot`
- endpoint: `/real_time_quotation`
- if iFinD fail: 返回 iFinD 错误，不使用其它数据源

默认指数包：

- 上证指数
- 深证成指
- 创业板指
- 沪深300

## 4. 基础财务指标

用户问法：

- `看看宁德时代基本面`
- `贵州茅台估值怎么样`
- `看下 300750 的财务和市盈率`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "看看宁德时代基本面"
```

预期路由：

- intent: `fundamental_basic`
- endpoint: `/smart_stock_picking`
- if iFinD fail: 返回 iFinD 错误或权限问题

## 5. 涨停数据

用户问法：

- `今天的A股涨停数据`
- `今日涨停`
- `涨停板`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "今天的A股涨停数据"
```

预期路由：

- intent: `limit_up_screen`
- endpoint: `/smart_stock_picking`
- if iFinD fail: 返回 iFinD 错误，不使用其它数据源

## 6. A 股榜单

用户问法：

- `A股成交额榜前十`
- `今日涨幅榜`
- `跌幅榜前二十`
- `量比榜`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "A股成交额榜前十"
```

预期路由：

- intent: `leaderboard_screen`
- endpoint: `/smart_stock_picking`
- if iFinD fail: 返回 iFinD 错误，不使用其它数据源

## 7. 个股画像 / 主营业务

用户问法：

- `贵州茅台主营业务是什么`
- `宁德时代公司简介`
- `这家公司是做什么的`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "贵州茅台主营业务是什么"
```

预期路由：

- intent: `entity_profile`
- endpoint: `/smart_stock_picking`
- if iFinD fail: 返回 iFinD 错误或权限问题

## 8. 资金流

用户问法：

- `今天主力资金流入前十`
- `主力资金净流入排行`
- `宁德时代资金流向`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "今天主力资金流入前十"
```

预期路由：

- intent: `capital_flow`
- endpoint: `/smart_stock_picking`
- if iFinD fail: 返回 iFinD 错误或权限问题

## 9. A 股常见数据查询

用户问法：

- `贵州茅台最近公告`
- `贵州茅台分红记录`
- `贵州茅台龙虎榜`
- `宁德时代融资余额和北向持股情况`
- `宁德时代限售解禁安排`
- `宁德时代所属概念和产业链`
- `明天A股有哪些新股申购`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "宁德时代融资余额和北向持股情况"
```

预期路由：

- intent: `generic_smart_query`
- endpoint: `/smart_stock_picking`
- 默认把用户原问题作为 `searchstring`；口语“有啥/怎么样/啥消息”会先改写成 iFinD 更稳定的正式查询词
- if iFinD fail: 返回 iFinD 错误，不使用其它数据源

## 10. 交易日 / 休市日

用户问法：

- `下一个交易日是什么时候`
- `下个交易日是哪天`
- `明天开不开盘`
- `今天A股休市吗`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "下个交易日是哪天"
```

预期路由：

- intent: `trading_calendar`
- endpoint: `/date_sequence`
- 返回数据中的 `time` 字段为 iFinD 交易日序列

处理原则：

- 不要把这类问法误交给 `/smart_stock_picking`
- 不要让 Agent 自己猜休市日；以 iFinD `/date_sequence` 返回的 `time` 为准

## 11. 复杂自然语言筛选

用户问法：

- `筛一下新能源车产业链里市盈率低于30且近一个月放量的股票`
- `查一下贵州茅台近三年营收和毛利率`
- `找一下今天主力资金流入靠前的半导体股票`

建议调用：

```bash
python3 {baseDir}/scripts/ifind_cli.py smart-query --query "筛一下新能源车产业链里市盈率低于30且近一个月放量的股票"
```

预期路由：

- intent: `generic_smart_query`
- endpoint: `/smart_stock_picking`
- 直接把用户原问题作为 `searchstring`

处理原则：

- 不要让 Agent 先手写 `api-call`
- 先让 iFinD 自然语言能力处理
- iFinD 返回失败后，再考虑 `endpoint-list` 或明确说明当前未覆盖

## 12. 不要乱猜的请求

用户问法：

- `帮我找贵州茅台公告PDF下载链接并按日期排序`
- `把所有年报原文下载地址列出来`
- `找公告附件全文`

处理方式：

1. 先运行 `smart-query`
2. 如果返回 `manual_api_lookup_required`，就读 `routing.md`
3. 如果仍没有明确接口，就直接告诉用户：

`当前 tonghuashun-ifind-skill skill 没有稳定覆盖这个 iFinD 能力。`