[思源笔记第三方插件系统] 插件系统安装指引

2023/3/28 更新：以支持挂件版本安装，详见：[思源笔记第三方插件系统] v0.3.21 发布，支持“插件系统挂件版”

1. 将如下代码插入到代码片段中(源码可以查看插件系统的 load.js)

   /* SiYuanPluginSystem */
   (function () {
       const path = require('path');
       const getCrossPlatformAppDataFolder = () => {
           let configFilePath;
           if (process.platform === "darwin") {
               configFilePath = path.join(
                   process.env.HOME,
                   "/Library/Application Support"
               );
           } else if (process.platform === "win32") {
               // Roaming包含在APPDATA中了
               configFilePath = process.env.APPDATA;
           } else if (process.platform === "linux") {
               configFilePath = process.env.HOME;
           }
           return configFilePath;
       };
       try {
           const data = require('fs').readFileSync(path.join(getCrossPlatformAppDataFolder(), '.siyuan', 'plugin.js'));
           const script = data.toString('utf8');
           console.log('local plugin system found, loading...');
           eval(script);
   
       } catch (e) {
           console.log('local plugin system not found, load online');
           return fetch('https://gitee.com/zuoez02/siyuan-plugin-system/raw/main/main.js', { cache: 'no-cache' }).then((res) => res.text()).then((sc) => {
               window.siyuanPluginScript = sc;
               eval(sc);
           });
       }
   })();
   

   ​
   打开设置
   ​
   选择外观 -> 代码片段 设置
   ​
   如图所示添加 JS 代码，粘贴代码并开启，点击确定保存
   插件系统将自动完成安装及开启。

2. ​
   右上角出现小齿轮，代表安装完成，点击小齿轮，选择插件系统设置，即可查看当前插件系统配置
   ​​

3. 打开你的工作空间目录，在 data​目录下创建 plugins 目录（通过思源菜单-> 工作空间-> 你的工作空间名称-> 打开文件位置即可直接打开)

4. 将你下载的插件放置在 plugins 目录下，使用插件系统快捷菜单的“重载”功能，页面刷新后，在插件系统菜单的插件列表中即可看到你的插件。每个插件为一个目录，其内部必须包括 main.js​和 manifest.json​两个主要文件
   ​​

   ​​

5. 关闭“安全模式”，在插件列表中开启插件，即可完成插件的加载。
   ​
   关闭“安全模式”
   ​
   开启你的第三方插件

注意 ⚠️：安全模式的作用是为了确保当开启时不加载第三方插件。由于 Electron 应用复杂的 API 设计，很难做到一个安全的插件系统，因此需要用户个人根据意愿开启或关闭安全模式。当插件系统初次安装时，安全模式为开启状态。

‍