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 賬號登入,用量按套餐點數計費。
更新日誌 →