🚀 反重力移动指挥
将您的移动设备转换为编码环境的远程任务控制。
反重力移动指挥是一个“代理桥”，它利用谷歌反重力的原生模型上下文协议（MCP）和人工制品系统，通过电报提供双向实时反馈回路。
✨ 特性
- 📱 快速行动循环：从手机发送编码任务，使用内联按钮批准计划
- 📸 视觉验证：自动接收UI更改的屏幕截图和录制
- ✅ 互动治理：通过Telegram按钮批准或拒绝代码差异
- 🚨 错误意识：通过全栈跟踪获得终端崩溃通知
- 📊 实时状态票务：实时进度更新，无垃圾邮件
🛠️ 快速开始
先决条件
安装
# Clone the repository
git clone https://github.com/yourusername/antigravity-telegram.git
cd antigravity-telegram
# Install dependencies
pip install -e .
# Or with uv
uv pip install -e .配置
- 复制示例环境文件：
cp .env.example .env- 编辑
.env使用您的凭据：
TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
AUTHORIZED_CHAT_IDS=your_chat_id
ARTIFACTS_PATH=~/.gemini/antigravity/artifacts跑步
运行Telegram bot和MCP服务器：
python -m src.main只运行Telegram机器人：
python -m src.main --mode bot仅运行MCP服务器（用于反重力集成）：
python -m src.main --mode mcp🔌 反重力MCP集成
1.添加到MCP配置
将Telegram网桥添加到您的反重力MCP配置中(~/.gemini/mcp_config.json):
{
"mcpServers": {
"telegram-bridge": {
"command": "python",
"args": ["-m", "src.main", "--mode", "mcp"],
"cwd": "/path/to/antigravity-telegram",
"env": {
"TELEGRAM_BOT_TOKEN": "your_token",
"AUTHORIZED_CHAT_IDS": "your_chat_id",
"ARTIFACTS_PATH": "~/.gemini/antigravity/artifacts"
}
}
}
}2.复制工作流
将工作流文件复制到Antigravity工作流：
cp workflows/mobile-command.md ~/.agent/workflows/3.使用Telegram
- 在Telegram上与您的机器人开始聊天
- 发送
/start验证连接 - 发送
/prompt "Your coding task here" - 通过手机批准计划并查看更改！
📱 电报命令
| 命令 | 描述 |
|---|---|
/start | 显示欢迎消息并验证连接 |
/prompt | 向Antigravity发送编码任务 |
/status | 检查当前执行状态 |
/cancel | 取消当前操作 |
/help | 显示帮助消息 |
🔧 MCP工具可用
以下工具暴露在反重力环境中进行通信：
| 工具 | 说明 |
|---|---|
send_telegram_message | 向用户发送消息 |
request_plan_approval | 请求批准实施计划 |
request_change_approval | 请求批准代码更改 |
send_artifact | 将截图/录音发送到Telegram |
update_status | 更新状态收报机消息 |
notify_error | 发送严重错误通知 |
await_user_response | 等待用户输入 |
🏗️ 建筑
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ 📱 Telegram │◄───►│ 🌉 Python │◄───►│ 🌌 Antigravity │
│ App │ │ Bridge │ │ Agent │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌──────────────────┐
│ 📁 Artifact │
│ Watcher │
└──────────────────┘📁 项目结构
antigravity-telegram/
├── src/
│ ├── main.py # Entry point
│ ├── config.py # Configuration management
│ ├── bot/
│ │ ├── handlers.py # Telegram command handlers
│ │ ├── keyboards.py # Inline keyboard builders
│ │ └── message_queue.py # Async message queue
│ ├── mcp_server/
│ │ ├── server.py # MCP server implementation
│ │ ├── tools.py # MCP tool definitions
│ │ └── state.py # Approval state management
│ ├── monitors/
│ │ ├── artifacts.py # Artifact directory watcher
│ │ └── terminal.py # Terminal output monitor
│ └── utils/
│ └── formatting.py # Message formatting
├── config/
│ └── mcp_config.json # MCP config template
├── workflows/
│ └── mobile-command.md # Antigravity workflow
├── .env.example
├── pyproject.toml
└── README.md🔒 安全
- 只有授权的聊天ID才能与机器人进行交互
- Bot令牌存储在环境变量中
- 会话文件被忽略
📝 许可证
MIT许可证-请参阅 许可证 了解详情。
🤝 贡献
欢迎投稿！请随时提交拉取请求。
______________________________________________________________________
建于❤️ 反重力社区