📱 phone-access-gateway

手机扫码访问门户 —— 把电脑上的本地服务（Reasonix Web UI、study-coach-server、Jupyter…）通过二维码发布到手机。

手机扫码 → 打开电脑上的同一个界面，实时同步。局域网免密直连，可选访问密码。

核心功能

• 📶 局域网二维码：自动检测电脑局域网 IP，生成手机可扫的二维码
• 🔒 访问密码：可选开启（扫码后输入密码进入），默认关闭直连
• 🤖 适配 Reasonix：一键启动 reasonix web + 生成扫码页
• 🔌 适配任意服务：已运行的本地服务都能挂到扫码页

快速开始

# 安装依赖
pip install -r requirements.txt

# ① 适配 Reasonix（自动启动 reasonix web + 扫码页）
python gateway.py reasonix --port 3081

# ② 适配任意已运行的服务（如 study-coach-server :8000）
python gateway.py serve --target http://127.0.0.1:8000 --name "study-coach-server"

# ③ 开启访问密码
python gateway.py reasonix --password mypass

# ④ 指定局域网 IP（多网卡时）
python gateway.py reasonix --lan-ip 192.168.15.58

启动后：

📱 手机扫码页: http://192.168.15.58:3081   ← 手机连同一 WiFi 打开这个
   或本机访问: http://127.0.0.1:3081        ← 电脑浏览器看二维码

手机使用流程

1. 手机连接与电脑同一 WiFi
2. 用微信/相机扫码（或手动输入地址）
3. 打开的就是电脑上的那个界面，实时同步

与 Reasonix 集成

python gateway.py reasonix 内部执行：

reasonix-cli.exe web -addr 0.0.0.0:8787 -no-open   # Reasonix Web UI 局域网监听
+ gateway.py 生成扫码页 (端口 3081)                  # 手机扫码 → 8787

Reasonix Web UI 完整支持手机端操作（对话/工具调用/任务监控）。

命令行参数

参数	说明
reasonix	一键适配 Reasonix（自动启动 web + 扫码页）
serve --target URL	适配任意本地服务
--port N	扫码页端口（默认 3081）
--lan-ip IP	手动指定局域网 IP
--password PW	开启访问密码
--rx-port N	Reasonix Web UI 端口（默认 8787）
--model NAME	Reasonix 模型名（可选）

技术要点

• 纯标准库 HTTP 服务：http.server.ThreadingHTTPServer，零框架依赖
• qrcode 库生成二维码：内嵌为 HTML data URI，无需额外文件
• 自动 LAN IP 检测：UDP 连接法（连接 8.8.8.8 拿本机地址）
• 密码校验：极简 token 校验（适合局域网信任环境）

简历亮点

• 局域网/公网工具开发：二维码分享 + 密码认证的完整实现
• Agent 工具链集成：把 Reasonix Web UI 变成手机可访问
• 实用主义工程：标准库实现，零重型依赖，即插即用

许可证

MIT © 2026 wpc725562-dotcom