# cherry-studio v2.0.4

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

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** — Add back-to-top button and line-break mode to notes
- **added** — Add delete impact preview to agent workspace
- **added** — Add tab navigation shortcuts
- **added** — Restore MCP-over-HTTP endpoints (/v1/mcps) in API gateway
- **added** — Add opt-in MCP sessions with server-to-client push and progress in API gateway
- **added** — Handle GROUP_MESSAGE_CREATE event with per-channel mention-only toggle for QQ channel
- **changed** — Serve the trace viewer incrementally and bound its retention
- **changed** — Virtualize large span trees in trace viewer
- **changed** — Route only PDFs through document processors in knowledge readers
- **fixed** — Sync tray-dependent preferences in settings
- **fixed** — Propagate stream abort signal into in-flight MCP tool calls
- **fixed** — Normalize legacy v1 MCP tool names before model replay
- **fixed** — Block unreadable images for text-only models in chat attachments
- **fixed** — Find deeply nested workspace file mentions in agent
- **fixed** — Keep window shortcuts local in shortcut service
- **fixed** — Preserve auto-backup intervals across restarts
- **fixed** — Persist assistant group collapse in resource list
- **fixed** — Wrap long unbroken lines in wrapped mode instead of clipping in code viewer
- **fixed** — Honor auto-collapse setting when disabled for thinking blocks

##### What's Changed
* test(ai): add chat turn integration trajectories by @xjt-box in https://github.com/CherryHQ/cherry-studio/pull/17550
* perf(ai-trace): serve the trace viewer incrementally and bound its retention by @zhangjiadi225 in https://github.com/CherryHQ/cherry-studio/pull/18203
* ci(prepare-release): sync and translate i18n before cutting a release by @DeJeune in https://github.com/CherryHQ/cherry-studio/pull/18214
* fix(settings): sync tray-dependent preferences by @ousugo in https://github.com/CherryHQ/cherry-studio/pull/17445
* feat(notes): add back-to-top button and line-break mode by @LWWZH in https://github.com/CherryHQ/cherry-studio/pull/17788
* feat(agent-workspace): add delete impact preview by @zhangjiadi225 in https://github.com/CherryHQ/cherry-studio/pull/18164
* fix(mcp-runtime): propagate stream abort signal into in-flight MCP tool calls by @kovsu in https://github.com/CherryHQ/cherry-studio/pull/18294
* fix(ai-messages): normalize legacy v1 MCP tool names before model replay by @DeJeune in https://github.com/CherryHQ/cherry-studio/pull/18224
* fix(chat-attachments): block unreadable images for text-only models by @zhangjiadi225 in https://github.com/CherryHQ/cherry-studio/pull/18297
* refactor(knowledge-readers): route only PDFs through document processors by @eeee0717 in https://github.com/CherryHQ/cherry-studio/pull/18161
* fix(agent): find deeply nested workspace file mentions by @ousugo in https://github.com/CherryHQ/cherry-studio/pull/18139
* fix(shortcut-service): keep window shortcuts local by @Pleasurecruise in https://github.com/CherryHQ/cherry-studio/pull/18282
* fix(backup): preserve auto-backup intervals across restarts by @ousugo in https://github.com/CherryHQ/cherry-studio/pull/18226
* fix(resource-list): persist assistant group collapse by @kennyzheng-builds in https://github.com/CherryHQ/cherry-studio/pull/18252
* docs(claude-md): cap inline comments, ban behavior-pinning tests, drop linear-history rule by @DeJeune in https://github.com/CherryHQ/cherry-studio/pull/18302
* fix(code-viewer): wrap long unbroken lines in wrapped mode instead of clipping by @tommyzhang100504 in https://github.com/CherryHQ/cherry-studio/pull/18290
* fix(thinking-block): honor auto-collapse setting when disabled by @linktao159357 in https://github.com/CherryHQ/cherry-studio/pull/18073
* fix(topic-naming): keep auto-rename requests free of assistant tool config by @tommyzhang100504 in https://github.com/CherryHQ/cherry-studio/pull/18320
* fix(mini-app): reuse existing sidebar tab by @kennyzheng-builds in https://github.com/CherryHQ/cherry-studio/pull/18233
* fix(assistant-editor): recover from legacy save failures by @kennyzheng-builds in https://github.com/CherryHQ/cherry-studio/pull/18257
* perf(trace-viewer): virtualize large span trees by @zhangjiadi225 in https://github.com/CherryHQ/cherry-studio/pull/18296
* fix(knowledge): add cursor pagination to knowledge base lists by @eeee0717 in https://github.com/CherryHQ/cherry-studio/pull/18300
* fix(system-ocr): send image bytes on Windows so JPEG decodes by @kovsu in https://github.com/CherryHQ/cherry-studio/pull/18335
* refactor(file-utils): split path spec from filename convention, add RelativeFilePath brands by @EurFelux in https://github.com/CherryHQ/cherry-studio/pull/18229
* refactor(knowledge): type material paths as PosixRelativeFilePath by @EurFelux in https://github.com/CherryHQ/cherry-studio/pull/18230
* feat(shortcuts): add tab navigation shortcuts by @ousugo in https://github.com/CherryHQ/cherry-studio/pull/16629
* fix(windows-env): preserve Unicode command paths by @AtomsH4 in https://github.com/CherryHQ/cherry-studio/pull/18201
* fix(dashscope): skip web_extractor when thinking is disabled by @tommyzhang100504 in https://github.com/CherryHQ/cherry-studio/pull/18349
* fix(agent-editor): let an explicit close discard a failed agent save by @kovsu in https://github.com/CherryHQ/cherry-studio/pull/18331
* fix(compose

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