siyuan 1.1.7 → 1.1.8

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## v1.1.8 2026
+## v1.1.9 2026
+
+## v1.1.8 2026-03-11
+
+* [Update plugin util  `platformUtils`](https://github.com/siyuan-note/siyuan/issues/17150)
+* [Add plugin function `openEmoji`](https://github.com/siyuan-note/siyuan/issues/17117)
+* [Add plugin function `getAllTabs`](https://github.com/siyuan-note/siyuan/issues/17140)
+* [Make hotkey optional for plugin commands and toolbar](https://github.com/siyuan-note/siyuan/pull/16676)
+* [Improve IProtyleOptions](https://github.com/siyuan-note/plugin-sample/issues/38)
+* [Improve error handling and security for plugin data storage methods](https://github.com/siyuan-note/siyuan/pull/16717)
+* [Update type definitions for TOperation, Constants and TProtyleAction](https://github.com/siyuan-note/petal/pull/46)
+* [Display a confirmation prompt when inserting large assets 256MB](https://github.com/siyuan-note/siyuan/issues/16685)
+* [Update fetchPost parameters](https://github.com/siyuan-note/petal/issues/47)
 
 ## v1.1.7 2025-12-23
 

package/package.json

@@ -12,7 +12,7 @@
         "README.md",
         "siyuan.d.ts"
     ],
-    "version": "1.1.7",
+    "version": "1.1.8",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/siyuan-note/petal.git"

package/siyuan.d.ts

@@ -98,13 +98,22 @@ export type TOperation =
     | "setAttrViewFitImage"
     | "setAttrViewShowIcon"
     | "setAttrViewWrapField"
-    | "setAttrViewColDate"
-    | "unbindAttrViewBlock"
+    | "setAttrViewColDateFillCreated"
+    | "setAttrViewColDateFillSpecificTime"
     | "setAttrViewViewDesc"
     | "setAttrViewColDesc"
     | "setAttrViewBlockView"
     | "setAttrViewGroup"
+    | "removeAttrViewGroup"
+    | "hideAttrViewAllGroups"
     | "syncAttrViewTableColWidth"
+    | "hideAttrViewGroup"
+    | "sortAttrViewGroup"
+    | "foldAttrViewGroup"
+    | "setAttrViewDisplayFieldName"
+    | "setAttrViewFillColBackgroundColor"
+    | "setAttrViewUpdatedIncludeTime"
+    | "setAttrViewCreatedIncludeTime"
 
 export interface Global {
     Lute: typeof Lute;
@@ -200,7 +209,11 @@ export interface IEventBusMap {
         textHTML: string,
         textPlain: string,
         siyuanHTML: string,
-        files: FileList | DataTransferItemList | string[]; // 读取本地文件时为 string[]
+        localFiles: {
+            path: string,
+            size: number
+        }[]
+        files: FileList | DataTransferItemList
     };
     "ws-main": IWebSocketData;
     "sync-start": IWebSocketData;
@@ -239,9 +252,9 @@ export interface ICommand {
      * "Delete": "⌦",
      * "Enter": "↩",
      */
-    hotkey: string,
+    hotkey?: string,
     customHotkey?: string,
-    callback?: () => void   // 其余回调存在时将不会触
+    callback?: () => void   // 其余回调存在时将不会触发
     globalCallback?: () => void // 焦点不在应用内时执行的回调
     fileTreeCallback?: (file: Files) => void // 焦点在文档树上时执行的回调
     editorCallback?: (protyle: IProtyle) => void     // 焦点在编辑器上时执行的回调
@@ -270,7 +283,13 @@ export function adaptHotkey(hotkey: string): string
 
 export function confirm(title: string, text: string, confirmCallback?: (dialog: Dialog) => void, cancelCallback?: (dialog: Dialog) => void): void;
 
-export function fetchPost(url: string, data?: any, callback?: (response: IWebSocketData) => void, headers?: IObject): void;
+export function fetchPost(
+    url: string,
+    data?: any,
+    cb?: (response: IWebSocketData) => void,
+    headers?: IObject,
+    failCallback?: (response: IWebSocketData) => void
+): void;
 
 export function fetchSyncPost(url: string, data?: any): Promise<IWebSocketData>;
 
@@ -351,6 +370,8 @@ export function exitSiYuan(): void
 
 export function getAllEditor(): Protyle[]
 
+export function getAllTabs(): Tab[]
+
 export function getAllModels(): {
     editor: [],
     graph: [],
@@ -367,6 +388,14 @@ export function getAllModels(): {
 
 export function openSetting(app: App): Dialog | undefined;
 
+export function openEmoji(options: {
+    position: IPosition,
+    selectedCB?: (emoji: string) => void,
+    dynamicIconURL?: string
+    hideDynamicIcon?: boolean
+    hideCustomIcon?: boolean
+}): void ;
+
 export function getModelByDockType(type: TDock | string): Model | any;
 
 /**
@@ -461,9 +490,9 @@ export abstract class Plugin {
 
     loadData(storageName: string): Promise<any>;
 
-    saveData(storageName: string, content: any): Promise<void>;
+    saveData(storageName: string, content: any): Promise<IWebSocketData>;
 
-    removeData(storageName: string): Promise<any>;
+    removeData(storageName: string): Promise<IWebSocketData>;
 
     addIcons(svg: string): void;
 

package/types/constants.ts

@@ -115,6 +115,7 @@ export abstract class Constants {
     public static readonly CB_GET_BACKLINK = "cb-get-backlink"; // 悬浮窗为传递型需展示上下文
     public static readonly CB_GET_UNUNDO = "cb-get-unundo"; // 不需要记录历史
     public static readonly CB_GET_SCROLL = "cb-get-scroll"; // 滚动到指定位置，用于直接打开文档，必有 rootID
+    public static readonly CB_GET_SEARCH = "cb-get-search"; // 通过搜索打开
     public static readonly CB_GET_CONTEXT = "cb-get-context"; // 包含上下文
     public static readonly CB_GET_ROOTSCROLL = "cb-get-rootscroll"; // 如果为 rootID 就滚动到指定位置，必有 rootID
     public static readonly CB_GET_HTML = "cb-get-html"; // 直接渲染，不需要再 /api/block/getDocInfo，否则搜索表格无法定位
@@ -259,6 +260,7 @@ export abstract class Constants {
     public static readonly MENU_SEARCH_REPLACE_HISTORY = "search-replace-history"; // 替换历史菜单
     public static readonly MENU_SEARCH_ASSET_HISTORY = "search-asset-history"; // 资源文件搜索历史菜单
     public static readonly MENU_MOVE_PATH_HISTORY = "move-path-history"; // 移动文档窗口搜索历史菜单
+    public static readonly MENU_CALLOUT_SELECT = "callout-select"; // 提示选择菜单
 
     public static readonly MENU_BACKGROUND_ASSET = "background-asset"; // 资源文件选择器菜单
     public static readonly MENU_AI = "ai"; // 块 AI 菜单
@@ -276,6 +278,7 @@ export abstract class Constants {
     // timeout
     public static readonly TIMEOUT_OPENDIALOG = 50;
     public static readonly TIMEOUT_DBLCLICK = 190;
+    public static readonly TIMEOUT_RESIZE = 200;
     public static readonly TIMEOUT_INPUT = 256;
     public static readonly TIMEOUT_LOAD = 300;
     public static readonly TIMEOUT_TRANSITION = 300;
@@ -291,9 +294,11 @@ export abstract class Constants {
         he_IL: "20210808180117-6v0mkxr",
         it_IT: "20210808180117-6v0mkxr",
         ja_JP: "20240530133126-axarxgx",
+        ko_KR: "20210808180117-6v0mkxr",
         pl_PL: "20210808180117-6v0mkxr",
         pt_BR: "20210808180117-6v0mkxr",
         ru_RU: "20210808180117-6v0mkxr",
+        tr_TR: "20210808180117-6v0mkxr",
         zh_CHT: "20211226090932-5lcq56f",
         zh_CN: "20210808180117-czj9bvb",
     };
@@ -783,7 +788,7 @@ export abstract class Constants {
     public static readonly SIYUAN_ASSETS_IMAGE: string[] = [".apng", ".ico", ".cur", ".jpg", ".jpe", ".jpeg", ".jfif", ".pjp", ".pjpeg", ".png", ".gif", ".webp", ".bmp", ".svg", ".avif", ".tiff", ".tif"];
     public static readonly SIYUAN_ASSETS_AUDIO: string[] = [".mp3", ".wav", ".ogg", ".m4a", ".aac", ".flac"];
     public static readonly SIYUAN_ASSETS_VIDEO: string[] = [".mov", ".weba", ".mkv", ".mp4", ".webm"];
-    public static readonly SIYUAN_ASSETS_EXTS: string[] = [".pdf"].concat(Constants.SIYUAN_ASSETS_IMAGE).concat(Constants.SIYUAN_ASSETS_AUDIO).concat(Constants.SIYUAN_ASSETS_VIDEO);
+    public static readonly SIYUAN_ASSETS_EXTS: string[] = [".pdf"].concat(Constants.SIYUAN_ASSETS_IMAGE, Constants.SIYUAN_ASSETS_AUDIO, Constants.SIYUAN_ASSETS_VIDEO);
     public static readonly SIYUAN_ASSETS_SEARCH: string[] = [".txt", ".md", ".markdown", ".docx", ".xlsx", ".pptx", ".pdf", ".json", ".log", ".sql", ".html", ".xml", ".java", ".h", ".c",
         ".cpp", ".go", ".rs", ".swift", ".kt", ".py", ".php", ".js", ".css", ".ts", ".sh", ".bat", ".cmd", ".ini", ".yaml",
         ".rst", ".adoc", ".textile", ".opml", ".org", ".wiki", ".epub", ".cs"];
@@ -840,7 +845,7 @@ export abstract class Constants {
     public static readonly BLOCK_HINT_KEYS: string[] = ["((", "[[", "（（", "【【"];
     public static readonly BLOCK_HINT_CLOSE_KEYS: IObject = {"((": "))", "[[": "]]", "（（": "））", "【【": "】】"};
     // common: "bash", "c", "csharp", "cpp", "css", "diff", "go", "xml", "json", "java", "javascript", "kotlin", "less", "lua", "makefile", "markdown", "objectivec", "php", "php-template", "perl", "plaintext", "python", "python-repl", "r", "ruby", "rust", "scss", "sql", "shell", "swift", "ini", "typescript", "vbnet", "yaml", "properties", "1c", "armasm", "avrasm", "actionscript", "ada", "angelscript", "accesslog", "apache", "applescript", "arcade", "arduino", "asciidoc", "aspectj", "abnf", "autohotkey", "autoit", "awk", "basic", "bnf", "dos", "brainfuck", "cal", "cmake", "csp", "cos", "capnproto", "ceylon", "clean", "clojure", "clojure-repl", "coffeescript", "coq", "crystal", "d", "dns", "dart", "delphi", "dts", "django", "dockerfile", "dust", "erb", "elixir", "elm", "erlang", "erlang-repl", "excel", "ebnf", "fsharp", "fix", "flix", "fortran", "gcode", "gams", "gauss", "glsl", "gml", "gherkin", "golo", "gradle", "groovy", "haml", "hsp", "http", "handlebars", "haskell", "haxe", "hy", "irpf90", "isbl", "inform7", "x86asm", "jboss-cli", "julia", "julia-repl", "ldif", "llvm", "lsl", "latex", "lasso", "leaf", "lisp", "livecodeserver", "livescript", "mel", "mipsasm", "matlab", "maxima", "mercury", "axapta", "routeros", "mizar", "mojolicious", "monkey", "moonscript", "n1ql", "nsis", "nestedtext", "nginx", "nim", "nix", "node-repl", "ocaml", "openscad", "ruleslanguage", "oxygene", "pf", "parser3", "pony", "pgsql", "powershell", "processing", "prolog", "protobuf", "puppet", "purebasic", "profile", "q", "qml", "reasonml", "rib", "rsl", "roboconf", "sas", "sml", "sqf", "step21", "scala", "scheme", "scilab", "smali", "smalltalk", "stan", "stata", "stylus", "subunit", "tp", "taggerscript", "tcl", "tap", "thrift", "twig", "vbscript", "vbscript-html", "vhdl", "vala", "verilog", "vim", "wasm", "mathematica", "wren", "xl", "xquery", "zephir", "crmsh", "dsconfig", "graphql",
-    // third: "yul", "solidity", "abap", "hlsl", "gdscript"
+    // third: "yul", "solidity", "abap", "hlsl", "gdscript", "moonbit"
     public static readonly ALIAS_CODE_LANGUAGES: string[] = [
         "js", "ts", "html", "toml", "c#", "bat"
     ];

package/types/index.d.ts

@@ -36,7 +36,7 @@ export * from "./mobile/dock/MobileOutline";
 export * from "./mobile/dock/MobileBacklinks";
 export * from "./mobile/dock/MobileBookmarks";
 export * from "./mobile/dock/MobileFiles";
-export * as platformUtils from "./protyle/util/compatibility";
+export * as platformUtils from "./platformUtils";
 
 
 type TDockPosition = "Left" | "Right" | "Bottom"

package/types/{protyle/util/compatibility.d.ts → platformUtils.ts}

@@ -14,3 +14,16 @@ export declare const isInIOS: () => any;
 export declare const updateHotkeyTip: (hotkey: string) => string;
 export declare const getLocalStorage: (cb: () => void) => void;
 export declare const setStorageVal: (key: string, val: any, cb?: () => void) => void;
+
+/**
+ * @param {string} [options.timeoutType="defalut"] 仅在桌面端有效，"default" 表示使用默认的超时机制，"never" 表示通知将一直显示，直到用户手动关闭它。
+ * @returns 通知 id
+ */
+export declare const sendNotification: (options: {
+    title?: string,
+    body?: string,
+    delayInSeconds?: number,
+    channel?: string,
+    timeoutType?: "default" | "never"
+}) => Promise<number>;
+export declare const cancelNotification: (id: number) => void;

package/types/protyle.d.ts

@@ -399,6 +399,7 @@ export type TProtyleAction = "cb-get-append" | // 向下滚动加载
     "cb-get-backlink" | // 悬浮窗为传递型需展示上下文
     "cb-get-unundo" | // 不需要记录历史
     "cb-get-scroll" | // 滚动到指定位置，用于直接打开文档，必有 rootID
+    "cb-get-search" | // 使用搜索打开搜索
     "cb-get-context" | // 包含上下文
     "cb-get-rootscroll" | // 如果为 rootID 就滚动到指定位置，必有 rootID
     "cb-get-html" | // 直接渲染，不需要再 /api/block/getDocInfo，否则搜索表格无法定位
@@ -802,7 +803,7 @@ interface IHint {
 }
 
 /** @link https://ld246.com/article/1549638745630#options */
-export interface IProtyleOptions {
+interface IProtyleOptions {
     history?: {
         created?: string
         snapshot?: string
@@ -834,9 +835,6 @@ export interface IProtyleOptions {
     _lutePath?: string;
     /** 是否启用打字机模式。默认值: false */
     typewriterMode?: boolean;
-    /** 多语言。默认值: 'zh_CN' */
-    lang?: string;
-    /** @link https://ld246.com/article/1549638745630#options-toolbar */
     toolbar?: Array<string | IMenuItem>;
     /** @link https://ld246.com/article/1549638745630#options-preview */
     preview?: IPreview;