Metadata-Version: 2.4
Name: ganiu-bridge
Version: 1.0.0
Summary: 嘎妞连接桥 — 让手机上的嘎妞 App 通过 HTTP API 遥控这台电脑（自动注册到嘎妞后端）
Author: Ganiu
License: Proprietary
Keywords: ganiu,bridge,remote-control,assistant
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: Chinese (Simplified)
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: screenshot
Requires-Dist: Pillow>=9.0; extra == "screenshot"

# 嘎妞连接桥（ganiu-bridge）

让手机上的**嘎妞 App** 通过局域网/公网 HTTP API 遥控这台电脑：执行命令、读写文件、查看系统信息、截图（可选装 Pillow）。

## 安装

```bash
pip install ganiu-bridge
```

## 使用

```bash
# 从嘎妞 App「设置 → 设备管理」获取设备配对码
ganiu-bridge --token 你的配对码
```

启动后自动注册到嘎妞后端，手机端即可看到这台电脑。

- 默认端口 `18791`，可用 `--port` 修改
- **零第三方依赖**（纯 Python 标准库），Python 3.9+ 即可
- 截图功能（可选）：`pip install "ganiu-bridge[screenshot]"`
- 安全：未配置 token 时仅允许本机回环访问；配置 token 后远程请求需携带 `Authorization: Bearer <token>`

## 环境变量

| 变量 | 说明 |
|---|---|
| `GANIU_BACKEND_URL` | 嘎妞后端地址，默认官方后端 |
