灵光AI手机端离线运行部署教程【便携神器】

想在地铁断网时继续用AI读发片、查药品说明书、解孩子作业题，又怕上传图片泄露隐私？灵光AI手机端离线运行能彻底解决这个问题——所有图像识别、文字提取、逻辑推理全部发生在你手机内部，摄像头拍完直接分析，不发一包数据到云端。

确认设备兼容性与基础环境

首先，打开手机“设置→关于手机→版本信息”，连续点击7次“版本号”开启开发者选项；然后回到“系统设置→开发者选项”，把“USB调试”和“允许模拟位置”都打开。注意：USB调试必须开启，否则后续ADB命令无法执行。

系统方面，安卓版本需要Android 10及以上，芯片要支持ARM64-v8a指令集——骁龙845、麒麟980、天玑810及以上的处理器都能满足。iOS目前还不支持离线视觉模型部署，所以这个教程只能用于安卓设备。

接下来安装Termux应用（从Google Play或F-Droid下载），启动后运行：pkg update && pkg upgrade && pkg install python wget clang openssl-tool。这一步大概花两分钟，如果网络不太稳定，可以提前把依赖包缓存好。

下载并验证离线模型包

这里提供两种方法，新手建议直接用第一种。

在Termux中逐行执行：

wget https://github.com/antgroup/lingguang-offline/releases/download/v2.3.1/lingguang-vision-quantized.tgz
tar -xzf lingguang-vision-quantized.tgz
sha256sum lingguang-vision/model.bin

核对输出的校验值是否等于官网发布的

，不一致就立即删除重下，避免加载损坏的模型导致崩溃。

（适合有HF Token的用户）
先配置Token：export HF_TOKEN="your_token_here"，再运行：pip install huggingface-hub && huggingface-cli download antgroup/lingguang-vision --revision quant-int8 --local-dir ./lingguang-vision

启动离线服务并绑定APP

首先进入模型目录：cd lingguang-vision

然后赋予执行权限并启动服务：chmod +x run.sh && ./run.sh --port 8080 --device cpu。如果你的手机是骁龙8+或天玑9200以上芯片，可以把--device cpu换成--device gpu，速度能提升40%以上。

保持Termux在后台运行，打开手机浏览器访问 http://127.0.0.1:8080/health，如果看到返回 {"status":"ok","model":"lingguang-vision-v2.3"}，就说明服务已经就绪。

最后一步：打开已安装的灵光AI App，进入“设置→高级→本地引擎地址”，填入http://127.0.0.1:8080，保存后重启App。此时相机图标右上角会出现一个灰色的小盾牌标识，代表已经切换到了纯离线模式。所有图像识别、文字提取和逻辑推理都在本地完成，隐私和安全都有保障。