Repository navigation
Releases
Versora 0.3.1
Versora 0.3.1 replaces in-app system dropdowns and hover hints with shared custom controls styled to match Litora.
- Custom lists support filtering, small-list typeahead, keyboard navigation, disabled options, focus restoration and bounded scrolling. Menus stay within the window and follow the selected theme.
- Shared hover and keyboard-focus hints use consistent timing and placement, without duplicate native title bubbles. Reduced-motion preferences are respected.
- A fixed 2 px loading strip below the titlebar reports native translation/update progress across pages without shifting the layout.
- Source-mode controls remain in place during animation; rapid clicks settle on the last selection with stable button widths and reduced-motion support.
- Mode icons and labels use consistent spacing and vertical alignment.
Download Versora-0.3.1-win32-x64-setup.exe and run it. Windows 10/11 x64 and an existing Microsoft Evergreen WebView2 Runtime are required. The installer is per-user and preserves application data and unknown files. The separate .sig uses the existing updater trust key; the installer has no Authenticode signature.
Source: 212f3e0a23d2d06b25d09216dc955553f7f6c48c, based on the accepted native branch with merged PR5/PR6/PR7. PR4 remains a separate, unmerged pull request.
Validation: 165 local Rust tests, 7 Node progress tests and 56 frozen UI/font files; actual Tauri/WebView2 controls with 140 private projects, repeated opening, eight theme/window combinations, page-scale stress and reduced motion; the real offline Demo pipeline and cancellation; isolated Windows install/upgrade/uninstall with DPAPI, unknown-file and junction preservation. The app's own verifier accepts the signed installer and rejects a mismatched version. GitHub CI also passed, including the Windows update handoff.
Limits: live paid API/provider compatibility, real CLI translation/model quality and live CLI process-tree cancellation remain unverified. Controlled native process-tree regression tests pass. Complete CLI tool isolation is not certified: Codex may retain shell tools/inherited MCP configuration and Grok home isolation remains incomplete. Cancellation cannot recall requests already accepted by an external provider. No clean-VM certification or automatic post-update rollback is provided.
Versora 0.3.0
$notesFile = Join-Path $env:TEMP 'versora-0.3.0-notes.md'
[IO.File]::WriteAllText($notesFile, $notes.Trim() + "n", [Text.UTF8Encoding]::new($false)) gh release create v0.3.0 -R mimateinn/Versora --verify-tag --latest
--title "Versora 0.3.0" --notes-file $notesFile "$out\Versora-0.3.0-win32-x64-setup.exe"
"$out\Versora-0.3.0-win32-x64-setup.exe.sig" `
"$out\SHA256SUMS.txt"
5. The tag push also starts .github/workflows/versora-release.yml. Cancel it: it would
rebuild and fail at signing (no secrets) or at "gh release create" (release exists).
gh run list -R mimateinn/Versora --workflow versora-release.yml --limit 1
gh run cancel -R mimateinn/Versora
6. Check what the updater will see.
gh api repos/mimateinn/Versora/releases/tags/v0.3.0 --jq '.draft, .prerelease, .html_url, (.assets[] | .name + " " + .state + " " + .browser_download_url)'
Alternative (CI builds and signs instead of this PC): set repo secrets `TAURI_SIGNING_PRIVATE_KEY`
and `TAURI_SIGNING_PRIVATE_KEY_PASSWORD`, do steps 1-3 with the release notes as the annotated tag
message, skip 4-5. The CI installer will have a different digest from the local one.
## Release notes (zh-Hant; also shown in the app as 「有咩新」)
<!-- notes-begin -->
Versora 0.3.0 係第一個正式版原生 Windows 桌面版,亦係第一個識自己更新嘅版本。
介面同 Litora 統一:得返「標準」同「Opal」兩個主題,Opal 用 Litora 嘅畫布同玻璃質感;頁面導航改用角落圓幣;捲軸跟強調色。
自動更新:開 app 大約 10 秒後檢查一次,之後每 4 小時再查。有新版就喺背景下載安裝程式,用 Versora 內建嘅發行者公鑰驗證簽名,驗證通過先會喺右下角顯示「新版本 X · 重新啟動」。撳一下就靜默安裝並重開;撳 × 收埋,下次關 app 時先安裝。翻譯進行中或者有未儲存嘅修改,重新啟動前會先問。更新後第一次開會顯示「已更新到 X」同「有咩新」。設定 › 更新 可以睇狀態、進度、更新內容,同改自動下載、頻道同檢查時間。
由 0.3.0-preview.1 升級:舊版未有公鑰,只會通知有新版並開發佈頁。請手動下載安裝呢個版本一次,之後嘅版本會自動更新。
下載 Versora-0.3.0-win32-x64-setup.exe 同 SHA256SUMS.txt。.sig 檔係 app 內更新用嘅簽名,唔使手動下載。需要 Windows 10/11 x64 同已安裝嘅 Evergreen WebView2 Runtime。安裝位置係 %LOCALAPPDATA%\Programs\Versora;升級同解除安裝都會保留應用資料、輸出同不明檔案。
驗證:
- Rust workspace 測試 165 個通過、0 個失敗、1 個子進程 helper 略過;更新策略測試 32 個全部通過。
- 安裝程式嘅簽名用 app 自己嘅驗證程式碼同已提交嘅公鑰驗證通過;改用錯誤版本號驗證會被拒絕。
- UI 原始碼凍結清單 53 個檔案全部吻合。
目前限制:
- 安裝程式冇 Authenticode 簽署,Windows SmartScreen 可能會警告。
- 冇自動回滾;更新失敗時安裝程式會還原舊版。
- 付費 API、已登入 CLI 嘅真實翻譯同模型質素未測試(NOT_RUN)。
- 呢個版本喺本機未做原生 UI 回歸同安裝/更新交接測試;/UPDATE 同 /RELAUNCH 交接只喺 CI 驗證過。
安裝程式:73,612,908 bytes。SHA-256:b911697a6015258791350a5bd68359ec94ab1548d407a324c86b3fd758d91615
Versora 0.3.0-preview.1 - Native Windows desktop
Versora opens as a native Windows desktop application. Rust implements translation, file handling, providers, settings and credentials; Tauri hosts bundled local interface files in WebView2. The installed application needs no Python, Node.js or application HTTP server.
This unsigned Windows x64 prerelease uses the unmerged PR4 interface and the native desktop branch. PR4 remains open; this preview does not merge or accept it. Source: 6d5f8dce7927ccdc71bb2cdd96c0cec7d27680e0, branch feat/rust-desktop.
Download Versora-0.3.0-preview.1-win32-x64-setup.exe and SHA256SUMS.txt. Windows 10/11 x64 and an existing Evergreen WebView2 Runtime are required. Installation uses the current account's %LOCALAPPDATA%\Programs\Versora directory and creates a Start Menu shortcut. No runtime download or file association is installed. Upgrade/uninstall preserve application data, WebView cache, outputs and unknown files.
The integrated 48-pixel titlebar provides native minimize, maximize/restore, close, blank-area dragging, double-click maximize/restore and eight resize directions. Closing retains the Rust unsaved-edit confirmation and active-job/persistence guard. The fixed footer shows the actual application version. Capsule scrollbars, theme transitions, route/selection motion and dialogs follow the applicable Litora styling, with reduced-motion behavior and stable content/action gutters. Theme changes preserve drafts, focus and caret; route changes during a transition preserve the destination pane's controls.
CLI status distinguishes executable detection, sign-in metadata, eligibility to attempt a request and recent verified transport. The first Translators visit performs one safe metadata probe; Recheck repeats that probe explicitly. A detected or signed-in CLI does not establish that the chosen model/backend works. Only a successful explicit transport test earns verified status; that test can consume provider quota.
Ordinary Latin UI text uses locally bundled official Libron v0.25 Regular/Bold/Italic/Bold Italic faces with original license/copyright notices. Headings and branding retain Litora's separate Poppins, Space Grotesk, Noto Sans TC, system-ui, sans-serif stack. Poppins is preferred when available, without a new download or bundled substitution; actual offline Noto Sans TC fallback is verified on this host. CJK fallback, monospace and document fonts remain separate. Changed PDFs embed Noto Sans CJK TC 2.004.
Validation:
- Offline/locked Rust workspace: 146 passed, zero failures, one child-process helper ignored when invoked directly. The final UI-only changes leave tested Rust/dependency inputs unchanged. CSV/TSV/YAML have 20 focused cases and PDF has eight, including actual Poppler rendering.
- Twenty-two actual native titlebar/interaction checks passed, including eight resize directions, retained-theme drafts/race, dialogs and unsaved Close Cancel behavior. The focused lifecycle recording confirmed OK exits with code zero, destroys the owned window and closes all causally owned WebView processes normally.
- The finalized EXE passed 168 actual native font/layout checks across 12 languages, seven pages and both themes at 800 logical pixels and 150% Windows scaling. Actual owned-window thumb hover, active press and drag changed the scroll position in both themes; full native captures preserve those states.
- Actual installed CSV/TSV/YAML/PDF batch writeback passed with explicitly tagged offline Demo. All four outputs were saved; originals, record framing, numbers and boolean values remained intact. The final isolated installation/uninstallation and cleanup verification passed.
- Fresh absent-directory installation, shortcut working directory, same-install upgrade, running-EXE/reparse refusal, uninstall and unknown-file/DPAPI/output preservation passed with unchanged installer logic. This final Production upgrade exited normally and preserved all 384 default owner-data/cache/unknown-entry/shortcut snapshot entries exactly. The formal native shortcut opened the installed final EXE with standard profiles, without Demo or remote debugging. Its actual startup PNG is attached.
- Both final packages match their fourteen-file allowlists and checksums. The package includes corresponding original sources for 346 locked dependencies and actual notices/fonts/licenses. No user documents, credentials, private settings, profiles or translation caches are packaged.
Current limits:
- Paid/live API compatibility, signed-in CLI translation and model quality are NOT_RUN. Offline Demo is explicitly tagged test output, not real translation. CLI sign-in metadata is not a transport or selected-model certificate.
- Controlled native child/grandchild cancellation passes. Complete CLI tool isolation remains unverified: Codex retains shell/MCP configuration; Grok home isolation is not implemented. Cancel cannot recall requests accepted by external providers, and parsing/writeback can finish before cancellation is observed.
- CSV/TSV preserve unchanged record bytes and enforce an 80 MB output cap. YAML supports a bounded YAML 1.2 subset and i64 integers, rejects unsupported ambiguous scalar spellings/custom or merge tags, and can normalize comments, quoting and anchors when changed. Validated keys/non-string types are retained.
- Structured-text extraction is conservative: identifier-like values, URLs, filenames and numbers may remain unchanged. Files with no selected text can be saved byte-for-byte without contacting a translator. Review single-word labels/game strings.
- PDF output is extractable-text reflow onto A4, without OCR or original layout, graphics, annotations or forms. Decrypt encrypted documents first. Missing glyphs report an error. Each changed PDF includes the full approximately 16.4 MB font; arbitrary script shaping and decompression/parser memory ceilings are not certified.
- Finished ZIP export is limited to 80 MB combined output and an 84 MB archive. Five small changed PDFs can exceed the combined cap because each carries its font; individual saved files remain available.
- CLI paths must identify native executables, not
.cmd/.batshims. API custom URLs require the public HTTPS host allowlist. - Updates can check metadata and open official downloads. Automatic download/install/rollback remains disabled pending publisher trust and a reviewed recovery adapter. SHA-256 verifies integrity, not publisher identity.
- Actual native checks use this Windows host at 150% scaling and 100% application zoom. 125% scaling, native 200%/300% application zoom, a clean Windows VM, other operating systems, comprehensive screen-reader behavior and caption Snap-layout hover are NOT_RUN. No global display/zoom settings or window permissions were expanded for those checks.
Historical browser preview v0.2.0-preview.1 and stable v0.1.1 remain unchanged. Application licensing is not inferred from dependency licenses; original third-party notices and corresponding sources accompany the installer.
Installer: 73,481,438 bytes. SHA-256: 8743c297f2c46a8ca8af18f0ca00047a426d9a4dccbac7813f2bd6cbd44bb6b1.
Versora v0.2.0-preview.1 - Browser preview
Versora v0.2 Windows portable preview
Download Versora-v0.2.0-preview.1-Windows-x64.zip, extract the entire archive into a writable folder, then double-click start.bat. Python 3.11.15 and dependencies are bundled; no Python or package installation is required. This is an unsigned Windows x64 portable folder, not an installer.
The browser opens the local app. Keep the starter window open; press Ctrl+C there to stop it. The server binds only to 127.0.0.1 and chooses an available port. Your credentials remain in .env, settings/glossaries in projects/, custom purposes in data/prompts/, and translations in data/outputs/ inside the extracted folder.
Source
This prerelease contains the owner-selected latest UI and engine from unmerged PR #4: 79af2e7. The PR remains unmerged. The merged README branding and related-app icons from 4f8141d are preserved as documented package overlays. No product code was changed for packaging.
BUILD-INFO.json, BUNDLED-VERSIONS.txt and FILES.sha256 identify the exact source and bundled files. Anthropic is pinned to the existing cached 0.76.0 SDK because installed 1.11.0 rejects this source's httpx.Client; the pinned client passed offline construction and dependency checks. OpenAI 3.24.0 and Streamlit 1.65.0 are bundled. Python and third-party licenses are included.
Executed validation
- Frozen PR4 repository suite against the bundled dependency set: 85 passed, 64 warnings. The warnings concern deprecated
locale.getdefaultlocale. - All bundled dependency constraints and offline OpenAI/Anthropic client construction passed; no provider requests were made.
- Actual extracted Windows package and bundled
start.bat: startup/loopback health, file selection, missing-provider guard, all five Settings panes in light, plus Appearance in dark passed. - Opt-in offline Demo: file export, real Chromium download equality (native artifact = SDK copy = 40-byte disk output), and Cancel restoring controls passed. Demo tags text with the target language; it does not translate.
- A Windows shortcut with the official Versora icon launched the identical local build successfully.
- ZIP CRC, per-file manifest and privacy audit passed. No developer
.env, user documents, private settings, project glossaries, translated outputs, caches, tokens, Git metadata or virtualenv were packaged.
Known limits
- Live API/CLI translation, paid-provider compatibility, model quality and real CLI process-tree cancellation were not tested. Bring your own credentials or compatible, installed and signed-in CLI. No credentials or CLI binaries are bundled.
- Codex's read-only preset still permits shell tools and inherited MCP configuration. The original translation-only/no-tool-access requirement remains unsatisfied; this is the known Medium baseline boundary, not a claimed fix. No disclosure/exploitation test was performed.
- Grok TOML-isolated
GROK_HOMEsupport is not ported. Existing deny flags/temp working directory do not certify complete isolation. - Cancellation may wait for synchronous HTTP timeouts (120 seconds per phase) or local extraction/writing. Immediate abort and live process-tree cleanup are not certified.
- Saved API keys are plaintext in local
.env. Comprehensive accessibility, all locales/viewports and universal DOCX/PDF/other-format fidelity are not certified. - Automatic updates are not verified for this portable preview. Its starter does not apply updates. The inherited in-app updater skips prereleases and lacks a version-ordering guard, so it can replace the preview with an older stable source release. Avoid that button and obtain future verified packages from this repository's Releases page. The separately requested unified updater is not included or claimed complete here.
Integrity
ZIP size: 105,364,259 bytes.
SHA256:
b17f8b65062db35f54bb2e0a1f64df5cfb2cc88954992075cfc0263ca1737d86
The attached SHA256SUMS.txt records the same checksum. Versora-launch-Windows.png shows the actual packaged Windows startup screen with Demo disabled.
Smart File Translation System v0.1.1
Smart File Translation System
Translate files on your own computer. Drop one file, a folder, or a zip — you get a matching translated file for each input, in the same folder shape.
What it does
It reads txt, md, docx, pdf, json, csv, tsv, yaml, po, xliff, xlsx, html, srt, and vtt. Game-text mode changes only the words players see. A glossary keeps important terms consistent later.
The screen comes in 12 languages, light or dark. You pick the model. Folder and zip jobs can run 1–8 files at a time (default 2). Finished files go to data/outputs/, and you can download them in the browser.
It uses official developer APIs (OpenAI, Anthropic, Gemini, xAI, and others). If the official Grok CLI or Codex CLI is already installed and signed in on this computer, you can use those too. Chat websites are not supported.
You can check for official updates in the app, or just start it — at most once a day.
How to use
- Download this folder from GitHub (green Code button → Download ZIP) and unzip it.
- On Windows, double-click
start.bat. On Mac or Linux, run./start.shfrom this folder. - Wait for the browser. The first start can take a few minutes. The starter installs what it needs and opens the app. An existing
.envis left alone. - If it asks for a key, put the key in
.envin this folder, save, and start again.
Keys stay here
Keys live only in a local .env. The repository has no secrets. For extra options later, add them in that same file.
Updates
v0.1.1
- One-click start:
start.bat(Windows) andstart.sh(Mac / Linux). - Folder and zip jobs write one output per input file, same folder shape.
- More types: json, csv, tsv, yaml, po, xliff, xlsx, html, srt, vtt.
- Game-text mode, plus a glossary for consistent terms.
- Official developer APIs only. Optional official Grok CLI / Codex CLI if already installed and signed in. No chat websites.
- Pick a model. Folder and zip jobs can run 1–8 files at a time (default 2).
- Official-package updates from the app or on start (at most once a day).
- Settings: Translate / Settings tabs, Appearance / Translation / Keys / Glossary, light and dark.
v0.1.0
- First public version.
智能檔案翻譯系統
在你自己的電腦上翻譯檔案。丟一個檔案、整個資料夾,或一個 zip——每個輸入檔都會得到對應的譯文,資料夾形狀相同。
能做什麼
支援 txt、md、docx、pdf、json、csv、tsv、yaml、po、xliff、xlsx、html、srt、vtt。遊戲文字模式只改玩家會看到的字。用語表讓重要用詞之後保持一致。
畫面有 12 種語言,淺色或深色。可選模型。資料夾/zip 一次可跑 1–8 個檔(預設 2)。譯文在 data/outputs/,也可以在瀏覽器下載。
用官方開發者 API(OpenAI、Anthropic、Gemini、xAI 等)。如果這台電腦已安裝並已登入官方 Grok CLI 或 Codex CLI,也可以用。不支援聊天網站。
可在程式裡檢查官方更新,或直接啟動——一天最多查一次。
怎麼用
- 從 GitHub 下載這個資料夾(綠色 Code 按鈕 → Download ZIP),解壓縮。
- Windows:連按兩下
start.bat。Mac 或 Linux:在這個資料夾執行./start.sh。 - 等瀏覽器打開。第一次可能要幾分鐘。啟動檔會裝好需要的東西並打開程式。已有的
.env不會被覆蓋。 - 如果要你填金鑰,把金鑰寫進這個資料夾的
.env,存檔後再啟動一次。
金鑰留在這台電腦
金鑰只放本機 .env,倉庫不含密鑰。之後要改更多選項,寫在同一個檔就好。
智能檔案翻譯系統 v0.1.0
首次公開投放。本機 Streamlit 介面,支援 txt/md/docx/pdf 翻譯、OpenAI 相容與 Anthropic 雙路由、專案用語表,以及 12 種介面語言(預設繁體中文)。金鑰只放本機 .env,倉庫不含密鑰。聯絡:laevataincheng@gmail.com