shudao-main 接口完整清单

生成时间：2026/4/3
检查范围：shudao-main/shudao-go-backend 所有控制器及路由配置

📊 接口统计

前端页面路由: 4个
API接口: 49个
总计: 53个HTTP接口

🌐 一、前端页面路由

序号	路由路径	方法	控制器方法	说明
1	`/`	GET	FrontendController.Index	前端首页
2	`/stream-test`	GET	FrontendController.StreamTest	流式接口测试页面
3	`/simple-stream-test`	GET	FrontendController.SimpleStreamTest	简化版流式接口测试页面
4	`/stream-chat-with-db-test`	GET	FrontendController.StreamChatWithDBTest	流式聊天数据库集成测试页面

🔌 二、API接口（apiv1 命名空间）

1️⃣ 认证模块 (1个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/auth/local_login`	POST	LocalAuthController.LocalLogin	本地登录接口	❌

2️⃣ 聊天对话模块 (16个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/send_deepseek_message`	POST	ChatController.SendDeepSeekMessage	发送DeepSeek消息	✅
2	`/apiv1/get_history_record`	GET	ChatController.GetHistoryRecord	获取历史记录	✅
3	`/apiv1/re_produce_single_question`	POST	ChatController.ReProduceSingleQuestion	重新生成单题	✅
4	`/apiv1/guess_you_want`	POST	ChatController.GuessYouWant	猜你想问	✅
5	`/apiv1/get_user_recommend_question`	GET	ChatController.GetUserRecommendQuestion	用户输入推荐问题	✅
6	`/apiv1/get_file_link`	GET	ChatController.GetFileLink	根据文件名获取链接	✅
7	`/apiv1/delete_conversation`	POST	ChatController.DeleteConversation	删除对话	✅
8	`/apiv1/delete_history_record`	POST	ChatController.DeleteHistoryRecord	删除历史记录	✅
9	`/apiv1/delete_recognition_record`	POST	ChatController.DeleteRecognitionRecord	删除隐患识别历史记录	✅
10	`/apiv1/save_ppt_outline`	POST	ChatController.SavePPTOutline	保存PPT大纲	✅
11	`/apiv1/save_edit_document`	POST	ChatController.SaveEditDocument	AI写作保存编辑文档	✅
12	`/apiv1/online_search`	GET	ChatController.OnlineSearch	联网搜索	✅
13	`/apiv1/save_online_search_result`	POST	ChatController.SaveOnlineSearchResult	保存联网搜索结果	✅
14	`/apiv1/intent_recognition`	POST	ChatController.IntentRecognition	意图识别接口	✅
15	`/apiv1/get_chromadb_document`	GET	ChatController.GetChromaDBDocument	获取ChromaDB文档并生成回答	✅
16	`/apiv1/stream/chat-with-db`	POST	LiushiController.StreamChatWithDB	流式聊天数据库集成接口	✅

3️⃣ 通用功能模块 (9个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/recommend_question`	GET	TotalController.GetRecommendQuestion	获取推荐问题	✅
2	`/apiv1/submit_feedback`	POST	TotalController.SubmitFeedback	提交意见反馈	✅
3	`/apiv1/get_policy_file`	GET	TotalController.GetPolicyFile	获取政策文件	✅
4	`/apiv1/get_function_card`	GET	TotalController.GetFunctionCard	获取功能卡片	✅
5	`/apiv1/get_hot_question`	GET	TotalController.GetHotQuestion	获取热点问题	✅
6	`/apiv1/like_and_dislike`	POST	TotalController.LikeAndDislike	点赞和踩	✅
7	`/apiv1/download_file`	GET	TotalController.GetPdfOssDownloadLink	文件下载接口	✅
8	`/apiv1/policy_file_count`	POST	TotalController.GetPolicyFileViewAndDownloadCount	政策文件查看下载统计	✅
9	`/apiv1/get_user_data_id`	GET	TotalController.GetUserDataID	根据account_id获取用户数据ID	✅

4️⃣ 考试模块 (3个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/re_modify_question`	POST	ExamController.ReModifyQuestion	修改考试题目	✅
2	`/apiv1/exam/build_prompt`	POST	PromptController.BuildExamPrompt	生成考试提示词	✅
3	`/apiv1/exam/build_single_prompt`	POST	PromptController.BuildSingleQuestionPrompt	单题生成提示词	✅

5️⃣ 隐患识别模块 (7个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/hazard`	POST	HazardController.Hazard	隐患识别	✅
2	`/apiv1/save_step`	POST	HazardController.SaveStep	保存识别步骤	✅
3	`/apiv1/get_history_recognition_record`	GET	SceneController.GetHistoryRecognitionRecord	获取历史识别记录	✅
4	`/apiv1/get_recognition_record_detail`	GET	SceneController.GetRecognitionRecordDetail	获取识别记录详情	✅
5	`/apiv1/get_third_scene_example_image`	GET	SceneController.GetThirdSceneExampleImage	获取三级场景示例图	✅
6	`/apiv1/submit_evaluation`	POST	SceneController.SubmitEvaluation	提交点评	✅
7	`/apiv1/get_latest_recognition_record`	GET	SceneController.GetLatestRecognitionRecord	查询最新识别记录	✅

6️⃣ OSS文件存储模块 (4个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/oss/upload`	POST	ShudaoOssController.Upload	生成S3预签名上传凭证	✅
2	`/apiv1/oss/shudao/upload_image`	POST	ShudaoOssController.UploadImage	上传图片	✅
3	`/apiv1/oss/shudao/upload_json`	POST	ShudaoOssController.UploadPPTJson	上传PPT JSON文件	✅
4	`/apiv1/oss/parse`	GET	ShudaoOssController.ParseOSS	OSS代理解析接口	✅

7️⃣ 流式接口模块 (2个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/stream/chat`	POST	LiushiController.StreamChat	流式聊天接口	✅
2	`/apiv1/stream/chat-with-db`	POST	LiushiController.StreamChatWithDB	流式聊天数据库集成接口	✅

8️⃣ 知识库检索模块 (1个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/knowledge/files/advanced-search`	GET	ChromaController.AdvancedSearch	知识库文件高级搜索	✅

9️⃣ 埋点跟踪模块 (4个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/tracking/record`	POST	TrackingController.RecordTracking	记录埋点	✅
2	`/apiv1/tracking/records`	GET	TrackingController.GetTrackingRecords	获取埋点记录列表	✅
3	`/apiv1/tracking/api_mapping`	POST	TrackingController.AddApiMapping	添加接口路径映射	✅
4	`/apiv1/tracking/api_mappings`	GET	TrackingController.GetApiMappings	获取接口路径映射列表	✅

🔟 积分系统模块 (3个接口)

序号	路由路径	方法	控制器方法	说明	需要认证
1	`/apiv1/points/balance`	GET	PointsController.GetBalance	获取用户积分余额	✅
2	`/apiv1/points/consume`	POST	PointsController.ConsumePoints	消费积分下载文件	✅
3	`/apiv1/points/history`	GET	PointsController.GetConsumptionHistory	获取消费记录	✅

📂 三、控制器文件清单

序号	文件名	控制器名称	方法数量	说明
1	`chat.go`	ChatController	16	聊天对话相关功能
2	`total.go`	TotalController	9	通用功能模块
3	`exam.go`	ExamController	1	考试相关功能
4	`prompt.go`	PromptController	2	提示词生成功能
5	`hazard.go`	HazardController	2	隐患识别功能
6	`scene.go`	SceneController	5	场景管理功能
7	`shudaooss.go`	ShudaoOssController	4	OSS文件存储
8	`liushi.go`	LiushiController	2	流式接口
9	`chroma.go`	ChromaController	1	知识库检索
10	`tracking.go`	TrackingController	4	埋点跟踪（含2个辅助方法）
11	`points.go`	PointsController	3	积分系统
12	`local_auth.go`	LocalAuthController	1	本地认证
13	`frontend.go`	FrontendController	4	前端页面渲染
14	`AIPPT.go`	AIPPTController	0	空控制器（未使用）
15	`test.go`	TestController	0	内部工具函数（无HTTP接口）

🔍 四、接口分类统计

认证模块:          1个接口
聊天对话模块:      16个接口
通用功能模块:      9个接口
考试模块:          3个接口
隐患识别模块:      7个接口
OSS文件存储模块:   4个接口
流式接口模块:      2个接口
知识库检索模块:    1个接口
埋点跟踪模块:      4个接口
积分系统模块:      3个接口
前端页面路由:      4个页面
-----------------------------------
总计:             53个HTTP接口
                  (49个API + 4个页面)

⚠️ 注意事项

空控制器: AIPPTController 当前为空控制器，未实现任何接口方法
测试工具: test.go 文件中的函数仅用于开发和测试环境，不对外提供HTTP接口
认证要求: 除本地登录接口外，所有API接口都需要通过JWT认证
路由配置: 所有路由定义在 routers/router.go 文件中

📝 备注

本清单基于代码静态分析生成，涵盖所有已注册的HTTP接口
接口的具体参数、返回值等详细信息需查阅对应的控制器源代码
部分接口可能有额外的中间件处理（如认证、日志、限流等）

检查完成时间: 2026年4月3日
检查人员: Cline
检查状态: ✅ 已完成全量检查，无遗漏

接口完整清单.md 10 KB Historia Czysty

shudao-main 接口完整清单

📊 接口统计

🌐 一、前端页面路由

🔌 二、API接口（apiv1 命名空间）

1️⃣ 认证模块 (1个接口)

2️⃣ 聊天对话模块 (16个接口)

3️⃣ 通用功能模块 (9个接口)

4️⃣ 考试模块 (3个接口)

5️⃣ 隐患识别模块 (7个接口)

6️⃣ OSS文件存储模块 (4个接口)

7️⃣ 流式接口模块 (2个接口)

8️⃣ 知识库检索模块 (1个接口)

9️⃣ 埋点跟踪模块 (4个接口)

🔟 积分系统模块 (3个接口)

📂 三、控制器文件清单

🔍 四、接口分类统计

⚠️ 注意事项

📝 备注

接口完整清单.md 10 KB

Historia Czysty