From 36a47fa5e20ca5a8e7e08f69a7f4f797a8a7ebf9 Mon Sep 17 00:00:00 2001 From: XokoukioX <3282076201@qq.com> Date: Thu, 6 Nov 2025 00:31:17 +0800 Subject: [PATCH 01/12] =?UTF-8?q?WIP::=E7=A7=81=E8=81=8A=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PRIVATE_CHAT_CHANGES.md | 183 ++++++++++++++++ README.md | 46 +++- nonebot_plugin_llmchat/__init__.py | 336 ++++++++++++++++++++++++----- nonebot_plugin_llmchat/config.py | 2 + 4 files changed, 510 insertions(+), 57 deletions(-) create mode 100644 PRIVATE_CHAT_CHANGES.md diff --git a/PRIVATE_CHAT_CHANGES.md b/PRIVATE_CHAT_CHANGES.md new file mode 100644 index 0000000..701ed86 --- /dev/null +++ b/PRIVATE_CHAT_CHANGES.md @@ -0,0 +1,183 @@ +# 私聊功能实现总结 + +## 📝 概览 + +已成功为 nonebot-plugin-llmchat 项目添加了完整的私聊功能支持。用户现在可以在私聊中与机器人进行对话，同时保持群聊功能完全不变。 + +--- + +## 🔧 主要改动 + +### 1. **config.py** - 配置模块 + +#### 新增配置项： +- `LLMCHAT__ENABLE_PRIVATE_CHAT` (bool, 默认值: False) + - 是否启用私聊功能 + +- `LLMCHAT__PRIVATE_CHAT_PRESET` (str, 默认值: "off") + - 私聊默认使用的预设名称 + +### 2. **__init__.py** - 主程序模块 + +#### 新增导入： +```python +from typing import Union +from nonebot.adapters.onebot.v11 import PrivateMessageEvent +``` + +#### 新增数据结构： + +**PrivateChatState 类** +- 用于管理每个用户的私聊状态 +- 结构与 GroupState 类似，但针对单个用户独立管理 +- 包含：preset_name、history、queue、processing 等属性 + +**private_chat_states 字典** +- 类型：`dict[int, PrivateChatState]` +- 按用户ID存储私聊状态 + +#### 修改的函数： + +1. **format_message()** + - 参数改为：`event: Union[GroupMessageEvent, PrivateMessageEvent]` + - 支持两种消息事件类型的格式化 + +2. **is_triggered()** + - 参数改为：`event: Union[GroupMessageEvent, PrivateMessageEvent]` + - 新增私聊事件检测逻辑 + - 私聊消息在启用且预设不为"off"时自动触发 + +3. **get_preset()** + - 新增参数：`is_group: bool = True` + - 支持从群组或私聊状态获取预设配置 + +4. **process_messages()** + - 新增参数：`context_id: int, is_group: bool = True` + - 支持处理群组和私聊消息 + - 私聊时跳过OneBot群操作工具（ob__开头的工具） + +5. **handle_message()** + - 参数改为：`event: Union[GroupMessageEvent, PrivateMessageEvent]` + - 支持路由到不同的处理逻辑 + +6. **save_state()** / **load_state()** + - 新增私聊状态的持久化 + - 私聊状态保存到单独的文件：`llmchat_private_state.json` + +#### 新增命令处理器（私聊相关）： + +所有私聊命令需要主人权限，且仅在启用私聊功能时可用： + +1. **私聊API预设** + - 查看或修改私聊使用的API预设 + - 用法：`私聊API预设 [预设名]` + +2. **私聊修改设定** + - 修改私聊机器人的性格设定 + - 用法：`私聊修改设定 [新设定]` + +3. **私聊记忆清除** + - 清除私聊的对话历史记录 + - 用法：`私聊记忆清除` + +4. **私聊切换思维输出** + - 切换是否输出AI的思维过程 + - 用法：`私聊切换思维输出` + +### 3. **README.md** - 文档更新 + +#### 更新的章节： + +1. **项目介绍** + - 更新标题为"群聊&私聊的AI对话插件" + - 添加"群聊和私聊支持"功能说明 + +2. **配置表格** + - 添加两个新配置项的说明 + +3. **使用指南** + - 将原"指令表"改名为"群聊指令表" + - 新增"私聊指令表" + - 添加"私聊功能启用示例"部分 + +--- + +## 🚀 使用指南 + +### 启用私聊功能 + +在 `.env` 文件中添加： + +```bash +# 启用私聊功能 +LLMCHAT__ENABLE_PRIVATE_CHAT=true + +# 设置私聊默认预设 +LLMCHAT__PRIVATE_CHAT_PRESET="deepseek-v1" +``` + +### 私聊命令示例 + +``` +# 主人私聊机器人 + +私聊API预设 # 查看当前预设 +私聊API预设 aliyun-deepseek-v3 # 切换预设 + +私聊修改设定 你是一个有趣的AI # 修改性格设定 + +私聊记忆清除 # 清除对话记忆 + +私聊切换思维输出 # 开关思维过程输出 +``` + +--- + +## 🔑 关键特性 + +✅ **独立管理** - 群聊和私聊拥有完全独立的对话记忆和配置 + +✅ **灵活控制** - 可单独启用/禁用私聊功能，无需影响群聊 + +✅ **自动触发** - 私聊消息自动触发回复，无需@机器人 + +✅ **权限隔离** - 私聊命令仅主人可用 + +✅ **工具适配** - 私聊时自动跳过不适用的群操作工具 + +✅ **状态持久化** - 私聊状态独立保存和恢复 + +--- + +## 📊 文件对比 + +| 文件 | 变更类型 | 主要改动 | +|------|--------|--------| +| config.py | 修改 | 新增2个配置项 | +| __init__.py | 修改 | 新增私聊类、处理器、命令 | +| README.md | 修改 | 更新文档说明 | + +--- + +## ⚠️ 注意事项 + +1. **默认禁用** - 私聊功能默认为禁用状态，需要在配置文件中显式启用 + +2. **群操作工具** - OneBot群操作工具（禁言、撤回等）在私聊中不可用 + +3. **状态文件** - 私聊状态存储在 `llmchat_private_state.json` 文件中 + +4. **权限限制** - 所有私聊命令都需要主人权限 + +5. **独立预设** - 私聊和群聊可以使用不同的API预设 + +--- + +## ✨ 后续改进建议 + +- [ ] 支持多用户私聊会话管理面板 +- [ ] 添加私聊消息转发到管理员功能 +- [ ] 实现私聊速率限制 +- [ ] 添加私聊用户黑名单 +- [ ] 支持私聊消息加密存储 + diff --git a/README.md b/README.md index 9239110..4e645e1 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ # nonebot-plugin-llmchat -_✨ 支持多API预设、MCP协议、内置工具、联网搜索、视觉模型的AI群聊插件 ✨_ +_✨ 支持多API预设、MCP协议、内置工具、联网搜索、视觉模型、群聊&私聊的AI对话插件 ✨_ @@ -48,6 +48,12 @@ _✨ 支持多API预设、MCP协议、内置工具、联网搜索、视觉模型 - 支持处理回复消息 - 群聊消息顺序处理，防止消息错乱 +1. **群聊和私聊支持** + - 支持群聊场景（默认启用） + - 支持私聊场景（可选启用） + - 分别管理群聊和私聊的对话记忆 + - 灵活的权限配置 + 1. **分群聊上下文记忆管理** - 分群聊保留对话历史记录（可配置保留条数） - 自动合并未处理消息，降低API用量 @@ -120,6 +126,8 @@ _✨ 支持多API预设、MCP协议、内置工具、联网搜索、视觉模型 | LLMCHAT__BLACKLIST_USER_IDS | 否 | [] | 黑名单用户ID列表，机器人将不会处理黑名单用户的消息 | | LLMCHAT__IGNORE_PREFIXES | 否 | [] | 需要忽略的消息前缀列表，匹配到这些前缀的消息不会处理 | | LLMCHAT__MCP_SERVERS | 否 | {} | MCP服务器配置，具体见下表 | +| LLMCHAT__ENABLE_PRIVATE_CHAT | 否 | False | 是否启用私聊功能 | +| LLMCHAT__PRIVATE_CHAT_PRESET | 否 | off | 私聊默认使用的预设名称 | ### 内置OneBot工具 @@ -241,7 +249,7 @@ LLMCHAT__MCP_SERVERS同样为一个dict，key为服务器名称，value配置的 配置完成后@机器人即可手动触发回复，另外在机器人收到群聊消息时会根据`LLMCHAT__RANDOM_TRIGGER_PROB`配置的概率或群聊中使用指令设置的概率随机自动触发回复。 -### 指令表 +### 群聊指令表 以下指令均仅对发送的群聊生效，不同群聊配置不互通。 @@ -253,6 +261,40 @@ LLMCHAT__MCP_SERVERS同样为一个dict，key为服务器名称，value配置的 | 切换思维输出 | 管理 | 否 | 群聊 | 无 | 切换是否输出AI的思维过程的开关（需模型支持） | | 设置主动回复概率 | 管理 | 否 | 群聊 | 主动回复概率 | 主动回复概率需为 [0, 1] 的浮点数，0为完全关闭主动回复 | +### 私聊指令表 + +以下指令仅在启用私聊功能（`LLMCHAT__ENABLE_PRIVATE_CHAT=true`）后可用，这些指令均只对发送者的私聊生效。 + +| 指令 | 权限 | 参数 | 说明 | +|:-----:|:----:|:----:|:----:| +| 私聊API预设 | 主人 | [预设名] | 查看或修改私聊使用的API预设 | +| 私聊修改设定 | 主人 | 设定 | 修改私聊机器人的设定 | +| 私聊记忆清除 | 主人 | 无 | 清除私聊的机器人记忆 | +| 私聊切换思维输出 | 主人 | 无 | 切换是否输出私聊AI的思维过程的开关（需模型支持） | + +**私聊功能说明：** + +- 私聊消息默认触发回复（无需@或随机触发） +- 私聊和群聊的对话记忆独立管理 +- OneBot群操作工具（如禁言、撤回等）在私聊中不可用 + +## 📝 私聊功能启用示例 + +在 `.env` 文件中添加以下配置以启用私聊功能： + +```bash +LLMCHAT__ENABLE_PRIVATE_CHAT=true +LLMCHAT__PRIVATE_CHAT_PRESET="deepseek-v1" +``` + +然后你可以在私聊中与机器人交互。使用以下命令管理私聊： + +- 切换预设：`私聊API预设 aliyun-deepseek-v3` +- 清除记忆：`私聊记忆清除` +- 修改设定：`私聊修改设定 你是一个有趣的AI助手` +| 切换思维输出 | 管理 | 否 | 群聊 | 无 | 切换是否输出AI的思维过程的开关（需模型支持） | +| 设置主动回复概率 | 管理 | 否 | 群聊 | 主动回复概率 | 主动回复概率需为 [0, 1] 的浮点数，0为完全关闭主动回复 | + ### 效果图 ![](img/mcp_demo.jpg) ![](img/demo.png) diff --git a/nonebot_plugin_llmchat/__init__.py b/nonebot_plugin_llmchat/__init__.py index acfa403..caac2a8 100755 --- a/nonebot_plugin_llmchat/__init__.py +++ b/nonebot_plugin_llmchat/__init__.py @@ -8,7 +8,7 @@ import random import re import ssl import time -from typing import TYPE_CHECKING +from typing import TYPE_CHECKING, Union import aiofiles import httpx @@ -21,7 +21,7 @@ from nonebot import ( on_message, require, ) -from nonebot.adapters.onebot.v11 import GroupMessageEvent, Message, MessageSegment +from nonebot.adapters.onebot.v11 import GroupMessageEvent, Message, MessageSegment, PrivateMessageEvent from nonebot.adapters.onebot.v11.permission import GROUP_ADMIN, GROUP_OWNER from nonebot.params import CommandArg from nonebot.permission import SUPERUSER @@ -86,16 +86,36 @@ class GroupState: self.last_active = time.time() self.past_events = deque(maxlen=plugin_config.past_events_size) self.group_prompt: str | None = None + self.user_prompt: str | None = None self.output_reasoning_content = False self.random_trigger_prob = plugin_config.random_trigger_prob +# 初始化私聊状态 +class PrivateChatState: + def __init__(self): + self.preset_name = plugin_config.private_chat_preset + self.history = deque(maxlen=plugin_config.history_size * 2) + self.queue = asyncio.Queue() + self.processing = False + self.last_active = time.time() + self.past_events = deque(maxlen=plugin_config.past_events_size) + self.group_prompt: str | None = None + self.user_prompt: str | None = None + self.output_reasoning_content = False + + group_states: dict[int, GroupState] = defaultdict(GroupState) +private_chat_states: dict[int, PrivateChatState] = defaultdict(PrivateChatState) # 获取当前预设配置 -def get_preset(group_id: int) -> PresetConfig: - state = group_states[group_id] +def get_preset(context_id: int, is_group: bool = True) -> PresetConfig: + if is_group: + state = group_states[context_id] + else: + state = private_chat_states[context_id] + for preset in plugin_config.api_presets: if preset.name == state.preset_name: return preset @@ -103,12 +123,12 @@ def get_preset(group_id: int) -> PresetConfig: # 消息格式转换 -def format_message(event: GroupMessageEvent) -> str: +def format_message(event: Union[GroupMessageEvent, PrivateMessageEvent]) -> str: text_message = "" - if event.reply is not None: + if isinstance(event, GroupMessageEvent) and event.reply is not None: text_message += f"[回复 {event.reply.sender.nickname} 的消息 {event.reply.message.extract_plain_text()}]\n" - if event.is_tome(): + if isinstance(event, GroupMessageEvent) and event.is_tome(): text_message += f"@{next(iter(driver.config.nickname))} " for msgseg in event.get_message(): @@ -123,13 +143,22 @@ def format_message(event: GroupMessageEvent) -> str: elif msgseg.type == "text": text_message += msgseg.data.get("text", "") - message = { - "SenderNickname": str(event.sender.card or event.sender.nickname), - "SenderUserId": str(event.user_id), - "Message": text_message, - "MessageID": event.message_id, - "SendTime": datetime.fromtimestamp(event.time).isoformat(), - } + if isinstance(event, GroupMessageEvent): + message = { + "SenderNickname": str(event.sender.card or event.sender.nickname), + "SenderUserId": str(event.user_id), + "Message": text_message, + "MessageID": event.message_id, + "SendTime": datetime.fromtimestamp(event.time).isoformat(), + } + else: # PrivateMessageEvent + message = { + "SenderNickname": str(event.sender.nickname), + "SenderUserId": str(event.user_id), + "Message": text_message, + "MessageID": event.message_id, + "SendTime": datetime.fromtimestamp(event.time).isoformat(), + } return json.dumps(message, ensure_ascii=False) @@ -157,32 +186,60 @@ def build_reasoning_forward_nodes(self_id: str, reasoning_content: str): return nodes -async def is_triggered(event: GroupMessageEvent) -> bool: +async def is_triggered(event: Union[GroupMessageEvent, PrivateMessageEvent]) -> bool: """扩展后的消息处理规则""" - state = group_states[event.group_id] + if isinstance(event, GroupMessageEvent): + state = group_states[event.group_id] - if state.preset_name == "off": - return False - - # 黑名单用户 - if event.user_id in plugin_config.blacklist_user_ids: - return False - - # 忽略特定前缀的消息 - msg_text = event.get_plaintext().strip() - for prefix in plugin_config.ignore_prefixes: - if msg_text.startswith(prefix): + if state.preset_name == "off": return False - state.past_events.append(event) + # 黑名单用户 + if event.user_id in plugin_config.blacklist_user_ids: + return False - # 原有@触发条件 - if event.is_tome(): - return True + # 忽略特定前缀的消息 + msg_text = event.get_plaintext().strip() + for prefix in plugin_config.ignore_prefixes: + if msg_text.startswith(prefix): + return False - # 随机触发条件 - if random.random() < state.random_trigger_prob: + state.past_events.append(event) + + # 原有@触发条件 + if event.is_tome(): + return True + + # 随机触发条件 + if random.random() < state.random_trigger_prob: + return True + + return False + + elif isinstance(event, PrivateMessageEvent): + # 检查私聊功能是否启用 + if not plugin_config.enable_private_chat: + return False + + state = private_chat_states[event.user_id] + + if state.preset_name == "off": + return False + + # 黑名单用户 + if event.user_id in plugin_config.blacklist_user_ids: + return False + + # 忽略特定前缀的消息 + msg_text = event.get_plaintext().strip() + for prefix in plugin_config.ignore_prefixes: + if msg_text.startswith(prefix): + return False + + state.past_events.append(event) + + # 私聊默认触发 return True return False @@ -197,18 +254,27 @@ handler = on_message( @handler.handle() -async def handle_message(event: GroupMessageEvent): - group_id = event.group_id - logger.debug( - f"收到群聊消息 群号：{group_id} 用户：{event.user_id} 内容：{event.get_plaintext()}" - ) - - state = group_states[group_id] +async def handle_message(event: Union[GroupMessageEvent, PrivateMessageEvent]): + if isinstance(event, GroupMessageEvent): + group_id = event.group_id + logger.debug( + f"收到群聊消息 群号：{group_id} 用户：{event.user_id} 内容：{event.get_plaintext()}" + ) + state = group_states[group_id] + context_id = group_id + else: # PrivateMessageEvent + user_id = event.user_id + logger.debug( + f"收到私聊消息 用户：{user_id} 内容：{event.get_plaintext()}" + ) + state = private_chat_states[user_id] + context_id = user_id await state.queue.put(event) if not state.processing: state.processing = True - task = asyncio.create_task(process_messages(group_id)) + is_group = isinstance(event, GroupMessageEvent) + task = asyncio.create_task(process_messages(context_id, is_group)) task.add_done_callback(tasks.discard) tasks.add(task) @@ -253,9 +319,16 @@ async def send_split_messages(message_handler, content: str): logger.debug(f"发送消息分段 内容：{segment[:50]}...") # 只记录前50个字符避免日志过大 await message_handler.send(Message(segment)) -async def process_messages(group_id: int): - state = group_states[group_id] - preset = get_preset(group_id) +async def process_messages(context_id: int, is_group: bool = True): + if is_group: + group_id = context_id + state = group_states[group_id] + else: + user_id = context_id + state = private_chat_states[user_id] + group_id = None + + preset = get_preset(context_id, is_group) # 初始化OpenAI客户端 if preset.proxy != "": @@ -273,16 +346,21 @@ async def process_messages(group_id: int): ) logger.info( - f"开始处理群聊消息 群号：{group_id} 当前队列长度：{state.queue.qsize()}" + f"开始处理{'群聊' if is_group else '私聊'}消息 {'群号' if is_group else '用户'}：{context_id} 当前队列长度：{state.queue.qsize()}" ) while not state.queue.empty(): event = await state.queue.get() - logger.debug(f"从队列获取消息 群号：{group_id} 消息ID：{event.message_id}") + if is_group: + logger.debug(f"从队列获取消息 群号：{context_id} 消息ID：{event.message_id}") + group_id = context_id + else: + logger.debug(f"从队列获取消息 用户：{context_id} 消息ID：{event.message_id}") + group_id = None past_events_snapshot = [] mcp_client = MCPClient.get_instance(plugin_config.mcp_servers) try: systemPrompt = f""" -我想要你帮我在群聊中闲聊，大家一般叫你{"、".join(list(driver.config.nickname))}，我将会在后面的信息中告诉你每条群聊信息的发送者和发送时间，你可以直接称呼发送者为他对应的昵称。 +我想要你帮我在{"群聊" if is_group else "私聊"}中闲聊，大家一般叫你{"、".join(list(driver.config.nickname))}，我将会在后面的信息中告诉你每条{"群聊" if is_group else "私聊"}信息的发送者和发送时间，你可以直接称呼发送者为他对应的昵称。 你的回复需要遵守以下几点规则： - 你可以使用多条消息回复，每两条消息之间使用分隔，前后不需要包含额外的换行和空格。 - 除外，消息中不应该包含其他类似的标记。 @@ -296,7 +374,7 @@ async def process_messages(group_id: int): - 如果你选择完全不回复，你只需要直接输出一个。 - 如果你需要思考的话，你应该思考尽量少，以节省时间。 下面是关于你性格的设定，如果设定中提到让你扮演某个人，或者设定中有提到名字，则优先使用设定中的名字。 -{state.group_prompt or plugin_config.default_prompt} +{(state.group_prompt if is_group else state.user_prompt) or plugin_config.default_prompt} """ if preset.support_mcp: systemPrompt += "你也可以使用一些工具，下面是关于这些工具的额外说明：\n" @@ -382,12 +460,24 @@ async def process_messages(group_id: int): await handler.send(Message(f"正在使用{mcp_client.get_friendly_name(tool_name)}")) # 执行工具调用，传递群组和机器人信息用于QQ工具 - result = await mcp_client.call_tool( - tool_name, - tool_args, - group_id=event.group_id, - bot_id=str(event.self_id) - ) + if is_group: + result = await mcp_client.call_tool( + tool_name, + tool_args, + group_id=event.group_id, + bot_id=str(event.self_id) + ) + else: + # 私聊时某些工具不可用（如群操作工具），跳过这些工具 + if tool_name.startswith("ob__"): + result = f"私聊不支持{mcp_client.get_friendly_name(tool_name)}工具" + else: + result = await mcp_client.call_tool( + tool_name, + tool_args, + group_id=None, + bot_id=str(event.self_id) + ) new_messages.append({ "role": "tool", @@ -452,7 +542,7 @@ async def process_messages(group_id: int): await handler.send(image_msg) except Exception as e: - logger.opt(exception=e).error(f"API请求失败 群号：{group_id}") + logger.opt(exception=e).error(f"API请求失败 {'群号' if is_group else '用户'}：{context_id}") # 如果在处理过程中出现异常，恢复未处理的消息到state中 state.past_events.extendleft(reversed(past_events_snapshot)) await handler.send(Message(f"服务暂时不可用，请稍后再试\n{e!s}")) @@ -564,12 +654,113 @@ async def handle_think(event: GroupMessageEvent, args: Message = CommandArg()): ) +# region 私聊相关指令 + +# 私聊预设切换命令 +private_preset_handler = on_command( + "私聊API预设", + priority=1, + block=True, + permission=SUPERUSER, +) + + +@private_preset_handler.handle() +async def handle_private_preset(event: PrivateMessageEvent, args: Message = CommandArg()): + if not plugin_config.enable_private_chat: + await private_preset_handler.finish("私聊功能未启用") + + user_id = event.user_id + preset_name = args.extract_plain_text().strip() + + if preset_name == "off": + private_chat_states[user_id].preset_name = preset_name + await private_preset_handler.finish("已关闭llmchat私聊功能") + + available_presets = {p.name for p in plugin_config.api_presets} + if preset_name not in available_presets: + available_presets_str = "\n- ".join(available_presets) + await private_preset_handler.finish( + f"当前API预设：{private_chat_states[user_id].preset_name}\n可用API预设：\n- {available_presets_str}" + ) + + private_chat_states[user_id].preset_name = preset_name + await private_preset_handler.finish(f"已切换至API预设：{preset_name}") + + +# 私聊设定修改命令 +private_edit_preset_handler = on_command( + "私聊修改设定", + priority=1, + block=True, + permission=SUPERUSER, +) + + +@private_edit_preset_handler.handle() +async def handle_private_edit_preset(event: PrivateMessageEvent, args: Message = CommandArg()): + if not plugin_config.enable_private_chat: + await private_edit_preset_handler.finish("私聊功能未启用") + + user_id = event.user_id + user_prompt = args.extract_plain_text().strip() + + private_chat_states[user_id].group_prompt = user_prompt + await private_edit_preset_handler.finish("修改成功") + + +# 私聊记忆清除命令 +private_reset_handler = on_command( + "私聊记忆清除", + priority=1, + block=True, + permission=SUPERUSER, +) + + +@private_reset_handler.handle() +async def handle_private_reset(event: PrivateMessageEvent, args: Message = CommandArg()): + if not plugin_config.enable_private_chat: + await private_reset_handler.finish("私聊功能未启用") + + user_id = event.user_id + + private_chat_states[user_id].past_events.clear() + private_chat_states[user_id].history.clear() + await private_reset_handler.finish("记忆已清空") + + +# 私聊思维输出切换命令 +private_think_handler = on_command( + "私聊切换思维输出", + priority=1, + block=True, + permission=SUPERUSER, +) + + +@private_think_handler.handle() +async def handle_private_think(event: PrivateMessageEvent, args: Message = CommandArg()): + if not plugin_config.enable_private_chat: + await private_think_handler.finish("私聊功能未启用") + + state = private_chat_states[event.user_id] + state.output_reasoning_content = not state.output_reasoning_content + + await private_think_handler.finish( + f"已{(state.output_reasoning_content and '开启') or '关闭'}思维输出" + ) + +# endregion + + # region 持久化与定时任务 # 获取插件数据目录 data_dir = store.get_plugin_data_dir() # 获取插件数据文件 data_file = store.get_plugin_data_file("llmchat_state.json") +private_data_file = store.get_plugin_data_file("llmchat_private_state.json") async def save_state(): @@ -590,6 +781,24 @@ async def save_state(): os.makedirs(os.path.dirname(data_file), exist_ok=True) async with aiofiles.open(data_file, "w", encoding="utf8") as f: await f.write(json.dumps(data, ensure_ascii=False)) + + # 保存私聊状态 + if plugin_config.enable_private_chat: + logger.info(f"开始保存私聊状态到文件：{private_data_file}") + private_data = { + uid: { + "preset": state.preset_name, + "history": list(state.history), + "last_active": state.last_active, + "group_prompt": state.group_prompt, + "output_reasoning_content": state.output_reasoning_content, + } + for uid, state in private_chat_states.items() + } + + os.makedirs(os.path.dirname(private_data_file), exist_ok=True) + async with aiofiles.open(private_data_file, "w", encoding="utf8") as f: + await f.write(json.dumps(private_data, ensure_ascii=False)) async def load_state(): @@ -611,6 +820,23 @@ async def load_state(): state.output_reasoning_content = state_data["output_reasoning_content"] state.random_trigger_prob = state_data.get("random_trigger_prob", plugin_config.random_trigger_prob) group_states[int(gid)] = state + + # 加载私聊状态 + if plugin_config.enable_private_chat: + logger.info(f"从文件加载私聊状态：{private_data_file}") + if os.path.exists(private_data_file): + async with aiofiles.open(private_data_file, encoding="utf8") as f: + private_data = json.loads(await f.read()) + for uid, state_data in private_data.items(): + state = PrivateChatState() + state.preset_name = state_data["preset"] + state.history = deque( + state_data["history"], maxlen=plugin_config.history_size * 2 + ) + state.last_active = state_data["last_active"] + state.group_prompt = state_data["group_prompt"] + state.output_reasoning_content = state_data["output_reasoning_content"] + private_chat_states[int(uid)] = state # 注册生命周期事件 diff --git a/nonebot_plugin_llmchat/config.py b/nonebot_plugin_llmchat/config.py index ed88dd2..6ecebf1 100755 --- a/nonebot_plugin_llmchat/config.py +++ b/nonebot_plugin_llmchat/config.py @@ -49,6 +49,8 @@ class ScopedConfig(BaseModel): default_factory=list, description="需要忽略的消息前缀列表，匹配到这些前缀的消息不会处理" ) + enable_private_chat: bool = Field(False, description="是否启用私聊功能") + private_chat_preset: str = Field("off", description="私聊默认使用的预设名称") class Config(BaseModel): From 2fecb746b3be7186abf9e78aa559c19c8c9600ad Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 11:20:33 +0800 Subject: [PATCH 02/12] =?UTF-8?q?=E8=A7=A6=E5=8F=91=E6=A3=80=E6=9F=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PRIVATE_CHAT_CHANGES.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/PRIVATE_CHAT_CHANGES.md b/PRIVATE_CHAT_CHANGES.md index 701ed86..131ec9d 100644 --- a/PRIVATE_CHAT_CHANGES.md +++ b/PRIVATE_CHAT_CHANGES.md @@ -171,13 +171,4 @@ LLMCHAT__PRIVATE_CHAT_PRESET="deepseek-v1" 5. **独立预设** - 私聊和群聊可以使用不同的API预设 ---- - -## ✨ 后续改进建议 - -- [ ] 支持多用户私聊会话管理面板 -- [ ] 添加私聊消息转发到管理员功能 -- [ ] 实现私聊速率限制 -- [ ] 添加私聊用户黑名单 -- [ ] 支持私聊消息加密存储 From 2c04afc86ae982ae98104a7618858c5f27b3326f Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 11:27:41 +0800 Subject: [PATCH 03/12] =?UTF-8?q?=E5=B0=9D=E8=AF=95=E8=A7=A3=E5=86=B3Ruff?= =?UTF-8?q?=20Lint=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- nonebot_plugin_llmchat/__init__.py | 50 +++++++++++++++++------------- 1 file changed, 29 insertions(+), 21 deletions(-) diff --git a/nonebot_plugin_llmchat/__init__.py b/nonebot_plugin_llmchat/__init__.py index caac2a8..68d97c3 100755 --- a/nonebot_plugin_llmchat/__init__.py +++ b/nonebot_plugin_llmchat/__init__.py @@ -8,7 +8,7 @@ import random import re import ssl import time -from typing import TYPE_CHECKING, Union +from typing import TYPE_CHECKING import aiofiles import httpx @@ -123,7 +123,7 @@ def get_preset(context_id: int, is_group: bool = True) -> PresetConfig: # 消息格式转换 -def format_message(event: Union[GroupMessageEvent, PrivateMessageEvent]) -> str: +def format_message(event: GroupMessageEvent | PrivateMessageEvent) -> str: text_message = "" if isinstance(event, GroupMessageEvent) and event.reply is not None: text_message += f"[回复 {event.reply.sender.nickname} 的消息 {event.reply.message.extract_plain_text()}]\n" @@ -186,7 +186,7 @@ def build_reasoning_forward_nodes(self_id: str, reasoning_content: str): return nodes -async def is_triggered(event: Union[GroupMessageEvent, PrivateMessageEvent]) -> bool: +async def is_triggered(event: GroupMessageEvent | PrivateMessageEvent) -> bool: """扩展后的消息处理规则""" if isinstance(event, GroupMessageEvent): @@ -254,7 +254,7 @@ handler = on_message( @handler.handle() -async def handle_message(event: Union[GroupMessageEvent, PrivateMessageEvent]): +async def handle_message(event: GroupMessageEvent | PrivateMessageEvent): if isinstance(event, GroupMessageEvent): group_id = event.group_id logger.debug( @@ -359,23 +359,31 @@ async def process_messages(context_id: int, is_group: bool = True): past_events_snapshot = [] mcp_client = MCPClient.get_instance(plugin_config.mcp_servers) try: - systemPrompt = f""" -我想要你帮我在{"群聊" if is_group else "私聊"}中闲聊，大家一般叫你{"、".join(list(driver.config.nickname))}，我将会在后面的信息中告诉你每条{"群聊" if is_group else "私聊"}信息的发送者和发送时间，你可以直接称呼发送者为他对应的昵称。 -你的回复需要遵守以下几点规则： -- 你可以使用多条消息回复，每两条消息之间使用分隔，前后不需要包含额外的换行和空格。 -- 除外，消息中不应该包含其他类似的标记。 -- 不要使用markdown或者html，聊天软件不支持解析，换行请用换行符。 -- 你应该以普通人的方式发送消息，每条消息字数要尽量少一些，应该倾向于使用更多条的消息回复。 -- 代码则不需要分段，用单独的一条消息发送。 -- 请使用发送者的昵称称呼发送者，你可以礼貌地问候发送者，但只需要在第一次回答这位发送者的问题时问候他。 -- 你有at群成员的能力，只需要在某条消息中插入[CQ:at,qq=（QQ号）]，也就是CQ码。at发送者是非必要的，你可以根据你自己的想法at某个人。 -- 你有引用某条消息的能力，使用[CQ:reply,id=（消息id）]来引用。 -- 如果有多条消息，你应该优先回复提到你的，一段时间之前的就不要回复了，也可以直接选择不回复。 -- 如果你选择完全不回复，你只需要直接输出一个。 -- 如果你需要思考的话，你应该思考尽量少，以节省时间。 -下面是关于你性格的设定，如果设定中提到让你扮演某个人，或者设定中有提到名字，则优先使用设定中的名字。 -{(state.group_prompt if is_group else state.user_prompt) or plugin_config.default_prompt} -""" + # 构建系统提示，分成多行以满足行长限制 + chat_type = "群聊" if is_group else "私聊" + bot_names = "、".join(list(driver.config.nickname)) + default_prompt = (state.group_prompt if is_group else state.user_prompt) or plugin_config.default_prompt + + system_lines = [ + f"我想要你帮我在{chat_type}中闲聊，大家一般叫你{bot_names}。", + "我将会在后面的信息中告诉你每条信息的发送者和发送时间，你可以直接称呼发送者为他对应的昵称。", + "你的回复需要遵守以下几点规则：", + "- 你可以使用多条消息回复，每两条消息之间使用分隔，前后不需要包含额外的换行和空格。", + "- 除外，消息中不应该包含其他类似的标记。", + "- 不要使用markdown或者html，聊天软件不支持解析，换行请用换行符。", + "- 你应该以普通人的方式发送消息，每条消息字数要尽量少一些，应该倾向于使用更多条的消息回复。", + "- 代码则不需要分段，用单独的一条消息发送。", + "- 请使用发送者的昵称称呼发送者，你可以礼貌地问候发送者，但只需要在第一次回答这位发送者的问题时问候他。", + "- 你有at群成员的能力，只需要在某条消息中插入[CQ:at,qq=（QQ号）]，也就是CQ码。at发送者是非必要的，你可以根据你自己的想法at某个人。", + "- 你有引用某条消息的能力，使用[CQ:reply,id=（消息id）]来引用。", + "- 如果有多条消息，你应该优先回复提到你的，一段时间之前的就不要回复了，也可以直接选择不回复。", + "- 如果你选择完全不回复，你只需要直接输出一个。", + "- 如果你需要思考的话，你应该尽量少思考，以节省时间。", + "下面是关于你性格的设定，如果设定中提到让你扮演某个人，或者设定中有提到名字，则优先使用设定中的名字。", + default_prompt, + ] + + systemPrompt = "\n".join(system_lines) if preset.support_mcp: systemPrompt += "你也可以使用一些工具，下面是关于这些工具的额外说明：\n" for mcp_name, mcp_config in plugin_config.mcp_servers.items(): From 7ea7a26681160704507abe9108455f119d052d3f Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 14:45:25 +0800 Subject: [PATCH 04/12] =?UTF-8?q?=E5=8F=96=E6=B6=88=E8=B7=9F=E8=B8=AA.DS?= =?UTF-8?q?=5FStore?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index dcd5a0a..83ace41 100644 --- a/.gitignore +++ b/.gitignore @@ -174,3 +174,4 @@ pyrightconfig.json !.vscode/launch.json !.vscode/extensions.json !.vscode/*.code-snippets +.DS_Store From a8d3213e485c1481702276bada332ecc33ea27b5 Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 14:52:44 +0800 Subject: [PATCH 05/12] Update Poerty --- poetry.lock | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/poetry.lock b/poetry.lock index 50d98ce..dcadb71 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 2.1.2 and should not be changed by hand. +# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand. [[package]] name = "aiofiles" @@ -662,14 +662,14 @@ typing-extensions = ">=4.0.0,<5.0.0" [[package]] name = "nonebot2" -version = "2.4.1" +version = "2.4.4" description = "An asynchronous python bot framework." optional = false python-versions = "<4.0,>=3.9" groups = ["main"] files = [ - {file = "nonebot2-2.4.1-py3-none-any.whl", hash = "sha256:fec95f075efc89dbe9ce148618b413b02f46ba284200367749b035e794695111"}, - {file = "nonebot2-2.4.1.tar.gz", hash = "sha256:8fea364318501ed79721403a8ecd76587bc884d58c356260f691a8bbda9b05e6"}, + {file = "nonebot2-2.4.4-py3-none-any.whl", hash = "sha256:8885d02906f1def83c138f298a7aa99ca1975351f44d8d290ea0eeec5aec1f0b"}, + {file = "nonebot2-2.4.4.tar.gz", hash = "sha256:b367c17f31ae0d548e374bb80b719ed12885620f29f3cbc305a5a88a6175f4e3"}, ] [package.dependencies] @@ -679,17 +679,17 @@ loguru = ">=0.6.0,<1.0.0" pydantic = ">=1.10.0,<2.5.0 || >2.5.0,<2.5.1 || >2.5.1,<2.10.0 || >2.10.0,<2.10.1 || >2.10.1,<3.0.0" pygtrie = ">=2.4.1,<3.0.0" python-dotenv = ">=0.21.0,<2.0.0" -tomli = {version = ">=2.0.1,<3.0.0", markers = "python_version < \"3.11\""} -typing-extensions = ">=4.4.0,<5.0.0" +tomli = {version = ">=2.0.1,<3.0.0", markers = "python_full_version < \"3.11.0\""} +typing-extensions = ">=4.6.0,<5.0.0" yarl = ">=1.7.2,<2.0.0" [package.extras] aiohttp = ["aiohttp[speedups] (>=3.11.0,<4.0.0)"] -all = ["Quart (>=0.18.0,<1.0.0)", "aiohttp[speedups] (>=3.11.0,<4.0.0)", "fastapi (>=0.93.0,<1.0.0)", "httpx[http2] (>=0.26.0,<1.0.0)", "uvicorn[standard] (>=0.20.0,<1.0.0)", "websockets (>=10.0)"] +all = ["aiohttp[speedups] (>=3.11.0,<4.0.0)", "fastapi (>=0.93.0,<1.0.0)", "httpx[http2] (>=0.26.0,<1.0.0)", "uvicorn[standard] (>=0.20.0,<1.0.0)", "websockets (>=15.0)"] fastapi = ["fastapi (>=0.93.0,<1.0.0)", "uvicorn[standard] (>=0.20.0,<1.0.0)"] httpx = ["httpx[http2] (>=0.26.0,<1.0.0)"] -quart = ["Quart (>=0.18.0,<1.0.0)", "uvicorn[standard] (>=0.20.0,<1.0.0)"] -websockets = ["websockets (>=10.0)"] +quart = ["quart (>=0.18.0,<1.0.0)", "uvicorn[standard] (>=0.20.0,<1.0.0)"] +websockets = ["websockets (>=15.0)"] [[package]] name = "nonemoji" From e293b05fa12cfb102e564ea15b128d3d3a96686e Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 15:11:49 +0800 Subject: [PATCH 06/12] =?UTF-8?q?=E7=A7=81=E8=81=8A=E5=88=9D=E6=AD=A5?= =?UTF-8?q?=E6=B5=8B=E8=AF=95=E9=80=9A=E8=BF=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PRIVATE_CHAT_CHANGES.md | 174 ---------------------------------------- 1 file changed, 174 deletions(-) delete mode 100644 PRIVATE_CHAT_CHANGES.md diff --git a/PRIVATE_CHAT_CHANGES.md b/PRIVATE_CHAT_CHANGES.md deleted file mode 100644 index 131ec9d..0000000 --- a/PRIVATE_CHAT_CHANGES.md +++ /dev/null @@ -1,174 +0,0 @@ -# 私聊功能实现总结 - -## 📝 概览 - -已成功为 nonebot-plugin-llmchat 项目添加了完整的私聊功能支持。用户现在可以在私聊中与机器人进行对话，同时保持群聊功能完全不变。 - ---- - -## 🔧 主要改动 - -### 1. **config.py** - 配置模块 - -#### 新增配置项： -- `LLMCHAT__ENABLE_PRIVATE_CHAT` (bool, 默认值: False) - - 是否启用私聊功能 - -- `LLMCHAT__PRIVATE_CHAT_PRESET` (str, 默认值: "off") - - 私聊默认使用的预设名称 - -### 2. **__init__.py** - 主程序模块 - -#### 新增导入： -```python -from typing import Union -from nonebot.adapters.onebot.v11 import PrivateMessageEvent -``` - -#### 新增数据结构： - -**PrivateChatState 类** -- 用于管理每个用户的私聊状态 -- 结构与 GroupState 类似，但针对单个用户独立管理 -- 包含：preset_name、history、queue、processing 等属性 - -**private_chat_states 字典** -- 类型：`dict[int, PrivateChatState]` -- 按用户ID存储私聊状态 - -#### 修改的函数： - -1. **format_message()** - - 参数改为：`event: Union[GroupMessageEvent, PrivateMessageEvent]` - - 支持两种消息事件类型的格式化 - -2. **is_triggered()** - - 参数改为：`event: Union[GroupMessageEvent, PrivateMessageEvent]` - - 新增私聊事件检测逻辑 - - 私聊消息在启用且预设不为"off"时自动触发 - -3. **get_preset()** - - 新增参数：`is_group: bool = True` - - 支持从群组或私聊状态获取预设配置 - -4. **process_messages()** - - 新增参数：`context_id: int, is_group: bool = True` - - 支持处理群组和私聊消息 - - 私聊时跳过OneBot群操作工具（ob__开头的工具） - -5. **handle_message()** - - 参数改为：`event: Union[GroupMessageEvent, PrivateMessageEvent]` - - 支持路由到不同的处理逻辑 - -6. **save_state()** / **load_state()** - - 新增私聊状态的持久化 - - 私聊状态保存到单独的文件：`llmchat_private_state.json` - -#### 新增命令处理器（私聊相关）： - -所有私聊命令需要主人权限，且仅在启用私聊功能时可用： - -1. **私聊API预设** - - 查看或修改私聊使用的API预设 - - 用法：`私聊API预设 [预设名]` - -2. **私聊修改设定** - - 修改私聊机器人的性格设定 - - 用法：`私聊修改设定 [新设定]` - -3. **私聊记忆清除** - - 清除私聊的对话历史记录 - - 用法：`私聊记忆清除` - -4. **私聊切换思维输出** - - 切换是否输出AI的思维过程 - - 用法：`私聊切换思维输出` - -### 3. **README.md** - 文档更新 - -#### 更新的章节： - -1. **项目介绍** - - 更新标题为"群聊&私聊的AI对话插件" - - 添加"群聊和私聊支持"功能说明 - -2. **配置表格** - - 添加两个新配置项的说明 - -3. **使用指南** - - 将原"指令表"改名为"群聊指令表" - - 新增"私聊指令表" - - 添加"私聊功能启用示例"部分 - ---- - -## 🚀 使用指南 - -### 启用私聊功能 - -在 `.env` 文件中添加： - -```bash -# 启用私聊功能 -LLMCHAT__ENABLE_PRIVATE_CHAT=true - -# 设置私聊默认预设 -LLMCHAT__PRIVATE_CHAT_PRESET="deepseek-v1" -``` - -### 私聊命令示例 - -``` -# 主人私聊机器人 - -私聊API预设 # 查看当前预设 -私聊API预设 aliyun-deepseek-v3 # 切换预设 - -私聊修改设定 你是一个有趣的AI # 修改性格设定 - -私聊记忆清除 # 清除对话记忆 - -私聊切换思维输出 # 开关思维过程输出 -``` - ---- - -## 🔑 关键特性 - -✅ **独立管理** - 群聊和私聊拥有完全独立的对话记忆和配置 - -✅ **灵活控制** - 可单独启用/禁用私聊功能，无需影响群聊 - -✅ **自动触发** - 私聊消息自动触发回复，无需@机器人 - -✅ **权限隔离** - 私聊命令仅主人可用 - -✅ **工具适配** - 私聊时自动跳过不适用的群操作工具 - -✅ **状态持久化** - 私聊状态独立保存和恢复 - ---- - -## 📊 文件对比 - -| 文件 | 变更类型 | 主要改动 | -|------|--------|--------| -| config.py | 修改 | 新增2个配置项 | -| __init__.py | 修改 | 新增私聊类、处理器、命令 | -| README.md | 修改 | 更新文档说明 | - ---- - -## ⚠️ 注意事项 - -1. **默认禁用** - 私聊功能默认为禁用状态，需要在配置文件中显式启用 - -2. **群操作工具** - OneBot群操作工具（禁言、撤回等）在私聊中不可用 - -3. **状态文件** - 私聊状态存储在 `llmchat_private_state.json` 文件中 - -4. **权限限制** - 所有私聊命令都需要主人权限 - -5. **独立预设** - 私聊和群聊可以使用不同的API预设 - - From 3089bb51ae6d8416c34ec226e764a372b076cf14 Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 15:14:44 +0800 Subject: [PATCH 07/12] =?UTF-8?q?=E4=BF=AE=E6=AD=A3ruff=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- nonebot_plugin_llmchat/__init__.py | 36 +++++++++++++++++------------- 1 file changed, 20 insertions(+), 16 deletions(-) diff --git a/nonebot_plugin_llmchat/__init__.py b/nonebot_plugin_llmchat/__init__.py index 68d97c3..a6246f8 100755 --- a/nonebot_plugin_llmchat/__init__.py +++ b/nonebot_plugin_llmchat/__init__.py @@ -115,7 +115,7 @@ def get_preset(context_id: int, is_group: bool = True) -> PresetConfig: state = group_states[context_id] else: state = private_chat_states[context_id] - + for preset in plugin_config.api_presets: if preset.name == state.preset_name: return preset @@ -216,14 +216,14 @@ async def is_triggered(event: GroupMessageEvent | PrivateMessageEvent) -> bool: return True return False - + elif isinstance(event, PrivateMessageEvent): # 检查私聊功能是否启用 if not plugin_config.enable_private_chat: return False - + state = private_chat_states[event.user_id] - + if state.preset_name == "off": return False @@ -238,7 +238,7 @@ async def is_triggered(event: GroupMessageEvent | PrivateMessageEvent) -> bool: return False state.past_events.append(event) - + # 私聊默认触发 return True @@ -327,7 +327,7 @@ async def process_messages(context_id: int, is_group: bool = True): user_id = context_id state = private_chat_states[user_id] group_id = None - + preset = get_preset(context_id, is_group) # 初始化OpenAI客户端 @@ -345,8 +345,10 @@ async def process_messages(context_id: int, is_group: bool = True): timeout=plugin_config.request_timeout, ) + chat_type = "群聊" if is_group else "私聊" + context_type = "群号" if is_group else "用户" logger.info( - f"开始处理{'群聊' if is_group else '私聊'}消息 {'群号' if is_group else '用户'}：{context_id} 当前队列长度：{state.queue.qsize()}" + f"开始处理{chat_type}消息 {context_type}：{context_id} 当前队列长度：{state.queue.qsize()}" ) while not state.queue.empty(): event = await state.queue.get() @@ -373,8 +375,10 @@ async def process_messages(context_id: int, is_group: bool = True): "- 不要使用markdown或者html，聊天软件不支持解析，换行请用换行符。", "- 你应该以普通人的方式发送消息，每条消息字数要尽量少一些，应该倾向于使用更多条的消息回复。", "- 代码则不需要分段，用单独的一条消息发送。", - "- 请使用发送者的昵称称呼发送者，你可以礼貌地问候发送者，但只需要在第一次回答这位发送者的问题时问候他。", - "- 你有at群成员的能力，只需要在某条消息中插入[CQ:at,qq=（QQ号）]，也就是CQ码。at发送者是非必要的，你可以根据你自己的想法at某个人。", + "- 请使用发送者的昵称称呼发送者，你可以礼貌地问候发送者，但只需要在" + "第一次回答这位发送者的问题时问候他。", + "- 你有at群成员的能力，只需要在某条消息中插入[CQ:at,qq=（QQ号）]，" + "也就是CQ码。at发送者是非必要的，你可以根据你自己的想法at某个人。", "- 你有引用某条消息的能力，使用[CQ:reply,id=（消息id）]来引用。", "- 如果有多条消息，你应该优先回复提到你的，一段时间之前的就不要回复了，也可以直接选择不回复。", "- 如果你选择完全不回复，你只需要直接输出一个。", @@ -677,7 +681,7 @@ private_preset_handler = on_command( async def handle_private_preset(event: PrivateMessageEvent, args: Message = CommandArg()): if not plugin_config.enable_private_chat: await private_preset_handler.finish("私聊功能未启用") - + user_id = event.user_id preset_name = args.extract_plain_text().strip() @@ -709,7 +713,7 @@ private_edit_preset_handler = on_command( async def handle_private_edit_preset(event: PrivateMessageEvent, args: Message = CommandArg()): if not plugin_config.enable_private_chat: await private_edit_preset_handler.finish("私聊功能未启用") - + user_id = event.user_id user_prompt = args.extract_plain_text().strip() @@ -730,7 +734,7 @@ private_reset_handler = on_command( async def handle_private_reset(event: PrivateMessageEvent, args: Message = CommandArg()): if not plugin_config.enable_private_chat: await private_reset_handler.finish("私聊功能未启用") - + user_id = event.user_id private_chat_states[user_id].past_events.clear() @@ -751,7 +755,7 @@ private_think_handler = on_command( async def handle_private_think(event: PrivateMessageEvent, args: Message = CommandArg()): if not plugin_config.enable_private_chat: await private_think_handler.finish("私聊功能未启用") - + state = private_chat_states[event.user_id] state.output_reasoning_content = not state.output_reasoning_content @@ -789,7 +793,7 @@ async def save_state(): os.makedirs(os.path.dirname(data_file), exist_ok=True) async with aiofiles.open(data_file, "w", encoding="utf8") as f: await f.write(json.dumps(data, ensure_ascii=False)) - + # 保存私聊状态 if plugin_config.enable_private_chat: logger.info(f"开始保存私聊状态到文件：{private_data_file}") @@ -803,7 +807,7 @@ async def save_state(): } for uid, state in private_chat_states.items() } - + os.makedirs(os.path.dirname(private_data_file), exist_ok=True) async with aiofiles.open(private_data_file, "w", encoding="utf8") as f: await f.write(json.dumps(private_data, ensure_ascii=False)) @@ -828,7 +832,7 @@ async def load_state(): state.output_reasoning_content = state_data["output_reasoning_content"] state.random_trigger_prob = state_data.get("random_trigger_prob", plugin_config.random_trigger_prob) group_states[int(gid)] = state - + # 加载私聊状态 if plugin_config.enable_private_chat: logger.info(f"从文件加载私聊状态：{private_data_file}") From 53f3f185e73c00e998690abe9f035705f1fab9ef Mon Sep 17 00:00:00 2001 From: KawakazeNotFound Date: Thu, 6 Nov 2025 16:33:41 +0800 Subject: [PATCH 08/12] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=9C=A8=E9=95=BF?= =?UTF-8?q?=E6=96=87=E6=9C=AC=E4=B8=8B=E5=AE=B9=E6=98=93=E8=A7=A6=E5=8F=91?= =?UTF-8?q?tool=5Fcall=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- nonebot_plugin_llmchat/__init__.py | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/nonebot_plugin_llmchat/__init__.py b/nonebot_plugin_llmchat/__init__.py index a6246f8..947c3b3 100755 --- a/nonebot_plugin_llmchat/__init__.py +++ b/nonebot_plugin_llmchat/__init__.py @@ -453,7 +453,7 @@ async def process_messages(context_id: int, is_group: bool = True): message = response.choices[0].message # 处理响应并处理工具调用 - while preset.support_mcp and message.tool_calls: + while preset.support_mcp and message and message.tool_calls: new_messages.append({ "role": "assistant", "tool_calls": [tool_call.model_dump() for tool_call in message.tool_calls] @@ -505,11 +505,17 @@ async def process_messages(context_id: int, is_group: bool = True): message = response.choices[0].message + # 安全检查：确保 message 不为 None + if not message: + logger.error("API 响应中的 message 为 None") + await handler.send(Message("服务暂时不可用，请稍后再试")) + return + reply, matched_reasoning_content = pop_reasoning_content( - response.choices[0].message.content + message.content ) reasoning_content: str | None = ( - getattr(response.choices[0].message, "reasoning_content", None) + getattr(message, "reasoning_content", None) or matched_reasoning_content ) @@ -518,7 +524,7 @@ async def process_messages(context_id: int, is_group: bool = True): "content": reply, } - reply_images = getattr(response.choices[0].message, "images", None) + reply_images = getattr(message, "images", None) if reply_images: # openai的sdk里的assistant消息暂时没有images字段，需要单独处理 From 1f41ed084ebf19d7ca7bedf7b0107ca53f05262d Mon Sep 17 00:00:00 2001 From: FuQuan <87348379+FuQuan233@users.noreply.github.com> Date: Fri, 7 Nov 2025 11:56:34 +0800 Subject: [PATCH 09/12] =?UTF-8?q?=E2=9C=A8=20=E5=90=88=E5=B9=B6=E7=A7=81?= =?UTF-8?q?=E8=81=8A=E6=8C=87=E4=BB=A4=EF=BC=8C=E6=9B=B4=E6=96=B0=E7=9B=B8?= =?UTF-8?q?=E5=85=B3=E6=9D=83=E9=99=90=E5=92=8C=E7=8A=B6=E6=80=81=E7=AE=A1?= =?UTF-8?q?=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- nonebot_plugin_llmchat/__init__.py | 225 ++++++++++------------------- 1 file changed, 75 insertions(+), 150 deletions(-) diff --git a/nonebot_plugin_llmchat/__init__.py b/nonebot_plugin_llmchat/__init__.py index 947c3b3..32dbd5e 100755 --- a/nonebot_plugin_llmchat/__init__.py +++ b/nonebot_plugin_llmchat/__init__.py @@ -22,7 +22,7 @@ from nonebot import ( require, ) from nonebot.adapters.onebot.v11 import GroupMessageEvent, Message, MessageSegment, PrivateMessageEvent -from nonebot.adapters.onebot.v11.permission import GROUP_ADMIN, GROUP_OWNER +from nonebot.adapters.onebot.v11.permission import GROUP_ADMIN, GROUP_OWNER, PRIVATE from nonebot.params import CommandArg from nonebot.permission import SUPERUSER from nonebot.plugin import PluginMetadata @@ -377,12 +377,19 @@ async def process_messages(context_id: int, is_group: bool = True): "- 代码则不需要分段，用单独的一条消息发送。", "- 请使用发送者的昵称称呼发送者，你可以礼貌地问候发送者，但只需要在" "第一次回答这位发送者的问题时问候他。", - "- 你有at群成员的能力，只需要在某条消息中插入[CQ:at,qq=（QQ号）]，" - "也就是CQ码。at发送者是非必要的，你可以根据你自己的想法at某个人。", "- 你有引用某条消息的能力，使用[CQ:reply,id=（消息id）]来引用。", "- 如果有多条消息，你应该优先回复提到你的，一段时间之前的就不要回复了，也可以直接选择不回复。", "- 如果你选择完全不回复，你只需要直接输出一个。", "- 如果你需要思考的话，你应该尽量少思考，以节省时间。", + ] + + if is_group: + system_lines += [ + "- 你有at群成员的能力，只需要在某条消息中插入[CQ:at,qq=（QQ号）]，" + "也就是CQ码。at发送者是非必要的，你可以根据你自己的想法at某个人。", + ] + + system_lines += [ "下面是关于你性格的设定，如果设定中提到让你扮演某个人，或者设定中有提到名字，则优先使用设定中的名字。", default_prompt, ] @@ -439,7 +446,7 @@ async def process_messages(context_id: int, is_group: bool = True): } if preset.support_mcp: - available_tools = await mcp_client.get_available_tools() + available_tools = await mcp_client.get_available_tools(is_group) client_config["tools"] = available_tools response = await client.chat.completions.create( @@ -471,25 +478,12 @@ async def process_messages(context_id: int, is_group: bool = True): # 发送工具调用提示 await handler.send(Message(f"正在使用{mcp_client.get_friendly_name(tool_name)}")) - # 执行工具调用，传递群组和机器人信息用于QQ工具 - if is_group: - result = await mcp_client.call_tool( - tool_name, - tool_args, - group_id=event.group_id, - bot_id=str(event.self_id) - ) - else: - # 私聊时某些工具不可用（如群操作工具），跳过这些工具 - if tool_name.startswith("ob__"): - result = f"私聊不支持{mcp_client.get_friendly_name(tool_name)}工具" - else: - result = await mcp_client.call_tool( - tool_name, - tool_args, - group_id=None, - bot_id=str(event.self_id) - ) + result = await mcp_client.call_tool( + tool_name, + tool_args, + group_id=event.group_id, + bot_id=str(event.self_id) + ) new_messages.append({ "role": "tool", @@ -576,22 +570,33 @@ preset_handler = on_command("API预设", priority=1, block=True, permission=SUPE @preset_handler.handle() -async def handle_preset(event: GroupMessageEvent, args: Message = CommandArg()): - group_id = event.group_id +async def handle_preset(event: GroupMessageEvent | PrivateMessageEvent, args: Message = CommandArg()): + if isinstance(event, GroupMessageEvent): + context_id = event.group_id + state = group_states[context_id] + else: # PrivateMessageEvent + if not plugin_config.enable_private_chat: + return + context_id = event.user_id + state = private_chat_states[context_id] + preset_name = args.extract_plain_text().strip() if preset_name == "off": - group_states[group_id].preset_name = preset_name - await preset_handler.finish("已关闭llmchat") + state.preset_name = preset_name + if isinstance(event, GroupMessageEvent): + await preset_handler.finish("已关闭llmchat群聊功能") + else: + await preset_handler.finish("已关闭llmchat私聊功能") available_presets = {p.name for p in plugin_config.api_presets} if preset_name not in available_presets: available_presets_str = "\n- ".join(available_presets) await preset_handler.finish( - f"当前API预设：{group_states[group_id].preset_name}\n可用API预设：\n- {available_presets_str}" + f"当前API预设：{state.preset_name}\n可用API预设：\n- {available_presets_str}" ) - group_states[group_id].preset_name = preset_name + state.preset_name = preset_name await preset_handler.finish(f"已切换至API预设：{preset_name}") @@ -599,16 +604,23 @@ edit_preset_handler = on_command( "修改设定", priority=1, block=True, - permission=(SUPERUSER | GROUP_ADMIN | GROUP_OWNER), + permission=(SUPERUSER | GROUP_ADMIN | GROUP_OWNER | PRIVATE), ) @edit_preset_handler.handle() -async def handle_edit_preset(event: GroupMessageEvent, args: Message = CommandArg()): - group_id = event.group_id - group_prompt = args.extract_plain_text().strip() +async def handle_edit_preset(event: GroupMessageEvent | PrivateMessageEvent, args: Message = CommandArg()): + if isinstance(event, GroupMessageEvent): + context_id = event.group_id + state = group_states[context_id] + else: # PrivateMessageEvent + if not plugin_config.enable_private_chat: + return + context_id = event.user_id + state = private_chat_states[context_id] - group_states[group_id].group_prompt = group_prompt + group_prompt = args.extract_plain_text().strip() + state.group_prompt = group_prompt await edit_preset_handler.finish("修改成功") @@ -616,16 +628,23 @@ reset_handler = on_command( "记忆清除", priority=1, block=True, - permission=(SUPERUSER | GROUP_ADMIN | GROUP_OWNER), + permission=(SUPERUSER | GROUP_ADMIN | GROUP_OWNER | PRIVATE), ) @reset_handler.handle() -async def handle_reset(event: GroupMessageEvent, args: Message = CommandArg()): - group_id = event.group_id +async def handle_reset(event: GroupMessageEvent | PrivateMessageEvent, args: Message = CommandArg()): + if isinstance(event, GroupMessageEvent): + context_id = event.group_id + state = group_states[context_id] + else: # PrivateMessageEvent + if not plugin_config.enable_private_chat: + return + context_id = event.user_id + state = private_chat_states[context_id] - group_states[group_id].past_events.clear() - group_states[group_id].history.clear() + state.past_events.clear() + state.history.clear() await reset_handler.finish("记忆已清空") @@ -639,32 +658,38 @@ set_prob_handler = on_command( @set_prob_handler.handle() async def handle_set_prob(event: GroupMessageEvent, args: Message = CommandArg()): - group_id = event.group_id - prob = 0 + context_id = event.group_id + state = group_states[context_id] try: prob = float(args.extract_plain_text().strip()) if prob < 0 or prob > 1: - raise ValueError - except Exception as e: - await reset_handler.finish(f"输入有误，请使用 [0,1] 的浮点数\n{e!s}") + raise ValueError("概率值必须在0-1之间") + except ValueError as e: + await set_prob_handler.finish(f"输入有误，请使用 [0,1] 的浮点数\n{e!s}") - group_states[group_id].random_trigger_prob = prob - await reset_handler.finish(f"主动回复概率已设为 {prob}") + state.random_trigger_prob = prob + await set_prob_handler.finish(f"主动回复概率已设为 {prob}") -# 预设切换命令 +# 思维输出切换命令 think_handler = on_command( "切换思维输出", priority=1, block=True, - permission=(SUPERUSER | GROUP_ADMIN | GROUP_OWNER), + permission=(SUPERUSER | GROUP_ADMIN | GROUP_OWNER | PRIVATE), ) @think_handler.handle() -async def handle_think(event: GroupMessageEvent, args: Message = CommandArg()): - state = group_states[event.group_id] +async def handle_think(event: GroupMessageEvent | PrivateMessageEvent, args: Message = CommandArg()): + if isinstance(event, GroupMessageEvent): + state = group_states[event.group_id] + else: # PrivateMessageEvent + if not plugin_config.enable_private_chat: + return + state = private_chat_states[event.user_id] + state.output_reasoning_content = not state.output_reasoning_content await think_handler.finish( @@ -672,106 +697,6 @@ async def handle_think(event: GroupMessageEvent, args: Message = CommandArg()): ) -# region 私聊相关指令 - -# 私聊预设切换命令 -private_preset_handler = on_command( - "私聊API预设", - priority=1, - block=True, - permission=SUPERUSER, -) - - -@private_preset_handler.handle() -async def handle_private_preset(event: PrivateMessageEvent, args: Message = CommandArg()): - if not plugin_config.enable_private_chat: - await private_preset_handler.finish("私聊功能未启用") - - user_id = event.user_id - preset_name = args.extract_plain_text().strip() - - if preset_name == "off": - private_chat_states[user_id].preset_name = preset_name - await private_preset_handler.finish("已关闭llmchat私聊功能") - - available_presets = {p.name for p in plugin_config.api_presets} - if preset_name not in available_presets: - available_presets_str = "\n- ".join(available_presets) - await private_preset_handler.finish( - f"当前API预设：{private_chat_states[user_id].preset_name}\n可用API预设：\n- {available_presets_str}" - ) - - private_chat_states[user_id].preset_name = preset_name - await private_preset_handler.finish(f"已切换至API预设：{preset_name}") - - -# 私聊设定修改命令 -private_edit_preset_handler = on_command( - "私聊修改设定", - priority=1, - block=True, - permission=SUPERUSER, -) - - -@private_edit_preset_handler.handle() -async def handle_private_edit_preset(event: PrivateMessageEvent, args: Message = CommandArg()): - if not plugin_config.enable_private_chat: - await private_edit_preset_handler.finish("私聊功能未启用") - - user_id = event.user_id - user_prompt = args.extract_plain_text().strip() - - private_chat_states[user_id].group_prompt = user_prompt - await private_edit_preset_handler.finish("修改成功") - - -# 私聊记忆清除命令 -private_reset_handler = on_command( - "私聊记忆清除", - priority=1, - block=True, - permission=SUPERUSER, -) - - -@private_reset_handler.handle() -async def handle_private_reset(event: PrivateMessageEvent, args: Message = CommandArg()): - if not plugin_config.enable_private_chat: - await private_reset_handler.finish("私聊功能未启用") - - user_id = event.user_id - - private_chat_states[user_id].past_events.clear() - private_chat_states[user_id].history.clear() - await private_reset_handler.finish("记忆已清空") - - -# 私聊思维输出切换命令 -private_think_handler = on_command( - "私聊切换思维输出", - priority=1, - block=True, - permission=SUPERUSER, -) - - -@private_think_handler.handle() -async def handle_private_think(event: PrivateMessageEvent, args: Message = CommandArg()): - if not plugin_config.enable_private_chat: - await private_think_handler.finish("私聊功能未启用") - - state = private_chat_states[event.user_id] - state.output_reasoning_content = not state.output_reasoning_content - - await private_think_handler.finish( - f"已{(state.output_reasoning_content and '开启') or '关闭'}思维输出" - ) - -# endregion - - # region 持久化与定时任务 # 获取插件数据目录 From e542deabdb71a86431dc1a9cc43344c9545a1ed7 Mon Sep 17 00:00:00 2001 From: FuQuan <87348379+FuQuan233@users.noreply.github.com> Date: Fri, 7 Nov 2025 11:58:16 +0800 Subject: [PATCH 10/12] =?UTF-8?q?=E2=9C=A8=20=E5=90=88=E5=B9=B6=E7=A7=81?= =?UTF-8?q?=E8=81=8A=E6=8C=87=E4=BB=A4=EF=BC=8C=E6=9B=B4=E6=96=B0=E7=9B=B8?= =?UTF-8?q?=E5=85=B3=E6=9D=83=E9=99=90=E5=92=8C=E7=8A=B6=E6=80=81=E7=AE=A1?= =?UTF-8?q?=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- nonebot_plugin_llmchat/mcpclient.py | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/nonebot_plugin_llmchat/mcpclient.py b/nonebot_plugin_llmchat/mcpclient.py index 4d38f0a..9a53865 100644 --- a/nonebot_plugin_llmchat/mcpclient.py +++ b/nonebot_plugin_llmchat/mcpclient.py @@ -106,7 +106,7 @@ class MCPClient: return SessionContext() - async def get_available_tools(self): + async def get_available_tools(self, is_group: bool): """获取可用工具列表，使用缓存机制""" if self._tools_cache is not None: logger.debug("返回缓存的工具列表") @@ -115,10 +115,11 @@ class MCPClient: logger.info(f"初始化工具列表缓存，需要连接{len(self.server_config)}个服务器") available_tools = [] - # 添加OneBot内置工具 - onebot_tools = self.onebot_tools.get_available_tools() - available_tools.extend(onebot_tools) - logger.debug(f"添加了{len(onebot_tools)}个OneBot内置工具") + if is_group: + # 添加OneBot内置工具，仅在群聊中可用 + onebot_tools = self.onebot_tools.get_available_tools() + available_tools.extend(onebot_tools) + logger.debug(f"添加了{len(onebot_tools)}个OneBot内置工具") # 添加MCP服务器工具 for server_name in self.server_config.keys(): From fe39e2aba4568ec7cc607588cfca5df45c19dcb0 Mon Sep 17 00:00:00 2001 From: FuQuan <87348379+FuQuan233@users.noreply.github.com> Date: Fri, 7 Nov 2025 12:13:53 +0800 Subject: [PATCH 11/12] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20fix=20lint=20problem?= =?UTF-8?q?s?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- nonebot_plugin_llmchat/__init__.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nonebot_plugin_llmchat/__init__.py b/nonebot_plugin_llmchat/__init__.py index 32dbd5e..a311dc0 100755 --- a/nonebot_plugin_llmchat/__init__.py +++ b/nonebot_plugin_llmchat/__init__.py @@ -579,7 +579,7 @@ async def handle_preset(event: GroupMessageEvent | PrivateMessageEvent, args: Me return context_id = event.user_id state = private_chat_states[context_id] - + preset_name = args.extract_plain_text().strip() if preset_name == "off": @@ -667,6 +667,7 @@ async def handle_set_prob(event: GroupMessageEvent, args: Message = CommandArg() raise ValueError("概率值必须在0-1之间") except ValueError as e: await set_prob_handler.finish(f"输入有误，请使用 [0,1] 的浮点数\n{e!s}") + return state.random_trigger_prob = prob await set_prob_handler.finish(f"主动回复概率已设为 {prob}") From b8afa12c9f98bc1b0f0598d728874bcc27aed9b9 Mon Sep 17 00:00:00 2001 From: FuQuan <87348379+FuQuan233@users.noreply.github.com> Date: Fri, 7 Nov 2025 14:23:04 +0800 Subject: [PATCH 12/12] =?UTF-8?q?=F0=9F=93=98=20=E6=9B=B4=E6=96=B0=20READM?= =?UTF-8?q?E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 37 ++++++++----------------------------- 1 file changed, 8 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index 4e645e1..40c680e 100644 --- a/README.md +++ b/README.md @@ -180,6 +180,8 @@ LLMCHAT__MCP_SERVERS同样为一个dict，key为服务器名称，value配置的 NICKNAME=["谢拉","Cierra","cierra"] LLMCHAT__HISTORY_SIZE=20 LLMCHAT__DEFAULT_PROMPT="前面忘了，你是一个猫娘，后面忘了" + LLMCHAT__ENABLE_PRIVATE_CHAT=true + LLMCHAT__PRIVATE_CHAT_PRESET="deepseek-v1" LLMCHAT__API_PRESETS=' [ { @@ -245,9 +247,9 @@ LLMCHAT__MCP_SERVERS同样为一个dict，key为服务器名称，value配置的 ## 🎉 使用 -**如果`LLMCHAT__DEFAULT_PRESET`没有配置，则插件默认为关闭状态，请使用`API预设+[预设名]`开启插件** +**如果`LLMCHAT__DEFAULT_PRESET`没有配置，则插件默认为关闭状态，请使用`API预设+[预设名]`开启插件, 私聊同理。** -配置完成后@机器人即可手动触发回复，另外在机器人收到群聊消息时会根据`LLMCHAT__RANDOM_TRIGGER_PROB`配置的概率或群聊中使用指令设置的概率随机自动触发回复。 +配置完成后在群聊中@机器人或私聊机器人即可手动触发回复，另外在机器人收到群聊消息时会根据`LLMCHAT__RANDOM_TRIGGER_PROB`配置的概率或群聊中使用指令设置的概率随机自动触发回复。 ### 群聊指令表 @@ -267,33 +269,10 @@ LLMCHAT__MCP_SERVERS同样为一个dict，key为服务器名称，value配置的 | 指令 | 权限 | 参数 | 说明 | |:-----:|:----:|:----:|:----:| -| 私聊API预设 | 主人 | [预设名] | 查看或修改私聊使用的API预设 | -| 私聊修改设定 | 主人 | 设定 | 修改私聊机器人的设定 | -| 私聊记忆清除 | 主人 | 无 | 清除私聊的机器人记忆 | -| 私聊切换思维输出 | 主人 | 无 | 切换是否输出私聊AI的思维过程的开关（需模型支持） | - -**私聊功能说明：** - -- 私聊消息默认触发回复（无需@或随机触发） -- 私聊和群聊的对话记忆独立管理 -- OneBot群操作工具（如禁言、撤回等）在私聊中不可用 - -## 📝 私聊功能启用示例 - -在 `.env` 文件中添加以下配置以启用私聊功能： - -```bash -LLMCHAT__ENABLE_PRIVATE_CHAT=true -LLMCHAT__PRIVATE_CHAT_PRESET="deepseek-v1" -``` - -然后你可以在私聊中与机器人交互。使用以下命令管理私聊： - -- 切换预设：`私聊API预设 aliyun-deepseek-v3` -- 清除记忆：`私聊记忆清除` -- 修改设定：`私聊修改设定 你是一个有趣的AI助手` -| 切换思维输出 | 管理 | 否 | 群聊 | 无 | 切换是否输出AI的思维过程的开关（需模型支持） | -| 设置主动回复概率 | 管理 | 否 | 群聊 | 主动回复概率 | 主动回复概率需为 [0, 1] 的浮点数，0为完全关闭主动回复 | +| API预设 | 主人 | [预设名] | 查看或修改私聊使用的API预设 | +| 修改设定 | 所有人 | 设定 | 修改私聊机器人的设定 | +| 记忆清除 | 所有人 | 无 | 清除私聊的机器人记忆 | +| 切换思维输出 | 所有人 | 无 | 切换是否输出私聊AI的思维过程的开关（需模型支持） | ### 效果图 ![](img/mcp_demo.jpg)