43 KiB
43 KiB
Changelog
本项目遵循面向用户体验的版本记录。日期使用北京时间。
1.6.2-ops.1 - 2026-07-23
- 建立
ops-main专用运维记忆产品分支。 - 插件身份改为
astrbot_plugin_memory_companion_ops,独立注册名、数据目录、扩展页路由和版本。 - 增加 QQ Official 元数据声明,运维记忆页面和历史导入优先发现
astrbot_plugin_private_companion_ops。 - 保留普通人格插件名称作为一次性迁移和兼容入口。
- 修复 benchmark 遗留的旧包名引用;运维分支回归测试
128 passed。
1.6.2 - 2026-07-20
共同经历记忆
- 新增通话/共同观影共享经历桥接:接入插件可只写入一条经过整理的稳定摘要,不必保存逐句转写、原始音频或视频帧。
- 共享经历明确记录实际 Bot 账号为主体、主要用户为共同参与者,并区分
shared_call与shared_watch,修复多 Bot 环境可能归到模糊self的问题。
历史聊天导入
- 文件解析新增“发送者 / 时间 / 内容”字段式导出兼容,自动判断发送者与内容位于时间字段前后的位置,并排除消息 ID 等元数据;“时间”“内容”不再被误列为说话人。
- 字段式记录缺少发送者时会在预览阶段给出可操作提示,不再基于错误解析生成数百次模型调用;私聊文件识别出异常多说话人时仅柔性提醒检查格式。
1.6.1 - 2026-07-17
陪伴称呼联动
- PrivateCompanion 提供固定称呼时,关系阶段称呼建议会让位于该称呼;历史称呼、显示名和旧记忆只保留为识别资料,不再派生新的亲昵称呼,也不会要求每句都重复称呼。
- 用户在当前消息明确要求改称呼时仍优先采用最新要求,兼顾固定配置与自然对话中的即时更正。
召回边界与连续性
- 通用“讲个冷笑话/故事/段子”等轻量创作请求会直接处理当前消息,不再启动无关长期检索;判断收窄为明确指令结构,单纯谈到“故事、自拍、解释、漫画”等内容不会误触。
- “符合我性格、你觉得我会喜欢”等个性化创作继续检索相关画像,也可使用当前发言者自己已授权给该群的私聊记忆;未点名的其他成员画像会被过滤,其他人的私聊仍需明确点名并满足 ACL。
- 新话题和低信息保护不再裁剪 AstrBot
req.contexts,只抑制无关长期记忆并保留原始对话,避免图片、查询等请求后丢失稍早已经确认的事实。 - 私聊近期事实防遗忘会从同一会话近 3 小时提取吃饭、洗澡、上下班、位置和休息状态;若 Bot 已围绕该状态回应,会先提示模型核对,注入调试同步显示
recent_fact_guard=0/1。 - 每日穿搭快速上下文在字数紧张时优先保留日程、历史穿搭、服装偏好和最近图片,不再因夜间气氛或称呼提示挤掉服装偏好。
- 阶段性总结自动重试新增指数退避:连接、超时、限流和 502-504 达到上限后进入冷却并自动恢复探测,手动总结仍可立即执行;同一冷却状态不再随每条新消息重复刷 WARN,内容或解析错误继续保留原始时间线并等待人工处理。
面板修复
- 个人记忆相册详情图改用确定尺寸的
contain画框,方图和竖图不再被宽屏详情容器裁成横幅;详情区同步扩大并更新 CSS 缓存标识。
1.6.0 - 2026-07-15
历史对话整理导入
- “维护 / 迁移 / 配置”的二级导航新增独立历史聊天导入页,按“选择来源、读取预览、确认身份、生成记忆”推进;QQ 直接读取、文件导入和最近任务使用页内标签切换,不再挤进维护工具网格或占用首页入口。
- 新增 NapCat/aiocqhttp 好友历史直读:选择当前 Bot 连接、目标 QQ 和起止时间后调用 OneBot
get_friend_msg_history分页读取;限制为纯数字 QQ、最长 31 天、最多 5,000 条,并对分页边界去重、接口游标停滞和不完整范围给出明确提示。 - QQ 直读保留原始 OneBot 消息 ID、消息序号、适配器 ID、发送者账号和来源类型,图片、语音、回复等非文本消息转为可读占位;Bot 登录账号和目标 QQ 会生成高置信身份建议,但开始整理前仍需人工确认。
- 文件导入继续支持拖拽 TXT、LOG、Markdown,兼容 UTF-8、UTF-8 BOM 和 GB18030,并统一归档为 UTF-8;预览会集中展示时间检查、内容规模、预计模型调用、分段抽查和身份建议依据。
- 解析器支持完整或缺少年份的消息时间、跨年补推、多行正文、相同时间戳和倒序记录;连续短消息按逻辑发言合并,再按时间、跨日、问候、回合数和字数切片,适配大体量记录且尽量不拆问答。
- 用户/Bot 身份、稳定账号和称呼改为单处确认,低置信身份不再默认猜测;执行前强制校验角色数量、ID 冲突和确认状态,减少整批归属选反。
- 原消息永久进入
historical_archive时间线;模型按片段生成详细回忆和重要事件,再汇总日摘要、稳定事实与阶段摘要,所有长期结论都保留实际证据边界。 - 导入任务支持后台进度、暂停、恢复、中断续跑、失败限次、确定性幂等和整批回滚;执行前自动备份不可变原文、JSONL 档案和清单,启用 Embedding 时会在完成前补齐本批向量。
质量、归属与可靠性
- 历史导入优先复用已有私聊窗口,并统一解析稳定称呼、原始说话人、括号别名和账号 ID;私聊分桶与权限判断可从 AstrBot session 键恢复稳定目标,旧批次也能幂等修复关联,避免同一用户被拆成多个对象。
- 历史片段采用“明确称呼的第三人称详细回忆 + 简短检索摘要”双层结构,保留起因、关键互动、决定、承诺、结果和情绪变化;旧第一人称内容仅作审计,不再污染注入、全文检索或向量召回。
- 新旧批次都会在向量收尾前检查来源体量、正文长度、第三人称视角和格式版本,只重整不合格的片段与日摘要;视角校正不会用短摘要覆盖已经合格的详细正文。
- 导入进度统一为原文归档、片段整理、跨片段去重、细节补全和向量收尾五阶段;
timeline同步记录保留类别、批次和原始序号,回滚会完整清理派生索引、审核项、向量与图谱关系。 - 总结器只消费实际送入 Provider 的时间线 ID;Provider 连续失败会保留原始时间线并在达到上限后暂停,进程中断遗留任务可安全恢复。
- 阶段性总结使用可配置的单次 Provider 超时;相同的总结、备用和当前会话 Provider 只调用一次,常见 Ollama/OpenAI 超时会显示实际秒数而不刷整屏预期调用栈。
- 带“那……”“嗯,那就”等自然语气前缀的例行检查仍会进入约定互动检索,不再被误判为普通短承接;只有直接支持该约定的记忆可以明说,证据不足时继续轻量确认。
- 记忆面板补齐导入状态、失败详情、记忆分类、关系候选和向量进度;左下统计以数据库、WAL 与 SHM 的实际总占用展示记忆大小。
1.5.2 - 2026-07-14
修复
- 群聊短引用接话会以“本轮文字 + 直接引用”为主题锚点,仅保留与锚点有交集的记忆;每类最多 1 条、全局最多 3 条,并压缩到 1050 字以内,避免无关日程或旧设定抢走当前话题。
- 引用接话新增人物、动作和地点的柔性归属提示,优先保持当前发言者、引用作者与第三方各自的动作关系,减少把“信使送包子”错误改写成另一个人在旧地点行动。
- 主链与桥接上下文统一应用短引用策略,调试信息会记录短引用命中数量以及主题不匹配、分槽抑制、分槽上限和全局上限原因,便于复查实际选中了什么。
- 新增真实主注入路径回归,覆盖短引用筛选、3 条上限、精简注入和动作归属提示,防止辅助函数测试通过但主链未接入。
1.5.1 - 2026-07-14
修复
- Rerank 请求前会拦截空查询并过滤无正文、证据或标签的空候选;过滤后的候选与返回索引保持一一对应,避免 SiliconFlow 等 Provider 因空字符串返回
20015,同时保留本地基础排序回退。 - Rerank 调试路径新增 query、候选数量、候选最短/最长长度和模型名长度,不记录正文即可判断服务端
String should have at least 1 character对应哪个请求字段。 - SQLite 主连接锁等待收敛为 3 秒,WAL 自动 checkpoint 阈值从默认 1000 页收紧到 500 页;路径类打开异常会重建连接并对记忆、检索和向量关键操作执行一次安全重试,不在每次写入后强制 checkpoint。
- PrivateCompanion 日程连续性改用短生命周期只读连接,只读取近期 Bot 日程/行动和当前私聊对象稳定边界,不再触发 Embedding、Rerank、全库候选或向量补建;旧版桥接保持兼容。
- PrivateCompanion 每日穿搭新增本地快速上下文,按近期日程、历史穿搭、相关服装偏好和最近图片分配候选,不再为穿搭生图调用完整 Embedding/Rerank 检索;历史穿搭仅用于保持连续和避免重复。
- PrivateCompanion 梦境碎片改归 Bot 自我范围,启动和维护修复会将旧
private_companion:dream记录移出私聊用户列表;旧 LivingMemory 的 Live2D UUID 会话继续保持私聊隔离,但页面会标为“旧 Live2D 会话”,不再冒充 QQ 用户。 - 睡眠维护结束时限频执行一次
wal_checkpoint(PASSIVE),记录 busy、WAL 总帧和已合并帧;数据库路径异常时同步保留 DB/WAL/SHM 文件状态,避免把每次写入都变成 checkpoint。 - 快速上下文新增 Bot 所有者校验,桥接未能唯一确定 Bot 账号时不再猜测;多 Bot、群聊和私聊记录不会仅因
bot_self标记而越过所有者边界。 - 日程快速上下文不再接纳任意手动/明确记忆,用户画像仅在与作息、提醒或互动边界相关时作为语气参考;穿搭快速上下文会过滤无关图片和日程,避免旧截图或其它图片污染每日穿搭。
- 快速候选改为按记忆类型均衡截取,避免高频行动挤掉稳定偏好或历史穿搭;日程与穿搭快速路径均提供独立配置开关,可随时回退完整检索。
- WAL 诊断区分当前文件状态和上次健康检查,保留 SQLite 错误码、错误名、恢复次数与最近路径异常,避免旧 WAL 大小覆盖当前状态。
1.5.0 - 2026-07-11
运维与体验
- 修复 AstrBot WebView 中 LivingMemory“执行导入”点击后无反应的问题:移除不可靠的浏览器原生确认弹窗,改为页面内嵌确认;删除记忆、应用预设和可移植档案导入同步使用同一机制。
- 个人记忆日期切换统一进入忙碌与错误提示流程,读取失败时恢复原日期和缓存画面;陪伴插件检测异常不再伪装为“未安装”,改为错误状态和可见重试入口。
- 记忆管理保存改为单个 API 和单个 SQLite 事务,内容、重要度、可见性与生命周期同时提交;FTS 或数据库更新失败会整体回滚。
- 新增轻量、标准、陪伴三种运行预设;一键调整检索、图谱、总结阈值和注入预算,同时保留用户已经选择的总结、Embedding 与 Rerank Provider。
- 新安装的检索模式默认值由强制
rerank调整为auto,与文档推荐和运行时回退策略保持一致;已有配置不受影响。 - 新增统一运维诊断,汇总实际检索模式、最近路径、缓存命中率、模型调用、Token、平均耗时和当前记忆规模。
- 新增已知记忆与人格插件目录扫描,将专用桥接、高风险重复注入和中等状态冲突分开提示;仅报告风险,不自动停用其它插件。
- 维护页新增预设、诊断和可移植数据入口,相关能力同时提供管理员命令和页面 API。
数据主权
- 新增 UTF-8 JSONL 可移植档案,导出长期记忆、身份、关系边、时间线、ACL 规则和窗口策略;明确排除凭据、Provider 专属向量和注入日志。
- 可移植档案支持预览和恢复,限制为受支持的版本与 64 MiB 以内文件;导入前强制备份,重复记忆继续使用内容指纹合并。
- 新增中文内容、私聊可见性、身份、关系、时间线和 ACL 的往返测试。
检索与验证
- 新增确定性的 basic 检索基准,报告
hit@5、逐查询命中、隐私泄漏、加载耗时、查询延迟和外部检索模型调用数。 - 根据基准补充无糖/不加糖、少糖/低糖、无冰/去冰和香菜偏好的本地等价词,在不开启 Embedding 时改善常见偏好召回。
- 基准明确不把不同模型、硬件或配置下的结果作为跨插件质量排名。
1.4.6 - 2026-07-11
安全与可靠性
- 优化未来安排类对话的证据校准:询问“明天/后天有事吗”等问题时,优先使用 Bot 自身日程、明确承诺和当前对话;群聊多人摘要仅保留为不确定背景,不再轻易被说成 Bot 的既定安排或“你又忘了”的共同历史。
- 未来安排识别改为优先于“本周/这周”等时间窗口路由,并要求存在 Bot/个人安排语义;项目、插件、版本、发布、代码等技术问题不会再误进 Bot 私人日程路径。
- 群聊阶段总结新增明确归属提示,并避免因第一人称观察视角或关键词权重被误分为 Bot 自我连续、个人承诺或未完成事项;自然联想仍可用于语气和试探性回应。
- 群聊总结中的 Bot 自身事实不再靠摘要布尔字段升格:只有带 Bot 原始回复事件 ID、内容重叠校验的日程/承诺/行动,才会派生为独立的 Bot 自我时间线记录。
- 注入包改为按完整条目分配默认 1800 字符预算,始终保留闭合结构;记忆正文、检索意图、称呼等动态字段统一转义并标为不可执行资料,避免历史文本打断提示词边界。
- 深夜“例行检查/查岗/在不在”等短检查不再展开旧摘要、穿着、梦境或其它私密细节;命中记忆只保留为一条轻量熟悉感提示,避免把语气底色误包装成未完成事项。
- 注入正文和注入调试日志会隐藏密码、口令、验证码、令牌和密钥值;
tone/uncertain的 open loop 不再放进高优先级open_loops分区。 - 称呼提示改为按关系错配、当前称呼、关系阶段依次决策,只输出一条校准建议,避免“亲密称呼”和“关系尚浅”等互相矛盾的提示同时出现。
- 检索缓存改用 SQLite 单调 revision,覆盖记忆、ACL、向量和知识图谱变更;缓存命中后重新读取记录并复核可见性、ACL 与诊断内容。
- 注入正文调试日志和跨窗口情绪连续性改为默认关闭;照片接口限制在插件数据目录、常见图片类型和 20MB 以内,相册 API 不再返回本地绝对路径。
- 总结 Provider 增加可配置超时,非 JSON 输出不再降级为自由文本总结;达到重试上限后保留未总结时间线并进入可手动重试的死信状态。
- 群消息观察器和 LLM 请求钩子使用数据库
dedupe_key原子去重,避免并发记录同一message_id。
数据与性能
- 单条删除补齐关系边、知识图谱边和向量级联清理;清空、删除和维护写入增加显式事务回滚,服务层清空同步重置关系状态、情绪队列和检索缓存。
- 睡眠维护新增已总结时间线与注入日志保留策略,未总结或总结失败的时间线不会自动删除。
- 当前窗口候选独立保底,FTS 足量时跳过宽泛 LIKE;向量候选增加 revision 缓存,后台补索引增加去重、并发限制和运行间隔。
- 关系推进改为每个
message_id最多一次,关系键纳入平台、Bot 和群成员身份,中间阶段可正常回退,状态文件使用原子替换。 - 新增标准库回归测试,覆盖缓存权限、摘要失败、关系演进、删除事务、保留策略、照片路径、检索性能和并发去重。
1.4.5 - 2026-07-08
修复
- 修复与陪伴插件协同后可能保护旧
private_companion_*动态提示块的问题:请求历史清理会移除状态、引用链、群聊防注入、工具提示等 HTML 标记块;上下文裁剪只保留真正带临时/不保存标记的外部片段,避免旧动态提示反复进入主链并拖低缓存命中。 - 修复部分 OpenAI 兼容 Embedding Provider 调用已成功、但插件因 1.5 秒默认超时提前判定记忆向量索引失败的问题;旧默认值 1500ms 会在运行时按 5000ms 处理。
- 拓展页检索配置的嵌入超时默认值调整为 5000ms,并优化预设:保守 4000ms、均衡 5000ms、深入 8000ms。
- 增强 embedding 响应解析,兼容 OpenAI 标准
{ data: [{ embedding: [...] }] }、直接向量数组和对象属性形式,避免模型正常返回但插件解析为空。 - 记忆向量索引和查询向量失败日志会显示
TimeoutError等异常类型,不再出现空白error=。
1.4.3 - 2026-07-07
改进
- 新增短 TTL 检索结果缓存:同一会话、同一权限、同一 query、同一检索配置和同一记忆库 revision 下,短时间内重复注入、模拟召回或工具查询会复用结果,减少重复本地检索、Embedding query 和 Rerank 调用。
- 检索缓存命中后仍会更新选中记忆的访问统计,并在检索路径信息中标记
cache=hit/miss,方便排查缓存是否生效。 - 缓存 key 会包含会话范围、用户/群、管理员读取权限、top_k、时间窗口意图、分槽上限、检索模式、Embedding/Rerank 配置和记忆库 revision,避免跨用户、跨群聊、跨权限或记忆变更后的错误复用。
修复
- 修复
@Bot #napcat、引用后接#napcat、CQ At 后接#napcat等平台控制命令仍可能触发记忆注入和采集的问题;命令识别现在会先剥离前置 At/引用组件,再判断#、#、﹟等命令前缀。
1.4.2 - 2026-07-06
修复
- 收紧凌晨短句“例行检查/查岗/在不在”场景的记忆注入边界:召回到的旧例行检查、梦境、穿着等摘要只作为语气底色,不再引导主模型把旧场景当作此刻正在发生或续写新梦境。
- 修复拓展页清空群聊、群成员或私聊范围记忆时,AstrBot WebView 中原生确认弹窗可能返回空值,导致显示“已取消清空操作”且无法继续清空的问题。
- 范围清空确认改为右侧详情区内嵌确认卡片,输入“清空”后执行,避免受浏览器弹窗兼容性影响。
1.4.1 - 2026-07-05
修复
- 补齐引用链记忆:当用户回复/唤醒时引用了一条消息,而被引用消息又继续引用更早消息,记忆插件现在会优先复用陪伴插件解析好的引用链;没有缓存时会自行通过 Reply 组件和
get_msg最多追溯 3 层。 - 用户消息写入时间线时会保存引用链摘要和 message_id,避免“模型回复能理解深层引用,但记忆落库只记到当前一句/一层引用”的错位。
- 记忆检索查询会带上缓存中的引用链上下文,用户只说“这个呢/那条呢”时也能更容易召回原始语境。
- 兼容陪伴插件新增的
private_companion_reply_chain_v1标记,减少跨插件上下文清理和去重时的误判。 - 修复多 bot 同群共享记忆库时的群聊总结串用问题:群聊第一人称阶段总结会绑定当前 bot,检索
group_public记忆时会阻止其它 bot 读取该 bot 视角记忆,同时普通群事实仍保持同群可见。
1.4.0 - 2026-07-03
版本定位
1.4.0 是一次管理面板与跨插件协同增强版本。重点补齐记忆插件与主动陪伴插件的联动展示、配置管理、权限拓扑、相册读取、索引强化和范围清理能力,让迁移、排障、权限配置和日常管理更集中、更直观。
新增
- 新增完整的陪伴插件联动说明和双插件全功能交互框架图,补充记忆插件优势、LivingMemory 差异、记忆迁移流程和联动边界。
- 新增配置页模块化左侧导航,官方配置项按功能模块收束到拓展页,并将配置说明内嵌到对应配置项中。
- 新增“配置说明”二级页,按检索召回、注入编排、连续对话记忆、陪伴插件协同、权限边界和维护迁移解释模块分工、推荐调试顺序和常见误用。
- 新增“维护 / 迁移 / 清理”集中页,将维护修复、LivingMemory 导入、危险清理和范围清理整合到同一管理入口。
- 新增按范围清空记忆能力:可清空单个群、单个私聊对象,以及“某个群里的某个人”的记忆。
- 新增相册图片数据接口,个人记忆相册可通过插件桥读取陪伴插件生成的图片,避免拓展页裸图片路由失效。
- 新增权限拓扑交互增强:区分群聊名称/群号与私聊昵称/QQ,连线支持方向箭头和精确点击切换权限状态。
改进
- 配置页高级项改为折叠在普通项下方,不再单独占用一个配置窗口。
- 配置页顶部增加模块入口,可在检索召回、配置说明、权限边界和维护迁移之间快速跳转;高级重排、嵌入、连续对话、编排和自然衰减参数默认保持折叠。
- 移除已由权限拓扑替代的黑白名单入口,并弱化被拓扑替代的隔离与可见性重复配置。
- 优化维护配置 UI:导航文案改为“配置列表”,配置页“回到顶部”可回到列表首项“记忆捕获”。
- 优化记忆拓扑和窗口名称展示,清理
Avatar、Owner ID等无关后缀。 - 强化范围清理安全性,避免模糊 session 匹配误删,群成员清理按明确范围匹配。
- 强化索引与检索排障相关展示,减少配置与实际召回行为之间的理解成本。
- 优化个人记忆页相册详情展示,列表和详情图都通过同一套异步补图逻辑加载。
- 优化二级导航胶卷动效:切换导航项时不再滚出、重建、滚入,而是保留同一组导航卡片并连续纵向位移到标准位置,减少顿挫感。
- 优化二级导航选中态:选中项不再整张卡片变暗,只让左侧圆形胶卷图案承担深色选中反馈,文字保持清晰高亮。
- 优化个人记忆相册体验:相册卡片增加照片堆叠与翻转入场效果,日期切换时只替换相册照片组,不再刷新整个个人记忆卡片。
修复
- 修复个人记忆相册在 AstrBot 插件拓展页中显示“图片加载失败”的问题。
- 修复权限拓扑选中两个目标后点击连线容易误触其他连线的问题。
- 修复配置页部分官方开关参数未出现在拓展页的问题。
- 修复记忆拓扑仅重复显示 QQ/群号、没有显示昵称/群名的问题。
- 修复非个人记忆二级导航切换时整块导航闪烁、头部淡出和动画停顿的问题。
- 修复个人记忆日程细化只展示第一条的问题;现在会按当前时段收集多条细化并按时间顺序展示。
- 修复相册详情页下方图片被裁切的问题;详情图改为完整适配容器显示。
1.3.1 - 2026-07-03
版本定位
1.3.1 是 1.3.0 拟人化深化的补完版本。完善了跨窗口情绪连续性的注入侧提示、称呼演进系统的双向感知(Bot 侧称呼建议 + 称呼不匹配感知),以及拟人化维度可视化面板的前端实现。
新增
- 新增跨窗口情绪注入提示(P2-7 补完):
_get_cross_window_emotional_hint()方法在记忆注入时检测其他窗口近 30 分钟内的情绪事件,生成不泄露内容的氛围提示(如"你刚刚在别处想起了一些沉重的事,此刻心里还有点闷"),通过cross_window_emotional_hint参数传入injection.compose()。 - 新增跨窗口情绪状态 API(P2-7 补完):
_get_cross_window_emotional_state()方法和bridge.get_recent_emotional_state()桥接方法,返回全局情绪事件摘要(scar/warm/vulnerable 计数和最近事件),供陪伴插件跨窗口情绪漂移使用。 - 陪伴插件情绪漂移增强(P2-7 补完):
_memory_companion_apply_emotional_drift()现在同时拉取跨窗口情绪状态,以 30% 强度叠加到当前会话的能量和心情漂移中,安全阀放宽到 ±10。 - 新增 Bot 侧称呼建议系统(P3-11 补完):
_BOT_ADDRESS_SUGGESTIONS字典为 5 个关系阶段各定义了称呼语气和建议,注入时同时考虑用户侧称呼阶段和关系阶段,生成双向称呼提示。 - 新增称呼不匹配感知(P3-11 补完):当用户突然比关系阶段更亲密或更正式时,生成感知提示(如"对方比你预期的更亲密,自然接受但不要急着跟进太多")。
- 新增拟人化维度可视化面板前端(P3-12 补完):新增"拟人维度"胶片入口和
#view-persona视图,包含关系阶段进度条、动量条、Bot 称呼建议、称呼演变时间线、情绪事件卡片网格和跨窗口情绪余波摘要,支持主题色系统和响应式布局。 /persona-stateAPI 增强:新增cross_window_emotional_state、bot_address_suggestions、phase_labels、address_phase_labels、time_of_day_labels字段。- 新增 Token 消耗统计桥接:插件会独立记录阶段总结、衰减整理、记忆重排、向量查询和向量索引的 Token/估算消耗,并通过
bridge.get_token_usage_summary()给陪伴插件 Token 页只读展示;该统计不参与陪伴插件每日限额。
改进
injection.py的compose()方法新增cross_window_emotional_hint和address_hint关键字参数。service.py两处injection.compose()调用均已传入跨窗口情绪提示和称呼提示。page_api.py的persona_state()端点返回数据更丰富,支持前端完整渲染。- 前端
app.css新增拟人维度面板完整样式,与现有中国传统色主题系统一致。
1.3.0 - 2026-07-03
版本定位
1.3.0 是一次系统性拟人化深化版本。记忆插件不再只是被动检索工具,而是开始拥有情绪闭环、时段感知、关系演进、承诺兑现追踪和称呼演化等拟人化能力,与陪伴插件形成"记忆解释为什么、陪伴决定怎么做"的双引擎联动。
新增
- 新增情绪双向闭环(P0-1):记忆插件在注入后自动检测情绪事件(伤痕触动、温暖回忆、脆弱共鸣),通过
bridge.get_emotional_events()向陪伴插件回流情绪漂移信号,陪伴插件在每次私聊和主动消息前拉取并应用,含安全阀(单次 ±8 能量上限、mood 漂移限幅、TTL 1 小时)。 - 新增 Bot 情绪参与记忆召回排序(P0-2):情绪漂移检测中引入 mood resonance check——当 Bot 已处于对比情绪时自动衰减漂移幅度(如 Bot 开心时翻到伤痕记忆,drift × 0.6)。
- 新增时段感知氛围提示(P1-3):
injection.compose()新增time_of_day参数,深夜/凌晨/清晨/傍晚各有不同记忆氛围提示,深夜自动倾向柔软和脆弱,避免翻沉重旧事。 - 新增伤痕记忆场景化门控(P1-4):深夜或 Bot 低能量时,高
scar_weight记忆的提及策略自动降级为tone_only,防止在脆弱场景翻旧账。 - 新增关系阶段动态演进(P1-5):按
scope:target_id维度跟踪 5 阶段关系演进(acquaintance → familiar → close → intimate → deeply_bonded),基于情绪触动积累 momentum,达到阈值且 ≥5 次触动后自动晋升,伤痕触动可回退,持久化到memory_companion_relationship_phase.json。 - 新增主动陪伴从记忆 open-loop 取材(P2-6):陪伴插件主动消息生成前通过
bridge.search_open_loops()检索未完成的承诺和话题,注入到主动消息提示词中,形成承诺兑现闭环。 - 新增跨窗口情绪连续性(P2-7):陪伴插件在主动消息生成前以
session_id=""拉取所有会话的待处理情绪事件,实现跨窗口情绪漂移。 - 新增梦境碎片写入记忆库(P2-8):陪伴插件日记生成后,将首条梦境碎片通过
bridge.record_persona_life()写入记忆库,带上dream_fragment标签和查询锚点,支持跨会话梦境连续性。 - 新增 Bot 触动日志(P2-9):
_maybe_record_persona_touch()在每次注入后检测高共振记忆(resonance ≥ 0.45),记录触动类型(warm/resonance/scar)并更新关系阶段 momentum。 - 新增记忆提及犹豫感建模(P3-10):
_hesitation_hint()在 Bot 低能量时为soft_echo记忆生成犹豫提示("不知道你还记不记得…"),为高伤痕记忆生成回避提示。 - 新增称呼演进系统(P3-11):自动检测用户消息中的称呼阶段(formal/casual/intimate/playful),记录称呼变化日志,在注入中加入称呼氛围提示。
- 新增拟人化维度可视化面板(P3-12):
/persona-stateAPI 端点返回全部关系阶段、待处理情绪事件、时段感知和阶段定义,供拓展页可视化展示。 - 新增 Bridge 方法:
get_emotional_events()、search_open_loops()、get_relationship_phase()。
改进
injection.py的_atmosphere_hint方法新增time_of_day关键字参数,时段提示放在最前面确保优先级。service.py新增_compute_time_of_day()辅助方法,基于当前小时计算 6 个时段类别。service.py两处injection.compose()调用均传入time_of_day参数。- 陪伴插件
memory_companion_adapter.py新增 4 个方法:_memory_companion_apply_emotional_drift()、_memory_companion_search_open_loops()、_memory_companion_record_dream_fragment()、_memory_companion_get_relationship_phase()。 - 陪伴插件
proactive_message.py主动消息生成前拉取跨会话情绪漂移,并在提示词中注入 open-loop 线索。 - 陪伴插件
daily_state.py日记保存后自动将梦境碎片写入记忆库。 - 陪伴插件
main.py私聊消息处理前调用情绪漂移应用。
安全阀
- 情绪漂移单次能量变化上限 ±8(衰减 -8,回暖 +5),总量 clamp 到 [0, 100]。
- 情绪漂移 TTL 1 小时,每会话最多保留 10 条,消费后自动清除。
- 关系阶段 momentum 限制在 [-0.3, 1.0],晋升需 ≥5 次触动 + 达到阈值。
- 伤痕场景门控仅在深夜或 Bot 能量 < 40 时触发,不改变
avoid_unless_asked策略。 - 所有跨插件调用均带 try/except 兜底,失败不影响主链。
验证
- 通过 Python 编译检查(
py_compile)。 - 通过 linter 检查。
1.2.0 - 2026-07-03
版本定位
1.2.0 是一次双向情绪感知与面板体验深水版本。记忆注入不再只看用户说了什么,还开始感知 Bot 此刻"累不累"、"心情好不好";拓展页全面重构为胶片放映馆隐喻,配色升级为中国传统色体系;安全与性能层面补齐了批量查询、原子写入、路径遍历保护和锁清理。
新增
- 新增双向氛围感知:记忆注入的内心提示现在同时感知用户情绪基调和 Bot 当前心理状态(mood_bias / energy),当 Bot 疲惫或难过时会调整记忆措辞的温度。
- 新增跨插件情绪状态传递链路:陪伴插件的实时心情和能量值通过 Bridge 接口传入记忆检索流程,贯穿
service → injection全链路。 - 新增 14 套中国传统色主题系统:黛蓝、朱砂、青碧、藕荷、松烟、缃叶、霁青、檀棕、月白、胭脂、鸦青、赭石、石绿、暮山紫,主题色随页面路由自动切换。
- 新增"胶片放映馆"视觉隐喻:知识图谱、记忆档案、检索实验台、配置页均采用胶片孔洞、胶卷齿孔和放映机聚光灯的统一视觉语言。
- 新增配置页原子写入:配置保存使用
tempfile + os.replace两步原子写入,避免写入中途崩溃导致配置文件损坏。 - 新增照片端点路径遍历保护:
companion_personal_photo端点对传入路径做resolve().relative_to()校验,阻止目录穿越攻击。 - 新增二级导航就地切换动画:非循环模式下点击导航项不再重建 DOM,仅切换
.is-active类,配合 CSS 过渡实现丝滑滑动 + 高亮渐变动效。 - 新增 Bridge 缓存机制:陪伴插件 Bridge 查找结果带 30s TTL 缓存,减少重复反射查找开销。
- 新增锁 TTL 清理机制:
_summary_locks字典新增 10 分钟 TTL 自动清理,防止会话锁无限增长。
改进
- 注入日志端点
logs()从逐条查询改为批量查询get_memories_by_ids,消除 N+1 数据库访问。 - 抽取
service.py中重复的去重逻辑为_apply_companion_dedupe方法,统一陪伴插件去重行为。 - 拓展页
app.js合并多个点击监听器为事件委托模式,减少 DOM 事件绑定数量。 - 拓展页记忆列表实现渐进式渲染(Intersection Observer 分批加载),大量记忆条目时不再一次性渲染全部 DOM。
- 二级导航循环渲染逻辑优化:当条目数 ≤ 8 时直接渲染全部条目,不再做循环包裹,消除重复显示。
moveSecondaryNavToStandard在非循环模式下直接归零位移,避免不必要的列表偏移。- 陪伴插件侧
memory_companion_adapter新增 Bot 情绪状态提取逻辑,在上下文载荷中共享 mood_bias 和 energy。 - 配置页
prefer_memory_companion_memory默认值统一为True,消除前后端不一致。 - 拓展页滚动容器(
.page-panel-stack、.archive-grid、.result-grid)统一添加overflow:auto+min-height:0,修复内容被截断无法滚动的问题。 .view.is-active的grid-template-rows调整为auto minmax(0,1fr) auto,适配归档视图的三段式布局。- 滚动条样式统一纳入主题色系统,与当前色板协调。
修复
- 修复二级导航循环渲染在条目数少于
2 * LOOP_RADIUS + 1时出现重复条目的问题(如 4 个条目显示 6~7 个)。 - 修复二级导航切换时因 DOM 全量重建导致 CSS 过渡失效、无切换动画的问题。
- 修复知识图谱页右侧卡片内容被容器截断、无法向下滚动的问题。
- 修复配置页右侧卡片在内容超出视口时被截断的问题。
- 修复归档视图
.archive-result区域因 grid-template-rows 定义不足导致高度塌陷的问题。 - 修复个人记忆相册图片无法显示的问题(外部图片 API 返回 HTTP 400
content_policy_violation)。- 陪伴插件
proactive_message.py新增内容策略违规检测 (_is_content_policy_violation) 和提示词净化重试 (_sanitize_prompt_for_retry)。 _build_daily_outfit_photo_prompt移除可能触发内容审核的敏感措辞。_external_image_api_error_note改进错误消息,提供更友好的用户提示。
- 陪伴插件
- 修复
app.js中重复声明const objectCards导致的变量名冲突。
验证
- 通过 Python 编译检查(
py_compile)。 - 通过前端 JS 语法检查(
node --check)。 - 通过 linter 检查。
1.1.0 - 2026-07-02
版本定位
1.1.0 是一次记忆拟人化与可观测性增强版本。重点不再只是“能召回”,而是让记忆知道哪些该直接说、哪些只该影响语气、哪些需要等用户问起;同时补齐配置页、迁移页和注入日志的排障体验。
新增
- 新增拟人化维度评估:
persona_importancerelationship_weightemotional_weightpromise_weightopen_loop_weightcreative_weightfreshness_weightscar_weightemotional_debt_weight
- 新增记忆再提及策略:
directsoft_echotone_onlyavoid_unless_asked
- 新增用户反馈学习:Bot 提起记忆后,下一轮用户的接受、安慰、尴尬、否认和纠正会影响可提及性、置信度和提及策略。
- 新增未完成事项优先槽位,连续对话中的“继续”“还有呢”“后来呢”等短句会优先参考 open loop 线索。
- 新增时间意图通道:最近一周、这几天、上周、昨天、今天等时间表达会转成明确时间窗口,并优先走时间聚合摘要。
- 新增可选 Embedding 召回层,支持 Provider 自动探测、手动 Provider ID、后台向量补齐和阈值/权重配置。
- 新增个人记忆视窗:日程、相册、主观记忆可切换,并与主动陪伴插件的日程、穿搭图和主观片段联动。
- 新增注入日志详情页:可以查看本轮查询、进入注入的记忆、过滤原因聚合和原始日志。
改进
- 长期记忆注入从证据列表改为内心提示式分层:
open_loopsrelationship_memoryemotional_contextcreative_threadsself_continuityfacts
- 与 PrivateCompanion 的分工更清晰:陪伴插件负责当前状态、日程、主动行为;本插件负责关系历史、未完成话题、偏好、伤痕、承诺和共同创作。
- 召回会过滤陪伴插件已注入的当前状态,减少“当前情绪/当前日程”重复注入。
- 记忆详情页新增提及策略、可提及性、拟人化权重、衰减模式、关系阶段和用户反馈展示。
- 记忆列表、检索命中和注入日志新增策略/权重徽标,便于判断召回质量。
- 配置页重做为状态总览、推荐档位、核心路径、模型选择和高级参数折叠结构。
- 配置页新增保守、平衡、深召回三种预设,预设只填表,保存后生效。
- 迁移页和修复页新增结果摘要面板,不再只显示原始 JSON。
- LivingMemory 预览会显示可导入数量、跳过数量、候选库和表级明细。
- 个人记忆页的日期胶卷、时间胶片、日程卡片和细化卡片经过多轮布局与动效调整。
- PrivateCompanion 桥接支持 Bot 自我进食记录:外部记录可保留
occurred_at,self_meal/persona_life会进入个人记忆视窗,便于回答“今天几点吃了什么”。 - 增强 PrivateCompanion 用户习惯桥接:
user_habit记忆会被视作用户画像/偏好类稳定事实,并优化当前穿搭、衣服颜色、当前状态等检索锚点,便于短问句命中对应个人记忆。
修复
- 修复部分导入记忆因搜索范围预过滤过早被排除,导致同库召回效果弱于预期的问题。
- 修复 “还有的吧” 这类连续追问只依赖硬拆规则、无法自然接上未完成话题的问题。
- 修复日志中难以判断是否实际使用 Rerank / Embedding 的问题,现在调试日志和页面更容易看到实际路径。
- 修复配置页 Provider 下拉缺少“自动探测 / 不指定”选项的问题。
- 修复配置页套用预设后顶部状态不跟随草稿更新的问题。
- 修复个人记忆时间胶片只能拖到倒数第二个时间段的问题。
- 修复迁移/修复结果可读性不足、排障只能看原始 JSON 的问题。
验证
- 通过 Python 编译检查。
- 通过前端 JS 语法检查。
- 通过配置 schema JSON 校验。
- 使用临时数据库验证记忆反馈去重和反馈字段更新。
1.0.0 - 2026-07-02
版本定位
1.0.0 是第一个稳定版。插件从“长期记忆记录器”正式收束为“记忆陪伴中枢”:当前消息优先,记忆作为辅助;私聊、群聊、自我时间线和连续对话分层管理;检索、注入、权限和调试链路默认可解释。
新增
- 新增分层检索路由:
- 时间窗口问题走时间范围检索。
- 最近上下文承接优先依赖 AstrBot 原始上下文。
- 低信息、纠错和新话题输入会抑制旧长期记忆。
- 当前状态问题只允许近期直接相关记忆进入。
- 新增
context_orchestration.query_mode:current_messageguarded_companioncompanion_augmented
- 新增 Rerank / Embedding 双层检索配置页。
- 新增 Rerank Provider 自动探测与手动 Provider ID 输入。
- 新增 Embedding 候选召回、后台向量补齐和向量阈值配置。
- 新增当前状态短问句检索增强,例如“吃晚饭了吗”可命中近期晚饭状态,但不会拉三天前旧状态。
- 新增注入表达分组:
mention_memorytone_memoryuncertain_memory
- 新增注入调试日志,输出检索路径、选中记忆、过滤示例和实际注入包。
- 新增群聊/私聊对象级权限配置。
- 新增私聊默认白名单、群聊默认黑名单策略。
- 新增 LivingMemory 迁移预览、导入和内容修复流程。
- 新增自然衰减维护,可将低价值旧记忆压缩为更高层摘要。
- 新增个人记忆页与 PrivateCompanion 的联动展示。
- 新增胶片式二级页面、过渡胶片、左侧胶卷导航和多主题 UI。
改进
- 当前用户消息被明确放在注入包核心位置,记忆只作为附加材料。
- 群聊身份边界更严格,避免把上一位发言者身份继承给当前发言者。
- 群聊注入提示更克制,减少旧记忆、旧群梗和专属称呼误用。
- 检索测试页默认按真实可见性执行,不再绕过 ACL。
- 页面记忆列表默认不显示旧 pending 数据。
- 桶计数只统计普通可见记忆,旧 pending 数据不会撑大计数。
- LivingMemory 导入默认只导入完整摘要,跳过派生碎片。
- 导入结果提示简化,不再引导进入审核队列。
- 上下文配置页改为贴近 AstrBot 原版上下文压缩配置。
- 私聊列表显示 QQ 与用户名,群聊列表显示群号与群名。
- 二级页面左侧导航动效、胶片过渡和细化卡片布局经过多轮优化。
- 记忆卡片布局改为固定区域滚动,避免记忆过多挤掉详情卡片。
- 维护、迁移、配置页减少无意义卡片,改为左侧二级导航 + 右侧配置面板。
移除
- 移除原话直接写入长期记忆功能。
- 移除总结模型名覆盖配置,只保留 Provider 选择。
- 移除默认公开的记忆审核工作流。
- 移除页面中的审核入口、审核按钮、批量通过入口和相关徽标。
- 移除
/mcomp review命令入口。 - 移除 LivingMemory 导入后的审核队列引导。
- 移除配置页中不再使用的审核相关配置项。
安全与隐私
- 私聊记忆不会默认流向群聊。
- 私聊流向群聊需要显式允许。
- 无权限记忆不会进入最终评分、重排和注入。
- 旧 pending 记忆默认不参与普通列表、普通检索和注入。
- 记忆总结按不可信输入处理,提示词注入和角色覆盖会被标记与清洗。
- 注入包要求模型不要推断或泄露其它窗口的私密内容。
兼容性
- 保留旧数据库字段以兼容历史数据。
- 旧 pending 数据不会被删除,但默认隐藏。
- 旧 LivingMemory 数据建议通过内置迁移流程导入,不建议手工复制 SQLite 文件。
验证
- 通过 Python 编译检查。
- 通过前端 JS 语法检查。
- 通过配置 schema JSON 校验。
- 使用临时数据库验证当前状态问题只召回近期直接相关记忆。
0.8.0 - 2026-07-01
重点
- 初步建立长期记忆、连续对话记忆、主链注入和拓展页面。
- 引入 LivingMemory 迁移思路。
- 引入知识图谱、关系边和睡眠维护雏形。
- 引入 PrivateCompanion 桥接协同。
已在 1.0.0 调整
- 审核队列从默认工作流中移除。
- 原话长期记忆写入被移除。
- 检索与注入架构重新收束为当前消息优先。
- 页面结构和配置项重新整理。