# cherry-studio v2.0.12

- Product: cherry-studio (https://whatsnew.fyi/product/cherry-studio)
- Vendor: cherry-studio
- Date: 2026-09-04
- Version: v2.0.12
- Original notes: https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.12
- Permalink: https://whatsnew.fyi/product/cherry-studio/releases/v2.0.12

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Settings gains a sidebar search to find any setting row across all sections including title, description, aliases, and Chinese pinyin, with scroll, highlight, and full keyboard navigation
- **added** — Settings search now covers all sections with static settings rows, including MCP tabs
- **added** — Translate model now has its own temperature, top-p, and reasoning effort settings, editable from the translation settings panel and translate page toolbar
- **changed** — Markdown previews outside chat now use the same rich renderer as chat messages
- **added** — In agent session messages and rendered artifact Markdown previews, workspace links open files in the artifact pane and directories in the system file manager, with relative links resolving from the agent workspace root
- **fixed** — Cherry Cloud models now honor server-declared capabilities and support configured OpenAI Chat Completions routes
- **fixed** — Cherry Cloud models remain compatible with older model-list responses
- **changed** — Message token details now show time to first token without requiring the expanded runtime breakdown
- **fixed** — Preserve partial chat responses and show a clear, retryable error when a provider stream ends without a finish reason
- **fixed** — Fix middle-click autoscroll scrolling in the chat message list to no longer vibrate or jump
- **changed** — Sent image attachments now appear as compact filename chips with real image thumbnails, including after reopening a conversation
- **fixed** — Model health check results no longer linger after leaving the provider page
- **fixed** — Allow grep searches in Filesystem MCP to use regular expression syntax supported by ripgrep
- **fixed** — Empty knowledge bases now appear in the knowledge list
- **fixed** — Prevent fraction denominators from being clipped when exporting conversations as images
- **fixed** — Prevent the OpenClaw gateway from failing to start when Cherry Studio uses a socks5 proxy
- **fixed** — Web fetch no longer sends localhost, LAN, or locally-unresolvable URLs to Jina Reader when the built-in fetch fails
- **fixed** — Pinned topics and agent sessions now keep their text aligned with unpinned items in owner-grouped lists

##### Downloads / 下载 (v2.0.12)

| Platform | Architecture | Global | China Edition |
| --- | --- | --- | --- |
| Windows | x64 | [Installer](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-win-x64-setup.exe) · [Portable](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-win-x64-portable.exe) | [Installer](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-win-x64-setup.exe) · [Portable](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-win-x64-portable.exe) |
| Windows | arm64 | [Installer](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-win-arm64-setup.exe) · [Portable](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-win-arm64-portable.exe) | [Installer](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-win-arm64-setup.exe) · [Portable](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-win-arm64-portable.exe) |
| macOS | x64 | [DMG](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-mac-x64.dmg) · [ZIP](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-mac-x64.zip) | [DMG](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-mac-x64.dmg) · [ZIP](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-mac-x64.zip) |
| macOS | arm64 | [DMG](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-mac-arm64.dmg) · [ZIP](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-mac-arm64.zip) | [DMG](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-mac-arm64.dmg) · [ZIP](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-mac-arm64.zip) |
| Linux | x64 | [AppImage](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-linux-x64.AppImage) · [DEB](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-linux-x64.deb) · [RPM](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-linux-x64.rpm) | [AppImage](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-linux-x64.AppImage) · [DEB](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-linux-x64.deb) · [RPM](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-linux-x64.rpm) |
| Linux | arm64 | [AppImage](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-linux-arm64.AppImage) · [DEB](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-linux-arm64.deb) · [RPM](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-2.0.12-linux-arm64.rpm) | [AppImage](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-linux-arm64.AppImage) · [DEB](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-linux-arm64.deb) · [RPM](https://github.com/CherryHQ/cherry-studio/releases/download/v2.0.12/Cherry-Studio-CN-2.0.12-linux-arm64.rpm) |

##### Release Notes / 发布说明

<details>
<summary>English</summary>

Cherry Studio 2.0.12 - Features, Fixes, and Improvements

✨ New Features
- [Settings] Settings gains a sidebar search: find any setting row across all sections (title/description/aliases, Chinese pinyin included), jump to it with scroll + highlight, full keyboard navigation.
- [Settings] Settings search now covers all sections with static settings rows, including MCP tabs.
-

_[Truncated at 4000 characters — full notes: https://github.com/CherryHQ/cherry-studio/releases/tag/v2.0.12]_