diff --git a/README.md b/README.md
index 8568a9e..a715663 100644
--- a/README.md
+++ b/README.md
@@ -1,39 +1,37 @@
# AI回评 / Comment AI Autopilot
-基于 AI 的 Halo 博客评论自动回复插件,支持多 AI 角色、合规检测、自审核、自动发布和对话式连续回复。
+> 基于 AI 的 Halo 博客评论自动回复插件,支持多 AI 角色、合规检测、自动发布和对话式连续回复。
## 功能特性
-- **多 AI 角色** — 支持创建多个 AI 角色,每个角色有独立的昵称、人格提示词、性别、语气风格和 Gravatar 头像,可为不同文章分类指定不同角色,人格提示词留空时使用基础配置
-- **唤醒词** — 评论以唤醒词开头可唤醒指定角色回复,支持自定义唤醒词,可在未启用AI回评的页面使用唤醒词召唤AI
-- **自动回复** — 监听新评论,自动调用 AI 生成回复,支持多轮对话上下文
-- **多语言适配** — 根据评论语言自动用对应语言回复,语言要求可自定义
-- **情感分析** — 分析评论情感倾向(非常正面/正面/中性/负面/非常负面),根据情感调整回复语气
-- **前置过滤(合规检测)** — AI 回复前对评论进行合规性分类,自动拦截广告/辱骂攻击/敏感内容/乱码,违规评论停止生成 AI 回复以节省 Token,可选自动将违规评论设为待审核状态
-- **误报反馈** — 被误拦截的评论可进行误报反馈,支持"AI回复"和"仅通过"两种处理方式,"仅通过"后可随时补触发 AI 回复
-- **草稿模式** — AI 回复先存为草稿,管理员审核后再发布,支持批量通过/拒绝/删除
-- **失败重试** — AI 生成失败时自动重试,最大重试次数可配置(0-10次,默认3次)
-- **对话轮次限制** — 同一评论线程中限制 AI 最多回复轮次,0为不限制,默认10轮
-- **速率限制** — 每小时最大 AI 回复数量,0为不限制,防止批量评论消耗过多额度
-- **文章/页面级开关** — 在文章编辑器中直接控制是否启用 AI 回复,支持全局页面开关一键启用/禁用所有页面(包括新建页面),文章默认开启,页面默认关闭
-- **评论者黑/白名单** — 支持按名称、邮箱屏蔽/信任指定评论者,支持批量添加和批量移除,站长不可手动移除
+- **多 AI 角色** — 独立昵称、人格提示词、性别、语气和 Gravatar 头像,支持按文章分类指定角色,人格提示词留空时使用基础配置
+- **唤醒词** — 评论以唤醒词开头可唤醒指定角色,支持跨页面唤醒和二级评论
+- **自动回复** — 监听新评论自动调用 AI 生成回复,支持多轮对话上下文
+- **多语言适配** — 根据评论语言自动用对应语言回复,语言要求提示词可自定义
+- **情感分析** — 5 级情感分类(非常正面/正面/中性/负面/非常负面),根据情感调整回复语气
+- **前置过滤(合规检测)** — AI 回复前对评论进行合规性分类,自动拦截广告/辱骂/敏感/乱码内容,节省 Token
+- **误报反馈** — 被误拦截的评论可进行误报反馈,支持"AI回复"和"仅通过"两种方式
+- **草稿模式** — AI 回复先存为草稿,管理员审核后再发布,支持批量操作
+- **失败重试** — AI 生成失败时自动重试,最大重试次数可配置(0-10 次,默认 3 次)
+- **对话轮次限制** — 限制 AI 最多回复轮次,0 为不限制,默认 10 轮
+- **速率限制** — 每小时最大 AI 回复数量,0 为不限制
+- **文章/页面级开关** — 文章默认开启、页面默认关闭,支持全局页面 AI 回复开关一键控制
+- **评论者黑/白名单** — 批量添加/移除评论者,白名单跳过前置过滤,黑名单不触发 AI 回复
- **手动触发** — 在评论管理页面对历史评论手动触发 AI 回复
-- **安全审核** — 安全检查与违规内容拦截
-- **Prompt 模板** — 支持分模块自定义 Prompt 模板(角色身份/安全审核/情感适配/输出规范/语言要求),提供多种模板变量(文章标题、发布日期、评论内容、对话历史等)
-- **插件健康检查** — 实时检测 AI Foundation 安装状态、启用状态、模型配置状态,针对不同异常状态提供快捷跳转按钮
-- **日志筛选与实时刷新** — 按状态、情感、角色筛选,关键词搜索,支持查看拦截原因和分类标签;实时刷新偏好自动保存,默认开启10秒间隔
-- **数据清理** — 自动清理超过指定天数的旧记录,手动清理支持自定义时间节点(默认清理7天前的记录)
-- **Comment Next 兼容** — 检测到 Comment Next 插件时显示提醒,避免冲突
-- **AI Foundation 集成** — 通过 Halo 官方推荐的 `ExtensionGetter` 获取 AI 服务,需安装 AI Foundation 插件
+- **模块化提示词** — 5 个独立模块(角色身份/安全审核/情感适配/输出规范/语言要求),均为可选,留空使用默认值
+- **智能状态检测** — 自动检测 AI Foundation 安装/启用/模型配置状态,检测 Comment Next 冲突
+- **日志与实时刷新** — 按状态、情感、角色筛选,关键词搜索,实时刷新偏好自动保存
+- **数据清理** — 自动清理旧记录,手动清理支持自定义时间节点和二次确认
+- **配置导入导出** — JSON 格式备份和迁移配置
## 前置要求
- Halo 2.25+
-- AI Foundation 插件(必须)
+- [AI Foundation](https://www.halo.run/store/apps/app-acslk9nu) 插件(必须)
## 安装
-### 应用商店安装
+### 应用商店
进入 **插件** → **安装** → 应用市场搜索 **AI回评** → 安装,或前往 [Halo 应用商店](https://www.halo.run/store/apps/app-mo5tivjt) 一键安装。
@@ -45,85 +43,78 @@
4. 选择下载的 `.jar` 文件上传
5. 安装完成后启用插件
-## 首次使用配置指南
+## 首次使用
安装并启用插件后,请按以下步骤完成初始配置:
-### 第一步:安装 AI Foundation 插件
+### 1. 安装 AI Foundation 插件
-AI回评依赖 [AI Foundation](https://www.halo.run/store/apps/app-acslk9nu) 插件提供 AI 能力。请确保:
-1. 已在 **插件** 页面安装并启用了 AI Foundation 插件
+AI 回评依赖 AI Foundation 插件提供 AI 能力。请确保:
+
+1. 已在 **插件** 页面安装并启用 AI Foundation 插件
2. 在 AI Foundation 中添加了至少一个 AI 模型(如 OpenAI、Ollama、DeepSeek 等)
-3. 在 **AI Foundation → 默认模型** 页面(`/console/ai-foundation/defaults`)设置了默认模型
+3. 在 **AI Foundation → 默认模型** 页面设置了默认模型
-> 💡 插件首页会自动检测 AI Foundation 状态,如未安装/未启用/未配置模型,将显示对应的提示和快捷跳转按钮。
+> 插件首页会自动检测 AI Foundation 状态,如未安装/未启用/未配置模型,将显示对应的提示和快捷跳转按钮。
-### 第二步:配置基础设置
+### 2. 配置基础设置
进入 **评论 → AI回评 → 设置**,在"基本设置"面板中:
-- **自动回复**:默认开启,关闭则需手动触发回复
-- **自动发布**:开启后AI回复直接发布,关闭则进入草稿待审核
-- **最大重试次数**:默认3次(0-10),AI生成失败时的重试次数
-- **最大对话轮次**:默认10轮,0为不限制
-- **速率限制(每小时)**:默认0(不限制),防止批量评论消耗过多额度
-- **启用页面AI回复**:默认关闭,开启后所有独立页面(非文章)默认启用AI回复
-- **前置过滤(合规检测)**:建议开启,自动拦截广告/辱骂/敏感内容
-- **白名单启用**:白名单内的评论者跳过前置过滤
-### 第三步:配置提示词
+- **自动回复**:默认开启,关闭则需手动触发
+- **自动发布**:开启后 AI 回复直接发布,关闭则进入草稿待审核
+- **最大重试次数**:默认 3 次(0-10)
+- **最大对话轮次**:默认 10 轮,0 为不限制
+- **速率限制(每小时)**:默认 0(不限制)
+- **启用页面 AI 回复**:默认关闭,开启后所有页面一键启用
+- **前置过滤**:建议开启,自动拦截广告/辱骂/敏感内容
+- **白名单**:白名单内评论者跳过前置过滤
-切换到"提示词设置"面板:
-- **角色身份提示词(personaIdentity)**:定义 AI 的基础身份和回复风格,这是全局默认角色
-- 其他提示词模块(安全审核/情感适配/输出规范/语言要求)可按需调整,留空使用默认值
+### 3. 配置提示词(可选)
-### 第四步:(可选)创建 AI 角色
+切换到"提示词设置"面板,5 个模块均为可选,留空使用默认值:
-在"AI角色管理"面板点击"添加角色",可创建多个AI角色:
-- 为角色设置昵称、邮箱(用于Gravatar头像)、性别、语气风格
-- **人格提示词**:独立角色的人格设定,留空则使用基础配置中的角色身份提示词
-- **唤醒词**:评论以唤醒词开头可直接召唤该角色回复
+- **角色身份提示词**:定义 AI 的基础身份和回复风格
+- 其他模块(安全审核/情感适配/输出规范/语言要求)可按需调整
+
+### 4. 创建 AI 角色(可选)
+
+在"AI角色管理"面板点击"添加角色":
+
+- 设置昵称、邮箱(Gravatar 头像)、性别、语气风格
+- **人格提示词**:留空则使用基础配置的角色身份提示词
+- **唤醒词**:评论以唤醒词开头可召唤该角色
- 可为不同文章分类指定不同角色
-### 第五步:(可选)配置黑/白名单
+### 5. 配置黑/白名单(可选)
在"基本设置"面板的评论者黑/白名单区域:
-- **黑名单**:被屏蔽的评论者不会触发AI回复,支持批量添加/移除
-- **白名单**:信任的评论者优先处理并跳过前置过滤
-- 点击"添加评论者"可从历史评论者中多选批量添加,也支持手动输入名称或邮箱
-### 第六步:开始使用
+- 支持从历史评论者中多选批量添加,也支持手动输入
+- 黑名单评论者不触发 AI 回复,白名单评论者跳过前置过滤
-配置完成后:
-- 新评论会自动触发AI回复(如果文章/页面启用了AI回评)
-- 在 **评论 → AI回评 → 回复日志** 中查看所有AI回复记录和状态
-- 可在日志页面手动触发历史评论的AI回复
+### 6. 开始使用
+
+- 新评论会自动触发 AI 回复(如果文章/页面启用了 AI 回评)
+- 在 **评论 → AI回评 → 回复日志** 中查看所有记录
- 如需临时关闭,在"基本设置"中关闭"自动回复"开关即可
-> 💡 文章级开关:编辑文章时,右侧设置面板中有"AI回评"开关,可单独控制每篇文章是否启用AI回复。
+> 编辑文章时,右侧设置面板中有"AI回评"开关,可单独控制每篇文章。
## 从源码构建
```bash
-# 克隆仓库
git clone https://github.com/sunny-335/plugin-comment-ai-autopilot.git
cd plugin-comment-ai-autopilot
-
-# 构建
./gradlew build -x test
-
# 构建产物位于 build/libs/ 目录
```
## 开发
```bash
-# 启用插件开发服务器
-./gradlew haloServer
-
-# 开发前端
-cd ui
-pnpm install
-pnpm dev
+./gradlew haloServer # 启动开发服务器
+cd ui && pnpm install && pnpm dev # 前端开发
```
## 文档
@@ -133,3 +124,19 @@ pnpm dev
## 许可证
[GPL-3.0](https://github.com/sunny-335/plugin-comment-ai-autopilot/blob/main/LICENSE) © 暖心向阳335
+
+---
+
+
+AI 辅助开发声明
+
+本项目在开发过程中使用了以下 AI 模型辅助编码:
+
+- **GLM-5.1 / GLM-5.2**(智谱AI)
+- **Qwen3.6 / Qwen3.7 Plus**(阿里通义千问)
+- **Doubao Seed 2.1 Pro**(字节豆包)
+- **MIMO V2.5**(小米)
+
+AI 辅助范围包括:代码生成、Bug 修复、代码审查、文档撰写。所有代码均经人工审查和测试验证后合并。
+
+
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index ed1a29a..cd76425 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,25 @@
# 更新日志
+## v1.4.1
+
+> 2026-07-06
+
+### 改进
+
+- **重写 README.md** — 精简结构,添加 AI 辅助开发声明(GLM-5.1/5.2、Qwen3.6/3.7 Plus、Doubao Seed 2.1 Pro、MIMO V2.5)
+- **死代码清理** — 移除 6 项未使用的代码和依赖
+
+### 移除
+
+- **WhitelistService.isSuperAdmin** — 未使用的 private 方法,功能已被 isAdminUser 覆盖
+- **CommentAiAutopilotEndpoint.PersonaResponse** — 未使用的 record 定义
+- **AiBadgeHeadProcessor** — 空操作的 TemplateHeadProcessor 实现类(整个文件删除)
+- **ui/src/utils/api.ts** — 未使用的 API 路径常量文件(整个文件删除)
+- **ui/src/utils/gravatar.ts** — 未使用的 Gravatar 工具文件(整个文件删除)
+- **canvas-confetti 依赖** — package.json 中声明但从未 import 的前端依赖
+
+---
+
## v1.4.0
> 2026-07-06
diff --git a/gradle.properties b/gradle.properties
index d5223ef..ca0e7a5 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -1,4 +1,4 @@
-version=1.4.0
+version=1.4.1
# Fix Windows Gradle Worker Daemon exit code 268435659 when running pnpm via Exec tasks
org.gradle.daemon=false
diff --git a/src/main/java/top/nxxy335/commentaiautopilot/endpoint/CommentAiAutopilotEndpoint.java b/src/main/java/top/nxxy335/commentaiautopilot/endpoint/CommentAiAutopilotEndpoint.java
index 4a3c8ac..1b8c11e 100644
--- a/src/main/java/top/nxxy335/commentaiautopilot/endpoint/CommentAiAutopilotEndpoint.java
+++ b/src/main/java/top/nxxy335/commentaiautopilot/endpoint/CommentAiAutopilotEndpoint.java
@@ -524,12 +524,6 @@ public class CommentAiAutopilotEndpoint implements CustomEndpoint {
long filteredCount
) {}
- public record PersonaResponse(
- String name,
- String prompt,
- String avatar
- ) {}
-
private Mono getConversation(ServerRequest request) {
var commentName = request.pathVariable("commentName");
return client.fetch(Comment.class, commentName)
diff --git a/src/main/java/top/nxxy335/commentaiautopilot/processor/AiBadgeHeadProcessor.java b/src/main/java/top/nxxy335/commentaiautopilot/processor/AiBadgeHeadProcessor.java
deleted file mode 100644
index 4e4ce28..0000000
--- a/src/main/java/top/nxxy335/commentaiautopilot/processor/AiBadgeHeadProcessor.java
+++ /dev/null
@@ -1,28 +0,0 @@
-package top.nxxy335.commentaiautopilot.processor;
-
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Component;
-import org.thymeleaf.context.ITemplateContext;
-import org.thymeleaf.model.IModel;
-import org.thymeleaf.processor.element.IElementModelStructureHandler;
-import reactor.core.publisher.Mono;
-import run.halo.app.theme.dialect.TemplateHeadProcessor;
-
-/**
- * Template head processor for comment-ai-autopilot.
- * Previously used to inject avatar replacement scripts, but now
- * avatar is handled natively via Gravatar (email-based).
- * Kept as a no-op to avoid breaking the Spring component scan.
- */
-@Component
-@Slf4j
-@RequiredArgsConstructor
-public class AiBadgeHeadProcessor implements TemplateHeadProcessor {
-
- @Override
- public Mono process(ITemplateContext context, IModel model,
- IElementModelStructureHandler structureHandler) {
- return Mono.empty();
- }
-}
diff --git a/src/main/java/top/nxxy335/commentaiautopilot/service/WhitelistService.java b/src/main/java/top/nxxy335/commentaiautopilot/service/WhitelistService.java
index 1e98e34..ead605d 100644
--- a/src/main/java/top/nxxy335/commentaiautopilot/service/WhitelistService.java
+++ b/src/main/java/top/nxxy335/commentaiautopilot/service/WhitelistService.java
@@ -137,27 +137,6 @@ public class WhitelistService {
return Mono.just(matchByDisplayName(owner, config.list()));
}
- /**
- * 通过 User 资源的角色注解判断是否为超级管理员(super-role)。
- */
- private Mono isSuperAdmin(String username) {
- return client.fetch(User.class, username)
- .map(user -> {
- var annotations = user.getMetadata().getAnnotations();
- if (annotations == null) return false;
- String roleNames = annotations.get(User.ROLE_NAMES_ANNO);
- if (roleNames == null || roleNames.isBlank()) return false;
- return Arrays.stream(roleNames.split(","))
- .map(String::trim)
- .anyMatch(SUPER_ROLE::equals);
- })
- .defaultIfEmpty(false)
- .onErrorResume(e -> {
- log.debug("[Whitelist] 获取 User {} 失败: {}", username, e.getMessage());
- return Mono.just(false);
- });
- }
-
private Mono isAdminUser(String username) {
return client.fetch(User.class, username)
.map(user -> {
diff --git a/src/main/resources/plugin.yaml b/src/main/resources/plugin.yaml
index 1fb37eb..fb5029c 100644
--- a/src/main/resources/plugin.yaml
+++ b/src/main/resources/plugin.yaml
@@ -33,4 +33,4 @@ spec:
url: "https://github.com/sunny-335/plugin-comment-ai-autopilot/blob/main/LICENSE"
settingName: "comment-ai-autopilot-settings"
configMapName: "comment-ai-autopilot-configmap"
- version: "1.4.0"
+ version: "1.4.1"
diff --git a/ui/package.json b/ui/package.json
index d0dc7dc..9ae1a6e 100644
--- a/ui/package.json
+++ b/ui/package.json
@@ -31,7 +31,6 @@
"@halo-dev/ui-plugin-bundler-kit": "^2.23.0",
"@iconify-json/ri": "^1.2.6",
"@tsconfig/node20": "^20.1.6",
- "@types/canvas-confetti": "^1.9.0",
"@types/jsdom": "^21.1.7",
"@types/node": "^20.19.1",
"@vitest/eslint-plugin": "^1.2.7",
diff --git a/ui/pnpm-lock.yaml b/ui/pnpm-lock.yaml
index c4ec493..06787b7 100644
--- a/ui/pnpm-lock.yaml
+++ b/ui/pnpm-lock.yaml
@@ -20,9 +20,6 @@ importers:
axios:
specifier: ^1.13.5
version: 1.17.0
- canvas-confetti:
- specifier: ^1.9.3
- version: 1.9.4
vue:
specifier: ^3.5.28
version: 3.5.38(typescript@5.8.3)
@@ -42,9 +39,6 @@ importers:
'@tsconfig/node20':
specifier: ^20.1.6
version: 20.1.9
- '@types/canvas-confetti':
- specifier: ^1.9.0
- version: 1.9.0
'@types/jsdom':
specifier: ^21.1.7
version: 21.1.7
@@ -695,9 +689,6 @@ packages:
'@tybys/wasm-util@0.10.2':
resolution: {integrity: sha512-RoBvJ2X0wuKlWFIjrwffGw1IqZHKQqzIchKaadZZfnNpsAYp2mM0h36JtPCjNDAHGgYez/15uMBpfGwchhiMgg==}
- '@types/canvas-confetti@1.9.0':
- resolution: {integrity: sha512-aBGj/dULrimR1XDZLtG9JwxX1b4HPRF6CX9Yfwh3NvstZEm1ZL7RBnel4keCPSqs1ANRu1u2Aoz9R+VmtjYuTg==}
-
'@types/chai@5.2.3':
resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
@@ -1040,9 +1031,6 @@ packages:
resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==}
engines: {node: '>=6'}
- canvas-confetti@1.9.4:
- resolution: {integrity: sha512-yxQbJkAVrFXWNbTUjPqjF7G+g6pDotOUHGbkZq2NELZUMDpiJ85rIEazVb8GTaAptNW2miJAXbs1BtioA251Pw==}
-
chai@6.2.2:
resolution: {integrity: sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==}
engines: {node: '>=18'}
@@ -3051,8 +3039,6 @@ snapshots:
tslib: 2.8.1
optional: true
- '@types/canvas-confetti@1.9.0': {}
-
'@types/chai@5.2.3':
dependencies:
'@types/deep-eql': 4.0.2
@@ -3466,8 +3452,6 @@ snapshots:
callsites@3.1.0: {}
- canvas-confetti@1.9.4: {}
-
chai@6.2.2: {}
chalk@4.1.2:
diff --git a/ui/src/utils/api.ts b/ui/src/utils/api.ts
deleted file mode 100644
index 73a22be..0000000
--- a/ui/src/utils/api.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * 统一 API 路径常量,避免硬编码散布在多个 Vue 文件中。
- * 修改 API 路径只需在此处更新。
- */
-export const API_BASE = '/apis/console.api.comment-ai-autopilot.nxxy335.top/v1alpha1'
-
-// ===== 日志相关 =====
-export const API_REPLIES = `${API_BASE}/replies`
-export const apiReply = (name: string) => `${API_REPLIES}/${name}`
-export const apiReplyAction = (name: string, action: string) => `${API_REPLIES}/${name}/${action}`
-export const API_BATCH_APPROVE = `${API_REPLIES}/batch-approve`
-export const API_BATCH_REJECT = `${API_REPLIES}/batch-reject`
-export const API_BATCH_DELETE = `${API_REPLIES}/batch-delete`
-export const apiConversation = (commentId: string) => `${API_BASE}/conversation/${commentId}`
-
-// ===== 概览相关 =====
-export const API_STATS = `${API_BASE}/stats`
-export const API_PERSONAS = `${API_BASE}/personas`
-export const apiPersona = (name: string) => `${API_PERSONAS}/${name}`
-export const API_HEALTH = `${API_BASE}/health`
-
-// ===== 设置相关 =====
-export const API_EXPORT = `${API_BASE}/export`
-export const API_IMPORT = `${API_BASE}/import`
-export const API_COMMENTERS = `${API_BASE}/commenters`
-export const API_CLEANUP = `${API_BASE}/cleanup`
-
-// ===== 评论触发 =====
-export const apiCommentTrigger = (commentName: string) => `${API_BASE}/comments/${commentName}/trigger`
diff --git a/ui/src/utils/gravatar.ts b/ui/src/utils/gravatar.ts
deleted file mode 100644
index 02537d7..0000000
--- a/ui/src/utils/gravatar.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-export async function computeGravatarHash(email: string): Promise {
- if (!email || email.trim() === '') return ''
- const normalizedEmail = email.trim().toLowerCase()
- const encoder = new TextEncoder()
- const data = encoder.encode(normalizedEmail)
- const hashBuffer = await crypto.subtle.digest('SHA-256', data)
- const hashArray = Array.from(new Uint8Array(hashBuffer))
- return hashArray.map(b => b.toString(16).padStart(2, '0')).join('')
-}
-
-export function getGravatarUrl(hash: string): string {
- if (!hash) return ''
- return `https://cn.cravatar.com/avatar/${hash}`
-}