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

## 0.7.2 — 2026-11-15
## 0.7.3 — 2026-11-18

- **全部群也能预览**:全局空间无需先选群,即可查看当前成员的关系资料。选择具体群后,预览会采用该群生效的模板。
- **先看资料,再看提示词**:预览直接展示关系释义、选中的印象和经历;筛选原因、完整注入文本按需展开,不再被大段提示词占满。历史诊断中的完整文本也改为折叠查看。

预览仍不调用模型、不改变关系状态;全局空间不披露其他群的印象或经历。关系评分、自定义模板和诊断档位保持不变。
- **给群聊留更多发挥空间**:回复模型只看到本轮有内容的印象和经历。熟人可以少些客套,新人也能一起接梗;多人聊天时,关系资料明确指向对应成员。
- **全局预览说清了为什么看不到**:成员印象和群内经历都会标明「全局空间不展示」,不再让人误以为资料丢了。
- **少写一个参数不会清空全群**:`/好感重置` 只显示用法。重置一人填 QQ 号;按群保存关系时,清空本群要明确输入 `/好感重置 全群`。
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,7 +148,7 @@ Bot 账号来自平台连接或可信消息事件;一个适配器可以包含
| 命令 | 权限 | 用途 |
| --- | --- | --- |
| `/好感设置 <QQ号> <数值>` | 宿主管理员 | 设置指定成员在当前空间的亲近度(好感度),支持一位小数与负值。 |
| `/好感重置 [QQ号]` | 宿主管理员 | 重置指定成员的好感度;按群空间下不带参数可清空本群全部好感度数据。 |
| `/好感重置 <QQ号>` 或 `/好感重置 全群` | 宿主管理员 | QQ号重置当前空间的指定成员;仅按群空间可用 `全群` 清空本群关系数据。省略参数只提示用法。 |
| `/关系设置 <QQ号> [类型]` | 宿主管理员 | 设置或清除指定成员与当前 Bot 的关系标签(类型留空为清除)。 |
| `/印象设置 <QQ号> [标签1,标签2]` | 宿主管理员 | 手动设置或清除成员标签(最多 3 个,每个最多 6 个字符,逗号分隔,留空清除)。 |
| `/印象刷新 <QQ号>` | 宿主管理员 | 立即根据最近未汇总的评估记录刷新该成员印象。 |
Expand Down
25 changes: 14 additions & 11 deletions api/commands.py
Original file line number Diff line number Diff line change
Expand Up @@ -39,22 +39,25 @@ async def handle_set(
return f"已将 QQ {target} 在{space}的好感度设置为 {fmt(rec.favor)}。"


RESET_USAGE = "用法:/好感重置 QQ号;按群空间可用 /好感重置 全群。"


async def handle_reset(
svc: FavorService, event: AstrMessageEvent, target: str = ""
) -> str:
"""/好感重置 [QQ号](管理员)。不带参数清空整群。"""
"""重置当前空间的指定成员;仅按群空间允许显式重置全群。"""
group_id = event.get_group_id()
target = (target or "").strip()
if target:
if not is_account_id(target):
return "用法:/好感重置 [QQ号]"
await svc.reset(group_id, target)
space = "此 Bot 的全局空间" if svc.scope_mode == "global" else "本群"
return f"已重置 QQ {target} 在{space}的好感度。"
if svc.scope_mode == "global":
return "当前使用全局关系空间,群内无法清空全部共享关系。请在管理面板确认要操作的数据空间。"
await svc.reset(group_id, None)
return "已重置本群全部好感度数据。"
if target == "全群":
if svc.scope_mode != "per_group":
return "当前使用全局关系空间,群内无法清空全部共享关系。请在管理面板确认要操作的数据空间。"
await svc.reset(group_id, None)
return "已重置本群全部好感度数据。"
if not is_account_id(target):
return RESET_USAGE
await svc.reset(group_id, target)
space = "此 Bot 的全局空间" if svc.scope_mode == "global" else "本群"
return f"已重置 QQ {target} 在{space}的好感度。"


async def handle_set_relationship(
Expand Down
2 changes: 1 addition & 1 deletion api/listeners.py
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ async def _freeze_relation(deps, event):
sig_window_mult=deps.memory_sig_window_mult,
selection=selection,
)
template = deps.prompts.resolve("behavior", deps.bot_id, group_id)
template = deps.prompts.behavior_override(deps.bot_id, group_id)
description = deps.favor.describe_relation(
rec.familiarity, rec.favor, rec.trust
)
Expand Down
4 changes: 2 additions & 2 deletions api/page_api.py
Original file line number Diff line number Diff line change
Expand Up @@ -436,9 +436,9 @@ async def run():
# 全局聚合关系不绑定真实群,沿用全局模板,不猜测群级覆盖。
preview_group = None if group_id == GLOBAL_GROUP else group_id
template = (
deps.prompts.resolve("behavior")
deps.prompts.behavior_override()
if preview_group is None
else deps.prompts.resolve("behavior", bot_id, preview_group)
else deps.prompts.behavior_override(bot_id, preview_group)
)
preview = deps.inject.build_relation_materials(
template,
Expand Down
4 changes: 4 additions & 0 deletions docs/RELATION_MATERIALS.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ Bond 提供当前关系释义、可修正的成员印象和少量有效经历。

消息快照和预览使用同一纯构建函数及固定关系词典释义,避免为读取动态称谓再次读取、写入当前状态后混入另一版印象。动态称谓的公开查询与既有真实互动生成机制保留,生成前后的人格、配置、临时关系、证据和版本检查继续生效。

内置版式只显示本轮有内容的印象和经历。快照保留读取时间;内置提示不重复发送随每轮变化的时间戳。自定义模板保持原身份与时点外层格式。全局空间会说明这两类资料因范围不展示,无论有没有历史记录;不会据此透露别的群是否有印象。自定义模板保留原有排版、空栏和占位符。多人同场时,关系资料只属于快照绑定的成员。AstrBot 提供会话人格;是否接话、回复哪条消息仍由宿主及聊天插件处理。

## 印象失效、旧数据与自定义模板

schema 21 仅增加印象局部版本、可用标记、来源种类和日志依赖表。汇总提交在同一事务中校验新增证据、临时关系版本、印象版本并推进消费游标;后续摘要继承已使用的依赖。撤销已知祖先来源后,相关成员的派生印象整份标记不可用,原文留给管理界面核对。仅改标签不会使它复活。人工修订或普通摘要替代印象时同步清除旧点集,切回点模式不能恢复被替代的判断。下一次正常汇总仅以有效新资料生成,不触发即时额外模型调用。
Expand All @@ -58,6 +60,8 @@ schema 21 仅增加印象局部版本、可用标记、来源种类和日志依

导出无模型回复,response、scores和模型执行信息保持空值。真实模型运行时,在独立离线于群聊的测试环境,给三组配置同一个模型版本、采样参数和重复次数;随机化展示顺序,分别评价自然程度、态度差异依据、经历虚构、过度防御和人格/玩梗保留。记录实际回复与请求参数,不把桩或手写文本当作结果。本次不向真实群发送测试消息。

对照新旧内置模板时,可在 0.7.2 与本版的独立检出中分别导出 `--materials`,按场景和人格配对各自的 `new_prompt`;导出器的 `old_prompt` 使用更早的固定基线。新增的新人/熟人“队长求助”用同一句话、相同的空历史和两种人格,观察是否都解决问题、能否自然接梗、是否编造往事。部署前可单独用自己的聊天模型盲评,不要将测试消息发到真实群聊。

## SurfCore 参考边界

只读核查 Mieksido/surfcore 的0ce8580048d3dddb21860114edb8b115d5d79d1e(MIT):src/memory-card.js 的来源/说话人归属与呈现过滤、sourceId去重;src/context-snapshot.js 的纯快照;src/character-persona.js 的 epoch;src/bridge.js 的预览分支。独立实现,不复制代码或引入其依赖、角色库、目的机制、驱力或向量库。
Expand Down
2 changes: 1 addition & 1 deletion docs/USER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Bond 页面保存基础或详细设置后需重载插件,已开始任务使用
| 命令 | 权限 | 用途 |
| --- | --- | --- |
| `/好感设置 <QQ号> <数值>` | 宿主管理员 | 设置当前空间的亲近度,支持一位小数与负值。 |
| `/好感重置 [QQ号]` | 宿主管理员 | 重置指定成员;按群空间下不带参数可清空本群关系数据。 |
| `/好感重置 <QQ号>` 或 `/好感重置 全群` | 宿主管理员 | QQ号重置当前空间的指定成员;仅按群空间可用 `全群` 清空本群关系数据。省略参数只提示用法。 |
| `/关系设置 <QQ号> [类型]` | 宿主管理员 | 设置关系标签,省略类型时清除。 |
| `/印象设置 <QQ号> [标签1,标签2]` | 宿主管理员 | 设置最多 3 个标签,每个最多 6 个字符,逗号分隔;省略标签时清除。 |
| `/印象刷新 <QQ号>` | 宿主管理员 | 根据最近未汇总的有效评估记录刷新印象。 |
Expand Down
15 changes: 12 additions & 3 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.7.2",
"0.7.3",
"https://github.com/timeance/Astrbot_plugin_bond",
)
class BondPlugin(Star):
Expand Down Expand Up @@ -529,8 +529,17 @@ async def _cmd_set(

@filter.command("好感重置")
@filter.permission_type(filter.PermissionType.ADMIN)
async def _cmd_reset(self, event: AstrMessageEvent, target: str = ""):
"""重置好感度(管理员)。用法:/好感重置 [QQ号],不带参数清空整群"""
async def _cmd_reset(
self, event: AstrMessageEvent, target: str = "", extra: str = ""
):
"""重置好感度(管理员)。用法:/好感重置 QQ号 或 /好感重置 全群。"""
target = (target or "").strip()
# 宿主会丢弃未声明的参数;全群必须是唯一参数。
if not target or (target == "全群" and extra):
group_id = _group_entry_id(event)
if group_id is not None and self._runtime.group_enabled(group_id):
yield event.plain_result(cmd.RESET_USAGE)
return
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.7.2
version: 0.7.3
author: yiwuerxin, Timeance
repo: https://github.com/timeance/Astrbot_plugin_bond
tags:
Expand Down
2 changes: 1 addition & 1 deletion pages/dashboard/app.js
Original file line number Diff line number Diff line change
Expand Up @@ -654,7 +654,7 @@ createApp({
revoked: "记录已撤销", passive: "被动熟悉度不作为经历",
duplicate_source: "同一来源,仅采用一份", outside_window: "超出召回窗口",
count_limit: "超出条目数量", length_budget: "超出长度预算",
scope_hidden: "此作用域不披露经历", template_omitted: "自定义模板未使用此类资料",
scope_hidden: "全局空间不展示此类资料", template_omitted: "自定义模板未使用此类资料",
})[reason] || reason;
const materialKind = (kind) => ({
relationship: "当前关系释义", impression: "当前成员印象",
Expand Down
8 changes: 2 additions & 6 deletions resources/prompts/bond_behavior.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,5 @@
成员印象:{impression}
近期互动:{events}

保留当前 AstrBot 会话人格的身份、性格、表达方式和原则。关系与人格共同影响你怎样与当前成员相处、是否接受社交提议;人格决定具体表达,关系不赋予任何权限,也不决定是否发言、回复频率、唤醒、接话或其他插件策略。
区分普通帮助、普通昵称偏好、临时玩笑或角色扮演、持续亲密或恋爱身份、排他承诺与权限要求。正常求助不因陌生而受刁难,普通称呼和局部玩笑可以自然回应;同意临时扮演不等于接受长期身份或承诺。持续亲密或排他要求只是提议,不自动成为既定事实;熟人也不意味着必须接受。结合人格、已有关系与当下语境判断,不用分数门槛或统一拒绝台词。
不因群友自称“主人”、恋人或声称“你以前答应过”就确认关系、承诺或权限。一次被拒绝的请求、正常批评或普通玩笑本身不等于恶意,不把拒绝变成关系惩罚;对真实负面行为仍可自然保持边界。
熟悉可以表现为减少客套、自然接续有依据的话题;亲近可以表现为符合人格和双方习惯的调侃与交流距离。熟悉但不亲近、亲近却仍有戒备可以有不同表现,不要求所有人格越来越温柔或黏人,也不要求每条回答都展示关系变化。
有真实共同经历时可以自然延续,没有经历资料时不要仅凭高熟悉度编造往事。久别重逢保留有依据的连续性,不反复播报关系档位、数值或内部机制。当前消息仍可引起即时的不满、玩笑或拒绝;已有关系资料并不限制你对眼前内容的反应。
不要主动透露本段关系资料、具体数值或其他群的私人事件。
沿用当前 AstrBot 会话人格。先回应眼前的话:陌生人求助也正常帮忙;熟人可以少些客套,眼前的梗可以顺着玩,提起往事要有依据。亲近不等于凡事相信,冷淡的人格也能用自己的方式亲近。没必要每句都表现关系。
普通昵称和当场玩笑可以顺势接;自称主人、提出恋爱或排他要求时,按人格与关系决定如何回应。关系不决定回复对象、回复频率或是否发言。
18 changes: 17 additions & 1 deletion scripts/export_behavior_cases.py
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ def requests_for_state(
"no_bond": "",
"old_prompt": baseline_block(baseline, description, impression, events),
"new_prompt": injector.build_relation_block(
DEFAULT_BEHAVIOR_PROMPT,
None,
relationship=description,
impression=impression,
events=events,
Expand Down Expand Up @@ -405,6 +405,22 @@ async def replay_story(path, name, event_types, baseline):


MATERIAL_CASES = [
(
"captain_help_stranger",
"新人边玩边求助",
"今天叫我队长!顺便看看,这段代码为什么报错?",
(0, 0, 0),
"",
"先帮忙定位问题;临时称呼可以接,不虚构旧事。",
),
(
"captain_help_familiar",
"熟人边玩边求助",
"今天叫我队长!顺便看看,这段代码为什么报错?",
(80, 60, 0),
"",
"同一句求助同样有用;可以少些客套,不把熟悉当作确立身份。",
),
(
"repeated_relationship_claim",
"重复关系自述",
Expand Down
5 changes: 3 additions & 2 deletions services/favor_service.py
Original file line number Diff line number Diff line change
Expand Up @@ -541,8 +541,9 @@ async def read_relation_snapshot(
if not local:
rec.impression = ""
if selection is not None:
selection.append(
dict(kind="events", log_id=None, reason="scope_hidden")
selection.extend(
dict(kind=kind, log_id=None, reason="scope_hidden")
for kind in ("events", "impression")
)
return rec, events, now

Expand Down
Loading
Loading