feat: v1.0.0-beta.1 - AI Foundation reflection integration and draft mode fix

This commit is contained in:
sunny-335
2026-06-16 23:20:51 +08:00
parent 72726da9b8
commit d737cbc8f1
26 changed files with 410 additions and 601 deletions
+5 -31
View File
@@ -1,28 +1,6 @@
# AI角色
AI角色定义了回复评论的虚拟身份,包括昵称、人格和头像。支持创建多个角色并灵活管理。
## 多角色管理
插件支持创建多个AI角色,每个角色有独立的昵称、人格提示词和Gravatar头像。在设置页面的 **AI角色设置** 区域可以管理所有角色。
### 默认角色
系统必须保留一个默认角色,用于没有指定角色的场景。默认角色不可删除,但可以将其他角色设为默认。
### 角色排序
多角色场景下,可以使用角色卡片上的 ▲▼ 按钮调整角色顺序。排序会影响角色在列表中的展示顺序。
### 角色操作
| 操作 | 说明 |
|------|------|
| 添加角色 | 点击"添加角色"按钮创建新角色 |
| 编辑角色 | 点击编辑图标修改角色信息 |
| 删除角色 | 点击删除图标移除角色(默认角色不可删除) |
| 设为默认 | 点击星标图标将角色设为默认角色 |
| 排序 | 使用 ▲▼ 按钮调整角色顺序 |
AI角色定义了回复评论的虚拟身份,包括昵称、人格和头像。
## 角色配置
@@ -50,11 +28,11 @@ AI回复者的显示名称,默认为「小回」。修改后新回复将使用
### 邮箱与头像
填写邮箱后,AI回复者的头像将通过 CravatarGravatar 镜像)服务自动生成:
填写邮箱后,AI回复者的头像将通过 Gravatar 服务自动生成:
1. 插件根据邮箱生成 SHA-256 哈希
2. 构造头像 URL`https://cn.cravatar.com/avatar/{hash}`
3. Halo 评论系统通过 `email-hash` 注解自动匹配头像
2. 构造 Gravatar URL`https://cn.cravatar.com/avatar/{hash}`
3. 头像URL存储在评论的 `owner.annotations["avatar"]`
::: warning
如果不填写邮箱,AI回复者将使用 Halo 默认头像。
@@ -62,7 +40,7 @@ AI回复者的显示名称,默认为「小回」。修改后新回复将使用
### 头像预览
角色编辑对话框中输入邮箱后,会实时显示 Gravatar 头像预览,方便确认头像是否正确。
设置页面输入邮箱后,右侧会实时显示 Gravatar 头像预览,方便确认头像是否正确。
::: tip
如果预览头像不正确,请检查:
@@ -70,7 +48,3 @@ AI回复者的显示名称,默认为「小回」。修改后新回复将使用
2. 是否已在 [Gravatar](https://gravatar.com) 上为该邮箱设置头像
3. 头像更新可能有缓存延迟
:::
::: info
由于 Halo 评论系统的限制,AI角色头像仅支持通过 Gravatar 邮箱方式设置,不支持自定义上传头像。这是因为 Halo 的评论组件对匿名评论者(kind=Email)始终使用 `email-hash` 注解生成 Gravatar 头像,忽略自定义头像 URL。
:::