Question 1

Why does 'Insert image or file' do nothing in SiYuan database item detail panel?

Accepted Answer

Known bug in SiYuan v3.8.6/v3.8.7 (Windows and likely mobile): the standalone database item panel renders an unmounted 'ghost' Protyle editor, so the shared upload entry fails the `protyle.element.isConnected` check in `isUploadDocumentAvailable` and silently cancels the upload before any network request — no error is shown, the file input is just cleared. Upgrading to v3.8.7 does NOT fix it. Workaround: add the image/file directly through the asset cell in the database table view instead of the standalone item detail panel — table uploads use a mounted editor and work normally. A permanent fix requires giving the standalone panel a real mounted upload target while keeping document/notebook/field identity checks; track the GitHub issue for the patch.

Question 2

Why does SiYuan skip the workspace lock screen (password) after switching workspaces?

Accepted Answer

This is a lock screen session lifecycle bug in SiYuan (affects versions up to 3.8.9-beta.5). Multiple desktop workspaces share one Electron session, so closing workspace Note1's window while Note2 stays open keeps the login cookie alive — switching back to Note1 then skips the lock screen.

Fix: Update to a SiYuan release containing commit 754558f936 (fixed in dev branch after 3.8.9-beta.5), then log in again so the new rule applies. After the fix, a desktop login without "Remember me" is bound to the current kernel session: once a workspace truly exits and reopens, re-authentication is required even if other workspaces are still running. Checking "Remember me" keeps the old 30-day policy; hiding, minimizing, or canceling quit does not invalidate the login. The same rules apply to password and OIDC logins; browser and mobile login policies are unchanged.

Workaround on older versions: fully quit the entire SiYuan app (not just close the workspace window) and relaunch it — the lock screen will then appear when switching back to the locked workspace.

Question 3

Why does my self-hosted deployment keep showing an error prompt and how to fix it?

Accepted Answer

This error typically indicates missing WebSocket reverse proxy configuration. In your reverse proxy (Nginx, Caddy, etc.), add a WebSocket upgrade rule. For example, in Nginx: location /ws { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; }. Refer to the project's README or deployment guide for exact paths and settings. After configuring, restart the proxy.

Question 4

How to stop a SiYuan mind map from hijacking mouse wheel scrolling of the document?

Accepted Answer

Current fix: click the mind map's "Lock View" (锁定视图) button. Locking freezes the canvas position and zoom, so the wheel scrolls the document instead of panning the canvas; unlock when you need to pan, zoom, or edit. Lock/Unlock works on both desktop and mobile (#19924). Existing boundary rules also help: when the mind map's vertical content fully fits in the viewport, the wheel scrolls the document directly (#20021), and once the canvas is panned to its edge, further scrolling passes back to the document (#19833). A redesign has been confirmed by the maintainer in #20670: the wheel will scroll the document by default, panning requires explicitly entering canvas mode (click blank canvas or the "Edit Canvas" button; two-finger drag/pinch on touchpad and mobile), Ctrl/Cmd+wheel or pinch to zoom, and Esc or clicking outside returns to reading mode.

Question 5

Why don't keyboard shortcuts (Command+F search) work with a Chinese input method on iPad in SiYuan Note?

Accepted Answer

This is a known bug in SiYuan (reported on v3.8.6, iPad with Magic Keyboard or external keyboards): shortcuts like Command+F fail while a Chinese IME composition session is active, because the app doesn't correctly regain focus after native IME composition ends. The fix adjusts short-press activation, repeated-click suppression, and search focus/cursor restoration after IME composition ends—update SiYuan to the latest version to get it. Workarounds on older versions: 1) Switch to the English keyboard layout before pressing shortcuts. 2) If Esc won't close the search panel, tap the search input field once first, then press Esc. 3) If a stray character (e.g., 'f') remains in the document after closing search, delete it manually and re-click to reposition the cursor.

siyuan

Core Features

What It Can't Do

Use Cases

Tags

Getting Started

Similar Projects