# QQ、微信聊天渠道、权限与本机声音

当前0.14.0增加只读[3D记忆关联图](memory-graph-3d.md)：展示有实际依据的记录、来源、人物和会话关系，后端有界读取，原文按需详情。图不调用模型、不触发回忆或人格更新；旧版QQ恢复与技术修复保留原范围，最终全量、实机与正式加载另验，不预填成功。

版本0.11.0，修订日期2026-10-27。这里的移动端指用户已有的QQ、微信等聊天软件，主入口是“连接”；插件接入同一个持续人格。个人网页与Telegram保留未来接口，本版不挂载手机网页服务。

## 选择接入方式

| 接入方式 | 当前实现 | 用户需要完成 | 能力边界 |
|---|---|---|---|
| 个人QQ（默认向导） | Windows受管NapCat／OneBot11，准备、本人扫码与实际能力接入 | 一键准备后本人扫码，核对账号并确认默认自主社交，再接到当前人格 | 默认全部私聊／群，指定对象可选；安装、在线、接收与送达分别核实 |
| QQ官方Bot | 官方绑定任务二维码、本人授权、Gateway接收，文字／图片／视频文件／普通文件与撤回接口 | 手机扫码确认Bot授权；按平台资质选择私聊或群聊，再明确启用 | 连接的是Bot，不自动接管桌面个人QQ；群能力受实际账号的平台权限限制 |
| 微信官方iLink | 官方二维码、本人确认／必要验证码、私聊接收，文字／图片／视频文件／普通文件接口 | 手机扫码确认后选私聊范围并明确启用 | 当前只支持私聊；普通微信群、朋友圈、实时语音／视频通话不可用 |
| QQ OneBot11高级桥 | 既有本地桥的私聊／群聊及实际支持的动作 | 自行准备并登录兼容NapCat等桥，填写地址／账号／鉴权与事件回调 | 以桥能力和实际回执为准；语音需确认can_send_record |
| 微信 OneBot12高级桥 | 兼容桥的私聊／群聊路由及实际支持的动作 | 自行准备确有相应能力的微信桥 | OneBot12协议不保证具体微信桥能访问普通群；不宣称语音可用 |
| Telegram、个人移动端应用 | 统一适配接口／实验源码保留 | 后续单独接入 | 本版没有发布入口，不要求用户安装自建手机应用 |

“已支持”表示连接器实现相应协议，不能代替该账号实际资质或真实往返验收。0.10.1及更早记录没有个人QQ／微信群真人往返，模拟平台记录只证明相应隔离链路；0.11.0的安装、本人扫码、正式人格接入和私聊／群聊回执分别见[本轮最终验收](qq-one-click-setup.md#0110-final-acceptance)。二维码来自本次真实登录或绑定任务，由本机渲染，不把任意手机网页链接冒充账号登录。

## 连接流程（0.10.0，沿用分步操作）

“连接”首页提供QQ、微信、B站、声音、社交身份、QQ动态扩展六个目的入口；可选翻唱服务在“创作”中。QQ默认先提供个人QQ受管准备与扫码，之后核对账号并确认默认自主社交，接入当前已加载人格；官方Bot与“使用已有兼容桥”为次级入口。微信、B站继续沿各自扫码流程。“能力与权限”单独查看，不把全部高级字段铺在扫码页面。受管NapCat负责准备自己的运行目录和回调，已有桥方式仍要求实际可用服务，手机确认仍由本人完成。

0.8.0只重整管理界面的导航、内容层次与交互流程，core/、adapters/和运行时schema相对0.7.0未改，八个人格工具与persona-memory/3保持兼容。本版[完整本地回归](verification/0.8.0-tests.json)605/605通过，失败／取消／跳过均为0；UI与宿主专项55/55（50项UI＋5项host）属于同批验证，不另算独立需求。[真实DSH界面](verification/0.8.0-native-ui.json)完成5个主入口与16项任务式旅程、浅深主题及保存回读，使用隔离样本、无真实模型或平台调用。[后端兼容回执](verification/0.8.0-backend-compatibility.json)逐SHA核对50份后台及配套文件，继承0.7.0 SDK证据，未声称重新执行本版SDK。0.7.0的583/58/35与当时九页GUI保留历史含义；远程CI和发布状态另以实际结果为准。

## 账号与社交身份

“连接 → 社交身份”可从已实际连接的QQ／微信核对后登记，也可先登记用户自行注册的B站、抖音或其它平台账号。手工档案只表示人格与账号的关联，不产生登录态或执行权；当前没有适配器的平台明确未连接。同平台仍只有一个活动连接，多个档案不代表并发登录。owner social.inspect/list/upsert/remove/linkCurrent/refresh使用当前人格实例，persona_platform action:accounts只读目录。默认32条／人格、总256条／256KiB，另有字段与能力目录上限，不另存Token或Cookie。

实际账号、适配器支持、用户许可和当前可用分别核对；取消身份登记不会自动退出平台或删除记忆。完整字段和状态见[深刻记忆与社交身份](memory-reflection-and-social-identities.md)。

## 个人QQ一键准备与接入

[个人QQ操作说明](qq-one-click-setup.md)按准备、本人扫码、确认默认自主社交、接入当前人格说明。Windows x64受管入口复用已核实的QQ安装，固定版本下载并校验NapCat，在独立目录配置WebUI、OneBot API与事件上报；不替换QQ安装包、不捕获已有桌面窗口登录态。新启动的桥QQ仍会正常读写自己的用户数据。

默认自主社交在本人确认后将该独立QQ的私聊与群聊均接入，connect的allowedPrivateIds／allowedGroupIds为['*']；不要求用户逐个选择联系人或群。指定对象范围作为可选隐私／测试设置，仍控制平台通路。联系谁、是否尝试加好友、回不回复由人格决定，不由范围页面替人格预选。停止只处理本应用通道与可证归属进程，不能确认QQ全树退出时如实提示人工关闭。恢复仅沿已经成功接入的同实例／同根与原启用范围，不自动下载、换账号或扩大范围；明确停止清除恢复意愿。

### 好友能力的当前接线状态

入站好友申请与主动添加是两项不同工具能力。NapCat固定版已有set_friend_add_request处理真实入站申请，插件的申请事件／回应链仍未接线。主动申请在公开OneBot注册表仍缺action，本轮通过原创原生适配器补friend.query与friend.request源码接线；正式宿主加载后的工具实测另验，不能用已成功的一次操作者诊断代替。权限、查询引用、原始档案和真实结果分层见[QQ账号操作](qq-account-operations.md)。

## QQ官方发送策略

腾讯官方文档顶部说明主动推送自2025-04-21起不再提供，同页下方仍留旧额度。当前官方driver以取消主动推送为准，返回deliveryPolicy.proactive:false和passiveReplyRequired:true；没有有效被动回复上下文时返回QQ_PUSH_UNAVAILABLE，不伪造发送回执。私聊被动窗口60分钟，群聊5分钟；实际API仍可能受账号条件拒绝。该限制只适用于官方QQ，不套用到OneBot桥；人格仍可以自主决定想主动联系，执行器只报告当前平台实际能否完成。依据：[腾讯官方发送文档](https://github.com/tencent-connect/bot-docs/blob/main/docs/develop/api-v2/server-inter/message/send-receive/send.md)，核对2026-10-26。

## 官方QQBot／微信扫码步骤（次级方式）

1. 先在“设置 → 人格与记忆库”加载实例，打开“连接”，选择QQ或微信。向导申请平台绑定任务，显示真实二维码、状态与过期时间。
2. 用自己的手机在对应应用内扫码并确认。验证码只用于这次绑定，不作为设置保存。未确认、取消、失败、过期与已授权分别显示；结果未知先查询同一绑定任务，不重复创建。扫码只能由本人完成。
3. 授权后核对账号与驱动支持的私聊／群聊范围。微信官方只显示私聊；QQ群选项不代表账号已获所有群权限。空列表未接入，只有用户明确选择相应全部范围才保存为`*`；微信默认可选择本次配对对象。点“完成连接并启用”后才开始接收。
4. 展开“能力与权限”，按需许可当前驱动支持的项目；页面分别显示支持、许可、可用及不可用原因。未许可项目不能通过人格工具执行，勾选也不能创造平台未实现的能力。
5. 需要停止时关闭接入；“断开连接”先停止接收并删除本机保存的该连接凭据，不声称已撤销平台端授权。平台远程授权需在对应平台管理。仅取消本次扫码不会自动删除已有聊天记忆。

本人确认后凭据仅保存在本机独立连接登记；页面只显示hasCredentials，不返回Token或AppSecret。本节官方绑定不要求个人客户端安装，也不抓取桌面登录态、创建公网隧道或修改防火墙；0.11.0个人QQ的受管NapCat准备按前节单独执行，不与官方Bot绑定混称。扫码和高级桥是不同接入方式，改方式／账号会退休旧原生绑定，避免沿用旧账号的聊天源。

## 实际能力与用户许可

权限按“人格实例＋平台＋实际账号”保存。检查、保存、列出和恢复默认分别是owner动作`permissions.inspect({id})`、`configure({id,allowed})`、`list({id})`、`reset({id,accountId})`。普通保存不由前端指定另一个账号或目录；切换账号不会套用旧账号授权。默认文字可用，迁移旧语音设置时保留其已选语音意图，但实际支持和就绪状态仍需核实。高级列表可恢复不再使用的账号权限，最多保存128条／256KiB；恢复默认会移除该账号的自定义许可，并恢复渠道默认许可：文字，以及渠道voiceMode中已开启的语音意图。它不删除聊天记忆、不自动重连，语音仍须驱动支持、引擎和连接就绪；返回defaults列出实际默认项。

| 能力ID | 面板含义 | 当前边界 |
|---|---|---|
| chat.text | 文字消息 | 仍需已接入目标与平台回执 |
| chat.image / chat.video / chat.file | 图片／视频文件／普通文件 | 使用已保存的媒体assetId和实际字节；视频文件不等于视频通话 |
| chat.voice | 语音消息 | 官方QQ和微信缺少已验证的PCM WAV发送编码链；QQ OneBot11按实测record能力使用，微信OneBot12不宣称支持 |
| chat.sticker | 驱动实际实现的表情 | 当前QQ NapCat适配仅发送系统face ID，未实现自定义表情包mface上传；官方QQ／微信未实现此项 |
| message.reply / message.retract | 引用消息／撤回自己的消息 | 必须使用真实消息ID，只有驱动实现的动作可执行 |
| contacts.read / groups.read | 联系人／群列表查询 | NapCat或明确列举对应action的桥可查询有限结果，官方QQ／微信未实现；不获得任意客户端控制 |
| friend.query / friend.request | 查询QQ联系人与加好友设置／主动申请 | 原创固定版本原生适配已在源码接线；实际可用同时核owned启动、账号、就绪和一次工具许可，正式宿主验收另列 |
| friend.manage / group.manage / profile.update | 处理收到的好友请求／群操作／账号资料 | 当前执行器未实现；入站处理上游已有但尚未接线，不因主动申请实现而宣称全部好友管理可用 |
| feed.read / feed.publish / feed.react | 平台资料／动态读取、发布与互动 | QQ需用户自备动态协议服务；B站按操作映射读取／评论；微信朋友圈仍未实现。实际支持与许可分别核对 |
| call.voice / call.video | 实时语音／视频通话 | 当前未实现；生成语音文件不代表RTC通话能力 |

当前可用必须同时满足驱动支持、用户许可、实际账号与连接就绪；平台执行时还可能拒绝账号权限。未支持项目不能新授权；既有许可可保留或撤销，但available仍为false。能力目录不是未来功能自动承诺。

## 已有OneBot兼容桥的高级配置

QQ使用OneBot11，微信使用OneBot12。准备并登录自己的兼容桥后，填写API地址、实际账号ID、API令牌和私聊／群列表；QQ上报必须使用消息段数组，微信保留`self.platform=wechat`及稳定账号／发言者／群标识。API密钥留空保留旧值，明确勾选清除才删除。

事件回调使用状态返回的实际callbackUrl，常见为`http://127.0.0.1:17654/channels/qq/events`或`/channels/wechat/events`。通用桥可沿用Bearer上报令牌；NapCat原生HTTP Client使用`onebot-hmac`，以专用token对原始JSON字节计算HMAC-SHA1，发送`x-signature: sha1=<hex>`，不能当成Bearer。受管向导自动配置；手动NapCat通过channels.rotateIngress选择authMode:onebot-hmac并将仅本次返回的secret填入HTTP Client token。旋转使旧secret失效；配置和状态不回显。回调保留Host／Origin／正文容量与排队后轮换复核，不通过URL参数放密钥。保存后核对真实账号与在线，再明确启用；官方绑定不使用此回调。

桥只有明确识别为NapCat，或get_supported_actions列举了相应操作，才报告扩展能力。NapCat提供系统face、引用、撤回、联系人／群列表与视频；图片还需can_send_image确认，语音另需can_send_record。自定义表情包、好友／群管理和资料修改没有因存在能力ID而自动开放。

已有兼容桥的空接入列表表示该范围尚未接入，显式`*`开放相应全部对象或群；0.11.0个人QQ默认自主社交向导会在本人确认连接时为私聊和群都保存['*']，指定对象模式仍可选。最近未接入目标只保留有限ID元数据，便于用户核对，不保存其聊天正文。高级API默认本机／私网字面地址或localhost，远程必须明确allowRemote且HTTPS；不接受URL凭据、查询令牌或fragment。

## 同一个人格与陪伴工具范围

平台、账号、房间和实际发言者分别保留；每个房间＋实际发言者使用稳定原生通道，但共用同一人格核心。外部ID、昵称或sessionId不自动等于personId；是否认出同一人仍由人格判断。原话经DSH原生inbox持久，保留平台sourceAt、接收时间、role与speakerId；关系重归属不改实际发言者。未读取的图片／语音段如实标记，不从占位文本猜原话。

所有“相续人格”主预设在普通DSH、IM、主动和唤醒中使用独立工具范围，当前八工具为memory_search、memory_forget、persona_introspect、persona_decide、persona_voice、persona_media、persona_platform、persona_task。人格通过persona_task自主创建独立新任务，显式工作预设处理工程／研究等过程；主会话按需回收结果、选择实际片段供原有自主整理。裸派发、Harness和编码工具不直接放回陪伴主会话，其它DSH预设不变。

工作会话与委派封套以宿主可信角色追踪，AI写的kind:user任务指令不会成为真人原话；任务详细过程和报告另行归档，主会话只自动留下导航事实。用户的平台授权仍按实际账号与渠道执行，创建worker不会获得新的平台或文件权限；在已有full-access环境中不宣称额外OS沙箱。原生`ctx.agents.create/resume`也继续用于真实接收／恢复通道。没有新增必须被@、主动次数、回复间隔、话题门槛或成长频率，详见[自主委派与任务档案](delegation-and-task-archives.md)。

## 发送、主动、睡眠与实际回执

原生inbox持久只表示收到来信，生成最终文字也不等于平台已发出。外发先存prepared，按同一源事件／操作编号去重；只有连接器取得明确平台回执才记为delivered和实际assistant。QQ等可返回平台消息ID；微信ret=0但没有远程消息ID时保存带client_id的API接受回执，并标明ID种类，不伪造远程消息ID或用户已读。超时、缺回执与冷恢复prepared保持unknown，不自动重发、不假清用户pending。

人格的主动消息沿已有持久计划与真实目标发送。睡中来信保留为待处理，唤醒后回到相应目标；接入群聊不改变注意、回复与睡眠选择。作品生成与平台发送分开报告：persona_media得到assetId，persona_platform仅对已支持、已许可的真实目标执行，使用实际资产字节与真实消息ID，不提供通用客户端遥控。

## 本机语音

Windows现有System.Speech生成WAV；其它系统缺引擎时如实不可用，文字仍可使用。不下载TTS模型、不训练／克隆音色，不把Edge在线TTS作为默认依赖。音色可由人格经persona_voice按需选，用户也可指定；无性格标签硬映射或每轮必选要求。用户模式下人格偏好仍可保存备用，明确音色不可用不静默换云端。语速近似SAPI音级，当前pitch:false；[微软SpeechSynthesizer文档](https://learn.microsoft.com/en-us/dotnet/api/system.speech.synthesis.speechsynthesizer)说明实际本机接口。

`text`发送文字；`both`可用真实文字回执记录交付，并另报voiceUnavailable；`voice`必须合成成功且渠道确认音频，否则明确失败，不擅自改发文字。官方QQ／微信当前都缺已验证的本机WAV官方编码转换链，微信OneBot12也不宣称支持。QQ OneBot11需要桥实测can_send_record。试听只生成短WAV，用户手动播放，不投递平台或写人格经历。生成、平台API接受、客户端收件和用户听到分别报告。

## 技术容量、恢复与撤销

| 载体 | 当前代码上限与行为 |
|---|---|
| 官方连接登记 | xiangxu-connections/1，两个平台账号，文件1MiB；不在文本人格备份中，凭据不回显 |
| 扫码任务 | 每平台当前任务，最长600000ms（10分钟）；平台可更早过期。重复查询同flowId，不重复申请授权 |
| 官方协议载体 | JSON／Gateway帧1MiB，单条文字16000个Unicode字符，媒体外发16MiB，串行入站队列32 |
| 官方恢复上下文 | 每账号最多128项，更新游标16KiB；它们是传输路由事实，不向模型注入整份目录 |
| 高级桥登记／回执 | xiangxu-channels/1最多1MiB、128个binding、每范围256个ID；回调正文64KiB、队列32 |
| 有限去重 | 回执2048、未确认最多256、终态保留目标1024；prepared／unknown不静默淘汰。终态淘汰保留源时间floor／出站序号高水位，拒绝过期未知入站与旧发送，不伪造旧ack |
| 用户许可登记 | xiangxu-permissions/1，128条、256KiB；按当前实例／实际账号消费，不混入模型人格材料 |
| 声音偏好／目录 | voice/profile.json 16KiB；内存最多8会话、每会话32音色、总32KiB，按需查询 |
| 本机声音缓存 | 单次2000个Unicode字符、单文件8MiB、最多4文件／总16MiB、60秒合成时限；超限不截断后冒充完整朗读 |

这些帽分别作用于传输、元数据与文件，不是人格发言频率。图片／视频作品库和模型读取另有独立上限，见[形象与创作](media-and-identity.md)。普通停用保留配置与去重状态；恢复某人格根会退休其旧binding、增加代次并停用接入，明确启用后建新通道，保留回执阻止旧事件重放。明确遗忘沿核心永久撤销链清相关派生，不因重新加载、作品结果迟到或恢复旧档案复活。

## 0.6.0 当前验证范围

0.6.0当时九页管理与八工具、自主委派和任务资料隔离的回执见[当前管理说明](management-ui.md#060-自主委派与验证范围)。完整回归495/495、真实DSH加确定性fixture专项35/35及可复用脚本另一次35/35属于0.6.0；它们没有新增真实平台账号或付费真实模型调用，不能当作用户QQ／微信已登录或收件。

## 0.5.0 实现与验证范围

> 本节为0.5.0历史范围；当时七工具且禁止人格派发，已由0.6.0自主委派与独立任务预设替代。

0.5.0当时实现官方扫码、实际能力／授权、陪伴工具隔离和媒体接口；当时回执统一在[历史管理说明](management-ui.md#050-实现与验证范围)维护。本人扫码、真实账号资质、真实平台收件及付费供应商生成没有在本轮完成，不预填通过数。下面保留0.4.0历史回归、模拟桥和WAV结果；0.4.1历史界面证据见[历史管理说明](management-ui.md#041-历史界面与验证范围)。

## 0.4.0 历史验证

完整本地回归 **336/336通过**，29份已记录运行源码SHA前后一致，79个JS/MJS的语法/核心独立性/包入口检查通过；具体范围见[完整回归摘要](verification/0.4.0-tests.json)。该回归包含明确保留的实验源码测试，不表示个人网页已发布。

最终原生SDK渠道专项 **67/67通过**：真实DSH引擎、固定模拟模型和loopback模拟QQ/微信桥。实际42个宿主请求与42个fixture请求均为`persona-social-fixture/fixture-v1`，共11次模拟HTTP发送（QQ7、微信4）。覆盖两平台私聊/群聊、同群不同actor隔离、共同人格、自主私聊目标、重复回调、等待/睡眠/明确唤醒、真实来源时间及未知发送不进入已说C1，详见[最终SDK与音频摘要](verification/0.4.0-sdk-fixture.json)。

音频使用本机Microsoft Huihui Desktop实际生成457852字节WAV：PCM16、单声道、22050Hz；完整字节经模拟QQ标准record动作取得模拟消息回执，缓存清理与退出恢复也有证据。没有播放到声卡，没有登录或发送到真实QQ/微信账号，也没有调用真实模型。不能把这项模拟协议交付写作用户实际平台已经收到声音。

SDK shutdown后留下的死PID语音lease另做9/9定向恢复，验证接管、短真实WAV、owned cleanup及显式关闭释放；结果在SDK摘要leaseRecovery单独计数，没有并入67项重复汇总。最终隔离载体已停止，进程和人格写锁均为0。

最终冷构建原生GUI实际显示七页与QQ/微信未配置状态、两个本机音色；用户指定Huihui保存后冷加载仍保持，音高不支持时控件禁用，真实WAV播放器保留手动controls而不autoplay，深色主题在重新挂载后保持。textarea只读type赋值与裸null文字问题已在真实验收中修复并复验；见[原生界面摘要](verification/0.4.0-native-ui.json)和[截图](management-ui.md#040-历史验收回执)。

初次55项文字渠道专项保留为历史（37/37请求、10次模拟发送），由最终67项音频链专项明确补充；未发布网页原型27项和旧0.3.0的229/26不提升成本版结果。0.4.0当时仍缺用户实际桥地址和账号，真实平台往返与声音听感不在该历史轮次已通过的证据中。

协议依据为[OneBot11固定版本](https://github.com/botuniverse/onebot-11/tree/d4456ee706f9ada9c2dfde56a2bcfc69752600e4)、[OneBot12固定版本](https://github.com/botuniverse/onebot/tree/d533f0fca3bd14781d4461776dba8d907d9de253)，代码中的`ONEBOT_STANDARD_SOURCES`记录核查日期2026-10-26。官方绑定依据为[腾讯QQBot连接器](https://github.com/tencent-connect/dsh-qqbot)与[腾讯微信iLink适配](https://github.com/Tencent/openclaw-weixin)；本机代码记录核查日期2026-10-26。完整字段权威见[persona-schema第14节](plan/persona/persona-schema.md#14-聊天渠道与本机声音技术契约050040引入)。


## 0.7.0验证口径

0.7.0[完整本地回归](verification/0.7.0-tests.json)583/583通过，失败／取消／跳过均为0；[真实DSH SDK](verification/0.7.0-sdk-fixture.json)分别完成新链58/58与委派链35/35，两套有重叠、分别列示，使用固定fixture且真实LLM／平台调用均为0。[原生九页GUI](verification/0.7.0-native-ui.json)使用合成数据、0模型调用；[自主性源码审查](verification/0.7.0-autonomy-audit.json)分列源码链、定向回归与交叉复核。远程CI结果不由本地回执推断；0.6.0的495/35及当时九页GUI、0.5.0和更早结果保留历史含义。0.7.0已修改核心，不能沿用0.6.0核心九文件未变的结论。账号登记不证明真实平台往返，B站／抖音接口预留不证明私信、投稿、朋友圈或实时通话已实现。

## 0.10.0 丰富消息、B站与自备服务

QQ OneBot11新增chat.mention、message.read、message.forward.read；media.cover由用户自备翻唱服务提供。原始消息段、系统表情、提及、引用、合并转发和媒体文件编号保留各自真实身份与来源。安全快照省略签名URL、内联二进制和任意本机路径并报告省略，不宣称永久保存所有原始网络字节。纯媒体消息允许空文字原件；转写／引用／转发资料为程序材料，不伪造用户键入文字。

channels.config兼容增加resolveIncomingMedia（默认true）与transcribeIncomingAudio（默认false）。解析图片还需宿主附件服务和模型声明视觉输入；音频识别依赖桥返回字节与已配置DSH STT，当前处理有界PCM16 WAV，可转换为单声道16kHz，格式或服务不支持时保留未识别。新增能力不自动移植到微信或官方Bot。

B站独立公共网页扫码适配器提供search/recommend/video/subtitles/comments/frames读取和comment/reply/share/message外发。权限按当前人格、平台和真实账号保存，B站默认全关；feed.read映射资料读取，feed.publish映射评论，message.reply映射回复，chat.text映射私信／视频链接分享。字幕按分P／段时序续读，故事板返回实际采样和cropRect，不冒充连续视频理解。外发须真实rpid或msg_key回执；unknown不自动重试，同一未确认内容不能仅换编号重发。

QQ动态与翻唱走xiangxu-social-provider/1，不是OneBot标准保证的QQ空间或翻唱API。用户提供真实兼容服务并明确启用，动态校验目标账号，翻唱使用已登记真实音频。请求／响应JSON格式请在对应服务配置页展开“接口路径与连接选项 → 查看扩展协议格式”；协议概述、容量和接入状态见[0.10.0 接入与检索说明](integrations-and-retrieval.md)，字段见[第22节](plan/persona/persona-schema.md#22-混合候选检索与可选平台扩展0100)。平台限制控制可执行能力，不规定人格关注谁、是否回应、怎样成长或多久主动。

音频资产库单件16MiB是入库／下载上限，不等于平台可发送同尺寸语音。本插件当前QQ OneBot11的record语音发送链单件硬帽8MiB；WAV／FLAC／Ogg／MP3仅表示可识别容器的校验与入库支持，不保证桥能解码、转码或成功发送。真正可发仍需当前桥确认record能力、账号与用户许可及实际平台回执。

## 0.10.1 B站扫码恢复与启动核实

B站页面可显式恢复同一有效flow的二维码，失效时才重新建立登录任务；能力行和授权确认使用同一组中文名称。服务仅在已启用且已有凭据时启动做一次GET /nav核实，失败不自动重试；未配置／关闭保持离线。用户已在本轮完成B站本人扫码并仅允许feed.read，真实读取结果另列于[0.10.1 界面、检索与上下文验收](ui-retrieval-context-validation.md)，不代表评论／回复／私信／分享已授权或验收。QQ仍无NapCat等兼容桥，个人账号／群聊真人往返不能写成完成。以上0.10.0和更早回执继续保留各自历史范围。

0.10.1真实读取另发现旧未签名/x/player/v2可在aid／bvid／cid回显一致时返回错误字幕轨，现使用签名/x/player/wbi/v2并核对视频／分P身份与可辨识的轨资产来源。未编码ID的轨不假称已绑定；contentHash可核对分页版本，平台来源验证不等于内容对应已被判定。程序不按语义删改字幕，内容是否对应仍由人格判断，详见[字幕来源修复说明](ui-retrieval-context-validation.md#字幕轨来源身份回显还不够)。

## 0.11.0 当前验收入口

个人QQ受管准备、本人扫码、范围授权、正式人格接入、私聊／群聊回执和停止恢复分别在[本轮最终验收](qq-one-click-setup.md#0110-final-acceptance)回填。文档同步不预填成功数，也不重写以上0.10.1及更早的历史验收。上游同Windows构建的已知问题仅作为排查线索，不表示所有机器一定失败。

## 0.11.0 独立QQ账号作用域

persona_platform的scope:account不要求已有聊天target或binding。宿主可信工具编号、当前人格根、实际账号和本次原生启动共同绑定操作；模型不能传入另一个memoryRoot、伪造入站申请flag或把主动申请写成聊天delivered。friend.query产生真实targetRef／optionsRef，friend.request消费同次查询，friend.status核对同一receiptId，完整技术原文沿receipts／receipt分页回查。

Windows QQ精确wrapper与固定NapCat bundle校验通过才加载原创sidecar；本机回环认证、marker、bootId、owned进程树与实际在线账号均须一致。版本不支持、离线、停止或换号如实不可用，普通OneBot聊天按自己的状态继续。一次许可之后，联系对象、是否申请和记忆选择仍由人格自主决定；工具说明增加到CONTROL_GUIDANCE，不新增频控、亲密度或价值审批。

本轮私聊／群聊各一次真人入站、QQ delivered和用户收件已确认；真实模型共两轮、无model_errors。三人群目前只确认一位发言者，不推定多人身份变化已验收。新账号工具在正式DSH的加载与测试仍待完成，统一见[当前验收](qq-one-click-setup.md#0110-final-acceptance)。