version update: web search+ private chat:本版本更新，引入联网搜索/私信功能

Author: Ea1XonCodeHou

.gitignore

@@ -27,4 +27,7 @@ rabbitmq/
 
 # local-development files
 develop_log/
-question/
+question/
+
+# Claude Code 本地配置（不提交）
+.claude/

README.md

@@ -7,6 +7,8 @@
 ![Redis](https://img.shields.io/badge/Redis-Latest-DC382D?logo=redis)
 ![RabbitMQ](https://img.shields.io/badge/RabbitMQ-3.13-FF6600?logo=rabbitmq)
 ![LangChain4j](https://img.shields.io/badge/LangChain4j-0.35.0-blue)
+![Tavily](https://img.shields.io/badge/Tavily-Search-00B4D8)
+![WebSocket](https://img.shields.io/badge/WebSocket-实时私信-6366f1)
 ![Vite](https://img.shields.io/badge/Vite-7.1-646CFF?logo=vite)
 
 CoderHub 是一个面向开发/学习者的智能技术博客交流社区平台。不仅提供了体系化的技术博客阅读/发布功能，和项目/教程学习模块，更整合了目前热门的 AI Agent 能力，让开发者在阅读和学习过程中，能通过智能助手实时调取平台内的知识库，实现“所见即所得”的互动式学习体验。
@@ -48,8 +50,10 @@ CoderHub 是一个面向开发/学习者的智能技术博客交流社区平台
 
 ### 项目开发进度
 
-目前仓库代码已完成 `v1.0.5` 版本的核心功能合并，系统整体运行稳定。
+目前仓库代码已完成 `v1.0.6` 版本的核心功能合并，系统整体运行稳定。
 
+- **实时私信系统**：基于原生 WebSocket 实现双向实时通讯，信息中心、私信咨询入口已上线。
+- **AI 联网搜索**：集成 Tavily Search API，深度检索与联网可同时开启，本地知识库优先。
 - **基础设施更新**：完成 Docker 容器化重构，支持环境变量脱敏配置。
 - **CI/CD 集成**：集成 GitHub Actions，实现代码推送自动部署。
 - **开发阶段 (当前重点)**：优化 RAG 检索的准确率与 Top-K 召回策略；管理端图表统计增强，降低AI幻觉，增强智能体交互能力，计划引入代码相关Agent功能。
@@ -58,6 +62,25 @@ CoderHub 是一个面向开发/学习者的智能技术博客交流社区平台
 
 ### 更新日志
 
+#### v1.0.6 (2026-03-17) - 实时私信系统
+
+**💬 私信聊天功能上线**
+
+- **WebSocket 实时通讯**：基于原生 Spring WebSocket（无 STOMP/SockJS 依赖），用户间消息毫秒级双向推送；支持断线自动重连，前端 5 秒后重试
+- **信息中心**：导航栏新增「信息中心」入口，未读消息红色角标实时更新；左侧联系人列表 + 右侧对话区的经典 IM 布局，兼容移动端折叠
+- **私信咨询**：文章作者卡片新增「私信咨询」按钮，一键跳转并自动打开与该作者的会话
+- **CoderHub 助手**：用户首次打开信息中心，系统自动创建欢迎会话并推送欢迎语，永久置顶于联系人列表顶部
+- **在线状态**：基于 WebSocket SESSIONS Map 实时判断对方是否在线，点击会话时动态查询
+
+#### v1.0.5 (2026-03-14) - AI 联网搜索
+
+**🌐 Tavily 联网搜索集成**
+
+- 集成 **Tavily Search API**，AI 回答时可补充互联网实时内容；深度检索与联网搜索可同时开启
+- 优先级设计：本地 RAG 知识库优先，联网结果作为补充，避免互联网内容覆盖平台内容
+- 搜索结果卡片化展示，显示来源站点名（`github.com`、`stackoverflow.com` 等）及匹配度
+- 后端通过 OkHttp 直接调用 Tavily REST API，无额外依赖；API Key 通过环境变量注入
+
 #### v1.0.5 (2026-03-11) - AI 深度检索升级 & 用户体验完善
 
 **🤖 AI 深度检索（RAG）全面升级**

coderhub_backend/coderhub-common/src/main/java/com/eaxon/coderhubcommon/constant/RedisConstant.java

@@ -147,6 +147,15 @@ public class RedisConstant {
      */
     public static final String ARTICLE_FULLTEXT = "article:fulltext:";
 
+    // ==================== 私信聊天 ====================
+
+    /**
+     * 私信未读总数
+     * Key: chat:unread:{userId}
+     * Value: Integer
+     */
+    public static final String CHAT_UNREAD = "chat:unread:";
+
     // ==================== 过期时间（单位：秒） ====================
 
     public static final long EXPIRE_30_MINUTES = 30 * 60;

coderhub_backend/coderhub-pojo/src/main/java/com/eaxon/coderhubpojo/DTO/ChatRequestDTO.java

@@ -44,6 +44,9 @@ public class ChatRequestDTO {
     @Schema(description = "最大输出token数")
     private Integer maxTokens;
 
+    @Schema(description = "是否启用联网搜索（Tavily）")
+    private Boolean useWebSearch;
+
     /**
      * 对话消息（用于历史记录）
      */

coderhub_backend/coderhub-pojo/src/main/java/com/eaxon/coderhubpojo/DTO/ChatStreamEvent.java

@@ -151,6 +151,12 @@ public static class RecommendItem {
 
         @Schema(description = "跳转链接")
         private String link;
+
+        @Schema(description = "来源URL（联网搜索结果）")
+        private String sourceUrl;
+
+        @Schema(description = "来源站点名称，如 github.com")
+        private String siteName;
     }
 
     // =============== 静态工厂方法 ===============

coderhub_backend/coderhub-pojo/src/main/java/com/eaxon/coderhubpojo/VO/ChatConversationVO.java

@@ -0,0 +1,41 @@
+package com.eaxon.coderhubpojo.VO;
+
+import java.time.LocalDateTime;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 私信会话列表项 VO
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ChatConversationVO {
+
+    private String id;
+
+    /** 对方用户ID */
+    private String peerId;
+
+    /** 对方昵称 */
+    private String peerName;
+
+    /** 对方头像 */
+    private String peerAvatar;
+
+    /** 对方会员等级 */
+    private Integer peerLevel;
+
+    /** 最新消息预览 */
+    private String lastMessage;
+
+    /** 最新消息时间 */
+    private LocalDateTime lastMsgAt;
+
+    /** 当前用户在此会话中的未读数 */
+    private Integer unreadCount;
+}

coderhub_backend/coderhub-pojo/src/main/java/com/eaxon/coderhubpojo/VO/ChatMsgVO.java

@@ -0,0 +1,39 @@
+package com.eaxon.coderhubpojo.VO;
+
+import java.time.LocalDateTime;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 私信消息 VO（用于历史记录和 WebSocket 推送）
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ChatMsgVO {
+
+    private String id;
+
+    private String conversationId;
+
+    private String senderId;
+
+    private String senderName;
+
+    private String senderAvatar;
+
+    private String receiverId;
+
+    private String content;
+
+    private Integer isRead;
+
+    private LocalDateTime createdAt;
+
+    /** 是否是当前用户发送的（供前端判断气泡方向） */
+    private Boolean isMine;
+}

coderhub_backend/coderhub-pojo/src/main/java/com/eaxon/coderhubpojo/entity/ChatConversation.java

@@ -0,0 +1,36 @@
+package com.eaxon.coderhubpojo.entity;
+
+import java.time.LocalDateTime;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 私信会话实体（两个用户之间唯一）
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ChatConversation {
+
+    /** 会话ID（UUID） */
+    private String id;
+
+    /** 参与方1（两个userId中字典序较小者，保证唯一索引） */
+    private String user1Id;
+
+    /** 参与方2（两个userId中字典序较大者） */
+    private String user2Id;
+
+    /** 最新消息预览（截断到255字符） */
+    private String lastMessage;
+
+    /** 最新消息时间 */
+    private LocalDateTime lastMsgAt;
+
+    /** 会话创建时间 */
+    private LocalDateTime createdAt;
+}

coderhub_backend/coderhub-pojo/src/main/java/com/eaxon/coderhubpojo/entity/ChatMsg.java

@@ -0,0 +1,34 @@
+package com.eaxon.coderhubpojo.entity;
+
+import java.time.LocalDateTime;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 私信消息实体
+ * 注意：命名为 ChatMsg 以避免与 LangChain4j 的 ChatMessage 类冲突
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ChatMsg {
+
+    private String id;
+
+    private String conversationId;
+
+    private String senderId;
+
+    private String receiverId;
+
+    private String content;
+
+    /** 0=未读，1=已读 */
+    private Integer isRead;
+
+    private LocalDateTime createdAt;
+}

coderhub_backend/coderhub-server/pom.xml

@@ -164,6 +164,12 @@
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-mail</artifactId>
         </dependency>
+
+        <!-- WebSocket（私信实时通讯） -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-websocket</artifactId>
+        </dependency>
     </dependencies>
 
     <build>