# 金融文本大模型打标项目
这是一个给初学者使用的金融文本大模型打标项目，分两步完成：
1. **命令行打标**：跑通大模型调用，终端输出清晰摘要。
2. **网页打标**：点选任务和示例数据，左右对比提示词与模型结果。
## 一、PyCharm 快速运行（推荐）
### 1. 用 PyCharm 打开项目
请打开 **`financial-labeling-project` 文件夹**作为项目根目录（不要只打开上一级 `Day_03`），否则运行配置路径会对不上。
### 2. 三种运行方式（任选）
**方式 A：右上角运行配置（最稳）**
项目已内置 `.run/` 配置，打开 PyCharm 后可在右上角直接选：
| 运行配置 | 作用 |
| --- | --- |
| `Run Web` | 启动网页 http://127.0.0.1:8000 |
| `Label Classify` | 命令行分类打标 |
| `Label Extract` | 命令行抽取打标 |
| `Label Match` | 命令行匹配打标 |
**方式 B：右键运行 Python 文件**
- 右键 `run_web.py` → **Run 'run_web'**
- 右键 `label.py` → **Run 'label'**（需在 Run Configuration 里补参数 `--task classify`）
**方式 C：README 里一键运行**
下文命令块使用 `bash` / `powershell` 标记。在 PyCharm 打开本 README 时，代码块左侧会出现 **绿色运行按钮**（需 2023.1+）。
> 若看不到运行按钮：确认代码块语言是 `bash` 或 `powershell`，不要用 `text`。
### 3. 配置环境变量
PyCharm：**Run → Edit Configurations → Environment variables** 添加：
```text
DASHSCOPE_API_KEY=你的密钥
```
或在 Windows 用户环境变量中配置 `DASHSCOPE_API_KEY`。
API Key **不要**写进 `config.yaml`。
## 二、项目结构
```text
financial-labeling-project/
bootstrap.py ← 自动切换工作目录，PyCharm 任意位置可运行
config.yaml ← 模型、路径、输出格式配置
label.py ← 命令行入口
run_web.py ← 网页入口
.run/ ← PyCharm 运行配置
requirements.txt
backend/
prompts/
data/
frontend/
outputs/
```
## 三、准备环境
安装依赖（PyCharm README 可点击运行）：
```bash
pip install -r requirements.txt
```
Windows PowerShell 等价命令：
```powershell
pip install -r requirements.txt
```
## 四、config.yaml 说明
```yaml
llm:
model: qwen-plus
temperature: 0
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
timeout_seconds: 60
generator:
model: qwen-plus
temperature: 0.85
timeout_seconds: 90
max_retries: 3
hard_temperature: 0.95
hard_max_retries: 5
hard_timeout_seconds: 120
cli:
output_mode: summary # summary | json | quiet
show_raw_output: false
text_preview_length: 60
save_json: true
```
## 五、第一步：命令行打标
默认运行（清晰摘要输出）：
```bash
python label.py --task classify
```
其他常用命令：
```bash
python label.py --task extract
python label.py --task match
python label.py --task classify --difficulty hard
python label.py --task classify --output json
python label.py --task classify --output quiet
```
终端默认显示：**标准 vs 模型对比 + 正确/错误判断 + 汇总表**。
完整 JSON（含 `expected`、`is_correct`）保存到 `outputs/{task}_results.json`。
## 六、第二步：统一网页打标
推荐启动（PyCharm 可直接运行 `run_web.py`，或 README 点击运行）：
```bash
python run_web.py
```
Windows PowerShell：
```powershell
python run_web.py
```
备选（需已安装 uvicorn）：
```bash
uvicorn backend.main:app --reload --app-dir .
```
打开页面：
```text
http://127.0.0.1:8000
```
`bootstrap.py` 会自动把工作目录切到项目根，一般**不需要**再手动 `cd financial-labeling-project`。
### 页面功能
- **点选任务 / 难度 / 示例**
- **生成测试数据**：困难样本含程序校验，不合格自动重试
- **左右对比**：左蓝提示词，右绿结果
### 后端接口
| 接口 | 作用 |
| --- | --- |
| `GET /prompt/{task}` | 获取提示词 |
| `GET /samples/{task}?difficulty=easy` | 获取文件中的示例 |
| `POST /generate-sample` | 生成一条测试数据 |
| `POST /label` | 提交打标 |
## 七、学生最需要知道的位置
| 想做的事 | 修改位置 |
| --- | --- |
| 改模型、温度、输出格式 | `config.yaml` |
| 修改分类提示词 | `prompts/classify.txt` |
| 修改抽取提示词 | `prompts/extract.txt` |
| 修改匹配提示词 | `prompts/match.txt` |
| 修改分类测试数据 | `data/classify_samples.json`（含 `expected_category`） |
| 修改抽取测试数据 | `data/extract_samples.json`（含中文 `expected_result`） |
| 修改匹配测试数据 | `data/match_samples.json`（含 `expected_is_match`） |
| 查看命令行打标结果 | `outputs/` |
## 八、常见问题
| 问题 | 解决办法 |
| --- | --- |
| README 命令块没有绿色运行按钮 | 确认是 `bash`/`powershell` 代码块；升级 PyCharm 2023.1+ |
| PyCharm 报 `No module named 'backend'` | 用 PyCharm 打开 `financial-labeling-project` 文件夹；或运行 `run_web.py` / `label.py` |
| 点击「生成测试数据」无反应 | 浏览器 F12 查 JS 错误；Ctrl+F5 刷新 |
| 一直卡在「生成中...」 | 检查 `DASHSCOPE_API_KEY`、网络 |
| `DASHSCOPE_API_KEY 未设置` | 在 PyCharm Run Configuration 或系统环境变量中配置 |
## 九、课堂实验建议
1. PyCharm 选 **Label Classify** 运行，看终端汇总表。
2. 改 `config.yaml` 里 `cli.output_mode` 为 `json`，再运行一次。
3. 删分类提示词里的「只能从给定类别中选择」，重新运行并对比 `outputs/`。
4. 选 **Run Web**，网页中对同一示例重新打标，观察右栏变化。