ganiu-bridge 1.0.0__tar.gz

ganiu_bridge-1.0.0/PKG-INFO

@@ -0,0 +1,52 @@
+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` | 嘎妞后端地址，默认官方后端 |

ganiu_bridge-1.0.0/PYPI_README.md

@@ -0,0 +1,29 @@
+# 嘎妞连接桥（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` | 嘎妞后端地址，默认官方后端 |

ganiu_bridge-1.0.0/ganiu_bridge/__init__.py

@@ -0,0 +1,8 @@
+"""
+嘎妞连接桥 — 让手机上的嘎妞 App 通过 HTTP API 遥控这台电脑
+
+pip install ganiu-bridge && ganiu-bridge --token <配对码>
+"""
+from .core import VERSION, DEFAULT_PORT  # noqa: F401
+
+__version__ = VERSION

ganiu_bridge-1.0.0/ganiu_bridge/core.py

@@ -0,0 +1,123 @@
+"""
+嘎妞桥接控制端 — 共享核心
+HTTP API 服务，接受手机端嘎妞的远程控制指令
+"""
+import json, subprocess, os, sys, platform, shutil
+from http.server import HTTPServer, BaseHTTPRequestHandler
+from pathlib import Path
+
+VERSION = "1.0.0"
+DEFAULT_PORT = 18791
+
+
+def get_system_info():
+    """获取系统信息"""
+    info = {
+        "hostname": platform.node(),
+        "os": platform.system(),
+        "os_version": platform.version(),
+        "arch": platform.machine(),
+        "python": sys.version,
+        "cpu_count": os.cpu_count(),
+        "cwd": os.getcwd(),
+    }
+    # 磁盘信息
+    if platform.system() == "Windows":
+        import ctypes
+        free = ctypes.c_ulonglong(0)
+        total = ctypes.c_ulonglong(0)
+        ctypes.windll.kernel32.GetDiskFreeSpaceExW(ctypes.c_wchar_p("C:\\"), ctypes.byref(free), ctypes.byref(total), None)
+        info["disk_total"] = total.value
+        info["disk_free"] = free.value
+    else:
+        stat = os.statvfs("/")
+        info["disk_total"] = stat.f_frsize * stat.f_blocks
+        info["disk_free"] = stat.f_frsize * stat.f_bavail
+    return info
+
+
+def run_command(cmd: str, timeout: int = 30, workdir: str = None):
+    """执行系统命令"""
+    try:
+        shell = platform.system() == "Windows"
+        result = subprocess.run(
+            cmd if shell else ["bash", "-c", cmd],
+            capture_output=True, text=True,
+            timeout=timeout,
+            cwd=workdir or os.getcwd(),
+            shell=shell,
+        )
+        return {
+            "exit_code": result.returncode,
+            "stdout": result.stdout[-50000:],
+            "stderr": result.stderr[-10000:],
+        }
+    except subprocess.TimeoutExpired:
+        return {"exit_code": -1, "stdout": "", "stderr": f"命令超时({timeout}s)"}
+    except Exception as e:
+        return {"exit_code": -1, "stdout": "", "stderr": str(e)}
+
+
+def read_file(path: str):
+    """读取文件"""
+    try:
+        p = Path(path)
+        if not p.exists():
+            return {"error": "文件不存在"}
+        if p.stat().st_size > 10 * 1024 * 1024:
+            return {"error": "文件超过10MB"}
+        return {"content": p.read_text(encoding="utf-8", errors="replace"), "size": p.stat().st_size}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def write_file(path: str, content: str):
+    """写入文件"""
+    try:
+        p = Path(path)
+        p.parent.mkdir(parents=True, exist_ok=True)
+        p.write_text(content, encoding="utf-8")
+        return {"ok": True, "path": str(p)}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def list_files(path: str):
+    """列出目录"""
+    try:
+        p = Path(path)
+        if not p.exists():
+            return {"error": "路径不存在"}
+        items = []
+        for f in sorted(p.iterdir(), key=lambda x: (not x.is_dir(), x.name.lower())):
+            items.append({
+                "name": f.name,
+                "is_dir": f.is_dir(),
+                "size": f.stat().st_size if f.is_file() else 0,
+            })
+        return {"path": str(p), "items": items[:200]}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def take_screenshot():
+    """截图 (需要PIL)"""
+    try:
+        from PIL import ImageGrab
+        import io, base64
+        img = ImageGrab.grab()
+        buf = io.BytesIO()
+        img.save(buf, format="JPEG", quality=60)
+        return {"image_base64": base64.b64encode(buf.getvalue()).decode()}
+    except Exception as e:
+        return {"error": f"截图失败: {e}. 请安装: pip install Pillow"}
+
+
+def which(program):
+    """查找可执行文件"""
+    if platform.system() == "Windows":
+        for ext in os.environ.get("PATHEXT", "").split(os.pathsep):
+            exe = program + ext
+            if shutil.which(exe):
+                return exe
+    return shutil.which(program)

ganiu_bridge-1.0.0/ganiu_bridge/server.py

@@ -0,0 +1,131 @@
+"""
+嘎妞桥接控制端 — HTTP API 服务器（含自动注册）
+"""
+import json, sys, os, socket, platform as pf, time, hmac
+from http.server import HTTPServer, BaseHTTPRequestHandler
+from urllib.parse import urlparse
+from urllib.request import Request, urlopen
+
+from .core import *  # noqa: F401,F403
+from .core import DEFAULT_PORT, VERSION, get_system_info, list_files, run_command, take_screenshot, write_file, read_file
+
+TOKEN = ""
+PORT = DEFAULT_PORT
+BACKEND = os.environ.get("GANIU_BACKEND_URL", "http://115.190.134.232:8000")  # 嘎妞后端  # 可用环境变量覆盖，迁移改端点不改代码
+DEVICE_NAME = socket.gethostname()
+DEVICE_OS = pf.system()
+DEVICE_IP = socket.gethostbyname(DEVICE_NAME)
+_registered = False
+
+
+def register_device():
+    """自动注册到嘎妞后端"""
+    global _registered
+    if not TOKEN:
+        print("  ⚠ 未配置TOKEN，跳过注册。在手机设置中获取设备配对码。")
+        return False
+    try:
+        data = json.dumps({"name": DEVICE_NAME, "os": DEVICE_OS, "ip": DEVICE_IP}).encode()
+        req = Request(f"{BACKEND}/api/v1/devices/register", data=data,
+                      headers={"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"})
+        resp = urlopen(req, timeout=10)
+        result = json.loads(resp.read())
+        if result.get("ok"):
+            print(f"  ✅ 已注册到嘎妞后端: {DEVICE_NAME} ({DEVICE_IP})")
+            _registered = True
+            return True
+        else:
+            print(f"  ❌ 注册失败: {result}")
+    except Exception as e:
+        print(f"  ❌ 注册失败: {e}")
+    return False
+
+
+class BridgeHandler(BaseHTTPRequestHandler):
+    def log_message(self, format, *args):
+        pass
+
+    def _check_auth(self):
+        if not TOKEN:
+            # 安全修复 2026-11-04：空 TOKEN 时仅允许本机回环访问，防止远程无鉴权执行命令/读写文件
+            client = self.client_address[0]
+            return client in ("127.0.0.1", "::1", "localhost")
+        auth = self.headers.get("Authorization", "")
+        return hmac.compare_digest(auth, f"Bearer {TOKEN}")
+
+    def _send(self, data, status=200):
+        self.send_response(status)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+        self.wfile.write(json.dumps(data, ensure_ascii=False).encode())
+
+    def do_OPTIONS(self):
+        self.send_response(204)
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.send_header("Access-Control-Allow-Methods", "GET,POST,OPTIONS")
+        self.send_header("Access-Control-Allow-Headers", "Authorization,Content-Type")
+        self.end_headers()
+
+    def do_GET(self):
+        if not self._check_auth():
+            return self._send({"error": "未授权"}, 401)
+        path = urlparse(self.path).path
+        if path == "/":
+            return self._send({"name": DEVICE_NAME, "version": VERSION, "os": DEVICE_OS, "registered": _registered})
+        if path == "/info":
+            return self._send(get_system_info())
+        if path == "/files":
+            qs = urlparse(self.path).query
+            params = dict(p.split("=") for p in qs.split("&") if "=" in p)
+            return self._send(list_files(params.get("path", os.getcwd())))
+        if path == "/screenshot":
+            return self._send(take_screenshot())
+        self._send({"error": "未知路径"}, 404)
+
+    def do_POST(self):
+        if not self._check_auth():
+            return self._send({"error": "未授权"}, 401)
+        path = urlparse(self.path).path
+        length = int(self.headers.get("Content-Length", 0))
+        body = json.loads(self.rfile.read(length).decode()) if length > 0 else {}
+        if path == "/cmd":
+            return self._send(run_command(body.get("cmd", ""), timeout=body.get("timeout", 30), workdir=body.get("workdir")))
+        if path == "/read":
+            return self._send(read_file(body.get("path", "")))
+        if path == "/write":
+            return self._send(write_file(body.get("path", ""), body.get("content", "")))
+        self._send({"error": "未知路径"}, 404)
+
+
+def start_server(port=None, token=None):
+    global TOKEN, PORT
+    if port: PORT = port
+    if token: TOKEN = token
+    server = HTTPServer(("0.0.0.0", PORT), BridgeHandler)
+    print(f"\n  嘎妞桥接控制端 v{VERSION}")
+    print(f"  系统: {DEVICE_OS} | 主机: {DEVICE_NAME} | 端口: {PORT}")
+    # 自动注册
+    register_device()
+    if not TOKEN:
+        print("  ⚠ 安全提醒: 未配置TOKEN，远程访问将被拒绝（仅本机127.0.0.1可用）")
+    print(f"  正在监听...\n")
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\n  已停止")
+        server.shutdown()
+
+
+def main():
+    import argparse
+    parser = argparse.ArgumentParser(description="嘎妞连接桥 — 接受手机嘎妞 App 的远程控制指令")
+    parser.add_argument("--port", type=int, default=DEFAULT_PORT)
+    parser.add_argument("--token", type=str, default="", help="设备配对码(从嘎妞App设置获取)")
+    parser.add_argument("--version", action="version", version=f"ganiu-bridge {VERSION}")
+    args = parser.parse_args()
+    start_server(port=args.port, token=args.token)
+
+
+if __name__ == "__main__":
+    main()

ganiu_bridge-1.0.0/ganiu_bridge.egg-info/PKG-INFO

@@ -0,0 +1,52 @@
+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` | 嘎妞后端地址，默认官方后端 |

ganiu_bridge-1.0.0/ganiu_bridge.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+PYPI_README.md
+pyproject.toml
+ganiu_bridge/__init__.py
+ganiu_bridge/core.py
+ganiu_bridge/server.py
+ganiu_bridge.egg-info/PKG-INFO
+ganiu_bridge.egg-info/SOURCES.txt
+ganiu_bridge.egg-info/dependency_links.txt
+ganiu_bridge.egg-info/entry_points.txt
+ganiu_bridge.egg-info/requires.txt
+ganiu_bridge.egg-info/top_level.txt

ganiu_bridge-1.0.0/ganiu_bridge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ganiu_bridge-1.0.0/ganiu_bridge.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ganiu-bridge = ganiu_bridge.server:main

ganiu_bridge-1.0.0/ganiu_bridge.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[screenshot]
+Pillow>=9.0

ganiu_bridge-1.0.0/ganiu_bridge.egg-info/top_level.txt

@@ -0,0 +1 @@
+ganiu_bridge

ganiu_bridge-1.0.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ganiu-bridge"
+version = "1.0.0"
+description = "嘎妞连接桥 — 让手机上的嘎妞 App 通过 HTTP API 遥控这台电脑（自动注册到嘎妞后端）"
+readme = "PYPI_README.md"
+requires-python = ">=3.9"
+license = { text = "Proprietary" }
+authors = [{ name = "Ganiu" }]
+keywords = ["ganiu", "bridge", "remote-control", "assistant"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: Chinese (Simplified)",
+]
+# 零第三方依赖：纯 Python 标准库（截图功能可选装 Pillow）
+dependencies = []
+
+[project.optional-dependencies]
+screenshot = ["Pillow>=9.0"]
+
+[project.scripts]
+ganiu-bridge = "ganiu_bridge.server:main"
+
+[tool.setuptools]
+packages = ["ganiu_bridge"]

ganiu_bridge-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+