跳转至

设置详解

桌面「空间设置」里的每个入口都在这里说明。部分页面有更详细的单独文档,会在对应小节里链接。

应用与容器

应用管理

安装 APK、导入桌面应用、管理虚拟应用和实例。详见 应用安装与管理。

宿主控制(Root)

需要设备已 root,并允许 NestSpace 使用 su。

  • 开启后,AI 助手和 MCP 会获得 host_* 工具,可以观察、点击、输入、截图、启动应用和打开网址;操作范围是整台真实设备,而不只是虚拟空间。
  • 关闭后,这些工具会立即从助手和 MCP 的工具列表中移除。
  • 每次开启都会重新检测 su;Root 不可用时开关无法打开。
  • 权限很高,请只在可信设备上使用。

相关工具见 MCP 工具参考。

容器槽位

容器进程池最多有 16 个槽位,每个槽位对应一个独立的容器进程。

  • 自动(默认):按内存动态管理,最高可以使用全部 16 个槽位。内存紧张时优先关闭最久未使用的后台容器,前台容器不会被关闭。
  • 固定档位:限制同时运行的容器进程数(1–16)。降低上限会立即结束超出范围的进程。

修改后立即生效。应用数据不会因为结束进程而丢失。

坐标模拟

为虚拟空间内的应用模拟经纬度:

  • 打开开关后,虚拟应用通过 LocationManager 读取到的位置是下方设置的坐标,默认精度 5 米;
  • 只影响虚拟应用,不会修改真实设备的定位,也不需要 Root;
  • 应用仍需获得定位权限;正在运行的应用可能需要重新打开才会使用新坐标;
  • 使用自有定位服务的应用(例如部分地图 SDK 或 Google Play 服务)可能仍返回真实位置。

容器自检

运行一组自动检查,确认容器基础能力是否正常:

  • 启动虚拟应用;
  • 读取界面和截图;
  • 独立进程;
  • WebView;
  • MCP 服务。

每项结果分为通过、部分通过、失败和跳过,可以复制完整报告。排查兼容性问题或反馈 issue 时,附上自检报告很有帮助。

浏览器代理

为内置浏览器配置 HTTP 或 SOCKS 代理:

  • 所有标签页和浏览器下载共用同一代理。
  • 支持逗号分隔的绕过规则。
  • 需要 Android 10+ 且 WebView 支持 PROXY_OVERRIDE。
  • 暂不支持需要用户名/密码的代理。

详细说明见 内置浏览器。

助手

模型设置

配置 AI 助手使用的模型接口,支持 Claude 兼容和 OpenAI 兼容两种协议。可以保存多个配置并切换,每个配置包含:

  • 协议;
  • Base URL;
  • API Key;
  • 模型名称;
  • 上下文 token 上限;
  • 单轮最大工具调用次数。

API Key 使用 Android Keystore 加密保存,任何工具结果都不会返回明文。点「测试连接」会发起一次真实请求。

详见 AI 助手。

系统提示词

所有模型共用一份系统提示词。可以编辑、保存,也可以一键恢复内置默认值。运行时 NestSpace 还会自动追加当前时间、记忆、技能索引和工具规则。

MCP 工具

配置**外部** MCP Server,让本地 AI 助手使用更多工具:

  • 支持多个 Streamable HTTP 端点;
  • 使用 Bearer Token 鉴权;
  • Token 使用 Android Keystore 加密保存;
  • 刷新后请求 initialize / tools/list;
  • 工具名以 mcp_<服务短 ID>_ 前缀提供给本地助手。

外部工具不会暴露给远程 MCP 客户端,远程客户端也不能直接调用它们。详见 MCP 控制服务。

记忆与技能

记忆与技能

  • 记忆:助手会在每轮对话后自动整理事实、偏好和做法。事实和偏好直接生效;做法在标准/宽松权限下直接生效,严格模式或自定义启用「风险点击」确认时先显示确认卡片。可以置顶、批准或删除。
  • 技能:随应用内置 7 个。助手会从成功的多步骤任务中自动起草技能;新技能始终默认停用,并在对话里显示启用卡片。每次使用会记录成功/失败;最近 3 次中失败 2 次会自动停用,手动重新启用后重新计数。
  • 自定义技能可以编辑、导入 SKILL.md、查看版本历史并恢复旧版本;内置技能只能停用,不能删除或覆盖。

记忆和技能保存在应用私有目录,并使用加密存储。需要时,相关条目会随系统提示词发送给当前配置的模型服务,不会上传到其他服务器。密码、验证码、银行卡和身份证信息不会被自动记录。

定时任务

让助手创建定时任务,例如「每天早上 9 点看看天气,下雨才告诉我」。支持:

  • 单次;
  • 每天;
  • 每周;
  • 固定间隔。

任务到点后会在原对话里执行,并发送结果通知。任务由系统闹钟调度;如果 NestSpace 被系统彻底停止,任务会在下次启动后恢复调度。

评测与回放

用真实任务测试 Agent,记录每次运行的工具轨迹和结果;成功后可以把流程保存为回放,之后重复执行。

子任务记录

查看 spawn_agent 创建的子 Agent:

  • 状态和结果;
  • 停止正在运行的子任务;
  • 结果按不可信数据处理,只用于给主 Agent 提供参考。

Token 统计

按请求查看模型输入的 token、输出的 token 和思考 token,用于估算用量和成本。

权限级别

控制助手执行敏感操作前是否需要确认:

级别 行为
严格 安装/卸载、权限变更、风险点击、下载等都需要确认;可复用的做法也会先请求确认
标准 在宽松基础上增加应用安装/卸载确认;记忆和自动起草的技能直接保存(技能默认停用)
宽松 只有支付、下单、转账、红包等涉及金钱的操作才提示
自定义 自己选择哪些类别需要确认

权限级别

可以确认的类别包括安装、权限、下载、风险点击等。记忆和技能学习不算敏感操作;只有严格模式,或自定义模式启用了「风险点击」确认时,可复用的做法才会先请求确认。自动起草的技能始终默认停用,需要在对话卡片或记忆与技能页面手动启用。远程 MCP 客户端不受这个设置影响;远程工具调用由客户端自己控制。

悬浮球

  • 打开或关闭悬浮球;
  • 设置宿主界面和容器内的颜色;
  • 调整透明度;
  • 选择语音语言;
  • 调整位置;
  • 下载或删除离线语音模型。

首次启用需要授予「显示在其他应用上层」权限。悬浮球是语音助手的快捷入口,详见 AI 助手。

MCP 控制服务

启动/停止对外的 MCP Server,查看本机和局域网地址、Token,以及后台启动所需的悬浮窗权限状态。

详见 MCP 控制服务。

桌面与语言

桌面壁纸

选择、更换或清除桌面壁纸。壁纸保存在应用内部,卸载 NestSpace 时一并清除。

语言

  • 跟随系统;
  • 中文;
  • English。

修改后界面立即刷新。

关于

显示当前版本号和项目信息。

相关文档