release: v0.1.12

[lefarcen]

🎉 Highlights

• 🪟 Windows support is here — Nexu now officially supports Windows as a first-class desktop platform. Install, upgrade, local runtime, tray behavior, and SkillHub extraction all received a full stabilization pass. (chore: align windows desktop delivery with mainline #949, fix: Windows skillhub catalog extraction and skills UI polish #986, fix(desktop): improve Windows tray and local update UX #988, fix(desktop): stabilize Windows user data migration #1021, fix: hide Windows installer directory selection pages #1030, fix(desktop): retry when Windows installer finds running Nexu #1073) Thanks @PerishCode, @alchemistklk, @mrcfps, @lefarcen, and @Siri-Ray.
• ⚙️ Refined desktop settings & update experience — Settings align with the workspace design system, the update flow consolidates into a single entry with real background download progress, and the balance / account area got a visual polish pass. (feat: align desktop settings with workspace design #984, feat(desktop): background auto-download updates #1020, fix: update settings account and desktop dock behavior #1022, fix(desktop): keep a single update banner #1033, fix: improve desktop update failure recovery #1056) Thanks @Siri-Ray and @lefarcen.
• 🎬 Feishu video direct delivery — LibTV video delivery now runs through a detached background waiter, making long-running sends smoother and less likely to block the foreground experience. (feat(libtv-video): direct Feishu delivery via detached background waiter #973) Thanks @alchemistklk.
• 🔌 Channel reliability & diagnostics — Connect/disconnect flows surface clearer failure diagnostics with structured logging, and QQBot/DingTalk plugin packaging issues were fixed. (fix: repair plugin bundle dependency closure for qqbot #1001, chore: add structured logging to channel connect/disconnect flows #1003, fix: improve channel connect error diagnostics #1018, fix: preserve dingtalk bundled plugin dependencies #1037) Thanks @lefarcen and @Siri-Ray.
• 🆓 Zero-credit model access — Users with zero credits can now continue chatting via free models. The platform automatically routes zero-credit requests to a configurable fallback model, so new users and users who have used up their credits still get a working experience out of the box.

📥 Download now:

Platform	Architecture	Link
macOS	Apple Silicon	nexu-0.1.12-mac-arm64.dmg
macOS	Intel	nexu-0.1.12-mac-x64.dmg
Windows	x64	nexu-setup-0.1.12-win-x64.exe

✨ What's New

• 🪟 Windows desktop is now a first-class path — Packaging, user-data migration, local updates, tray behavior, and SkillHub catalog extraction all stabilized for daily Windows use. (chore: align windows desktop delivery with mainline #949, fix: Windows skillhub catalog extraction and skills UI polish #986, fix(desktop): improve Windows tray and local update UX #988, fix(desktop): stabilize Windows user data migration #1021, fix: hide Windows installer directory selection pages #1030)
• 🔄 Background auto-download with real progress — Updates download silently in the background; the settings page shows live progress when opened, and a single consolidated banner replaces the previous duplicate update UI. (feat(desktop): background auto-download updates #1020, fix(desktop): keep a single update banner #1033)
• 🧭 Desktop settings aligned with workspace design — Account area, shell preferences, and model picker brought in line with the workspace visual language. (feat: align desktop settings with workspace design #984, fix: update settings account and desktop dock behavior #1022, fix: align settings model picker and analytics default #1034)
• 💳 Credits & balance polish — Gifted credits now appear in the sidebar balance popup, and the popup renders via portal to fix clipping issues. (fix: show gifted credits in sidebar balance popup #985, fix(web): render balance popup via portal to fix sidebar clipping #990)
• 🎥 Feishu video hardening — Long-running video delivery no longer blocks foreground flows. (feat(libtv-video): direct Feishu delivery via detached background waiter #973)
• 🆓 Zero-credit model fallback — Zero-cost models bypass credit rejection; when credits are exhausted, requests automatically route to a free fallback model instead of failing.

🛡️ Stability & Reliability

• 🔁 Windows migration hardening — User-data path handling and migration logic stabilized to reduce upgrade regressions. (fix(desktop): stabilize Windows user data migration #1021)
• 🧰 Installer safety — Windows installer directory-selection pages hidden to prevent install-path-related data loss. Windows installer now retries gracefully when a running Nexu instance is detected. (fix: hide Windows installer directory selection pages #1030, fix(desktop): retry when Windows installer finds running Nexu #1073)
• 🔧 OpenClaw config determinism — Skill lists and config serialization sorted deterministically, eliminating unnecessary runtime reloads from key reordering. (fix(desktop): keep a single update banner #1033)
• ⚡ Skill install sync batching — Batch skill installs now trigger a single OpenClaw config sync instead of one per skill, eliminating the restart loop that left the agent stuck on "starting" during initial bootstrap. (fix(controller): batch skillhub sync to prevent OpenClaw restart loop #1074)
• 🧠 Structured channel diagnostics — All channel connect/disconnect flows now produce structured logs for easier production tracing. (chore: add structured logging to channel connect/disconnect flows #1003, fix: improve channel connect error diagnostics #1018)
• 💬 WeChat runtime fixes — Fixed prewarm drain behavior and raw ID session title issues. (fix(controller): fix WeChat prewarm drain and raw ID session titles #972)
• 🛎️ Desktop shell polish — Improved Windows tray behavior, Mac sidebar toggle positioning, and renderer background keepalive. (fix(desktop): improve Windows tray and local update UX #988, fix(web): fix Mac sidebar toggle overlapping traffic lights #1002, fix(desktop): keep renderer running in background + faster balance polling #958)
• 🔄 Desktop update failure recovery — Auto-updater now recovers gracefully from interrupted downloads and failed installs. (fix: improve desktop update failure recovery #1056)

🐛 Bug Fixes

• Fixed QQBot and DingTalk plugin bundle dependency closures in packaged builds. (fix: repair plugin bundle dependency closure for qqbot #1001, fix: preserve dingtalk bundled plugin dependencies #1037)
• Fixed controller overwriting agent-edited platform docs. (fix(controller): never overwrite agent-edited platform docs on channel connect #999)
• Fixed dev controller startup wait and platform template injection. (fix(dev): inject PLATFORM_TEMPLATES_DIR and harden controller startup wait #971)
• Preserved full X share copy and repo URL. (fix: preserve full X share copy and repo url #975)
• Aligned settings model picker and analytics defaults. (fix: align settings model picker and analytics default #1034)
• Fixed desktop account area and dock behavior. (fix: update settings account and desktop dock behavior #1022)
• Fixed missing i18n translations for Home and Conversation pages. (fix: add missing i18n translations for Home and Conversation pages #1049)
• Fixed welcome locale switching and added channel setup diagnostics. (fix: restore welcome locale switching and add channel setup diagnostics #1054)
• Added logout confirmation dialogs in settings. (fix: add logout confirmation dialogs in settings #1069)

📚 Documentation

• Added Korean localization for README and docs site. (docs: add Korean (한국어) localization #998) Thanks @qiongyu1999.
• Added model credit consumption guide in zh/en/ja. (docs: add model credit consumption guide (zh/en/ja) #978) Thanks @qiongyu1999.
• Updated Feishu app permissions with expanded user scopes. (docs: update Feishu app permissions with expanded user scopes #997)
• Added EN & JA translations for first-pr and contributor-rewards guides. (docs: add EN & JA translations for Good First Issue contributor guides #1043) Thanks @caiqiling958-cmd.
• Added WeChat contributor group QR code and i18n contributor sections. (docs: add WeChat contributor group QR code to guide pages #1042, docs: add i18n contributor recruitment & appreciation sections #1038, docs: restore Chinese README contributing section #1036, docs: improve contributor onboarding entry points #1032) Thanks @caiqiling958-cmd.
• Added Windows installation guide (zh/en/ja/ko). (docs: add Windows installation guide (zh/en/ja/ko) #1039)
• Rewrote README (en/zh/ja/ko). (docs: rewrite README (en/zh/ja/ko) and remove Windows beta guide #1040)

🔨 For Developers

Click to expand

• 📊 Fixed PostHog analytics identity and desktop metadata propagation. (chore: fix PostHog analytics identity and desktop metadata #960) Thanks @mrcfps.
• 🏅 Added Vaunt contributor achievement configuration. (chore: add Vaunt contributor achievement configuration #1015) Thanks @qiongyu1999.
• 🔧 Added temporary Langfuse tracing passthrough. (chore: add temporary langfuse tracing passthrough #1019)
• 🪟 Aligned Windows desktop delivery pipeline with mainline. (chore: align windows desktop delivery with mainline #949) Thanks @PerishCode.

Full Changelog: v0.1.11...release/v0.1.12

[sentry]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[cloudflare-workers-and-pages]

Deploying nexu-docs with    Cloudflare Pages

Latest commit:	775ac30
Status:	✅  Deploy successful!
Preview URL:	https://7ad89718.nexu-docs.pages.dev
Branch Preview URL:	https://release-v0-1-12.nexu-docs.pages.dev

View logs