一、环境配置

统一开发环境，具体工作：

• Python ：使用 Python 3.12（兼容 LangGraph 及 PaddleOCR Windows wheel）。
• 依赖管理工具：选用 uv 替代 pip/poetry。理由：速度快、可以自动创建虚拟环境、支持 pyproject.toml。
• 后端依赖清单：编写 backend/pyproject.toml，核心依赖包括：

                   fastapi, uvicorn[standard]（API 服务）

                   sqlalchemy, asyncmy, alembic（数据库）

                   langgraph, langchain-core（多 Agent 编排）

                   paddlepaddle, paddleocr（OCR，Windows 专用 wheel 稍后补充）

                   chromadb, sentence-transformers（RAG 向量库）

                   deepseek-sdk 或 openai（LLM 调用）

                   python-multipart, python-jose, passlib（认证与文件上传）

uv 是 Rust 编写的下一代 Python 包管理器，锁文件 uv.lock 能精确锁定依赖传递版本，比 pip freeze 更可靠。同时支持 tool.uv.sources 配置私有索引，为后续 PaddleOCR 国内镜像源预留接口。

二、Vue 项目前端初始化与核心界面开发工作内容

2.1 Vue 项目前端初始化（基础搭建）

初始化的核心目标是搭建项目骨架、配置基础环境、统一开发规范，为后续业务开发铺路。

初始化核心操作：

初始化关键点：

• 项目启动正常：npm run dev 能启动本地服务，访问指定端口看到默认页面；
• 跨域代理生效：配置的接口代理能正确转发请求，避免开发环境跨域；
• 规范校验生效：ESLint 能检测出语法错误 / 风格问题，Prettier 能自动格式化；
• 全局资源可访问：全局样式、图片等资源能正常加载，无 404。

2.2 核心界面开发

核心界面开发是基于初始化的骨架，实现业务核心页面（如首页、列表页、详情页、表单页），核心围绕组件化、路由、状态管理、交互逻辑展开。

核心开发界面关键原则：

• 组件化：页面拆分为 “公共组件 + 业务组件 + 页面组件”，复用性优先（如通用按钮、表单输入框封装为公共组件）；
• 数据驱动：通过状态（ref/reactive/Vuex/Pinia）驱动视图，避免直接操作 DOM；
• 逻辑内聚：相关逻辑（如商品列表的请求、筛选、加载更多）集中在组件 / Store 中，便于维护；
• 异常处理：接口请求失败、数据为空、用户操作错误等场景需做兜底（加载失败提示、空数据占位、表单错误提示）。

三、技术理解

3.1 构建引擎配置

• Vite / Webpack 是现代前端构建工具，负责编译、打包、压缩、转译。
• 核心技术点：
  • ESM 模块化：浏览器原生支持，Vite 开发环境不打包，直接运行，极快。
  • 依赖预构建：把第三方库打包成静态资源，提升加载速度。
  • 代理跨域：开发环境转发请求，绕过浏览器同源策略。
  • 路径别名：@ 指向 src，本质是模块路径解析优化。

3.2 Vue 应用入口

• 这是Vue 应用的启动器。
• Vue3 使用 createApp() 创建应用实例，是函数式、轻量化、无全局污染。
• 执行流程：
  1. 创建实例
  2. 安装插件（路由、状态库、UI 库）
  3. 挂载到 DOM
• 技术本质：插件化架构 + 生命周期启动。

总结：Vue 项目初始化的核心是 “标准化、可复用、易扩展”，核心界面开发的核心是 “组件化、数据驱动、业务闭环”，两者结合实现从基础搭建到业务落地的完整流程。