{"id":50971981,"url":"https://github.com/bestxby/wechat-with-antigravity","last_synced_at":"2026-06-19T03:02:04.490Z","repository":{"id":364351866,"uuid":"1267563336","full_name":"bestxby/wechat-with-antigravity","owner":"bestxby","description":"A powerful bridge connecting personal WeChat to Antigravity Agent, transforming WeChat into a full-duplex root terminal for your IDE.","archived":false,"fork":false,"pushed_at":"2026-06-12T17:28:15.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T18:27:05.960Z","etag":null,"topics":["ai-agent","antigravity-ide","automation","ide-plugin","wechat-bot"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bestxby.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-12T16:50:39.000Z","updated_at":"2026-06-12T17:28:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bestxby/wechat-with-antigravity","commit_stats":null,"previous_names":["bestxby/wechat-with-antigravity"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bestxby/wechat-with-antigravity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestxby%2Fwechat-with-antigravity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestxby%2Fwechat-with-antigravity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestxby%2Fwechat-with-antigravity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestxby%2Fwechat-with-antigravity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bestxby","download_url":"https://codeload.github.com/bestxby/wechat-with-antigravity/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestxby%2Fwechat-with-antigravity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34515405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","antigravity-ide","automation","ide-plugin","wechat-bot"],"created_at":"2026-06-19T03:02:03.929Z","updated_at":"2026-06-19T03:02:04.485Z","avatar_url":"https://github.com/bestxby.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WeChat with Antigravity 🚀 (原生智能体微信网关)\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e将您的微信变成 AI Agent 智能体的“万能遥控器”！\u003c/strong\u003e\n\u003c/p\u003e\n\n本项目允许您直接使用个人微信与本地运行的 **AI Agent（如 Antigravity IDE, Claude Code 等）** 进行交互。支持文字、图片、文件、甚至是语音的多模态无缝对接！\n\n经过底层架构的深度重构，本项目抛弃了传统的轮询 Daemon 守护进程模式，转而采用与 Agent 深度集成的 **原生驱动引擎 (Native Agent Loop)**。它不只是一个聊天机器人，而是您挂在微信上的一名**全栈 AI 架构师**。\n\n---\n\n## 🌟 核心亮点 (Highlights)\n\n| 特性 | 详细说明 |\n|---|---|\n| **扫码即用** | 无需部署复杂的服务器架构，无需繁琐注册。直接在电脑端扫码绑定，一分钟即可上路。所有数据流转全在本地机器，绝对的隐私安全。 |\n| **可视控制台** | 内置 IDE 侧边栏可视化控制面板，支持查看运行状态、一键启动/关闭守护进程、实时日志输出与便捷指令触发。 |\n| **消息不刷屏** | 只推送核心信息——任务进度、最终结果。智能体在阅读文件、排查 Bug、写代码等思考过程中产生的终端噪音会被底层全自动拦截。 |\n| **\"对方正在输入中...\"** | 当智能体在执行长达数分钟的复杂工程时，底层跨进程守护系统会维持微信头部的“输入中”动画，让您时刻感知它正在干活，告别漫长的等待焦虑。 |\n| **文件/多模态支持** | 支持语音秒转文字及音频多模态识别；发图片、报错截图、PDF文档给它分析；它生成的报告和代码也能直接回传到微信里。 |\n| **动态大脑转移** | 微信随心所欲穿梭于您的无数个代码宇宙！在任何一个正在开发的终端或窗口中启动监听，该工作区即刻接管微信控制权，微信瞬间变为对当前项目发号施令的遥控器。 |\n| **底层多开防死锁** | 内置物理级 Mutex 文件锁。在不同项目切换时，物理防止“多个窗口大脑”同时抢夺微信消息导致的精神分裂。 |\n\n---\n\n## 🛠️ 微信端便捷指令集 (Convenient Commands)\n\n在微信对话中，您可以发送以下内置的斜杠指令（Slash Commands）直接控制和查看您的电脑系统：\n\n* **`/status`**：查看系统健康状态。实时输出当前系统的 CPU 负载、内存使用量/总量/百分比、各磁盘分区容量（已用/空闲/百分比）以及系统已开机时间。\n* **`/lock`**：锁定电脑工作站。通过调用 Windows API 立即锁定屏幕，保护电脑隐私安全。\n* **`/sleep`**：使电脑进入睡眠模式。挂起当前系统进入低功耗休眠，当您重新唤醒电脑时，智能体将恢复工作。\n* **`/screenshot`**：获取实时桌面高清截图。支持高 DPI 自适应缩放，截取当前主屏幕的完整画面并自动发送给您。\n* **`/awake`**：防休眠挂机模式开关。如果当前未运行防休眠，发送后将立即开启（保持系统清醒以接收微信消息）；如果正在运行，发送后将自动关闭。\n* **`/reset`**：重置智能体记忆。清空当前的任务流与对话上下文，让智能体大脑重归零点，开始处理全新任务。\n\n---\n\n## 🛠️ 前置要求\n\n1. 本地安装 Node.js (v18+) 和 npm\n2. 本地正在运行支持命令执行的 Agent（如 Antigravity IDE, Claude Code 等）\n\n---\n\n## 🚀 详细使用指南\n\n### 第一步：初始化与微信登录\n\n在项目根目录下安装所需的依赖，然后运行登录脚本：\n\n```bash\nnpm install\nnpm run setup\n```\n\n运行后，终端中会渲染出一个登录二维码。请使用您的**个人微信**进行扫码。\n扫码成功并成功登录后，相关的状态和会话登录凭证（Credentials）将被加密保存在您本地的 `~/.wechat-antigravity` 目录中。\n\n---\n\n### 第二步：安装并启动服务\n\n我们提供了三种启动和接管方式：\n\n#### 方式 A：通过 Antigravity IDE 插件自动管理 (强烈推荐)\n\n通过安装本地 IDE 插件，您可以直接在 IDE 侧边栏中可视化地开启/关闭微信桥接，并享受完全自动化的后台消息接收与智能体唤醒。\n\n1. **安装插件**：\n   * **方法一：通过 VSIX 离线包安装 (强烈推荐，最简单)**：\n     * 前往 GitHub Releases 页面下载最新的 `wechat-antigravity-bridge-2.2.0.vsix` 文件。\n     * 打开 Antigravity IDE，按 `Ctrl + Shift + P` 唤起命令面板，选择 **`Extensions: Install from VSIX...`** 并导入下载好的 vsix 文件；或者在终端中运行：\n       ```bash\n       antigravity --install-extension wechat-antigravity-bridge-2.2.0.vsix\n       ```\n   * **方法二：本地源码手动安装 (适合开发调试的用户)**：\n     * 在根目录编译插件代码：\n       ```bash\n       npm run build\n       ```\n     * 将整个项目文件夹复制或建立软链接到以下路径：\n       * **Windows**: `C:\\Users\\\u003c您的用户名\u003e\\.antigravity-ide\\extensions\\bestxby.wechat-antigravity-bridge-2.2.0`\n       * **macOS / Linux**: `~/.antigravity-ide/extensions/bestxby.wechat-antigravity-bridge-2.2.0`\n     * 重启 Antigravity IDE，插件即会自动激活。\n3. **可视化配置与运行**：\n   * 启动 Antigravity IDE 后，点击左侧活动栏 (Activity Bar) 中的 **WeChat Agent** 微信小图标。\n   * 如果先前已登录，侧边栏会显示您的状态以及后台消息监听器守护进程（Daemon）状态。如果未登录，可直接在侧边栏中进行扫码绑定。\n   * 控制台界面采用全新自适应（Responsive）单页布局设计，支持自动缩放，无需任何滚动。\n   * 点击 **开启** 按钮开启守护进程，此时状态灯将变为绿色（Running）。\n   * 当您在微信端给智能体发送指令时，插件会全自动捕获消息并唤醒 IDE 侧边栏的 Antigravity 智能体面板开始处理，处理完成后自动回传，无需手动执行任何命令！\n\n#### 方式 B：纯终端命令行启动\n\n您可以在需要被智能体接管的任意工作区目录下，直接执行以下命令开启监听：\n\n```bash\n# 请确保此时的环境是在目标代码仓库下，且传入本项目所在的绝对路径运行\nnode /path/to/wechat-with-antigravity/dist/agent-loop/wait-message.js\n```\n---\n\n## 🔄 动态多工作区路由 (Active Workspace Routing)\n\n当您在 IDE 中同时打开多个项目（工作区）时，它们会通过底层的路由机制进行消息分发与切换：\n* **核心机制**：系统在 `~/.wechat-antigravity/workspaces.json` 中记录当前所有打开的 IDE 工作区，并在 `active_workspace.txt` 中记录当前被激活的消息接收工作区。\n* **焦点感知**：当您的鼠标点击或切换到某个 IDE 窗口时，插件会自动将当前激活的窗口路径写入到 `active_workspace.txt`。\n* **可视化看板**：WeChat 侧边栏控制台内置了“🖥️ 活跃工作区”看板，实时渲染出所有打开的代码仓，并为当前接收消息的活跃窗口打上绿色的 “接收中 / RECEIVING” 呼吸徽章。\n* **手动点击切换**：除了聚焦自动切换，您还可以直接在侧边栏的列表中点击任意一个工作区，立刻手动将消息接收大脑路由转移到对应的窗口。\n* **消息路由**：微信消息监听器收到新指令后，会优先读取该活跃窗口配置，并自动在其对应的工作区路径中写入任务并唤醒智能体。\n\n---\n\n## 🔒 远程微信二次确认流程 (Remote Confirmation Loop)\n\n为了在远程托管（例如电脑放在家，您出门在外用手机控制）时保证本地系统的安全性，项目内置了**微信端双向确认机制**：\n\n1. **触发安全操作**：当智能体需要执行特权或高风险操作（例如读写敏感文件、发起网络请求、打开浏览器等）时，本地程序会启动 `wait-approval.js`。\n2. **推送确认请求**：智能体会将本次操作的详细内容（例如“准备打开 Gemini 网页”）推送至您的微信。\n3. **挂起等待**：本地进程进入挂起阻塞状态，并在微信维持“对方正在输入中”状态，等待您的指令。\n4. **微信答复**：\n   * 回复 **`y`** 或 **`yes`**：本地收到确认许可，继续执行高风险操作。\n   * 回复 **`n`** 或 **`no`**：本地拒绝授权，中断并安全退出当前特权操作。\n\n通过这种“微信即时授权锁”，您能够绝对掌控智能体在您电脑上的行为。\n\n---\n\n## ⚙️ 进阶：如何配置无弹窗完全后台运行 (Bypass Screen Dialogs)\n\n默认情况下，IDE 的沙箱安全策略会对所有敏感动作（如读写文件、启动浏览器等）在**电脑屏幕上弹出确认框**。如果您不在电脑旁，这些弹窗会导致流程卡死。\n\n为了实现真正的 **100% 离线远程托管**，您可以为该项目配置白名单免密权限：\n\n### 配置步骤：\n\n1. 寻找或创建您 IDE 的项目授权配置文件：\n   * **Windows 路径**: `C:\\Users\\\u003c您的用户名\u003e\\.gemini\\config\\projects\\wechat-with-antigravity.json`\n   * **macOS/Linux 路径**: `~/.gemini/config/projects/wechat-with-antigravity.json`\n2. 将以下 JSON 写入该文件中：\n   ```json\n   {\n     \"fileAccessPolicy\": \"AGENT_SETTING_POLICY_ALLOW\",\n     \"internetPolicy\": \"AGENT_SETTING_POLICY_ALLOW\"\n   }\n   ```\n3. **效果说明**：\n   配置完成后，IDE 将直接信任该项目目录。当智能体通过浏览器子 Agent（Browser Subagent）在后台执行网页 analysis 或操作（如自动登录、获取网页 DOM、截图）时，**将不再有任何屏幕确认弹窗拦截**，配合微信二次确认，即可完美实现全后台静默托管运行。\n\n---\n\n## 🌙 防休眠挂机 (Awake Mode)\n\n为了实现 24 小时全天候的消息响应，底层集成了一个调用 Windows API 的原生防休眠脚本。只要您在终端中运行以下命令，您的电脑屏幕可以息屏，但系统绝不会进入深度休眠切断网络。\n```bash\nnpm run awake\n```\n您也可以通过微信直接发送 **`/awake`** 控制该模式的启闭。\n\n---\n\n## 🧹 记忆重置大法 (/reset)\n\n随着长周期的对话，大模型的记忆上下文会越堆越多。当您希望智能体立刻跳出当前的开发思维，重开一张白纸去做一个全新的任务时，只需在微信中发送指令：\n👉 **“/reset”** 或 **“忘掉之前的任务，重新开始一个全新的任务”**\n\n收到指令后，智能体会主动拦截并清空当前的任务流，让大脑重归零点状态！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbestxby%2Fwechat-with-antigravity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbestxby%2Fwechat-with-antigravity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbestxby%2Fwechat-with-antigravity/lists"}