ZOREVA-UI CLI

在终端中构建应用。

提出需要的界面、着色器或主题。CLI 借助 ZOREVA-UI 目录在你的 SwiftUI 或 Android 项目中规划、编辑和运行命令,展示每个 diff,并在任何高风险操作前询问。

安装选项

macOS 和 Linux。Windows 和 npm 见下方。

安装

每个平台一条命令。

Windows

在 PowerShell 中运行。安装独立的 Windows x64 二进制文件。无需 Node.js。

$ irm https://zoreva-ui.com/install.ps1 | iex

npm

可在任何装有 Node.js 18 或更高版本的平台上使用的替代方式。安装的命令是 zoreva。

$ npm i -g zoreva-ui

然后运行 zoreva ,然后在浏览器中用你的 ZOREVA-UI 账户登录(邮箱验证码、Google 或 GitHub)。专有软件:安装即表示你接受 CLI 许可(EULA).

规划模式

在任何改动之前审查计划。

按 Shift+Tab 或以 --plan 启动。代理只会读取你的项目、写出计划并询问“按此计划构建吗?”。在你同意之前不会写入任何内容。

zoreva
ZOREVA-UI CLI 显示计划并询问是否构建
02

Diff 与 /undo

每次编辑都会先显示 diff。

接受、拒绝或在本次会话余下时间全部接受修改。每个提示词都是一个检查点:/undo 还原上一个提示词修改的文件,/rewind 可以回退更多。

03

权限与沙箱

高风险命令总是会询问。

删除文件、git push、改写历史或安装软件包每次都会询问:仅允许一次、在此项目中始终允许,或拒绝。/sandbox 让 AI 的命令在无网络、仅能写入项目内的环境中运行(Linux 上使用 bubblewrap)。

04

ZOREVA.md 与 @ 提及

你的项目规则,每次会话都会加载。

ZOREVA.md 和 .zoreva/rules 会在每次会话开始时读取;/init 可创建一个。输入 @ 即可附加文件,并从你的项目中自动补全。

05

继续与恢复

从上次中断的地方继续。

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

模式与设置

  • /mode

    build、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 图标尺寸

  • /precheck

    App Review 或 Google Play 可能指出的问题

  • /logs

    流式查看应用日志,最近的崩溃优先

Git 与工具

  • /diff

    自上次提交以来的变更

  • /commit

    使用建议的提交信息提交

  • /pr

    使用 gh 或 glab 创建拉取请求

  • /bg

    在后台运行命令

  • /mcp

    MCP 服务器及其状态和工具

  • /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 查看所有选项。

更新日志

频繁发布。

  1. v0.2.7

    2026年10月31日

    • Auto is smarter: better choices, especially in Spanish.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. v0.2.2

    2026年10月29日

    • Model picker no longer shows Auto twice; removed the offline sample from the list.
  7. 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.
  8. 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.
  9. 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.
  10. v0.1.7

    2026年10月23日

    • /credits 和模型列表仅显示点数:不显示 ZOREVA-UI Cloud 的内部按令牌价格或美元换算。
  11. v0.1.6

    2026年10月23日

    • /undo 会还原上一轮 AI 修改的文件;每一轮都是一个检查点。
    • 删除文件、用 git 推送、改写历史或安装软件包的命令总会询问:允许一次、在此项目中始终允许或拒绝。会话级的“始终允许”不再涵盖这些命令。
    • 每次会话开始时都会读取 ZOREVA.md 作为项目规则;/init 会创建一个,/instructions 会列出已加载的内容。
    • 输入 @ 可将文件附加到消息中,并根据项目文件自动补全。
    • 每条回复都会显示消耗的点数,当你的 ZOREVA-UI 点数不足时会出现提醒。
    • 网络故障会在短暂等待后自动重试;其他错误以通俗易懂的文字显示,而不是堆栈跟踪。
    • 可选的匿名崩溃报告:默认关闭,崩溃后询问一次,或使用 /telemetry on 开启。报告绝不包含你的代码、提示词或文件内容。
  12. 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 版本现在会收到明确的更新提示,而不是直接失败。
  13. 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 上的全新终端插图。
  14. 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 运行。
  15. v0.1.2

    2026年10月22日

    • zoreva login 只使用浏览器,不再在终端中询问邮箱和密码。
    • 无需同意页面:如果你已在网站上登录,终端会立即连接。
    • 完成后,浏览器会在 zoreva-ui.com 上显示确认页面。
    • 页眉显示你的系统(macOS、Windows 或 Linux),会话行已移除。
    • 会话消息使用 CLI 的蓝色。
  16. v0.1.1

    2026年10月22日

    • 安装的命令是 zoreva,页眉显示 Zoreva 字样。
    • login 和 logout 不再在聊天中运行:它们在本地应答,不调用模型,也不消耗点数。
    • 未登录时打开会显示入口界面:Enter 在浏览器中打开登录,Esc 退出。
    • 浏览器登录不再将令牌放在 URL 中:它使用 PKCE 和一次性代码。
    • zoreva -p 不要求会话,因此脚本可以继续运行。
  17. 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 账号登录,用量按套餐点数计费。
更新日志 →