个人任务简介负责项目核心业务功能开发包括 AI 智能评分、文件预览、数据导出等关键功能。这些功能是整个项目的价值核心直接面向用户使用场景实现对项目申报书的自动化AI评分。将申报文件转换为前端可预览的格式支持 PDF 原生预览和 DOCX 转 HTML。将申报评分数据导出为常用格式支持 CSV 和 Excel 导出工作内容AI评分服务评分请求构建定义系统提示词明确评分维度和输出格式主函数判断是否配置了模型未配置时使用规则回退。系统提示词确保 AI 理解评分标准输出结构化 JSON支持配置化可切换不同模型供应商异常时自动回退到规则评分保证服务可用Prompt Engineering提示词工程 是调教 AI 模型的核心技术提示词包含角色定义你是项目申请书评审助手 - 让模型扮演专业评审评分维度实用性 60 分 创新性 40 分 - 明确打分标准输出格式必须包含指定字段 - 强制结构化输出特殊要求措辞尽量多样化 - 避免重复评语实用性维度细分为需求、范围、流程、步骤、输出、前景创新性维度细分为大模型、智能体、设计、难度(text or “”) 处理 None 值.strip() 去除首尾空白避免空字符串判断失误文本为空直接回退无需调用 AI节省成本SYSTEM_PROMPT你是项目申请书评审助手。请严格根据以下标准评分并仅返回JSON。 评分结构 1.项目实用性60分来自实际需求、应用范围适合、操作流程简洁、操作步骤明确、应用输出确切、具有实用前景。 2.项目创新性40分合理使用大模型、智能体设计合理技术具有难度工作量适度。 输出字段必须包含practicality_score, innovation_score, total_score, practicality_reason, innovation_reason 要求在不偏离事实的前提下措辞尽量多样化避免多次评分出现完全相同的评语。 asyncdefscore_application_text(text:str|None)-ScorePayload:settingsget_settings()normalized_text(textor).strip()ifnotnormalized_text:return_fallback_score(,reason申请书正文缺失需人工复核。)if(settings.model_provider.lower()openai-compatibleandsettings.model_base_urlandsettings.model_api_key):try:returnawait_score_with_openai_compatible(normalized_text)exceptException:return_fallback_score(normalized_text,reason模型调用失败已回退到规则评分建议人工复核。)return_fallback_score(normalized_text,reason未配置模型密钥当前使用规则评分建议配置模型以启用AI评审。)OpenClaw兼容接口调用使用 httpx 异步调用 OpenAI 兼容接口设置 temperature0.55 保证输出稳定性又有多样性使用 response_format 强制 JSON 输出由此可以使用httpx异步调用OpenClaw兼容接口设置 temperature0.55保证输出稳定性又有多样性。使用 response_format 强制 JSON 输出essages 格式OpenAI Chat API 标准格式system 消息系统提示词全局指导user 消息用户输入申报书内容temperature 参数0 完全确定性1 完全随机0.55 平衡稳定性和多样性response_format强制 JSON 输出防止模型返回 Markdown 包裹的 JSONhttpxPython 异步 HTTP 客户端类似 requests 的异步版本AsyncClient 自动管理连接池高并发下性能优异timeout60.0AI 模型响应可能很慢涉及模型推理60 秒足够async with 确保请求结束后自动关闭连接asyncdef_score_with_openai_compatible(text:str)-ScorePayload:settingsget_settings()headers{Authorization:fBearer{settings.model_api_key},Content-Type:application/json}payload{model:settings.model_name,temperature:0.55,messages:[{role:system,content:SYSTEM_PROMPT},{role:user,content:f申请书内容如下:\n{text}\n请直接返回JSON。},],response_format:{type:json_object},}asyncwithhttpx.AsyncClient(timeout60.0)asclient:responseawaitclient.post(settings.model_base_url.rstrip(/)/chat/completions,headersheaders,jsonpayload,)response.raise_for_status()dataresponse.json()规则回退评分使用关键词匹配计算基础分再根据关键词命中数量加分上限封顶列表推导式遍历关键词列表.lower() 统一大小写关键词和文本都转小写命中则计数 1sum() 汇总命中总数评分公式实用性基础分 20 命中数×5上限 60创新性基础分 12 命中数×4上限 40def_fallback_score(text:str,reason:str|NoneNone)-ScorePayload:practicality_keywords[需求,应用,流程,步骤,输出,落地,场景,实用]innovation_keywords[大模型,智能体,agent,算法,多模态,自动化,推理,检索]practicality_hitssum(1forkeywordinpracticality_keywordsifkeyword.lower()intext.lower())innovation_hitssum(1forkeywordininnovation_keywordsifkeyword.lower()intext.lower())practicality_scoremin(20practicality_hits*5,60)innovation_scoremin(12innovation_hits*4,40)total_scorepracticality_scoreinnovation_scorereturnScorePayload(practicality_scorepracticality_score,innovation_scoreinnovation_score,total_scoretotal_score,practicality_reasonf规则评分命中实用关键词{practicality_hits}个,innovation_reasonf规则评分命中创新关键词{innovation_hits}个,needs_human_reviewreasonisnotNone)文件预览服务DOCX转HTML提取DOCX段落文本拼接为HTML使用标签保留格式python-docx 库内部解析 .docx 文件本质是 ZIP 包含 XMLdoc.paragraphs 返回所有段落对象p.text 获取段落文本内容(p.text or “”) 处理 None空段落可能返回 Noneif text 过滤空段落Word 中的回车会产生空段落缓存机制检查输出文件是否存在st_mtime 是文件最后修改时间如果 HTML 文件比 DOCX 文件新说明之前已转换直接返回缓存避免重复转换提升性能def_docx_to_html(input_path:Path,output_dir:Path)-Path:output_dir.mkdir(parentsTrue,exist_okTrue)outoutput_dir/f{input_path.stem}.htmlifout.exists()andout.stat().st_mtimeinput_path.stat().st_mtime:returnout docDocument(str(input_path))lines:list[str][]forpindoc.paragraphs:text(p.textor).strip()iftext:lines.append(text)body\n\n.join(lines)html(!doctype htmlhtmlheadmeta charsetutf-8/meta nameviewport contentwidthdevice-width,initial-scale1/titleApplication Preview/titlestylebody{font-family:Segoe UI, PingFang SC, sans-serif;margin:0;padding:20px;line-height:1.6;color:#123456}pre{white-space:pre-wrap;word-break:break-word;font-family:inherit;margin:0;}/style/headbodyfpre{escape(body)}/pre/body/html)out.write_text(html,encodingutf-8)returnout预览入口函数PDF直接返回DOCX转化为HTML提供统一预览入口根据类型进行处理PDF是浏览器原生支持的格式Chrome、Edge、Firefox 内置 PDF 渲染器直接返回文件路径和 application/pdf 类型浏览器会显示内置 PDF 阅读器DOCX浏览器不支持直接显示必须转化为HTMLtext/html; charsetutf-8 告诉浏览器这是 HTML 文档使用 UTF-8 编码defget_preview_file(file_path:str)-PreviewResult:ensure_storage_dirs()settingsget_settings()srcPath(file_path)ifnotsrc.exists():raisePreviewError(source file not found)suffixsrc.suffix.lower().lstrip(.)ifsuffixpdf:returnPreviewResult(pathstr(src),media_typeapplication/pdf)ifsuffixdocx:out_dirsettings.preview_storage_path html_path_docx_to_html(src,out_dir)returnPreviewResult(pathstr(html_path),media_typetext/html; charsetutf-8)raisePreviewError(unsupported preview type)数据导出服务CSV导出使用标准库csv模块utf-8-sig 编码带 BOMExcel 打开不乱码StringIO 在内存中创建文件对象数据存在内存中不写入磁盘适合小中型数据导出getvalue() 获取 StringIO 中的所有内容encode(“utf-8-sig”)UTF-8 编码 BOM (Byte Order Mark)BOM 是 3 字节EF BB BFExcel 看到 BOM 会自动以 UTF-8 打开否则可能以系统默认编码GBK打开导致乱码由于csv不支持布尔类型因此要将布尔值转化为数值True → 1False → 0defbuild_csv_bytes(rows:Iterable[dict])-bytes:outputio.StringIO()writercsv.writer(output)writer.writerow([id,student_name,student_id,project_title,practicality,innovation,total,needs_human_review])forrowinrows:writer.writerow([row.get(id),row.get(student_name),row.get(student_id),row.get(project_title),row.get(practicality_score),row.get(innovation_score),row.get(total_score),1ifrow.get(needs_human_review)else0,])returnoutput.getvalue().encode(utf-8-sig)Excel导出Excel格式更加规范可支持更多数据并且内存缓冲减少磁盘IO因此可以使用excel格式。使用 openpyxl 库创建 Excel 文件, 写入内存缓冲区避免生成临时文件Workbook 创建新的 Excel 工作簿active 获取当前活动工作表默认有一个defbuild_xlsx_bytes(rows:Iterable[dict])-bytes:wbWorkbook()wswb.active ws.titlescoresws.append([id,student_name,student_id,project_title,practicality,innovation,total,needs_human_review])forrowinrows:ws.append([row.get(id),row.get(student_name),row.get(student_id),row.get(project_title),row.get(practicality_score),row.get(innovation_score),row.get(total_score),1ifrow.get(needs_human_review)else0,])bufio.BytesIO()wb.save(buf)returnbuf.getvalue()总结本阶我主要完成了三项关键功能AI 评分服务实现了项目申报书的智能评审功能。通过定义系统提示词将评分维度量化为实用s性60分和创新性40分并调用OpenAI兼容接口获取结构化评分结果。同时设计了规则回退机制当AI模型不可用时通过关键词匹配算法提供基础评分确保服务高可用文件预览服务解决了申报文件在线查看需求。针对PDF和DOCX两种常用格式采用差异化处理策略PDF直接返回由浏览器原生渲染DOCX则转换为HTML并注入CSS样式同时加入缓存机制避免重复转换数据导出服务提供了评分结果的导出能力。实现了CSV和Excel两种格式导出使用utf-8-sig编码解决Excel打开CSV乱码问题内存缓冲区方式减少磁盘IO操作本阶段工作使项目具备了AI智能评分、文件预览、数据导出等核心功能为前端提供了完整的业务能力支撑