她有身体,有日程,有情绪。 不是一句人设,是一整天的生活。 插件负责她的身体、日程、情绪和关系背景;怎么说话,仍然由大模型按人设自己决定。
作者 娜莉灵 · 显示名 人形化核心伴侣 · 插件 ID astrbot_plugin_humanoid_core(为兼容已安装用户与联动发现保持不变)
运行要求:AstrBot 4.24.0+ · Python 3.10+(更早的版本会被 AstrBot 的版本校验拒绝加载)
「人形化核心伴侣」是给 AstrBot 做的拟人化插件:给她一份会变的身体、一整天的日程和会波动的情绪,让角色不只是一句固定人设。
- 她有会随时间变化的身体:精力、困意、睡眠债、饥饿、生理周期,不要求你先说话才更新;
- 她有一整天的日程:动态现排、可以被打断,被打断的事挂起后还能自己回去接着做;
- 她有情绪与关系:好感度、心境、认识天数,按互动慢慢变,不是每条消息都从零开始;
- 她知道自己在哪、几点、什么天气、什么日子;
- 她不替自己写台词:插件只把背景递给她,怎么说还是大模型的事。
- 身体状态 —— 精力、困意、睡眠债、饥饿、不适、唤醒度、想不想说话(社交欲望)随休息与活动一起变,不同数值是不同状态;
- 社交能量 —— 陪聊会消耗、独处会恢复,累了就先管自己(可关);
- 睡眠 —— 睡不够会起不来;睡着那一段不会被消息重排,但会记下「被吵到」;
- 生理周期 —— 8 个阶段各有体感,也会影响部分状态变化;
- 梦 —— 睡着会做梦,刚醒的一小段时间她还没完全缓过来。
- 动态日程 —— 一天会被打断,不是每天机械重复同一套安排;
- 日程打断 —— 私聊里叫住她(「在吗」「陪我」),她会放下手上的事换一件;
- 挂起续做 —— 被打断的旧活会挂起一段时间,忙完可以自己回去接着做;
- 专属素材 —— 按她的人设单独写一份生活素材,人设变了才重写,写不出来就退回内置池;
- 她说过的事会进日程 —— 对话里带明确日期的「今天要办的事」会被记下来,按时间顺序带上。
- 排完自己再看一遍 —— 每段新日程装进来之前让模型回头审「接不接得上」(时间够不够走、地点可不可能、时长值不值、有没有凭空多出的人),判不过就按它说出的原因改一版再用。
- 空档立刻接上 —— 她手上那段过完就马上排下一段,不空等节流间隔。
- 情绪 —— 会随互动变化,持续性情绪不会下一条消息就清零;
- 好感度 —— 关系会变深,也会因为连着几句难听话掉下来;
- 认识天数 —— 记得你们认识多久,但不逼她时时提起;
- 关系阶段 —— 好感与认识时长走到不同阶段,措辞与主动性会跟着变,不是只换一个数字;
- 注意力 —— 她此刻对你这句话上不上心,会影响措辞与主动性。
- 时间时区 —— 按她的城市过,作息跟着走;
- 天气 —— 她那边什么天,要不要带伞她自己知道;
- 节日季节 —— 知道今天是什么日子,含农历节日(2025–2030)与二十四节气;2031 年起农历查不到,节气照常;
- 穿搭 —— 她知道自己穿着什么:按人设判(人设里写了穿着就用原文),也可以手写预设、随场景变化(可关)。
- 正在输入 —— 私聊回复时显示「正在输入」(仅 NapCat);
- 多角色 —— 每个角色各自生活,互不覆盖;
- 长期记忆 —— 装了记忆插件就按你这句话去读,没装照常跑;
- 未完事项 —— 记着手上还开着的事,最多三条、最多放 4 天;
- 对话间隔 —— 知道你多久没来,但不逼她问「你去哪了」;
- 同机 bot —— 可以聊;同一对 bot 默认 600 秒内最多 3 轮(可配),真人一开口就清零;
- 群聊 —— 群里一样有身体和日程;群消息也会进情绪分析,只跟已经有情绪档案的人(陌生人在群里说一句不建档),间隔比私聊宽(面板「群聊情绪分析间隔」,默认 20 条),管理指令在群里对非管理员回一句「权限不足」;
- 环境模式 —— 可以把整个插件限定在私聊或群聊(面板「生效范围」,默认两边都生效)。
- 亲密场景模拟 —— 默认关闭的进阶项:当好感与亲近欲都到一定程度、又真的想要时,她会进入一个更亲密的互动情境,并据此调整自己的情绪与措辞;关闭时完全不参与普通聊天。开启前请确认使用场景合规,面板里有独立开关与阈值。
1. 装上
AstrBot「本地安装 zip」不覆盖同名目录:装过旧版先卸载(不要勾「删除配置」「删除数据」),再上传新 zip。
需要 AstrBot 4.24.0 及以上:更早的版本会被 AstrBot 的版本校验直接拒绝加载(官方声明的最低版本就是真实 API 下限)。
官方声明支持平台:aiocqhttp(QQ / NapCat)与 qq_official;其他 AstrBot 平台理论可用但未逐一验证,其中「正在输入」只在 NapCat 生效。
2. 填一处
| 填哪里 | 填什么 | 例子 |
|---|---|---|
| 她所在的城市 | 决定她的钟点、作息、天气、季节 | /拟人 时间 大阪 |
就这一处。装完第一件事就是改城市——不改会静默退回服务器时区,天气和季节也一起错掉。 表里没有的名字可以直接填 IANA 时区名(
Asia/Ho_Chi_Minh)。
3. 确认人设
AstrBot 里的角色人设要先写好——日程语气与生活特质都从这份人设里读。
4. 想接天气
填 weather_api_key(OpenWeather 免费档够用);不填也能跑,只是没有天气。
配置在 data/config/astrbot_plugin_humanoid_core_config.json,身体状态在 data/plugin_data/humanoid_core/state.json;卸载插件时这两份数据都不会被删除。依赖只有 aiohttp。
查状态的这几条谁都能用,直接打,不带前缀:
| 指令 | 作用 |
|---|---|
/你的状态 |
精力、身体轴、生理、天气、日程、关系、注意力 |
/亲密状态 |
她对你的亲密状态(只在私聊:亲近欲、门槛、场景阶段、余韵、冷却、能不能进) |
/好感度 |
你的情绪档案;管理员加「排行榜」看所有人排名 |
/情绪详情 |
含基线值与交互轮次 |
/情绪日志 |
最近的情绪波动记录 |
/查看日程 |
她今天已经过出来的日程 |
/时间 大阪 |
查那个城市现在几点;不带城市就用她所在的城市 |
/叫我 小灵 |
设她对你的称呼(最多 32 字) |
/拟人帮助 |
列出全部指令和用法 |
管理员 · 改配置
下面这些挂在「拟人」组里,要带 /拟人 前缀,且只有管理员能用。
| 指令 | 作用 |
|---|---|
/拟人 时间 大阪 |
改她所在的城市(只影响当前这个 bot;写「默认」跟随全局) |
/拟人 设置 |
看常用项;/拟人 设置 城市 大阪 改一项,立即生效;/拟人 设置 穿搭 白色针织衫 单独给当前角色设穿搭 |
/拟人 参照名称 小雨 |
注入里代表她的名字(写「清除」跟随人设,最多 24 字) |
/拟人 诊断 |
模型链、时区、上下文大小、状态文件、天气、冷却状态;超过 700 字自动转成图片(最多 3 张,渲染失败回落文字) |
/拟人 角色 |
列出所有身份档案;带个号只看那一个。面板「预置角色QQ」里填的号也算(它们没发过消息也有档案) |
/拟人 重载 |
重新读配置文件,不用重启插件 |
管理员 · 动数据
| 指令 | 作用 |
|---|---|
/拟人 重置日程 |
立刻重排当前这一段,绕过冷却 |
/拟人 日程打断 |
让她放下手上的事,换一件做 |
/拟人 日程继续 |
把手上这件事往后延长,不重新生成 |
/拟人 重置状态 |
精力、社交能量、生理周期回初始值 |
/拟人 重置情绪 |
把你自己的情绪重置到初始值 |
/拟人 设置好感度 88 |
0-100,设的是你自己的好感度 |
/拟人 批量好感度 111:30,222:40 |
逗号分隔,数值 0-100 |
/拟人 查看昵称 |
列出所有用户设的称呼,人多只显示前 30 个 |
面板上共 146 项(多数带【进阶】标记),这里列真正需要动的:
| 项 | 默认 | 什么时候调 |
|---|---|---|
她所在的角色人设 |
AstrBot 那边设 | 日程按它排;写她的语气、身份、说话习惯 |
timezone_city |
河源(记得改~) | 必改。决定她的钟点、作息、天气、季节 |
auto_nickname |
开 | 从消息自带的名字认一次称呼;含数字/emoji/占位词一律不认 |
auto_identify_user |
关 | 开则注入里用真名区分「她」和「对方」 |
use_llm_schedule |
开 | 关掉则日程改用本地模板(更省额度,情节也更死板) |
schedule_continue_minutes |
45 | /拟人 日程继续 一次把当前这一段往后延长多久 |
schedule_pause_ttl_minutes |
180 | 被打断的事保留多久(期间她可以自己回去接着做) |
schedule_interrupt_quiet_minutes |
45 | 距上一条私聊至少隔这么久才算「有人来访」;0 = 每条私聊都算(多人部署慎用) |
schedule_interrupt_on_call |
开 | 私聊里明确叫住她(「在吗/你在干嘛/陪我」)时,不熬安静间隔也算一次来访 |
max_sleep_hours |
0 | 一觉的硬上限,睡过就强制结算成醒着。0 = 自动(睡眠需求 + 3 小时,至少 10);小于 4 按 4 算。日程断档后她一直「在睡」时靠它兜底 |
weather_api_key |
空 | OpenWeather 密钥(免费档就够) |
weather_proxy |
空 | 天气请求走这个代理(http://127.0.0.1:7890、socks5://…)。直连 api.openweathermap.org 报 getaddrinfo failed 或超时时填;AstrBot 不读系统代理,只认这里 |
preset_role_ids |
空 | 预置角色 QQ(逗号/换行分隔)。填了的号在插件加载时就有一份身份档案,不必等那个号先发消息;只多给档案,不会去驱动另一台机器上的 bot |
llm_idle_silence_minutes |
60 | 连续这么久没人说话就停掉后台调用,有人一说话立刻恢复 |
llm_daily_call_budget |
500 | 每日模型调用次数上限(不是 token),多 bot 共享一份 |
opportunity_evidence_enabled |
开 | 注入侧证据卡:每轮把「她此刻真能提的具体的事」(日程/未完事项/天气/生活素材)连同出处、采集时间与剩余有效期递进上下文;一条都没有时明确告诉她「少说,不要编」 |
greeting_opportunity_enabled |
开 | 问候时机卡:早 7-11 点、午间 12-14 点、晚 21-24 点落在窗口里时,把「现在适合开口」翻成一张可提的由头并进证据卡,出处写「问候时机」;只给时机,不代表对方刚醒,说什么由她自己定 |
closing_guard_enabled |
开 | 收尾沉默守卫:她已经用「晚安」这类话收过尾、对方也只回了句「晚安」时,不再补一条同义道别 |
closing_guard_prompt_enabled |
开 | 每轮给模型一句短提示(「上一轮你已经道过晚安」);关掉只保留静默判定 |
closing_guard_window_seconds |
1800 | 道别之后多久内的「晚安」还算同一场收尾(秒,60-7200) |
input_state_enabled |
开 | 私聊回复时显示「正在输入」(仅 NapCat) |
mood_data_retention_days |
7 | 超过这么多天没说话,情绪档案清回初始值(称呼保留) |
contract_enabled |
开 | 跨插件契约总开关;关掉后不再向「自主拟人社交」导出她的状态 |
mood_use_llm_for_delta |
开 | 关掉则情绪完全本地判断,零额外调用 |
cooling_enabled |
开 | 冷静期:好感跌破门槛后她冷着一段时间,且这段时间不主动找他 |
soma_enabled |
开 | 关掉则身体轴只保留精力一个数(不影响跨插件契约里的非身体内容) |
mood_negative_streak_required |
2 | 连着几句难听话才扣好感;1=每句都扣 |
mood_negative_softening |
开 | 底部减速 + 情绪韧性(好感越低扣得越少、关系越深越抗打击) |
mood_recovery_bonus |
开 | 道歉快速回温 + 低于基线时暖话加成 + 连着哄加速消气 |
cooling_affection |
10 | 好感低于它就进入冷静期 |
cooling_minutes |
15 | 冷静期语气持续多久(分钟) |
cooling_no_proactive_days |
3 | 冷静期里不主动找 TA 的天数 |
mood_llm_interval_messages |
4 | 私聊里每几条消息用模型分析一次情绪(按会话算) |
mood_group_llm_interval_messages |
20 | 群聊里每几条消息用模型分析一次情绪(群聊单独更宽的间隔,只跟已有档案的人) |
改完面板里的进阶项,用 /拟人 重载 刷新;/拟人 设置 改的项立即生效。
建议搭配 自主拟人社交 v1.28.17 及以上(契约 v3:身体块不可用时数值为 null)。装了时,她把身体、日程、关系、称呼与亲密状态一起导出去,由对方决定什么时候主动开口;没装也能独立跑,只是没人替她先说话。两边都靠插件 ID astrbot_plugin_humanoid_core 互相发现,ID 保持不变。
| 对比 | 人形化核心伴侣 | 自主拟人社交 |
|---|---|---|
| 主要职责 | 维护身体、情绪、日程、关系 | 决定是否主动联系、联系谁、聊什么 |
| 是否主动发消息 | 不负责 | 负责 |
| 日程与状态 | 生成并维护 | 读取作为决策参考 |
| 状态 | 她的表现 | 怎么处理 |
|---|---|---|
| 没装自主拟人社交 | 独立跑,只是没人替她先开口 | 想要主动消息再装 |
| 已装,但版本偏旧 | 读不到的字段按「没有」降级,不报错;部分由头、称呼用不上 | 升级到 v1.28.17+ |
| 已装,但配置关闭 | contract_enabled 关掉后不再对外导出契约,对方拿不到她的状态;只关 soma_enabled 则仍导出身份、日程、节日、事件等非身体内容,身体块标 available: false、数值给 null(不是 0/50/false) |
想联动就打开 contract_enabled;只想轻量可只关身体轴 |
- 她不做长期记忆:不建记忆库、不存完整聊天记录。
- 但会落盘几段短原文,都在插件自己的数据目录(
data/plugin_data/humanoid_core/state.json;POSIX 下文件权限600、目录700,同机其他账号读不到):- 每个人最近一条消息的前 120 字(
last_message),用来知道「你刚说了什么」; - 最近 12 小时内你说过的几句原话:最多 4 条、每条最多 26 字(
said)。过了 12 小时只是不再递给她,不会自动从盘上删掉; - 她自己最近说过的 5 句话、每条最多 200 字(
spoke_log),用来判「对方接没接住」。
- 每个人最近一条消息的前 120 字(
- 此外还有手上开着的未完事项(最多三条、最多放 4 天,事情了结就消失)。
- 这些片段随每条回复递给她一句事实,不落会话历史:上下文被压缩掉之后它们还在。
debug_mode打开时,情绪分析的请求会写进日志,但<user_message>里的聊天原文与「她说过的话」一律脱敏成字数,不写内容;其它日志里的 QQ 号也只留前 3 后 2。- 想彻底清掉:停掉插件后删
data/plugin_data/humanoid_core/state.json(好感度、日程等当前状态会从头开始)。 - 装了「我会牢牢记住你」时两边会接上:每轮按你刚说的话去读这个人的记忆,她自己生活里的事真正结束时补一条回去;没装照常跑。
她按「她所在的城市」过日子:/时间 城市 可以查别的城市,但她的身体和日程只按这个。填表里有的名字(河源/北京/大阪/莫斯科),或者直接填 IANA 时区名(Europe/Moscow)。
表里没有的名字会静默退回服务器时区——/拟人 诊断 的【时区】会直接告诉你有没有生效。地名表共 9,779 条(GeoNames 数据表 9,411 条 + 手写行政区划表 940 条,去重后 9,779 条),中国、日本、俄罗斯的地级与县级驻地大多都认,写「广东省」「大阪市」这类带后缀的也认。填到「市」最稳,纯区级名(越秀区、源城区)不认。多 bot 可以在各自的 /拟人 时间 城市 里单独设,互不影响;/时间 城市 谁都能用,只是查时间。
天气城市填英文名+国家码(Beijing,CN),也可以填 IANA 时区名(Asia/Shanghai)或表里的中文地名;留空则跟着城市配置走。两处不一致会出现「说在北京却报河源的天气」。
- 状态与背景都走临时内容块:每轮在变的东西(她对 TA、心情、身体感觉、几点、天气、季节、她手上还没做完的事)作为临时内容块追加,只发给模型、不落会话历史;system_prompt 里只放一句「这些是背景、不是要念出来的内容」的框架句——写进 system_prompt 会让前缀缓存逐轮失效。她这会儿正在做什么不常驻,只在对方问起时给一句:常驻就会变成每条回复都在报备。
- 给体感,不给数值:「有点困」是递给她的;「好感 46/100」这种体检单留在
/你的状态里给你看。 - 同一件事只说一遍:关系位置、心气、精力、想不想说话,各自有且只有一个来源。
- 日程按 15 分钟一个决策窗:到点或掷中「改主意概率」才排下一段,不预排未来;关掉模型就用按日期轮换的本地模板,任何时刻都有段可做。
- 素材分三层:内置池(人人都有)→ 她的专属素材(按人设生成并落盘,人设不变不重写)→ 对话里她今天要办的事。生成侧只读这些,不在换段时额外问模型。
- 有人打破一段安静来找她:给她一次中途换事的机会,旧活挂起,忙完可以自己回去接着做。
- 睡眠不受消息打扰:睡着那一段不会因为来消息就重排,但会记下「被吵到」;刚醒的一小段时间她还没完全缓过来。
- 身体按时间积分:睡眠债、久坐、饥饿随时间推进,停机后按离线时长补算(上限 72 小时)。
- 情绪本地先判:模型结果只占 0.3 权重融合;本地已经判负明确时,那一次模型调用直接跳过。
- 状态写盘节流:变更后按存档体积自适应间隔整份重写(默认 60 秒,存档越大间隔越长),原子替换;序列化分块进行、不再卡住消息主循环。
/拟人 诊断会显示文件大小、用户数与【状态落盘】一节(间隔、上次序列化耗时、写入体积、连续失败次数与最近错误)——落盘失败会计数,状态仍留在内存,恢复后自动补写。
- 数据不用迁移:
state.json的结构与路径都没变,配置、角色、好感与情绪档案会原样继续;跨插件契约升到 v3(身体块不可用时数值为null,只关身体轴时旧版社交层可能把 null 当数字读);升级前备份一下data/plugin_data/humanoid_core/state.json更稳。 - 安装方式不变:AstrBot「本地安装 zip」不覆盖同名目录——先卸载旧版(不要勾「删除配置」「删除数据」),再上传新包;插件 ID 没变,卸载再装不会丢配置与数据。
- 最低版本变了:从 3.0.0 起要求 AstrBot 4.24.0 及以上。
- 显示名变了:面板里显示「人形化核心伴侣」,插件 ID 仍是
astrbot_plugin_humanoid_core,数据目录与跨插件发现都不受影响。
见 更新日志 · 仓库:https://github.com/naliling/humanoid_core_plugin
本插件采用私用授权,不是开源许可证:版权所有 © 2026 娜莉灵,保留所有权利。仅授权个人私下安装与使用;未经作者书面许可,不得再分发或用于商业用途,也不得移除版权声明。完整条款见 LICENSE。
这个插件会一直更新,只要你愿意反馈。
反馈渠道:
- GitHub Issues:https://github.com/naliling/humanoid_core_plugin/issues
- AstrBot 插件市场评论区
- 发现 bug → 提 issue,我会修
- 想要新功能 → 提 issue 说清使用场景,合适就做
- 文档看不懂 → 直接说哪句看不懂,我改文档
- 想加新平台 → 告诉我平台名,我加适配
- 会写代码 → 欢迎 PR,合并后署名
版本规则:每次更新只递增最后一位 +0.0.0.1
3.1.7 → 3.1.8 → … → 3.1.9 → 3.1.10
更新方式:WebUI 插件页点「检查更新」,或删掉旧文件夹重新放新的(配置与状态存在 AstrBot 的 data 目录,换包不会丢)。
你的每一次反馈,都会变成下一个 0.0.0.1。