函数参数更新总结.md 2.8 KB

process_webpage_with_QWen 函数参数更新总结

更新概述

成功修改了 process_webpage_with_QWen 函数,添加了新的 publish_time 参数,并更新了所有相关的调用位置。

主要修改

1. 函数签名更新

文件: app/core/data_parse/parse_web.py

  • 原签名: process_webpage_with_QWen(markdown_text)
  • 新签名: process_webpage_with_QWen(markdown_text, publish_time)
  • 功能: publish_time 参数用于设置 career_path 中的 date 字段值

2. API接口更新

文件: app/api/data_parse/routes.py

  • 更新了 /webpage-parse 接口
  • 新增 publish_time 必填参数验证
  • 更新请求体示例和文档说明
  • 修改函数调用以传递两个参数

新的请求体格式:

{
    "markdown_text": "网页内容...",
    "publish_time": "2025-01-15"
}

3. 测试文件更新

更新了以下测试文件中的函数调用:

test_qwen_extraction.py

  • 更新了 test_single_person_extraction() 函数
  • 更新了 test_multiple_person_extraction() 函数
  • 所有调用都添加了 "2025-01-15" 作为 publish_time 参数

test_webpage_parse.py

  • 更新了 test_single_person() 函数
  • 更新了 test_multiple_persons() 函数
  • 更新了 test_field_validation() 函数
  • 所有调用都添加了 "2025-01-15" 作为 publish_time 参数

quick_test.py

  • 更新了多人员提取测试
  • 添加了 "2025-01-15" 作为 publish_time 参数

功能验证

✅ 测试结果

  • 函数调用成功,参数传递正确
  • career_path 中的 date 字段正确使用了传入的 publish_time 值
  • 所有测试文件都已更新并可正常运行

📊 影响范围

文件类型 修改文件数 主要变更
核心函数 1 添加新参数,修改内部逻辑
API接口 1 更新请求参数验证和调用
测试文件 3 更新所有函数调用

使用说明

函数调用示例

# 新的调用方式
result = process_webpage_with_QWen(markdown_content, "2025-01-15")

API请求示例

curl -X POST http://localhost:5000/api/data-parse/webpage-parse \
  -H "Content-Type: application/json" \
  -d '{
    "markdown_text": "网页内容...",
    "publish_time": "2025-01-15"
  }'

注意事项

  1. 向后兼容性: 此更新不向后兼容,所有调用此函数的地方都必须传递两个参数
  2. 参数格式: publish_time 应为字符串格式,建议使用 "YYYY-MM-DD" 格式
  3. 必填参数: 在API接口中,publish_time 是必填参数,不提供会返回400错误

总结

✅ 所有修改已完成并验证通过
✅ 函数参数传递正确
✅ career_path 日期字段使用指定的 publish_time
✅ 测试文件全部更新完毕