山东大学软件学院创新实训-易学探索助手开发记录

本周，我主要完成了以下工作：

需求分析： 针对项目的功能和目标用户的需求，对易学探索助手进行了详细的需求分析。
系统设计： 设计了易学探索助手的系统架构，包括各个模块的功能和接口。
命名规范： 制定了项目的命名规范，以确保代码的可读性和可维护性。

需求分析

上传文件模块

  • 需求描述: 用户可上传易学相关文献、图片等资料，以便于后续处理和分析。
  • 功能点:
    • 支持多种文件格式，如PDF、Word、图片等；
    • 文件大小限制，建议不超过50MB；
    • 上传速度优化，提高用户体验；
    • 文件预览功能，方便用户查看上传内容。

句读处理模块

  • 需求描述: 对上传的易学文献进行句读处理，便于用户阅读和理解。
  • 功能点:
    • 自动断句，根据标点符号和语境进行智能断句；
    • 支持手动调整句读，用户可根据需求修改断句结果；
    • 显示句读进度，让用户了解当前处理情况；
    • 句读结果显示，以高亮、分段等形式展示处理结果。

翻译模块

  • 需求描述: 为用户提供易学文献的翻译功能，帮助用户更好地理解内容。
  • 功能点:
    • 支持将古文字符翻译为现代汉语；
    • 翻译速度快，保证翻译质量；
    • 翻译结果显示，以对照、悬浮等形式展示翻译内容；
    • 支持用户自定义翻译词典，提高翻译准确性；
    • 翻译历史记录，方便用户查看和对比。

注释模块

  • 需求描述: 为易学文献中的关键词汇、概念等添加注释，帮助用户深入理解。
  • 功能点:
    • 自动识别关键词汇，提供默认注释；
    • 支持用户添加自定义注释，丰富注释内容；
    • 注释显示方式，以弹窗、悬浮等形式展示；
    • 注释管理功能，包括修改、删除等；
    • 注释反馈功能，方便用户提出建议。

知识图谱模块

  • 需求描述: 构建易学知识图谱，展示易学体系中的概念、人物、事件等关系。
  • 功能点:
    • 自动提取文献中的关键信息，构建知识图谱；
    • 支持用户自定义知识图谱节点和关系；
    • 知识图谱可视化展示，便于用户理解和掌握；
    • 知识图谱查询功能，帮助用户快速找到所需信息；
    • 知识图谱导出功能，方便用户保存和分享。

详细设计文档

1. 上传文件模块详细设计

  • 技术实现:
    • 前端：使用HTML5 的<input type="file">元素实现文件上传功能。使用Ajax 技术实现无刷新上传，提升用户体验。
    • 后端：采用Spring Boot 框架，使用MultipartFile 接口处理上传的文件。
  • 接口设计:
    • 上传文件接口:
      • URL: /api/upload
      • Method: POST
      • 参数：file (文件对象), type (文件类型)
      • 响应：文件的存储路径和唯一标识符
  • 数据库设计:
    • 文件表:
      • file_id (主键, UUID)
      • user_id (外键, 关联用户ID)
      • file_name (文件原始名称)
      • file_path (文件存储路径)
      • upload_time (上传时间)
      • file_type (文件类型)

2. 句读处理模块详细设计

  • 技术实现:
    • 前端：使用JavaScript 实现句读结果的展示和手动调整。
    • 后端：调用deepseek大语言模型进行句读处理。
  • 接口设计:
    • 句读处理接口:
      • URL: /api/parsing/sentence
      • Method: POST
      • 参数：text (待处理的文本)
      • 响应：句读处理后的文本数组

3. 翻译模块详细设计

  • 技术实现:
    • 前端：实现翻译结果的展示和用户自定义词典的添加。
    • 后端：集成大模型API 进行文本翻译。
  • 接口设计:
    • 翻译接口:
      • URL: /api/translation
      • Method: POST
      • 参数：text (待翻译的文本)
      • 响应：翻译后的文本

4. 注释模块详细设计

  • 技术实现:
    • 前端：实现注释的添加、显示和管理。
    • 后端：使用数据库存储注释信息。
  • 接口设计:
    • 注释接口:
      • 创建注释：/api/annotations/create
      • 读取注释：/api/annotations/read
      • 更新注释：/api/annotations/update
      • 删除注释：/api/annotations/delete
      • Method: POST for create, GET for read, PUT for update, DELETE for delete
      • 参数：annotation_id (注释ID), content (注释内容), keyword (关键词)

5. 知识图谱模块详细设计

  • 技术实现:
    • 前端：使用D3.js 或Sigma.js 等库实现知识图谱的可视化。
    • 后端：使用大模型提取语义信息，构建知识图谱 使用Neo4j 作为图数据库存储知识图谱数据。
  • 接口设计:
    • 知识图谱接口:
      • 创建节点：/api/knowledge-graph/nodes/create
      • 创建关系：/api/knowledge-graph/relationships/create
      • 查询图谱：/api/knowledge-graph/query
      • 导出图谱：/api/knowledge-graph/export
      • Method: POST for create and query, GET for export
      • 参数：node (节点信息), relationship (关系信息), query (查询语句)
posted @ 2025-03-21 15:12  htekye  阅读(67)  评论(0)    收藏  举报