PCFAnalysis/README.md

# PCF 焊接数据导入生成工具

这是一个 Windows 本地/内网 Web 工具。用户在浏览器上传多个 `.pcf` 文件后，系统解析 `WELD` 焊口段，并生成基于 `焊接数据导入模版.xls` 的导入文件。

## 功能

- 多文件上传 `.pcf`
- 按规则解析标准 PCF 字段
- 使用 `deepseek-v4-flash` 辅助识别非标准字段名
- 生成 `.xls`、问题清单 `.csv`、解析报告 `.json`
- 不依赖 Microsoft Excel

## 启动

首次离线安装：

```powershell
.\scripts\install_offline.ps1
```

启动服务：

```powershell
.\scripts\run.ps1
```

浏览器打开：

```text
http://127.0.0.1:7001
```

## DeepSeek 配置

未配置密钥时，系统仍会按规则生成 Excel，只跳过智能字段映射。密钥在 `config/mapping.yaml` 中配置：

```yaml
deepseek:
  model: deepseek-v4-flash
  base_url: https://api.deepseek.com
  api_key: "你的密钥"
  confidence_threshold: 0.85
```

默认模型是：

```text
deepseek-v4-flash
```

## 离线依赖包

`vendor/wheels/` 用于存放离线 wheel。联网开发机可运行：

```powershell
.\scripts\download_wheels.ps1
```

然后把整个项目目录复制到离线 Windows 环境。

## 测试

```powershell
.\.venv\Scripts\python.exe -m pytest
```

## 第三方接口调用

页面上传和 URL 接口复用同一套解析逻辑。

```http
POST /api/AnalysisPcf
Content-Type: application/json
```

请求体：

```json
{
  "attachment_url": "https://example.com/demo.pcf"
}
```

`attachment_url` 也支持服务端可访问的本地文件：

```json
{
  "attachment_url": "D:\\数据\\样例\\demo.pcf"
}
```

或 `file:///`：

```json
{
  "attachment_url": "file:///D:/数据/样例/demo.pcf"
}
```

也可以传多个附件：

```json
{
  "attachment_urls": [
    "https://example.com/a.pcf",
    "https://example.com/b.zip"
  ]
}
```

返回内容包含：

- `tables.import_columns`：导入数据列定义，包含英文 `key` 和中文 `label`
- `tables.import_rows`：导入文件数据，字段名使用英文 `key`
- `tables.issue_rows`：问题清单数据
- `report`：解析报告 JSON

该接口只返回 JSON 数据，不生成下载文件，也不返回 `downloads`。

附件引用支持 `.pcf` 和包含 `.pcf` 的 `.zip`。本地文件路径按服务端机器的文件系统解析。