shudao-main/shudao-chat-py/接口命名对齐计划.md

接口命名对齐计划（以Go版本为准）

对齐目标: 将Python版本函数名统一为Go版本的命名规范
原则: 仅修改函数名，路由路径保持不变，确保前端调用不受影响

---

需要修改的接口列表

1️⃣ routers/total.py（2处修改）

当前函数名	Go版本函数名	路由路径	状态
policy_file_count	get_policy_file_view_and_download_count	POST /apiv1/policy_file_count	🔄 待修改
download_file	get_pdf_oss_download_link	GET /apiv1/download_file	🔄 待修改

2️⃣ routers/file.py（3处修改）

当前函数名	Go版本函数名	路由路径	状态
oss_upload	upload	POST /apiv1/oss/upload	🔄 待修改
upload_json	upload_ppt_json	POST /apiv1/oss/shudao/upload_json	🔄 待修改
oss_parse	parse_oss	GET /apiv1/oss/parse	🔄 待修改

3️⃣ routers/exam.py（2处修改）

当前函数名	Go版本函数名	路由路径	状态
build_prompt	build_exam_prompt	POST /apiv1/exam/build_prompt	🔄 待修改
build_single_prompt	build_single_question_prompt	POST /apiv1/exam/build_single_prompt	🔄 待修改

---

✅ 已对齐的接口（无需修改）

routers/total.py

• ✅ get_recommend_question → Go: GetRecommendQuestion
• ✅ get_policy_file → Go: GetPolicyFile
• ✅ get_function_card → Go: GetFunctionCard
• ✅ get_hot_question → Go: GetHotQuestion
• ✅ submit_feedback → Go: SubmitFeedback
• ✅ like_and_dislike → Go: LikeAndDislike
• ✅ get_user_data_id → Go: GetUserDataID

routers/chat.py

• ✅ send_deepseek_message → Go: SendDeepSeekMessage
• ✅ get_history_record → Go: GetHistoryRecord
• ✅ delete_conversation → Go: DeleteConversation
• ✅ delete_history_record → Go: DeleteHistoryRecord
• ✅ stream_chat → Go: StreamChat
• ✅ stream_chat_with_db → Go: StreamChatWithDB
• ✅ guess_you_want → Go: GuessYouWant
• ✅ online_search → Go: OnlineSearch
• ✅ save_online_search_result → Go: SaveOnlineSearchResult
• ✅ intent_recognition → Go: IntentRecognition
• ✅ get_user_recommend_question → Go: GetUserRecommendQuestion
• ✅ save_ppt_outline → Go: SavePPTOutline
• ✅ save_edit_document → Go: SaveEditDocument

routers/file.py

• ✅ upload_image → Go: UploadImage
• ✅ get_file_link → Go: GetFileLink

routers/knowledge.py

• ✅ get_chromadb_document → Go: GetChromaDBDocument
• ✅ advanced_search → Go: AdvancedSearch

routers/points.py

• ✅ get_balance → Go: GetBalance
• ✅ consume_points → Go: ConsumePoints
• ✅ get_consumption_history → Go: GetConsumptionHistory

routers/exam.py

• ✅ re_modify_question → Go: ReModifyQuestion
• ✅ re_produce_single_question → Go: ReProduceSingleQuestion

routers/hazard.py

• ✅ hazard → Go: Hazard
• ✅ save_step → Go: SaveStep

routers/scene.py

• ✅ get_history_recognition_record → Go: GetHistoryRecognitionRecord
• ✅ get_recognition_record_detail → Go: GetRecognitionRecordDetail
• ✅ get_third_scene_example_image → Go: GetThirdSceneExampleImage
• ✅ get_latest_recognition_record → Go: GetLatestRecognitionRecord
• ✅ submit_evaluation → Go: SubmitEvaluation
• ✅ delete_recognition_record → Go: DeleteRecognitionRecord

---

📋 修改执行顺序

1. routers/total.py - 修改2个函数名
2. routers/file.py - 修改3个函数名
3. routers/exam.py - 修改2个函数名

总计: 7个函数需要重命名

---

⚠️ 重要说明

1. 仅修改函数名，路由装饰器（@router.get/post）中的路径保持不变
2. 函数内部逻辑完全不变
3. 确保前端调用不受影响（路由路径未改变）
4. 命名规范:
   • Go版本：大驼峰（PascalCase）如 GetPolicyFile
   • Python版本：蛇形（snake_case）如 get_policy_file
   • 转换规则：GetPolicyFile → get_policy_file

---

生成时间: 2026-04-03
状态: 待执行