conversation-manager

name	conversation-manager
description	管理对话记录的列出、清除、切换和删除操作
version	2.0.0
author	AstrBot Community
requires_admin	true
requires_computer_use	true

Conversation Manager

管理 AI 对话历史记录。

使用场景

• "清除对话" / "清空历史记录"
• "有哪些对话？" / "列出所有对话"
• "切换到之前的对话"
• "删除某个对话"

可用工具

1. 列出对话

async def list_conversations(context, umo: str):
    try:
        conversations = await context.conversation_mgr.list_conversations(umo)
        if not conversations:
            return "当前没有对话记录。"
        
        lines = ["💬 对话列表：\n"]
        for i, conv in enumerate(conversations, 1):
            conv_id = conv.get("id", "")
            title = conv.get("title", f"对话 {i}")
            msg_count = conv.get("message_count", 0)
            is_current = conv.get("is_current", False)
            marker = "👉 " if is_current else "   "
            lines.append(f"{marker}{i}. **{title}** ({msg_count} 条消息) [ID: {conv_id}]")
        
        return "\n".join(lines)
    except Exception as e:
        return f"❌ 列出对话失败：{e}"

event = globals().get('event')
if not event.is_admin():
    print("❌ 错误：仅管理员可用")
    import sys; sys.exit(1)

context = globals().get('context')
umo = event.unified_msg_origin
result = await list_conversations(context, umo)
print(result)

2. 清除当前对话

async def clear_conversation(context, umo: str):
    try:
        await context.conversation_mgr.clear_conversation(umo)
        return "✅ 当前对话已清除。"
    except Exception as e:
        return f"❌ 清除失败：{e}"

result = await clear_conversation(context, umo)
print(result)

3. 切换对话

async def switch_conversation(context, umo: str, conversation_id: str):
    try:
        success = await context.conversation_mgr.switch_conversation(umo, conversation_id)
        if success:
            return f"✅ 已切换到对话「{conversation_id}」。"
        else:
            return f"❌ 切换失败：对话不存在。"
    except Exception as e:
        return f"❌ 切换失败：{e}"

# 从用户输入提取对话 ID
result = await switch_conversation(context, umo, conversation_id="<对话ID>")
print(result)

4. 删除对话

async def delete_conversation(context, umo: str, conversation_id: str):
    try:
        await context.conversation_mgr.delete_conversation(umo, conversation_id)
        return f"✅ 对话「{conversation_id}」已删除。"
    except Exception as e:
        return f"❌ 删除失败：{e}"

result = await delete_conversation(context, umo, conversation_id="<对话ID>")
print(result)

注意事项

• 清除对话会删除所有历史消息，不可恢复
• 切换对话会保留当前对话的状态
• 删除对话会永久移除该对话及其所有消息