移动端通用 Agent

把桌面级 Agent
装进你的口袋

龙宫 Agent 在手机沙箱内嵌轻量 Linux 运行时(proot + Termux + qwencode + Node + Python),流式对话、文件工作区、浏览器自动化、读屏与语音——运行时与工具执行都在设备内完成,无需 root。

qwencode · Running
本地工作区已挂载
龙宫 Agent● local
帮我把这份调研报告整理成 PDF
已读取 workspace 中的报告,正在排版生成本地产物…
▸ browser_navigate · 取证完成
📎 附件 · 🎙 语音qwen-local ▾
设备内运行时与工具执行
独立进程运行时与 UI 隔离
6+可挂载 MCP 能力
2 形态Phone 竖屏 / Pad 横屏
Capabilities

一台设备,一整套 Agent 能力

从流式会话到文件产物,从网页自动化到屏幕感知,龙宫把桌面级 Agent 的工具链完整搬进手机——运行时与工具执行都在你自己的设备上。

流式 Agent 会话

SSE 流式输出、多会话管理、标题搜索、思维链默认折叠、工具调用紧凑行 + 详情。滚动纪律经五代迭代打磨,流式 token 绝不打断阅读。

SSE → Flow<AgentEvent> → 消息拍平

文件工作区与产物

面板分「任务 / 文件」双 Tab:任务 Tab 实时呈现计划与产物;文件 Tab 逐层浏览 workspace、面包屑定位当前目录、上一级返回,点文件交系统应用打开。

任务 Tab · 文件 Tab · FileProvider 打开

内置浏览器自动化

可见浏览器覆盖层 + browser MCP:导航、快照、点击、填表、截图取证,页面变化屏幕可见。

browser_* · CDP 中继

屏幕感知 / 操控

device-screen MCP 读取当前屏幕元素、前台应用、拉起应用;操控(点击/输入/滑动)默认关闭、按需开启。

无障碍 · opt-in

语音输入

ASR 三协议桥,按住说话实时叠加草稿;权限流完整,未授权优雅降级。

RECORD_AUDIO · 可选

多模型 · 多供应商管理

百炼 / 火山 / 华为等供应商密钥本机加密存储;会话级模型 chip 逐会话覆写,首页空态显示全局默认模型。模型目录动态合并,供应商未配密钥时本地门控给出明确指引。

per-session 覆写 · EAGER-PIN · 凭证门控 fail-open

MCP 工具生态

能力以服务挂载、逐服务开关;连接自动守护、会话预热,保证首次响应不冷场。

browser · device-screen · homework…
Showcase

看见它如何工作

三个最具代表性的工作流,展示龙宫与普通"聊天套壳"的本质区别:它真的在你的设备上动手做事。

01 / CONVERSATION

流式对话,像桌面一样顺滑

消息以 SSE 逐 token 流入,用户气泡右对齐、助手全宽 Markdown、思维链默认折叠、工具调用收成紧凑行。反向布局 + 贴底跟随的滚动纪律,让长对话永远停在你想看的位置。

  • 多会话 列表 / 搜索高亮 / 重命名 / 归档
  • 乐观新建 置顶插入立即导航,后台对齐
  • JumpToBottom 逃生舱,长流不迷路
chat · session
总结一下今天工作区里新增的文件
▸ list_files(workspace) ✓
检测到 3 个新增文件:调研报告.md、数据表.xlsx、截图.png…
qwen-local思维链 折叠工具 2 次
02 / WORKSPACE

工作区:产物即取即用

Agent 读写的是真实共享存储下的 workspace。你在系统文件管理器里看得见、拿得走;也把资料放进去让它读。产物默认落在根或一级目录,绝不藏进深层路径。

  • 三处复用 Pad 常驻栏 / 中屏 sheet / 手机横滑条
  • 系统打开 FileProvider 交任意已装应用
  • 附件上传 图片/文件拷入 uploads,消息内引用
workspace · ~/workspace
~/workspace/
├─ uploads/2026-09/ · 附件(14 天清理)
├─ 调研报告.md
├─ 数据表.xlsx
└─ 产物/ 报告_final.pdf ← 本次生成
文件 Tab面包屑 ~/workspace › 产物/
任务 Tab计划 3/3 · 产物 1
03 / AUTOMATION

浏览器 + 读屏:跨出对话框

内置浏览器由 browser MCP 驱动,网页任务一律走可见覆盖层,操作过程屏幕可见、可截图取证;device-screen MCP 则读取第三方 App 画面、按需操控。两者分工清晰,不越权。

  • browser_* 只管内置浏览器内的网页
  • device-screen 读屏 / 前台应用 / 拉起 / 操控(opt-in)
  • 安全默认 操控默认关闭,先读后点、点完验证
mcp · browser / device-screen
browser_navigate→ 打开目标页
browser_take_snapshot→ 元素 uid
browser_type / click→ 填表 · 点击
browser_screenshot→ 取证留档
read_screen→ 第三方 App 画面
browser ✓device-screen ✓屏幕操控 · 关
Adaptive

一套实现,两种形态

基于 Material 3 Adaptive 的 list-detail 骨架:Pad 横屏三栏(会话列表 / 聊天 / 工作区常驻栏),手机竖屏收敛为 Header + 列表→详情。工作区栏打开时会话列表主动让位,窄屏也不挤。

Pad · 横屏 Expanded
调研报告整理
周报草稿
课件大纲
数据清洗
把大纲扩写成讲义
📎 🎙qwen-local ▾
WORKSPACE
讲义_v2.docx
大纲.md
参考/
Expanded:工作区右侧常驻,会话列表让位过渡。
会话
调研报告整理
周报草稿
产物横滑条 ↑
Compact:Header 导航 + 列表→详情,产物收为 composer 上方横滑条。
Ecosystem

开放的生态扩展能力

龙宫集成 qwencode,把「换模型、加技能、连工具」都做进设置里——三类扩展即开即用,无需改一行代码。

Powered byqwencode 设置 → AI 能力

模型供应商开放支持

设置 → AI 能力 → 模型管理

内置阿里云百炼火山方舟两家供应商(均 OpenAI 兼容),也可添加任意自定义端点。密钥本机加密存储,模型可随时切换、逐个覆写参数。

自定义 OpenAI 兼容端点 密钥本机加密 逐模型参数覆写 会话级切换
右侧为内置供应商与可用模型缩影;完整清单在应用内动态拉取。
模型管理内置 2 家供应商 · 均 OpenAI 兼容
阿里云百炼dashscope密钥已设 ✓
qwen3.8-max-preview最新👁
qwen3.7-max👁
qwen3.7-plus👁
+ qwen3-coder-plus · qwen3.7-flash · qwen3.6-plus …
火山方舟volc ark设置密钥
deepseek-v4-pro热门👁
doubao-seed-2.1-turbo👁
kimi-k3👁
+ glm-5.2 · minimax-m3 · ark-code-latest …
+添加自定义供应商baseUrl + apiKey

技能管理

设置 → AI 能力 → 技能管理

技能是装着 SKILL.md 的文件夹,把一套专业流程沉淀成模型可随时调用的能力。内置 7 项开箱技能,也可导入自己的。

模型自动调用 /name 手动触发 导入自有技能 随仓库共享
右侧按用途归类列出内置技能与各自能做什么。
技能管理内置 7 项 · 用户可导入 ⟳ · ⇪
文档办公4 项
/docx/pdf/pptx/xlsx
Word · PDF · PPT · Excel 的读取、生成与编辑
深度研究1 项
/deep-research
多源检索 + 交叉验证,产出带引用的研究报告
技能工坊2 项
/skill-creator/install-skill-dependency
创建新技能、为技能安装缺失依赖

MCP 与连接器

设置 → AI 能力 → MCP 与连接器

MCP 标准连接外部工具与数据源,查看状态、逐服务开关、逐工具过滤。内置浏览器与读屏能力,也能添加或导入自定义连接器。

Stdio / SSE / HTTP 逐服务开关 逐工具过滤 远程 OAuth
右侧为内置 MCP 缩影;工具数与连接状态在应用内实时呈现。
MCP 与连接器内置 2 项通用连接器 ⟳ · + · ⇪
browser已连接6 工具
browser_navigate
browser_screenshot
device-screen已连接4 工具
read_screen
screen_tap
+添加连接器Stdio / SSE / HTTP
Architecture

三层架构,一条边界

App 管界面与业务,SDK 管运行时,proot 对使用者不可见;层间仅暴露 Kotlin API 与一个 localhost 基址。

01 · App 层

每款产品一份,SDK 不管

界面与业务逻辑
UIJetpack Compose + Material 3 Adaptive;Pad 三栏 / Phone 列表→详情
StateViewModel + StateFlow / Room / DataStore
业务认证登录态、学情采集、作业课堂、推送语义
只暴露 Kotlin API + 一个 localhost 基址
02 · Agent Runtime SDK

UI 无关的模块化运行时

龙宫 App 即第一个宿主
sdk-client纯 Kotlin;会话 / prompt / SSE→Flow / MCP / 技能 / 设置 / 预热 / 恢复
sdk-runtimeAAR;物料铺设 / init 编排 / proot 启动 / serve 生命周期;:runtime 独立进程
sdk-capabilities按需引入;screen / browser / voice / fileopen
sdk-assets物料包;OSS 分发,MANIFEST 校验
内聚为 SDK 私产:proot / 端口 / serve-token
03 · proot 容器

对 SDK 使用者完全不可见

设备内 Linux 用户空间
Termux rootfsnode 24qwen serve :8091ACP agentMCP 池python 3.14skillscronie
For Developers

Agent Runtime SDK

你在龙宫 App 里看到的每个能力,都能以 SDK 模块装进你的 App。

Module形态 / 职责
sdk-clientKMP(commonMain 零 Android 类型,iOS 预留)。qwen serve 协议类型化客户端:会话 / prompt / SSE→Flow / MCP / 技能 / 设置 / 预热 / transcript 恢复。
sdk-runtimeAndroid AAR。物料铺设、init 编排、proot 启动、serve 生命周期与后台保活;Service 运行于 :runtime 独立进程,与 UI 崩溃隔离。
sdk-capability-screen可选屏幕感知/操控:无障碍 + A11yHttpServer + device-screen MCP。
sdk-capability-browser可选可见浏览器:专用 WebView + CDP 中继 + 覆盖层 + 跨站重建链。
sdk-capability-voice可选语音输入 ASR 三协议桥。
sdk-capability-fileopen可选系统应用打开文件(FileProvider,随包免疫 R8)。
sdk-assetsOSS 物料包(不入 git,仅 SHA256SUMS 指针):bootstrap rootfs / debs / python / npm 引擎 / skills / mcp / init.sh。
Integration.kt
// 1) 依赖(Maven 坐标)
implementation("com.jvscopilot.agentruntime:sdk-runtime:0.x")
implementation("com.jvscopilot.agentruntime:sdk-ui:0.x")

// 2) 冷启动门闸:消费 initialize() Flow
runtime.initialize().collect { state ->
    if (state is RuntimeState.Running) enterHome()
}

// 3) 建会话 + 流式 prompt
val session = runtime.client.createSession()
runtime.client.prompt(session.id, text).collect { event ->
    render(event)  // MessageUpdated / PartUpdated / Status
}

// 4) 挂一个现成设置页(可选)
AgentSettingsScreen(runtime)  // 模型·密钥·语音·MCP 开关

AgentClient API 一览

sdk-client · 纯 Kotlin 协程接口(suspend / Flow)
生命周期
  • awaitReady()等待 serve 就绪,discovery 空窗内建重试
  • runtimeState(): Flow<RuntimeState>初始化进度 / 运行中 / 异常
会话
  • createSession(title?)thread scope 强制内建,防混线
  • listSessions()封套 / 裸数组双兼容
  • deleteSession(id)删除会话
  • renameSession(id, name)重命名会话
事件流 & prompt
  • events(sessionId): Flow<AgentEvent>SSE→Flow;懒建流,仅活跃会话恢复
  • prompt(sessionId, text)退避重试内建;404→resume 链
MCP
  • mcpStates(): Flow<List<McpServerState>>connected / connecting / disabled
  • setMcpEnabled(server, enabled)写 settings.json mcp.excluded
  • warmupMcpConnections()隐藏会话预热,保证首响
设置 & 目录
  • getSettings(): ServeSettingssettings.json 类型化投影
  • setModel(provider, model, overrides?)会话级模型覆写
  • refreshModelCatalog(): ModelCatalog动态目录并集合并
  • setVoiceInputService(sel?)语音输入服务选择
恢复
  • restoreTranscript(sessionId): List<AgentEvent>磁盘 jsonl 重建,含 tool part
Security & Privacy

隐私与安全,默认替你把关

每一项可能触及隐私的能力,默认都是关闭或脱敏的;打开它,需要你在界面上明确同意。

凭据加密存储

供应商密钥进 EncryptedSharedPreferences,不进 Room、不上云;按账号分桶,换账号即换桶 + 进程重启。

凭证门控 fail-open

仅在确证"供应商未配密钥"时本地拦截并给出指引;任何读取异常一律放行,绝不误伤正常会话。

附件 GPS 自动脱敏

图片附件上传前剥离 EXIF 位置信息,分享截图不泄露坐标。

屏幕操控需手动开启

读屏需开启无障碍;点击/输入/滑动默认关闭,先读后点、点完验证,不自动答题。

物料可审计

离线物料 SHA256 强校验、版本谱系公示;升级收益与 CVE 修复逐条存档可查。

开源许可公示

proot(GPLv2)、Termux(GPLv3/GPLv2)等再分发组件于应用内"开源许可"页公示许可证与源码获取链接。

FAQ

常见问题

我的数据会上传到云端吗?
运行时、文件与工具执行全部在设备本地完成。是否联网取决于你配置的模型供应商:选择云端供应商时 prompt 会发往该供应商;选择自建/本地端点则可全离线。供应商密钥仅存本机加密存储。
需要 root 或刷机吗?
不需要。龙宫在应用沙箱内以 proot 承载 Linux 用户空间,普通安装即可运行,不触碰系统分区。
支持哪些设备?
Android 9(API 28)及以上,手机与平板均适配:Pad 横屏三栏、手机竖屏列表→详情,基于 Material 3 Adaptive 自动切换。
没有网络能用吗?
运行时与工具链离线可用(物料内嵌离线首启)。对话是否可用取决于模型端点:配置本地/自建端点即全离线;云端供应商则需联网。
作业/课堂等教育功能在哪?
龙宫默认为通用 Agent;教育能力(作业门闸、学情采集)作为可选开关存在,默认关闭,开启后才注入规则并启用相应 MCP。
如何把这套运行时集成进我自己的 App?
使用 Agent Runtime SDK:依赖 sdk-runtime(+可选能力包),消费 initialize() Flow 做冷启动门闸,再经 runtime.client 建会话与流式 prompt。详见上方「SDK」区。
用了哪些开源组件?许可如何?
proot(GPLv2,仅独立二进制调用)、Termux bootstrap(GPLv3/GPLv2)等;应用内"开源许可"页公示许可证与源码获取链接(Termux 官方仓库)。

现在,把龙宫装进口袋。

下载 Android 版,体验在设备上运行的桌面级 Agent;或阅读 SDK 文档,把这套运行时集成进你自己的应用。

in-app 更新:关于页「检查更新」· manifest 强校验 SHA256