https://github.com/bestxby/wechat-with-antigravity
A powerful bridge connecting personal WeChat to Antigravity Agent, transforming WeChat into a full-duplex root terminal for your IDE.
https://github.com/bestxby/wechat-with-antigravity
ai-agent antigravity-ide automation ide-plugin wechat-bot
Last synced: about 16 hours ago
JSON representation
A powerful bridge connecting personal WeChat to Antigravity Agent, transforming WeChat into a full-duplex root terminal for your IDE.
- Host: GitHub
- URL: https://github.com/bestxby/wechat-with-antigravity
- Owner: bestxby
- License: mit
- Created: 2026-06-12T16:50:39.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2026-06-12T17:28:15.000Z (7 days ago)
- Last Synced: 2026-06-12T18:27:05.960Z (7 days ago)
- Topics: ai-agent, antigravity-ide, automation, ide-plugin, wechat-bot
- Language: TypeScript
- Size: 40 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WeChat with Antigravity 🚀 (原生智能体微信网关)
将您的微信变成 AI Agent 智能体的“万能遥控器”！
本项目允许您直接使用个人微信与本地运行的 **AI Agent（如 Antigravity IDE, Claude Code 等）** 进行交互。支持文字、图片、文件、甚至是语音的多模态无缝对接！
经过底层架构的深度重构，本项目抛弃了传统的轮询 Daemon 守护进程模式，转而采用与 Agent 深度集成的 **原生驱动引擎 (Native Agent Loop)**。它不只是一个聊天机器人，而是您挂在微信上的一名**全栈 AI 架构师**。
---
## 🌟 核心亮点 (Highlights)
| 特性 | 详细说明 |
|---|---|
| **扫码即用** | 无需部署复杂的服务器架构，无需繁琐注册。直接在电脑端扫码绑定，一分钟即可上路。所有数据流转全在本地机器，绝对的隐私安全。 |
| **可视控制台** | 内置 IDE 侧边栏可视化控制面板，支持查看运行状态、一键启动/关闭守护进程、实时日志输出与便捷指令触发。 |
| **消息不刷屏** | 只推送核心信息——任务进度、最终结果。智能体在阅读文件、排查 Bug、写代码等思考过程中产生的终端噪音会被底层全自动拦截。 |
| **"对方正在输入中..."** | 当智能体在执行长达数分钟的复杂工程时，底层跨进程守护系统会维持微信头部的“输入中”动画，让您时刻感知它正在干活，告别漫长的等待焦虑。 |
| **文件/多模态支持** | 支持语音秒转文字及音频多模态识别；发图片、报错截图、PDF文档给它分析；它生成的报告和代码也能直接回传到微信里。 |
| **动态大脑转移** | 微信随心所欲穿梭于您的无数个代码宇宙！在任何一个正在开发的终端或窗口中启动监听，该工作区即刻接管微信控制权，微信瞬间变为对当前项目发号施令的遥控器。 |
| **底层多开防死锁** | 内置物理级 Mutex 文件锁。在不同项目切换时，物理防止“多个窗口大脑”同时抢夺微信消息导致的精神分裂。 |
---
## 🛠️ 微信端便捷指令集 (Convenient Commands)
在微信对话中，您可以发送以下内置的斜杠指令（Slash Commands）直接控制和查看您的电脑系统：
* **`/status`**：查看系统健康状态。实时输出当前系统的 CPU 负载、内存使用量/总量/百分比、各磁盘分区容量（已用/空闲/百分比）以及系统已开机时间。
* **`/lock`**：锁定电脑工作站。通过调用 Windows API 立即锁定屏幕，保护电脑隐私安全。
* **`/sleep`**：使电脑进入睡眠模式。挂起当前系统进入低功耗休眠，当您重新唤醒电脑时，智能体将恢复工作。
* **`/screenshot`**：获取实时桌面高清截图。支持高 DPI 自适应缩放，截取当前主屏幕的完整画面并自动发送给您。
* **`/awake`**：防休眠挂机模式开关。如果当前未运行防休眠，发送后将立即开启（保持系统清醒以接收微信消息）；如果正在运行，发送后将自动关闭。
* **`/reset`**：重置智能体记忆。清空当前的任务流与对话上下文，让智能体大脑重归零点，开始处理全新任务。
---
## 🛠️ 前置要求
1. 本地安装 Node.js (v18+) 和 npm
2. 本地正在运行支持命令执行的 Agent（如 Antigravity IDE, Claude Code 等）
---
## 🚀 详细使用指南
### 第一步：初始化与微信登录
在项目根目录下安装所需的依赖，然后运行登录脚本：
```bash
npm install
npm run setup
```
运行后，终端中会渲染出一个登录二维码。请使用您的**个人微信**进行扫码。
扫码成功并成功登录后，相关的状态和会话登录凭证（Credentials）将被加密保存在您本地的 `~/.wechat-antigravity` 目录中。
---
### 第二步：安装并启动服务
我们提供了三种启动和接管方式：
#### 方式 A：通过 Antigravity IDE 插件自动管理 (强烈推荐)
通过安装本地 IDE 插件，您可以直接在 IDE 侧边栏中可视化地开启/关闭微信桥接，并享受完全自动化的后台消息接收与智能体唤醒。
1. **安装插件**：
* **方法一：通过 VSIX 离线包安装 (强烈推荐，最简单)**：
* 前往 GitHub Releases 页面下载最新的 `wechat-antigravity-bridge-2.2.0.vsix` 文件。
* 打开 Antigravity IDE，按 `Ctrl + Shift + P` 唤起命令面板，选择 **`Extensions: Install from VSIX...`** 并导入下载好的 vsix 文件；或者在终端中运行：
```bash
antigravity --install-extension wechat-antigravity-bridge-2.2.0.vsix
```
* **方法二：本地源码手动安装 (适合开发调试的用户)**：
* 在根目录编译插件代码：
```bash
npm run build
```
* 将整个项目文件夹复制或建立软链接到以下路径：
* **Windows**: `C:\Users\<您的用户名>\.antigravity-ide\extensions\bestxby.wechat-antigravity-bridge-2.2.0`
* **macOS / Linux**: `~/.antigravity-ide/extensions/bestxby.wechat-antigravity-bridge-2.2.0`
* 重启 Antigravity IDE，插件即会自动激活。
3. **可视化配置与运行**：
* 启动 Antigravity IDE 后，点击左侧活动栏 (Activity Bar) 中的 **WeChat Agent** 微信小图标。
* 如果先前已登录，侧边栏会显示您的状态以及后台消息监听器守护进程（Daemon）状态。如果未登录，可直接在侧边栏中进行扫码绑定。
* 控制台界面采用全新自适应（Responsive）单页布局设计，支持自动缩放，无需任何滚动。
* 点击 **开启** 按钮开启守护进程，此时状态灯将变为绿色（Running）。
* 当您在微信端给智能体发送指令时，插件会全自动捕获消息并唤醒 IDE 侧边栏的 Antigravity 智能体面板开始处理，处理完成后自动回传，无需手动执行任何命令！
#### 方式 B：纯终端命令行启动
您可以在需要被智能体接管的任意工作区目录下，直接执行以下命令开启监听：
```bash
# 请确保此时的环境是在目标代码仓库下，且传入本项目所在的绝对路径运行
node /path/to/wechat-with-antigravity/dist/agent-loop/wait-message.js
```
---
## 🔄 动态多工作区路由 (Active Workspace Routing)
当您在 IDE 中同时打开多个项目（工作区）时，它们会通过底层的路由机制进行消息分发与切换：
* **核心机制**：系统在 `~/.wechat-antigravity/workspaces.json` 中记录当前所有打开的 IDE 工作区，并在 `active_workspace.txt` 中记录当前被激活的消息接收工作区。
* **焦点感知**：当您的鼠标点击或切换到某个 IDE 窗口时，插件会自动将当前激活的窗口路径写入到 `active_workspace.txt`。
* **可视化看板**：WeChat 侧边栏控制台内置了“🖥️ 活跃工作区”看板，实时渲染出所有打开的代码仓，并为当前接收消息的活跃窗口打上绿色的 “接收中 / RECEIVING” 呼吸徽章。
* **手动点击切换**：除了聚焦自动切换，您还可以直接在侧边栏的列表中点击任意一个工作区，立刻手动将消息接收大脑路由转移到对应的窗口。
* **消息路由**：微信消息监听器收到新指令后，会优先读取该活跃窗口配置，并自动在其对应的工作区路径中写入任务并唤醒智能体。
---
## 🔒 远程微信二次确认流程 (Remote Confirmation Loop)
为了在远程托管（例如电脑放在家，您出门在外用手机控制）时保证本地系统的安全性，项目内置了**微信端双向确认机制**：
1. **触发安全操作**：当智能体需要执行特权或高风险操作（例如读写敏感文件、发起网络请求、打开浏览器等）时，本地程序会启动 `wait-approval.js`。
2. **推送确认请求**：智能体会将本次操作的详细内容（例如“准备打开 Gemini 网页”）推送至您的微信。
3. **挂起等待**：本地进程进入挂起阻塞状态，并在微信维持“对方正在输入中”状态，等待您的指令。
4. **微信答复**：
* 回复 **`y`** 或 **`yes`**：本地收到确认许可，继续执行高风险操作。
* 回复 **`n`** 或 **`no`**：本地拒绝授权，中断并安全退出当前特权操作。
通过这种“微信即时授权锁”，您能够绝对掌控智能体在您电脑上的行为。
---
## ⚙️ 进阶：如何配置无弹窗完全后台运行 (Bypass Screen Dialogs)
默认情况下，IDE 的沙箱安全策略会对所有敏感动作（如读写文件、启动浏览器等）在**电脑屏幕上弹出确认框**。如果您不在电脑旁，这些弹窗会导致流程卡死。
为了实现真正的 **100% 离线远程托管**，您可以为该项目配置白名单免密权限：
### 配置步骤：
1. 寻找或创建您 IDE 的项目授权配置文件：
* **Windows 路径**: `C:\Users\<您的用户名>\.gemini\config\projects\wechat-with-antigravity.json`
* **macOS/Linux 路径**: `~/.gemini/config/projects/wechat-with-antigravity.json`
2. 将以下 JSON 写入该文件中：
```json
{
"fileAccessPolicy": "AGENT_SETTING_POLICY_ALLOW",
"internetPolicy": "AGENT_SETTING_POLICY_ALLOW"
}
```
3. **效果说明**：
配置完成后，IDE 将直接信任该项目目录。当智能体通过浏览器子 Agent（Browser Subagent）在后台执行网页 analysis 或操作（如自动登录、获取网页 DOM、截图）时，**将不再有任何屏幕确认弹窗拦截**，配合微信二次确认，即可完美实现全后台静默托管运行。
---
## 🌙 防休眠挂机 (Awake Mode)
为了实现 24 小时全天候的消息响应，底层集成了一个调用 Windows API 的原生防休眠脚本。只要您在终端中运行以下命令，您的电脑屏幕可以息屏，但系统绝不会进入深度休眠切断网络。
```bash
npm run awake
```
您也可以通过微信直接发送 **`/awake`** 控制该模式的启闭。
---
## 🧹 记忆重置大法 (/reset)
随着长周期的对话，大模型的记忆上下文会越堆越多。当您希望智能体立刻跳出当前的开发思维，重开一张白纸去做一个全新的任务时，只需在微信中发送指令：
👉 **“/reset”** 或 **“忘掉之前的任务，重新开始一个全新的任务”**
收到指令后，智能体会主动拦截并清空当前的任务流，让大脑重归零点状态！