docs: 全面更新v1.4.0文档

- index.md: 更新特性卡片(移除自学习,新增页面开关/状态检测/批量操作)

- introduction.md: 更新核心功能列表(5模块提示词/页面开关/批量操作/智能检测)

- settings.md: 重写设置文档(新配置项/白名单批量操作/页面开关/状态检测/手动清理)

- prompt.md: 四模块改为五模块(新增语言要求),移除自学习引用,标注可选

- persona.md: 添加人格提示词留空使用基础配置说明

- filter.md: 添加全局页面开关和白名单批量操作说明

- cleanup.md: 添加手动清理时间节点和二次确认说明

- auto-reply.md: 更新配置项表格(重试/轮次/速率限制)

- faq.md: 更新AI Foundation状态检测和清理问题

- CHANGELOG.md: 重写v1.4.0更新日志
This commit is contained in:
sunny-335
2026-07-07 08:26:05 +08:00
parent 3da2929304
commit 60d938c1da
10 changed files with 193 additions and 183 deletions
+31 -36
View File
@@ -2,51 +2,46 @@
## v1.4.0
> 2026-07-02
> 2026-07-06
### 新增
- **AI审核白名单** — 管理员自动入白名单 + 支持手动添加其他评论者;白名单内评论跳过 AI 审核拦截。与黑名单并排显示
- **黑/白名单移除按钮** — 名单列表中每个评论者新增移除按钮
- **Comment Next 插件冲突检测** — 检测 plugin-comment-next 是否安装启用,若启用则提示冲突并提供 AI回复/AI拦截配置页跳转链接
- **日志「操作」按钮** — 替代原删除按钮,根据记录状态显示不同操作(取消通过AI回复/取消通过评论者评论/触发AI回复/删除违规评论
- **日志回复角色显示与筛选** — 日志列表显示回复角色名标签,筛选下拉新增角色筛选项
- **取消通过AI回复/评论者评论** — 新增端点支持取消已发布回复的通过状态
- **模块化提示词配置** — 拆分为角色身份、安全审核、情感适配、输出规范4个独立模块,各默认填入完整默认值
- **设置页新增配置项** — 最大重试次数、最大对话轮次(支持0=无限制+二次确认)、速率限制(支持0=无限制+二次确认)、回复质量自学习开关
- **AI Foundation 未安装明确提示** — 显示「未安装插件依赖」+ 安装链接
- **首页待审核卡片条件显示** — 仅在关闭自动发布时显示,启用前置过滤且违规设待审核时显示违规待审核数
- **日志删除评论多选项** — 日志页删除按钮改为弹窗,根据记录状态提供不同选项
- 正常状态(PASS/PENDING/REVIEWING/FALSE_POSITIVE)提供「仅删除AI回评」「删除评论者评论」「仅删除日志」「取消」四项
- 已拦截状态(FILTERED)提供「确定」「取消」二项
- 「仅删除AI回评」删除已发布 Reply 扩展,日志标记为 DELETED 保留
- 「删除评论者评论」级联删除 Comment 及关联 Reply/AiCommentReply
- **AI角色按场景切换** — 支持为文章分类(Category)指定默认 AI 角色,在模型设置中配置分类角色映射。解析优先级:唤醒词 > Post/Category/Tag 标注 > 分类角色映射 > 全局默认。瞬间评论使用全局默认
- **回复质量自学习** — 从历史被拒绝回复中提取共性特征(长度/开头词/语气词),生成时注入「避免以下风格」提示。默认关闭,在基本设置中开启
- **首页待审核卡片** — 首页新增待审核独立卡片,一键跳转审核
- **黑/白名单批量操作** — 支持多选、全选、批量添加/移除评论者,弹窗支持从历史评论者多选和手动输入
- **全局页面AI回复开关** — 一键启用/禁用所有独立页面的AI回复(包括新建页面),默认关闭
- **语言要求提示词模块** — 新增第五个提示词模块 `languageRequirement`,可自定义多语言回复规则
- **已拦截数统计** — 首页概览卡片新增已拦截数统计(已失败和待审核之间
- **AI Foundation 智能状态检测** — 区分未安装/未启用/未配置模型三种状态,提供对应快捷跳转按钮
- **手动清理自定义时间节点** — 手动清理支持自定义清理天数(默认7天前),二次确认弹窗防误操作
- **实时刷新偏好持久化** — 日志页实时刷新开关和刷新间隔通过 localStorage 自动保存,默认开启10秒间隔
- **配置导入导出** — 支持将插件配置(ConfigMap + AI角色)导出为 JSON 文件,方便备份和迁移
### 改进
- **首页角色卡片完善** — 显示完整角色信息(唤醒词、性别等)
- **「查看日志」按钮移至标题栏** — 位于「插件设置」右侧
- **移除角色卡片「修改配置」按钮** — 统一使用标题栏入口
- **分类角色映射移至AI角色配置组** — 从模型设置组迁移
- **移除提示词预设** — 避免自定义角色时提示词重复组合,预设模板移至文档
- **统一使用 Halo 官方弹窗组件** — 所有二次确认弹窗改用 `VModal` 组件,移除浏览器原生 `confirm()`。删除角色、导入配置等操作均使用统一的官方弹窗
- **AI角色删除后自动刷新** — 删除角色后自动重新拉取角色列表,确保已删除角色不再显示
- **日志页分页改用官方组件** — 使用 Halo 官方 `VPagination` 组件,新增每页条数选择器(10/20/50/100,默认20
- **首页信息整合** — 「回复概览」更名为「概览」,移除通过率进度条,AI Foundation 连接状态整合到概览卡片,移除独立健康横幅和快捷操作卡片
- **自定义提示词模板默认留空** — settings.yaml 默认值改为空字符串,未填写时后端使用完整 `DEFAULT_PROMPT_TEMPLATE`
- **修复文档变量显示问题** — 文档中 `{{变量}}` 在 markdown 渲染时不显示,改用 `<code v-pre>` 包裹修复
- **修正头像默认行为描述** — 邮箱为空时使用 Gravatar 默认头像(非 Halo 默认头像)
- **"提示词"改为"人格提示词"** — AI角色编辑弹窗中的提示词改名为人格提示词,留空时使用基础配置的 personaIdentity
- **配置项重构** — 最大重试次数(0为不重试,最大10,默认3)、最大对话轮次(0为不限制,默认10)、速率限制(0为不限制,默认0/h)移至基本设置,滑条改为输入框,模型设置中删除重复项
- **提示词均为可选项** — 五个提示词模块均标注"(可选)",留空使用默认值
- **白名单文案修正** — 删除"管理员自动加入白名单"的显示文案(实际不支持自动加入)
- **手动清理区域样式优化** — 红色危险主题卡片式布局,输入框组与按钮高度对齐
- **分类角色映射迁移** — 从模型设置组迁移至 AI 角色配置组(persona)
- **瞬间评论 group 校验** — Moment 评论判断增加 group 双重校验,避免误判同名资源
### 移除
- **回复质量自学习功能** — 因正常情况下不会被拒绝且已有自动审核,移除 ReplyLearningService 及所有相关引用
- **提示词预设开关** — 移除设置页内的提示词预设开关(友好型/专业型/幽默型/简洁型),预设模板保留在文档中
### Bug 修复
- **修复删除违规评论时误删日志** — deleteCommenterComment 改为保留 AiCommentReply 日志记录,仅删除 Comment 和 Reply 扩展
- **修复 WhitelistService 类型推断错误** — ObjectNode 三元表达式类型推断问题
- **修复配置导入 400 Bad Request** — 导出的 personas 含完整 Extension 只读元数据(creationTimestamp/finalizers/labels 等),导入更新时未清理导致校验异常。导入前清洗 metadata 仅保留必要字段
- **修复 `deleteAiReplyOnly` 乐观锁重试无效** — 删除 Reply 期间版本号可能过期,重试复用过期 record 必然失败。改为重试前重新 fetch 最新版本
- **修复 `deleteCommenterComment` 空指针风险** — AiCommentReply 列表过滤未检查 `spec == null`,畸形数据触发 NPE
- **修复配置导入 400 Bad Request** — 导入时清除 persona 的 labels、annotations 等只读 metadata 字段
- **修复所有注册用户绕过白名单过滤** — WhitelistService 中 isRegisteredUser 改为 isAdminUser,只检查 super-role 和 role-admin
- **修复 getAdminList 误标管理员** — 改为只匹配 role-admin 角色的用户
- **修复手动输入评论者无法添加** — addManualEntry 方法实际将条目加入选中列表
- **修复手动输入框回车触发表单提交** — 添加 .prevent 修饰符
- **修复 AI Foundation 状态显示不正确** — 未配置模型时不再错误显示"连接正常"
- **修复 Comment Next 冲突提醒不显示** — 增强检测逻辑支持多种插件名称模式
- **修复 AI Foundation 插件跳转路径** — 从 /console/plugins/plugin-ai-foundation 改为 /console/plugins/ai-foundation
- **修复前端导入错误提示不显示** — 显示实际错误信息而非通用的"导入失败"
- **修复 categoryPersonaMap 配置分组不一致** — 新增 persona 配置组,前端正确读写
---