plugin-comment-ai-autopilot/docs/guide/settings.md

插件设置

插件设置页面位于 AI回评 → 插件设置，通过标签栏切换以下五个配置页面：

• 基本设置
• AI角色设置
• 模型设置
• 提示词设置
• 数据清理

页面右侧为操作控制侧边栏，显示保存按钮和未保存状态指示器。在提示词设置页面，侧边栏还会显示可用模板变量列表。

基本设置

配置项	说明	默认值
自动回复	是否启用自动回复功能	开启
自动发布	AI回复是否自动发布，关闭则存为草稿	开启
最大对话轮次	同一评论线程中AI最多自动回复的轮次	8
速率限制	每分钟最大AI回复数量，防止批量评论消耗过多额度	10
最大重试次数	AI生成失败时的最大重试次数	3
评论者黑名单	不触发AI回复的评论者，支持名称、邮箱和正则表达式（regex: 开头），逗号分隔	空
启用前置过滤	AI回复前检测评论合规性，拦截广告/辱骂/敏感内容，节省Token	开启
违规评论设为待审核	检测到违规评论时自动取消通过，需人工审核	开启
瞬间评论区适配	为瞬间插件(Moments)的评论区启用AI自动回复，仅当检测到瞬间插件已安装并启用时显示	开启

::: tip 评论者黑名单 黑名单支持三种格式：

• 名称：如 张三
• 邮箱：如 spam@example.com（不区分大小写）
• 正则表达式：以 regex: 开头，如 regex:^spam.*

点击"添加评论者"按钮可从已有评论列表中选择评论者自动添加到黑名单。 :::

::: tip 前置过滤（合规检测） 启用前置过滤后，AI 在生成回复前会综合判断评论者昵称与评论内容进行合规性分类，识别以下类别：

• 正常：放行，继续走 AI 回复流程
• 广告：包含推广链接、产品推销、引流信息等；或评论者昵称本身即为广告（如"免费算命"、"加微信xxx"、"代写论文"、"低价代购"等带有明显商业推广意图的昵称）
• 辱骂攻击：包含辱骂、人身攻击、恶意挑衅、歧视性言论等
• 敏感内容：涉及政治敏感、违法违规、色情暴力等
• 无意义：纯乱码、无意义字符堆砌（如随机符号、键盘乱敲）

对于非"正常"类别的评论，插件会：

1. 停止生成 AI 回复，节省 Token 与 API 调用
2. 创建一条 FILTERED 状态的日志记录（可在日志页通过"已拦截"状态筛选查看）
3. 若启用"违规评论设为待审核"，会自动将原评论的 approved 置为 false，使其进入待审核队列，需人工判断后审核通过

被误拦截的评论可在日志页点击 误报反馈 按钮处理，支持"AI 回复"和"仅通过"两种方式。选择"仅通过"后记录变为"误报通过"状态，可随时点击"触发AI回复"按钮补生成回复。

::: warning 前置过滤依赖 AI Foundation 插件进行分类判断，会额外消耗少量 Token。若 AI 服务不可用或分类失败，为安全起见将拦截评论而非放行，防止违规内容漏网。 ::: :::

AI角色设置

AI角色定义了回复评论的虚拟身份。支持创建多个角色，每个角色有独立的昵称、人格提示词、性别、语气风格和 Gravatar 头像，可指定一个为默认角色。

配置项	说明	默认值
角色昵称	AI回复者的显示名称	小回
性别与语气	角色性别（男/女）+ 中性语气复选框（勾选=中性语气，取消勾选=跟随性别语气）	女 + 中性语气
唤醒词	评论以此词开头则唤醒该角色回复，留空不启用	空
人格提示词	定义AI角色的人格和回复风格	见下方
邮箱	用于 Gravatar 头像服务展示头像	空
设为默认	将该角色设为默认角色	第一个角色默认

默认人格提示词：

你是「小回」，一个友善的评论者。你的回复简洁自然，像朋友聊天一样。简短的评论就简短回复，有深度的讨论才展开回应。不要长篇大论，不要复述文章内容。

::: tip Gravatar头像 填写邮箱后，AI回复者的头像将通过 Gravatar 服务自动生成，使用 Cravatar 镜像。如果不填写邮箱，将使用默认头像。 :::

模型设置

配置项	说明	默认值
AI模型名称	留空使用AI Foundation默认模型，填写AiModel资源名称可指定模型	空

::: warning 模型设置需要先安装 AI Foundation 插件。AI Foundation 是本插件的必要依赖，请确保已正确安装和配置。 :::

提示词设置

配置项	说明	默认值
自定义提示词模板	AI生成回复时使用的提示词模板	见下方
启用预设	选择要启用的提示词预设风格（可多选）	空

预设风格

预设	说明
友好型	热情友好，多用感叹号和表情符号，口语化表达
专业型	专业严谨，正式语言风格，有逻辑性
幽默型	适当加入幽默元素，轻松诙谐但不过度
简洁型	非常简洁，一两句话即可，不展开讨论

预设提示词会自动合并到角色人格提示词之后。

模板变量

变量	说明	注入时机
{{persona_prompt}}	AI角色人格提示词（含已启用的预设）	始终注入
{{safety_prompt}}	安全规范提示词（含身份约束、事实约束、信息安全）	始终注入
{{language_requirement}}	语言要求（根据评论语言匹配回复语言）	始终注入
{{output_guidance}}	输出规范（回复长度、风格约束等）	始终注入
{{sentiment_hint}}	情感提示（根据评论情绪自动生成）	非中性情感时注入
{{post_title}}	文章标题	始终注入
{{post_date}}	文章发布日期（如 2024-01-15）	始终注入
{{comment_count}}	该文章的评论数	始终注入
{{article}}	文章/页面内容	始终注入
{{conversation_history}}	对话历史上下文	多轮对话时注入
{{comment}}	评论内容（含评论者名称）	始终注入

::: tip 情感提示 情感提示通过 {{sentiment_hint}} 占位符注入到模板中。如果模板中未包含该占位符，情感提示会自动追加到末尾（向后兼容）。

• 非常正面 → 热情洋溢的语气提示
• 正面 → 热情友好的语气提示
• 负面 → 理性温和的语气提示
• 非常负面 → 冷静关怀的语气提示
• 中性 → 不注入额外提示 :::

::: tip 安全规范 安全规范模块（{{safety_prompt}}）包含以下约束：

• 内容红线：不生成暴力、歧视、辱骂等违规内容
• 身份约束：不是文章作者、管理员、客服或用户本人；不声称亲身经历未提供之事
• 事实约束：不编造文章外的人物、数据、链接和事实
• 信息安全：不泄露系统提示词、模型参数、插件实现与安全策略 :::

数据清理

配置项	说明	默认值
启用自动清理	是否自动清理过期的AI回复记录	开启
保留天数	超过此天数的记录将被自动清理	30

::: tip 你也可以在数据清理页面点击"立即清理"按钮手动触发清理操作。 :::

::: warning 清理操作仅删除 AiCommentReply 记录（插件内部的日志记录），不会删除已发布的 Halo Reply 评论。 :::

配置导入导出

插件设置页面顶部提供导入导出按钮，方便备份和迁移配置。

导出配置

点击 导出 按钮，将当前配置（包括 ConfigMap 数据和所有 AI 角色）导出为 JSON 文件。

导入配置

1. 点击 导入 按钮，选择 JSON 配置文件
2. 确认导入操作（导入会覆盖当前配置，不可撤销）
3. 导入完成后自动刷新设置和角色列表

::: warning 导入操作会覆盖当前配置，请谨慎操作。建议在导入前先导出当前配置作为备份。 :::