DevPulse Beta 换组与项目文档交接

一 换组情况与交接范围

本次换组由陈诗默与杨子旭进行交换。陈诗默原为 DevPulse 组成员，本次从本组换出；杨子旭换入 DevPulse 组，参与后续项目工作。

本组将通过项目资料、运行说明和已知问题清单，帮助杨子旭熟悉现有系统与后续任务。交接内容以当前项目基线为准，重点说明已有能力、运行方式和仍需处理的问题，保证换组后的工作能够衔接。

DevPulse 是面向课程资料和团队文档的知识问答系统。用户登录后进入知识库，上传资料并等待后台入库，再围绕资料提问、查看引用和提交反馈。交接的核心是让接收方理解这条链路、能够启动系统，并知道哪些内容已经有实现记录、哪些仍然只是计划。

本次交接覆盖文档、代码入口、配置要求、验证方式和待处理问题。账户与密钥不放入公开博客，运行环境由接收方按说明配置。

二 交接资料清单

三 当前项目基线

前端采用 Vue 3、TypeScript 和 Vite；后端采用 Python、FastAPI；数据与任务服务包括 MySQL、Chroma、Redis 和 Celery；通过 Docker Compose 启动各服务。

依据 11 月 2 日实现记录，项目已有登录、知识库管理、文档上传与异步入库、混合检索、带引用问答、反馈与权限等能力。当前问答方案实时调用 DeepSeek，模型配置缺失或调用失败时返回错误；早期本地摘录回答的方案已经被后续记录替代。

历史记录还说明：文档重建索引后，旧引用显示来源已更新并隐藏过期原文；删除文档后，相关预览和检索需要受限制。这些行为是接收时应重点复核的内容，不能按早期设计文档推断。

四 推荐阅读与接收顺序

第一步阅读 README 和部署说明，明确系统用途及启动所需环境。第二步阅读实现验证记录，区分当前行为和历史方案。第三步根据需求与设计文档梳理业务链路，并将文档差异记入问题清单。最后进入代码和测试，定位各模块的实际入口。

接收时拟选择一份不含个人信息的 Markdown 或 TXT 资料，依次完成注册登录、创建知识库、上传、查看入库状态、提问、打开引用和提交反馈。随后用另一个账户检查知识库和会话的访问范围。

五 运行交接步骤

1. 准备 Docker 与 Docker Compose，确认容器引擎可用。
2. 获取同一版本的源码和运行说明，核对根目录存在 compose.yaml。
3. 按 .env.example 创建本地配置，填写自己的数据库密码及模型密钥；已有 .env 不直接覆盖。
4. 按部署说明在根目录运行 pwsh -File deploy/start.ps1。
5. 浏览器访问 http://localhost:8088，用测试资料验证主链路。
6. 记录实际版本、运行环境、启动结果、失败信息及处理方法，形成交接验收记录。

当前 Compose 将 Web 端口绑定在本机回环地址。需要异地访问时，应另行准备可访问环境；交接文档不把本机地址写成公开演示链接。

六 交接验收标准

交接采用“资料理解、环境复现、业务验证、问题追踪”的顺序。资料清单已经整理，运行接收将在 Beta 启动时进行。

七 带入 Beta 的问题

交接完成的标志是资料能被正确理解、环境能按说明复现、未解决问题有明确入口。交接过程中发现的问题将进入 Beta 任务台账，与后续验证和修订一起追踪。