nonebot-plugin-dotcharacter 2.0.2__tar.gz → 2.0.3__tar.gz

{nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-dotcharacter
-Version: 2.0.2
+Version: 2.0.3
 Summary: NoneBot 插件：加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI 角色扮演对话
 Author: tghrt
 License: MIT
@@ -64,7 +64,7 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI
 - 🔥 热加载角色，无需重启
 - 💬 群聊 @机器人 触发对话，命令无需 @
 - 👑 管理员权限控制（命令仅管理员可用）
-- 🧠 多用户会话隔离
+- 🧠 私聊会话独立，群聊会话按群共享
 
 ## 💿 安装
 
@@ -134,7 +134,41 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI
 | ollama | llama3 | http://localhost:11434/v1 |
 | custom | gpt-4o-mini | 自定义 |
 
-## 🎉 使用
+## 📂 角色目录结构
+
+`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` 中已配置：
+
+```env
+COMMAND_START=["!", "/"]
+```
+
+否则 NoneBot 不会识别命令。
+
+### 群聊会话机制
+
+- **群聊**：管理员执行 `!角色切换` 后，**全群共享同一个会话**。任何群成员 @机器人 发消息都会进入同一个对话历史。
+- **私聊**：每个用户与角色的对话历史是独立的。
 
 ### 指令表
 

{nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.3}/README.md

@@ -39,7 +39,7 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI
 - 🔥 热加载角色，无需重启
 - 💬 群聊 @机器人 触发对话，命令无需 @
 - 👑 管理员权限控制（命令仅管理员可用）
-- 🧠 多用户会话隔离
+- 🧠 私聊会话独立，群聊会话按群共享
 
 ## 💿 安装
 
@@ -109,7 +109,41 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI
 | ollama | llama3 | http://localhost:11434/v1 |
 | custom | gpt-4o-mini | 自定义 |
 
-## 🎉 使用
+## 📂 角色目录结构
+
+`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` 中已配置：
+
+```env
+COMMAND_START=["!", "/"]
+```
+
+否则 NoneBot 不会识别命令。
+
+### 群聊会话机制
+
+- **群聊**：管理员执行 `!角色切换` 后，**全群共享同一个会话**。任何群成员 @机器人 发消息都会进入同一个对话历史。
+- **私聊**：每个用户与角色的对话历史是独立的。
 
 ### 指令表
 

{nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.3}/nonebot_plugin_dotcharacter/__init__.py

@@ -74,7 +74,7 @@ __plugin_meta__ = PluginMetadata(
     supported_adapters={"~onebot.v11"},
     extra={
         "author": "tghrt",
-        "version": "2.0.2",
+        "version": "2.0.3",
     },
 )
 

{nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.3}/nonebot_plugin_dotcharacter.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-dotcharacter
-Version: 2.0.2
+Version: 2.0.3
 Summary: NoneBot 插件：加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI 角色扮演对话
 Author: tghrt
 License: MIT
@@ -64,7 +64,7 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI
 - 🔥 热加载角色，无需重启
 - 💬 群聊 @机器人 触发对话，命令无需 @
 - 👑 管理员权限控制（命令仅管理员可用）
-- 🧠 多用户会话隔离
+- 🧠 私聊会话独立，群聊会话按群共享
 
 ## 💿 安装
 
@@ -134,7 +134,41 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI
 | ollama | llama3 | http://localhost:11434/v1 |
 | custom | gpt-4o-mini | 自定义 |
 
-## 🎉 使用
+## 📂 角色目录结构
+
+`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` 中已配置：
+
+```env
+COMMAND_START=["!", "/"]
+```
+
+否则 NoneBot 不会识别命令。
+
+### 群聊会话机制
+
+- **群聊**：管理员执行 `!角色切换` 后，**全群共享同一个会话**。任何群成员 @机器人 发消息都会进入同一个对话历史。
+- **私聊**：每个用户与角色的对话历史是独立的。
 
 ### 指令表
 

{nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-dotcharacter"
-version = "2.0.2"
+version = "2.0.3"
 description = "NoneBot 插件：加载 dot-skill / colleague-skill 蒸馏角色，通过 QQ Bot 进行 AI 角色扮演对话"
 requires-python = ">=3.9"
 readme = "README.md"