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
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 目标与范围

本项目为 `astrbot_plugin_bond`,面向 AstrBot 社区。当前已实现 Bot/作用域隔离、三维关系、分级评估、人格适配与原生管理面板;LivingMemory 集成已按维护者决策移除。使用范围见 `README.md`,验证记录见 `docs/ACCEPTANCE.md`。默认关闭评估、注入及麦麦联动,不宣称可生产使用。
本项目为 `astrbot_plugin_bond`,面向 AstrBot 社区。当前已实现 Bot/作用域隔离、三维关系、分级评估、人格适配与原生管理面板;LivingMemory 集成已按维护者决策移除。使用范围见 `README.md`,验证记录见 `docs/ACCEPTANCE.md`。新安装默认开启关系注入,默认关闭自动评估、动态称谓及麦麦联动,保留旧配置的明确选择。

用户已授权按 PR0 至 PR7 分阶段开发、测试与创建 PR。后续按可审查阶段交付,不自动合并 PR、不自动部署;正式版本的自动发布按下述已授权工作流执行。

Expand Down
17 changes: 12 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,16 @@
# 更新说明

## 0.6.0 — 2026-11-10
## 0.7.0 — 2026-11-11
### 大型更新!

- 固定关系称谓扩展至 75 个,初识、熟悉和亲近阶段的变化更丰富。
- 新增人格称谓模式,按 Bot 人格在后台生成,查榜直接复用。
- 完善信任积累、分级扣分和修复机制,让可靠行为与失信行为得到更合理的反馈。
这次更新带来个性化动态称谓、持续行为积累信任,以及更直观的关系状态显示。

升级会统一五项信任设置,保留原始分数和历史记录;显示的信任度可能变化。详情见 [升级说明](README.md#升级备份与回滚)。
- **称谓可以随人格生成。** 开启「动态称谓」后,Bot 会根据完整人格和熟悉度、亲近度、信任度生成称谓,也能表达亲近却戒备等复杂关系。模型默认跟随复核模型,固定词典仍是默认选项。
- **关系变化后再刷新称谓。** 任一维度跨过 5 分边界后检查刷新,最短间隔 12 小时,每 Bot 每日最多 30 次调用。查榜直接使用已保存的称谓,无需等待生成。
- **持续尊重边界可以增加信任。** 14 天内积累至少 3 件独立、可核验的行为,可获得一次信任奖励,每 5 天最多一次。
- **一眼看出哪些维度在衰减。** 管理页面会显示「F 衰减中」「F A 衰减中」等状态,字母沿用各维度的颜色。
- **个性化设置集中管理。** 回复参考与动态称谓放在「个性化功能」中,设置说明同步精简。新安装默认在回复中体现关系,已有关闭选择会保留。
- **调整部分固定称谓。** 优化初识等阶段的用词,新增「疏远而戒备的熟人」,词典共 76 个称谓。
- **使用说明补充管理页面截图。** README 保留原有介绍,更新操作说明,并加入深浅色总览和成员详情截图。

升级保留关系分数与历史记录,自动兼容旧称谓设置。备份和升级方法见 [升级说明](docs/MAINTENANCE_UPGRADE.md)。
93 changes: 66 additions & 27 deletions README.md

Large diffs are not rendered by default.

316 changes: 176 additions & 140 deletions _conf_schema.json

Large diffs are not rendered by default.

9 changes: 7 additions & 2 deletions api/listeners.py
Original file line number Diff line number Diff line change
Expand Up @@ -276,6 +276,9 @@ async def on_group_message(
has_at_bot, is_reply_bot = _chain_flags(event)
reply_metadata = _reply_metadata(event)
original_event = event
title_interaction = not getattr(
event, "_bond_cmd_done", False
) and not text.lstrip().startswith(("/", "!", "!"))
passive_batch = None
passive_activity = getattr(deps, "passive_activity", None)
if (
Expand Down Expand Up @@ -368,8 +371,6 @@ 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 All @@ -379,6 +380,10 @@ async def _bg() -> None:
finally:
CURRENT.reset(diagnostic_token)

# 普通群消息也观察跨桶;取消卸载时不再发起后续后台工作。
if deps.titles is not None and title_interaction:
await deps.titles.observe(event)

deps.registry.spawn(_bg(), name=f"judge:{group_id}/{user_id}")


Expand Down
115 changes: 111 additions & 4 deletions core/assessment.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
import hashlib
import json
import math
import time
from dataclasses import dataclass

from .relation_policy import EVENT_TYPES, TRUST_EVENTS
Expand Down Expand Up @@ -61,6 +62,8 @@ class Verdict:
should_update: bool = True
reference_message_id: str = ""
reference_excerpt: str = ""
behavior_message_id: str = ""
behavior_excerpt: str = ""


@dataclass(frozen=True)
Expand All @@ -75,6 +78,14 @@ class TrustEvidence:
current_id: str
reference_id: str
reference_excerpt: str = ""
reference_at: float = 0.0
behavior_id: str = ""
behavior_key: str = ""
behavior_excerpt: str = ""
fingerprint: str = ""
current_key: str = ""
observed_at: float = 0.0
source_events: tuple[str, ...] = ()


def verify_trust_evidence(interaction, first, reviewed, payload) -> TrustEvidence:
Expand All @@ -94,7 +105,8 @@ def verify_trust_evidence(interaction, first, reviewed, payload) -> TrustEvidenc
or first.reference_message_id != reviewed.reference_message_id
):
raise ValueError("信任事件缺少一致复核")
turns = json.loads(payload)["recent_turns"]
data = json.loads(payload)
turns = data["recent_turns"]
anchor = next(
(
turn
Expand All @@ -109,7 +121,45 @@ def verify_trust_evidence(interaction, first, reviewed, payload) -> TrustEvidenc
for item in (first, reviewed)
):
raise ValueError("信任证据引用不存在或不能核验")
# 同一事实的跨消息补述、跨日重试、改用另一事件名不能重复奖励/惩罚。
# 行为来源与边界分开;同一边界之后可以出现多件独立的实际行为。
behavior_id = first.behavior_message_id
if behavior_id != reviewed.behavior_message_id:
raise ValueError("行为来源缺少一致复核")
current = dict(
message_id=interaction.message_id,
role="user",
text=interaction.text,
ts=data.get("trusted_metadata", {}).get("observed_at", time.time()),
)
behavior = (
next(
(turn for turn in [current, *turns] if turn["message_id"] == behavior_id),
None,
)
if behavior_id
else anchor
)
if behavior is None or (
behavior_id
and any(
not item.behavior_excerpt or item.behavior_excerpt not in behavior["text"]
for item in (first, reviewed)
)
):
raise ValueError("行为来源不存在或不能核验")
reference_at = float(anchor.get("ts", 0))
observed_at = float(behavior.get("ts", time.time()))
if first.event_type == "boundary_respected" and (
not behavior_id
or behavior["role"] != "user"
or behavior_id == anchor["message_id"]
or reference_at <= 0
or not math.isfinite(reference_at)
or not math.isfinite(observed_at)
or observed_at < reference_at
or observed_at > time.time()
):
raise ValueError("尊重行为需要明确边界之后的独立可核验来源")
key = [
interaction.platform,
interaction.bot_id,
Expand All @@ -118,6 +168,11 @@ def verify_trust_evidence(interaction, first, reviewed, payload) -> TrustEvidenc
anchor["message_id"],
]
event_id = "trust:" + hashlib.sha256(json.dumps(key).encode()).hexdigest()
behavior_key = hashlib.sha256(
json.dumps(key[:-1] + [behavior["message_id"]], ensure_ascii=False).encode()
).hexdigest()
if first.event_type == "boundary_respected":
event_id = "trust:boundary:" + behavior_key
return TrustEvidence(
interaction.bot_id,
interaction.group_id,
Expand All @@ -127,6 +182,24 @@ def verify_trust_evidence(interaction, first, reviewed, payload) -> TrustEvidenc
interaction.message_id,
anchor["message_id"],
reviewed.reference_excerpt,
reference_at,
behavior["message_id"],
behavior_key,
reviewed.behavior_excerpt if behavior_id else reviewed.reference_excerpt,
hashlib.sha256(
" ".join(behavior["text"].split()).casefold().encode()
).hexdigest(),
interaction.event_id,
observed_at,
tuple(
sorted(
{
turn["source_event_id"]
for turn in (anchor, behavior)
if turn.get("source_event_id")
}
)
),
)


Expand All @@ -138,7 +211,13 @@ def parse_verdict(raw: str, interaction: Interaction) -> Verdict:
or not required <= data.keys()
or data.keys()
- required
- {"should_update", "reference_message_id", "reference_excerpt"}
- {
"should_update",
"reference_message_id",
"reference_excerpt",
"behavior_message_id",
"behavior_excerpt",
}
):
raise ValueError("评估结构不符")
# 旧三字段响应继续可读;新协议显式让模型对语义重复和不应计分弃权。
Expand Down Expand Up @@ -175,7 +254,28 @@ def parse_verdict(raw: str, interaction: Interaction) -> Verdict:
raise ValueError("信任引用格式无效")
if kind in TRUST_EVENTS and should_update and (not ref_id or not excerpt):
raise ValueError("信任事件需要真实记录引用")
return Verdict(kind, confidence, evidence, should_update, ref_id, excerpt)
behavior_id = data.get("behavior_message_id", "")
behavior_excerpt = data.get("behavior_excerpt", "")
if (
not isinstance(behavior_id, str)
or len(behavior_id) > 220
or not isinstance(behavior_excerpt, str)
or len(behavior_excerpt) > 2000
or bool(behavior_id) != bool(behavior_excerpt)
):
raise ValueError("行为引用格式无效")
if kind == "boundary_respected" and should_update and not behavior_id:
raise ValueError("尊重边界需要独立行为来源")
return Verdict(
kind,
confidence,
evidence,
should_update,
ref_id,
excerpt,
behavior_id,
behavior_excerpt,
)


def locally_relevant(text: str, directed: bool) -> bool:
Expand Down Expand Up @@ -215,10 +315,17 @@ def needs_review(verdict: Verdict, text: str) -> bool:
event_type 只能是:"""
SYSTEM_PROMPT += ", ".join(EVENT_TYPES)
TRUST_CONTRACT = """
可用信任类别包括 boundary_respected。
信任事件另需 reference_message_id 和 reference_excerpt(recent_turns 中真实 Bot 回复的连续原文)。
普通事件省略这两个字段。不允许以当前用户的自称、转述、承诺、道歉、夸奖或服从作为核验结果。
verified_correction:此前记录已经独立确认可核验纠错;promise_kept:明确约定且记录确认实际履行;
repair_action:记录已确认失误后的实质修正。仅说“完成了”“我改了”不够。
boundary_respected:Bot 已明确表达具体边界,之后出现可直接观察、能独立核验的尊重行为。
此类每条只是候选证据,由本地累计14天内至少3件独立行为后奖励一次,每成员关系每5天最多一次。
道歉、承诺、沉默、服从、仅停止发言或自称已经尊重均不算;不能把同一行为的补述当作新的行为。
此类必须另给 behavior_message_id 和 behavior_excerpt,指向当前 trusted_metadata.message_id 或 recent_turns 中实际行为的最早可验证来源及连续原文。
其他正向信任类别如与已记录行为有关,也应给这两个字段,不能更换类别或引用重复奖励。
boundary_evidence 中的既有行为供比较独立性,已消费或失效的行为也不得改写、补述后再用。
boundary_violation:具体边界已明确传达,当前行为确实越界;repeated_pressure:边界后再次实质施压,非普通追问;
deliberate_deception:记录与当前事实性主张明确矛盾且有蓄意误导证据,缺失记录不等于说谎;
severe_manipulation:确凿的严重欺骗/强迫,不能用普通角色玩笑、正常批评或测试性指令代替。
Expand Down
26 changes: 26 additions & 0 deletions core/config_migrations.py
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,32 @@ def migrate_saved_defaults(cfg: dict) -> list:
if isinstance(passive, dict) and type(passive.get("enabled")) is bool:
cfg["passive_familiarity"] = passive["enabled"]
changed.append("passive_familiarity")
title = cfg.get("relation_title")
if isinstance(title, dict):
mode = title.get("mode")
if mode:
if mode not in {"fixed", "llm"}:
raise ValueError("旧称谓模式无效")
title["enabled"] = mode == "llm"
title["mode"] = ""
changed.extend(["relation_title.enabled", "relation_title.mode"])
# 仅旧模式下的已知默认额度升级为 30,保留新配置中有效的小额度。
for key, old, new in (
("refresh_cooldown_hours", 6, 12),
("daily_generation_limit", 10, 30),
):
if type(title.get(key)) in (int, float) and title[key] == old:
title[key] = new
changed.append(f"relation_title.{key}")
# 存量越界值显式迁移并持久化,避免运行时静默忽略已保存的设置。
for key, minimum, maximum, default in (
("refresh_cooldown_hours", 12, 720, 12),
("daily_generation_limit", 0, 30, 30),
):
value = title.get(key)
if type(value) in (int, float) and not minimum <= value <= maximum:
title[key] = default
changed.append(f"relation_title.{key}")
levels = cfg.get("levels")
if not isinstance(levels, dict):
return changed
Expand Down
31 changes: 16 additions & 15 deletions core/relation_lexicon.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
from bisect import bisect_right
from dataclasses import dataclass

LEXICON_VERSION = "3"
LEXICON_VERSION = "4"
BAND_EDGES = (
(1.0, 5.0, 40.0, 70.0),
(-40.0, -10.0, 10.0, 40.0),
Expand Down Expand Up @@ -39,13 +39,13 @@ def text(self) -> str:

# 词条是唯一文案源;docs/RELATION_LEXICON.md 由开发脚本生成。
TERMS = {
"r01": ("保持距离", "态度疏远并保持戒备;仍按当前人格礼貌回应。"),
"r01": ("疏远而戒备", "态度疏远并保持戒备;仍按当前人格礼貌回应。"),
"r02": ("疏远而谨慎", "缺少亲近感,交往时谨慎保留。"),
"r03": ("疏离之交", "倾向保持距离,信任态度暂有保留。"),
"r04": ("疏远但放心", "亲近感较弱,但信任态度相对放松。"),
"r05": ("疏远但信赖", "虽然疏远,仍保有较强信任;两者同时成立。"),
"r06": ("有所防备", "态度偏淡,同时有明确戒备。"),
"r07": ("谨慎往来", "态度偏淡,信任上也较谨慎。"),
"r06": ("疏淡而戒备", "态度偏淡,同时有明确戒备。"),
"r07": ("疏淡而谨慎", "态度偏淡,信任上也较谨慎。"),
"r08": ("生疏之交", "不太熟悉,态度偏淡,信任有所保留。"),
"r09": ("客气而放心", "交往偏客气疏淡,信任态度较为放松。"),
"r10": ("客气而信赖", "虽不热络,仍保有较强信任。"),
Expand Down Expand Up @@ -97,20 +97,20 @@ def text(self) -> str:
"r53": ("亲近伙伴", "交互上很熟络,态度亲近,信任较为放松。"),
"r54": ("可信伙伴", "交互上很熟络,态度亲近,当前有较强信任。"),
"r55": ("亲密伙伴", "交互上很熟络,亲近感较强,信任较为放松。"),
"r56": ("新相识", "开始相识,态度平和,信任仍有保留。"),
"r57": ("渐熟的相识", "已有一些交流,逐渐熟悉,亲疏态度平和,信任仍有保留。"),
"r56": ("浅交之人", "已有少量交集,态度平和,信任仍有保留。"),
"r57": ("寻常相识", "已有一些交流,亲疏态度平和,信任仍有保留;不表示正在升温。"),
"r58": ("相熟之人", "已有较多相识,态度平和,信任仍有保留。"),
"r59": ("谨慎的新相识", "开始相识,态度平和,信任较谨慎。"),
"r60": ("戒备的新相识", "开始相识,态度平和,但有明确戒备。"),
"r61": ("放心的新相识", "开始相识,态度平和,信任较为放松。"),
"r62": ("可信的新相识", "开始相识,态度平和,当前有较强信任,不补造共同经历。"),
"r59": ("交浅而谨慎", "交集尚浅,态度平和,信任较谨慎。"),
"r60": ("交浅而戒备", "交集尚浅,态度平和,但有明确戒备。"),
"r61": ("交浅但放心", "交集尚浅,态度平和,信任较为放松。"),
"r62": ("交浅却信赖", "交集尚浅,态度平和,当前有较强信任,不补造共同经历。"),
"r63": ("放心的熟面孔", "已有一定相识,态度平和,信任较为放松。"),
"r64": ("可信的熟面孔", "已有一定相识,态度平和,当前有较强信任。"),
"r65": ("有好感的新相识", "开始相识且有亲近意愿,信任仍有保留。"),
"r66": ("亲切的新相识", "开始相识,态度亲近,信任较为放松。"),
"r67": (
"可信的新朋友",
"开始相识,当前已有亲近感和较强信任;朋友仅表达 Bot 的态度。",
"投缘而信赖",
"交集尚浅,当前已有亲近感和较强信任;仅表达 Bot 的态度。",
),
"r68": ("亲近的新相识", "开始相识但亲近感较强,信任较为放松;不预设恋爱。"),
"r69": ("亲近的相识", "已有一定相识,亲近感较明显,信任仍有保留。"),
Expand All @@ -120,6 +120,7 @@ def text(self) -> str:
"r73": ("熟络但谨慎", "交互上很熟络,亲疏态度平和,信任仍较谨慎。"),
"r74": ("熟络而放心", "交互上很熟络,亲疏态度平和,信任较为放松。"),
"r75": ("熟络而信赖", "交互上很熟络,亲疏态度平和,当前有较强信任。"),
"r76": ("疏远而戒备的熟人", "已经熟悉,但态度疏远且有明确戒备;三者同时成立。"),
}

# 局部展示细分,不增加主档位、不改变分数;未匹配时仍使用125格原词典。
Expand Down Expand Up @@ -160,7 +161,7 @@ def text(self) -> str:
("r01", "r02", "r03", "r04", "r05"),
("r06", "r07", "r26", "r09", "r10"),
("r11", "r12", "r27", "r14", "r15"),
("r16", "r17", "r18", "r28", "r20"),
("r16", "r17", "r18", "r19", "r20"),
("r21", "r22", "r23", "r24", "r25"),
),
(
Expand All @@ -171,14 +172,14 @@ def text(self) -> str:
("r21", "r22", "r23", "r37", "r38"),
),
(
("r39", "r02", "r40", "r04", "r05"),
("r76", "r02", "r40", "r04", "r05"),
("r06", "r07", "r41", "r09", "r10"),
("r39", "r42", "r43", "r44", "r45"),
("r21", "r22", "r46", "r47", "r36"),
("r21", "r22", "r48", "r37", "r49"),
),
(
("r39", "r02", "r40", "r04", "r05"),
("r76", "r02", "r40", "r04", "r05"),
("r06", "r07", "r50", "r09", "r10"),
("r39", "r42", "r51", "r44", "r45"),
("r21", "r22", "r52", "r53", "r54"),
Expand Down
Loading
Loading