API 参考手册

当您的插件在 Spark 中运行时，会向全局作用域（window）自动注入一个 spark 对象。它是插件访问底层系统能力的唯一桥梁。

核心 API

spark.showNotification(title, content)

发送系统原生通知。

• 参数:
  • title: 通知标题
  • content: 通知内容

spark.copyText(text)

将文本复制到系统剪贴板。

spark.db.set(key, value)

持久化存储简单的键值对。数据将随用户账号（如 WebDAV）同步。

spark.shell.execute(command)

CAUTION

该 API 具有高权限。用于在后台异步执行 shell 命令。

进程间通信 (IPC)

如果您定义了系统插件或需要与 Spark 核心深度交互，请使用 IPC 模式：

// 发送消息到核心
spark.ipc.send('request-data', { id: 123 });

// 监听核心返回
spark.ipc.on('data-response', (data) => {
  console.log('Received:', data);
});

---

TIP

开发技巧: 您可以在 Spark 的开发模式下双击 Logo 打开调试器，直接在控制台输入 window.spark 查看完整的对象结构。