X-Ray Plugin Beta Release Notes v26.4.21.2-beta

This beta release introduces significant performance improvements, more reliable data management, and several new features designed to make the AI-powered reading experience smoother and more responsive.

Major Improvements

AI and Data Features

• Silent Background Updates: AI data updates now happen quietly in the background as you progress through chapters. This removes the need for intrusive popups, allowing you to keep reading without interruption.
• Smart Chapter Filtering: The plugin now intelligently ignores non-narrative sections like covers, tables of contents, and bibliographies to save on AI processing and provide a cleaner timeline.
• Better Character Management: Improvements to the character list now prevent duplicates and ensure more accurate role-based sorting, prioritizing the most important figures in your story.
• Robust Timeline Sorting: The timeline now uses physical page locations for sorting instead of relying solely on chapter titles. This makes chronological navigation much more accurate, even in books with complex structures or missing tables of contents.

Performance and Reliability

• Instant Book Opening: We have optimized how the plugin loads data when you open a book, making it ideal for large Omnibus editions. By deferring non-essential processing, we have eliminated the 15-second UI freeze that previously occurred.
• API Key Protection: A critical fix ensures that your Gemini or ChatGPT API keys are no longer deleted during plugin updates. Your configuration is now safely preserved across versions.

Maintenance and Health

• Log Rotation: Logs are now automatically capped at 512KB to save space on your device.
• Clear Logs: You can now manually clear logs directly from the Maintenance menu if you need to free up space or start a fresh session.

Technical Details (for those interested)

• Implemented a new xray_logger.lua module for better performance and rotation.
• Optimized onReaderReady and autoLoadCache to prevent blocking the main UI thread.
• Added a 2-second debounce and silent network checks for background merge fetches.
• Standardized timeline sorting using a multi-strategy page matcher.

User Verification

• Please double-check your API keys in the Settings > AI Settings menu to ensure they migrated correctly.
• If you notice any issues with character duplication or timeline sorting, please report them through the usual channels.

Full Changelog: 26.4.21.1-beta...26.4.21.2-beta