first commit

2026-06-14 22:28:19 +08:00
commit e03ba7a20d
67 changed files with 13400 additions and 0 deletions
@@ -0,0 +1,34 @@
+# 自动回复
+
+自动回复是插件的核心功能，当有新评论发布时，插件会自动触发AI生成回复。
+
+## 工作原理
+
+插件通过 Halo 的 Reconciler 机制监听评论和回复的创建事件：
+
+- **CommentReconciler** — 监听新评论，触发首次AI回复
+- **ReplyReconciler** — 监听新回复，当回复者不是AI角色时，触发对话式AI回复
+
+## 去重机制
+
+为避免重复回复，插件实现了多层去重防护：
+
+1. **内存锁** — 使用 `ConcurrentHashMap` 防止同一评论并发处理
+2. **数据库检查** — 处理前查询是否已存在 `AiCommentReply` 记录
+3. **发布前检查** — 创建 Reply 前再次确认不存在重复
+
+## 历史评论过滤
+
+插件启动时间之前的评论不会触发自动回复，避免安装插件后对大量历史评论批量回复。
+
+## 对话式回复
+
+当评论者回复AI的评论时，插件会自动提取对话上下文（最近5条回复），让AI的回复更连贯自然。
+
+## 配置项
+
+| 配置项 | 说明 | 默认值 |
+|--------|------|--------|
+| 自动回复 | 是否启用自动回复功能 | 开启 |
+| 自动发布 | AI回复是否自动发布，关闭则存为草稿 | 开启 |
+| 最大重试次数 | AI生成失败时的最大重试次数 | 3 |