Add token consumption tracking system Update version to v1.10.0

FavorabilitySystem.md

@@ -0,0 +1,123 @@
+# 好感度系统功能规范
+
+## 功能概述
+为机器人添加一个可开关的好感度系统，通过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. 好感度调整工具的具体参数和使用方式