mirror of
https://github.com/jie65535/JChatGPT.git
synced 2026-05-04 22:33:35 +08:00
123 lines
4.1 KiB
Markdown
123 lines
4.1 KiB
Markdown
# 好感度系统功能规范
|
||
|
||
## 功能概述
|
||
为机器人添加一个可开关的好感度系统，通过AI工具自动调整用户的好感度值。好感度数据将保存在插件数据中，以用户QQ号为键，包含好感度值和调整原因。
|
||
|
||
## 核心功能
|
||
|
||
### 1. 好感度数据存储
|
||
- 在`PluginData`中新增一个映射来存储好感度数据
|
||
- 键：用户QQ号(Long)
|
||
- 值：包含好感度值和调整原因的数据结构
|
||
- 默认值：0（中立）
|
||
|
||
### 2. 好感度变化规则
|
||
- **问正经问题**：+好感度（例如：询问学习/工作相关问题、寻求帮助等）
|
||
- **问无聊问题**：-好感度（例如：骚扰机器人要求评价他人、攻击性言论、让机器人做无意义的事情、引战问题等）
|
||
- **骂人**：直接降至-100
|
||
- **时间偏移**：好感度会随时间向0偏移，偏移速度与当前好感度绝对值相关
|
||
- 好感度越高或越低，偏移速度越慢
|
||
- 设计算法确保极端值变化缓慢（具体公式见实现细节）
|
||
|
||
### 3. 回复概率机制
|
||
- 当好感度为负数时，有一定概率不回复用户消息
|
||
- 概率计算：好感度绝对值的百分比
|
||
- 例如：好感度为-50，则有50%概率不回复（即50%概率回复）
|
||
|
||
### 4. 好感度调整工具
|
||
- 新增一个AI工具，允许AI根据对话内容自主调整用户的好感度
|
||
- 工具名称：`adjustUserFavorability`
|
||
- 工具参数：
|
||
- `userId`: 用户QQ号
|
||
- `change`: 好感度变化值（可正可负）
|
||
- `reason`: 调整原因（用于溯源）
|
||
- `impression`: 对用户的印象/画像（可选）
|
||
|
||
### 5. 系统开关
|
||
- 在配置文件中添加开关选项，控制是否启用好感度系统
|
||
- 默认启用
|
||
|
||
### 6. 管理员命令
|
||
- 添加插件命令手动修改某个人的好感度
|
||
- 添加命令重置所有好感度
|
||
|
||
## 实现细节
|
||
|
||
### 1. 数据结构
|
||
在`PluginData`中添加：
|
||
```kotlin
|
||
/**
|
||
* 用户好感度数据
|
||
* Key: 用户QQ号
|
||
* Value: 好感度信息
|
||
*/
|
||
val userFavorability by value(mutableMapOf<Long, FavorabilityInfo>())
|
||
|
||
/**
|
||
* 好感度信息数据类
|
||
* @param value 好感度值 (-100 ~ 100)
|
||
* @param reason 调整原因列表，用于溯源
|
||
* @param impression 对用户的印象/画像
|
||
*/
|
||
data class FavorabilityInfo(
|
||
val value: Int = 0,
|
||
val reasons: List<String> = emptyList(),
|
||
val impression: String = ""
|
||
)
|
||
```
|
||
|
||
### 2. 好感度工具
|
||
创建新的工具类`AdjustUserFavorabilityAgent`，继承`BaseAgent`。
|
||
工具描述：`根据用户行为调整其好感度值，范围-100~100`
|
||
|
||
### 3. 消息处理逻辑
|
||
在`JChatGPT.kt`的`onMessage`函数中：
|
||
- 添加好感度系统开关检查
|
||
- 在决定是否回复前，计算回复概率
|
||
- 如果随机数小于不回复概率，则直接返回，不进行后续处理
|
||
|
||
### 4. 时间偏移机制
|
||
设计时间偏移算法，使好感度逐渐向0回归：
|
||
- 偏移公式：`偏移量 = sign(好感度) * (1 - (|好感度| / 100)^2) * 基础偏移速度`
|
||
- 基础偏移速度可设置为每天1-5点
|
||
- 这样确保当好感度接近极端值时，变化速度会显著减慢
|
||
|
||
### 5. 配置选项
|
||
在`PluginConfig.kt`中添加：
|
||
```kotlin
|
||
/**
|
||
* 是否启用好感度系统
|
||
*/
|
||
val enableFavorabilitySystem by value(true)
|
||
|
||
/**
|
||
* 好感度每日基础偏移速度（点/天）
|
||
*/
|
||
val favorabilityBaseShiftSpeed by value(2.0)
|
||
```
|
||
|
||
### 6. 插件命令
|
||
添加以下命令：
|
||
- `/jgpt favorability <qq> <value>`: 设置指定QQ号的好感度值
|
||
- `/jgpt resetFavorability`: 重置所有用户的好感度为0
|
||
|
||
### 7. 提示词设计
|
||
不再使用系统提示词中的占位符，而是将好感度信息直接添加到聊天历史的顶部。
|
||
|
||
### 8. 好感度信息展示
|
||
- 不再使用系统提示词中的占位符
|
||
- 在获取历史消息时，将好感度信息作为摘要添加到聊天历史的顶部
|
||
- 格式示例：
|
||
```
|
||
[好感度摘要]
|
||
用户840465812(筱杰) 好感度: 75
|
||
印象: 热心的开发者，经常提供有用的建议
|
||
调整原因:
|
||
- 2025-09-10 14:30: 提供了关于代码优化的建议 +10
|
||
- 2025-09-09 10:15: 帮助测试新功能 +5
|
||
```
|
||
|
||
## 待确认事项
|
||
|
||
1. 时间偏移的基础速度设定（每天多少点）
|
||
2. 好感度调整工具的具体参数和使用方式 |