Wtonec

Wtonec 是一个面向微信与 QQ 的 Android LSPosed/Xposed 双宿主语音模块。单个 APK 同时声明微信 com.tencent.mm 和 QQ com.tencent.mobileqq 作用域，在聊天页面提供悬浮球和语音面板。

主要功能

• 微信模块：微信聊天页悬浮球、语音模式长按入口、预设/克隆/语音包/设置面板。
• QQ 模块：QQ NT 聊天页悬浮球、QQ 语音发送链、私聊和群聊适配框架。
• Fish Audio 预设音色、克隆音色 ID、轻颜音色、ElevenLabs 音色和 Android 系统 TTS。
• 文字转语音、试听、生成、保存、生成并发送。
• 本地语音包导入、搜索、排序、试听、重命名、导出、删除和发送。
• 在线语音目录、下载、缓存、取消、重试、试听和发送。
• MP3/其他音频本地解码、Tencent SILK 兼容编码和宿主语音发送。
• API Key 加密保存、统一配置快照、共享配置 Bridge、DEX 缓存、运行日志和本地安全证据页。
• 156 个随 APK 打包的本地悬浮窗图标、自定义图标导入和微信/QQ 独立持久化。
• 液态玻璃、Miuix 浅色、AMOLED 深色及扩展面板主题；应用界面主题与语音面板风格相互独立。
• v1.6.9：液态玻璃光学材质采用背景采样、模糊、surface tint、描边高光和软件 acrylic fallback 分层渲染，避免根节点透明穿透。
• v1.6.9：统一 canonical 配置快照按 revision/CAS 原子保存，微信与 QQ 通过失效通知主动拉取，宿主不再逐字段轮询。
• v1.6.9：直连源站网络配置移除旧 CDN 过滤路径；聊天入口增加重绑和会话校验保护。
• v1.6.9：Fish Audio 目录更新到 296 项并包含新增 291–305 音色；轻颜免费、系统 TTS、MiniMax 不显示快捷语气标签，MiniMax emotion 与标签分离并显示参考价 0.2 元/次。
• v1.6.9：安全页支持配置 OpenAI-compatible/第三方 API 地址、Key 与模型发现；密钥仅以 Keystore 加密密文保存。
• v1.6.9：新增 ElevenLabs 文字转语音音色区和音色管理；收到的语音可从长按菜单提交到 ElevenLabs 克隆流程，返回的 Voice ID 保存到对应区域。

安装与激活

1. 从 项目 Release 或 Xposed 官方 Release 下载 APK。
2. 在 LSPosed 中启用 Wtonec。
3. 根据使用目标勾选作用域：
   • 微信：com.tencent.mm
   • QQ：com.tencent.mobileqq
4. 完全结束对应的微信或 QQ 进程后重新启动。
5. 首次启动按提示完成对应宿主的 DEX 匹配，再完整重启一次宿主。
6. 进入私聊或群聊，点击悬浮球或使用宿主语音入口打开面板。

微信和 QQ 的 Hook、DEX 缓存、会话状态和宿主目录分别隔离。只使用微信时可以只勾选微信作用域，只使用 QQ 时可以只勾选 QQ 作用域。

API Key

Fish Audio、轻颜和克隆音色需要自己的 Tiax API Key：

1. 访问 Tiax 官网 注册账号。
2. 登录 Tiax 用户中心 获取 API Key。
3. 在 Wtonec 设置页填写并保存。
4. 微信和 QQ 通过受控的加密配置 Bridge 使用同一份 Key；Bridge 不可用时使用本地加密缓存。

系统 TTS、本地语音包和公开在线样例不读取 Tiax Key。安全页可额外配置 OpenAI-compatible 或其他第三方 API 的 endpoint、Key 与模型列表；这些凭据只在本地以 Keystore 加密密文保存。文档、截图和日志中统一使用 YOUR_API_KEY，请勿提交真实 Key。

使用流程

微信模块

进入微信聊天页，将输入栏切换到语音模式，长按微信语音按钮，或点击悬浮球打开面板。确认面板顶部显示正确的当前会话后，再试听、生成或发送。

QQ 模块

进入 QQ NT 私聊或群聊，点击悬浮球，或使用已适配的 QQ 语音入口打开面板。发送前确认当前 QQ 会话和账号信息。QQ 版本差异可能影响 AIO、Contact、回调和语音气泡行为，实际兼容性以目标设备验证结果为准。

音频格式

接口返回 MP3 或其他音频后，Wtonec 在本地完成解码、单声道处理、24 kHz 重采样和 Tencent SILK 编码，再交给微信或 QQ 的正常语音发送链。直接修改文件扩展名不构成兼容格式转换。

数据目录

宿主副本按包名分开：

/storage/emulated/0/Android/data/com.tencent.mm/Wtonec/
/storage/emulated/0/Android/data/com.tencent.mobileqq/Wtonec/

语音包、索引、日志、崩溃诊断、DEX 缓存和任务缓存的详细说明见 数据目录、备份与清理。模块还维护受签名保护的 canonical 语音库，通过 PFD/Binder 与两个宿主同步。

文档

• 文档导航
• 安装与首次启动
• 双宿主说明
• 功能使用
• API Key
• 数据目录
• 隐私说明
• 常见问题
• Release v1.6.9
• Release v1.6.8（历史）
• Release v1.6.7（历史）
• Release v1.5.11（历史）
• 免责声明
• Xposed 官方仓库与版本规则
• 公开样例范围

项目入口

• 项目仓库：tianxing226/wtonec
• Xposed 官方模块仓库：Xposed-Modules-Repo/dev.wtonec
• GitHub Pages：tianxing226.github.io/wtonec
• 官网：tiax.pw

公开范围

公共仓库提供项目介绍、使用文档、截图、静态网站、少量独立 Kotlin 样例和 Release APK。正式 Hook、DEX matcher、微信/QQ 内部调用、编解码、JNI/Rust、Bridge、签名和加固实现保留在私有工程。

免责声明

Wtonec 仅供学习、研究与技术交流使用。使用者应遵守所在地法律法规、软件平台规则及第三方服务条款，并自行承担安装、配置、升级、内容来源和使用行为产生的责任。

本项目与微信、QQ、腾讯、LSPosed、Fish Audio、Tiax 及其他内容来源不存在隶属、合作、官方授权或背书关系，相关名称与商标归各权利主体所有。严禁用于侵犯隐私、传播侵权内容、欺诈、骚扰、批量滥用、干扰平台服务或其他违法用途。第三方接口、内容许可、价格和可用性以对应服务方规则为准。详细内容见 使用说明与责任边界。

反馈与隐私

反馈前请遮盖 API Key、Token、签名 URL、微信/QQ 账号、联系人、会话标识、输入文字和本地路径。Wtonec 不自动上传日志、安全扫描报告或本地语音包。