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
9 changes: 6 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# 更新说明

## 0.5.12 — 2026-11-09
## 0.6.0 — 2026-11-10

- 取消 AstrBot 版本上限,最低要求保留为 4.28,允许宿主后续版本加载。
- 补充 AstrBot 4.29.4 真实框架验证,覆盖关系注入、工具续跑、OneBot 消息及原生页面认证。
- 固定关系称谓扩展至 75 个,初识、熟悉和亲近阶段的变化更丰富。
- 新增人格称谓模式,按 Bot 人格在后台生成,查榜直接复用。
- 完善信任积累、分级扣分和修复机制,让可靠行为与失信行为得到更合理的反馈。

升级会统一五项信任设置,保留原始分数和历史记录;显示的信任度可能变化。详情见 [升级说明](README.md#升级备份与回滚)。
41 changes: 31 additions & 10 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.5.12</strong> · AstrBot ≥4.28 · OneBot aiocqhttp · AGPL-3.0
<strong>v0.6.0</strong> · AstrBot ≥4.28 · OneBot aiocqhttp · AGPL-3.0
</p>

---
Expand All @@ -34,7 +34,8 @@ Bond 是面向 **长期多人群聊** 的关系记忆插件。它分别记录 Bo
| 特色 | 你会用到的能力 |
| --- | --- |
| **三维关系,分别记录** | 熟悉度、亲近度、信任度各自计算,可以同时表达“亲近”和“戒备”。 |
| **55 个中文关系词条** | 三个维度各分五档,125 种状态组合映射为 55 个中文关系称谓;底层仍只维护三个维度。 |
| **75 个中文关系词条** | 新增 20 个称谓,在初识、渐熟和亲近阶段细分表达,让前期变化更容易看见。 |
| **可选人格称谓** | 按当前完整人格在后台选择贴切表达,保存后反复使用;查榜不额外调用模型。 |
| **表达沿用当前人格** | 词条提供理解线索,Bot 不必照读标签,也没有预设的冷淡或热情答法。 |
| **每个 Bot 有自己的关系** | 按真实 Bot 账号独立存储;群内关系与全局关系分开管理。 |
| **关系可查、可调、可撤销** | 管理面板保留变动流水,支持正式调整与限时体验,临时关系结束后恢复正式值。 |
Expand All @@ -46,7 +47,7 @@ Bond 是面向 **长期多人群聊** 的关系记忆插件。它分别记录 Bo
**三个维度负责计算,关系词典负责解释,当前人格负责表达。**

<p align="center">
<img src="docs/assets/relationship-overview.svg" width="1000" alt="三层关系处理:熟悉度、亲近度、信任度各分五档,125 种状态组合映射到 55 个中文关系词条,最后交由当前人格表达。" />
<img src="docs/assets/relationship-overview.svg" width="1000" alt="三层关系处理:三维五档与125种主状态,结合局部细分提供75个关系称谓,再由当前人格表达。" />
</p>

### ① 计算:熟悉、亲近、信任各有含义
Expand Down Expand Up @@ -77,7 +78,19 @@ Bond 是面向 **长期多人群聊** 的关系记忆插件。它分别记录 Bo
| **亲密而保留** | 已经熟悉且亲近,信任上仍有所保留。 |
| **亲密挚友** | 熟悉、亲近和信任均较强,仍不改变人格原则或权限。 |

这些词条表示并列的关系组合,不是一条逐级升级的路线。完整的 55 个词条、释义与档位映射见 [关系词典](docs/RELATION_LEXICON.md)。
这些词条表示并列的关系组合,不是一条逐级升级的路线。主档位映射见 [关系词典](docs/RELATION_LEXICON.md),0.6.0 新增的 20 个词条与称谓规则见 [评估框架](docs/ASSESSMENT_FRAMEWORK.md#关系称谓)。

在亲近度与信任度保持平和、保留时,熟悉度增长可以依次呈现:**陌生 → 眼熟之人 → 新相识 → 泛泛之交 → 渐熟的相识 → 相熟之人 → 普通熟人 → 熟络之交**。前期在 F 达到 1、3、5、8 时就有不同表达;这只是这一组关系的示例,不代表聊天越多就必然成为朋友。

三维仍各分五档,共有 **125 格主状态**。本次在部分组合中增加 F 为 **3、8、20** 和 A 为 **25** 的局部展示边界,让同一主档位内也能呈现变化。

### 固定词典与人格称谓

默认使用 **固定词典(fixed)**,不增加模型调用。想让称谓贴近 Bot 的气质,可在 AstrBot 插件设置或 Bond「详细设置 → 关系称谓」选择 **人格称谓(llm)**,并指定生成模型。两个入口编辑同一份设置;称谓模式与 Realistic / Galgame 的关系增长模式分别选择。

人格称谓在成员直接互动后尝试后台生成,读取当前会话完整的有效人格,并从本地审定的可公开词族中选择措辞。按群空间可参考本群已有印象,复杂负向状态使用固定词典。没有完整人格、生成失败或结果不合适时自动回退。全局关系空间生成称谓时省略聚合印象。

默认同一成员在当前会话中两次生成尝试至少间隔 **6 小时**,每个 Bot 每个 UTC 日最多 **10 次**,超时 **30 秒**,可在同一设置页调整。次数跨群与数据空间合计,失败和超时也计入。称谓刷新独立于印象更新,已有称谓仍适用时会复用。查询、排行只读取有效缓存,缺少缓存时显示固定词典。人格改变、关系不再匹配、来源撤销或临时关系切换后,旧词会停用。缺少明确会话的管理页面和跨插件查询显示固定称谓。

### ③ 表达:让角色用自己的方式回应

Expand Down Expand Up @@ -167,21 +180,25 @@ AstrBot 插件配置与 Bond「详细设置 → 查询与排行」共用我的

新安装默认 **Galgame**。评估仍默认关闭:先手动选择日常评估模型,再开启自动评估;需要回复参考关系时,另行开启关系注入。

模型判断互动性质、指向、上下文与语义重复;Bond 校验身份、协议和当前原文证据,再执行本地数值规则。普通有内容问答可以增加熟悉度,不自动增加亲近度。感谢、示好和道歉不自动恢复信任;当前默认事件规则没有正向信任增量。
模型判断互动性质、指向、上下文与语义重复;Bond 校验身份、协议和当前原文证据,再执行本地数值规则。普通有内容问答可以增加熟悉度,不自动增加亲近度。**信任来自可观察的可靠行为**:有记录确认的纠错、履约和实质修正,可逐步建立或修复信任;感谢、示好、承诺和道歉本身不加信任。

可信事件基础增加 **0.5 T**,Galgame 下为 **1 T**。明确越界、重复实质施压、可证实的蓄意误导、严重操纵分别按 **−1 / −2 / −4 / −6 T** 处理,仍受每日额度限制。普通冒犯与普通操纵只影响原有亲近度判断,T 为 0。正常批评、无害玩笑不应被当作破坏信任。一次道歉不能抵消严重失信,后续独立的可靠行为可以慢慢修复。

自动信任变化需要选择**分级复核**并配置复核模型。两次判断须一致,并引用本群、当前成员上下文中实际记录的 Bot 回复;缺失记录、证据不完整或无法复核时不计 T。同一已确认事项的重复补述不重复计分。模型仍可能误判,引用存在也不等于现实事实已被验证;管理员可查看证据并撤销流水。

| 每日互动额度 | 基础模式 | Galgame(默认) | 两种模式扣分额度 |
| --- | --- | --- | --- |
| 熟悉度 F | +5 | +10 | 0 |
| 亲近度 A | +10 | +20 | −8 |
| 信任度 T | +2 | +4 | −5 |
| 信任度 T | +2 | +4 | −8 |

Galgame 将所有正向请求和正向每日额度统一乘 2;负向单次变化、负向额度、模型、调用次数与衰减不变。正负用量独立累计,加减不能抵消已用额度;撤销恢复分值,不退还已消费的互动额度或调用次数。自动时间衰减不占扣分额度。切换模式不翻倍旧分数、不重算历史、不清空当天用量。

**越熟悉,积累速度越平缓。** 熟悉度按六个数值区间调整增长倍率,与关系词典的五档独立;具体倍率见上图。亲近度保留等级倍率与同日加分递减。微小的有效变化会保存,页面显示一位小数。

**关系保温期默认 5 天。** 即使一段时间没有互动,彼此的熟悉感也不会马上消失。超过这段时间后,关系才会逐渐淡化。三个维度只计算超过保温期(`decay.grace_days`)的时间;设为 `0` 可取消保温期。默认分别维护三个维度:普通问答只维护熟悉度;亲近和信任须有各自合格的关系事件。有效互动会重新计时,不会恢复此前已淡化的关系。规则或额度归零不保温,合法变化因精度归零或触及分值边界仍可维护对应维度。

`decay.maintenance_strategy` 默认 `independent`;改为 `legacy` 并重载可恢复接纳事件统一保温。切换会先结算既有关系,不补发保温期,也不重算历史奖励。成员详情的“最近互动”按三个维度最近的真实维护时间显示。升级与回退方法见 [维护升级说明](docs/MAINTENANCE_UPGRADE.md)。
`decay.maintenance_strategy` 默认 `independent`;`legacy` 保留熟悉度和亲近度的联动保温,**信任始终只由合格可信事件维护**。手动切换维护策略仍沿用既有结算机制,不补发保温期,也不重算历史奖励。成员详情的“最近互动”按三个维度最近的真实维护时间显示。

默认半衰期为熟悉度 **30 天**、亲近度 **30 天**、信任度 **60 天**,默认基线分别为 **10、0、20**。开启亲近度档位托底(`decay.floor_enabled`,默认开启)时,按当前亲近度所在等级(`厌恶 / 陌生 / 认识 / 友好 / 亲密 / 挚友 / 挚爱`)**向下两级的下沿**计算衰减下限(例如「挚爱 `95`」最多衰减到「亲密」下沿 `55`);托底只影响亲近度,不保证三维关系称谓保持不变。每维的开关、半衰期与基线都可在详细设置的“熟悉度变化”“亲近度变化”“信任度变化”中调整;共用的关系保温期与额度换日时区位于“基础设置”。

Expand Down Expand Up @@ -266,11 +283,11 @@ Bond 使用 AstrBot 原生管理页面,写操作由宿主认证保护。每次

**模型提出事件建议,本地规则决定变化。** 模型不能直接修改三维数值。失败、超时、解析失败、复核预算不足或结果不确定时,本次不改关系,正常对话继续。同时评估人数已满时跳过新评估,不排队影响对话。

**感谢和道歉不自动换来信任。** 默认规则只让这类事件影响熟悉度/亲近度,不增加信任。当前没有经过验证的自动信任修复机制;管理员调整不算自动修复。升级不重算旧分值。
**感谢和道歉不自动换来信任。** 有记录支持的纠错、履约和实质修正,经初评与复核一致确认后可逐步增加信任。感谢、示好、承诺和道歉本身的 T 为 0,信任事件的证据要求见上方关系节奏说明。

**图片排行会获取 QQ 头像。** 获准查询后,仅向固定 QQ 头像服务发送榜内至多 10 名成员的账号来获取头像,不发送关系称谓、分值或聊天。头像只短时缓存在内存,失败使用昵称占位;图像在本机生成,内置中文字体,无需在线渲染或额外模型。关闭图片或使用模型工具查询时不请求头像。

**模型调用有数据外发。** 启用评估或刷新印象时,消息文本、允许的上下文或有限流水可能发送给所选 AstrBot Provider。Bond 不自动上传本地诊断;请勿向 Issue、PR 或截图提交真实聊天、账号、数据库和密钥。
**模型调用有数据外发。** 启用评估或刷新印象时,消息文本、允许的上下文或有限流水可能发送给所选 AstrBot Provider。人格称谓会将当前完整人格、三维关系与允许参考的本群印象发送给指定称谓模型,全局空间省略聚合印象。“我的印象”的大模型总结使用当前会话聊天模型。Bond 不自动上传本地诊断;请勿向 Issue、PR 或截图提交真实聊天、账号、数据库和密钥。

<details>
<summary>提示词文件、配置重载与外部记忆</summary>
Expand All @@ -290,7 +307,11 @@ LivingMemory 集成已移除,不再探测、读取或写入其记忆。本地

升级前停用插件,并一起备份代码、AstrBot 插件配置和整个 `data/plugin_data/astrbot_plugin_bond/` 数据目录。复制 SQLite 文件前须停止写入;在线备份使用插件提供的备份功能。

当前数据结构为 schema 18,新增维护时间、亲近托底参考与策略记录,保留历史分值、印象和流水。升级无需重置数据;从早期单分结构升级时,原好感度保留为亲近度,新增的熟悉度(`familiarity`)与信任度(`trust`)字段默认初始化为 `0`(不按比例折算三维)。回滚至 schema 17 或更早的代码时,须恢复升级前匹配的代码、配置与数据备份。旧代码不能直接打开新库。Bond 不自动导入旧 `bond.db` 或 Xinxian 数据。
**0.6.0 会一次性重置信任专属的五项配置,原来自定义的值也会覆盖。** 新值为基础每日加分上限 `2`、扣分上限 `8`、启用信任衰减、半衰期 `60` 天、基线 `20`。共用保温期、关系模式、F/A 设置和模型选择沿用已保存值。升级成功后再调整的信任设置会正常保留。

本次信任配置升级保留成员原始 T、时间锚与历史流水,重载后直接按新参数计算有效信任度,显示值可能立即变化。插件会将覆盖前的五项信任设置保存为数据目录下的 `trust-settings-before-0.6.json`,并用内部标记避免重复覆盖。保存失败会撤回本次内存修改并报错。具体范围与处理方法见 [升级说明](docs/MAINTENANCE_UPGRADE.md)。

当前数据结构为 **schema 19**,相对 18 仅新增称谓缓存与独立调用预算表。从早期单分结构升级时,原好感度保留为亲近度,新增的熟悉度与信任度初始化为 `0`。回滚须成套恢复匹配的旧代码、配置与完整数据备份。旧代码不能直接打开新库。Bond 不自动导入旧 `bond.db` 或 Xinxian 数据。

本版提供 [三组行为对照与多轮评测材料](docs/P0_BEHAVIOR_EVALUATION.md)。离线工程测试不证明真实模型已更自然或有趣,真实群聊效果需另行验收。

Expand Down
24 changes: 21 additions & 3 deletions _conf_schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -780,7 +780,7 @@
"legacy"
],
"description": "关系维护策略",
"hint": "independent 分别维护熟悉、亲近和信任;legacy 沿用接纳事件统一保温。重载生效,保留历史数据,切换不发放新保温期。"
"hint": "independent 分别维护三个维度;legacy 仅联动熟悉度和亲近度。信任始终需要可信事件维护。重载生效,切换不发放新保温期。"
},
"grace_days": {
"type": "float",
Expand Down Expand Up @@ -1182,6 +1182,24 @@
"hint": "设置本机诊断记录,供管理员排查评估和关系变化。",
"invisible": true
},
"trust_config_version": {
"type": "int",
"default": 0,
"invisible": true,
"description": "信任配置升级标记(内部使用,请勿修改)"
},
"relation_title": {
"type": "object",
"description": "关系称谓",
"hint": "固定词典无需模型。动态称谓在互动后后台生成,查询只读缓存;与关系增长模式独立,保存后重载生效。",
"items": {
"mode": {"type": "string", "default": "fixed", "options": ["fixed", "llm"], "description": "称谓模式", "hint": "fixed:固定词典;llm:按当前人格生成。复杂或不适合公开的结果回退词典。"},
"provider_id": {"type": "string", "default": "", "_special": "select_provider", "description": "称谓生成模型", "hint": "选择已配置的文本模型;留空保持固定称谓。"},
"refresh_cooldown_hours": {"type": "float", "default": 6, "description": "刷新间隔(小时)", "hint": "合并关系变化后的刷新;旧称谓不再符合关系时立即回退词典。"},
"daily_generation_limit": {"type": "int", "default": 10, "description": "每个 Bot 每日生成上限", "hint": "所有群和关系空间合计,UTC 零点换日;0 暂停生成。失败调用也计入。"},
"generation_timeout_seconds": {"type": "float", "default": 30, "description": "生成超时(秒)", "hint": "生成失败不影响聊天、评分和查询。"}
}
},
"relation_daily_caps": {
"type": "object",
"description": "每日分数额度",
Expand Down Expand Up @@ -1215,11 +1233,11 @@
"type": "float",
"default": 2,
"description": "信任度每日加分上限",
"hint": "每人每天正向增信的额度;默认事件不增信。Galgame 为 2 倍,0 禁止增加。"
"hint": "可核验可信事件的每日加分额度;感谢、承诺和道歉本身不加信任。Galgame 为 2 倍,0 禁止增加。"
},
"trust_down": {
"type": "float",
"default": 5,
"default": 8,
"description": "信任度每日扣分上限",
"hint": "每人每天最多扣多少信任度;0 禁止互动扣分,时间衰减另算。"
}
Expand Down
10 changes: 10 additions & 0 deletions api/listeners.py
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ class Deps:
prompts: object | None = None
bot_id: str = ""
passive_activity: object | None = None
titles: object | None = None


@dataclass(frozen=True)
Expand Down Expand Up @@ -135,6 +136,13 @@ async def _freeze_relation(deps, event):
description = deps.favor.describe_relation(
rec.familiarity, rec.favor, rec.trust
)
if deps.titles is not None:
from dataclasses import replace

display = await deps.favor.read_relation_title(
group_id, user_id, event=event, record=rec
)
description = replace(description, title=display["title"])
block = deps.inject.build_relation_block(
template,
relationship=description.text,
Expand Down Expand Up @@ -360,6 +368,8 @@ async def _bg() -> None:
await deps.impressions.maybe_refresh(
group_id, user_id, umo=event.unified_msg_origin
)
if deps.titles is not None and (has_at_bot or is_reply_bot):
deps.titles.schedule(event)
except Exception:
# 意外异常属疑难:warning 必须带堆栈,否则后台静默死因不可查
logger.warning(
Expand Down
4 changes: 2 additions & 2 deletions api/llm_tools.py
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ async def tool_query_favor(
return _reply(
"只能查询你自己的关系称谓。", for_llm=for_llm, status="unavailable"
)
title = await svc.relation_title(group_id, sender)
title = await svc.relation_title(group_id, sender, event=event)
return _reply(
"你与当前 Bot 的关系:" + title + "。",
for_llm=for_llm,
Expand Down Expand Up @@ -84,7 +84,7 @@ async def ranking_rows(svc: FavorService, event: AstrMessageEvent, limit: int):
public, self_rank, avatar_ids = [], None, []
for i, record in enumerate(rows[:count], 1):
label = " ".join((record.nickname or "").split())[:40] or "未命名成员"
title = await svc.relation_title(group_id, record.user_id)
title = await svc.relation_title(group_id, record.user_id, event=event)
public.append({"rank": i, "member": label, "relation_title": title})
avatar_ids.append(str(record.user_id))
if str(record.user_id) == str(event.get_sender_id()):
Expand Down
Loading
Loading