ScreenBridgeAI(原名“图传AI”)是一个 Windows 截图与跨设备 AI 助手:在电脑上截取屏幕或读取剪贴板图片,在同一局域网的手机浏览器查看图片,并通过自己配置的视觉模型进行问答。当前桌面与手机界面为中文。
- 电脑快捷键截图、读取剪贴板图片,或手动导入图片。
- 手机扫码连接,查看图库、裁剪图片、发起 AI 问答和追问。
- 流式显示回答,支持后台生成、连接恢复和图片自动分析队列。
- 使用兼容 Chat Completions 的视觉模型接口;API Key 由使用者自己配置。
- 图片和对话默认保存在电脑本地;首次配置与数据保存位置可在电脑端查看。
- Windows 10/11、Python 3.13 和 Microsoft Edge WebView2 Runtime。
- 手机与电脑需要处于可以互相访问的网络环境。
- 需要自行配置支持图片输入的 AI 服务、模型名称和 API Key。使用在线服务时,提交的图片与问题会发送到所配置的服务商,并可能产生费用。
在 PowerShell 中运行:
git clone https://github.com/bearyluo/ScreenBridgeAI.git
cd ScreenBridgeAI
py -3.13 -m pip install -r .\源码\requirements.txt
py -3.13 .\源码\app.py打开电脑界面后配置视觉模型,用手机扫描界面上的二维码。默认快捷键为 Ctrl+Alt+P 截屏、Ctrl+Alt+V 读取剪贴板图片,可在设置中调整。
源码测试使用 unittest:
py -3.13 -m unittest discover -s .\源码\tests -p "test_*.py"
py -3.13 -m unittest discover -s .\安装包\tests -p "test_*.py"浏览器测试需要额外安装 playwright 和本机 Microsoft Edge;缺少相关依赖时会跳过。安装器测试会在临时目录创建测试文件及目录链接,应在测试环境中运行。
如需自行构建 Windows 安装包,额外安装 PyInstaller==6.22.3,然后运行:
py -3.13 -m pip install PyInstaller==6.22.3
cd .\构建
py -3.13 build_release.py
py -3.13 verify_release.py构建结果位于 构建/发布/。本仓库仅包含源码与构建脚本,没有预编译安装包。
手机连接使用局域网 HTTP。请在可信网络中使用,并妥善保管配对链接。应用不会因为运行在局域网而自动加密网络传输。
仓库不包含用户的截图、对话记录、配置、API Key 或日志。请勿将这些文件提交到 GitHub。
本项目暂未指定开源许可证。