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

## 0.7.0 — 2026-11-11
### 大型更新!
## 0.7.1 — 2026-11-14

这次更新带来个性化动态称谓、持续行为积累信任,以及更直观的关系状态显示。
- **印象跟得上相处的变化**:新互动可以修正旧判断,同一件事只作为一份依据。撤销错误记录后,受影响的印象也会停止用于回复。
- **保留玩笑和自述的语境**:整理资料时保留来源与限定,提醒模型区分成员自述、临时角色扮演和已确认的关系。
- **当前资料,一键预览**:在成员详情查看当前选用的关系、印象和经历,以及取舍原因。预览不调用模型,也不改变关系状态。
- **回复依据,可以回看**:在系统诊断查看当轮实际提供的关系资料与筛选原因。正文需当时开启「完整上下文」且记录完整保留;未保存的内容不会补写。

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

升级保留关系分数与历史记录,自动兼容旧称谓设置。备份和升级方法见 [升级说明](docs/MAINTENANCE_UPGRADE.md)。
诊断未设置档位时,默认改为「原文+评估」;已有明确设置不变,新安装仍默认关闭诊断。

**升级提醒**:本次包含数据结构升级。请先停止插件,备份代码、配置和完整数据目录;回退时需一并恢复升级前的备份。详见 [使用与升级说明](docs/RELATION_MATERIALS.md)。
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -469,3 +469,5 @@ Bond 基于 [yiwuerxin/astrbot_plugin_xinxian](https://github.com/yiwuerxin/astr


注入位置的取舍见 [注入方式评估](docs/research/INJECTION_REVIEW.md);大量成员的计算开销与实测范围见 [页面合成负载记录](docs/research/DASHBOARD_LOAD.md)。

关系资料的只读预览、历史诊断、来源限定与升级回退见 [关系资料说明](docs/RELATION_MATERIALS.md)。
2 changes: 1 addition & 1 deletion _conf_schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -1210,7 +1210,7 @@
},
"detail_level": {
"type": "string",
"default": "assessment",
"default": "raw",
"options": [
"assessment",
"raw",
Expand Down
27 changes: 16 additions & 11 deletions api/listeners.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
from __future__ import annotations

import asyncio
import json
from dataclasses import dataclass

from astrbot.api import logger
Expand Down Expand Up @@ -92,6 +93,7 @@ class RelationSnapshot:
group_id: str
user_id: str
captured_at: float
materials_json: str = "{}"


def _message_identity(event):
Expand Down Expand Up @@ -124,26 +126,21 @@ async def _freeze_relation(deps, event):
snapshot = None
else:
group_id, user_id = identity[1:3]
selection = []
rec, events, captured_at = await deps.favor.read_relation_snapshot(
group_id,
user_id,
count=deps.memory_count,
days=deps.memory_days,
sig_threshold=deps.memory_sig_threshold,
sig_window_mult=deps.memory_sig_window_mult,
selection=selection,
)
template = deps.prompts.resolve("behavior", deps.bot_id, group_id)
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(
materials = deps.inject.build_relation_materials(
template,
relationship=description.text,
impression=rec.impression,
Expand All @@ -156,7 +153,11 @@ async def _freeze_relation(deps, event):
user_id=user_id,
),
captured_at=captured_at,
selection=selection,
impression_valid=rec.impression_valid,
impression_origin=rec.impression_origin,
)
block = materials.pop("block")
snapshot = RelationSnapshot(
block,
rec.familiarity,
Expand All @@ -169,6 +170,7 @@ async def _freeze_relation(deps, event):
group_id,
user_id,
captured_at,
json.dumps(materials, ensure_ascii=False),
)
future.set_result(snapshot)
return deps, snapshot
Expand Down Expand Up @@ -437,18 +439,21 @@ async def _on_llm_request_inner(
origin, snapshot = await _freeze_relation(deps, event)
if snapshot is None:
return
origin.inject.inject(req, snapshot.block)
req._bond_injected_snapshot = snapshot
if snapshot.block:
origin.inject.inject(req, snapshot.block)
req._bond_injected_snapshot = snapshot
origin.favor.record_diagnostic(
group_id,
user_id,
"render",
status="injected",
status="injected" if snapshot.block else "skipped",
after=dict(
familiarity=snapshot.familiarity,
affinity=snapshot.affinity,
trust=snapshot.trust,
),
bands_after=snapshot.bands or None,
term_after=snapshot.term,
material_hash=json.loads(snapshot.materials_json).get("material_hash"),
material_selection=json.loads(snapshot.materials_json).get("selection"),
)
63 changes: 63 additions & 0 deletions api/page_api.py
Original file line number Diff line number Diff line change
Expand Up @@ -403,6 +403,60 @@ def _relation_group(params, mode):
async def handle_member(self):
async def run():
params = await self._params()
if params.get("action") == "preview":
if request.method != "GET":
raise _PageRequestError
bot_id, mode = self._target(params)
group_id = self._required_account(params, "group_id")
user_id = self._required_account(params, "user_id")
deps = self._runtime.peek(bot_id, mode)
if deps is None:
return self._response(
{
"success": True,
"preview": {
"available": False,
"note": "当前空间尚未加载,未生成预览。",
},
}
)
selection = []
rec, events, now = await deps.favor.read_relation_snapshot(
group_id,
user_id,
count=deps.memory_count,
days=deps.memory_days,
sig_threshold=deps.memory_sig_threshold,
sig_window_mult=deps.memory_sig_window_mult,
selection=selection,
)
description = deps.favor.describe_relation(
rec.familiarity, rec.favor, rec.trust
)
preview = deps.inject.build_relation_materials(
deps.prompts.resolve("behavior", bot_id, group_id),
relationship=description.text,
impression=rec.impression,
events=events,
configured_master=deps.favor.is_master(user_id),
identity=dict(
bot_id=bot_id,
scope_mode=mode,
group_id=group_id,
user_id=user_id,
),
captured_at=now,
selection=selection,
impression_valid=rec.impression_valid,
impression_origin=rec.impression_origin,
)
preview.update(
available=True,
injection_enabled=deps.inject_enabled,
note="当前有效数据的只读预览;不是历史实际输入。"
+ ("注入当前已关闭。" if not deps.inject_enabled else ""),
)
return self._response({"success": True, "preview": preview})
_bot_id, _mode, deps = await self._deps(params)
group_id = self._relation_group(params, _mode)
user_id = self._required_account(params, "user_id")
Expand Down Expand Up @@ -736,6 +790,15 @@ async def run():
cleared = await recorder.clear(bot_id, mode)
if not cleared["clear_succeeded"]:
raise _PageOperationError
elif request.method == "GET" and action == "history":
return self._response(
{
"success": True,
"history": recorder.material_history(
await recorder.export(bot_id, mode)
),
}
)
elif request.method == "GET" and action == "export":
return self._response(
{
Expand Down
24 changes: 14 additions & 10 deletions core/impression.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@
import re
import time

from .relation_materials import SOURCE_RULES

IMPRESSION_MAX = 80 # 印象正文长度上限
TAG_MAX = 3 # 标签数量上限
TAG_LEN_MAX = 6 # 单个标签长度上限
Expand Down Expand Up @@ -55,17 +57,19 @@ def build_summary_prompt(
) -> str:
"""构造印象汇总提示词(走一次廉价 LLM 调用)。

samples: 最近评审记录摘要行(如「+0.8 你好可爱啊 —— 夸我可爱」),时间正序。
samples: 带存储来源、成员表达和模型判断的 JSON 资料行,时间正序。
"""
who = (nickname or "").strip() or "该成员"
old = (old_impression or "").strip()
old_line = f"旧印象(可延续可推翻):{old}\n" if old else ""
old_line = f"旧印象(上一轮结论,不是新证据,可延续可推翻):{old}\n" if old else ""
body = "\n".join(samples) or "(暂无记录)"
return (
f"你是「{persona_name}」的印象管理员。根据下面的互动记录,"
f"用{persona_name}的视角给群成员「{who}」写一句印象侧写,并给几个标签。\n\n"
f"{old_line}最近互动记录(增减分 | 发言 | 当时的判断):\n{body}\n\n"
"要求:\n"
f"{old_line}新增来源记录(JSON 资料):\n{body}\n\n"
+ SOURCE_RULES
+ "\n"
+ "要求:\n"
f"- 印象一句话、不超过{IMPRESSION_MAX}字,写这个人的性格/说话风格/和你的关系感觉,"
"要有具体感(如「嘴硬心软,爱用外号逗人」),不要空话\n"
"- 如果这个人前后有了变化,用「以前觉得……,最近……」的双段式写清来龙去脉,"
Expand All @@ -81,22 +85,22 @@ def build_summary_prompt(
def parse_summary(content: str) -> tuple[str, list[str]] | None:
"""解析 LLM 汇总输出「印象:…\n标签:a,b,c」。

印象截断到 IMPRESSION_MAX 字;标签最多 TAG_MAX 个、单个截断到
TAG_LEN_MAX 字、去掉空项与重复;解析失败返回 None(调用方静默跳过)。
印象超过 IMPRESSION_MAX 字则拒收,避免截断限定;标签最多 TAG_MAX 个、超过
TAG_LEN_MAX 字的条目省略、去掉空项与重复;解析失败返回 None(调用方静默跳过)。
"""
text = content or ""
m = _SUMMARY_RE.search(text)
t = _TAGS_RE.search(text)
if not m:
return None
impression = m.group(1).strip()[:IMPRESSION_MAX]
if not impression:
impression = m.group(1).strip()
if not impression or len(impression) > IMPRESSION_MAX:
return None
raw_tags = (t.group(1).strip() if t else "").replace(",", ",")
tags: list[str] = []
for part in raw_tags.split(","):
p = part.strip()[:TAG_LEN_MAX]
if p and p != "无" and p not in tags:
p = part.strip()
if len(p) <= TAG_LEN_MAX and p and p != "无" and p not in tags:
tags.append(p)
if len(tags) >= TAG_MAX:
break
Expand Down
35 changes: 19 additions & 16 deletions core/impression_points.py
Original file line number Diff line number Diff line change
@@ -1,13 +1,7 @@
"""印象带权点模型(P-C,GOAL Phase 3)。

把"一句话印象"升级为带权印象点集:LLM 提 (point, weight 1-10);
相似点合并(SequenceMatcher ≥ 0.6,权重求和、保留最长描述);活跃点
>10 时按 weight × 时间权重加权随机保留 10 条,挤出项并入长印象。
时间权重阶梯(GOAL 规格,非单调):1h=1.0 → 24h=0.7 → 7d=0.95 →
30d=0.1(更早 0.05)——一小时内最新鲜、一天内让位、一周内回稳(长期
未翻旧账的点重新有分量)、一个月后近乎遗忘。好感负向变化时新点权重
×1.5(损失厌恶)。分析提示词把其他群友昵称替换为「用户A/B」防串像。
纯函数可单测;存储为 favor.points(schema v9,JSON 数组字符串)。
"""印象点解析与完整条目呈现。

运行路径使用模型修订后的当前点集,不累加旧结论的权重。
merge_points/retain 等保留为旧数据工具,当前生成不再调用。
"""

from __future__ import annotations
Expand All @@ -16,22 +10,25 @@
import re
from difflib import SequenceMatcher

from .relation_materials import SOURCE_RULES

MERGE_SIMILARITY = 0.6
MAX_ACTIVE_POINTS = 10
LOSS_AVERSION = 1.5

POINTS_PROMPT = """你是「{persona_name}」的印象管理员。根据下面群成员「{who}」的互动记录,提取 3~6 条关于 TA 的印象点。
POINTS_PROMPT = """你是「{persona_name}」的印象管理员。根据下面群成员「{who}」的互动记录,根据新互动修订当前印象,输出 1~6 条完整的当前印象点(每条不超过80字)。旧点可保留、改写或删除,不必重复输出旧判断。

{old_points}最近互动记录(增减分 | 发言 | 当时的判断):
{old_points}新增来源记录(JSON 资料):
{samples}

要求:
- 每条印象点:一句具体描述(这个人的性格/说话风格/和你的关系感觉)+ 权重 1~10(越核心越重)
- 记录里出现的其他群友一律只称「用户A」「用户B」(按出现顺序编号),不要写他们的名字
- 负面得罪(增减分明显为负的记录)对应的印象点权重可以给高些
- 旧点的权重不是证据数量;不得因重复引用而加权,新互动可以纠正旧点

只输出 JSON 数组,不要其他内容:
[{{"point": "印象描述", "weight": 5}}, ...]"""
POINTS_PROMPT += "\n" + SOURCE_RULES


def _similarity(a: str, b: str) -> float:
Expand Down Expand Up @@ -141,11 +138,12 @@ def parse_points(raw: str) -> list[dict] | None:
return None
pts = [
{
"point": str(it.get("point") or "").strip()[:80],
"point": str(it.get("point") or "").strip(),
"weight": max(1, min(10, int(float(it.get("weight") or 5)))),
}
for it in arr
if isinstance(it, dict) and str(it.get("point") or "").strip()
if isinstance(it, dict)
and 0 < len(str(it.get("point") or "").strip()) <= 80
]
return pts or None
except Exception:
Expand All @@ -160,4 +158,9 @@ def render_impression(points: list[dict], limit: int = 80) -> str:
)[:3]
if not top:
return ""
return ";".join(str(p["point"]) for p in top)[:limit]
selected = []
for point in top:
candidate = ";".join([*selected, str(point["point"])])
if len(candidate) <= limit:
selected.append(str(point["point"]))
return ";".join(selected)
4 changes: 4 additions & 0 deletions core/models.py
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,10 @@ class FavorRecord:
trust_maintained_at: float | None = None
affinity_floor_reference: float | None = None

impression_revision: int = 0
impression_valid: bool = True
impression_origin: str = "legacy"

@property
def affinity(self) -> float:
"""亲近度沿用 favor 存储,避免维护两份数值。"""
Expand Down
Loading
Loading