MiclawApiBridge

把小米超级小爱 (com.aios.osbot) 的 AI 能力暴露为本机 OpenAI 兼容 HTTP API 的 Xposed 模块(LibXposed API 102)。

v2.1: 模块主动请求 root 授权 + 免重启即时生效。服务启动自动触发 su 授权弹窗;设置页「立即授权 Root」按钮 / GET /v1/admin/root 可在不重启的情况下重新请求授权。

需 root (Magisk/KernelSU),授权 com.aios.osbot 后即时生效。

✨ 功能

  • OpenAI 兼容: POST /v1/chat/completions(流式 SSE + 非流式)、/v1/completions/v1/chat
  • 多模态识图: 图片 URL / base64 / 本地路径
  • 多轮会话: user/chat_id 控制上下文,/v1/chat/reset 重置
  • JSON 模式 + temperature/max_tokens 映射
  • 代码执行: POST /v1/exec(root,shell/python,强制 Token)
  • 管理: /v1/admin/status(含 root 状态)/ /v1/admin/logs / /v1/admin/reload
  • 设置界面: 端口 / Token / LLM 代理 / 路由表 / 限流 / Root 状态显示
  • 稳健性: 限流 / 失败自动重试 / 端口自动避让 / 双保险启动 / 固定签名

⚠️ 首次使用必做(注入不生效的 90% 原因)

  1. LSPosed 启用模块 + 作用域勾选 com.aios.osbot
  2. 给 root 权限:KernelSU/Magisk → 超级用户 → 允许 com.aios.osbot(不是只装模块就行!)
  3. 必须重启超级小爱:强制停止 → 重新打开(或重启手机)
    • 权限刚授予时模块可能不会立刻注入,重启后才会生效
    • 判断标准:打开模块设置页,看到「● 服务运行中」+「🔑 Root: 可用」

已验证:注入不了 = 权限没走通 或 权限作用了但没重启。与模块代码无关。

🔑 Root 要求

  • 设备已 root(Magisk / KernelSU)
  • Magisk/KernelSU 授权列表 允许 com.aios.osbot 使用 su(首次弹窗选允许)
  • 无 root 时模块仍可提供对话 API,仅 /v1/exec 代码执行受限

📱 使用

  1. 安装 APK(若装过旧版请先卸载,签名已变更)
  2. LSPosed 启用模块,作用域勾选 com.aios.osbot
  3. 打开模块图标:确认服务运行 + Root 状态
  4. 重启超级小爱

🔌 接入

Base URL: http://127.0.0.1:8787/v1
API Key:  模块设置里的 Token(可留空)
Model:    osbot.main

Releases

2.1

Stable

8/12/2026, 8:15:17 AM

v2.1: 模块主动请求root授权 + 免重启即时生效 - 服务启动自动触发su授权弹窗, UI按钮立即授权(不重启), /v1/admin/root端点重新请求授权

Assets

1

2.0

Stable

8/12/2026, 7:29:38 AM

v2.0 (root版): 干净2.0 + root权限支持 - RootUtil su检测/执行, /health与/v1/admin/status显示root状态, UI显示root授权提示, exec无root降级。需 root (Magisk/KernelSU), 请在授权列表允许 com.aios.osbot

Assets

1

1.4.0

Stable

8/12/2026, 2:16:00 AM

v1.4.0: 默认全部走超级小爱(本地), LLM代理默认关闭

Assets

1

1.1.0

Stable

8/11/2026, 6:22:28 PM

v1.1.0: OpenAI 标准 API (openapi.json, CORS, 标准错误, SSE 流式, 去重)

Assets

1

2.0

Stable

8/12/2026, 6:35:56 AM

v2.0: 恢复真实服务启动 (HookEntry 双保险) + 全新设置 UI + 限流 / 请求日志 / 会话重置 / 配置热重载 / 失败自动重试

Assets

1

1.0.0

Stable

8/11/2026, 5:56:15 PM

初版:把超级小爱AI暴露为本机OpenAI兼容API (LibXposed API 102)

Assets

1