Yuki-QQbot 3.4.6

Yuki-QQbot 3.4.6 正式版发布说明

3.4.6 聚焦复杂工具链、Memory V2 语义自由度和长 Episode 的持续生产能力。本版本让模型承担语义判断，让后端专注可信身份、证据、权限、范围、幂等与事务边界，并减少大型 MCP 结果和积压自省造成的重复调用。

MCP 大型结果与 Agent 工具链

• 增加通用结构化 Artifact 导航，保留 MCP JSON 的对象、数组和游标语义，不再依赖特定服务的硬编码摘要。
• read_tool_artifact 支持稳定分页、路径读取、搜索和幂等结果，复杂点单链路可在不创建订单的前提下连续浏览门店、菜单、套餐和规格。
• Agent 工具循环增加执行前去重、最终回复预算、成功副作用短路和可继续工具链判断，降低重复翻页与无效调用。
• 修复 Responses 与 OpenAI 兼容链路中结构化工具结果的传递边界。

Memory V2 模型语义

• 移除依据中文词形、关键词或 Bot 固定名字判断主体、意图和长期价值的语义正则。
• 自动记忆继续由模型输出主体依据、保留价值、来源风格和来源类型；后端只验证可信引用与结构边界。
• memory_change 支持明确的用户请求依据；普通姓名使用当前群身份进行唯一解析，模糊候选可交还主 Agent 选择或澄清。
• 保留伪造证据、跨群目标、越权操作、SELF protected key、版本链、receipt 和事务校验。

长 Episode 与统一时区

• Structured Self Reflection 对格式错误提供具体诊断和一次有界修复，Episode 不再因模型放错输出字段而静默丢失。
• 数据库存储、排序和比较统一保持 UTC；传给模型、工具及用户的时间统一转换到配置时区。
• Self Reflection 事件时间带明确时区偏移，Episode valid_from 使用明确 UTC，修复日期提前或滞后 8 小时的问题。
• 新系统提示词仍作为私有运行配置挂载，不进入公开源码与镜像层。

Self Reflection 积压调度

• 每批最多读取 100 条事件、8000 字符，继续采用连续且不重叠的水位窗口。
• 每轮最多 12 个批次，同一会话每轮最多连续处理 7 个批次，每日最多 36 次模型调用。
• 同一会话完成一批后可在同一调度轮继续推进；失败会话不会在本轮立即重试烧费模型。
• 调度仍为 04:00、12:00、20:00（Asia/Shanghai），并兼容旧的 MAX_SESSIONS_PER_RUN 环境变量。

升级与验证

• Yuki 版本为 3.4.6，Plugin API 保持 1.1。
• 本地与 GitHub Actions 均通过 Ruff format、Ruff lint、Mypy、Pytest、Prompt benchmark、模型路由、插件契约、Alembic fresh install、Memory migration matrix、Docker 和 Memory Quality。
• 本地测试结果：1040 passed，1 项真实外部 Embedding 测试按配置跳过。
• 服务器已从本地构建的合并提交镜像部署；Bot 健康，OneBot 已连接，NapCat 容器与 QQ 登录状态保留，网易云、Miniflux 和麦当劳 MCP 正常握手。

升级前建议备份 data/。只重建 Bot 可保留 NapCat 登录状态：

docker compose up -d --no-deps --force-recreate bot