内容
<div align="center">
# Lociant
### Android本地AI运行时和手机能力层，用于智能代理。
[](LICENSE)
[](apps/android)
[](docs/openai-compatible.md)
[](docs/agent-integration.md)
</div>
---
## 中文
Lociant 把 Android 手机变成一个可被智能代理通过局域网调用的本地 AI 节点。
它不是完整的智能代理框架，也不替代 Codex、Hermes、OpenCode、RikkaHub、Pi 或你自己的自动化系统。Lociant 位于它们下层：提供手机本地模型、摄像头视觉、Android 状态、屏幕工具、通知、存储，以及标准化 API。
## 能力
- 通过 OpenAI-compatible API 和 Ollama 风格接口运行本地 LLM/VLM。
- 提供 MCP Streamable HTTP server，智能代理可以直接接入。
- Android 本地工具：设备状态、剪贴板、打开 App、屏幕上下文（`ui_screen_state`，含无障碍层级和可选截图）、节点点击、点击、滑动、返回、主页、最近任务、通知栏、快捷设置、UI 空闲等待。
- 摄像头视觉：启动视觉 runtime、捕获画面、把图片传给本地 VLM。
- 本地会话和存储，用于保存手机侧上下文。
- 可见 Android runtime：前台服务、悬浮运行窗口、权限管理、WebView 设置页。
## 快速开始
1. 安装 Android App。
2. 在 App 里启动 Runtime。
3. 确认手机显示局域网地址，例如：
```text
http://10.238.125.4:11434
```
4. 在支持 MCP 的智能代理客户端里添加：
```text
名称：Lociant
传输：Streamable HTTP
URL：http://<phone-ip>:11434/mcp
Headers：留空
```
如果启用了 API Token，添加：
```text
Authorization: Bearer <token>
```
5. 在当前对话里启用 MCP tools，然后测试：
```text
调用 runtime_status。
调用 device_status。
用 ui_screen_state 获取当前屏幕状态。
启动 vision，再调用 camera_capture。
```
## OpenAI-Compatible API
把手机作为本地模型服务：
```text
Base URL: http://<phone-ip>:11434/v1
Model: 从 GET /v1/models 里选择
API Key: 留空，或按客户端要求填任意非空值
```
## 构建
```powershell
cd apps/android
.\gradlew.bat :app:assembleDebug
```
输出 APK：
```text
apps/android/app/build/outputs/apk/debug/app-debug.apk
```
## 边界
Lociant 只负责手机侧能力。桌面智能代理仍然应该负责规划、工作区文件、Shell、代码编辑和长期任务状态。
## 文档
- [统一架构](docs/unified-architecture.md)
- [OpenAI-Compatible API](docs/openai-compatible.md)
- [智能代理集成](docs/agent-integration.md)
---
