nonebot-plugin-dotcharacter

✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI 角色扮演对话 ✨

📖 介绍

与 Claude Code 使用 dot-skill 角色对话完全一致：

1. dot-skill / colleague-skill 从原材料（聊天记录、文档等）蒸馏出角色的 SKILL.md
2. SKILL.md 包含 PART A（工作能力）和 PART B（人物性格）
3. 对话时，系统提示词 = PART B 优先定态度 + PART A 供知识
4. LLM 按照系统提示词生成符合角色风格的回复

本插件做的事情：读取 SKILL.md → 构造系统提示词 → 管理多用户对话历史 → 调用 LLM API → 返回角色回复。

特性

• 🎭 支持 celebrity / colleague / relationship 三类角色
• 🤖 支持 9 个 LLM Provider 预设（DeepSeek / OpenAI / Kimi / Qwen / Zhipu / SiliconFlow / Groq / Ollama / Custom）
• 📂 多目录角色扫描，支持 dot-skill 和 colleague-skill 两种格式
• 🔥 热加载角色，无需重启
• 💬 群聊 @机器人 触发对话，命令无需 @
• 👑 管理员权限控制（命令仅管理员可用）
• 🧠 私聊会话独立，群聊会话按群共享
• 🔄 LLM API 超时自动重试（3次，指数退避）
• ⚡ 连接池优化，避免长时间运行后连接失效

💿 安装

nb plugin install nonebot-plugin-dotcharacter

pip install nonebot-plugin-dotcharacter

pdm add nonebot-plugin-dotcharacter

poetry add nonebot-plugin-dotcharacter

plugins = ["nonebot_plugin_dotcharacter"]

⚙️ 配置

在 nonebot2 项目的 .env 文件中添加下表中的配置

LLM Provider 预设

📂 角色目录结构

DOTCHARACTER_SKILLS_PATH 指向的是 skills 根目录，插件会扫描其下的一级子目录。目录结构必须如下：

skills/                          ← DOTCHARACTER_SKILLS_PATH 指向这里
├── celebrity/                   ← 一级子目录必须是这三类之一
│   └── xiao_xiao_tao_zi_yo/     ← 角色文件夹（文件夹名即 slug）
│       ├── SKILL.md             ← 主技能文件（必须）
│       ├── meta.json            ← 元数据（可选）
│       └── persona.md           ← 人物性格（可选，优先于 SKILL.md 的 PART B）
├── colleague/
│   └── xxx/
└── relationship/
    └── xxx/

注意：角色文件夹必须放在 celebrity/、colleague/ 或 relationship/ 下，直接放在 skills 根目录不会被识别。

⚠️ 重要提示

NoneBot 命令前缀

本插件的命令以 ! 开头（如 !角色列表），请确保你的 .env 中已配置：

COMMAND_START=["!", "/"]

否则 NoneBot 不会识别命令。

群聊会话机制

• 群聊：管理员执行 !角色切换 后，全群共享同一个会话。任何群成员 @机器人 发消息都会进入同一个对话历史。
• 私聊：每个用户与角色的对话历史是独立的。

指令表

🔗 相关项目

• colleague-skill — dot-skill 角色蒸馏工具，支持 celebrity / colleague / relationship 三类角色

📄 许可证

MIT