1.立项原因：传统校园办事流程信息以通知文件、网页公告、微信群聊等形式分散存储，学生查找特定办事步骤时需跨多个平台反复检索，信息获取效率低下且容易遗漏关键材料或环节。本项目旨在利用大模型语义理解与知识检索能力，将校内各类办事资料整合为结构化知识库，通过自然语言问答形式为学生提供即时、准确的办事指引，减少行政咨询重复性人力投入。
2.行业场景：面向高校校园学生服务场景，覆盖请假审批流程、课程退补选操作、成绩单与在读证明开具、宿舍调换申请、校园卡挂失补办、奖学金申请流程等常见校园办事需求。系统以轻量化H5问答应用为载体，学生输入日常口语化问题即可获得标准化办事指南输出，适用于移动端快速查询场景，可作为高校智慧校园建设中的辅助信息服务模块。
1.项目包含七大核心功能模块：前端H5交互页面模块——提供问答输入框与结果渲染展示界面；后端API接口模块——基于FastAPI构建RESTful接口，处理请求路由与响应封装；JSON知识库读取与检索模块——负责加载、解析和检索结构化校园办事数据；Agent调度模块——协调问答流程中的知识检索、提示词组装与模型调用；DeepSeek大模型API调用模块——封装模型请求与响应解析逻辑，实现语义理解与文本生成；提示词工程约束模块——设计严格Prompt模板，限定模型回答来源与输出格式；内网穿透公网演示模块——通过隧道代理实现本地服务临时外部访问；安卓套壳APP打包模块——将H5页面封装为WebView容器应用，生成Android安装包。
2.核心功能描述：用户通过H5移动端页面输入办事相关问题，前端将请求提交至后端FastAPI服务，后端读取本地JSON知识库进行上下文匹配，通过精心设计的约束性Prompt模板（强制限定回答仅基于知识库内容、禁止编造流程、按固定字段模板输出）调用DeepSeek大模型API生成标准化办事信息，包含办理地点、所需材料、办理步骤、注意事项等结构化字段，最终将结果返回前端以卡片形式清晰渲染展示。整套流程支持内网穿透工具实现临时外网访问，便于移动端演示。
1.本人独立完成全流程开发：后端层面，使用FastAPI编写RESTful接口，实现JSON知识库加载与检索、多版Prompt模板设计迭代、DeepSeek API调用封装与异步请求处理；前端层面，开发移动端适配的H5交互页面，包含输入、加载动画、结果卡片渲染等完整交互，完成安卓WebView套壳打包与APK生成；部署层面，配置内网穿透工具实现公网临时访问，完成接口联调与端到端测试。
2.技术栈与架构：项目采用前后端分离架构。后端使用Python 3.10 + FastAPI框架，集成DeepSeek大模型API，JSON文件作为轻量级结构化知识库，Prompt设计采用Few-shot + 格式约束 + 负向禁止的复合策略；前端使用原生HTML5 + CSS3响应式布局 + Vanilla JavaScript（Fetch API异步请求），打包采用Android Studio WebView生成APK；内网穿透使用ngrok映射本地端口。实现亮点与难点：难点一，模型易脱离知识库幻觉回答，通过设计多层级Prompt约束（角色锚定→知识源限定→格式固定→禁止项列举）及后置关键词校验解决；难点二，本地服务无法外网访问，使用ngrok隧道代理映射本地端口实现临时公网演示；难点三，H5打包安卓WebView后因Android 9及以上默认禁止明文流量导致请求失败，通过配置android:usesCleartextTraffic="true"及WebView混合内容加载解决。
评论