Antigravity QQ Bridge (Windows)

Windows 版本的反重力 2.0 (Antigravity 2.0) 桌面版 QQ 机器人桥接程序。

通过直接调用桌面版的后台 language_server.exe agentapi 接口，实现 QQ 消息与反重力桌面端会话的无缝直连。

---

技术亮点

• 直连桌面版 API：不走 PTY/ConPTY，直接调用 language_server.exe agentapi，与桌面版图形界面完全同步
• 三段式弹性投递体系 (v2.1.0)：
  • 被动回复通道：5分钟窗口内优先带 msg_id 被动回复，极速响应且不消耗主动额度；
  • 主动消息自动降级：长任务耗时超过被动窗口（>5分钟）时，自动剥离 msg_id 降级为主动消息直接推送；
  • Markdown/纯文本自适应：遭遇 QQ 特殊字符校验拒绝（40034011）时就地降级纯文本重发；
  • 开口秒级补报队列：若遇断网或极端主动配额耗尽，自动存入 UNREAD_EVENTS 暂存队列，用户开口瞬间提取最新 msg_id 一次性全部补报送达。
• 动态进程发现：自动扫描运行中的 language_server.exe，提取监听端口和 CSRF token
• 模型自动同步：读取桌面版 settings.json，用户在 GUI 切换模型后下一条 QQ 消息自动使用新模型
• 会话持久化：conversation_id 本地存储，重启后自动恢复同一对话
• UTF-8 强制覆盖：避免 Windows GBK 环境下 emoji 输出导致崩溃
• 免审批模式：适配 always-proceed 全局配置，无需逐次确认

与其他桥的区别

其他 3 个桥 (Linux)	Windows 桥
tmux 常驻 + send-keys 注入	直连 language_server.exe agentapi
读取 JSONL 日志拿输出	桌面版 GUI 实时同步
独立于 GUI 运行	与桌面版共享会话和模型配置
普通单向推送	三段式弹性投递 (被动回复/主动降级/未读补报)

这意味着你在桌面版切换模型、改设置，QQ 通道立刻跟着变——两个入口，同一个 Agent。

运行与部署

1. 复制 .env.example 为 .env 并填写配置（APP_ID, CLIENT_SECRET, MASTER_OPENID）
2. 启动：

   python antigravity_qq_bridge_win.py

3. 守护进程常驻：

   python daemon.py

架构

QQ 用户
  │
  ▼
QQ 官方 WebSocket 网关
  │
  ▼
antigravity_qq_bridge_win.py (三段式投递引擎)
  │
  ├─── 动态发现 language_server.exe (端口 + CSRF)
  ├─── 读取 settings.json (当前模型)
  ├─── 调用 agentapi (发送消息 / 获取回复)
  ├─── 监听 transcript.jsonl 增量日志
  └─── 持久化 conversation_id
        │
        ▼
Antigravity 2.0 桌面版 (language_server.exe)
  │
  └─── 用户在 GUI 中实时看到完整对话