v0.5.16 · 群管理全家桶 + 对话群管 + B站订阅推送 + 出站防线四层

v0.5.16 · 群管理全家桶 + 对话群管 + B站订阅推送 2.0 + 出站防线四层

本版继续全部来自真实群聊反馈实战：每个问题先复现、定位、修复、E2E 验证再上线。

🛡 群管理（新模块，侧边栏「群管理」）

• 分群管理：定时全群禁言（支持跨午夜窗口如 23:00→08:00）、关键词撤回、关键词禁言（可配时长）、群公告查看/编辑/发布、快捷操作（立即全群禁言、手动禁言成员）
• 批量管理：多选群一键群发同一段公告（逐群确认可选）、批量应用定时禁言/关键词设置到所选群
• 管理操作要求机器人是目标群管理员；所有危险操作均有确认弹窗

🗣 对话群管（群管理页开关，默认关）

• 开启后主人可以直接自然语言指挥机器人管群——私聊群聊都行、跨群指挥也行：
  「在鸽子窝发条公告：今晚十点禁言」「把张三禁言10分钟」（说名字即可，自动解析群名片）「撤回张三刚发的那两条」「开全体禁言」
• 四层边界：默认关闭；能力教学只注入主人的消息（其他群友完全不知道有这能力）；执行侧主人身份硬校验；标记绝不外漏
• 报错全部人话化并跟人设走：对群主操作 → "TA是群主我动不了"；对管理员操作 → "同级管不了同级，得群主来"；群友玩梗"禁言我" → 人设打岔，绝不假装办了

📺 B站订阅推送（新市场插件 bili_sub，1.1.0）

• 订阅 UP 主，新视频/图文动态/直播开播自动转发到指定群或私聊（好友点选+手动QQ号）
• 推送历史：每条按目标标绿✓红✗，失败的或想补发的一键重推到任意群/私聊
• 图文动态真实发图；直播开播无需B站登录；防轰炸三板斧（首订只记水位/单轮≤3条/请求限速）

🔒 出站防线四层（"说漏嘴"系列终结）

• 行首 [] 元数据拦截：[时:23:24]/[21:05]/[回应:63] 等模型模仿历史格式的泄漏全形态剥离（markdown 链接例外）
• 占位复读拦截：[QQ表情#x] 等入站占位被模型模仿输出的，句中剥离；未知表情降级 [表情] 不带编号
• [回应] 标记旁路兜底：追聊/主动/连贯性重试路径统一剥离
• 追聊提示词回声丢弃：模型把判断框架转述成"换个新话头…像没事找话"发出的，整句丢弃

🧠 感知与分寸

• 裸@反应降级（戳一戳哲学）：纯@无内容 → 表情回应；图看不了 → 表情回应，绝不说"图我这边没显示出来"
• 安抚短词定向：群友互相"摸摸/抱抱"不再被当成对机器人说；同文短消息 3 分钟内不重复回复
• @其他人渲染进文本：纯@消息在历史里不再显示空行
• 人设与风格合并为一页（子tab切换，功能数据不变）
• 风格学习插件 1.0.1：设置页二次打开卡死修复

🐛 稳定性

• 宿主修复：PluginAPI.send 方法名错配——插件发文字通道自 0.4.0 起从未工作过（bili_sub 实测暴露）
• 风控优化三件套全可配（图片限频/主动降频/拟人化节奏）

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。需要 B站订阅推送的用户在插件市场安装「B站订阅推送」。

v0.5.15 · 活人感 + 风控优化 + 感知补完

v0.5.15 · 活人感 + 风控优化 + 感知补完（实战淬火版）

本版全部来自一周真实群聊反馈：每一项都先在生产群复现、定位、修复、回归验证。

🧍 活人感（群友反馈"越来越像机器人"的系统性回应）

• 纯图/表情不再硬接话：空占位消息降级为表情回应或沉默（可配置三档：表情回应/跳过/旧行为）——真人就是这么处理表情包的
• 克制总纲：教学段瘦身 + "大多数消息只看不说"总纲注入
• 闲聊长度上限：闲聊回复超长自动压缩重写（告别小作文感，可配置）
• 回指限制：不再频繁"我记得你上次说……"展示记性

🛡 风控优化（条款825 事件后的全套缓解，全部可开关可回退）

• 图片获取限频：每分钟 10 次 / 每日 60 次双窗口（超限自动降级为纯文本回复，不硬拉）
• 主动消息降频：夜间 0-8 点静默 + 概率×0.5 + 间隔×2
• 发送节奏拟人化：首条回复 0.8-2.5s 随机延迟（秒回是机器人最典型特征）
• 设置页新增风控优化分区，三项独立开关

👁 感知补完（"看不到/看不懂"系列终结）

• 裸@补内容：只@不写正文时，自动关联 TA 刚发的前/后一条消息（文字+图），不再对着空气问"你发的是啥"
• 图文合并双向化：先打字后配图也能合并看图（此前只回捞先发的图）；连发中的"图+配文"不再被冷却拦死
• 纯图绕过修复：vision 配置透传遗漏导致纯图消息从未进过识图流程（隐性老 bug）
• 指代词教学：图片消息里的"这个/那个/它"明确指向图中主体（遮光罩被当食物的根治）
• 引用消息带图可见；未知消息段兜底（QQ 空间动态等新形态标记+日志，不再静默丢弃）

🔥 热点与记忆

• 热点近 3 天注入：隔天问旧瓜不再一脸茫然（新闻讨论窗口 2-3 天，热点记忆跟着走）
• 说话人名字对齐：不再把 A 说的话安到 B 头上
• 记忆页搜索：记忆流水+群成员画像双搜索框，支持群号/QQ号/内容模糊匹配（三档模糊）

🔒 稳定性（两次"全群失声"级事故的根治）

• 发送失败留痕：daemon 拒绝发送时 agent 侧必记 DAEMON_SEND_REJECT——此前发送链路死掉两层日志全静默
• 发送链路修复：send_texts 配置引用错误导致部署后所有文字消息静默失败（2026-11-11 事故）
• style_learn 插件 v1.0.1：设置页二次打开人设列表卡死修复

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。

v0.5.14 · 感知大修 + AI 翻唱插件 + 表情回应 + 稳定性加固

v0.5.14 · 感知大修 + AI 翻唱插件 + 表情回应 + 稳定性加固

👁 感知修复（看得更全、看得更懂）

• QQ 图片终于看得见：QQ 图床带签名、外部（含模型服务端）一律拉不到——累计 171 次「图片格式错误」的根因。现在图片经 NapCat 内部通道下载后 base64 直传模型，每张图都是真图；副本进本地缓存（设置→缓存管理→「消息图片暂存」可清，200MB 自动环形）
• 小程序/链接卡片可读：B 站分享、音乐、各类小程序卡片此前整段丢弃（机器人完全看不见），现在解析出标题/描述/链接（B 站链接里的 BV 号还能联动 B 站插件）
• 看图接地指令：带文字的图先看懂图再回（此前小模型只按文字字面回复，图里的梗/价格被无视）
• 纯图/语音/表情消息的历史占位：表情包不再被当成"空消息"（主动消息撞车说"你发的是空的"的根源）
• 引用消息真正可见：引用较早/跨天的消息也能看到被引内容（后台线程现查，不再阻塞消息管道）；引用谁看得一清二楚

🎤 AI 翻唱（新市场插件 sing_svc）

• 引用一条语音说「翻唱」，机器人用指定音色把整段唱完发回（so-vits-svc 本机 GPU 推理，零 API 成本）
• 一键部署引擎：自动下载官方源码 + 复用 GPT-SoVITS 运行时（实测依赖全兼容）+ 自动下底模，进度条全程可视；也可手动填整合包目录
• 社区歌声模型包（G*.pth+config.json）页内导入即用

😊 表情回应

• 机器人能像真人一样给消息挂 QQ 小黄脸（👍😏😊😭😴🍉🐶），语境化自主决定何时挂
• 群消息页新增设置卡：总开关 + 表情勾选（默认全选）；只对白名单群生效

🛠 MCP 工具桥增强

• 三种传输全支持（stdio/http/SSE）；streamable_http 等别名自动归一
• 添加服务弹窗化：表单字段对齐 ZCode（超时/请求头/环境变量/协议版本）；JSON 直接粘贴——单服务、ZCode 格式、Claude Desktop 整段 mcpServers 配置（一次可导多个，中文键名自动转安全名）
• 工具索引上限可调（默认 4000 字符，页面附服务数参考）
• 修复：弹窗内报错被模糊层挡住、开关勾不上、标题 undefined

🔒 稳定性（实战连环修，每个都有防再犯机制）

• 模型链 200s 预算熔断：服务端超时风暴不再把主循环拖停十几分钟（此前期间所有消息积压无回应）
• 系统提示模板占位符计数校验、线程传参数 AST 校验（两次"全群失声"级事故的根）
• 日志带日期前缀：多天累积日志不再把历史故障混成今天
• 出站控制标记统一拦截器（[SPLIT] 等变体泄漏根治）；记忆纠错 [忘:关键词]（记错的自己能改）；闲聊间隔分群计时+触发即记账（话题热区不再复读）
• 开机自启 exe 模式修复；引擎自启加载态徽标；daemon HTTP 中断噪音静默
• 上下文注入日志（运行日志新页签）：每条消息发给模型的完整上下文可查——排查"她为什么这么回"一眼见底

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。需要 AI 翻唱插件的用户在插件市场安装「AI翻唱」。

v0.5.13 · MCP 工具桥：让机器人调用整个 MCP 生态

v0.5.13 · MCP 工具桥：让机器人调用整个 MCP 生态

🔌 MCP 服务（本版主打）

• 机器人本体即是 MCP 客户端：管理台新增「MCP 服务」页，聊天里像平时一样说需求（「查下麦当劳有什么券」「用 tracy 抓个性能」），她自己挑工具、组织参数、多步执行，再用平时的语气汇报——装了什么服务就会什么本事
• 直连 ZCode 已装服务，零重复安装：自动读取 ZCode 的 MCP 配置——http 型直连同一个在跑实例；stdio 型机器人按同款命令自己拉起进程。ZCode 关着也不影响（读的是配置文件）；没装 ZCode 也能手动添加
• 三种传输全支持：stdio / http（含 streamable_http 等别名自动归一）/ SSE 旧传输
• 添加服务走弹窗：表单模式字段对齐 ZCode（超时/请求头/环境变量/协议版本四档）；JSON 模式直接粘贴——单服务、ZCode 格式、Claude Desktop 整段 mcpServers 配置（可一次导入多个，中文键名自动转安全名）都行
• 安全默认：总开关+每服务开关默认全关；仅主人的消息可触发工具调用；工具索引总长度上限可调（默认 4000 字符，页面附服务数参考）

🎤 语音修复与打磨

• 微调模型与克隆音色互斥：微调模型生效时用训练音色说话（此前克隆参考音频压在微调底模上导致音色被拉偏）；克隆音色自动挂起，回退预设后恢复
• 语音页顶部状态条正确显示微调模型；启用/回退微调模型带预估进度条；试听「点谁听谁」
• 开机自启修复（exe 版此前注册的路径不存在导致静默失败）；引擎随应用自启的加载期显示「启动中…」并自动刷新，不再误判"没启动"

🧠 对话质量

• 看图接地：带文字的图必须先看懂图再回（此前小模型只按文字字面回复，图内梗/价格被无视）
• 引用回复：引用较早的消息也能看到被引内容（OneBot 接口兜底现查）；回复别人的消息机器人不再乱插话
• 内部标记统一拦截：[SPLIT] 等控制标记的变体在发送层统一剔除（剥标记留正文，不拦整条），杜绝协议词泄漏
• 记忆纠错：只准记对方亲口说的事实（推测/工具结果不再被记成你的喜好）；新增 [忘:关键词] 撤销通道，说"我没说过"即自愈

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。

v0.5.12 · 支持音色微调模型 + 安全加固 + 备份精细化

v0.5.12 · 支持音色微调模型 + 安全加固 + 备份精细化

🎤 GPT-SoVITS 微调模型（重大新能力）

• 导入社区训练包：包含 .ckpt + .pth 的文件夹原样导入（语音消息页 → 本地引擎卡 → ＋导入微调模型），自动带上参考音频——还原度远超零样本克隆
• 微调模型与克隆音色双板块独立管理：各有说明、各有列表（启用/试听/删除），带文件缺失容错（模型被删自动回退预设+红字警示）
• 导入带命名冲突检测；启用切换引擎约 40-90 秒（有确认提示）
• 本地合成性能优化：批次/语速/切分可调 + 防冷启动保活（每 5 分钟热身，发语音从 4-5s 冷启动降到 1.3-1.5s 稳态）

🔒 安全加固（全量审计 P1/P2 修复）

• 文件外传白名单：send-file 默认仅限数据目录；可执行文件（exe/bat 等）一律拒发
• 设备操控敏感文件黑名单：.ssh/.aws/密钥/凭据/浏览器登录数据不可读不可发（防提示词注入链式窃取）
• SSRF 防护：自定义语音接口地址禁止内网/环回
• 主循环配置 mtime 缓存（磁盘 IO 大降）、记忆流水自动轮转（8MB 上限）

💾 备份精细化

• 备份范围可勾选（6 组默认全选）：人设与风格/长期记忆为重要组——取消勾选弹强提醒（数据不可再生）；其余组自由取消
• 新增插件与导入数据组（插件设置/各插件数据/聊天导入库）；补漏分对象人设路由、克隆音频本体、成员画像、复盘日报；支持目录整树备份

✨ 其他改进

• 动态上下文预算：注入量大自动升全量档；窗口逼近自动减历史保命（普通聊天维持精简）
• 克隆向导引导式分步（选素材→开始克隆→试听→保存逐步展开）+ 实时进度条
• 语音页顶部显示当前生效供应商+音色状态条
• 「正在输入…」拟真（私聊设置）；QQ 在线状态管理转内置（18 种状态+定时+手动）
• 语音意图兜底：「发个语音」类口语变体必定触发语音回复
• 追聊不再在晚安后纠缠；分类框架（"C类——"）不再泄漏
• 插件消耗预估通用化（插件列表顶部显示总增幅）；热点速览修注入截断
• 列表输入统一分隔规范（中英文逗号/顿号/空格/换行均可）

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。

v0.5.11 · 拟真与整理：正在输入指示器 + 状态管理内置 + 插件体系修缮

v0.5.11 · 拟真与整理：正在输入指示器 + 状态管理内置 + 插件体系修缮

「正在输入…」拟真（私聊设置，默认关）

• 私聊文字回复前，对方聊天栏先显示「对方正在输入…」停顿 1-10 秒（默认 2）再发出——像真人打字
• 私聊消息页 → 「正在输入…」拟真卡片：开关 + 时长，即时生效
• 仅私聊有效（QQ 群聊无此显示）；语音/图片回复不显示

QQ 在线状态管理 → 内置插件

• 原设置页「QQ 在线状态」升级为内置插件（免安装，随应用分发）：18 种状态——基础 6 种（在线/离开/忙碌/请勿打扰/Q我吧/隐身）+ QQ 个性状态（睡觉中/学习中/搬砖中/摸鱼中/听歌中/追剧中/熬夜中/emo中/恋爱中/无聊中/元气满满/好运锦鲤）
• 三个能力各自开关：上下线自动 / 定时状态（多条“时:分→状态”规则，如 23:30 睡觉中）/ 手动一键切换
• 原设置项自动沿用，设置页旧卡退役

每日热点速览 → 市场插件

• 从内置转为市场分发（市场页可安装/更新）；个人数据无缝沿用
• 市场清单升级 v26：新增「每日热点速览」「语气风格学习（活人感）」

修复

• 追聊不再在「晚安/去睡/拜拜」等收尾语后开口（此前晚安后 2 分多钟又催一遍睡，观感割裂）；新话头禁止与自己刚说过的同主题
• 修插件私有数据混写单文件（各插件配置/数据现各归其位，读写更稳）

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。

v0.5.10 · 风格系统大版本：语气风格学习插件 + 风格卡按人设

v0.5.10 · 风格系统大版本：语气风格学习插件 + 风格卡按人设

新插件「语气风格学习（活人感）」

• 机器人在你指定的群里旁观群友聊天（只看不说话），AI 蒸馏出这群人的「活人感特征」注入她的上下文——掌握真人会怎么说话，不是模仿任何人（样本全程去标识、蒸馏明确禁止提取个人特征）
• 学习对象三模式：指定成员白名单 / 全员 / 黑名单之外（可排除群里其他 AI）
• 学习群独立于群消息白名单：可一键同步，支持去没配置说话的群只旁观学习
• 可选喂给：全部人设 / 仅指定人设 / 仅全局通用设定
• 独立风格库页：每群一条特征记录，可手动新增/编辑/删除
• 页面实时显示预计 token 消耗增幅；与精简上下文不冲突（注入块属永不裁剪段、单群硬上限 320 字）
• ⚠ 涉及分析群成员消息内容，默认关闭

风格卡按人设独立（此前是全局唯一一份）

• 每张人设可以有自己的语言底子；全局风格叠加到所有人设；老用户旧风格文件无缝回退
• 编辑目标切换器：✓卡=有专属风格卡、✦自进化N=积累了 N 条观察
• 「复制风格到…」「清空此目标」；未保存切换有守卫

人设与自进化

• 人设页新增「创建副本」（含其风格卡）——调试改坏随时切回
• 自进化保留上限可调（30–300，只影响存档不影响消耗）；观察列表分页
• 自进化注入条数可调（4–40，默认 12）——直接决定每条回复的消耗，页面明示后果

其他

• 用户可见文案清理：不再把个别真实案例细节写进界面提示

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据都在 ~/.zcode-qq-bot/，升级不影响。

v0.5.9 · 语音大修 + 交互大修（12+ 项修复）

v0.5.9 · 语音大修 + 交互大修（12+ 项修复，全部来自真实使用反馈）

语音克隆与音色

• 统一音色列表：智谱预设与克隆音色合并为一个列表（预设/克隆标签、使用中绿底高亮、启用不再消失）；本地引擎列表同样式——不再「预设一个下拉、克隆一个列表」两头找
• 克隆流程统一：① 选文件 → ② 开始克隆 → ③ 试听 → ④ 命名保存（智谱克隆成功自动试听；GLM-TTS 终于有「保存到音色列表」按钮）；两边都有「重来/放弃」一键清空本次克隆
• 修 克隆音色列表与自启动开关被「保存设置」清空（后端整体替换配置的锅）；修 GSV 调起始/时长不生效的截取缓存 bug
• 修 克隆报「网络错误」：余额不足（1113）自动换下一个智谱 Key、平台抖动（1234/5xx）重试后换 Key，每次尝试落日志；余额耗尽给充值/转免费本地引擎的明确指引
• 修 GLM-TTS 语音开头数秒嘟嘟声：起音检测修剪，杂音段整剪、干净输出零误剪
• 修 语音内容成「我是文本AI无法处理音频」：提示反拒绝条款 + 输出守卫拦两类变体；语音能力提示改两态（未开启时按人设引导去开启，不再自称做不到）
• 语音页配置字段（Key/目录/端口/音色/供应商切换）填完即存即提示，不再「填了不知存没存」

行为与时间感

• 修 主动发言时间错乱（中午说"今晚早点休息"）：四条链路历史行加 [时:分] 时间戳 + 当前时间注入
• 时刻保密升级为硬性规则：数字时刻/中文钟点/整点全封死（"晚上八点"也不行），仅对方明确问时间才答
• 出站确定性清洗时间前缀：模型模仿历史行 [21:05] 格式的漏网之鱼在发送出口剥掉
• 看图模式三档：新增「所有图都识，看后再定插话」（图必看不认错，插话按独立概率）；顺修 all 档被插话判定变相屏蔽的问题

应用与页面

• 修 卡在开屏加载页（两轮）：整页脚本语法错误致闪屏永不消失的真凶已除；开屏动画改为真加载（预热插件列表/语音设置等，进度条+步骤文案实时显示，进页即用不再等）
• 页面 JS 崩溃/闪屏卡住自动上报服务日志（卡加载类问题不再靠猜）
• 修 点 X 关不掉：托盘隐藏/显示/单实例唤醒加 Win32 兜底
• 修 引擎随应用自启动从未生效（异常被吞线程无声死亡）；WebView2 强制软件渲染防显存争用冻结
• 设置页分区重排（⑧ 个分区按职能归类，删重复开关）

升级：应用内「检查更新」或下载下方 zip 解压运行「升级到新版.bat」。个人数据（Key/人设/记忆）都在 ~/.zcode-qq-bot/，升级不影响。

v0.5.8

本批内容（0.5.6→0.5.8 累积）：

本地语音引擎

• 「克隆新音色」流程改版：选文件 → 截取 → ① 试听效果（临时参考直接合成播放）→ 满意 → 填名 → ③ 保存到音色列表——试听不占音色库，随便试
• 参考时长限 3-10 秒（GPT-SoVITS 引擎硬限制，零样本参考不是越长越好）+ 页面说明；音色列表显示参考时长、超限标 ⚠
• 「随应用自动启动引擎」选项（默认关，开启后应用启动约 8 秒自动拉起引擎）

语音消息页

• 页面重排：开关策略 → 语音来源与音色 → 本地引擎（引擎卡只在 GPT-SoVITS 供应商下展开）
• 智谱克隆音色列表：一键克隆成功自动入列（名字+speaker_id），带启用/移除

AI 行为

• 看图模式细分：新增「看图范围」设置——所有图都识（默认）/ 仅明确要求时才识图（@/回复机器人直接识；其余裸图交给插话判定器，只有明确要求看图或图与你强相关才回复——解决"几乎每图必回、无关图也插话显突兀"的问题）
• AI 互聊阈值二放宽（真 AI 乒乓 12 条/回 6 才试探；人类倾诉连发 8-10 条不再误判）

修复

• 语音消息页内容缺失（重复 return 导致整页只剩标题）
• 插件更新会把高版本"降级"的判定 bug
• 语音历史"占位竞争"（模型看不到自己语音说了什么导致的复读）

v0.5.6

本地语音引擎「克隆新音色」流程改版：

① 试听先行，满意再保存

• 新流程：选文件 → 截取（起始/时长）→ ① 试听效果（临时参考直接合成播放，不占音色库）→ 满意 → 填音色名 → ③ 保存到音色列表
• 不满意调起始/时长或换片段再点①，随便试多少次

② 参考时长限制说明与修正

• 「参考音频 3-10 秒」是 GPT-SoVITS 引擎的硬限制（零样本克隆取一小段最代表音色的即可，更长不是更好；大量素材想利用需走微调训练）
• 时长输入限到 10 秒（默认 8），不再出现填 30 秒保存后试听必失败的情况
• 音色列表显示参考时长，超出 3-10 秒的音色标 ⚠ 提示重截