把 QQ 聊天、语音通话、默认音色、虚拟形象和 B 站工具整理成可以独立配置的 Windows 项目。

当前状态：0.1.0a1 Alpha 预览版。第二台 RTX 2060 设备已验证文字聊天、语音消息和语音通话；QQ 虚拟角色视频存在未解决的兼容性问题。 逐步安装修复后的成功记录不能替代从零部署、重启恢复和长期运行验收。本版不承诺 40 分钟装完或固定响应延迟。

在一台带内置实体摄像头的 Windows 11 笔记本上，CameraEmulator 独立读取能得到正确角色，但 QQ 选择该设备后仍显示实体镜头。升级到 QQ 9.9.35、使用与正常本机一致的摄像头 DLL 后仍未解决。与实体摄像头共存有关只是待验证假设，尚无根因结论。需要可靠角色视频的使用者请等待后续修复；本版可先使用文字与语音功能。

发布与模型下载：v0.1.0a1。

第三方 QQ 协议适配器可能遇到账号限制、接口变动或平台风控。不要用本项目规避平台限制。

• 23 个抽离的原有脚本、5 个 AstrBot 插件，以及统一配置、安装、校验和离线测试工具。
• 当前默认人设文本；362 张表情包、12 个情绪类别和可迁移索引；默认参考音频与形象素材。
• 本地权重以独立模型包交付，不放入 Git；上游模型从固定版本下载并核对 SHA256。
• 密钥填在本地 .env；账号、设备和路径填在本地 config.json。

电话默认直接调用模型以保留源环境的低延迟路径。它读取人设文本，不自动等于 AstrBot 的跨天记忆。 B 站自动巡检、形象和默认麦克风看守默认关闭；完成对应配置后自行启用。

在仓库根目录安装可编辑包后运行：

python -m pip install -e .
python -m unittest discover -s tests -v
python scripts/test_bili_patch.py
python plugins/astrbot_plugin_qq_power/test_qq_power.py
python scripts/release_check.py

上述检查不发送 QQ/B 站消息，不代表电话、账号登录或新机器部署已经通过。

项目原创代码按 MIT 发布。依赖保持各自许可证，见 NOTICE。 素材的制作方说明、来源核对状态与逐文件哈希见 assets/ASSETS.md。 不会用项目的 MIT 声明替第三方改写授权范围。

这是软件驱动的虚拟角色。不要冒充现实中的个人，不要把它当成专业医疗、法律或紧急服务。 停用方式和本地记忆位置见 docs/04_人设与记忆.md。