ZOREVA-UI CLI
在终端中构建应用。
提出需要的界面、着色器或主题。CLI 借助 ZOREVA-UI 目录在你的 SwiftUI 或 Android 项目中规划、编辑和运行命令,展示每个 diff,并在任何高风险操作前询问。
macOS 和 Linux。Windows 和 npm 见下方。
~/my-app $
安装
每个平台一条命令。
Windows
在 PowerShell 中运行。安装独立的 Windows x64 二进制文件。无需 Node.js。
$ irm https://zoreva-ui.com/install.ps1 | iexnpm
可在任何装有 Node.js 18 或更高版本的平台上使用的替代方式。安装的命令是 zoreva。
$ npm i -g zoreva-ui然后运行 zoreva ,然后在浏览器中用你的 ZOREVA-UI 账户登录(邮箱验证码、Google 或 GitHub)。专有软件:安装即表示你接受 CLI 许可(EULA).
规划模式
在任何改动之前审查计划。
按 Shift+Tab 或以 --plan 启动。代理只会读取你的项目、写出计划并询问“按此计划构建吗?”。在你同意之前不会写入任何内容。

Diff 与 /undo
每次编辑都会先显示 diff。
接受、拒绝或在本次会话余下时间全部接受修改。每个提示词都是一个检查点:/undo 还原上一个提示词修改的文件,/rewind 可以回退更多。
权限与沙箱
高风险命令总是会询问。
删除文件、git push、改写历史或安装软件包每次都会询问:仅允许一次、在此项目中始终允许,或拒绝。/sandbox 让 AI 的命令在无网络、仅能写入项目内的环境中运行(Linux 上使用 bubblewrap)。
ZOREVA.md 与 @ 提及
你的项目规则,每次会话都会加载。
ZOREVA.md 和 .zoreva/rules 会在每次会话开始时读取;/init 可创建一个。输入 @ 即可附加文件,并从你的项目中自动补全。
继续与恢复
从上次中断的地方继续。
zoreva -c 继续此文件夹中的上一次对话。zoreva -r 或 /resume 打开任意已保存的对话,/conversations 按项目浏览。
使用自己的 AI
使用 ZOREVA-UI 模型或你自己的密钥。
默认情况下,CLI 使用通过 我们的 AI 基础设施 提供的 ZOREVA-UI 模型,按你方案的积分计费,并在每条回复中显示。运行 /keys 改为连接你自己的服务商,或传入 -m provider/model.
$ zoreva
› /keys
› /model
$ zoreva -m provider/model
命令
输入 / 使用命令,@ 引用文件,! 运行 shell。
会话
/new开始新对话
/resume继续已保存的对话
/undo还原上一个提示词修改的文件
/rewind回到更早的提示词之前
/compact总结对话以释放上下文
/usage显示方案用量和剩余上下文
/export将对话保存为 Markdown
模式与设置
/modebuild、plan、debug 或 task
/model选择模型,或 provider/model id
/keys使用你自己的 API 密钥
/permissions信任级别与允许/拒绝规则
/sandbox无网络,仅能写入项目内
/init为此项目创建 ZOREVA.md
/theme深色、浅色、色盲友好或自定义
应用
/create用目录界面新建 Xcode 应用
/build在模拟器、iPhone 或 Android 上构建并运行
/preview各种尺寸、浅色、深色、大字体的截图
/store带边框和说明文字的 App Store 截图
/icon用一张图片生成所有 iOS 和 Android 图标尺寸
/precheckApp Review 或 Google Play 可能指出的问题
/logs流式查看应用日志,最近的崩溃优先
Git 与工具
/diff自上次提交以来的变更
/commit使用建议的提交信息提交
/pr使用 gh 或 glab 创建拉取请求
/bg在后台运行命令
/mcpMCP 服务器及其状态和工具
/doctor检查 Node、Xcode、模拟器和连接
/update检查新版本
zoreva启动 ZOREVA-UI(无会话时会要求登录)
zoreva login在浏览器中登录(邮箱验证码、Google 或 GitHub)
zoreva -p "prompt"回答一次后退出(用于脚本,--json 输出事件)
zoreva -c / -r [id]继续上一次对话,或选择已保存的对话
zoreva --plan / --task以规划模式启动,或规划 → 批准 → 执行
zoreva new <Name> [screen]用目录中的界面创建 Xcode 应用
zoreva update更新到最新版本
在 CLI 中运行 /help 查看完整列表,或运行 zoreva --help 查看所有选项。
更新日志
频繁发布。
v0.2.7
2026年10月31日
- Auto is smarter: better choices, especially in Spanish.
v0.2.6
2026年10月30日
- 表格单元格内的换行现在会显示为单元格中的真实换行,而不是文本里的 <br>。
- A <br> outside a table starts a new line.
- Tables with multi-line cells draw a line between rows so each row is easy to tell apart.
- You're asked once whether to share anonymized requests to help improve Auto. Change it any time with /privacy on, off or status; turning it off deletes what was stored.
v0.2.5
2026年10月30日
- Auto 能回答各种请求,不只是代码:写作、学习、规划、研究、数学和日常问题。
- Auto follows your session mode: plan mode plans without touching files, debug mode investigates without editing, and task mode gives planning work more reasoning.
- Questions about current information (news, prices, latest versions) search the web before answering.
- Attached photos, screen recordings and documents (PDF, spreadsheets, slides) go straight to the right model.
- More accurate routing for small edits and learning questions.
v0.2.4
2026年10月29日
- 任务完成或失败时都会通知你,不只是长任务;简短的聊天回复不会打扰你。
- On macOS the notification shows the ZOREVA-UI fox icon and the project name, never full paths.
- New /notify on|off command to turn notifications on or off.
v0.2.3
2026年10月29日
- Skipping a question with Esc now ends the turn instead of repeating the answer and asking again.
- Markdown tables render as aligned boxes that wrap to the terminal width.
- The model picker lists upcoming models as Coming soon; they can't be selected yet.
v0.2.2
2026年10月29日
- Model picker no longer shows Auto twice; removed the offline sample from the list.
v0.2.1
2026年10月29日
- Auto mode uses far fewer credits for the same work.
- Semantic code search: the agent finds the right files by meaning, not just by exact words.
- Video understanding: attach a screen recording of a bug and the agent watches it to find the problem.
- Per-project instructions are generated automatically; the CLI also reads your AGENTS.md, CLAUDE.md and Cursor rules without modifying them.
v0.2.0
2026年10月29日
- Hooks: run your own scripts before and after the agent acts, set in ~/.zoreva/hooks.json or your project’s .zoreva/hooks.json; /hooks shows what is loaded.
- zoreva run works headless, so the agent can run from a GitHub Actions workflow in your repository.
- ZOREVA_API_KEY signs the CLI in with a CLI API key from your account, for CI and other headless use.
- When an API key reaches its monthly credit cap, zoreva run stops and exits with code 4.
v0.1.8
2026年10月26日
- 界面支持 zoreva-ui.com 的全部语言:英语、西班牙语、葡萄牙语、法语、德语、日语、韩语、简体中文、繁体中文和印地语。
- zoreva config language picks the interface language (for example, zoreva config language es).
- Skills, rule files and tools can be turned off in your config; turned-off rules match by their real path, and turned-off skills are skipped.
v0.1.7
2026年10月23日
- /credits 和模型列表仅显示点数:不显示 ZOREVA-UI Cloud 的内部按令牌价格或美元换算。
v0.1.6
2026年10月23日
- /undo 会还原上一轮 AI 修改的文件;每一轮都是一个检查点。
- 删除文件、用 git 推送、改写历史或安装软件包的命令总会询问:允许一次、在此项目中始终允许或拒绝。会话级的“始终允许”不再涵盖这些命令。
- 每次会话开始时都会读取 ZOREVA.md 作为项目规则;/init 会创建一个,/instructions 会列出已加载的内容。
- 输入 @ 可将文件附加到消息中,并根据项目文件自动补全。
- 每条回复都会显示消耗的点数,当你的 ZOREVA-UI 点数不足时会出现提醒。
- 网络故障会在短暂等待后自动重试;其他错误以通俗易懂的文字显示,而不是堆栈跟踪。
- 可选的匿名崩溃报告:默认关闭,崩溃后询问一次,或使用 /telemetry on 开启。报告绝不包含你的代码、提示词或文件内容。
v0.1.5
2026年10月23日
- 输入行位于两条细线之间,上下各留一行空白,空间更宽裕。
- 当面板打开时(update、model、help),顶部线条变为蓝色而不是另画一条线,关闭后恢复灰色。
- 计划模式(Shift+Tab)只读取你的项目、编写计划、询问“执行此计划?”,并且只有在你同意后才会执行。
- 每次文件编辑都会先显示 diff:接受、拒绝,或在本次会话剩余时间内接受所有编辑。
- zoreva -c 继续该文件夹中的上一次对话;zoreva -r 或 /resume 选择较早的对话。没有可继续的对话时,-c 会提示你。
- 智能体的提示词和内置技能现在来自 ZOREVA-UI 服务器,而不再随软件包附带,并有一个小型离线后备。
- npm 软件包是不带 source map 的单个压缩文件;独立二进制文件已压缩并预编译。
- CLI 依据 ZOREVA-UI CLI EULA 授权,可在 zoreva --help 和 /cli/eula 中找到链接。
- 非常旧的 CLI 版本现在会收到明确的更新提示,而不是直接失败。
v0.1.4
2026年10月22日
- 欢迎界面回来了:居中的 ZOREVA-UI 动画文字标志、带版本号的问候、每个版本的“新功能”一行、/keys 和 / 提示,以及 zoreva-ui.com 链接。
- 聊天中的 update 不再发送给 AI:输入 update、/update、zoreva update 或 zoreva-ui update 会当场检查版本,并告诉你要运行什么(zoreva update 或 npm i -g zoreva-ui@latest)。
- zoreva update 会安装到 CLI 所在的同一 npm 前缀(例如 ~/.npm-global),并使用 --prefer-online,避免停留在旧的缓存版本。助手知道软件包名称是 zoreva-ui。
- CLI 中所有地方的名称都写作 ZOREVA-UI:页眉、消息、终端标题和连接页面。
- 所有 CLI 消息均为英文:登录、退出、更新、沙盒提示和浏览器页面。
- /cli 上的全新终端插图。
v0.1.3
2026年10月22日
- zoreva update 和 /update:通过 npm 更新;如果你安装的是二进制文件,则会下载新版本并在替换前用 SHA256SUMS 校验。
- 有新版本时启动会提示(每天检查一次)。可用 NO_UPDATE_NOTIFIER、CI 或 ZOREVA_NO_UPDATE_CHECK 关闭。
- 适用于 macOS(arm64 和 x64)、Linux(x64 和 arm64)和 Windows x64 的免 Node 二进制文件。install.sh 将其放入 ~/.zoreva/bin,Windows 上使用 install.ps1;没有二进制文件时改用 npm。
- 在 Linux 上,命令在 bubblewrap 沙盒中运行(无网络,只能写入项目内部)。没有沙盒时(Windows,或没有 bwrap 的 Linux),除非你传入 --yes,否则每条命令都会请求许可。
- 安全性:login、logout 和 update 无法从智能体的 shell 中运行(B1);!command 经过同样的过滤(B2);只读 MCP 工具对每个服务器只请求一次许可(B3)。
- 在 Windows 上,命令使用 cmd.exe;测试在 Windows、macOS 和 Linux 上使用 Node 18、20 和 22 运行。
v0.1.2
2026年10月22日
- zoreva login 只使用浏览器,不再在终端中询问邮箱和密码。
- 无需同意页面:如果你已在网站上登录,终端会立即连接。
- 完成后,浏览器会在 zoreva-ui.com 上显示确认页面。
- 页眉显示你的系统(macOS、Windows 或 Linux),会话行已移除。
- 会话消息使用 CLI 的蓝色。
v0.1.1
2026年10月22日
- 安装的命令是 zoreva,页眉显示 Zoreva 字样。
- login 和 logout 不再在聊天中运行:它们在本地应答,不调用模型,也不消耗点数。
- 未登录时打开会显示入口界面:Enter 在浏览器中打开登录,Esc 退出。
- 浏览器登录不再将令牌放在 URL 中:它使用 PKCE 和一次性代码。
- zoreva -p 不要求会话,因此脚本可以继续运行。
v0.1.0
2026年10月22日
- 首次在 npm 发布(npm i -g zoreva-ui):一个基于 ZOREVA-UI 目录构建 SwiftUI 界面的终端聊天工具。
- 模型由 zoreva-ui.com 通过 我们的 AI 基础设施 提供:Claude Haiku、Sonnet 和 Opus、Qwen3 Coder、gpt-oss 和 Kimi。
- 使用你的 ZOREVA-UI 账号登录,用量按套餐点数计费。