常见问题

Valxe 是原生 Swift + SwiftUI 写的,深度集成 iOS 系统 API(WKWebView、Keychain、Files、App Extensions)。Android 没有计划,macOS 用户建议直接用 VS Code 即可。本 App 主要解决的痛点是「在 iPad 上有桌面级开发环境」。

App Store 版本是 7 天免费试用 + NT$60 / US$1.99 一次性购买永久解锁(只买一次,没有订阅、没有月费、没有 AI 用量加购)。试用要在 App 内按「开始 7 天免费试用」才会开始,每个 Apple ID 一次,记录由 App Store 保存,重新安装也不会重置;试用结束不会自动收费。试用期间所有功能可用;还没开始试用、或试用结束后没购买时是只读模式——仍可打开与浏览文件,编辑 / 新增 / 删除文件、终端、AI 助理、Git 版本控制与导入主题需要解锁。

支持 12 家:Anthropic Claude、OpenAI、Google Gemini、DeepSeek、Groq、xAI(Grok)、Mistral、OpenRouter、智谱 GLM、Minimax、本地 Ollama,以及自订 OpenAI 兼容后端。Agent 模式可让 AI 直接读写你的文件、跑终端(内置 5 个工具)。本地 Ollama 可从 iPad 连 Mac 区网直连,不送数据到云端。API key 自备,我们不代收费。

稳定是 Valxe 最优先处理的事。已处理的包括:Pull 不再覆盖未提交的本地文件、SSH 连到不支持 TTY 的主机不闪退、C/C++ 连续运行不闪退、重开同一个文件不闪退、Stage Commit 竞态条件等;依赖版本与 UI 细节也已升级。每个版本的变更见本站「更新记录」页。重要项目仍建议定期 push 到外部 Git remote 备份。

可以,但体验会差很多——屏幕太小、键盘屏蔽编辑区、终端机难用。强烈建议 iPad(尤其是 iPad Air / Pro + 外置键盘),M 系列芯片跑语言 runtime 最顺。iPhone 适合临时改一两行文件或看 Git diff。

绝对不会。私钥存在 iOS Keychain(系统加密、无法被其他 App 读取),App 本身连看都看不到明文。我们没有自家后端,连你 SSH 连到哪台机器都不知道。私钥是不是你自己产的,我们也碰不到。

内置 Python 3.9.2、Node.js 18.19.0、PHP 8.3.2、Clang 14.0.0(C/C++ + WebAssembly)、OpenJDK 8(Java)。Python 可装 pip 套件、Node 可装 npm 套件、PHP 可跑 Laravel artisan。仿真器版本(Valxe UI)受限于 framework,部分语言 runtime 不可用,真机完整版才有所有功能。

内置的 Python / Node / PHP / Clang / OpenJDK runtime 是预编译的 xcframework,光是这几包 binary 就接近 1GB(类似你电脑装完一套 dev 工具)。换来的是 iPad 上完全脱机可跑这些语言。对开发者来说值得;对只想看 code 的用户可能太大。

请通过本站的联系表单告诉我们。反馈 bug 时附上设备型号、iOS / iPadOS 版本、Valxe 版本与重现步骤,会更快找到原因;功能建议也欢迎说明你的使用场景。

绝对不会。试用结束只是切到「只读模式」——你仍可打开与浏览所有文件、拷贝内容、看设置。挡的是编辑 / 新增 / 删除文件,以及终端、AI 助理、Git 版本控制与导入主题。文件本身完全不会被删、被改、被锁。即使你永远不购买,iPad 上的 code 也永远安全地留在原处,需要时可通过 iOS Files / iCloud Drive / AirDrop 拿出来。

一般聊天:你问 AI 答,AI 不能碰你的文件。Agent 模式:AI 可调用 5 个工具——`read_file`(读档)、`write_file`(写档)、`list_dir`(列目录)、`grep`(搜索)、`run_terminal`(跑指令)。读档、列目录、搜索 AI 可以自己来;会改东西的操作都要你同意:AI 要写档或执行终端指令前,画面会弹出确认卡,你可以选「允许」「拒绝」或「本次任务都允许」,拒绝就不会执行;按停止或清除对话会一并取消。路径限制:读写一律限制在当前打开的工作区内,绝对路径、`../`、指向工作区外的快捷方式(符号链接)都会被拦,远程 SSH 工作区路径上有符号链接也会拦。沙箱限制:Agent 只能访问你打开的工作区、不能跳出 sandbox 看其他 App。

步骤:(1) Mac 上 `OLLAMA_HOST=0.0.0.0 ollama serve` 让 Ollama 监听区网。(2) 在 iPad Valxe 设置 → AI → 加入 provider「Ollama」,Server Address 填 `http://<Mac 区网 IP>:11434`(例 `http://192.168.1.50:11434`)。(3) 加入 model 时 App 会打 `/api/tags` 验证并列出可用 model,失败会明确提示。好处:数据完全不送云端、付费 model 用本地大幅省钱、Agent tool-use 也支持(qwen2.5-coder / llama / mistral 等 OpenAI function calling 兼容 model)。Mac 不开机时 App 会 graceful fallback,不会 crash。

能跑的:Python 3.9.2 含 pip(装 numpy、pandas、requests、flask 等都可),Node 18.19 含 npm,PHP 8.3.2 含 Composer,Clang 14(C/C++ 编译 + WebAssembly 输出),OpenJDK 8(Java + Kotlin via kotlinc)。桌面有的限制 iPad 都有:Python C extension(numpy 之类)需预编译 iOS arm64 版才能装、Node 不支持 native module(node-gyp build 不过),PHP 没有 GD / Imagick / pcntl 等需 OS 层 lib 的 extension。仿真器版(Valxe UI)受 iOS Simulator framework 限制,部分 runtime 不可用,真机完整版才有完整 5 个 runtime。

SwiftGit2(libgit2 wrapper)本身能处理大 repo,但 iPad 内存 / 保存空间是瓶颈——基本 iPad(8GB RAM)clone Linux kernel(~4GB)会吃力,M 系列 iPad Pro(16GB+)就顺得多。建议:(1) 对 monorepo 用 `--depth=1` shallow clone 大幅省空间。(2) 大 repo 开分支用 `--single-branch` 不要拉所有分支历史。(3) 随身存 Git LFS 二进位资产要小心 iPad 容量,可用 `.gitattributes` 排除。Stage Commit 竞态条件已修(`tab` race 在 v1.x 修了),日常 commit 不会吃 conflict。

好消息:Monaco 跟 VSCode 同款引擎,语法高亮 / autocomplete / multi-cursor / Emmet / 主题 JSON 完全兼容,直接把你的 VSCode color theme JSON 拖入即可。差异主要在:(1) Extension 生态不同——VSCode 那边 extension 不能直接装,但本 App 走「JS 注入修补模式」让 Swift 层可动态增删功能。(2) 设置不是 settings.json 而是 iOS 设置页,但 keyboard shortcut 大部分对应(:wq / Cmd+P / Cmd+Shift+F 都通)。(3) iPad 特有优势:Stage Manager 双屏幕、外置 27" 显示器、Apple Pencil 触摸、轻便电池整天。差异化是「iPad 桌面级体验」,不是要取代你的 MacBook + VSCode。