PCF 焊接数据导入生成工具

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

功能

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

启动

首次离线安装：

.\scripts\install_offline.ps1

如果在线下载 wheel，默认走 https://pypi.org/simple，私有镜像可加 -IndexUrl。

启动服务：

.\scripts\run.ps1

浏览器打开：

http://127.0.0.1:7001

DeepSeek 配置

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

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

默认模型是：

deepseek-v4-flash

离线依赖包

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

.\scripts\download_wheels.ps1

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

测试

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

第三方接口调用

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

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

请求体：

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

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

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

或 file:///：

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

也可以传多个附件：

{
  "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。本地文件路径按服务端机器的文件系统解析。