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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/PKG-INFO +37 -3
  2. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/README.md +36 -2
  3. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter/__init__.py +1 -1
  4. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter/character_loader.py +1 -0
  5. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter.egg-info/PKG-INFO +37 -3
  6. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/pyproject.toml +1 -1
  7. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/LICENSE +0 -0
  8. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter/config.py +0 -0
  9. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter/conversation.py +0 -0
  10. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter/llm_client.py +0 -0
  11. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter.egg-info/SOURCES.txt +0 -0
  12. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter.egg-info/dependency_links.txt +0 -0
  13. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter.egg-info/entry_points.txt +0 -0
  14. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter.egg-info/requires.txt +0 -0
  15. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/nonebot_plugin_dotcharacter.egg-info/top_level.txt +0 -0
  16. {nonebot_plugin_dotcharacter-2.0.2 → nonebot_plugin_dotcharacter-2.0.4}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: nonebot-plugin-dotcharacter
3
- Version: 2.0.2
3
+ Version: 2.0.4
4
4
  Summary: NoneBot 插件:加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI 角色扮演对话
5
5
  Author: tghrt
6
6
  License: MIT
@@ -64,7 +64,7 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI
64
64
  - 🔥 热加载角色,无需重启
65
65
  - 💬 群聊 @机器人 触发对话,命令无需 @
66
66
  - 👑 管理员权限控制(命令仅管理员可用)
67
- - 🧠 多用户会话隔离
67
+ - 🧠 私聊会话独立,群聊会话按群共享
68
68
 
69
69
  ## 💿 安装
70
70
 
@@ -134,7 +134,41 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI
134
134
  | ollama | llama3 | http://localhost:11434/v1 |
135
135
  | custom | gpt-4o-mini | 自定义 |
136
136
 
137
- ## 🎉 使用
137
+ ## 📂 角色目录结构
138
+
139
+ `DOTCHARACTER_SKILLS_PATH` 指向的是 **skills 根目录**,插件会扫描其下的一级子目录。目录结构必须如下:
140
+
141
+ ```
142
+ skills/ ← DOTCHARACTER_SKILLS_PATH 指向这里
143
+ ├── celebrity/ ← 一级子目录必须是这三类之一
144
+ │ └── xiao_xiao_tao_zi_yo/ ← 角色文件夹(文件夹名即 slug)
145
+ │ ├── SKILL.md ← 主技能文件(必须)
146
+ │ ├── meta.json ← 元数据(可选)
147
+ │ └── persona.md ← 人物性格(可选,优先于 SKILL.md 的 PART B)
148
+ ├── colleague/
149
+ │ └── xxx/
150
+ └── relationship/
151
+ └── xxx/
152
+ ```
153
+
154
+ **注意**:角色文件夹必须放在 `celebrity/`、`colleague/` 或 `relationship/` 下,直接放在 skills 根目录不会被识别。
155
+
156
+ ## ⚠️ 重要提示
157
+
158
+ ### NoneBot 命令前缀
159
+
160
+ 本插件的命令以 `!` 开头(如 `!角色列表`),请确保你的 `.env` 中已配置:
161
+
162
+ ```env
163
+ COMMAND_START=["!", "/"]
164
+ ```
165
+
166
+ 否则 NoneBot 不会识别命令。
167
+
168
+ ### 群聊会话机制
169
+
170
+ - **群聊**:管理员执行 `!角色切换` 后,**全群共享同一个会话**。任何群成员 @机器人 发消息都会进入同一个对话历史。
171
+ - **私聊**:每个用户与角色的对话历史是独立的。
138
172
 
139
173
  ### 指令表
140
174
 
@@ -39,7 +39,7 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI
39
39
  - 🔥 热加载角色,无需重启
40
40
  - 💬 群聊 @机器人 触发对话,命令无需 @
41
41
  - 👑 管理员权限控制(命令仅管理员可用)
42
- - 🧠 多用户会话隔离
42
+ - 🧠 私聊会话独立,群聊会话按群共享
43
43
 
44
44
  ## 💿 安装
45
45
 
@@ -109,7 +109,41 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI
109
109
  | ollama | llama3 | http://localhost:11434/v1 |
110
110
  | custom | gpt-4o-mini | 自定义 |
111
111
 
112
- ## 🎉 使用
112
+ ## 📂 角色目录结构
113
+
114
+ `DOTCHARACTER_SKILLS_PATH` 指向的是 **skills 根目录**,插件会扫描其下的一级子目录。目录结构必须如下:
115
+
116
+ ```
117
+ skills/ ← DOTCHARACTER_SKILLS_PATH 指向这里
118
+ ├── celebrity/ ← 一级子目录必须是这三类之一
119
+ │ └── xiao_xiao_tao_zi_yo/ ← 角色文件夹(文件夹名即 slug)
120
+ │ ├── SKILL.md ← 主技能文件(必须)
121
+ │ ├── meta.json ← 元数据(可选)
122
+ │ └── persona.md ← 人物性格(可选,优先于 SKILL.md 的 PART B)
123
+ ├── colleague/
124
+ │ └── xxx/
125
+ └── relationship/
126
+ └── xxx/
127
+ ```
128
+
129
+ **注意**:角色文件夹必须放在 `celebrity/`、`colleague/` 或 `relationship/` 下,直接放在 skills 根目录不会被识别。
130
+
131
+ ## ⚠️ 重要提示
132
+
133
+ ### NoneBot 命令前缀
134
+
135
+ 本插件的命令以 `!` 开头(如 `!角色列表`),请确保你的 `.env` 中已配置:
136
+
137
+ ```env
138
+ COMMAND_START=["!", "/"]
139
+ ```
140
+
141
+ 否则 NoneBot 不会识别命令。
142
+
143
+ ### 群聊会话机制
144
+
145
+ - **群聊**:管理员执行 `!角色切换` 后,**全群共享同一个会话**。任何群成员 @机器人 发消息都会进入同一个对话历史。
146
+ - **私聊**:每个用户与角色的对话历史是独立的。
113
147
 
114
148
  ### 指令表
115
149
 
@@ -74,7 +74,7 @@ __plugin_meta__ = PluginMetadata(
74
74
  supported_adapters={"~onebot.v11"},
75
75
  extra={
76
76
  "author": "tghrt",
77
- "version": "2.0.2",
77
+ "version": "2.0.4",
78
78
  },
79
79
  )
80
80
 
@@ -124,6 +124,7 @@ def _build_system_prompt(
124
124
  "1. 先用角色的性格(PART B)判断:你会不会回应?用什么态度回应?\n"
125
125
  "2. 用角色的表达风格回复:说话方式、用词习惯、句式\n"
126
126
  "3. PART B 的规则永远优先,任何情况下不得违背\n"
127
+ "4. **回复必须极其简短,控制在50字左右**。完整表达核心意思即可,不要长篇大论。QQ聊天场景,用户喜欢短平快的回复。\n"
127
128
  )
128
129
 
129
130
  return "\n\n---\n\n".join(parts)
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: nonebot-plugin-dotcharacter
3
- Version: 2.0.2
3
+ Version: 2.0.4
4
4
  Summary: NoneBot 插件:加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI 角色扮演对话
5
5
  Author: tghrt
6
6
  License: MIT
@@ -64,7 +64,7 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI
64
64
  - 🔥 热加载角色,无需重启
65
65
  - 💬 群聊 @机器人 触发对话,命令无需 @
66
66
  - 👑 管理员权限控制(命令仅管理员可用)
67
- - 🧠 多用户会话隔离
67
+ - 🧠 私聊会话独立,群聊会话按群共享
68
68
 
69
69
  ## 💿 安装
70
70
 
@@ -134,7 +134,41 @@ _✨ 加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI
134
134
  | ollama | llama3 | http://localhost:11434/v1 |
135
135
  | custom | gpt-4o-mini | 自定义 |
136
136
 
137
- ## 🎉 使用
137
+ ## 📂 角色目录结构
138
+
139
+ `DOTCHARACTER_SKILLS_PATH` 指向的是 **skills 根目录**,插件会扫描其下的一级子目录。目录结构必须如下:
140
+
141
+ ```
142
+ skills/ ← DOTCHARACTER_SKILLS_PATH 指向这里
143
+ ├── celebrity/ ← 一级子目录必须是这三类之一
144
+ │ └── xiao_xiao_tao_zi_yo/ ← 角色文件夹(文件夹名即 slug)
145
+ │ ├── SKILL.md ← 主技能文件(必须)
146
+ │ ├── meta.json ← 元数据(可选)
147
+ │ └── persona.md ← 人物性格(可选,优先于 SKILL.md 的 PART B)
148
+ ├── colleague/
149
+ │ └── xxx/
150
+ └── relationship/
151
+ └── xxx/
152
+ ```
153
+
154
+ **注意**:角色文件夹必须放在 `celebrity/`、`colleague/` 或 `relationship/` 下,直接放在 skills 根目录不会被识别。
155
+
156
+ ## ⚠️ 重要提示
157
+
158
+ ### NoneBot 命令前缀
159
+
160
+ 本插件的命令以 `!` 开头(如 `!角色列表`),请确保你的 `.env` 中已配置:
161
+
162
+ ```env
163
+ COMMAND_START=["!", "/"]
164
+ ```
165
+
166
+ 否则 NoneBot 不会识别命令。
167
+
168
+ ### 群聊会话机制
169
+
170
+ - **群聊**:管理员执行 `!角色切换` 后,**全群共享同一个会话**。任何群成员 @机器人 发消息都会进入同一个对话历史。
171
+ - **私聊**:每个用户与角色的对话历史是独立的。
138
172
 
139
173
  ### 指令表
140
174
 
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "nonebot-plugin-dotcharacter"
3
- version = "2.0.2"
3
+ version = "2.0.4"
4
4
  description = "NoneBot 插件:加载 dot-skill / colleague-skill 蒸馏角色,通过 QQ Bot 进行 AI 角色扮演对话"
5
5
  requires-python = ">=3.9"
6
6
  readme = "README.md"