Android App
推荐方式。支持横屏沉浸、系统分享导出与安全存储会话，长期使用体验最好。
- 要求：Android 8 及以上
- 来源：由项目自行构建安装包，不通过公开商店分发
NATIVE · ANDROID
装到手机上，
或者直接用浏览器。
Infinite Canvas 是同一套前端代码：浏览器里就是网页应用，套上原生壳就是 Android / iOS App。下面三种方式按你的设备挑一个。
- Android
- 原生构建，已可用
- Web
- 任意现代浏览器
- iOS
- 需要 macOS + Xcode 自行构建
- 账号
- 使用现有账户登录
- 版本
- v0.1.0
INSTALL
三种方式，
三种方式，
选一个开始。
浏览器直接用
不想装东西就走这条。打开网址登录即可创作，会话保存在这台浏览器里。
- 建议：Chrome / Edge / Safari 最新版本
- 注意：浏览器模式不支持系统级横屏锁定与原生分享
WEB · INSTANT
iOS 自建
仓库里已经配好 Capacitor iOS 目标，在 macOS 上用 Xcode 编译后即可在真机安装。
- 要求：macOS + Xcode + Apple 开发者签名
- 状态：需要自行构建，暂不提供现成安装包
NATIVE · IOS
ANDROID BUILD
从源码构建 Android 安装包
需要 Node.js 与 Android Studio，以及 JDK 21。Capacitor 7 的 Android 目标编译级别是 21，用 JDK 17 会报「无效的源发行版：21」。
# 1. 安装依赖
npm install
# 2. 构建 Web 资源并同步到原生工程
npm run build
npm run cap:sync
# 3. 用 Android Studio 打开并运行
npm run android
Android Studio 自带的 jbr 通常就是 JDK 21。构建前先确认
java -version 输出 21.x。
LOCAL DEV
本地开发与调试
开发服务器默认监听 4173 端口，并把模型与素材接口代理到目标服务，避免本地调试被跨域拦住。
npm run dev
# → http://localhost:4173
修改前端后重新构建并同步，再用 Android Studio 运行；调试图标过滤 mikasa-app 可以看到脱敏后的请求诊断。
/api · /v1 · /v1beta开发代理到模型网关/kling · /jimeng第三方视频与图片通道/short-links-api云端素材与短链服务
ACCOUNT & QUOTA
用你现有的
用你现有的
账户登录。
Infinite Canvas 不自建账户系统，也不内置任何模型密钥。登录后，App 会在你的账户下创建一枚专属 Token，之后的每次生成都用它计费。
- 01登录与二次验证支持账户密码登录，开启两步验证的账户会要求输入验证码。
- 02额度与请求次数账户页显示剩余额度和累计请求次数，每次生成后自动刷新。
- 03模型分组切换分组会改变可用模型与单价；恢复默认分组随时可以点回去。
App 不保存密码与账户总 Key。原生端的会话只存放在设备安全存储中，卸载或清除数据后需要重新登录。
你的数据放在哪里
DATA & PRIVACY
ON THIS DEVICE
留在这台设备上
- 个人画布项目、节点与连线
- 素材库里的图片、视频与对话记录
- 浏览器模式下的登录会话
- 导入的本地文件与导出包
这些内容不会自动上传。清除浏览器数据或卸载 App 会一并清除，重要素材请先导出。
OVER THE NETWORK
会通过网络发送
- 生成请求里的提示词与参考图（发往模型网关）
- 你主动上传到云端的素材文件与短链创建请求
- 共享画布的结构数据（通过 WebSocket）
- 脱敏后的失败诊断信息（仅接口路径、状态码、耗时与模型名）
诊断日志不包含 Token、密码、Cookie、提示词正文和图片内容。
常见问题
FAQ没有账号可以先用吗？
需要一个可用账户。生成请求按账户额度计费，所以必须先登录；登录后 App 会自动准备一枚专属 Token，无需你手动填。
Android 构建报「无效的源发行版：21」怎么办？
说明当前 JAVA_HOME 是 JDK 17 或更低。把 JAVA_HOME 指向 JDK 21（Android Studio 自带的 jbr 目录即可），确认 java -version 输出 21.x 后重新构建。
生成失败了，怎么排查？
先看面板里的错误提示：常见原因是模型未选、额度不足、服务端未开放对应接口或被网关拦截。App 内检索 mikasa-app 日志标签可以看到请求路径与状态码。
换手机后素材还在吗？
不会自动跟着走。素材默认存在本机，可以在旧设备上把画布导出成完整包（含媒体文件）再导入新设备，或先把重要素材上传云端拿短链。
可以在电脑上打开吗？
可以。它本质上是 Web 应用，桌面浏览器同样能用，只是横屏沉浸与原生分享这类能力在浏览器里会被替换成等效的网页行为。