Metadata-Version: 2.5
Name: tenko-plugin-persona-chat
Version: 0.1.37
Summary: Tenko AI 群友：接入 DeepSeek，用人设口吻陪群友聊天，内置“大肥鱼”
Project-URL: Homepage, https://github.com/g1331/tenko-plugins/tree/main/plugins/persona_chat
Project-URL: Repository, https://github.com/g1331/tenko-plugins
License-Expression: GPL-3.0-only
Keywords: chatbot,deepseek,llm,qq,tenko,tenko-plugin
Classifier: Framework :: AsyncIO
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications :: Chat
Requires-Python: <3.14,>=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: pillow>=10
Requires-Dist: pypinyin>=0.51
Requires-Dist: tenko-api<0.5,>=0.4.1
Requires-Dist: zhconv>=1.4
Description-Content-Type: text/markdown

# tenko-plugin-persona-chat

[Tenko](https://github.com/g1331/tenko) 的 AI 群友插件。接入 DeepSeek（或任何 OpenAI 兼容接口），用人设口吻陪群友聊天，内置人设是“大肥鱼”——网友给 DeepSeek 起的外号“蓝色大肥鱼”拟人成的鲸鱼娘，爱撒娇、蠢萌、兴趣偏科，不懂的事老实说不懂或者先搜一下。

```text
群友 A：@大肥鱼 听说你高峰期又涨价了？
大肥鱼：什么叫“又”啊，说得好像我天天趁火打劫一样……排队排到鱼尾都打结了，不加钱谁顶得住嘛
```

## 规则

- 群里被 @、被回复时一定回复；@ 同群任一 Tenko 账号都算。群友打的字里只含唤醒词（默认“大肥鱼”；@ 或引用一个同名群友不算）时也叫她来看，但不强制回：很多人自己部署了大肥鱼，“我的大肥鱼”“我电脑里的”多半说的是他们自己那个，由她判断是不是在叫她，不是就旁观接一句或不说话。被叫到后不秒回：从那条消息到她发出第一条，按看消息 2 秒、每秒打 3 个字留出时间（最多 12 秒；日志里群友接话的中位数约 8 秒），扣掉模型思考已经花的时间。只有要接的那条后面已经有别人说话时（含等待期间）才引用它，否则直接发；私聊每条都回复。
- 昵称里带唤醒词的别人的号（多半是另一个 AI，比如“大肥鱼bot”）：它的话照样记进记录，但引用她、提到“大肥鱼”都不算叫她，只有 @ 她才回；它说话也不算新消息、不触发跟聊，免得两个 AI 你一句我一句刷屏。
- bot 说过话后的 3 分钟内算在聊天里：紧跟在它后面打了字的那条消息（可能在回它；只发一张图、一个表情不算，引用或 @ 了别人的不算，一字不差重复别人刚说过的话也不算，多半是跟着问那个人）或每攒两条新消息，等群里安静 3 秒，让模型判断要不要接着聊。群友接话很少 @ 她，所以紧跟着她的那条会在提示里点明“#编号 紧跟在你后面说……”，同时摆出她刚说的话，提醒没 @ 她就不一定是对她说的，让她对照内容判断：之前只说“多半是在接你的话”，别人在她后面接前面的话题、吐槽别人的图时，她常以为在说她。最近 20 条里她已经开口超过 4 次时（连着说的几条算一次；日志里最活跃的群友约占两成），不再攒消息插嘴，也不主动开口；有人紧跟着她打字回她时照样接。
- 没人叫她、最新一条只是图或表情包时，只许回表情包：模型看了图总忍不住描述画面（“这猫瞪得比我还圆”），规则和末尾提示都压不住。借收藏里的图接在真实聊天后面当成群友新发的梗图回放，旧版开口的回复约一半在描述画面；现在末尾提示要她大多数时候不说话、真觉得好笑才回一张表情包、擦边的图不接，她写了字的话先按这话挑一张贴切的表情包（4 分以上），字不发。只改提示词（不许描述画面）时开口反而更多、盲评输给旧版；改成只许回表情包后，同样 60 次里描述画面 15 → 0，擦边图上开口 7/20 → 1/20，开口 25 → 20 次，盲评 26:3（31 平）。
- 说话风格按日志里真人群聊调过：群里一半的消息不到 8 个字，所以每次请求末尾都提醒她说短、默认只发一条、一两个字的反应（“草”“？”“笑死”）也算回复；群友发的表情包和梗图当成一句话来接，不去描述画面，有人要她看图时才聊图里的内容。按 10-24 到 10-27 的日志比过她和群友：每条字数中位数 16 比 10，不到 8 个字的 7% 比 36%，一次只发一条的 41% 比 63%（只算发言 20 条以上的人），连发 4 条以上的 18% 比 8%，带“嘛”的 11% 比 1%，“我搜了下”开头的有 133 条。所以一次回复最多发两条字（表情包另算，多出来的并进第二条）；人设示例大多改成一条、少带语气词；末尾提示里点名她最近 20 条里用了 4 次以上的语气词（嘛、呀、啦、欸）和开头（不过、就是、其实、我搜了下、哈哈），让她这次别用，和点名最近用过的梗一样；末尾提示还列出这个群最近常见的短说法（一整条不超过 6 个字、至少 3 次、两个人以上发过，接龙复读只算一次，命令、带 @ 的和纯数字不算），合适时让她也这么接。有人说她是 bot、人机、没活人感时插件只发第一句：她以前连发三条辩解“欸 哪没活人感嘛 / 我这不是在陪你们聊吗”；末尾另加提示反而更糟，别人说别的 bot 她也急着回“我不是机器人”，所以不加。这时插件另挑表情包，有 4 分以上贴切的就只发表情包、字不发：打字回什么都像对号入座。规则里写的是冲她说就顺着玩一句（“复活吓死你们”），没点她名的不接；一群人接龙复读“这群怎么那么多机器人”时，没人叫她插件就不问模型。群友聊 bot 本身（部署、token、花多少钱）她不讲解；随口提到的主播、外号、梗当成大家都认识的，能搜就搜，不问“某某是谁”；引用她的话再起外号吐槽，说的就是她，不反问；不值得正经接的话（复读、起哄）被叫到时回个“？”“hyw”或一张表情包就算回了。人称和称呼也写进规则：“我”“你”别弄反，聊天里提到 bot主人就叫名字，不说“主人”。搜索是悄悄的：搜完的回复开头是“我搜了下”“查了一下”的，插件删掉这几个字（日志里她 133 条话这么开头）；冲她说一句没头没尾的话，多半是在考梗，规则让她先搜再用梗里的说法接。这几条是按群主几轮盲评调的（每轮约 20 题，从日志还原场景，新旧两版回复打乱后由人挑更像群友的）：9:8、13:4、9:10（输在只点破不接梗，于是加了“短不等于干巴巴”）、15:5（被说是 bot 只发表情包的 5 题全胜）。末尾提示还要她把简短和干巴巴分开：有人认真问、请教时，要说成一句通顺的整话，连接词照带（“那看你玩什么游戏了，要是玩大作的话显卡就别省”），不为了短压成几截空格隔开的短语（“看游戏 显卡别省 散热留余地”），那样一看就是 AI。
- 提示词分三层：人设（她是谁、来历、口味、语气和示例对话，可用 `persona` 整段换掉）、群友规则（怎么当群友：接住对方再带上自己的看法或经历、留个话口，关心群友说过的事，有立场、被呛不认怂，梗只当调料，被逗时岔开而不是说“我不接”，像打字聊天一样说话）和输出规则（消息格式、工具、表情包）。后两层和人设无关，换了人设照样生效，所以自定义人设只写人物本身就行；实测一个只写了身份的自定义人设，加上群友规则后在多轮模拟聊天的盲评里 19:2 胜过不加。
- 预置两个人设：“大肥鱼”（默认，爱撒娇的蠢萌鲸鱼娘）和“小埋”（住在群里的老群友，样子和说话的味道像《干物妹！小埋》的土间埋：随意、懒懒的，被逗了就笑一下、吐槽回去，不撒娇不卖萌，记挂着群里的人，谁有事都帮着查、出主意，查完说结论、给建议，不把图上的数字念一遍）。大肥鱼像真人一样有自己的日常；小埋的日子就是这个群：大家聊了什么、谁在忙什么、她帮谁查了什么，这些她都能拿来聊、拿来关心人，群外的上学、吃饭、睡觉不编；被说是机器人、问是不是 AI，就顺着玩一句（“被发现了”“复活吓死你们”），不强调身份，也不硬说自己是真人。在生产记录的 22 个时刻回放（被叫到和没人叫两种），编造群外经历从 15/44 降到 5/44，盲评 19:9（16 平）；剩下的多是记录里她以前编过的话被接着往下说，只留最后几条再问就没有了，所以换版后建议 `/AI群友 重置 全部`。早先小埋也按“有日常”的规则走，还每天按人设编两三件“今天的小事”放进提示：生产记录里她 510 条发言约 40 条在编日常或说困了要睡，群友的反应是“海老名？”“真的假的”“刚刚不是说看新番吗”“你不是机器人吗”，没有一条接得起来；一天的小事早上就整段给出，还会早上七点说“晚上薯片吃完了”。所以“今天的小事”整个删掉。自定义人设按有日常的规则走。`/AI群友 人设 换 小埋` 一键切换，也能 `/AI群友 人设 改` 写自定义人设；选择存在插件数据目录的 `persona.json`，所有群共用。人设的名字自动算唤醒词，换了以后旧名字不再算叫她（`wake_words` 可以另加）。各群之前的聊天还是旧人设说的，想马上换干净可以 `/AI群友 重置 全部`。人设里不写具体功能：她能用的功能是从其他插件动态发现的，人设只写她乐意帮人用。
- 说话分寸按生产日志调过：拿最近 72 小时里 120 次被 @ 的真实回复在同一份快照上回放，让模型站在群友角度盲评。被逗、被骂、被编故事时，规则要她撒个娇或笑着岔开，不挑字眼、不反问、不非要证明自己没错（这条也写进每次请求的末尾提示，只写在规则里压不住）；有人认真问、请教、问她自己时，正面回答并结合她在群里的实际表现，不拿梗打发。改后大肥鱼盲评 74:39 胜过改前；小埋 78:31、70:43（两轮），评审判为“贫嘴抬杠”的从 20% 降到 12–17%；截图里“从你对群友的发言来看，你最想拥有什么能力”这类问题，改前 10 次全答“不用睡觉”一类，改后 9–10 次会说想记准群友的事、帮人查东西少来回问。
- 她最近说过人设里的梗（内置人设如“白饭”“token”“尾巴”，自定义人设填 `catchphrases`）时，末尾提示会点名这些刚用过，让她别句句往上靠；和同一个人 5 分钟内每来回满 4 轮，提醒一次别在同一个梗上打转、换个方向聊。多轮模拟里内置人设的自嘲梗从约一成降到几乎没有，盲评约 3:1 胜过之前的版本。
- bot 会累：10 分钟内说满 15 句（`stamina`）或 1 小时内说满 30 句算累，参照的是活跃群友的说话量。用掉三分之二（10 分钟 10 句或 1 小时 20 句）后不再主动开口，只在被叫到时回话；累了以后，@ 她、引用她的照样要回，只是提示她简短回一句（有日常的人设可能说要去歇会儿，小埋不装困）；只提到名字的由它决定理不理。只提到名字的到 1.5 倍后不理，@ 她、引用她的到 2 倍才不理：以前到 1.5 倍连 @ 也不理，她刚连着帮人查完几次战绩，群里“小埋”“@你”叫了几分钟没反应，接着就是“似了吧”“bot是不是下播了”“对话无了”。不说话就慢慢恢复。
- 没在聊天时，群里累计 8 条新消息后同样等安静 3 秒，让模型判断要不要插一句；这样插过话后 5 分钟内不再这样插话。
- 模型看到插件启用以来的聊天记录，格式是 `#编号 [昵称(QQ号) 身份] 内容`（身份取宿主的成员权限：群主、群管理、bot管理员、bot主人，普通成员不标；昵称冒充骗不了它），规则后面告诉它当前群名，像 QQ 一样隔了 5 分钟以上的消息前面标一行时间，每次请求的提示里带当前时间（含年份，模型才不会按训练数据当成往年去搜）；编号只用来定位消息，模型说话时不会提它；@ 显示为昵称，引用了已不在记录里的消息时带上作者和开头。一次请求的输入超过 `context_tokens`（默认 32000）后，较早的部分由模型整理成一份备忘（人物、话题、梗和约定），按这次实际的输入量一次压到一半左右：人设、表情包目录和图片也占输入，只按聊天记录留一截的话压完还贴着阈值，每次回复都改写备忘，前缀缓存全部失效。闲聊丢点旧细节影响不大，压得狠一点、留足余量，备忘就很久才改写一次。超阈值时先撤旧图：只留最近约 4000 token 的图、换上新的表情包目录，撤完降到阈值的四分之三以下就不压聊天（群里图多时看过的图能占到输入的三分之二，聊天原文才一成，先压文字是丢了最值钱的部分），还超才压聊天；日志里记下压掉几条、撤掉的旧图约多少 token，以及输入从多少降到约多少。记录只追加不改动，请求前缀大多能命中缓存。聊天记录和备忘存在插件数据目录的 `conversations.json`（明文）：她每说完一次就存，其余时候有新消息最多每分钟存一次，插件卸载或退出时再存一次；重启后某个群第一次来消息时恢复，接着之前的编号聊。图片地址会过期，恢复后只剩 `[图片]`；精力、冷却等计时从零开始。`/AI群友 重置` 同时删掉存盘。
- 她会慢慢记住人和群：群里比上次整理多出 60 条消息时，在后台把这段记录（第一次最多读最近 300 条，连同备忘）交给模型，更新两种档案，存在插件数据目录的 `memory.json`。人物档案按 QQ 号所有群共用，每人约 80 字：怎么称呼、身份、和她的关系、本人说的游戏 ID 这类长期不变的事、她答应过的事；战绩这类会变的数字不记，隐私不记，关于某人的事只信本人或 bot主人、bot管理员说的，免得被人起哄写进“某某是傻逼”。群档案每群一份，约 300 字：群聊什么、群规、梗、她在群里的处境。私聊不整理。回复时把本群档案和最近 40 条里说过话的人的档案放在末尾提示里，注明可能过时、别硬提；放末尾是因为说话的人一换就变，放前面整段记录的缓存都会失效。实测真实群聊里有人 @ 她“帮我查下我的战绩”：没有档案时 6 次里 5 次拿“群友QQ号”去查、1 次反问 EA 名，有档案时 6 次都直接用了他绑定的 EA 名；闲聊“今天好热”时 6 次里只有 1 次顺口叫了声“猫娘”，没翻旧账。每次整理一次请求约 5–9k 输入、几百 token 输出。
- 每次请求最多带 5 张新图（`vision_images`），在请求时下载，和所属消息一起发给模型看。群里顺带出现的图用低清晰度，每张约 190 token（大图小图都差不多）；叫她时带的图、她被叫到时引用的那张图用高清，每张约 1000 token（小图三四百）：低清读不出密密麻麻的小字，还会照样编个数出来，实测真实战绩截图上的地图名，低清读成了别的图，高清读对了。图后面标一句“上面的图是 #编号 昵称 发的”，规则也要她想顺带聊别人发的东西时，像群友那样另发一条引用那条再说：不然图后面紧接着下一个人的话，她顺口就对着正在回的人说“你发的”（实测转发的漫画后面紧跟别人 @ 她，16 次里 3 次算错人；改后聊到漫画的几次都另发一条引用了转发那条）。动图（GIF）模型只看得到第一帧，所以均匀抽至多 6 帧、缩小后拼成一张 3×2 的图发给它，并注明是按时间顺序抽的帧，费用和一张图相同（做法参考 MaiBot）。看过的图之后一直跟着所属消息发给模型，直到压缩时只留最近约 4000 token 的图（约 20 张低清或 4 张高清）；不然来一张新图，最早那张就变回文字，从那条起的前缀缓存全部失效。长边超过 2048 像素或超过 2 MB 的照片（手机原图常有七八兆）先缩小重存成 JPEG 再发；没赶上看的、超过 20 MB（动图 8 MB）的或下载失败的图片只显示为 `[图片]`。带图请求被接口拒绝时去掉图片重试一次。
- 合并转发的聊天记录展开成 `[聊天记录：昵称：内容 / …]`（至多 300 字，套娃的转发只写 `[聊天记录]`），里面前 4 张图片和普通图片一样排进最近几张给她看；直接发的转发向 OneBot 实现（`get_forward_msg`）要内容，引用转发时直接用适配器带上的内容。
- 表情包：插件经 OneBot 原始接口 `get_msg` 区分表情包和照片（satori 适配器转换时丢了这个字段，拿不到时全当照片）。模型看到觉得好玩的表情包会悄悄调用 `save_sticker` 收藏，只收它这次真看到的表情包，不收照片和截图；收藏时写一段 60 字以内的备注：图上的字、画面、背后的梗和什么时候发。收藏所有群共用，存在插件数据目录的 `stickers/` 下，上限 `sticker_limit` 张；满了以后表情包目录前会提示收藏已满，模型收新图时在 `save_sticker` 的 `replace` 里自己挑一张丢掉，没挑或挑了不存在的名字时，在收进来 3 天以上的里头丢平均每天发得最少的（一样少丢最久没发的；全是新收的才在全部里挑），丢掉哪张记日志。以前按总次数丢，刚收进来还没轮到发的新图下一张进来就被挤掉，收藏里总是那几张老图。群友指出某张用错了或讲了它的梗时，模型先对照图上的字、自己知道的或搜索结果判断，确认原来写错了才调用 `edit_sticker` 改备注或名字，每次修改都记日志（会话、改前改后）。有人嫌某张难看、恶心或是刷屏的烂梗图（比如龙图）叫她删时，她用 `delete_sticker` 删掉：bot主人、bot管理员叫的直接删（规则里写明 bot主人是把她接进群、调教她的主人，交代的事嘴上可以嘟囔但要照办；被他们叫到时请求末尾再点一次名，只写在规则里时她常一边调用删除一边嘴上争“哪个是龙图”；她调用了删除就删，不再问答应没有，那句确认实测常把“哈？…行 删了”判成没答应）；别人叫的她自己判断，每个群每天最多删 3 张，而且模型常一边调用删除一边嘴上说“凭啥删”，所以再拿她回的话问一次答应了没有（一次几个 token 的小请求），答应了才删；删除都记日志。删掉的图（她删的或 `/AI群友 表情 删` 删的）记进插件数据目录的 `sticker_bans.json`，按内容哈希和 QQ 文件名（内容的 md5）认，群友以后再发同一张她也不收回来；满了腾位置丢的不算。引用她发过的表情包时，记录里写成“回复#编号（你发的[表情:名字]）”，她才知道说的是哪张，不会翻错编号、不认账。收藏目录（名字和备注）跟在群名后面发给模型；目录是每个会话的快照，收藏增删改不会改动它（不然每收一张，所有群后面的缓存都失效），变化写在每次请求末尾的提示里，压缩时才并进目录。群友玩梗时它会挑对应的图接梗，收藏里已有的表情包再出现时显示为 `[表情包:名字]`，不再发图；叫它的那条消息里带的除外，多半是要它看这张，光凭备注容易认错。模型在回复里写 `[表情:名字]` 就发对应的表情包，可以单独发、先字后图或同一条图文混排；每次最多一张，同一张在一个群里一段时间内不重复（收藏每多一张多 1 分钟，最长半小时），整条回复只有这张表情包时例外，编造的名字直接删掉；它把某张图上的字原样打成一整条（如“得加钱！”）时，改发那张图。模型边说话边配图非常保守，所以她说的话里没有能发的表情包时（没配、配的这张最近发过或名字是编的，也不是在用别的 bot 的指令），插件会再单独问一次：带上最近 6 条、她要说的话和最近在这儿发过的几张（叫它别挑），让模型从收藏里挑三张候选，各给贴切程度打 1–5 分；最好的一张有 5 分就发，只有 4 分时三次里发一次，在分数最高的那一档里随机挑一张跟在后面单独发，同样贴切的几张里平时每天发得多的机会小。以前只挑一张：模型每次都挑它心里最贴切的那几张，这几张又最常在冷却里，挑中了也发不出去；而且收藏目录按收藏先后排，模型偏爱列表前头的，后收的总轮不上。现在单独挑图时目录每天按日期换一次顺序（当天的前缀缓存照样命中），每个会话的目录快照也是打乱的。拿她两天里真实说过的约 300 段话按时间顺序重放（两版各记各的冷却），配图率 28% → 46%，用到的表情包 34 → 50 张，最常用 5 张的占比 44% → 34%，出自目录前半的占比 74% → 56%，两版都发了且不同的 30 段盲评贴切程度 13:11（6 平）。4 分就发时配图率到 76%，在 4 分以上的候选里按用量抽签时盲评输给旧版 12:20，所以只在最高一档里挑。这次请求的提示和收藏目录基本都能命中缓存，每次约 2400 token，其中约 2000 命中缓存。表情包经 NapCat 的 `send_group_msg` 带 `sub_type=1` 发出，显示成表情；接口不可用时改发普通图片。
- 聊天回复默认开 DeepSeek 的思考（`reasoning_effort = "high"`）。思考模式不支持强制调用工具，只能 `tool_choice=auto`，模型多半直接把话写进正文：没调 `send_message` 时正文就当要说的话；被叫到必须回话、想完却没开口时，插件不思考、强制只能说话再问一次。从 0.1.35 的日志里取 40 个场景（最近 10 条里没有图），同一套提示词回放，盲评开思考 24:12（4 平）胜过不开：更看得懂在逗谁、在玩什么梗，事实也更少说错。每次只多几十到一两百个输出 token，慢 1–2 秒。`low` 对 `high` 是 18:17（5 平），`low` 每次少想约 30 个 token，但遇到没听过的梗搜得少（4 次对 2 次），默认留在 `high`。思考时同一张图的输入 token 约是不思考的两倍，图照样看得懂。话写在正文里就填不了 `reply_to`：跟聊时提示本来只让她回紧跟在她后面的那条，所以没指定引用时插件默认引用这条（和被叫到时引用叫她的那条一样，只在被后面的话盖住时才引用）；规则也让她直接写字时在要接的那句开头写“回复#编号 ”，插件换成引用，接两条就拆成两次发。回放 31 个没人叫她的场景，不思考时 22 次开口里 3 次会引用被盖住的那条，开思考后模型很少自己写“回复#”（26 次里 1 次），所以主要靠默认引用。
- 被叫到、被问到不确定的具体事实时，模型可以先调用 `search`，插件用 DeepSeek 的网页搜索（`/v1/tools/search`，和对话共用 API key，每次约 0.005 元，搜不到不收费）取前 4 条结果的摘要，再让模型照结果回复，可以说是看来的，但别每次都用“我搜了下”开头。主动插话和跟聊时不搜；每个群或私聊每天最多搜 `search_daily` 次（默认 20，次数只记在内存里，重启清零）。允许搜索、或眼前有表情包要能顺手收藏时，被叫到的第一轮不强制只能说话；模型没说话时再强制问一次。
- 被叫到时，模型还能调用 `run_command` 用别的扩展插件（`tenko.plugins` 入口点里除它自己以外的插件，例如战地一查询）注册的命令。命令清单（用法和说明）每次现取，插件装卸后自动跟上，写在群名后面；宿主自带的命令不在清单里，清单外的命令不执行。命令以叫她的人的身份执行（换一条新消息 ID，免得命中原消息的命令解析缓存），宿主的插件开关、限流和权限照常生效。结果照常发到群里，同时整条记进记录：文字最多 1000 字，渲染出来的图以高清给模型看；然后再问一次模型，让她照着结果接话：结果大家都看得到，提示要她只回一条、一句话说个看法或最有意思的一点，最多带一个数字，有人起哄叫她损谁就拿游戏数据轻轻调侃一句；插件也只发她说的第一条。以前查完战绩她连发三条念 K/D、胜率、时长（功能结果后的回复八成带 4 个以上数字，平时不到一成），被群友说“没有活人感”。从日志里还原 27 个查战绩的场景（战绩图换成接口现拉的文字战绩卡），每个跑两次：平均 2.5 → 1.0 条、55 → 26 字，带 4 个以上数字的 76% → 41%，盲评哪种更有活人感 27:15（12 平），输的多是旧版先夸后损、判断更全的时候。主动插话和跟聊时不用命令。
- 模型每次必须在 `send_message`（往当前会话发文字；一次最多调用两次，每次可以换行分成几条连着发，整次回复最多两条字，中间按打字速度停顿）和 `stay_silent`（不说话）之间选一个，不能做任何管理动作；它写在普通回复里的文字一律丢弃。要 @ 人时它填对方某条消息的编号；像群友那样叫别的 bot（如生图）时它在 text 开头写“@昵称 指令”，昵称对上记录里说过话的人才换成真的 @，对不上的照原样当文字发。规则只告诉它自己只能发文字和表情包、别的 bot 能照群友的用法去叫，具体叫哪个、发什么命令由它从聊天记录里学。
- 违禁词（`banned_words`）：比对前统一成简体、半角、小写，去掉空格、标点和符号，所以 `lanyinzhenshen` 能拦下 “Lan Yin-Zhen.Shen”“ＬＡＮＹＩＮ ｚｈｅｎｓｈｅｎ”。拼音不少于 8 个字母的词条再按读音比一次（pypinyin 转成不带声调的拼音），写一条 `lanyinzhenshen` 就能拦下 “蓝银真神”“懒音真神”“蓝yin真shen”；读音更短的只按字面比，“西安”和“先”都读 xian，按读音比会误伤。群友的消息含违禁词时整条不记进记录，引用的开头、合并转发里的内容也算在这条消息里一起查；她看不到这条，就不会接话，提示、备忘和档案里也不会出现。模型要说的话含违禁词时整次回复都不发，只删掉词的话，剩下的内容照样能看出在聊什么。两种情况都会记日志。违禁词可以在 WebUI 的插件配置里一行一个地改，保存立即生效。
- DeepSeek 托管接口自己也审核内容：命中时不回话，直接返回 `400 Content Exists Risk`。触发的那条要是留在记录里，之后每次请求都会带上它被拒，整个群卡到有人重置为止。所以插件记着上次请求成功时记录到了哪一条，被审核拒绝时撤掉这次请求里新带上、还没审过的几条（分不清是哪条触发的，她自己刚说的也一起撤），这次不回，下次照常聊；撤掉的原文写进日志，可以照着补进违禁词。这类拒绝不当成故障报告给管理员。
- 只回艾特：群管理员及以上用 `/AI群友 只回艾特 开` 按群打开。打开后在这个群里只有 @ 她才回，叫名字、引用她都不算叫她，也不跟聊、不主动插话；群里的消息照样记进上下文。设置存在插件数据目录的 `at_only.json`，`关` 恢复正常。
- 有人在 bot 说完 10 秒内又来叫（多半是另一个 bot 在对聊），连续 3 轮后改由模型决定回不回，连续 6 轮后不再理会，直到对方慢下来。
- 同一个人叫 bot 至少间隔 5 秒；每个群每天最多用 20 万 token（未命中缓存的输入加输出；命中缓存的只按约 2% 计价，不计入），可另设全局每日上限，超出后当天不再应答。
- 命令消息（`/` 开头）会记进上下文，但不会触发回复。Tenko 功能从这些账号发出的回复（游戏出题、查询结果等）经 Entari 的 `after_send` 事件记进群聊记录，标作 `[Tenko 功能]`，只留文字、每条截断到 100 字，图片记成 `[图片]`，不算新消息，不会催模型插话；模型自己发的话不重复记录。规则后面告诉模型本群能响应的 bot 账号（昵称每次现取，改名后自动跟上）；记录里有别人的昵称含唤醒词（比如另一个叫“大肥鱼bot”的号）时，再点名告诉它那个号不是它，免得把对方的话和状态当成自己的和帮助命令，被问到功能时让对方看帮助。

插件消耗付费额度，是受控插件：所有群默认关闭，只有 BOT 管理员能用 `/开启 AI群友` 打开；私聊也只对 BOT 管理员开放。

## 命令

| 命令 | 权限 | 说明 |
| --- | --- | --- |
| `/AI群友 重置` | 群里需群管理员；私聊本人 | 清空本群或本私聊的聊天记录（她对人和群的印象保留） |
| `/AI群友 重置 全部` | BOT 管理员 | 一次清空所有群和私聊的聊天记录（印象保留），换人设后常用 |
| `/AI群友 用量` | BOT 管理员 | 今日和近 7 天的 token 用量与估算费用；群里只显示本群，各群明细只在私聊里列 |
| `/AI群友 重置用量` | BOT 管理员 | 本群或本私聊今天的额度从现在重新算，用量统计不变 |
| `/AI群友 上下文` | 群里需群管理员 | 下次请求占上下文的比例，人设规则、群信息、表情包目录、备忘、原文、末尾提示、看过的图各占多少 token（按上次实际输入折算的约数），缓存命中率、今日额度和精力；额度用完时会写明 |
| `/AI群友 记忆` | 群里需群管理员 | 她对本群和最近说过话的人的印象 |
| `/AI群友 记忆 删 QQ号` | BOT 管理员 | 删掉她对某人的印象（所有群共用） |
| `/AI群友 忘记我` | 所有人 | 删掉她对自己的印象 |
| `/AI群友 只回艾特 [开\|关]` | 群里需群管理员 | 本群是否只在被 @ 时回复；不带参数时查看当前状态 |
| `/AI群友 表情` | 群里需群管理员 | 列出收藏的表情包和使用次数 |
| `/AI群友 表情 看 名字` | 群里需群管理员 | 发出这张收藏的表情包 |
| `/AI群友 表情 删 名字` | BOT 管理员 | 删掉一张收藏（所有群共用），以后再看到同一张也不收 |
| `/AI群友 人设` | 群里需群管理员 | 当前人设和可选的预置人设 |
| `/AI群友 人设 看 [名字]` | 群里需群管理员 | 当前或某个预置人设的全文 |
| `/AI群友 人设 换 名字` | BOT 管理员 | 换成预置人设（大肥鱼、小埋），`默认` 回到配置里的；所有群生效 |
| `/AI群友 人设 改 名字 人设内容` | BOT 管理员 | 换成自定义人设，名字也算唤醒词；所有群生效 |

## 安装

在 WebUI 的插件市场安装，或由 Master 在聊天里 `/安装插件 persona_chat`。装好后默认不启用，`/启用插件 persona_chat` 即可加载。

## 配置

`config/tenko.toml` 的 `[plugin_config.persona_chat]`，也可以在 WebUI 的插件配置里修改。`api_key` 必填，只写在本机配置里，不要提交到任何仓库：

```toml
[plugin_config.persona_chat]
api_key = "sk-..."
```

在 WebUI 的插件配置里保存时，`base_url`、`api_key`、`sticker_limit` 以外的项就地换上，不重载插件，内存里的搜索次数、冷却、精力和正在等的跟聊都保留；改这三项（导入时就用掉了）会重载插件。直接改配置文件要重启才生效。

| 配置 | 默认值 | 说明 |
| --- | --- | --- |
| `base_url` | `"https://api.deepseek.com"` | OpenAI 兼容接口地址 |
| `api_key` | `""` | 接口密钥，为空时不应答 |
| `model` | `"deepseek-flash"` | 模型名 |
| `reasoning_effort` | `"high"` | 聊天回复的思考强度：`low`、`high`、`max`，留空不思考（DeepSeek 把 `medium` 当 `high`） |
| `wake_words` | `[]` | 除了当前人设的名字，消息含这些词时也当作在叫 bot |
| `persona` | `""` | 人设提示词，为空时用内置“大肥鱼”；只写人物本身，怎么当群友是通用规则。用 `/AI群友 人设` 换的预置或自定义人设优先 |
| `catchphrases` | `[]` | 人设里的梗和口头禅，她最近用过的会被点名让她别再用；为空且用内置人设时用内置的 |
| `context_tokens` | `32000` | 请求输入超过这么多 token 后把较早的聊天压成备忘，压回一半左右 |
| `batch_size` | `8` | 没在聊天时累计多少条新消息后考虑插话，`0` 关闭 |
| `follow_seconds` | `180` | bot 说话后多久之内每条新消息都考虑接话，`0` 关闭 |
| `quiet_seconds` | `3` | 主动说话前等群里安静多久 |
| `unprompted_interval_seconds` | `300` | 没在聊天时两次插话的最短间隔 |
| `user_cooldown_seconds` | `5` | 同一个人叫 bot 的最短间隔 |
| `stamina` | `15` | 精力：10 分钟内说多少句算累（1 小时按两倍），`0` 不限 |
| `vision_images` | `5` | 每次请求最多带几张新图给模型看，`0` 只用 `[图片]` 文字 |
| `search_daily` | `20` | 每个群或私聊每天最多上网搜几次，`0` 关闭搜索 |
| `sticker_limit` | `100` | 表情包收藏上限，所有群共用，`0` 关闭表情包 |
| `max_reply_chars` | `120` | 单条回复字数上限，超出时在句末截断 |
| `group_daily_tokens` | `200000` | 每个群每天的 token 上限（未命中缓存的输入加输出），用完后当天不再理这个群的消息、也不记录，`0` 不限 |
| `banned_words` | `[]` | 违禁词，含这些词的群友消息她看不到，含这些词的回复不发；不分简繁、全半角和大小写，忽略空格和标点，拼音 8 个字母以上的还按读音比 |
| `global_daily_tokens` | `0` | 全部会话合计每天的 token 上限，`0` 不限 |

请求关闭了 DeepSeek 的思考模式，人设和规则固定放在请求最前面以命中前缀缓存。`/AI群友 用量` 的费用按 `deepseek-flash` 官方价目估算（工作日 UTC 01–04、06–10 点为高峰价），换用其他模型时只看 token 数即可。

## 图标

`icon.png` 由 [Phosphor Icons](https://phosphoricons.com) 的 `fish`（fill）渲染而来，Phosphor Icons 以 MIT 许可证发布。
