一、项目概述

本项目为“文澜知微”古文沉浸式智慧阅读平台，核心目标是打造一款集古籍阅读、历史人物对话、古文智能翻译、时空地图可视化为一体的综合性平台。实训期间，小组围绕项目从0到1的搭建、核心功能开发逐步推进，先后完成项目基础框架搭建、标准化开发流程梳理、古籍阅读模块开发、历史人物对话基础功能开发，确保项目按计划落地，实现各模块的高效联动与标准化开发。

成员：陈秋华、秦玮悦、蔺涵霖

时间：3.23-4.16，分为两个核心阶段：

3.23-4.7（项目框架搭建与标准化流程梳理）

4.7-4.16（古籍阅读模块、历史人物对话基础功能开发）

二、小组分工及成员完成情况

小组共3名成员，结合项目需求与成员技术特长，明确分工、协同推进，各成员具体分工及完成情况如下，所有已分配任务均按要求完成，无延期情况。

成员	负责模块	具体职责	完成情况
陈秋华	项目整体框架搭建、标准化流程梳理	1. 前后端基础框架搭建（前端Vue3+Element Plus+Vite，后端SpringBoot，数据库MySQL+Redis）；2. 后端分层架构实现、权限区分（admin/guest）；3. 前端目录规范梳理与落地；4. 登录注册模块开发；5. 前后端通信桥梁封装；6. 标准化开发流程（前后端）梳理与文档输出。	✅ 全部完成，框架运行稳定，流程文档规范，可支撑后续功能模块快速开发
秦玮悦	古籍阅读模块（前后端开发）	1. 后端：古籍、章节、分类相关实体类、Repository层、Service层、Controller层开发，API接口封装；2. 前端：书籍列表页、书籍详情页、阅读页开发，路由配置、API服务封装、类型定义；3. 数据库设计（category、ancient_book、chapter表）及测试数据插入；4. 页面效果优化与功能测试。	✅ 全部完成，3个核心页面交互流畅，接口联调正常，测试数据完整，支持分类筛选、字体调节等核心功能
蔺涵霖	历史人物对话模块（后端开发）	1. 历史人物对话整体后端架构设计（业务层、模型服务层、数据持久化层）；2. 人物档案实时生成、对话生成、会话持久化核心逻辑开发；3. DeepSeek模型接口对接，Prompt设计与优化；4. 数据库三张核心表（会话表、参与者表、消息表）设计与实现；5. 前后端通信接口封装（复用sendChatMessage）。	✅ 全部完成，实现人物档案实时生成、文言/白话双模式、多人同场对话功能，会话可正常持久化

三、各模块完成效果

（一）项目基础框架与标准化流程

1. 框架成果：完成前后端基础骨架搭建，实现登录注册核心功能，区分admin（管理员端）与guest（客户端）权限，封装通用通信逻辑，后端实现实体类自动映射数据库表，无需手动建表，大幅提升开发效率；前端梳理标准化目录规范，确保团队开发一致性。

2. 流程成果：梳理并输出前后端单功能模块标准化开发流程文档，明确开发步骤、自检要求、命名规范，后续所有功能模块均按此流程开发，降低团队协作成本，避免代码混乱。

（二）古籍阅读模块

1. 核心功能：实现书籍列表页（分类筛选、卡片式展示）、书籍详情页（信息展示、目录、收藏功能）、阅读页（章节切换、字体调节、进度保存）三大核心页面，路由配置完整，API服务封装规范。

2. 效果表现：页面响应式布局，卡片悬停有交互效果，字体调节范围12px-28px且自动保存，阅读进度自动记录，分类筛选精准，测试数据（《史记》《论语》等）完整，可正常完成“筛选-查看详情-阅读”全流程。

（三）历史人物对话模块（基础功能）

1. 核心功能：实现人物档案实时生成（支持任意历史人物）、文言/白话双模式切换、多人同场对话、会话持久化四大核心功能，前端交互流畅，后端接口稳定。

2. 效果表现：用户输入历史人物名称后，可快速生成标准化人物档案；切换文言/白话模式后，模型输出风格符合预期；支持多人同场对话，输出内容按结构化格式展示；会话记录可保存至数据库，支持历史会话切换与查看，模型调用稳定，容错处理到位。

四、项目现存问题与改进方向

（一）现存问题

• 历史人物对话模块：模型输出效果仍有优化空间，部分场景下人物回答与历史设定贴合度不足；多人同场对话的交互体验可进一步完善。

• 古籍阅读模块：收藏功能仅实现本地保存，未对接后端数据库，无法实现跨设备同步；缺乏搜索功能，用户难以快速找到目标书籍。

• 整体优化：部分页面响应式细节不够完善，加载速度可进一步提升；权限管控仅实现基础区分，后续需细化功能权限。

（二）改进方向

• 优化模型Prompt，结合已有数据集微调模型，提升历史人物回答的准确性与贴合度。

• 完善古籍阅读模块的收藏功能与搜索功能，实现收藏数据后端存储、跨设备同步，支持按书名/作者搜索。

• 优化页面交互细节，提升响应速度；细化权限管控，区分不同角色的功能操作权限。

五、接下来的任务规划

结合项目整体目标与当前进度，后续任务按模块分工推进，计划周期为4.17-4.30，具体任务安排如下：

（一）各成员后续任务

成员	后续任务	任务要求
陈秋华	1. 优化基础框架，完善权限管控功能；2. 对接各模块，确保框架与核心功能联动稳定；3. 整理项目整体文档，完善开发规范；4. 优化已完成的地图历史人物轨迹功能，提升可视化效果与交互体验。	权限管控细化到具体功能按钮，框架运行无报错，文档完整可追溯；地图轨迹可视化流畅，交互体验良好
秦玮悦	1. 古籍阅读模块添加搜索功能（按书名/作者）；2. 完善收藏功能，对接后端数据库实现跨设备同步；3. 添加阅读历史记录功能；4. 对接大模型实现古文智能翻译功能。	搜索精准，收藏与历史记录可正常存储和展示，翻译功能流畅，与阅读页面联动
蔺涵霖	1. 微调优化DeepSeek模型，提升历史人物对话效果；2. 完善多人同场对话的后端逻辑，优化结构化输出；3. 开发会话管理功能（删除、编辑会话）；4. 优化会话持久化性能。	模型回答贴合人物设定，多人对话无错乱，会话管理功能正常，性能稳定

（二）整体任务目标

1. 完成所有核心功能开发（古籍阅读完善、历史人物对话优化、古文智能翻译、搜索与收藏同步）；2. 实现各模块高效联动，确保平台整体运行稳定；3. 完善项目文档，完成功能测试与bug修复；4. 为后续时空地图可视化模块开发奠定基础。

六、小组总结

这一段时间内我们分工明确、协同配合，顺利完成了项目基础框架搭建、标准化流程梳理以及古籍阅读、历史人物对话两大核心模块的基础开发任务，实现了项目从0到1的突破。同时，各成员充分发挥自身技术特长，积极运用AI辅助编程提升开发效率，严格遵循标准化开发流程，确保了代码质量与开发进度。

但是，我们也认识到项目现存的不足，后续将按照任务规划继续功能的开发，同时重点优化模型效果、完善功能细节、提升用户体验，确保按时完成项目整体目标。

七、备注

1. 所有已完成模块均经过初步测试，接口联调正常，可正常演示；2. 项目相关代码、测试数据、开发文档已统一归档，便于后续查阅与维护；3. 后续任务将严格按照计划推进，若有调整，将及时召开小组会议同步信息。