版本看板

產品演進的速覽報告。

安裝或升級前值得掌握的關鍵變更資訊。

本頁面旨在提供直覺的版本導向總結,而非取代GitHub Releases的詳細細節。

01

2026-05-28 01:31:21 (UTC)

02

v0.22.29

03

GitHub Releases

目前最高版本

目前重點版本:v0.22.29

2026-05-28 01:31:21 (UTC) / **Draw.io diagram text layout**: Fixed multiline Draw.io labels in previews so text inside boxes starts at the expected position instead of appearing with an unnecessary blank line at the top.

v0.22.29v0.22.28v0.22.27

版本摘要

完整日誌前先看的版本重點

開發計畫

近期開發計畫

從 OpenSpec 的 active changes 中摘取最接近落地的項目。

v0.26.0

統一 workspace 術語

讓 UI、i18n 與實作中的 explorer 命名保持一致。

v0.25.0

動態文字翻譯補強

為靜態 JSON 無法涵蓋的英文動態內容提供自動翻譯輔助。

v0.24.0

文件生成流程

把插入現有文件、新增 Markdown、模板腳手架放進同一流程。

安裝前為何先看這裡

近期版本節奏可反映更新可靠性、渲染穩定性與跨平台維護強度。

近期發布匯總

v0.22.29 2026-05-28 01:31:21 (UTC)

🐛 Bug Fixes

  • Draw.io diagram text layout: Fixed multiline Draw.io labels in previews so text inside boxes starts at the expected position instead of appearing with an unnecessary blank line at the top.
v0.22.28 2026-05-27 07:02:47 (UTC)

✨ Improvements

  • Document preview and export stability: Refreshed the document and diagram rendering components used by previews and saved files, improving consistency after rendering updates.
  • Markdown processing stability: Updated Markdown processing dependencies so large documents and embedded assets use the latest parser and archive handling fixes.

🔧 System

  • Dependency maintenance: Removed older duplicate support libraries from the release dependency graph, reducing the maintenance surface for future builds.
v0.22.27 2026-05-26 23:48:35 (UTC)

✨ Improvements

  • Diagram preview and export stability: Updated the bundled document and diagram rendering path used by Mermaid, Draw.io, and PlantUML so previews and saved files stay aligned after renderer updates.

🔧 System

  • Rendering dependency cleanup: Removed a deprecated compatibility renderer path from the app dependency graph and now use the current rendering runtime directly.
更多版本
v0.22.26 2026-05-25 19:14:28 (UTC)

✨ Improvements

  • Unified document export: HTML, PDF, PNG, and JPEG exports now use the same document rendering path as the viewer, improving consistency between previews and saved files.
  • Diagram preview consistency: Mermaid, Draw.io, and PlantUML previews now receive the active theme directly, reducing stale diagram colors after theme changes.

🐛 Bug Fixes

  • Diagram exports with tilde fences: Diagrams written with ~~~ code fences now render in exported HTML instead of appearing as raw Markdown.

🔧 System

  • Rendering dependency cleanup: Removed an older export integration path and aligned diagram rendering dependencies to improve release stability.
  • Diagram rendering runtime refresh: Updated the shared rendering runtime used by previews and exports to improve release stability.
v0.22.25 2026-05-19 17:13:21 (UTC)

🚀 Features

  • Automatic language mode: Added a language option that follows the operating system. New installs use this automatic mode by default, while existing manual language choices stay unchanged.

🐛 Bug Fixes

  • Localized update-check errors: Update-check failures now show readable messages in the selected app language instead of raw network or library errors. Connection, timeout, server, proxy, response, and unknown failures are covered.
v0.22.24 2026-05-19 09:15:55 (UTC)

🐛 Bug Fixes

  • Startup update-check error no longer blocks the app: KatanA no longer shows a red update-check failure on every launch when the system network settings point to an unreachable proxy. If update information cannot be fetched, the app now starts quietly and treats it as temporarily unavailable update information.
v0.22.23 2026-05-19 07:44:56 (UTC)

🐛 Bug Fixes

  • Windows console window suppression: Fixed the console window that could briefly appear on Windows when KatanA opened a document containing a PlantUML diagram.

🔧 System

  • Windows background process stability: Strengthened the internal process-launch path so background tools used by KatanA stay hidden on Windows.
v0.22.22 2026-05-18 08:22:37 (UTC)

🔧 System

  • Windows distribution stability: Improved safeguards so helper tools used around KatanA do not briefly flash console windows on Windows.
  • Diagram preview reliability: Improved internal checks around diagram preview rendering so intermittent preview failures are caught before release.
v0.22.21 2026-05-16 09:31:46 (UTC)

✨ Improvements

  • Diagram Preview Cache: Reuses generated diagram SVGs per Markdown file, reducing unnecessary redraws when reopening or restoring tabs.

🔧 System

  • Improved diagram rendering quality verification so Mermaid and Draw.io visual regressions can be caught more accurately before release.
  • Improved diagram cache compatibility handling so cached diagrams are refreshed when rendering output changes.
v0.22.20 2026-05-15 11:04:17 (UTC)

🐛 Bug Fixes

  • Linux Diagram Text: Fixed Mermaid, PlantUML, and ZenUML diagram labels disappearing in previews on Linux environments without system fonts.
v0.22.19 2026-05-15 06:14:19 (UTC)

🐛 Bug Fixes

  • Diagram Preview Stability: Fixed Mermaid and Draw.io previews failing with a worker disconnect after the renderer update.

🔧 System

  • Aligned the internal diagram rendering runtime used by preview and export paths to improve update stability.
v0.22.18 2026-05-14 16:02:42 (UTC)

🐛 Bug Fixes

  • Linux Diagram Labels: Fixed Mermaid and Draw.io diagram labels disappearing in the preview on Linux.
  • Linux PlantUML Preview: Fixed PlantUML diagrams rendering as blank space in the preview on Linux.
  • Windows Update Check: Fixed update checks failing with io: Connection refused when Windows environments have a broken local proxy setting.
v0.22.17 2026-05-13 14:30:56 (UTC)

🐛 Bug Fixes

  • Windows Startup: Suppressed a visible PowerShell console window that appeared briefly during theme detection.
  • Splash Screen: Fixed the splash screen layout to remain perfectly centered across all screen resolutions.
v0.22.16 2026-05-12 15:20:29 (UTC)

✨ Improvements

  • Linuxbrew Installation: Linuxbrew installs now publish the expected katana-desktop command and replace stale command links during formula updates, reducing manual cleanup after upgrades.
  • Icon Alpha Editing: The icon color advanced settings now always show the opacity slider, making transparent icon colors easier to adjust.

🐛 Bug Fixes

  • Windows In-App Update: Fixed the Windows update and restart flow so repeated update actions do not spawn duplicate installers, and relauncher processes start reliably from a desktop app without a console.
  • PlantUML on Windows: Fixed PlantUML rendering on Windows so Java-based diagrams can open without being hidden by the app's background-process mode.

🔧 System

  • Removed obsolete built-in renderer plugin placeholders now that diagram handling is wired through the current rendering pipeline.
v0.22.15 2026-05-12 09:46:00 (UTC)

🐛 Bug Fixes

  • ZenUML Diagram Colors: Fixed ZenUML diagrams rendering with incorrect colors. The diagram background and internal colors (lifelines, fragment boxes) now correctly follow the active light or dark theme.
v0.22.14 2026-05-11 05:24:36 (UTC)

✨ Improvements

  • Diagram Theme Consistency: Mermaid and DrawIO diagrams now follow the active light or dark theme in previews and exports, preventing dark diagram colors from appearing in light workspaces.
  • Diagram Renderer Availability: Diagram rendering no longer depends on a separate startup download or manual renderer repair action, reducing first-run and offline failure cases.

🐛 Bug Fixes

  • ZenUML Diagram Rendering: Fixed ZenUML content inside mermaid fences so it is passed to the diagram renderer instead of staying visible as raw Markdown.
  • Linux In-App Update: Fixed Linux in-app updates for installs whose executable was named katana-desktop; the next update can repair itself through the normal restart flow without manual reinstall or file renaming.
  • Windows In-App Update: Improved update asset selection so Windows portable or renamed installs still use the correct application executable during automatic update.
v0.22.13 2026-05-10 09:30:00 (UTC)

🐛 Bug Fixes

  • Windows In-App Update: Fixed an issue where the in-app updater detected new versions and showed the "Update & Restart" button, but neither the update nor the relaunch actually completed. The relauncher script extension is now .ps1 (executed as PowerShell), the evacuate/replace flow runs inside a single retry loop with up to 30 attempts to absorb antivirus / Defender file locking, and the running window is no longer hidden after restart.
  • Windows Update Diagnostics: The "Update Failed" dialog now points at %LOCALAPPDATA%\KatanA\update.log so failed self-updates can be triaged from the message itself.
  • Windows Path Robustness: Single quotes in the install path are now safely escaped, and the relauncher restores the working directory of the new process after launch.
v0.22.12 2026-05-08 15:04:10 (UTC)

🚀 Features

  • Workspace Tabs: Workspaces can now stay open as tabs with close buttons, a plus button for opening another workspace, persisted restoration, and a setting for keeping a single workspace open.

✨ Improvements

  • Markdown Fix Review: Added a "Cancel All" action for multi-file Markdown fix previews, making it easier to discard an entire batch at once.
  • Problems Panel Count: Updated the status-bar problem count to follow the selected Problems panel scope while the panel is open, and return to all open tabs when closed.
  • Tab Clarity: Added subtle inner borders to workspace and document tabs, with accent-colored hover borders and workspace close icons shown only on hover.

🐛 Bug Fixes

  • Markdown Bulk Fixes: Fixed bulk Markdown fixes so every eligible open tab is included and can be applied from the review, including tabs whose contents have not been loaded yet.
  • Markdown Fix Loop: Fixed repeated MD022 / MD012 quick-fix previews by using the same convergent fix result as the Markdown formatter.
  • Linter Settings Refresh: Fixed Markdown diagnostics so Linter setting changes are reflected even when the document text has not changed.
  • Unavailable Fix Buttons: Hid fix actions when the suggested fix would not change the current content, preventing buttons that cannot apply a real fix.
  • Quick Fix Preview: Fixed editor diagnostic quick-fix buttons so they reliably open the review tab.
  • Window Title Clarity: Fixed macOS window titles so the window shows the current workspace while the in-app title shows the active document, avoiding duplicated document text.
  • Workspace Restore: Prevented temporary workspaces from being restored on the next launch after opening standalone files.

🔧 System

  • Improved the internal quality gate so shared code-quality checks stay consistent across KatanA ecosystem projects.
v0.22.11 2026-05-04 13:29:09 (UTC)

🐛 Bug Fixes

  • Auto-Update Linux Asset: Fixed Linux auto-update asset selection to use KatanA-linux-x86_64.tar.gz, which matches the release pipeline output.
  • Windows Relauncher Robustness: Updated the Windows relauncher to confirm evacuation and replacement before launch, rollback on failure, and avoid forcing start of the old binary.
  • Update Logging: Added local update diagnostics in %LOCALAPPDATA%\KatanA\update.log for evacuate, replace, launch, and rollback phases.
  • Release Note Guidance: Added manual upgrade guidance for v0.22.10 users that can be affected by Linux 404 and Windows relauncher path issues.
v0.22.10 2026-05-03 00:27:30 (UTC)

🚀 Features

  • Diagram Renderer Runtime Replacement: Mermaid and DrawIO previews now use the in-process JavaScript renderer path with a unified policy, reducing environment dependency on external browser apps.
  • Rendering Verification Tooling: Added official-reference rendering comparison tooling and fixture organization to support deterministic Mermaid/DrawIO render verification across languages and styles.

✨ Improvements

  • Export Reliability: Updated HTML / PDF / PNG / JPEG generation paths to align with the renderer policy and preserve rendered output quality without requiring OS Chrome/Chromium launch for normal export flows.
  • Resource Coverage: Expanded DrawIO-compatible resources and updated fixture sets so diagram rendering behavior is validated against official references before release.

🐛 Bug Fixes

  • Diagram Quality: Fixed numerous Mermaid/DrawIO rendering mismatches (layout, color, labels, sizing, and markers) through expanded fixture-driven corrections.
  • Locale and Normalization: Improved handling for non-English diagram inputs in comparison and runtime paths to reduce parser/display edge cases.
v0.22.9 2026-04-29 00:20:53 (UTC)

🐛 Bug Fixes

  • Windows Auto-Update: Fixed an issue on Windows where the automatic update installation could hang or fail due to file locking when restarting the application.
  • Update Dialog: Improved the reliability of the "Download Update" and "Install Update" actions in the settings tab.
v0.22.8 2026-04-28 05:55:06 (UTC)

🚀 Features

  • Diff Apply Preview: Added a new confirmation flow in the Problems panel so users can review proposed file edits before applying quick fixes.

✨ Improvements

  • Diff Viewer Usability: Added split and inline diff modes with persistent settings, plus file-level pagination for multi-file fixes.
  • Fix Preview Clarity: Improved preview readability and modal navigation so users can compare original and updated code with clearer context and safer controls.

🐛 Bug Fixes

  • Prevented accidental file modifications by requiring explicit confirmation for each diff before applying fix previews.
  • Fixed oversized preview layout by limiting long diff rendering and keeping tooltips visually stable.

🔧 System

  • Reworked the internal diff apply state flow to support cancellable, file-by-file review with stronger consistency around user decisions.
v0.22.7 2026-04-27 05:24:43 (UTC)

🚀 Features

  • Diagram Block Rendering: Added support for Mermaid, DrawIO, and PlantUML blocks written with tilde fences, so both backtick and tilde Markdown code blocks can render diagrams.
  • Markdown Lint Settings: Added workspace-aware Markdown lint settings with shared rules, workspace rules, rule details, presets, and reusable user presets.
  • Markdown Formatting Actions: Added file, folder, workspace, and Problems panel actions for applying available Markdown lint fixes in bulk.

✨ Improvements

  • Diagram Rendering Performance: Reworked Mermaid and DrawIO rendering to use cached local renderer assets and faster background rendering.
  • Settings Experience: Unified theme, icon, and linter preset controls, improved searchable dropdowns, and fixed layout issues in advanced settings.
  • Explorer Workflows: Added quick creation and formatting entry points from Explorer headers and context menus.

🐛 Bug Fixes

  • Fixed Markdown lint diagnostic popups in code view so warning and error details appear on hover.
  • Fixed code block insertion so the button opens a type selector and inserts the selected fenced code block.
  • Fixed Mermaid and DrawIO preview regressions affecting size, centering, colors, caching, and refresh behavior.
  • Fixed a Markdown lint crash caused by multibyte Japanese text in long-line checks.

🔧 System

  • Improved renderer asset caching, Markdown lint compatibility, and regression coverage for diagram previews, settings persistence, and bulk fixes.
v0.22.6 2026-04-25 14:03:32 (UTC)

🚀 Features

  • Open File Flow: Added a dedicated File > Open File action for opening supported documents, images, and DrawIO files without mixing it with the folder-only Open Workspace flow.
  • External File Drop: Files dropped onto the app window now open as tabs in the current workspace, including multi-file drops.
  • Explorer Move Operations: Files and folders can now be moved directly from the Explorer, including drops onto folders or the workspace root area.

✨ Improvements

  • File Type Filtering: Open File and external file drops now share the same supported-extension checks, including user-configured Markdown extensions, images, and DrawIO files.
  • Temporary Workspace Handling: Opening a file without an active workspace uses a temporary workspace for the current session without saving it to workspace history or restoring it on the next app launch.
  • Markdown Lint Reliability: Updated the bundled Markdown lint engine so editor diagnostics and quick fixes follow the latest rule behavior available in KatanA.

🐛 Bug Fixes

  • Fixed moved image tabs so they continue pointing to the new file location after Explorer move operations.
  • Fixed file move confirmation and settings labels so the UI uses localized text consistently.
v0.22.5 2026-04-25 07:59:44 (UTC)

🚀 Features

  • Contextual Markdown Input Controls: Added cursor-adjacent Markdown input controls with buttons for Bold, Italic, Strikethrough, Inline Code, Code Block, Headings (H1–H3), Bullet List, Numbered List, Blockquote, and image insertion. Inline formatting buttons are enabled only when text is selected; block-level buttons are always available while editing.
  • Clipboard Image Paste: Added support for pasting images directly from the clipboard into the editor via normal paste (Cmd+V on macOS) or the grouped context menu. Images are saved to the configured directory and inserted as Markdown image syntax.
  • Explorer Referenced Images: The Explorer panel now displays a collapsible "Referenced Images" section listing all images referenced in the active document. Clicking an image reveals it in Finder/Explorer.
  • Image Ingest Settings: Added image ingest configuration to the Behavior settings tab, including save directory, filename format, and auto-create directory toggle.

🐛 Bug Fixes

  • Fixed editor input regressions that could interrupt typing, hide the Markdown input controls, or let editor shortcuts conflict with tab navigation while editing.
  • Fixed clipboard image paste so regular paste inserts the image at the current cursor position when the clipboard contains image data.
  • Fixed linter diagnostics so workspace Markdown lint configuration is respected and editor-side quick fixes are shown consistently with the Problems panel.
  • Fixed file dialog cancellation so canceling the native macOS picker no longer opens the fallback in-app file picker.

🔧 System

  • Preview-First Default: Newly opened documents now default to preview mode unless the user explicitly switches the active tab to code or split mode.
  • Improved the internal structure of the Explorer so referenced images can be expanded without making the panel harder to maintain.
v0.22.4 2026-04-23 21:40:00 (UTC)

🚀 Features

  • Markdown Linter UI & Auto-Fix Integration:
    • Implemented an interactive Linter Settings UI supporting localized rule descriptions (i18n).
    • Added real-time in-editor visualization for linting errors with squiggly lines and gutter icons.
    • Implemented diagnostic popups with "Quick Fix" and "Fix All" automated formatting capabilities.
    • Added an in-app documentation viewer for MarkdownLint rules with visual examples.
    • Improved the internal rule organization so Markdown checks remain stable as more fixes are added.

🐛 Bug Fixes

  • Fixed an issue where the file dialog could crash on certain limited Linux environments.

🔧 System

  • Optimized internal test execution and added fallback testing for the DrawIO rendering pipeline.
v0.22.3 2026-04-22 01:49:58 (UTC)

🚀 Features

  • Redesigned the shortcut settings interface: added a search bar, OS-native key icons (e.g. ⌘, ⇧, ⌥), and a dedicated shortcut capture modal with a cleaner row-click trigger.
  • Added custom file type icons for HTML, PDF, and image files in the explorer.
  • Added specific command filtering in the command palette (Cmd+Shift+P / Ctrl+Shift+P) exclusively for Katana-specific actions.

✨ Improvements

  • Completed localization translations across all 11 supported languages for previously untranslated labels (e.g. "Close Document", "Global Search").
  • Assigned new default shortcuts to various actions, including file.close_workspace and view.refresh_explorer.

🐛 Bug Fixes

  • Fixed layout truncation issues where the command palette and tab navigation could not be scrolled when containing a large number of items.
  • Resolved an issue where release notes would fail to display properly if the network fetch failed.

🔧 System

  • Improved shortcut-definition safeguards so duplicate shortcuts are caught earlier.
  • Improved internal test stability around environment-dependent behavior.
v0.22.2 2026-04-20 16:38:00 (UTC)

🚀 Features

  • Side Panel Redesign: Completely revamped the visual design of various side panels (TOC, Tools, Export, Story) and refined the layout order of sidebar icons for a more intuitive workspace experience.

✨ Improvements

  • Ultra-Precise Scroll Synchronization: Overhauled the synchronization logic between the editor and preview panes. Implemented high-precision physical mapping based on actual visual layout coordinates, ensuring perfect alignment even with soft-wrapping.
  • Full EOF Reachability (Ghost Space): Introduced dynamic "Ghost Space" padding for both panes, mathematically guaranteeing that both reach the document boundary at the same time.
  • Search Experience: Switched the default search filter from regular expressions to plain text to provide a smoother, more predictable search experience.
  • Windows Installation: Added official documentation and support for installing KatanA via winget on Windows.

🐛 Bug Fixes

  • Preview Panel Infinite Expansion (Ratchet Bug): Resolved the endless horizontal expansion of the preview pane by introducing smart dynamic column width distribution and maximum cell width limits for Markdown tables.
  • Split Panel Resizing: Fixed a critical issue where adjusting the width of split panels became unresponsive.
  • Consecutive Diagrams: Fixed a rendering regression where consecutive rich blocks (Mermaid, DrawIO, PlantUML) failed to be interpreted and displayed properly.
  • Nested Code Blocks: Corrected a layout degradation where code blocks nested within standard list items were incorrectly rendered inline.
  • Search in Preview-Only Mode: Stabilized document search navigation and match highlighting while operating in the preview-only mode.
  • Math Block Stability: Eliminated visual jitter in LaTeX/Math blocks and unified rendering bounds.
  • Linux Font Loader: Patched a font resolution issue affecting specific configurations on Linux distributions.
  • Update Checker: Upgraded the version comparison engine to accurately identify and notify users of hotfix-level (-1 etc.) updates.
  • General UI: Restored the missing icon on the CHANGELOG tab and enforced a fixed width for the custom theme saving modal to prevent out-of-bounds rendering.

🔧 System

  • Internal Stability: Migrated internal scroll mapping from estimated line counts to exact layout row coordinates to eliminate scroll drift. Strengthened integration test coverage across font handling, table dimensions, and layout alignment. Upgraded core app assets and translation strings.
v0.22.1-1 2026-04-14 10:15:00 (UTC)

✨ Improvements

  • Modernized Icon Settings UI: Replaced the cramped accordion-based icon settings with a sleek "Bottom Sheet" (slide-up panel) overlay. This new layout decouples advanced configuration from the preview grid, providing a much larger, dedicated workspace for icon overrides and system settings while maintaining an elegant, animated user experience.

🐛 Bug Fixes

  • Search Bar UI Fixes: Resolved layout collapse bugs in the global search tab, fixed input focus dropping caused by IME text input events, prevented frame expansion upon focusing the search bar, and removed redundant search icons from context-aware search inputs.
v0.22.1 2026-04-12 18:59:00 (UTC)

✨ Improvements

  • Standardized Search UI: Unified the search bar design across the explorer, global search, and document search.
  • Enhanced Search Inputs: Integrated search icons and clear buttons directly inside search input fields for a more premium look and feel.
  • Advanced Search Toggles: Added support for Case Sensitivity, Whole Word matches, and Regular Expressions across all search interfaces.
  • Layout Stability: Resolved layout regressions where the search bar could cause the sidebar to stretch horizontally.
  • Extended Localization: Completed native localization for "Official Website" links and About dialog entries across all 11 supported languages.
  • macOS Menu Optimization: Simplified the macOS-specific application menu by removing redundant "Hide" and "Show All" items for a cleaner user experience.

🐛 Bug Fixes

  • Explorer Filter Behavior: Fixed an issue where hidden directories starting with "." (e.g., .git) were not excluded when filtering.
  • Improved UI Usability: Improved the explorer to automatically focus the search input field when the filter is enabled.

🔧 System

  • Refactored Search Components: Consolidated redundant search UI logic into a centralized SearchBar widget for better maintainability and consistency.
v0.22.0 2026-04-12 13:10:00 (UTC)

Added

  • Implemented Markdown Authoring Commands (Bold, Italic, Strikethrough, etc.) and integrated them into the command inventory.
  • Added comprehensive Image Ingest Pipeline UI and fallback integrations.
  • Replaced missing images with an aesthetic UI fallback component (ImageFallbackOps) for better user experience.
  • Persisted image ingestion settings to allow custom paths for image asset management.

Fixed

  • Fixed a preview layout issue that could affect image-related controls.
  • Removed unused preview-pane code paths to keep the image feature stable.
v0.21.0 2026-04-12 08:21:00 (UTC)

Added

  • Implemented Shortcut Customization UI in Settings.
  • Added comprehensive localization for the shortcut settings panel (de, es, fr, it, ko, pt, zh-CN, zh-TW).
  • Introduced conflict detection to warn users if a newly bound shortcut is already in use by another feature.
  • Enabled OS-specific default shortcut definitions alongside custom user overrides.
v0.20.0 2026-04-12 05:51:33 (UTC)

🚀 Features

  • Centralized Command Inventory: Introduced a unified command tracking system to handle all user-facing actions consistently.
  • Enhanced Application Menus: Significantly expanded the File and View menus with new commands, maintaining complete parity across macOS native menus and other operating systems.
  • Command Palette Grouping: Results inside the Command Palette now display their respective group or category for better navigation and context.

✨ Improvements

  • Reorganized Help Menu: Consolidated external links and application resources systematically, including a direct link to the GitHub repository.

🔧 System

  • Improved application stability and cross-platform UI synchronization by establishing a strict single source of truth for command availability.
v0.19.0 2026-04-12 02:30:00 (UTC)

🚀 Features

  • Markdownlint Parity: Built-in Markdown diagnostics are now fully compliant with the official markdownlint specifications.
  • Enhanced Problems Panel: The Problems Panel now prominently displays official rule codes (e.g., MD001) and provides one-click links to the official documentation.

✨ Improvements

  • Diagnostic Stability: Stabilized real-time diagnostic refresh policies and modernized rule filtering to distinguish between Official, Experimental, and Hidden internal rules.
v0.18.8 2026-04-12 00:53:47 (UTC)

🚀 Features

  • Self-Contained Windows Distribution: KatanA for Windows is now distributed as a fully standalone application. By statically linking runtime libraries, the requirement to install the "Visual C++ Redistributable" has been completely eliminated for new users.

✨ Improvements

  • Windows Installer Design Refresh: Refined the visual design of the Windows MSI installer to include a custom banner and dialog branding for a more professional and integrated installation experience.
  • Automated Winget Updates: Hardened the internal release pipelines to improve the reliability of KatanA's submissions to the Windows Package Manager (Winget).
v0.18.7 2026-04-11 22:34:24 (UTC)

✨ Improvements

  • Refined the slideshow mode with an animated outrigger tab and comprehensive hover highlighting for all document nodes.
  • Enhanced Workspace UI with a modernized Finder-style tab toolbar, improved Workspace Toggle Modal, and stabilized layout components.
  • Improved Markdown rendering to correctly detect and activate plain-text URLs within list items.
  • Unified shortcut management and refined general UI/UX behaviors (e.g., context menu labels and overlay transparency).

🐛 Bug Fixes

  • Fixed an issue where the layout would regress when combining tab toolbars and side panels.

🔧 System

  • Improved internal validation performance by removing redundant checks and tuning parallel execution.
  • Centralized resource directories and resolved Windows packaging dependency issues for a cleaner architecture and distribution.
v0.18.6 2026-04-10 19:06:06 (UTC)

✨ Improvements

  • Unified Multi-Platform Menu: Introduced a dedicated "KatanA" application menu for Windows and Linux, matching macOS standards. This centralizes "About", "Check for Updates", "Settings", "Language", and "Quit" in the leftmost menu for improved cross-platform consistency.
  • Robust PlantUML/mmdc Probing: Enhanced Mermaid CLI (mmdc) discovery on Windows to recognize various executable extensions (.cmd, .ps1, .exe). Also improved the Node.js download fallback for PlantUML to follow redirects and handle errors more reliably.

🐛 Bug Fixes

  • Linux Auto-Update 404: Fixed a download failure (404 error) occurring during application updates on some Linux environments by improving redirect handling in the fetch pipeline.
  • Localization Parity: Resolved inconsistencies in update-related labels across all 11 supported languages, ensuring a fully localized experience during installation and relaunch.
v0.18.5 2026-04-10 12:58:13 (UTC)

✨ Improvements

  • PlantUML Download Resilience: Implemented a robust, cross-platform download mechanism for PlantUML. Now tries curl first, then falls back to PowerShell Invoke-WebRequest on Windows, and wget on Linux/macOS.

🐛 Bug Fixes

  • Terms of Service re-displayed after update: Fixed a bug where the Terms of Service screen was incorrectly shown again after every application update. It now appears only on the very first launch.

🔧 System

  • Windows background process stability: Diagram rendering, file reveal, update cleanup, and downloads now use the same hidden background-process behavior on Windows.
  • Regression prevention: Added internal safeguards so future background tasks do not accidentally bring back console-window popups on Windows.
v0.18.4 2026-04-10 11:18:09 (UTC)

🚀 Features

  • Windows distribution stability: Centralized command execution logic for Windows to prevent console windows from popping up during background tasks such as diagram rendering and application updates.

✨ Improvements

  • PlantUML Download Resilience: Implemented a robust download mechanism for PlantUML with an automatic PowerShell fallback on Windows, ensuring compatibility even when curl is unavailable.

🐛 Bug Fixes

  • Mermaid CLI (mmdc) on Windows: Suppressed unnecessary console windows during Mermaid diagram rendering on Windows.
  • Silent Background Updates: Fixed an issue where a PowerShell window would briefly appear during the application update process on Windows.
v0.18.3 2026-04-10 09:52:37 (UTC)

✨ Improvements

  • Improved the resolution logic of the Mermaid rendering engine to be more robust across multiple platforms.

🐛 Bug Fixes

  • Fixed an issue where the terms of service modal was incorrectly displayed every time the app was updated.
  • Fixed an issue where the application would freeze and become unresponsive during the first launch.
  • Fixed an issue where the demo language switching links were incorrectly resolved as relative paths.

🔧 System

  • Improved internal code structure for greater maintainability and stability.
v0.18.2 2026-04-10 07:25:00 (UTC)

✨ Improvements

  • Enabled manual diagram re-rendering for Demo files via the Refresh button, allowing users to update diagrams without restarting after installing prerequisite tools like Mermaid CLI or Java.
  • Added a PlantUML class diagram example to the rendering features demo.
  • Updated Windows documentation to feature the portable ZIP version as the recommended installation method.

🐛 Bug Fixes

  • Fixed an issue where the Terms of Service agreement modal would incorrectly appear on every minor app version update.
  • Fixed a bug causing internal Katana:// virtual URLs (opened from tooltips etc.) to be misidentified as local paths, preventing them from opening correctly.
  • Enhanced multi-platform support for the Mermaid CLI (mmdc) resolution, ensuring reliable path discovery on Windows and robust cache validation when reloading diagrams after tool installation.
  • Addressed an installation failure in the Windows MSI installer where directories under AppData were not properly initialized during per-user installations.

🔧 System

  • Improved background stability of the testing environment for Windows builds.
v0.18.1 2026-04-09 15:40:06 (UTC)

🚀 Features

  • Windows MSI Installer: KatanA for Windows is now distributed as a native .msi package (built via WiX), automatically creating Start Menu and Desktop shortcuts upon installation.
  • The built-in auto-updater seamlessly supports smooth background updates for the new perUser installed directory.
v0.18.0 2026-04-08 12:15:00 (UTC)

🚀 Features

  • Cross-Platform Support: KatanA now officially supports Windows and Linux (Ubuntu) distributions. Users on these platforms can now download MSI and DEB installer packages directly from the GitHub Releases page.
  • Smart Update Detection: The built-in updater is now fully OS-aware. It will securely ignore update files that do not match your current operating system, preventing unsupported cross-platform installations.

✨ Improvements

  • App installation has become much simpler as the external dependency on the gh CLI has been completely removed. Communication with GitHub is now performed securely through an internal HTTP adapter.

🔧 System

  • Improved release packaging reliability across supported operating systems.
v0.17.2 2026-04-08 08:45:00 (UTC)

🚀 Features

  • Expanded Icon Settings to support Advanced Icon Configuration. Users can now assign custom colors or override default icon packs on a per-icon basis, and save them as reusable presets.

✨ Improvements

  • Reorganized the icon settings panel to group icons systematically by vendor and category, greatly enhancing discoverability.
  • Added a fixed action bar to the bottom of the settings screen, providing immediate access to 'Apply' and 'Restore' functions even when scrolling through long lists.
v0.17.1 2026-04-07 21:47:42 (UTC)

✨ Improvements

  • Stabilized UI controls during slideshows to ensure magnification elements remain visible and active on diagram blocks.
  • Improved hover highlight visibility across all diagram types to ensure unified preview behavior.
  • Unified the source design of system view icons (reset view) for a more consistent visual experience.

🐛 Bug Fixes

  • Fixed a visual clipping issue where Markdown heading highlights failed to extend fully to the edges of the preview pane.
v0.17.0 2026-04-07 19:40:00 (UTC)

🚀 Features

  • Introduced an "Icon Theme Pack" feature, allowing users to customize the application's icons from a rich selection of 15 built-in themes (including Lucide, Material Symbols, Feather, and more).

✨ Improvements

  • Ensured robust UI stability by enforcing strict icon synchronization and fixing display anomalies such as placeholder icons for extensionless files.

🔧 System

  • Enhanced internal asset validation mechanisms to automatically block broken or visually inconsistent SVGs.
v0.16.10 2026-04-07 15:57:00 (UTC)

🚀 Features

  • Added a "Help -> Demo" menu to explore read-only demonstration documents (Reference Mode), allowing users to safely view sample features without accidentally saving edits.

🐛 Bug Fixes

  • Fixed a bug where custom task list markers (e.g., [/], [-]) were incorrectly rendered as standard unchecked boxes.
v0.16.9 2026-04-07 12:49:00 (UTC)

🔧 System

  • Improved background rendering stability for preview panes; preview processing now continues in the background even when switching between tabs.
v0.16.8-2 2026-04-07 09:03:00 (UTC)

🐛 Bug Fixes

  • Fixed a regression where background elements (such as the editor or workspace tree) could be inadvertently interacted with while a modal was active.
v0.16.8-1 2026-04-07 04:10:00 (UTC)

🐛 Bug Fixes

  • Fixed a critical regression where the UI would freeze when opening modals (Workspace Toggle, Settings, Command Palette, Search) due to Z-order interaction conflicts.
v0.16.8 2026-04-07 01:35:00 (UTC)

✨ Improvements

  • Stabilized hover highlighting and scroll synchronization for rich blocks (such as diagrams, tables, and alerts) in the Markdown preview. Hovering over a rich block smoothly visualizes and maps precisely to its editor source lines. Split-pane scrolling near these blocks now stays perfectly aligned without jittering.
v0.16.7 2026-04-07 01:45:00 (UTC)

✨ Improvements

  • Refined the visual presentation of alert blocks (Note, Tip, etc.) by adjusting vertical margins and spacing for a more professional layout rhythm.
  • Updated the "Caution" alert icon to a dedicated prohibited/caution sign (🚫) for improved visual clarity and consistency.
v0.16.6 2026-04-06 16:08:00 (UTC)

✨ Improvements

  • Pinned tabs can now be directly unpinned by clicking the pin icon, without using the context menu.
v0.16.5 2026-04-06 15:30:00 (UTC)

✨ Improvements

  • Improved UI focus behavior: background elements (such as the editor and workspace tree) no longer react to hovers or clicks while a modal, popup, or overlay window is active.
v0.16.4 2026-04-06 14:35:08 (UTC)

✨ Improvements

  • Overall UI/UX improvements across the system.
v0.16.3 2026-04-03 09:50:00 (UTC)

🐛 Bug Fixes

  • UX Resilience: Relocated workspace tab & group configuration storage from the transient OS Cache directory to the persistent Application Settings directory (workspaces/*.json). This ensures that running common disk cleanup tools or OS cache purges will no longer accidentally delete your carefully organized tab groups and pinned tabs.
v0.16.2 2026-04-03 09:08:06 (UTC)

✨ Improvements

  • Fixed an issue where "mojibake" (character corruption) could occur across different operating systems by replacing OS-dependent emoji icons (e.g., download, hourglass, update badges) with natively rendered, cross-platform SVG icons.
  • Enhanced the UI for toggling between the editor and preview panels by introducing context-aware layout icons that dynamically reflect the horizontal or vertical split direction, making layout management more intuitive.
v0.16.1 2026-04-03 05:10:39 (UTC)

🐛 Bug Fixes

  • Fixed an issue where pinned tabs and tab groups were not successfully restored upon app restart due to inconsistent cached path resolution.
v0.16.0 2026-04-03 03:59:11 (UTC)

🚀 Features

  • Introduced a fullscreen slideshow viewer for Markdown documents, complete with pagination controls and seamless document activation.

🐛 Bug Fixes

  • Fixed a backward compatibility issue where legacy cache paths caused workspace tab groups to be lost upon restart.
v0.15.1 2026-04-03 00:10:00 (UTC)

🐛 Bug Fixes

  • Resolved an issue where tab groups leaked across different workspaces; tab groups are now correctly isolated and persisted per workspace.
v0.15.0 2026-04-02 23:30:14 (UTC)

✨ Improvements

  • Implemented interactive hover highlights for Markdown tables and accordion (<details>) blocks, ensuring the code editor synchronously highlights the exact source lines corresponding to the UI element.
v0.14.1 2026-04-02 15:10:57 (UTC)

🐛 Bug Fixes

  • Resolved a backwards-compatibility issue during workspace switching where tab states (pins and groups) saved in older versions were discarded and appeared lost upon restoration.
v0.14.0 2026-04-02 14:05:45 (UTC)

🚀 Features

  • Introduced the global Command Palette (accessible via Cmd+Shift+P / Ctrl+Shift+P), providing unified access to application commands with a fuzzy-search interface.

✨ Improvements

  • Enhanced command palette usability with dynamic height adjustment, window resizing support, and automatic focus tracking to keep the active selection visible.
  • Increased overall rendering stability by ensuring text with script-like characters gracefully falls back to plain text instead of triggering false-positive rendering errors.

🔧 System

  • Increased 100% UI localization compliance across all 10 supported languages by integrating translation parameters into deep workspace and file-operation dialogs.
v0.13.0 2026-04-02 10:15:00 (UTC)

🚀 Features

  • Introduced a realtime "Problems Panel", allowing users to quickly identify and navigate to Markdown authoring issues without leaving the editor canvas.
  • Added foundational local Markdown diagnostics, currently catching skipped heading levels and broken relative links, which are calculated in the background when documents are opened or saved.
v0.12.0 2026-04-02 04:45:00 (UTC)

🚀 Features

  • Introduced an integrated in-document search feature. Users can now search for specific text within the active Markdown file using the search bar embedded in the ViewModeBar, complete with hit counts and jumping between matches.
  • Added comprehensive keyboard navigation for the new document search. Pressing the ArrowUp or ArrowDown keys while focused in the search input quickly jumps to the previous or next match.

✨ Improvements

  • Silenced internal testing framework CLI noise to greatly improve developer application stability and reduce memory consumption during test cycles.

🐛 Bug Fixes

  • Fixed a crash that occurred when searching for specific multi-byte Japanese characters due to invalid character boundaries.
  • Repaired regression on scroll synchronization. Searching and navigating through document matches will now consistently scroll both the editor and preview panels to highlight the correct position.
v0.11.2 2026-04-02 00:30:00 (UTC)

🐛 Bug Fixes

  • Fixed an issue where diagram cache files were not properly cleared from persistent storage.
  • Resolved missing localization keys for the new Tab Groups feature across multiple languages.
  • Polished Tab Group UI layouts and resolved various internal linter warnings.
v0.11.0 2026-04-01 11:45:00 (UTC)

🚀 Features

  • Introduced the "Tab Groups" feature, allowing users to visually organize and consolidate multiple tabs. Groups can be assigned custom names and colors (from a curated palette of 7), and can be fully collapsed to maximize the editor screen area.
  • Enhanced accident prevention safeguards for "Pinned" tabs. Pinned files are now fully protected from bulk-close operations such as "Close Others" or "Close All".

✨ Improvements

  • Upgraded the workspace tab restoration (session persistence) logic on application restart, ensuring that advanced states such as tab group affiliations and pinned statuses are seamlessly retained across sessions.
v0.10.1 2026-04-01 09:35:00 (UTC)

✨ Improvements

  • Ensured that diagram previews immediately reflect theme and color changes without requiring an application restart.
  • Prevented rendering glitches where outdated cached diagrams in the previous color scheme would incorrectly display after switching themes.
v0.10.0 2026-04-01 07:34:00 (UTC)

✨ Improvements

  • Stabilized UI responsiveness and reduced disk I/O load during typing or frequent file navigation by restructuring the persistent caching strategy.
v0.9.0 2026-04-01 13:40:00 (UTC)

🚀 Features

  • Introduced a permanent Activity Rail on the left side of the workspace, consolidating the workspace toggle, search modal, and recently opened workspaces into a unified navigation bar.
  • Added a new "Flat View" mode for the workspace tree, displaying all files in a single list with workspace-relative paths, bypassing deeply nested directory structures.
  • Implemented natural sort algorithm across both Tree and Flat views to ensure versioned directories and files (e.g., v0-9 vs v0-11) are ordered intuitively by humans.

✨ Improvements

  • Supported drag-and-drop reordering for icons within the Activity Rail, naturally persisting layout preferences to user settings.
  • Rearranged the workspace header layout based on user feedback to prioritize readability and group action icons (Expand All, Collapse All, Refresh, Filter) more logically.
v0.8.11 2026-04-01 00:06:36 (UTC)

✨ Improvements

  • Stabilized synchronization between the editor and preview panels to prevent jittering during scroll, particularly at the bottom of long documents and in documents without headings.
v0.8.10 2026-03-31 22:30:00 (UTC)

✨ Improvements

  • Optimized the rendering flow when files are updated from external editors, reducing unnecessary flickering in the preview and applying updates faster.
  • Improved nested task lists formatting by allowing the entire row to be clicked to toggle checks.

🐛 Bug Fixes

  • Resolved a visual bug where multiple lines would highlight simultaneously on hover; the highlight is now precisely constrained to the row under the cursor.
v0.8.9 2026-03-31 02:17:00 (UTC)

🐛 Bug Fixes

  • Completely resolved the issue with Homebrew auto-updater conflicts. The application will now securely untap and detach itself from Homebrew package management silently in the background simply by launching the KatanA app normally.
v0.8.8-4 2026-03-31 01:05:00 (UTC)

🐛 Bug Fixes

  • Fixed an issue where the native auto-updater silently failed to remove the Homebrew link when updating KatanA from within the app. The auto-updater now correctly identifies Homebrew and untaps the cask upon successful transition.
v0.8.8-3 2026-03-31 00:20:00 (UTC)

🔧 System

  • Improved foundational stability for the internal update mechanism.
v0.8.8-2 2026-03-31 00:11:32 (UTC)

🐛 Bug Fixes

  • Fixed an issue where hyphenated version numbers (e.g., 0.8.8-1) were incorrectly identified as older versions, causing the new release details to not open automatically after an update.
v0.8.8-1 2026-03-30 23:00:00 (UTC)

🐛 Bug Fixes

  • Fixed an issue where the new version update dialog rendered English markdown text instead of localized strings.
v0.8.8 2026-03-30 14:30:00 (UTC)

🔧 System

  • Optimized internal dependencies for the Markdown preview engine, improving long-term maintainability and stability.
v0.8.7 2026-03-30 13:25:00 (UTC)

🔧 System

  • Strengthened internal application components and refined the release automation pipeline to guarantee delivery stability for future updates.
v0.8.6 2026-03-30 10:00:00 (UTC)

🔧 System

  • Restructured internal UI logic and rendering pipelines to significantly improve stability and maintainability for future enhancements.
  • Expanded automated test coverage to ensure better quality assurance across updates.
v0.8.5 2026-03-30 02:35:00 (UTC)

🐛 Bug Fixes

  • Fixed a UI regression where the left vertical guideline in expandable accordion (details) blocks was missing when opened.
v0.8.4-1 2026-03-30 02:35:00 (UTC)

🐛 Bug Fixes

  • Fixed a UI regression where the left vertical guideline in expandable accordion (details) blocks was missing when opened.
v0.8.4 2026-03-30 02:00:00 (UTC)

🔧 System

  • Optimized internal processing and improved the foundational stability of the application for future updates.
v0.8.3 2026-03-28 18:56:00 (UTC)

✨ Improvements

  • Added a mechanism to safely detach Katana Desktop from Homebrew management during auto-updates, ensuring older versions aren't automatically reinstalled by brew upgrade.
  • Eliminated CDN caching delays inside the ChangeLog viewer by actively appending cache-busting timestamps during version updates.

🐛 Bug Fixes

  • Fixed an issue where the ChangeLog tab would be incorrectly restored and cached as a zombie tab upon application restart.
v0.8.2 2026-03-28 18:45:00 (UTC)

🐛 Bug Fixes

  • Fixed an issue where the ChangeLog Viewer tab would disappear immediately on startup when restoring a previously opened workspace.
  • Fixed a bug where the accordion sections for the latest update were collapsed by default due to the application inadvertently forgetting its previous version state.
v0.8.1 2026-03-28 18:05:00 (UTC)

🐛 Bug Fixes

  • Fixed an issue where the ChangeLog Viewer would not display the latest release notes immediately after an application update due to network caching algorithms.
v0.8.0 2026-03-28 17:29:17 (UTC)

🚀 Features

  • Introduced an integrated ChangeLog Viewer UI, allowing users to conveniently browse recent application updates and release notes directly within the app.

✨ Improvements

  • Unified the alignment of icons and text across the application interface, specifically improving the vertical centering within the ChangeLog and navigation tabs for a cleaner look.

🔧 System

  • Strengthened network error handling and internal test coverage specifically around background data fetching to guarantee future stability.
v0.7.10 2026-03-28 04:31:08 (UTC)

🐛 Bug Fixes

  • Restored the missing UI Contrast logic, ensuring transparent background colors (like hover and active rows) correctly adapt their visibility against dark themes.
v0.7.9 2026-03-28 02:54:09 (UTC)

✨ Improvements

  • Redesigned the Custom Themes settings layout for better usability and a cleaner interface.

🐛 Bug Fixes

  • Improved the rendering of underlined text to fix an issue where underlines were not displayed correctly on certain macOS environments.
  • Fixed an issue where list markers, footnotes, and collapsible text did not properly update their colors when the theme was changed.
  • Fixed an issue where changing the theme could cause unsaved documents to be unexpectedly reloaded or discarded.
  • Unified hover and text selection highlight colors to match the active accent color across all themes.
v0.7.8 2026-03-27 13:03:25 (UTC)

🚀 Features

  • Introduced a UI contrast slider in the Appearance settings, allowing fine-grained control over visual contrast limits.
  • Added a dedicated 'Clear HTTP Cache' button within the System settings tab for on-demand cache directory purging.

✨ Improvements

  • Vertically centered and right-aligned color swatches in the Custom Themes grid, improving visual consistency and scanability across all settings panes.

🔧 System

  • Improved internal codebase quality by enforcing stricter translation standards.
  • Improved the performance of background analysis tools.
v0.7.7 2026-03-27 08:30:00 (UTC)

✨ Improvements

  • Optimized hover and current-line background transparency across all dark themes to improve text visibility.
  • Fixed a visual glitch where semi-transparent highlights would appear overly bright or washed out.
  • Overhauled the theme customization system to allow detailed adjustments for system elements, code blocks, and preview areas independently.

🐛 Bug Fixes

  • Resolved an error that could occur when clearing the image cache on macOS.

🔧 System

  • Eliminated hardcoded color values from the application to improve maintainability and theme stability.
v0.7.6 2026-03-26 21:20:00 (UTC)

🚀 Features

  • Provide granular control to adjust the auto-save interval with 0.1-second precision.
  • Implement toggles for hiding file extensions and add a fully functioning list-style UI for managing scan exclusion paths easily.
  • Support complete lifecycle actions for custom themes, including named saving, duplication, and explicit deletion.

✨ Improvements

  • Standardized all dropdown menus across the application for improved appearance and hover interactions.
  • Transition scroll synchronization configuration to an intuitive toggle switch and streamline layout order.
  • Rearrange custom theme color pickers vertically to dramatically improve visibility and usability within constrained side panels.

🐛 Bug Fixes

  • Fixed potential translation errors that could occur when switching application languages.
  • Fixed minor layout glitches and formatting issues.

🔧 System

  • Expanded UI and integration tests to improve application stability.
v0.7.5 2026-03-26 05:43:00 (UTC)

🐛 Bug Fixes

  • Resolve an issue where closing a tab would fail to load and render the preview for the newly activated tab if it was previously opened in the background without being rendered.
v0.7.4 2026-03-26 05:15:00 (UTC)

🚀 Features

  • Integrate a visual progress bar during the update download phase and correct the GitHub API release URL.

✨ Improvements

  • Redesign link rows to display aligned icons (e.g., External Link) and make the build version commit hash clickable.
  • Conditionally hide the markdown preview panel in System settings to optimize space.
  • Center accordion icons optically for a more balanced layout.

🐛 Bug Fixes

  • Resolve a critical degradation where the close tab button was rendered unclickable due to the drag-and-drop interaction overlay.
  • Fixed layout regressions where the window stretched horizontally out-of-bounds and the title bar rendered insufficiently short.
v0.7.3 2026-03-26 00:30:00 (UTC)

🚀 Features

  • Add context menus (Open, Rename, Delete, Copy) to directory and file items via right-click interaction.

✨ Improvements

  • Improve bidirectional drag-and-drop tab movement by unifying drop points to exact midpoints between tabs.
  • Support auto-scrolling when dragging a tab to the edges of the visible scroll area.

🐛 Bug Fixes

  • Fixed an issue where the background color for syntax highlighting was improperly rendered.
v0.7.2 2026-03-25 21:37:57 (UTC)

🐛 Bug Fixes

  • Fixed a bug where the update checker dialog would stretch vertically indefinitely in the "up to date" state. Added preventive measures against recurrence.
v0.7.1 2026-03-25 20:00:00 (UTC)

🐛 Bug Fixes

  • Eliminated reliance on rate-limited connections, resolving a fundamental architecture flaw that caused false network errors and blocked updates.
  • Repaired a layout calculation bug that caused the update checker modal to unpredictably stretch vertically with blank whitespace.
v0.7.0 2026-03-26 03:00:00 (UTC)

✨ Features

  • Implement interactive UI for the auto-update release framework, incorporating Markdown-rendered release notes and integrated extraction logic.
v0.6.4 2026-03-25 09:50:20 (UTC)

🐛 Bug Fixes

  • Manually draw underlines using proportional geometry bounds to bypass macOS CJK font metric corruption, ensuring <u> tags are consistently visible across all environments.

🔧 System

  • Implemented extensive internal unit tests to permanently guarantee inline formatting integrity and prevent visual regressions.
v0.6.3 2026-03-25 08:26:00 (UTC)

🐛 Bug Fixes

  • Remove trailing space from the Homebrew update command in localized update notification messages.
v0.6.2 2026-03-25 08:05:30 (UTC)

🚀 Features

  • Support for custom states ([/]), context menu interactions, and precision vertical alignment.
  • High-fidelity TeX/LaTeX equation rendering leveraging the MathJax pipeline for native-quality formatting.

✨ Improvements

  • Bidirectional scroll tracking between the editor and preview pane with exact block-level precision.
  • Visual highlight of the corresponding markdown structure under the cursor in Split-View mode.

🐛 Bug Fixes

  • Resolved internal panics related to multi-byte characters and eliminated scroll position drifting in long documents.
v0.6.1 2026-03-24 03:15:14 (UTC)

✨ Improvements

  • Resolved text clipping (left-side truncation) and misalignment within list items, tuning the positioning for CJK glyph centering.
  • Implemented stable, CSS-like centering behavior for tables using native layout calculations.
  • Expand clickable regions to cover both icon and name for directories/files, with hover effects and context menu support across the full row.
  • Active tab scrolls into view only on navigation button press, preventing unwanted scroll jumps during manual scrolling.
  • Apply consistent gray background to all sidebar icons (filter, TOC toggle, etc.) for improved visibility in light theme.
  • Remove extraneous padding on preview and main window outer frames, and equalize left/right inner margins.

🐛 Bug Fixes

  • Corrected vertical positioning of background fills for inline code and strikethrough text.
  • Fix header-row border rendering that was being cut off midway.
  • Implement per-column text alignment (left/center/right) as specified in Markdown alignment syntax.
  • Explicitly refresh file content from disk and correctly reset the visual state to prevent stale UI artifacts on diagram updates.
  • Ensure truly asynchronous/parallel tab loading when opening multiple files from a workspace directory, with the first file activated immediately.

🔧 System

  • Optimized internal testing environments and centralized resource management for overall quality improvements.
v0.6.0 2026-03-22 21:52:53 (UTC)

🐛 Bug Fixes

  • Fix 100% idle CPU utilization and spinner UI freeze by optimizing rendering and SVG load logic.
  • Fix list item line breaks inside blockquotes and remove unnecessary vertical whitespace around code blocks.
  • Transition from SVG icons to direct Painter API drawing for reliability. Adjusted button positioning for better visibility and UX.
  • Stabilize centrally squeezed layout by enforcing fixed widths on side panels.
  • Skip splash screen natively in test harness context without causing false positives.
  • Expanded test coverage for image loading fallback logic to maintain code quality standards.
v0.5.2 2026-03-22 12:44:52 (UTC)

🚀 Features

  • Added a "Workspace" settings tab allowing users to configure the maximum depth and ignored directories for scanning.

✨ Improvements

  • Significant reduction in idle CPU usage (from 75%+ to <5%) by optimizing window title updates, splash screen repaints, and font rebuilding logic.
  • Ensure rendering engine resources are properly released on workspace switch to prevent thread proliferation.

🐛 Bug Fixes

  • Fix persistence and ordering of recently opened workspaces.
  • Fix infinite spinner loop caused by unhandled rendering thread panic.

🔧 System

  • Improved stability by enhancing static code analysis.
  • Fix borrow checker errors, synchronize all i18n locale files, and achieve 100% test coverage gate.
v0.5.1 2026-03-22 09:41:24 (UTC)

🐛 Bug Fixes

  • Fix GitHub release creation by pushing the tag before creating the release
v0.5.0 2026-03-22 09:16:29 (UTC)

🚀 Features

  • Add Terms of Service agreement with version tracking
  • Implement Markdown export (HTML, PDF, PNG, JPG)

✨ Improvements

  • Polish Terms modal with language ComboBox and better centering
  • Workspace sidebar filter icon changed to ∇ (Nabla) for better semantics
v0.4.0 2026-03-21 13:05:00 (UTC)

🚀 Features

  • Add App Branding (Icon & Splash Screen)
  • Implement Check For Updates functionality
  • Add native menus for Checking for Updates, Help, and Donations
  • Optimize Diagram Texture implementation with cache
  • Add Trackpad support (Pan and Zoom) to Preview and Full-screen Viewers

🐛 Bug Fixes

  • Fix Native Fullscreen on macOS displaying black background
  • Support relative image resolution in Markdown
  • Fix integration TOC bugs
v0.3.1 2026-03-21 04:32:00 (UTC)

🚀 Features

  • Add FORCE=1 option to make release to skip all interactive confirmation prompts
  • Improved release automation controls for maintainers

🔧 System

  • Skip Git hooks (--no-verify) during release push as quality checks are pre-verified

  • Enable full local release flow (DMG build, GitHub publication, Homebrew update) as default

  • Reorganized release tooling into smaller maintainable parts

  • Improved the main release control flow for easier maintenance

v0.3.0 2026-03-21 03:52:24 (UTC)

🚀 Features

  • Implement Tab Context Menu (Close, Close Others, Close All) and Tab Restoration actions
  • Support automatic restoration of previously opened workspace tabs on startup
  • Add Editor Table of Contents (TOC) side panel with setting persistence and i18n support
  • Enable Editor Line Numbers and Current Line Highlighting features

🐛 Bug Fixes

  • Resolve CJK font baseline jitter in UI components
  • Prevent TOC side panel auto-expansion and ignore YAML frontmatter in outline
  • Improve Linux compatibility for macOS-specific emoji rendering code

🔧 System

  • Restore signed tag generation config after GPG environment setup
  • Update dependencies (rustls-webpki)
v0.2.1 2026-03-21 00:53:02 (UTC)

🔧 System

  • Updated project dependencies and release tooling

  • Fix coverage gap in preview_pane and codify release bypass rules

  • Resolve V0.2.0 archive omission and add AI warning block to next tasks

  • Rename repository to KatanA, reorganize documents, and support English translation

  • Specify language in settings window integration test to stabilize test

  • Collect_matches logic extraction and partial setting screen integration test addition for coverage improvement

v0.2.0 2026-03-20 19:16:37 (UTC)

🚀 Features

  • Add workspace persistence and tab restoration logic (Task 1)
  • Implement CacheFacade and stabilize all integration tests
  • Implement recursive expansion of workspaces and "Open All", and improve usability (Task 3, 5)
  • Localize metadata tooltips and apply to file items

🐛 Bug Fixes

  • Enforce strict lazy loading and restrict folder auto-expand on Open All
  • Abolish redundant filename tooltip and fix ast linter coverage
  • Restore missing absolute path in metadata tooltip and apply TDD

🔧 System

  • Refactor RwLock usage and fix external image caching on force reload
v0.1.6 2026-03-19 23:57:28 (UTC)

🚀 Features

  • Implement workspace search and filter functionality
  • Add internationalized text for search modal Include/Exclude options
  • Add inclusion/exclusion filter functionality to search modal and place search button in UI

🐛 Bug Fixes

  • Keep app version metadata aligned in macOS packages
  • Automatically sync internal version files during releases.

🔧 System

  • Prepare for v0.1.7 release
  • Prepare for v0.1.6 release
v0.1.5 2026-03-19 21:12:34 (UTC)

🚀 Features

  • Apply v0.1.5 changes and bump version to 0.1.5

🔧 System

  • Bump version to 0.1.4

  • Unify HashMap and fixed-length arrays into Vec, and apply collectively including AST rules and migration functionality

  • Fix tests broken by workspace methods renaming

  • Add missing tests to meet 100% coverage gate

v0.1.4 2026-03-19 21:03:35 (UTC)
v0.1.3 2026-03-19 19:59:23 (UTC)

🚀 Features

  • Expand theme presets from 10 to 30 (added OneDark/TokyoNight/CatppuccinMocha etc.)
  • Migrate i18n to type-safe structs (I18nMessages) and add 8 languages (zh-CN/zh-TW/ko/pt/fr/de/es/it)
  • Add 8 language tags to macOS native menu and dynamically translate menu strings according to language switching
  • Update entire UI for i18n/settings hierarchization, and implement OS language detection, theme expansion, and Show more/less toggle in settings screen

🐛 Bug Fixes

  • Recovery of missed v0.1.3 version update
  • Fix flaky tests where curl failed to start due to environment variable pollution during parallel test execution

🔧 System

  • Hierarchize settings.json structure (ThemeSettings/FontSettings/LayoutSettings) and add migration mechanism

  • Fix coverage gate and improve code quality

  • Update tests according to i18n type-safety, settings hierarchization, and theme expansion (integration/i18n/theme/diagram_rendering tests)

v0.1.2 2026-03-19 16:54:57 (UTC)

🚀 Features

  • Add i18n tooltips to tab navigation and slider

🐛 Bug Fixes

  • Fix left alignment of workspace file entries
  • Fix issue where font size slider becomes invisible in light theme
  • Add selection color border to slider to ensure visibility in all themes
  • Modify markdown preview tables to use available width
  • Fix bugs in table layout and vertical split scroll

🔧 System

  • Prepare for v0.1.2 release
  • Turn warnings into errors and remove unused code
  • Prepare for v0.1.2 release
v0.1.1 2026-03-19 10:54:34 (UTC)

🚀 Features

  • Support hidden directory display in workspace tree and add directory refresh button

🐛 Bug Fixes

  • Add error handling to Homebrew Cask update step
  • Prevent contamination of cached old DMG files
v0.1.0 2026-03-19 09:33:46 (UTC)

🚀 Features

  • Add Homebrew Cask support
  • Implement 10 theme presets and ThemeColors foundation (Task 1) (#23)
  • Implement foundation for font size and family settings (Task 2)
  • Implement theme linking and settings screen, and update snapshots (WIP)
  • Add dynamic acquisition of OS fonts and reflection in UI
  • Implement Task 4: editor/preview layout settings
  • Implement Task 5: OS theme linking (initial default auto-selection)
  • Implement Task 6: font setting expansion (search function + Apple Color Emoji)
  • Add strict quality checks to linter (prohibit use of todo! macro, etc.)
  • Improve UI functions such as font search, emoji support, and preview
  • Implement emoji inline rendering foundation and separate SVG/HTTP cache loaders
  • Enhanced internal mechanisms for early detection of potential implementation issues.

🐛 Bug Fixes

  • Improve .app signing (abolish --deep, specify runtime/timestamp, DMG remains unsigned)
  • Fix regression where workspace is not restored on startup
  • Improved emoji rendering in the Markdown preview

🔧 System

  • Improve change detection for code-quality checks

  • Prepare for v0.0.4 release

  • Exclude unnecessary old backup images (.old.png) when updating snapshots from Git tracking

  • Expand coverage gate exclusion rules (return None/false/display/Pending)

  • Prepare for v0.1.0 release (update version number)

  • Optimized codebase structure and brought comments up to international development standards.

  • Add tests for coverage improvement

v0.0.3 2026-03-18 02:50:23 (UTC)

🐛 Bug Fixes

  • Unify Coverage job with local make coverage
  • Improve DrawIo diagram text visibility in dark theme
  • Expand mmdc resolution from .app bundle to 6-layer fallback
  • Improve diagram snapshot verification stability in automated environments
  • Fix startup from GUI apps by supplementing node PATH when executing mmdc
  • Add margins above and below HTML blocks to resolve layout tightness

🔧 System

  • Update coverage exclusion reasons to accurate technical grounds

  • Prepare for v0.0.3 release

  • Change release notes to be extracted from CHANGELOG.md

  • Improved internal validation coverage around rendering rules

  • Unify Ignore tags to limited_local

  • Fix environment-dependent errors in snapshot verification

  • Fix global state conflict errors in multiple i18n tests

  • Add integration tests for diagram rendering and sample fixtures

v0.0.2 2026-03-17 09:20:28 (UTC)

🐛 Bug Fixes

  • Resolve linux cross-compilation errors for github actions
  • Resolve Markdown rendering, label update, and quality-check instability
  • Support CenteredMarkdown for raw HTML alignment reproduction
  • Fix CenteredMarkdown alignment, image path resolution, and badge display

🔧 System

  • Kick ci to retry integration tests

  • Release v0.0.2

  • Include complete release metadata in release v0.0.2

  • Update integration test snapshot

  • Tune snapshot comparison tolerance for text rendering differences across environments

v0.0.1 2026-03-16 23:16:22 (UTC)

🚀 Features

  • Bootstrap Katana macOS MVP — implementation of Rust project foundation and all core modules
  • Task 3.2 — native Markdown preview pane implementation
  • I18n support, language setting, appAction expansion, bin rename
  • Improve diagram rendering (Draw.io arrow support, Mermaid PNG output, CommandNotFound distinction)
  • Extend filesystem service (workspace tree and file monitoring improvements)
  • Tab-specific preview management, scroll synchronization, macOS native menu, workspace panel control
  • Enhance verification — introduction of lefthook, adding tests, tightening Clippy, defining quality gates
  • Improved stability by enhancing static code analysis.
  • Apply Katana app icon and version for native About panel (#15)
  • Implement settings persistence foundation (JsonFileRepository + SettingsService)
  • Auto-save settings when workspace or language changes
  • Restore saved settings (workspace, language) on startup
  • Improve preview functionality (image path resolution, section splitting starting fence support, diagram renderer improvements)
  • Improve About screen and unify app display name to KatanA
  • Add macOS app bundle (.app) packaging (#18)
  • Add macOS DMG installer generation (#19)
  • Automate release (git-cliff + make release) (#20)
  • Add release automation for distributing packaged builds (#22)
  • Add GitHub Sponsors URL settings and Japanese version of README

🐛 Bug Fixes

  • Fix Clippy warnings, formatting, and 30-line limit
  • Fix issues confirmed via screenshots
  • Improved PlantUML test isolation
  • Fix 3 issues — lazy loading, Mermaid fonts, and forced desktop move
  • Fix flaky issues in snapshot tests
  • Fixed code block layout inside lists in the Markdown preview
  • Improved macOS version metadata update compatibility
  • Add ad-hoc code signing to packaged releases
  • Fixed release automation branch targeting and version metadata
  • Improve build cache configuration and organize English/Japanese changelogs
  • Avoid build-cache conflicts during tool installation
  • Improved lint-job compatibility for Rust checks

🔧 System

  • Bootstrap katana repository

  • Remove opsx prompt files

  • Align gitignore with official templates

  • Mark Task 6.2 as completed — bootstrap-katana-macos-mvp all tasks completed

  • Exclude local planning files from version control

  • Update ignore rules for local planning, notes, and nested project settings

  • Delete unnecessary document templates and README

  • Add automated quality coverage checks and document quality gates

  • Tighten release quality requirements and delete unnecessary assets

  • Integrate lefthook validation commands into Makefile and automate fixes

  • Updated desktop and Markdown rendering dependencies

  • Add GitHub Sponsors URL settings and Japanese version of README

  • Improve release-note generation settings

  • Prepare for v0.0.1 release

  • Fix clippy warnings in drawio_renderer

  • Migrate tests from src/ to tests/ directory and tighten Clippy

  • Refactor katana-ui into lib/binary structure and extract logic

  • Extract magic numbers into named constants with clear purpose

  • Externalize language definitions to locales/languages.json

  • Unify span_location duplication into free functions (self-review fix)

  • Separated rendering logic and event routing

  • Translate Japanese comments and strings in source code and tests to English

  • Improve UI layout and add linter module

  • Task 6.2 — add preview synchronization tests

  • Add app state unit tests and fix java headless mode for plantuml

  • Add unit tests for preview synchronization (Task 3.2 completed)

  • Tighten coverage — removed ignore-filename-regex, abolished #[coverage(off)], enforced 100% Regions

  • Address differences in LLVM coverage calculation and tighten 100% test gate

  • Add integration tests for persistence round-trip

關於版本資訊的單一事實來源

  • GitHub Releases是所有版本產物及詳細說明的官方標準源。
  • 倉庫README定義了各類環境下的標準安裝及維護流程。

Support

支持 KatanA 開發

若這條安裝指令有幫助,歡迎為 KatanA 點 Star 或贊助。

How to star on GitHub