创新实训开发日志：研途Buddy（一）

主要内容本周正式进入创新实训项目开发阶段团队各自完成了研途Buddy项目的基础环境搭建、前后端配置、Git 协作流程、智谱大模型 API 接入与本地服务启动。本文将完整记录我从 0 到 1 搭建项目运行环境的全过程包含工具安装、依赖配置、密钥管理、服务启动与遇到的常见问题和解决过程。一、核心思路项目采用了前后端分离 云端大模型架构后端基于 Python 的 FastAPI 框架构建接口服务前端使用 Vue3 实现交互页面大模型能力依托智谱 AI 官方提供的 Flash 4 版本 API 实现所有模型计算均在云端完成无需本地配置 GPU大幅降低了环境部署门槛。同时由队长主持我们通过Gitee进行项目的协作。二、具体步骤1. 开发环境准备首先我先完成了基础开发工具的检查与安装包括 Git 版本控制工具、Python 3.10 及以上环境、Node.js 运行时以及 PyCharm 开发工具同时配置了本项目使用的虚拟环境进行依赖隔离避免不同项目与设备之间的版本冲突问题。2. Gitee 仓库管理进入项目文件夹克隆项目到本地。git clone 仓库地址 cd project-training创建个人开发分支方便后续使用。git checkout -b 名字3. 后端环境配置首先在后端目录创建了虚拟环境激活虚拟环境后安装目前所需的项目依赖。pip install -r requirements.txt考虑到部分依赖版本可能存在兼容性问题我在安装过程中对报错内容进行逐一排查对无法正常安装的扩展包采用核心依赖兜底安装的方式优先保证 FastAPI、uvicorn、python-dotenv、openai 以及 zhipuai 等关键模块可用。核心依赖的安装有pip install fastapi uvicorn python-dotenv openai zhipuai接着团队决定先申请使用智谱API Key方便先开展工作。这里我选的模型是Flash 4后续在backend目录下创建env配置文件并粘贴生成的API Key。# backend/.env ZHIPU_API_KEYxxx这里需要注意的是为了保证密钥安全避免上传至公开仓库造成信息泄露.env 绝对不能上传到 Git引号保留key 不要加空格否则后端是会报错的。完成配置后通过 uvicorn 指令启动后端服务成功在本地 8000 端口运行接口服务并通过 FastAPI 自动生成的接口文档页面验证服务可用性。uvicorn main:app --reload当出现 api_key 未设置的报错时需要检查.env 文件位置是否正确、变量名称是否与代码读取规则一致。启动成功就会显示Uvicorn running on http://127.0.0.1:80004. 前端环境配置由于已经提前安装好 Node.js 环境我直接进入项目的 frontend 目录cd ../frontend安装前端所有 Vue 相关依赖等待依赖安装完成后使用启动命令运行前端项目npm install启动前端项目npm run serve前端项目成功在本地 8080 端口运行浏览器可以正常访问页面。5. 大模型接口接入流程项目已封装好智谱接口通过加载 .env 环境变量初始化 AsyncOpenAI 客户端。from openai import AsyncOpenAI from settings import settings client AsyncOpenAI( api_keysettings.ZHIPU_API_KEY, base_urlsettings.ZHIPU_BASE_URL )传入 modelglm-4-flash后就可以接受用户问题返回AI回答。6.遇到的问题及解决方案问题1安装Node.js后终端输入node -v能显示版本号但输入npm -v报错解决方案在PowerShell中运行以下命令允许当前用户运行本地脚本输入Y确认即可Set-ExecutionPolicy RemoteSigned -Scope CurrentUser问题2关闭终端后重新打开输入node -v或npm -v报错解决方案 在“用户变量”中找到 Path添加Node.js安装路径 关闭所有终端后重新打开即可永久正常使用。问题3启动后端仍报错未配置智谱 API Key或 .env 配置文件未正确设置。解决方案检查 .env 文件位置是否在 backend 目录下变量名称是否与代码中settings.ZHIPU_API_KEY一致。问题4运行npm install成功后输入npm run serve报错npm error Missing script: serve。解决方案使用正确的启动命令。npm run dev总结经过一系列规范且细致的操作我初步完成了项目的完整环境搭建实现了 Gitee 仓库正常拉取、虚拟环境稳定运行、后端服务正常启动、前端页面正常展示、智谱 Flash 4 大模型接口成功调用的目标。目前本地服务可以正常接收用户问题并通过云端大模型返回结构化回答项目基础运行环境完全符合预期。本次环境搭建不仅为后续奠定了稳定基础也能够帮助团队成员快速上手减少配置成本提升整体开发效率。在接下来的开发阶段我也将逐步推进用户登录、对话记录、RAG 知识库扩展等功能持续完善研途项目的能力。