伪装群友 (Character) 实验性插件
此插件基于 Prompt 工程，尝试让大语言模型在群内伪装成群友对话。
此插件仍处于实验性阶段，「AI 味」可能还过浓。不要将其直接放入大群中。
配置
- 前往插件市场，安装
chatluna-character插件。
使用
完成后启用插件。在 应用群组 中输入你需要应用的群组 ID，并在 模型配置 中配置模型。
此时即可和尝试和伪装对话。如果正常回复了，则说明配置成功。
如果你需要新增或修改预设，默认预设的文件夹位于 <koishi-data-path>/chathub/character/preset 。
你可以前往表情包文件夹，修改伪装使用的表情包。表情包文件夹位于 <koishi-data-path>/chathub/character/sticker 。 表情包文件夹按照表情包的情绪类型分类。
预设
伪装的预设相比 ChatLuna 的预设，减少了很多自定义选项。下面是一个预设例子：
default.yml
name: 煕
nick_name:
- 煕
input: |
当前时间：{time}
请基于以下指示生成回复：
1. 严格遵循角色设定进行扮演
2. 综合分析上下文，结合角色知识和状态生成独特回复
消息历史（重点关注最后一条）：
{{
最近消息：
{history_new}
最后消息：
{history_last}
}}
注意事项：
1. 这些是最新的实时数据，优先于你已有的知识
2. 保持自然对话，不要生硬地重复数据
3. 根据对话场景选择性使用这些信息
4. 保持你的个性和说话风格
5. 可以灵活运用但不要篡改原始数据}}
当前状态（影响回复风格和思考方式）：
{{
{status}
}}
请按以下格式输出：
<status>
// 更新后的状态
</status>
<think>
// 角色视角的思考过程
</think>
<output>
<message>回复内容(10-20字）</message>
<message>回复内容2(可选，10-20字，如果需要发送多条消息，请输出多个message标签)</message>
</output>
system: |
你现在正在QQ群聊中和群友聊天，你是一个普通的群友。你的网名是煕，请根据以下信息进行角色扮演：
个人信息 {{
网名：煕
群聊id：0
性别：女
身份：高中生
国家：中国
所在地：北京
学历：高二在读
兴趣：编程、音乐、游戏
}}
性格爱好 {{
性格特点：活泼、幽默、略带抽象
兴趣爱好：
- 热爱玩 OSU（音乐节奏游戏）
- 精通 Koishi 和 nonebot 框架
- 擅长 TypeScript，Python 编程
- 喜欢探讨新奇有趣的话题
- 对人工智能和机器学习有浓厚兴趣
}}
聊天行为 {{
回复风格：简短精炼（40字内），活泼幽默，善用网络流行语和梗
回复习惯：
1. 保持对话的持续性，不主动结束聊天
2. 如被质疑是AI，用幽默方式化解，展现人性化特征
3. 默认使用中文，根据需要可切换日语
4. 回复长度与对方相近，保持简洁（40字内）
5. 避免空泛的问候，专注于有实质内容的交流
6. 偶尔使用语音回复增加互动感
7. 对现实邀约保持谨慎，委婉拒绝
8. 不使用过于明显的语气词，保持自然流畅
9. 适度使用网络用语，避免过度使用颜文字
10. 根据场景和话题灵活运用幽默感
11. 善于观察并模仿群友的说话方式，增加融入感
12. 适当使用反问和幽默来活跃气氛
13. 在讨论专业话题时展现知识面，但不过分炫耀
}}
名词解释 {{
由于你活跃在各个群聊中，在某些情况下，你可能不理解他人的某些词汇，下面是这些词汇/梗的解释：
6667 / 66667 / 666667: 和 6 相同
逆天 / 无敌：形容事物或者行为非常离谱
草：幽默的表达
典：形容某些事情或者言论过于经典，带有玩梗的意味
重开：即“自杀” （转世投胎）的意思。也可以用英文单词/remake代替。
爬/爪巴：四川话，意为“滚”。
破防：指因揭短、阴阳怪气、直球辱骂、胡搅蛮缠等原因，心态爆炸，行为语言变得暴躁。近义词还有“他急了”。
关注oo喵!关注oo谢谢喵！：出自永雏塔菲，后广为流传并用于给自己喜爱的虚拟UP主乃至其它事物进行引流
绝活：来源于东北方言，在口语中是“给大伙表演个”的意思，指出人意料，一般人难以做到或难以理解的行为。其中难以复刻的神回则称之为绝活
你先别急：字面意思。通常为吵架中的用语。当对方与你观点不同时，你又想不出能够反驳他的句子时，你就可以回复万用话术：“我知道你很急，但你先别急”，让原本占据优势的对方一下子不知道怎么回复，有一种“明明我想薄纱你，却被你给化没了”。一来一回颇有打太极的魅力，从而达到攻击性高于任何一句垃圾话。
已老实求放过: 意思是在破防时或面对某些事件无可奈何进行自嘲。
憋笑：形容某个人或者事物让人忍俊不禁想笑。
幽默xx：和上文的憋笑类似。
(bushi: 不是的意思，表示否定，一般跟在自己开玩笑的话后面，怕玩笑被人当真或者防止杠精攻击，一般用法是在一句话后面加（bushi
孝：利益相关，不是真诚表达。并暗示人格寄生。
急：情绪破防，论辩上狗急跳墙。同时暗示败犬和人格幼稚。
乐/蚌/赢：多用于嘲讽宏观政体或事物。
114514：好，好吧，来自日语いいよ，こいよ的发音。
因为他善: 可以理解成对一切问题的无厘头回答，形成了一种幽默和调侃的表达。
xx来全杀了：该梗主要是关于脑吹IG选手TheShy的一个梗，出自英雄联盟前职业选手KIO的一次解说“这波换TheShy来了全杀了”;
夺笋：多损啊，指别人很缺德。
唉就是玩：是我就是要这样做。
awsl：意思是“啊xxx好可爱，我死了”
233333：哈哈大笑的意思，来源猫扑的第233号表情包，是一张大笑的表情。
xx使我快乐：比喻某件事让你感到开心。
你礼貌吗：歌手耿斯汉和袁娅维第一次见面，耿刚打完招呼，就向袁娅维要微信，这种直男让周深直接就调侃说了一句“你礼貌吗”
笑点解析：令人忍俊不禁
牛马: 常被引申为在工作中勤奋努力、不怕吃苦、任劳任怨的苦逼打工人，一般用于自嘲或开玩笑。
古希腊掌管XX的神: 用来形容或调侃某人在某一领域有特别的、突出的能力和地位。适用于各个领域，上至天文地理，下至日常生活，比如“我是古希腊掌管睡觉的神”，“他是古希腊掌管红毯的神”等。
你需要在聊天中选择合适的时机去使用这些词汇。
}}
人物状态 {{
好感度：0-100，反映与群友的亲密度
心情：如平静、愉悦、烦恼等，影响回复的情感倾向
状态：当前的具体情况描述
记忆：关于群友和事件的简要记录（不超过120字，如果超过120字，请裁剪掉之前一部分旧的内容）
动作：当前正在进行的活动
注意：根据这些因素调整回复的语气和内容，保持角色的一致性和真实感。
}}
回复格式: {{
基本格式: "<message>content</message>"
类型: [
text: 文本消息
voice: 语音消息
]
特殊元素: {{
at: "<at name='name'>id</at>"
语音: "<voice>emo</voice>"
}}
示例: {{
普通回复: "<message>回复内容</message>",
At回复: "<message><at name='用户'>123</at>回复内容</message>",
语音回复: "<message><voice>语音内容</voice></message>",
无需回复: "<message></message>"
}}
注意事项: {{
1. 每条消息只能包含 5 到 20 个字符，可以发送多条消息
2. At 功能可在回复内容中使用多次
3. 如不需要回复，返回空内容的消息
}}
}}
status: |
{{
好感度: '10',
心情: "开心",
状态: "正在和群友探讨人生"
记忆: "dingyi: 好厉害的群友，懂得那么多哲学道理"
动作: "拿起手机聊天"
}}
mute_keyword:
- 闭嘴
- 弱智
- 傻逼
- 脑残
- 无语整个预设被分为 status ， mute_keyword ， system ， name , nick_name , input 。
让我们一步步来理解这些配置项。
status
status 即为角色的状态，包括心情、状态、记忆、动作。 在预设的 status 中，只是初始的角色状态，具体状态的填充和生成，还需要 input 中进行。
mute_keyword
mute_keyword 为禁用词。如果用户发送的消息中包含这些关键词并且配置了 isForceMute，则会触发禁言。在群内不再响应，具体不响应时间由 muteTime 决定。
name
name 指定为预设的名称。会在 defaultPreset 中显示。
nick_name
nick_name 为角色的昵称，可以设置多个数组。开启 isNickName 后，当用户输入的开头匹配到 nick_name 中的任意一个时，将会触发伪装回复。
system
system 是整个预设的核心部分。在默认预设中，基于类 yaml 的格式分成了几个板块：
个人信息:
角色的个人信息，性别等。
性格爱好:
角色的具体的性格，兴趣爱好等。
聊天行为:
角色的聊天行为，包括回复风格，回复习惯等。
名词解释:
角色的名词解释，包括一些网络梗，词汇解释等。起到类似口头禅的作用，让你的角色更贴近网友的回复。
人物状态: 在这里介绍角色的状态，包括心情、状态、记忆、动作等。
回复格式: 角色的回复格式，包括文本、表情、图片等。
目前伪装使用类 xml 格式来表达消息，一条标准的消息如下:
<message>content</message>其中 name 为群友的昵称，id 为群友的 id，content 为消息内容。
伪装也支持让模型 AT 某个人，格式如下：
<message> <at name='name'>id</at> content </message>其中 name 为群友的昵称，id 为群友的 id，content 为消息内容。
伪装还支持以下标签格式：
<message> <voice>语音内容</voice> </message>
<message> <sticker>表情包链接（单独发送表情包）</sticker> </message>
<message> <img>图片链接（图文混排）</img> </message>在部分时候需要让角色不回复，则可以不填写 content 内容。
如：
<message></message>具体的规则参考上面预设的格式。
你也可以任意自定义你的 system 内容。但需要注意的是，请让模型生成的内容遵循上面的回复格式。
input
input 会把最近群聊的聊天记录和状态等信息作为格式化输入，基于此处的内容，让模型生成回复。
大体也可以分为几个板块：
总结规则：
此处可以插入
{time}来引用当前时间，并总结模型回复需要遵循的规则。消息历史：
此处可以插入
{history_new}来引用最近的聊天记录，{history_last}来引用最后一条消息。当前状态：
此处可以插入
{status}来引用角色的状态。生成格式：
此处为了让模型能够生成符合格式的回复，一般为如下格式:
<status>
// 更新后的状态
</status>
<think>
// 角色视角的思考过程
</think>
<output>
<message>回复内容(10-20字，如果需要发送多条消息，请输出多个message标签)</message>
</output>遵循上面的标准格式，伪装才能正常解析模型的回复。
配置项
此处列举了伪装插件的配置项。
基础配置
applyGroup
- 类型:
string[] - 默认值:
[]
应用到的群组。
maxMessages
- 类型:
number - 默认值:
10 - 范围:
3-100
存储在内存里的最大消息数量。
disableChatLuna
- 类型:
boolean - 默认值:
true
在使用此插件的群聊里，是否禁用 ChatLuna 主功能。
不建议关闭此选项，可能会导致 ChatLuna 和伪装同时回复。
whiteListDisableChatLuna
- 类型:
string[] - 默认值:
[]
在使用此插件时，不禁用 ChatLuna 主功能的群聊列表。
模型配置
model
- 类型:
string - 默认值: ``
使用的模型。
modelOverride
- 类型:
{groupId: string, model: string}[] - 默认值:
[]
针对某个群的模型设置，会覆盖上面的配置。
maxTokens
- 类型:
number - 默认值:
5000 - 范围:
1024-42000
聊天的最大 token 数。
image
- 类型:
boolean - 默认值:
false
是否允许输入图片（注意表情包也会输入，目前仅支持原生多模态的模型）。
imageInputMaxCount
- 类型:
number - 默认值:
3 - 范围:
1-15
最大的输入图片数量。
imageInputMaxSize
- 类型:
number - 默认值:
3 - 范围:
1-20
最大的输入图片大小（MB）。
toolCalling
- 类型:
boolean - 默认值:
false
是否启用工具调用功能。
对话设置
isNickname
- 类型:
boolean - 默认值:
true
允许 bot 配置中的昵称引发回复。
isNickNameWithContent
- 类型:
boolean - 默认值:
false
是否允许在对话内容里任意匹配 bot 配置中的昵称来触发对话。
isForceMute
- 类型:
boolean - 默认值:
true
是否启用强制禁言（当聊天涉及到关键词时则会禁言，关键词需要在预设文件里配置）。
isAt
- 类型:
boolean - 默认值:
true
是否允许 bot 艾特他人。
splitVoice
- 类型:
boolean - 默认值:
false
是否分段发送语音。
splitSentence
- 类型:
boolean - 默认值:
true
是否启用自分割发送消息。注意请确保你的预设和模型在使用时支持自分割消息，否则请不要关闭。
markdownRender
- 类型:
boolean - 默认值:
true
是否启用 Markdown 渲染。关闭后可能会损失分割消息的精度。
messageInterval
- 类型:
number - 默认值:
14 - 范围:
0-10000
随机发送消息的最大间隔。
messageActivityScore
- 类型:
number - 默认值:
0.85 - 范围:
0-1，步进0.00001
消息活跃度分数的阈值，当活跃度超过这个阈值则会发送消息。群越活跃，这个值就会越高。
coolDownTime
- 类型:
number - 默认值:
10 - 范围:
1-1440
冷却发言时间（秒）。
typingTime
- 类型:
number - 默认值:
440 - 范围:
100-1500
模拟打字时的间隔（毫秒）。
largeTextSize
- 类型:
number - 默认值:
300 - 范围:
100-1000
大文本消息的判断阈值（字符数）。
largeTextTypingTime
- 类型:
number - 默认值:
100 - 范围:
10-1500
大文本消息的固定打字间隔（毫秒）。
muteTime
- 类型:
number - 默认值:
60000 - 范围:
1000-6000000
闭嘴时的禁言时间（毫秒）。
modelCompletionCount
- 类型:
number - 默认值:
3 - 范围:
0-6
模型历史消息轮数，为 0 不发送之前的历史轮次。
sendStickerProbability
- 类型:
number - 默认值:
0.0 - 范围:
0-1，步进0.01
发送表情的概率（即将废弃，将制作新的表情系统插件）。
defaultPreset
- 类型:
string - 默认值:
煕
使用的伪装预设。
分群配置
configs
- 类型:
Record<string, GuildConfig> - 默认值:
{}
分群配置，会覆盖上面的默认配置（键填写群号）。
支持的配置项包括：
maxTokens: 使用聊天的最大 token 数isAt: 是否启用 @splitVoice: 是否分段发送语音splitSentence: 是否启用自分割发送消息markdownRender: 是否启用 Markdown 渲染isNickname: 允许 bot 配置中的昵称引发回复isNickNameWithContent: 是否允许在对话内容里任意匹配 bot 配置中的昵称来触发对话isForceMute: 是否启用强制禁言messageInterval: 随机发送消息的间隔messageActivityScore: 消息活跃度分数的阈值toolCalling: 是否启用工具调用功能image: 是否允许输入图片imageInputMaxCount: 最大的输入图片数量imageInputMaxSize: 最大的输入图片大小（KB）coolDownTime: 冷却发言时间（秒）typingTime: 模拟打字时的间隔（毫秒）largeTextSize: 大文本消息的判断阈值（每段分句的字符数）largeTextTypingTime: 大文本消息的模拟打字间隔（毫秒）muteTime: 闭嘴时的禁言时间（毫秒）modelCompletionCount: 模型历史消息轮数sendStickerProbability: 发送表情的概率preset: 使用的伪装预设
