熟悉,不一定亲近。亲近,也可以有所保留。
为 AstrBot 的长期群聊保留相处的痕迹,让当前人格决定如何表达。
快速开始 · 三维关系 · 关系词典 · 管理面板 · 能力与限制
v0.8.1 · AstrBot ≥4.28 · OneBot aiocqhttp · AGPL-3.0
Bond 是面向 长期多人群聊 的关系记忆插件。它分别记录 Bot 对每位成员的熟悉度、亲近度与信任度,将三维状态转成自然语言描述,供当前人格在回复时参考。
关系可以随群聊互动更新,也可以在管理面板里查看、调整、撤销或设置限时覆盖。每份关系资料都属于对应的 Bot 账号与数据空间;群内公开查询只显示关系称谓,不展示具体分值。
可选联动:在「信任度变化」开启「根据反注入复核结果调整信任度」,保存并重载 Bond,再开启 AntiPromptInjector 4.2.0 的群聊防护报告。模型确认且能归责于发言人的防护事件只影响信任度,沿用当前 Bot 的关系空间和每日下降额度。联动默认关闭,不需要开启 Bond 的自动评估,也不额外调用模型。见本版更新。
其他插件可以使用进程内接口查询关系称谓、排行,或提交群聊互动供 Bond 评估。
初次安装默认在回复中体现关系,自动评估、动态称谓和诊断记录默认关闭。 启用自动评估前,先在管理面板选择日常评估模型。已有配置中明确关闭的回复参考会继续保留。可先试用查询和管理功能,再按需开启自动评估。
| 特色 | 你会用到的能力 |
|---|---|
| 三维关系,分别记录 | 熟悉度、亲近度、信任度各自计算,可以同时表达“亲近”和“戒备”。 |
| 76 个中文关系词条 | 在初识、渐熟和亲近阶段细分表达,也能描述熟悉却疏远、亲近却戒备等关系。 |
| 可选动态称谓 | 根据完整人格和三维关系生成个性化称谓,保存后复用;查榜不额外生成称谓。 |
| 表达沿用当前人格 | 词条提供理解线索,Bot 不必照读标签,也没有预设的冷淡或热情答法。 |
| 每个 Bot 有自己的关系 | 按真实 Bot 账号独立存储;群内关系与全局关系分开管理。 |
| 关系可查、可调、可撤销 | 管理面板保留变动流水,支持正式调整与限时体验,临时关系结束后恢复正式值。 |
| 可选诊断,方便验证 | 本机记录脱敏的变化、称谓与调用情况,帮助排查漂移和失败,不额外调用模型。 |
三个维度负责计算,关系词典负责解释,当前人格负责表达。
| 维度 | 描述什么 | 从低到高的五档 |
|---|---|---|
| F · 熟悉度 | 有多熟悉 | 陌生 → 眼熟 → 相识 → 熟悉 → 熟络 |
| A · 亲近度 | 相处时的亲疏 | 疏远 → 疏淡 → 平和 → 亲近 → 亲密 |
| T · 信任度 | 放心还是戒备 | 戒备 → 谨慎 → 保留 → 放心 → 信赖 |
熟悉度范围为 0..100,亲近度与信任度为 -100..100,三者不合成一个总好感分。初始三维均为 0 时,对应档位为「陌生 + 平和 + 保留」,关系称谓为 陌生。分档用于描述状态,不是经过心理学校准的概率。初期少量有效交流即可从“陌生”走向“眼熟、相识”;熟悉不等于亲近,更不等于信任。
眼熟模式让 Bot 对同群活跃成员逐渐积累熟悉度。有人明确 @ 当前 Bot 时,默认按以下规则处理:
- 从同群最近 10 分钟的发言者中,选取最近发言的 3 位其他成员。
- 每人增加最多 0.3 F,每 30 分钟最多一次,通过此方式最多增长到 60 F。
- 与直接互动共用每日 F 加分额度;不套用阶段倍率或 Galgame 单次加分倍率,但保留 Galgame 的每日总额度。
这五项参数可在「详细设置 → 熟悉度变化」中调整,位于熟悉度每日扣分上限之后。人数设为 0 时不限制人数,仍只选时间范围内的成员。选中的人若处于冷却、额度不足或已达上限,会跳过本次奖励,不向更早的成员补位。
被动增长不刷新任何维度的保温时间,不增加亲近或信任。超过被动上限的 F 仍按原规则衰减,该上限不是衰减下限。当前 @ 成员不领取本次被动奖励,仍按既有规则处理直接互动。仅回复 Bot、文字唤醒及 @ 其他成员不触发被动奖励。
新安装或缺少配置时默认开启,已有开关选择会保留,可在「基础设置」中关闭。眼熟模式独立于自动评估,不增加模型调用,只记录成员身份和最近发言时间。重启后重新积累活跃成员,但仍保留已发奖励的冷却与去重记录。
流水来源显示为「群聊活跃」,同次触发合并显示。列表最多预览 3 人,详情可查看全部成员并分别撤销。详细规则与验证范围见 眼熟模式说明。
| 词典中的状态 | 它保留的细节 |
|---|---|
| 陌生 | 初始默认状态(三维均为 0):尚不熟悉,亲疏态度平和,信任有所保留。 |
| 亲近却戒备 | 有亲近感,也有明确戒心;亲近不会抵消边界。 |
| 疏远但信赖 | 不够热络,仍可以保有较强信任。 |
| 亲密而保留 | 已经熟悉且亲近,信任上仍有所保留。 |
| 亲密挚友 | 熟悉、亲近和信任均较强,仍不改变人格原则或权限。 |
这些词条表示并列的关系组合,不是一条逐级升级的路线。完整映射与局部细分见 关系词典,动态称谓规则见 评估框架。
在亲近度与信任度保持平和、保留时,熟悉度增长可以依次呈现:陌生 → 眼熟之人 → 浅交之人 → 泛泛之交 → 寻常相识 → 相熟之人 → 普通熟人 → 熟络之交。前期在 F 达到 1、3、5、8 时就有不同表达;这只是这一组关系的示例,不代表聊天越多就必然成为朋友。
三维仍各分五档,共有 125 格主状态。部分组合另设 F 为 3、8、20 和 A 为 25 的局部展示边界,让同一主档位内也能呈现变化。
默认使用 固定词典,不增加模型调用。想让称谓贴近 Bot 的气质,可在 AstrBot 插件设置中开启「动态称谓」,或进入 Bond「详细设置 → 个性化功能」开启同名开关。两个入口共用设置,与 Realistic / Galgame 的关系增长模式分别控制。称谓模型留空时跟随复核模型,也可单独指定;两者都未配置时继续使用固定词典。
动态称谓根据当前会话的完整人格和三维关系生成,经过校验后保存。按群记录时可参考本群印象,全局关系空间不使用跨群汇总的印象。亲近却戒备、熟悉但疏远等关系也可生成称谓。缺少完整人格、生成失败或校验未通过时,沿用仍适用的已保存称谓,否则显示固定词典。
成员实际互动时,若任一维度跨过 5 分边界,便会检查是否可以刷新。默认两次刷新尝试至少间隔 12 小时,每 Bot 每个 UTC 日最多 30 次模型调用;每次刷新最多尝试 3 轮,通过后即停止。生成、校验、失败和重试均计入次数,额度跨群和数据空间共用。可延长间隔、降低日上限,或将日上限设为 0 暂停;单次调用默认超时 30 秒。
查询和排行只读取已保存且仍适用的称谓,不触发生成。人格改变、关系含义不再匹配、来源撤销或临时关系切换后,旧称谓会停用。称谓刷新与印象更新分别进行;缺少明确会话的管理页面和跨插件查询使用固定称谓。
关闭动态称谓后,改用固定词典并保留已保存的结果。再次开启时,可继续使用仍适用的称谓;需要更新时先显示固定词典,等下次互动跨过分数边界、且满足间隔和额度要求后再刷新。
「在回复中体现关系」开启时,Bond 会给回复模型补充关系资料,保留原有的人格设定、用户输入和对话历史。系统不要求模型披露或照读称谓,具体如何回应由当前人格、系统规则和对话语境决定。
默认回复指导将三维状态分别用于相处方式:熟悉后减少客套、接续有依据的话题;亲近后更多回应心情,表达欢迎、欣赏或在意;信任影响对模糊意图的理解,不改变事实核对与权限。克制的人格可以更耐心、留意细节,活泼的人格可以更自然地分享喜悦和打趣。亲近但戒备、疏淡却信赖也分别表达,不统一变成热情或服从。普通求助仍认真帮助,高关系仍可拒绝或不悦,不强制恋爱和固定台词。已有自定义行为模板会保留,只有选择默认模板才使用新版默认文案。
Bond 通过 AstrBot 的标准请求钩子追加当前发言者的关系资料,不决定是否接话、回复对象或回复频率。休息、离场及模型选择继续由宿主或相应聊天插件负责。追加资料和保留系统提示的上下文改写可以共同使用;若其他插件绕过请求钩子,或在 Bond 运行后覆盖整个系统提示,关系引导可能无法到达模型。效果还取决于当前人格、模型和语境,不能保证任意插件组合下每条回复都表现差异。
普通群消息会先读取当前关系、印象和近期事件,再启动后台评估。同一条消息的重试或后续工具调用继续使用这份资料,下一条消息才重新读取。因此,本轮评分不会反过来影响本轮回复;角色仍可直接回应眼前的玩笑、求助或冒犯。第三方主动发起、绕过普通群消息入口的请求,只能在首次生成回复时读取资料;无法确认 Bot 和成员身份时不补充关系。
自然语言工具提供的是 当前 Bot 对成员的关系,不能据此推断成员对 Bot 的感受,也不能回答群友之间谁最喜欢谁。唤醒、接话与主动发言仍由 AstrBot 或 Angel Heart 等插件决定。
- 使用 AstrBot
>=4.28和aiocqhttp;真实框架装配验证覆盖4.28.0、4.29.4,Python 版本跟随宿主要求。后续版本可加载,兼容性以实际框架验证为准。 - 在 AstrBot 的插件管理中通过本仓库地址安装;也可下载 main 的 ZIP,解压到
data/plugins/astrbot_plugin_bond/。插件目录必须全小写。 - 重载后打开 Bond 管理页面,在「详细设置 → 基础设置」先手动选择日常评估模型(不自动跟随聊天模型),再按需开启自动评估,填入适用群与需要忽略的机器人账号。在「个性化功能」中调整回复参考与动态称谓。尚未发现 Bot 时也可完成这些设置。
- 在「详细设置 → 基础设置」选择关系模式,在「关系变化」调整基础参数;新安装默认为 Galgame。保存并重载后生效。连接 OneBot 后点击“刷新 Bot 列表”,选中需要管理的 Bot 与数据空间。
插件列表左侧与 README 使用同一版 Logo。更新插件后重载并刷新插件页面即可;手动安装时请保留根目录的 logo.png。
Bot 账号来自平台连接或可信消息事件;一个适配器可以包含多个账号。私聊可帮助登记 Bot,但不会建立关系记录。仅填写适配器配置、尚未连接或收到事件时,列表可能没有可识别的账号。
在已启用 Bond 的群聊中发送:
| 命令 | 权限 | 用途 |
|---|---|---|
/我的关系 |
所有群成员 | 查看当前 Bot 对发言者自己的关系称谓,始终保留原有行为。 |
/我的印象 |
所有群成员,需开启 | 按设置返回关系称谓,或结合当前人设生成一句话印象。 |
/好感排行 |
按配置(所有人 / 仅主人) | 查看本群前 10 名的昵称、头像与当前关系,按亲近度排序,不显示分值。 |
在 AstrBot 插件配置或 Bond「详细设置 → 查询与排行」中设置“我的印象”:默认关闭;“输出关系称谓”仅返回称谓;“大模型总结”使用当前会话聊天模型和人设,结合关系称谓、标签与已有印象生成一句话,超时、异常或无有效回复时回退关系称谓。
“你对我有什么印象”“你觉得我怎么样”“你对我的感觉如何”等问法由聊天模型识别后调用 query_my_impression,仍需宿主正常接话并支持工具调用;需要确定入口时使用 /我的印象,仅查关系称谓可继续使用 /我的关系。本功能只查发问者本人,不更新关系或存储生成结果。总结会将当前人设及上述关系资料发送给当前聊天模型,不发送分值或原始流水;同一 Bot 的全局空间只使用共享关系称谓,不带入其他群的标签或印象。
管理员快捷命令
| 命令 | 权限 | 用途 |
|---|---|---|
/好感设置 <QQ号> <数值> |
宿主管理员 | 设置指定成员在当前空间的亲近度(好感度),支持一位小数与负值。 |
/好感重置 <QQ号> 或 /好感重置 全群 |
宿主管理员 | QQ号重置当前空间的指定成员;仅按群空间可用 全群 清空本群关系数据。省略参数只提示用法。 |
/关系设置 <QQ号> [类型] |
宿主管理员 | 设置或清除指定成员与当前 Bot 的关系标签(类型留空为清除)。 |
/印象设置 <QQ号> [标签1,标签2] |
宿主管理员 | 手动设置或清除成员标签(最多 3 个,每个最多 6 个字符,逗号分隔,留空清除)。 |
/印象刷新 <QQ号> |
宿主管理员 | 立即根据最近未汇总的评估记录刷新该成员印象。 |
排行最多展示 10 人,默认使用八千代月读空间风格图片,右上角从九款无文字角色插图中随机选择,插件运行期间避免连续同款。昵称缺失时显示“未命名成员”,不会用账号替代昵称。可在「详细设置 → 基础设置」选择 所有人 / 仅主人,或关闭图片改用文字。仅主人模式按 Bond「主人 QQ」名单与可信发言者账号匹配,未配置时无人可查;斜杠命令、文字唤醒和模型工具共用权限。权限限制谁能发起查询,不能阻止群内成员看到或转发已经发送的榜单;它不授予任何管理权限。
合成昵称与头像示例,非真实群聊资料。
/我的关系 对所有群成员开放;/好感排行 遵循配置的查询权限,直接返回公开资料。自然语言询问由当前人格组织表达,不强制复述关系称谓。聊天查询不展示具体分值、私有证据或其他群资料。
| 想要的效果 | 设置方法 |
|---|---|
| 互动后自动评估关系 | 在「详细设置 → 基础设置」手动选择日常评估模型与评估模式,再开启自动评估;复核模型可留空。 |
| 回复时参考当前关系 | 在「个性化功能」调整「在回复中体现关系」,新安装默认开启。它与自动评估分别控制,也可配合手动设定的关系使用。 |
| 使用个性化称谓 | 在「个性化功能」开启「动态称谓」,模型默认跟随复核模型。 |
| 只在指定群使用 | 填写 group_whitelist;留空表示所有群。名单外不记录、不评估、不注入,也不响应 Bond 群聊查询。 |
| 观察规则与称谓的运行 | 在“详细设置 → 关系诊断”打开诊断记录。 |
自动评估在后台进行,不阻塞正常回复。Bond 页面保存基础与详细设置后需要重载插件;提示词保存后立即生效。 AstrBot 原插件配置也可编辑同一份配置,宿主保存时会自动重载。切换编辑入口后先刷新,避免提交另一处已过期的表单。自动评估需要调用你选择的模型,会产生相应用量。用量统计缺失时显示未知,不估算货币成本。
印象更新频率由 impression.interval 配置(默认 8):
- 哪些记录计入累计:仅统计上次汇总之后未汇总、未撤销的有效自动评估流水(其中包含因每日额度等限制而写入的零变化评估流水)。已撤销的流水不参与,管理员手动调整不计入;这不是聊天消息条数或模型调用次数,不是每聊 8 句就更新。
- 何时尝试更新:在一次自动评估实际更新关系后进行检查;当累计的有效自动评估流水达到
impression.interval(默认 8 条)时,启动后台任务生成印象。 - 群空间与全局空间:按群记录(
per_group)时,每个群分别积累;全局空间(global)中,同一 Bot 对同一成员的跨群评估记录共同积累,同样支持自动更新印象(但 Bond 不支持私聊关系记录,也不会因此在群聊回复中公开其他群的印象或历史)。不同 Bot 和不同数据空间相互独立。 - 两种记录模式:默认的一句话模式同时更新印象和标签,标签最多 3 个;分点模式(
impression.points_mode)更新印象要点并保留已有标签。模型不可用或生成失败时,保留原内容和待汇总记录。临时关系期间暂停自动更新。
AstrBot 插件配置与 Bond「详细设置 → 查询与排行」共用我的印象、排行权限、图片排行、显示人数、文字查榜与唤醒短语设置,保存后重载插件生效。AstrBot 插件配置保留启用、模型、适用范围和排行等常用选项。三维变化、印象与回复、评估高级参数放在 Bond 页面中,日常使用可以保留默认值。
新安装默认 Galgame,回复参考默认开启。自动评估默认关闭:先选择日常评估模型,再按需开启。
模型判断互动性质、指向、上下文与语义重复;Bond 校验身份、协议和当前原文证据,再执行本地数值规则。普通有内容问答可以增加熟悉度,不自动增加亲近度。信任来自可观察的可靠行为:有记录确认的纠错、履约和实质修正,可逐步建立或修复信任;感谢、示好、承诺和道歉本身不加信任。
纠错、履约和实质修正的可信事件基础增加 0.5 T,Galgame 下为 1 T。明确越界、重复实质施压、可证实的蓄意误导、严重操纵分别按 −1 / −2 / −4 / −6 T 处理,仍受每日额度限制。普通冒犯与普通操纵只影响原有亲近度判断,T 为 0。正常批评、无害玩笑不应被当作破坏信任。一次道歉不能抵消严重失信,后续独立的可靠行为可以慢慢修复。
持续尊重边界也能积累信任。 明确边界后,14 天内至少有 3 件独立、可核验的遵守行为,可获得基础 +1 T(Galgame 为 +2 T),每 5 天最多奖励一次。同一件事的重复表述不累计,奖励仍受每日额度限制。
自动信任变化需要选择分级复核并配置复核模型。两次判断须一致,并引用本群、当前成员上下文中实际记录的 Bot 回复;缺失记录、证据不完整或无法复核时不计 T。同一已确认事项的重复补述不重复计分。模型仍可能误判,引用存在也不等于现实事实已被验证;管理员可查看证据并撤销流水。
| 每日互动额度 | 基础模式 | Galgame(默认) | 两种模式扣分额度 |
|---|---|---|---|
| 熟悉度 F | +5 | +10 | 0 |
| 亲近度 A | +10 | +20 | −8 |
| 信任度 T | +2 | +4 | −8 |
Galgame 将所有正向请求和正向每日额度统一乘 2;负向单次变化、负向额度、模型、调用次数与衰减不变。正负用量独立累计,加减不能抵消已用额度;撤销恢复分值,不退还已消费的互动额度或调用次数。自动时间衰减不占扣分额度。切换模式不翻倍旧分数、不重算历史、不清空当天用量。
越熟悉,积累速度越平缓。 熟悉度按六个数值区间调整增长倍率,与关系词典的五档独立;具体倍率见上图。亲近度保留等级倍率与同日加分递减。微小的有效变化会保存,页面显示一位小数。
关系保温期默认 5 天。 超过保温期后,关系才开始随时间淡化;设为 0 可取消保温期。三个维度分别计时:普通问答只维护熟悉度,亲近和信任需要各自的合格事件。因此,即使熟悉度一直在增加,长期没有信任事件时,超出基线范围的信任仍会衰减。
合格互动会重置对应维度的计时,不恢复此前已淡化的分数。被规则拒绝或每日额度用尽的事件不延长保温期;如果事件本身合格,只是增量太小而被舍入为零,或分数已达到上限,仍可维护对应维度。三个维度都只计算超过 decay.grace_days 的时间。
decay.maintenance_strategy 默认 independent;legacy 保留熟悉度和亲近度的联动保温,信任始终只由合格可信事件维护。手动切换维护策略仍沿用既有结算机制,不补发保温期,也不重算历史奖励。成员详情的“最近互动”按三个维度最近的真实维护时间显示。
默认半衰期为熟悉度 30 天、亲近度 30 天、信任度 60 天,默认基线分别为 10、0、20。开启亲近度档位托底(decay.floor_enabled,默认开启)时,按当前亲近度所在等级(厌恶 / 陌生 / 认识 / 友好 / 亲密 / 挚友 / 挚爱)向下两级的下沿计算衰减下限(例如「挚爱 95」最多衰减到「亲密」下沿 55);托底只影响亲近度,不保证三维关系称谓保持不变。每维的开关、半衰期与基线都可在详细设置的“熟悉度变化”“亲近度变化”“信任度变化”中调整;共用的关系保温期与额度换日时区位于“基础设置”。
基线是衰减的停止范围,不是自动赠送的分数。熟悉度高于基线(默认 10)时随时间向基线下降,低于或等于基线时保持不变;亲近度与信任度使用正负对称范围。例如信任基线设为 20,+40 在保温期结束 60 天后约为 +30,−40 约为 −30,之后继续向 +20 / −20 收敛;低于 −20 的信任可向 −20 回升,−20~+20 内保持不变,但时间流逝不会把负信任变为正信任。临时关系期间暂停三维正式衰减;修改参数并重载后,对已有成员也使用当前设置。
评估次数与上下文范围
默认每位成员在同一 Bot 下每 5 分钟最多初评 5 次,每天初评 30 次、复核 8 次;每个 Bot 每天初评 300 次、复核 100 次,插件同时最多评估 2 人。调用额度跨群及数据空间共享,失败和超时也计入次数;调用日额度按 UTC 日期刷新。
评估默认参考最近 6 条相关发言或回复,以及 7 天内最多 8 条同群已计分摘要,总长不超过 4000 字符。只使用当前成员与 Bot 的相关互动,不监听完整群聊;历史内容不能重复计分,语义判断仍可能出错。
在「详细设置 → 基础设置」选择关系模式,在「关系变化」按熟悉度、亲近度、信任度分别调整参数;在「评估」调整窗口、预算、并发与上下文。点击 「恢复此区默认设置」 只将默认值填入当前设置分区,检查后保存并重载生效,不会清除模型选择、成员状态或流水。已有明确保存的模式与参数继续保留,重装保留配置也不会自动替换旧值。评估是否合适仍受接入模型影响,建议固定模型与人格观察 2–3 天。
升级、精度、额度与回滚说明见 关系评估框架。
Bond 使用 AstrBot 原生管理页面,写操作由宿主认证保护。每次进入页面时自动跟随 AstrBot 当前的浅色/深色主题;点击右上角主题按钮可在本次打开期间临时切换浅色或深色,不会记住上次选择。设置分组默认折叠,字段旁的问号解释用途。
以下截图来自实际管理页面,Bot、群、昵称、QQ 号、印象和流水均为合成演示数据。
当前总览 · 浅色
当前总览 · 深色
成员详情 · 浅色
当前总览顶部的“今日概览”显示所选 Bot 的初评、复核次数与运行配额,以及当前数据空间中关系发生变动的人数。调用按 UTC 日期跨群合计,失败也计入;人数按关系设置的时区统计,三维任一实际改分或撤销均计入,同一成员只算一人,不含临时关系和自然衰减。翻页和搜索不改变统计范围,点击“刷新”可更新概览。
| 入口 | 可以做什么 |
|---|---|
| 当前总览与成员详情 | 查看三维数值、关系称谓和标签,按群或 QQ 号筛选。详情中可查看最近互动、完整印象和近期评审,也可刷新昵称、调整关系或编辑印象。 |
| 变动流水 | 对照熟悉度、亲近度与信任度的增量,按群、QQ 号、维度或自动评估来源筛选,查看变动详情或预览并撤销整个事件。 |
| 临时调整 | 在成员详情中将调整方式切换为「临时调整」,给选定成员设置持续 1 分钟至 30 天的临时三维关系,用来体验不同状态。 |
| 提示词 | 分别配置关系行为与互动评估模板,支持全局设置、按 Bot 与指定群覆盖、草稿预览与恢复默认;重置群级覆盖后继承全局模板。 |
| 评估 | 调整超时、统计时段、每日初评/复核上限、同时评估上限与参考上下文,对照「当前生效设置」及调用统计,支持「恢复此区默认设置」与按维度跳转查看评估流水。 |
| 详细设置 | 顶部汇总展示当前关系模式、三维每日加扣分上限、衰减速度与基线;基础设置集中管理启用开关、模型、群与排行选项,其余分区按用途收纳并支持「恢复此区默认设置」;底部可管理当前空间的诊断记录。 |
| 备份与恢复 | 在顶部作用域栏展开「备份与恢复」,对选定 Bot 的当前数据空间执行在线备份,或输入备份文件名经二次确认后恢复至当前空间。 |
尚无关系变化的成员默认折叠,可展开或搜索。点击「显示印象」后,三维数值会隐藏,状态仍保留,标签右侧显示已有印象:最多两行,超出省略,没有内容时显示「暂无印象」。宽屏会收紧前四列,为印象留出空间;窄屏和手机按成员逐条排列,保留账号、状态、标签与详情入口。点击「显示数值」即可切回,这两个操作都不调用模型。
状态列会标出正在衰减的维度,例如「F 衰减中」「F A 衰减中」;三维同时衰减时显示「衰减中」。字母颜色与数值列一致,负信任向基线恢复也显示为「T 衰减中」。没有衰减时沿用「几天未动」,临时关系优先显示对应状态。
临时关系生效时,称谓、排行和回复参考使用临时值,成员详情中同时显示正式值与截止时间。期间暂停该关系的自动评估、自动印象更新和正式衰减,已发出的旧任务不能回写。
到期或点击“立即结束临时关系”后恢复正式值,随后继续衰减与评估;期间消息不补评。临时状态保存在本地,重启后继续生效。结束临时关系后,才能调整正式分数、撤销分数流水或重置;印象与标签仍可手动编辑。
昵称显示、全局详情与多 Bot 排查
- “全部群”显示 QQ 昵称,指定群显示群名片,没有群名片时回退昵称。旧记录缺少可靠昵称时显示“昵称未知”,不会把旧群名片当作 QQ 昵称。
- 成员详情中可点击“刷新昵称”;需要对应 Bot 在线,同一成员两次刷新至少间隔 30 秒。平台查询失败时保留原资料,长昵称可悬停查看。
- 全局空间的“全部群”可查看、调整正式关系;群资料与事件操作仍需选择真实群。按群空间保留独立行,不合并分值。
- 多个 Bot 使用不同 AstrBot 配置时,每份配置都要启用 Bond,群白名单也要允许目标群。平台收到消息,不等于该配置已启用插件。
- 旧版热更新后若成员详情提示参数无效,先重载插件并刷新页面;必要时重启 AstrBot,以清除旧成员接口。
| 数据空间 | 适合的使用方式 | 隔离规则 |
|---|---|---|
per_group(默认) |
同一人在不同群有不同的相处状态。 | 按 Bot、群、成员分别记录。 |
global |
同一 Bot 跨群使用一份成员关系状态。 | 每个 Bot 仍独立;仅面向群聊(不支持私聊关系记录),本群排行只列出本群已观察到的成员,不召回其他群印象与历史。 |
切换空间只改变使用哪份数据,不会迁移、合并、复制或删除原记录。临时关系同样遵循空间规则:全局模式跨群共用,按群模式仅影响选定群。面板中的 Bot 专属模式优先于 default_scope_mode。
数据保存在 data/plugin_data/astrbot_plugin_bond/,每个真实 Bot 分别使用 bots/{bot_id}/group.db 与 bots/{bot_id}/global.db。
诊断默认关闭。启用后默认使用 assessment 档,仅记录脱敏的变化、称谓、评估状态、调用耗时与用量;管理员可在当前 Bot、当前空间下查看状态、导出或清除,关闭后仍可管理旧记录。
raw增加消息与回复,evaluation再增加评估内容,full再增加主请求内容。升级时已有的明确选择会保留;更详细的档位可能包含私人对话,分享前请检查。- 成员与事件使用临时代号,已知凭据模式会脱敏;这不保证识别所有隐私内容。JSON 工具字符串同样检查,未通过复检的旧行不导出。
- 默认保留约 7 天,全部 Bot 与空间合计默认最多 100MB,可配置 1–10000MB;定期清理或写入时超限均先删旧记录,面板显示实际占用。
- 不额外调用模型,不修改正式关系与变动流水;清除记录后,在途任务不能补写该批旧内容。
详细保存规则、导出限制与排查方法见 诊断说明。
关系只影响态度和表达。 Bond 不改变系统规则、管理权限、人格核心或发言策略;配置中的“主人”只是沿用当前人格的称谓,不授予权限,也不豁免评分。关系状态用于角色表现,不代表 AI 拥有真实感情。
先确认归因,再考虑变化。 自动评估只接受没有冲突的当前 Bot 指向。其他 @ 对象、多目标、引用来源缺失或冲突时跳过更新。空文本、不满足入口条件的消息和相同稳定消息 ID 的重复处理由框架拒绝;是否只是寒暄、重复感谢或新的实质互动交由模型结合有界上下文判断。滚动调用窗口与分值额度分别约束调用和变化,纯文本转述仍可能被模型误解。
模型提出事件建议,本地规则决定变化。 模型不能直接修改三维数值。失败、超时、解析失败、复核预算不足或结果不确定时,本次不改关系,正常对话继续。同时评估人数已满时跳过新评估,不排队影响对话。
感谢和道歉不自动换来信任。 有记录支持的纠错、履约和实质修正,经初评与复核一致确认后可逐步增加信任。感谢、示好、承诺和道歉本身的 T 为 0,信任事件的证据要求见上方关系节奏说明。
图片排行会获取 QQ 头像。 获准查询后,仅向固定 QQ 头像服务发送榜内至多 10 名成员的账号来获取头像,不发送关系称谓、分值或聊天。头像只短时缓存在内存,失败使用昵称占位;图像在本机生成,内置中文字体,无需在线渲染或额外模型。关闭图片或使用模型工具查询时不请求头像。
模型调用有数据外发。 启用评估或刷新印象时,消息文本、允许的上下文或有限流水可能发送给所选 AstrBot Provider。动态称谓会将当前完整人格、三维关系与允许参考的本群印象发送给称谓模型(未单独指定时跟随复核模型),全局空间省略聚合印象。“我的印象”的大模型总结使用当前会话聊天模型。Bond 不自动上传本地诊断;请勿向 Issue、PR 或截图提交真实聊天、账号、数据库和密钥。
提示词文件、配置重载与外部记忆
提示词保存在独立的 data/plugin_data/astrbot_plugin_bond/prompts.json。评估和行为模板分开管理,群级覆盖按真实 Bot ID 与群 ID 保存;评估模板始终保留程序的输出协议,未知占位符会被拒绝。
提示词文件损坏时保留原文件,暂停自动评估与关系注入;本地查询和管理继续运行。修复或恢复文件后重载插件,详见 提示词说明。
基础与详细配置适用于所有 Bot。Bond 页面保存后重载生效;已开始的任务按原配置执行完毕。群白名单外的历史资料保留,管理员仍可在面板管理。配置仍由 AstrBot 保存,隐藏字段保留;Bond 基础设置与评估页共用版本校验,过期保存会被拒绝,需刷新后重试。AstrBot 原配置入口不使用 Bond 的版本校验,因此在两处来回编辑时先刷新原配置表单。
LivingMemory 集成已移除,不再探测、读取或写入其记忆。本地关系、印象与流水不受其安装或卸载影响,见 接口调查。
升级前停用插件,并一起备份代码、AstrBot 插件配置和整个 data/plugin_data/astrbot_plugin_bond/ 数据目录。复制 SQLite 文件前须停止写入;在线备份使用插件提供的备份功能。
从 0.6.0 之前的版本升级时,会一次性重置信任专属的五项配置,原来自定义的值也会覆盖。 已完成这次升级的安装不会再次重置。新值为基础每日加分上限 2、扣分上限 8、启用信任衰减、半衰期 60 天、基线 20。共用保温期、关系模式、F/A 设置和模型选择沿用已保存值。升级成功后再调整的信任设置会正常保留。
上述信任配置升级保留成员原始 T、各维度的维护时间与历史流水,重载后直接按新参数计算信任度,显示值可能立即变化。插件会将覆盖前的五项信任设置保存为数据目录下的 trust-settings-before-0.6.json,避免重复覆盖;保存失败时会撤回修改并报错。具体范围与处理方法见 升级说明。
0.7.0 保留关系分数与历史流水。 旧称谓开关自动兼容;旧默认刷新间隔由 6 小时改为 12 小时,日上限由 10 次改为 30 次,并将生成和校验分别计次。其余自定义值只在超出新范围时调整。
当前数据结构为 schema 20,在原有称谓缓存和调用记录之外,新增持续尊重边界所需的证据记录。从早期单分结构升级时,原好感度保留为亲近度,新增的熟悉度与信任度初始化为 0。回滚须成套恢复匹配的旧代码、配置与完整数据备份。旧代码不能直接打开新库。Bond 不自动导入旧 bond.db 或 Xinxian 数据。
本版提供 三组行为对照与多轮评测材料。离线工程测试不证明真实模型已更自然或有趣,真实群聊效果需另行验收。
| 想了解什么 | 从这里开始 |
|---|---|
| 日常设置、命令与操作 | 用户指南 |
| 完整关系称谓与组合 | 关系词典 |
| 自定义表达与模板 | 提示词说明 |
| 管理功能与接口 | 管理面板 |
| 升级、备份与回退 | 升级说明 |
| 安装后的验证边界 | 验收记录 |
| 情感与关系建模 | 图文短论文 · 研究来源 |
| 开发与测试 | 开发指南 |
| 参与贡献与反馈 | 贡献指南 · 安全问题报告 |
| 插件商店提交准备 | 提交资料与自查 |
欢迎在 Issues 提交脱敏复现,或通过 PR 改进代码与文档。
Bond 基于 yiwuerxin/astrbot_plugin_xinxian(心弦好感度)开发,保留原作者署名,并沿用 GNU AGPL v3 许可证。 项目 Logo 与九款排行角色插图是以《超时空辉夜姬!》角色八千代为灵感、由 AI 辅助绘制的非官方同人素材,非官方联名。
关于情感与关系建模的设计、实现和合成实验,见图文短论文 《AstrBot Bond:群聊中的情感与社会关系建模》。原始研究输入、文献用途和未采纳结论见 研究来源与证据边界。
以下文献用于界定构念、比较机制和设计评价方法,不能证明 Bond 具有真实情感,也不能直接给出关系分值、阈值、修复比例或真实群聊效果。条目按主题编排,编号供短论文引用;来源核对日期为 2026-11-03。
- Berscheid, E., Snyder, M., & Omoto, A. M. (1989). The Relationship Closeness Inventory: Assessing the Closeness of Interpersonal Relationships. Journal of Personality and Social Psychology, 57(5), 792–807. DOI: 10.1037/0022-3514.57.5.792。用于区分互动接触与主观亲近。
- Laurenceau, J.-P., Barrett, L. F., & Pietromonaco, P. R. (1998). Intimacy as an Interpersonal Process: The Importance of Self-Disclosure, Partner Disclosure, and Perceived Partner Responsiveness in Interpersonal Exchanges. Journal of Personality and Social Psychology, 74(5), 1238–1251. DOI: 10.1037/0022-3514.74.5.1238。用于理解互动质量与回应性,不能据此推断用户内心。
- Mayer, R. C., Davis, J. H., & Schoorman, F. D. (1995). An Integrative Model of Organizational Trust. Academy of Management Review, 20(3), 709–734. DOI: 10.5465/amr.1995.9508080335。用于区分信任与喜欢、礼貌等正向态度。
- Lewicki, R. J., McAllister, D. J., & Bies, R. J. (1998). Trust and Distrust: New Relationships and Realities. Academy of Management Review, 23(3), 438–458. DOI: 10.5465/amr.1998.926620。用于讨论矛盾信号及单一信任标量的表达限制。
- Kim, P. H., Ferrin, D. L., Cooper, C. D., & Dirks, K. T. (2004). Removing the Shadow of Suspicion: The Effects of Apology versus Denial for Repairing Competence- versus Integrity-Based Trust Violations. Journal of Applied Psychology, 89(1), 104–118. DOI: 10.1037/0021-9010.89.1.104。用于区分不同违背类型的修复条件,不采用固定“道歉恢复率”。
- Lewicki, R. J., & Brinsfield, C. (2017). Trust Repair. Annual Review of Organizational Psychology and Organizational Behavior, 4, 287–313. DOI: 10.1146/annurev-orgpsych-032516-113147。用于区分言语回应与持续行为修复。
- Russell, J. A. (1980). A Circumplex Model of Affect. Journal of Personality and Social Psychology, 39(6), 1161–1178. DOI: 10.1037/h0077714。用于区分当前情感体验与长期关系构念。
- Baumeister, R. F., Bratslavsky, E., Finkenauer, C., & Vohs, K. D. (2001). Bad Is Stronger than Good. Review of General Psychology, 5(4), 323–370. DOI: 10.1037/1089-2680.5.4.323。用于讨论正负影响的不对称性,不提供统一扣分倍率。
- Bickmore, T. W., & Picard, R. W. (2005). Establishing and Maintaining Long-Term Human-Computer Relationships. ACM Transactions on Computer-Human Interaction, 12(2), 293–327. DOI: 10.1145/1067860.1067867。长期关系型 Agent 的设计与评价背景。
- Skjuve, M., Følstad, A., Fostervold, K. I., & Brandtzaeg, P. B. (2021). My Chatbot Companion – a Study of Human-Chatbot Relationships. International Journal of Human-Computer Studies, 149, 102601. DOI: 10.1016/j.ijhcs.2021.102601。一对一聊天机器人关系的定性研究背景。
- Skjuve, M., Følstad, A., Fostervold, K. I., & Brandtzaeg, P. B. (2022). A Longitudinal Study of Human–Chatbot Relationships. International Journal of Human-Computer Studies, 168, 102903. DOI: 10.1016/j.ijhcs.2022.102903。用于提醒长期关系体验存在个体差异,不把固定阶段当作普遍规律。
- Ghosh, D., Fabbri, A. R., & Muresan, S. (2018). Sarcasm Analysis Using Conversation Context. Computational Linguistics, 44(4), 755–792. DOI: 10.1162/coli_a_00336。用于说明孤立句子不足以可靠识别反讽。
- Inoue, K., Lala, D., Elmers, M., Ochi, K., & Kawahara, T. (2025). An LLM Benchmark for Addressee Recognition in Multi-modal Multi-party Dialogue. Proceedings of the 15th International Workshop on Spoken Dialogue Systems Technology, 330–334. ACL Anthology。用于支持独立处理受话人归因;原实验并非 QQ 文本群聊。
- Gao, J., Lian, Y., Zhou, Z., Fu, Y., & Wang, B. (2023). LiveChat: A Large-Scale Personalized Dialogue Dataset Automatically Constructed from Live Streaming. ACL 2023, Volume 1: Long Papers, 15387–15405. DOI: 10.18653/v1/2023.acl-long.858。中文多方对话与受话人识别的外部数据参照。
- Geifman, Y., & El-Yaniv, R. (2017). Selective Classification for Deep Neural Networks. Advances in Neural Information Processing Systems, 30. 会议论文。借鉴“允许弃权”的风险与覆盖率权衡,不声称 Bond 实现了论文的统计保证。
- Sharma, M., Tong, M., Korbak, T., et al. (2024). Towards Understanding Sycophancy in Language Models. ICLR 2024. 会议论文。用于说明模型建议仍需校验,不推导“夸奖用户必有恶意”或通用错误率。
- Zhong, W., Guo, L., Gao, Q., Ye, H., & Wang, Y. (2024). MemoryBank: Enhancing Large Language Models with Long-Term Memory. Proceedings of the AAAI Conference on Artificial Intelligence, 38(17). DOI: 10.1609/aaai.v38i17.29946。记忆更新的比较背景;记忆遗忘机制不能直接当作关系衰减定律。
- Wang, Z., Chiu, Y. Y., & Chiu, Y. C. (2023). Humanoid Agents: Platform for Simulating Human-like Generative Agents. EMNLP 2023: System Demonstrations. ACL Anthology。情绪与关系分层的模拟架构参照;Bond 未实现其情绪或需求系统。
- Park, J. S., O'Brien, J. C., Cai, C. J., Morris, M. R., Liang, P., & Bernstein, M. S. (2023). Generative Agents: Interactive Simulacra of Human Behavior. UIST 2023. 作者预印本。记忆、反思和生成行为的架构参照;不作为 Bond 群聊效果或 Token 节约的证据。
注入位置的取舍见 注入方式评估;大量成员的计算开销与实测范围见 页面合成负载记录。
关系资料的只读预览、历史诊断、来源限定与升级回退见 关系资料说明。




