Files
2026-07-13 13:12:33 +08:00

5.2 KiB

OpenSquilla 0.4.1

Overview

OpenSquilla 0.4.1 is a maintenance release for the 0.4 desktop and Control UI line. It focuses on packaged desktop reliability, Web UI recovery, Coding mode and SquillaRouter packaging, installer telemetry accuracy, and the project move to main as the active development branch.

Existing gateway configuration and session data stay in place. Users upgrading from 0.4.0 should close any running desktop app or gateway process, install the 0.4.1 package, and restart OpenSquilla.

What's Improved

🖥️ Desktop and Coding mode reliability

The desktop package now fails fast when SquillaRouter model assets are missing or still Git LFS pointer files, and packaged gateway smoke checks cover code-task, Coding mode support, and router startup before release assets are published. Windows desktop cleanup wording and active-window reload behavior are also tightened.

🌐 Multilingual Control UI and client

The Control UI and desktop client now support English, Simplified Chinese, Japanese, French, German, and Spanish across first-paint desktop boot text, settings surfaces, connection state, and persisted language selection.

🧰 Telemetry, icons, and user-facing polish

Install telemetry now skips GitHub Actions, pytest, and explicit test environments before creating telemetry state or uploading events. The Windows Electron app, installer, and uninstaller use the OpenSquilla logo. Web UI fixes improve streaming recovery, stale task isolation, settings restore behavior, session deletion, topbar layout, status line breaks, and HTML artifact opening from the desktop app.

Non-user-initiated network observability can be disabled before startup with OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY=true or:

[privacy]
disable_network_observability = true

That unified switch covers automatic install telemetry, passive update checks, and desktop startup auto-update checks. The legacy compatibility environment variables OPENSQUILLA_TELEMETRY_DISABLED=true and OPENSQUILLA_UPDATE_CHECK_DISABLED=true remain honored; manual user-initiated release, download, or update checks may still contact GitHub after user intent.

🧭 Providers, router labels, and mainline governance

Provider profile fixes cover Volcengine and BytePlus, macOS router runtime diagnostics are clearer, and model request logs expose router target labels. OpenSquilla now treats main as the ordinary development and integration branch; maintainer collaboration branches remain available for release, hotfix, staging, integration, and sandbox work.

Downloads

🖥️ Recommended desktop downloads:

  • macOS desktop installer: OpenSquilla-0.4.1-mac-arm64.dmg
  • macOS desktop zip: OpenSquilla-0.4.1-mac-arm64.zip
  • Windows desktop installer: OpenSquilla-0.4.1-win-x64.exe

Code signing policy: docs/code-signing-policy.md.

⚙️ Terminal and automation downloads:

  • Python wheel: opensquilla-0.4.1-py3-none-any.whl
  • Checksums: SHA256SUMS

🧳 Legacy compatibility downloads:

  • Legacy Windows portable, versioned: OpenSquilla-0.4.1-windows-x64-py312-recommended-portable.zip
  • Legacy Windows portable, stable alias: OpenSquilla-windows-x64-portable.zip

The legacy Windows portable assets remain available as legacy compatibility downloads for existing scripts and portable-folder workflows. New Windows desktop users should prefer OpenSquilla-0.4.1-win-x64.exe.

Privacy and third-party attribution are documented in PRIVACY.md and THIRD_PARTY_NOTICES.md.

🔄 Updater metadata:

  • latest-mac.yml
  • latest.yml
  • *.blockmap

Upgrading from 0.4.0

If OpenSquilla was installed with uv tool install, reinstall 0.4.1 over the existing tool environment:

uv tool install --python 3.12 --force --reinstall-package opensquilla \
  "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.4.1/opensquilla-0.4.1-py3-none-any.whl"

The release installers use the same forced reinstall path. Close any running OpenSquilla gateway or desktop app before upgrading, then restart it after the install. Existing ~/.opensquilla/config.toml and session data are reused.

Desktop users should quit the running desktop app before replacing it. macOS users install the .dmg by dragging OpenSquilla into Applications. Windows users run the .exe installer.

Legacy Windows portable users should extract the 0.4.1 portable zip to a fresh folder, or replace the whole extracted 0.4.0 folder while the gateway is stopped. Do not copy only individual files from the new zip into an old portable tree.

Acknowledgements

Thanks to the contributors whose pull-request work is newly present in the 0.4.1 release surface:

  • @ab2ence for install telemetry CI/test environment skipping and desktop HTML artifact native-open support.

See CONTRIBUTORS.md for the full attribution ledger and PR evidence.