Skip to content

system

This tool covers SiYuan system reads, network status, configuration reads, user notifications, and explicit sync triggering.

When to read this page: you need runtime status rather than notebook or document content.

Related pages:

Actions

GroupActions
Basic infoget_version, get_current_time, changelog
Config / environmentconf, network, workspace_info
Notificationsnotify
Syncperform_sync

Safety Rules

  • workspace_info is high-risk because it exposes the absolute workspace path and requires confirmation.
  • conf is read-only. Use mode="summary" for a compact overview, or mode="get" with keyPath for a specific field.
  • changelog is read-only. Use fromVersion after plugin upgrades to find changes that may affect user rules, /AGENTS.md memory, permissions, appearance, connection snippets, timeline settings, or tool configuration.
  • notify shows a SiYuan notification with msg, level, and optional timeout.
  • perform_sync triggers SiYuan sync immediately through /api/sync/performSync. It requires confirmation.

Action List

  • workspace_info
  • network
  • conf
  • notify
  • changelog
  • perform_sync
  • get_version
  • get_current_time

Released under the MIT License.