SiYuan v3.8.0

Overview

This major release expands SiYuan's AI capabilities and integrations, bringing more powerful database and editing tools, LAN-assisted cloud synchronization, and a smoother experience across platforms.

AI-powered knowledge management

Semantic search powered by embeddings and reranking helps you find relevant notes more accurately, while the new AI Agent lets you work with your knowledge in natural language.

Model Context Protocol

MCP support lets external AI assistants and tools interact with your SiYuan knowledge base through a standardized interface, enabling richer automations and integrations.

More powerful databases and editing

Automatic heading numbering, improved navigation and folding, richer table and database views, more flexible filtering and selection, and smoother search and history workflows further improve the efficiency of everyday knowledge management.

Faster cloud synchronization over LAN

With LAN peer assistance, devices on the same local network can share data during cloud synchronization, improving transfer efficiency and reducing internet data usage.

A smoother experience across platforms

From mobile tabs, multi-selection, audio recording, and custom fonts to better export previews, PDF handling, and HarmonyOS support, this release polishes the experience across desktop, tablet, and phone.

Changelogs

Below are the detailed changes in this version.

Feature

• Support Model Context Protocol (MCP)
• Semantic search using AI embeddings and reranking
• AI Agent
• Support secure OIDC authentication

Enhancement

• Support automatic heading numbering
• Support breadcrumb child block navigation
• Improve table functionality
• Support folding and expanding sibling and direct child headings
• Support cross-block selection of some inline elements and then settings
• Support multiple display formats for database date fields
• Support configuring visible views per database block
• Improve pasting tabular data into the database
• Support find and replace in search results grouped by document
• Support vertical alignment for horizontal super blocks
• Improve data snapshot comparison filtering and file categorization
• Support transitive backlinks for document and heading blocks
• Improve database field visibility management across views
• Support filtering in the tag panel
• Support filtering relation candidates and rollup items in databases
• Improve sorting for downloaded marketplace packages
• Support comparing document versions in file history and data snapshots
• Improve audio recording with MP3 encoding and AudioWorklet
• Support blockquote blocks to make flashcards
• Support a database multi-selection editing toolbar
• Support back and forward navigation in the PDF viewer
• Improve PDF rectangle annotation visibility on dark backgrounds
• Support transforming multiple headings with their subheadings
• Improve export preview layout and scrolling in small panes
• Support Shift+Click range selection in database views
• Support interactions with rendered HTML elements in database template fields
• Improve database tables by replacing fixed columns with a frozen column range
• Improve preservation of expanded document tree state when moving documents
• Improve folded list item state after child block changes
• Support adding network images to database asset fields
• Improve dock button tooltip positioning
• Improve the mobile text selection toolbar by integrating the plugin menu
• Improve arrow key navigation when entering and leaving database blocks
• Improve opening database search results
• Improve dynamic document loading with global content retention and load-all support
• Improve spell checking with suggestions and custom dictionary support
• Support network images for document and notebook icons
• Improve database table column width adjustment
• Improve pasting multiple cells into a table from a single target cell
• Support document cover images, icons, and tags in floating windows
• Improve deletion confirmation for referenced blocks, documents, and notebooks
• Improve icon editing for database-bound documents in floating windows
• Improve emoji picker organization and loading performance
• Support creating and binding documents for detached database items
• Improve database relation selection with multi-field table display
• Improve document title visibility in backlink and mention panels
• Mobile keyboard toolbar is hidden behind the virtual keyboard in iOS PWA
• Improve editing selected options in database select and multi-select fields
• Support frontends in theme manifests
• Delay showing dock panels in floating layout
• Flashcard pages are not refilled after removing cards
• Support dynamically loading all items in database relation popups
• PDF colors follow theme instead of PDF mode
• Improve list shortcut behavior within lists
• Improve blockquote shortcut behavior within blockquotes
• Support prompting users to press Ctrl+A again to select all loaded content blocks
• Improve mobile menu layout, navigation, and interactions
• Improve mobile block gutter display after the keyboard opens
• Improve table cell selection when dragging across table boundaries
• Cursor disappears after deleting incomplete Chinese input following an inline formula in a table cell
• Improve the Turn into menu for empty blocks
• Support a context menu for document tags on desktop
• Support selecting text from the cursor to page boundaries with customizable shortcuts
• Document titles are included in content selections on Android
• Improve inline formula editing with arrow-key navigation
• Improve context switching in floating windows
• Support editing database fields for selected items from the context menu
• Support mouse drag selection for database items
• Support Ctrl+drag selection of multiple blocks
• Improve multi-block reference insertion when dragging blocks
• Support hiding the primary field in database gallery views
• Support adjusting cover image positions in database card and kanban views
• Improve search and replace for text spanning escaped nodes
• Support opening database blocks from the database attribute panel on tablets
• Improve unsplitting the current pane
• Improve search result consistency when editing keywords
• Support filtering database date fields by start or end date
• Improve copying and pasting empty cells in database table views
• Improve database date and relation default values
• Support displaying option descriptions when hovering over select and multi-select options in database views
• Support precise database relation filters
• Support relative font sizes in the mobile inline element menu
• Support sorting database date fields by start or end date
• Support displaying empty fields in database card and kanban views
• Support custom card width and preview aspect ratio in database gallery and kanban views
• Improve PDF Rectangle Annotation Moving, Resizing, and Copying
• Support disabling the middle dot code block shortcut
• Support document tabs on mobile
• Remember outline expand levels
• Support Mermaid layouts through chart block custom attributes
• Improve "Recent Documents" on mobile
• Improve document tree menus for multiple and mixed selections
• Support copying rich text and HTML from selection and block menus
• Support reordering database kanban columns via drag-and-drop
• Support quick actions for select and multi-select groups in database kanban views
• Improve the "New item has been filtered" notification
• Support dynamic and network icons in recent emojis
• Improve searching view names in Add to Database
• Support expanding or folding all database groups at once
• Support inserting different database views directly from the slash menu
• Support compact layouts in database card and kanban views
• Support recursively converting nested lists to other list types or paragraphs
• Improve block reference insertion after cursor movement
• Improve marketplace package update checks and installed package metadata handling
• Improve marketplace package details and management actions
• Improve settings UI
• Support adding list items to the beginning or end of the current list
• Support file history and data snapshot versions in the document Data History menu
• Keep the text appearance menu open after applying a style on mobile
• Improve PDF export preview behavior when canceling destination selection
• Improve AI provider and model configuration interactions
• Support installing local marketplace packages from .zip files
• Support multiple filter values for database single-select fields
• Support embedding HTML files as IFrame blocks
• Improve heading folding to preserve descendant fold states
• Improve drag-and-drop support for external mice on Android
• Support searching documents by hierarchical paths
• Support filtering in the bookmark panel
• Show backlinks and mentions at the bottom of documents
• Improve cursor restoration after undoing block creation while writing
• Improve database attributes at the top of the editor
• Improve list type preservation when pasting into paragraphs inside list items
• Improve error details for Obsidian Vault imports
• Pressing Backspace or Shift+Tab breaks the list hierarchy.
• Support callout blocks to make flashcards
• Disable the iframe event when dragging handles to resize panels
• Support batch insertion of images and files in the HarmonyOS editor
• Improve TLS certificate handling after local IP address changes
• Files shared from WeChat are inserted as invalid local URLs on iPhone
• Optimize drag-and-drop interaction for document tree and outline on mobile
• Avoid blank pages and overlapping content when exporting Mermaid diagrams to PDF
• Support converting non-contiguous selected blocks
• Improve formula clipping
• Preserve video and audio assets with spaces in filenames when exporting Markdown.zip
• Improve backlink panel refresh with incremental DOM updates
• Improve search highlighting to match text before HTML escaping
• Improve flashcard answer display for folded blocks
• Support configuring database badge click behavior
• Support Stable, Beta, and Alpha update channels
• Improve the visibility of primary key cell action buttons
• Improve copying selected rich text and images to external applications on Desktop
• Improve inline style rendering in the outline panel
• Keyboard opens when tapping an embed block in a locked document on Huawei tablets
• Support pinning the database view toolbar while scrolling
• Improve text selection menu compatibility on HarmonyOS
• Support configuring a default template for new documents
• Improve the unreferenced assets layout on mobile
• Improve title image, tag, and icon button visibility after unlocking documents on mobile
• Improve paste experience for VSCode Markdown files
• Improve custom font support for variable fonts
• Improve dialog closing order for system back actions on Android and HarmonyOS
• Improve RPM package compatibility with other Electron applications
• Improve data synchronization performance
• Support importing custom fonts on mobile
• Improve drag and drop visual cues and tooltips
• Support audio recording on Android and HarmonyOS
• Improve built-in Pandoc storage and upgrade compatibility
• Support configurable tab startup behavior
• Improve handling when overwriting an export file that is in use
• Support S Pen hover for block popovers on Android tablets
• Improve Add to Database list opening performance
• Support configuring the visibility of menu items and dock icons
• Improve mobile export destination and completion feedback
• Support creating child documents from reference menus
• Support dragging document tabs to the Documents panel
• Improve database view state management by removing the top-level ViewID
• Improve editor font selector performance with large system font collections
• Improve drag selection for nested container blocks
• Support LAN peer-assisted acceleration for cloud data sync
• Support full-width tildes as a strikethrough input shortcut
• Support detecting Intel builds running through Rosetta
• Improve asset storage for ordinary notebook imports

Bugfix

• PDF anchor links become invalid when exporting documents containing asset files
• HTML block update after undo is escaped
• Custom document icons are not applied to file trees after interface refresh
• Structural flashcard options incorrectly trigger Show Answer for document flashcards
• Content can be inserted into list item markers
• Virtual references convert document characters into HTML entities
• Code snippet titles disappear in the built-in manager
• Concurrent search indexing creates duplicate entries
• Asset files containing consecutive periods return 403 Forbidden
• CLI document get displays an empty title and omits creation and update times
• Some security vulnerabilities
• Blank space above database tables grows after repeated scrolling
• Opening a document-bound database primary key incorrectly focuses the document
• Entering - at the beginning of a list item's first child block clears its content
• Deleting a document tag on mobile also deletes the adjacent tag
• Parent document still shows expand icon after moving all child documents
• Clicking a database primary key block reference temporarily prevents document scrolling
• Child block order is reversed after duplicating a folded heading
• A duplicate empty column appears after dragging a list item block to the right of a super block
• Kernel CLI block and document operations can corrupt paths, bypass dry-run validation, silently fail moves, and leave stale SQL indexes
• Yuque clipping omits image URLs and lazy-loaded code blocks
• Table menus fail to open after pasting copied table cells
• HTML and PDF export can crash with a stack overflow when footnotes contain merged-cell tables with nested block refs
• Daily note templates may query incomplete data before indexing finishes
• Unable to undo edits made within embed blocks from the containing document
• Document deletion may leave stale block attributes and related caches
• SVG images containing DOCTYPE declaration display 422 Unprocessable Content
• Directory assets appear in both unused and missing asset lists
• Password-protected published documents show a block-not-found error instead of the password prompt
• Callout image icons become title text after optimizing typography
• List item content is lost when inserting a nested list from the slash menu

Document

• Improve the user guide

Refactor

• Upgrade to PDF.js v4.8.69
• Bump Electron to v42.7.1
• Upgrade abcjs 6.5.0 to 6.7.0
• Refactor graph rendering to replace vis-network

Development

• Improve plugin paste event handling when replacing clipboard data
• Support top-level await and console error logging in embed block JavaScript queries
• Add kernel API /api/filetree/setSort
• Support block type locking for block updates
• Improve kernel file watcher behavior on macOS and mobile platforms
• Enhance API documentation for forward proxy features
• Support API /api/block/getDocBlocksOrders for document block order
• Improve IAL attribute ordering stability in the getBlockKramdown API

Download

• B3log
• GitHub