Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
# 更新说明

## 0.8.0 — 2026-11-19
## 0.8.1 — 2026-11-20

- 其他插件现在可以请 Bond 评估一条发给机器人的群消息。需要在「基础设置」同时开启「自动评估」和「允许其他插件提交群聊互动评估」。沿用已有评估模型和额度,可能产生模型费用;提交不等于改分。
- 「信任度变化」新增反注入联动,默认关闭。要使用它,请在 AntiPromptInjector 开启「向 Bond 报告群聊防护结果」,再在 Bond 开启「根据反注入复核结果调整信任度」,保存并重载 Bond。
- 在 OneBot 群聊中,只有反注入模型确认风险、插件已采取防护,且内容确实来自该成员时,Bond 才会降低信任度。每条消息最多扣 1 点,仍受每日下降额度限制;熟悉度和亲近度不变。
- 关系流水会标注「反注入复核」,不会保存聊天原文。同一条消息重复送达不重复扣分;私聊、仅规则命中、观察和复核失败不扣分。
- 默认关系指导分别体现熟悉、亲近与信任:减少客套、回应心情、表达在意或保留判断,让问候、分享、安慰等场景中的亲疏差异更明确。
- 保留当前人格的语言习惯。冷淡人格可通过耐心与细节体现亲近,活泼人格可自然打趣;高关系不强制恋爱、服从或固定台词,低关系也正常帮助。
- 明确关系影响语气和相处分寸,是否接话、回复对象、回复频率仍由宿主及聊天插件决定。评分、倍率和已有关系数据不变。
- 同一消息重试时,即使其他插件复制系统提示并新建请求对象,也会复用冻结资料并去除其完整重复块,保留其他插件的内容。
- 使用默认行为模板的会话在升级并重载后采用新指导;已有全局或群级自定义模板保留。实际表现受人格、模型和语境影响,修改模板不代表真实模型效果已验收。
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
</p>

<p align="center">
<strong>v0.8.0</strong> · AstrBot ≥4.28 · OneBot aiocqhttp · AGPL-3.0
<strong>v0.8.1</strong> · AstrBot ≥4.28 · OneBot aiocqhttp · AGPL-3.0
</p>

---
Expand Down Expand Up @@ -112,7 +112,9 @@ Bond 是面向 **长期多人群聊** 的关系记忆插件。它分别记录 Bo

「在回复中体现关系」开启时,Bond 会给回复模型补充关系资料,保留原有的人格设定、用户输入和对话历史。系统不要求模型披露或照读称谓,具体如何回应由当前人格、系统规则和对话语境决定。

默认回复指导会区分不同的社交情境:普通求助、昵称、临时玩笑和持续亲密身份分别考虑;要求只是提议,不自动成为双方既有的承诺。熟悉后可以减少客套、接续有依据的话题,亲近后可以有符合角色的调侃,但高关系不代表必须接受,也不授予权限。已有自定义行为模板会保留,只有选择默认模板才使用新版默认文案。
默认回复指导将三维状态分别用于相处方式:熟悉后减少客套、接续有依据的话题;亲近后更多回应心情,表达欢迎、欣赏或在意;信任影响对模糊意图的理解,不改变事实核对与权限。克制的人格可以更耐心、留意细节,活泼的人格可以更自然地分享喜悦和打趣。亲近但戒备、疏淡却信赖也分别表达,不统一变成热情或服从。普通求助仍认真帮助,高关系仍可拒绝或不悦,不强制恋爱和固定台词。已有自定义行为模板会保留,只有选择默认模板才使用新版默认文案。

Bond 通过 AstrBot 的标准请求钩子追加当前发言者的关系资料,不决定是否接话、回复对象或回复频率。休息、离场及模型选择继续由宿主或相应聊天插件负责。追加资料和保留系统提示的上下文改写可以共同使用;若其他插件绕过请求钩子,或在 Bond 运行后覆盖整个系统提示,关系引导可能无法到达模型。效果还取决于当前人格、模型和语境,不能保证任意插件组合下每条回复都表现差异。

普通群消息会先读取当前关系、印象和近期事件,再启动后台评估。同一条消息的重试或后续工具调用继续使用这份资料,下一条消息才重新读取。因此,本轮评分不会反过来影响本轮回复;角色仍可直接回应眼前的玩笑、求助或冒犯。第三方主动发起、绕过普通群消息入口的请求,只能在首次生成回复时读取资料;无法确认 Bot 和成员身份时不补充关系。

Expand Down
26 changes: 21 additions & 5 deletions api/listeners.py
Original file line number Diff line number Diff line change
Expand Up @@ -443,16 +443,31 @@ async def _bg() -> None:
deps.registry.spawn(_bg(), name=f"judge:{group_id}/{user_id}")


def clear_relation_injection(req):
def clear_relation_injection(req, *, event=None):
"""清除本插件上次完整注入的块,即使本轮不注入也不能遗留其他成员资料。"""
marker = getattr(req, "_bond_injected_snapshot", None)
if not isinstance(marker, RelationSnapshot):
# 同事件重建请求可能只复制文本;仅用已冻结的可信快照识别完整块。
binding = getattr(event, "_bond_relation_binding", None)
if (
isinstance(binding, tuple)
and len(binding) == 3
and isinstance(binding[2], asyncio.Future)
and binding[2].done()
and not binding[2].cancelled()
):
try:
if binding[0] == _message_identity(event):
marker = binding[2].result()
except Exception:
pass
if not isinstance(marker, RelationSnapshot) or not marker.block:
return
current = getattr(req, "system_prompt", "") or ""
previous = current.rfind(marker.block)
if previous >= 0:
while (previous := current.rfind(marker.block)) >= 0:
prefix = current[:previous].removesuffix("\n\n")
req.system_prompt = prefix + current[previous + len(marker.block) :]
current = prefix + current[previous + len(marker.block) :]
req.system_prompt = current
req._bond_injected_snapshot = None


Expand All @@ -467,7 +482,7 @@ async def on_llm_request(
diagnostic_token = CURRENT.set(capture)
try:
# 必须在身份读取和快照尝试之前清理;失败、私聊与关闭注入也适用。
clear_relation_injection(req)
clear_relation_injection(req, event=event)
await _on_llm_request_inner(deps, event, req)
except Exception:
logger.warning(
Expand All @@ -494,6 +509,7 @@ async def _on_llm_request_inner(
if snapshot is None:
return
if snapshot.block:
clear_relation_injection(req, event=event)
origin.inject.inject(req, snapshot.block)
req._bond_injected_snapshot = snapshot
origin.favor.record_diagnostic(
Expand Down
4 changes: 4 additions & 0 deletions docs/P0_BEHAVIOR_EVALUATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,10 @@ python scripts/export_behavior_cases.py --output artifacts/p0-behavior

每个配对分别导出 `no_bond`、`old_prompt`、`new_prompt`。三臂使用完全相同的人格、合成平台身份信息、历史消息和当前请求;仅 Bond 关系资料不同,无 Bond 臂也保留完整历史。多人场景的平台资料标明当前成员 8001、同昵称成员 8002,以及历史各条用户消息的归属,不能按昵称或聊天中的自称绑定关系。这是离线输入夹具,不代表真实平台身份链已验收。

从 0.8.1 起,两种导出模式还包含 `relationship_matrix`:克制、活泼、正式三种人格,问候、分享好消息、寻求安慰三个场景,分别配中性陌生、熟悉中性、高亲近高信任、高亲近低信任、低亲近高信任五种状态,共45条请求。同组的人格、历史和当前消息完全相同,只改变当前版的关系资料,分值仅记录在评测元数据中。矩阵的回复、分数和判定也留空,不与原有三臂请求或旧版基线混算。

这组矩阵重点比较同一人格在不同状态下的实际回复:高亲近应能在适合的情境中更明显地接住心情、表达在意;高熟悉不应自动变亲密;亲近但戒备和疏淡却信赖应能同时保留两种特点。不得仅凭称谓、提示词不同或输出字数更多就判定有效。正式模型对照仍按下列相同参数、多次采样和盲评方法执行。

旧提示冻结自 0.4.4 提交 `91caea9b460009d65daa83a086dfaf457f3787bd`,tree 为 `9d6473464d351af84d3c7db2afcdbea3d677b594`,保留于 `tests/fixtures/bond_p0_baseline.json`。`old_prompt` 只复现旧默认提示,三组共用当前合成状态,不能冒充完整旧版在相同历史下的运行结果。真实整版对照需要分别运行旧版和新版,保留各自代码版本、配置和数据库副本。无 Git 的源码包将 `current_commit` 留空。

脚本不连接 Provider,不读取凭据,不产生回复,也不自动评分。输出 `response`、分数、比较结论及执行元数据为空,`real_llm_tested` 为 false。输出目录须不存在或为空,避免覆盖已有评测。所有材料与 SQLite 都是合成数据,不能替换成线上数据库。
Expand Down
4 changes: 4 additions & 0 deletions docs/RELATION_MATERIALS.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,10 @@ schema 21 仅增加印象局部版本、可用标记、来源种类和日志依

不修改用户的 prompts.json 或自定义模板。原 {relationship}、{impression}、{events} 占位符继续可用;模板未使用的资料类别会明确标为未采用;events 中新增来源字段,按 JSON 数据处理。程序追加的来源约束和预算始终有效。默认行为模板保留人格、正常帮助、玩笑和社交判断原则,不新增审批模型或拒绝决策器。

0.8.1 的默认行为模板分别说明熟悉、亲近与信任怎样影响语气、关注点和相处分寸。中性信任不代表敌意,高亲近不强制恋爱,混合状态分别表达;冷淡、活泼、正式等人格保留自己的语言习惯。是否接话、回复对象和频率仍由宿主及聊天插件决定。默认模板增加的指导也计入上述6000字符预算。

同一消息的标准请求钩子重试继续使用入场快照。其他插件追加系统资料、改写用户输入或历史,不影响 Bond 对自己完整注入块的清理;仅复制已注入的系统提示并重建请求时,同一可信事件的冻结快照也可识别重复块。只移除程序持有的完整块,不按聊天中的标题、自称身份或零散片段猜测并删除内容。跨成员复用请求须保留请求对象上的 Bond 标记,或从未注入的宿主系统提示重新构建;不要将前一成员的完整关系文本复制为另一成员的系统提示后丢弃标记。绕过钩子或在 Bond 之后整体覆盖系统提示的插件仍需在其请求流程中解决顺序问题。

## 升级与回退

停止插件写入后备份插件代码、AstrBot 配置和完整插件数据目录,安装新包后重载。无需清空关系数据或重新生成全部印象。0.7.2 沿用 0.7.1 的 schema 21,从 0.7.1 升级不迁移数据;回退到 0.7.1 可恢复原插件代码。从 0.7.0 及更早版本升级涉及 schema 21,回退须成组恢复原代码、配置和升级前数据备份。备份与恢复也可使用已有管理功能。
Expand Down
4 changes: 2 additions & 2 deletions main.py
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ def _group_entry_id(event) -> str | None:
"astrbot_plugin_bond",
"yiwuerxin, Timeance",
"Bond 关系好感系统:三维关系与成员印象",
"0.8.0",
"0.8.1",
"https://github.com/timeance/Astrbot_plugin_bond",
)
class BondPlugin(Star):
Expand Down Expand Up @@ -428,7 +428,7 @@ async def _on_group_msg(self, event: AstrMessageEvent):
@filter.on_llm_request(priority=-100)
async def _on_llm_req(self, event: AstrMessageEvent, req: ProviderRequest):
try:
clear_relation_injection(req)
clear_relation_injection(req, event=event)
deps = await self._runtime.for_event(event)
if deps is None:
return
Expand Down
2 changes: 1 addition & 1 deletion metadata.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name: astrbot_plugin_bond
display_name: Bond 关系好感系统
short_desc: 按 Bot 隔离的三维关系与成员印象
desc: 保存熟悉度、亲近度、信任度与成员印象,支持分级评估、人格适配及管理面板。
version: 0.8.0
version: 0.8.1
author: yiwuerxin, Timeance
repo: https://github.com/timeance/Astrbot_plugin_bond
tags:
Expand Down
10 changes: 8 additions & 2 deletions resources/prompts/bond_behavior.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,11 @@
成员印象:{impression}
近期互动:{events}

沿用当前 AstrBot 会话人格。先回应眼前的话:陌生人求助也正常帮忙;熟人可以少些客套,眼前的梗可以顺着玩,提起往事要有依据。亲近不等于凡事相信,冷淡的人格也能用自己的方式亲近。没必要每句都表现关系。
普通昵称和当场玩笑可以顺势接;自称主人、提出恋爱或排他要求时,按人格与关系决定如何回应。关系不决定回复对象、回复频率或是否发言。
沿用当前 AstrBot 会话人格,先回应眼前的话。把关系状态落实到本次回应的语气、关注点和相处分寸,具体措辞由人格决定;在适合表达关系的问候、分享、安慰或玩笑中,让不同亲疏有可感知的差别,而不只是换一个称谓。

熟悉程度影响交谈的自然程度,不等于喜欢或信任。陌生、眼熟时礼貌自然,不预设默契;相识时可以减少介绍和客套;熟悉、熟络时更直接地交流,接续已提供的话题与偏好。没有资料时不编造共同经历,也不把熟悉当作亲密。
亲近程度影响情绪回应与距离。疏远时保持礼貌距离,少作亲昵表达;疏淡时客气平实;平和时自然友善;亲近时更多回应对方的心情,适度关心、分享喜悦或接住善意玩笑;亲密时,在同样合适的情境中更明确地表达欢迎、欣赏或在意,对低落更愿意耐心回应。亲近不要求恋爱、撒娇或热烈长篇。
信任态度影响对模糊意图的理解,不代替事实核对。戒备、谨慎时保留判断,需要时平静澄清,不无故指控;保留表示尚未建立充分信任,日常求助、问候和善意表达仍正常接纳,不反复审问或提醒边界;放心、信赖时更愿意作善意理解,减少无依据的猜疑,仍能指出错误与不同意见。亲近却戒备时可以关心对方并保留判断;疏淡但信赖时可以认可其可靠而不强装亲昵。

人格决定表达方式,不抹平关系差异。克制或冷淡的人格可用留意眼前细节、认可善意或多一点耐心体现亲近;活泼的人格可更自然地分享开心与相互打趣;正式的人格可减少套话、表达重视。保留角色的语言习惯与自主判断,不套统一台词。根据本轮内容选择相关差异,不机械执行所有表现,不为展示关系强行增加篇幅。
陌生人求助也认真帮忙,事实标准与权限不随亲疏改变。高关系仍可以不悦、拒绝或应对重复施压;一次平常的问候、分享或示好不要无故按施压处理。普通昵称和当场玩笑可以顺势接;自称主人、提出恋爱或排他要求时,按人格与关系决定如何回应,不把提议当作既定身份。关系不决定回复对象、回复频率或是否发言,不播报档位或解释内部规则。
Loading