XINCODE-Public
Health Gecti
- License — License: GPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 20 GitHub stars
Code Gecti
- Code scan — Scanned 5 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
纯 Kotlin 原生 Android AI 智能体:多模型接入、子智能体协作、在线插件市场、技能自动引用、root/Ubuntu 终端、长期记忆
XINCODE
纯 Kotlin 原生 Android AI 智能体。 一个运行在手机上的自主 AI Agent:多供应商接入、工具调用循环、子智能体并行协作、在线插件市场、技能场景自动引用、长期记忆、内置 root/Ubuntu 环境与终端,以及像素风「智能体指挥室」实时动画。从零构建,无跨端框架。
版本:1.14.1(versionCode 136) · 许可:GPL-3.0-or-later
✨ 主要能力
- 智能体核心 — OpenAI Chat Completions / Responses API / DeepSeek / Anthropic 等多供应商,自定义端点与模型清单;工具调用循环 + 结构化输出 + Prompt 缓存纪律。
- 运行链 — 长任务通知栏一键中断/审批批复(无回执不执行);多轮任务自动继承前文结论;运行流水落盘,杀进程可续跑、可分支重试;工具结果必回模型,失败明示不静默。
- 计划 / 协作模式 — 计划模式可视化任务卡;协作模式下主脑把任务并行派发给多个专职子智能体,汇总回主脑;内置四个专职角色,误删后升级自动找回。
- 指挥室 — 像素风「智能体指挥室」(WebView + HTML5 Canvas),每个子智能体一个工位与像素小人,派活即联动动画。
- 环境与终端 — root 终端;内置 Ubuntu 环境(root + chroot 自动部署),可直接执行命令;一键部署常用开发环境。
- 记忆 — 长期记忆(FTS 全文检索 + 向量语义检索,自动沉淀);普通对话之间记忆互通,项目内对话按项目隔离;精编两文件记忆(用户画像 / 近况)由后台复盘分身维护。
- 上下文与成本 — 输入框旁上下文圆环(绿→蓝→黄→红)、实时 token / 缓存命中、可配置压缩阈值、人民币成本显示(缓存感知)。
- 效率与自动化 — 多引擎联网搜索(必应 / 百度 / 搜狗 / DuckDuckGo 融合 + 正文抓取)、Goal/Work 多任务、定时任务(cron / WorkManager)、语音转写、视觉与深度推理委托副模型。
- 插件与技能 — 在线插件市场(27 个实测可用:气象/金融/知识/影音/工具/饮食/游戏/开发 8 分类,云端上架免发版,SSRF 出站守卫,Key 只进请求头);技能场景自动引用(命中附用法)+
/技能名主动调用;MCP 支持(stdio 本地传输 + HTTP),@服务器名优先使用其工具。 - 安全 — 权限模式(询问 / 完全访问)、敏感操作确认卡(通知栏可批)、审计日志;执行策略判定与权限求交已打底。
完整清单见 CHANGELOG.md。
🧱 工程结构
多模块 Gradle 工程(Kotlin DSL):
| 模块 | 职责 |
|---|---|
app |
Android 入口、Compose UI、智能体编排、指挥室 WebView |
core |
AgentCore、工具注册表、调度循环 |
provider |
各 LLM 供应商客户端(OpenAI 兼容 / Anthropic 等) |
data |
Room 持久化、记忆(FTS + 向量)、记忆抽取 |
security |
权限模式、敏感操作门控、审计 |
tools |
内置工具实现 |
service |
前台服务、后台任务、通知 |
ui |
共享 UI 组件与主题 |
- 语言:Kotlin · UI:Jetpack Compose · 存储:Room
minSdk 28·targetSdk 34·compileSdk 34
🔨 从源码构建
Debug 包(无需签名密钥)
git clone <this-repo-url>
cd XINCODE
./gradlew :app:assembleDebug
# 产物:app/build/outputs/apk/debug/app-debug.apk
需要 JDK 17 与 Android SDK(Platform 34)。若本机未装 SDK,在项目根新建 local.properties 指向 SDK 路径:sdk.dir=/path/to/Android/Sdk。
Release 签名包(在你自己的电脑上)
签名密钥是你的私有机密,永远不进仓库(keystore.properties、*.jks、*.keystore 均已在 .gitignore 中)。
- 复制模板:
cp keystore.properties.example keystore.properties - 若还没有密钥,生成一个:
keytool -genkeypair -v -keystore xincode-release.jks \ -alias xincode -keyalg RSA -keysize 2048 -validity 10000 - 把
keystore.properties里的四项填成你的真实值(storeFile/storePassword/keyAlias/keyPassword)。 - 打签名包:
./gradlew :app:assembleRelease # 产物:app/build/outputs/apk/release/app-release.apk
⚠️ 请离线备份
.jks与这些口令——一旦丢失,将无法再为同一应用发布更新。
若keystore.properties不存在,构建脚本会自动跳过签名配置(Debug 仍可正常构建)。
🔐 权限说明
| 权限 | 用途 |
|---|---|
INTERNET |
调用 LLM API、联网搜索、抓取正文 |
RECORD_AUDIO |
语音转写(仅在你主动使用语音输入时) |
POST_NOTIFICATIONS |
后台任务完成通知 |
FOREGROUND_SERVICE / FOREGROUND_SERVICE_DATA_SYNC |
后台推进长任务(Goal/Work、定时任务) |
应用不含广告与第三方追踪。API Key 等敏感配置仅保存在本机;android:allowBackup="false" 已关闭系统自动备份。
⚙️ 使用前配置
首次启动后,进入设置填写你自己的 LLM 供应商信息(端点 + API Key + 模型)。需要 OpenAI Responses API 时选择「OpenAI Responses」路径;它会调用 /v1/responses,并将工具调用、结构化输出和流式事件转换为应用内部格式。XINCODE 不内置任何托管密钥,API Key 只保存在设备 Keystore 加密配置中,正式包不包含任何 Key。
📄 许可与第三方声明
- 本项目主体代码采用 GNU General Public License v3.0 or later(见
LICENSE)。 - 打包/引用的第三方字体、像素素材与 Maven 依赖,依其各自许可使用,详见
THIRD-PARTY-NOTICES.md与licenses/。- JetBrains Mono 字体 — SIL OFL 1.1
- 角色 sprite(MetroCity)— CC0 1.0
- 地板/家具/装饰/地毯(pixel-agents)— MIT
🙏 致谢
XINCODE 在设计过程中参考了多个开源 AI 智能体的公开设计思路(inspired by,并未搬运/移植其代码):
- xai-org/grok — 工具调用循环与终端 agent 交互思路
- NousResearch Hermes 系列 — 自进化学习闭环、精编记忆、零上下文工具-RPC 等设计思路
- pixel-agents-hq/pixel-agents — 像素办公室场景灵感与素材来源
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi