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