10. 插件扩展与管理 (Plugins)

MindLogic 提供了一个轻量且强大的 插件系统 (Plugin System)。除了节点脚本 (Entity Scripts) 外,您还可以通过安装插件来扩展 MindLogic 的能力,例如连接外部 API、执行复杂的文本处理,或调用大型语言模型 (LLM)。

插件的应用场景

插件主要用于将繁琐的网络请求、数据处理和第三方服务集成进行封装。典型的应用场景包括:

  • API 请求:与各类互联网服务进行交互(如获取天气、股票、汇率数据)。
  • AI 模型集成:调用各类大型语言模型(OpenAI、DeepSeek 等),利用 AI 进行自动化分析。
  • 信息爬取与提取:从网页、PDF 等外部文件中提取文本并用于计算与推理。
  • 工具链集成:调用搜索引擎或特定领域的专业工具。

官方插件下载列表

您可以直接下载我们提供的官方插件,并在软件内的 工具 (Tools) -> 插件中心 (Plugin Center) 中点击“导入”进行安装。

插件名称详情说明版本下载地址
Global Weather获取全球任意位置的当前天气与预报数据1.0.0下载 Weather.mlplugin
DALL-E 3 Image Generation调用 OpenAI 的 DALL-E 3 模型,根据提示词生成图像1.0.0下载 DALL-E_3.mlplugin
Native PDF Extractor使用 Apple 原生 PDFKit,提取本地或远程 PDF 的纯文本1.0.0下载 PDF_Extractor.mlplugin
HTTP Request发起通用的 GET/POST 请求以获取各类 JSON API 数据1.0.0下载 HTTP_Request.mlplugin
Wikipedia Search搜索维基百科,并返回头部最相关的结果摘要1.0.0下载 Wikipedia.mlplugin
LLM (OpenAI Compatible)调用任何标准的 OpenAI 兼容 LLM 接口 (例如 Qwen, Moonshot)1.0.0下载 OpenAI_Compatible.mlplugin
DeepSeek (OpenAI Compatible)专门为调用 DeepSeek 大模型而优化的接口配置1.0.0下载 DeepSeek.mlplugin
DuckDuckGo Search借助 DuckDuckGo HTML 搜索网络信息1.0.0下载 DuckDuckGo.mlplugin
Web Scraper从网页 URL 中提取纯文本内容,常用于阅读新闻或文档1.0.0下载 WebScraper.mlplugin

(注意:Test 插件仅作为开发测试用途,未在此处列出)

插件使用指南

  1. 安装插件: 下载上述 .mlplugin 文件。打开 MindLogic,在顶部菜单栏选择 工具 (Tools) -> 插件中心 (Plugin Center),然后点击右上角的 导入 (Import) 图标,选择下载的插件文件即可完成安装。

  2. 全局配置: 部分插件(例如 OpenAI LLM 插件)可能需要 API Key 或其他全局参数。在“插件中心”选择已安装的插件,点击 编辑全局配置,填入您的 Key 并保存。这些配置对所有使用该插件的节点均有效。

  3. 在节点中使用: 选中画布上的任意节点。在右侧的属性检查器 (Inspector) 底部,展开 插件 (Plugin) 面板,从下拉列表中选择您需要的插件。 选中后,面板会展开该插件特有的输入框(例如:提示词、目标 URL 等)。您既可以直接输入静态文本,也可以使用 {} 语法引用上游节点的数据(例如 { node.inputs['City'] })。

  4. 查看执行结果: 当图谱计算流经该节点且所有的输入就绪时,插件会自动在后台执行。成功后,其返回结果会注入到节点的属性中,您可以在节点的下游继续使用这些结果。

执行顺序与参数传递逻辑

为了能最大限度地发挥插件和脚本的威力,您需要了解 MindLogic 节点在运行时的先后执行顺序。整个计算流遵循以下三大阶段:

  1. 数学与公式引擎 (Math & Formula Engine) 优先执行: 系统首先拉取所有上游节点传递过来的 Inputs 变量,然后计算当前节点属性检查器中定义的各种“公式 (Formulas)”。此时,node.inputsnode.outputs 会被赋予初始的静态计算结果。
  2. 插件脚本 (Plugin Script) 隐式执行: 如果您为节点配置了插件,插件底层的代码片段会紧接着公式之后执行。插件可以通过 { 变量 } 读取节点数据,通过系统接口发起网络/AI请求,并通常将获得的数据直接赋值给 node.outputs['特定属性'] 或者是修改节点的标题 node.title
  3. 节点自定义脚本 (Node Custom Script) 最后执行: 属性面板最底部的自定义“节点脚本 (Script)”拥有最终的执行权。因为它是紧接在插件脚本之后运行的,所以您可以直接在这里拿到插件的输出结果! 例如,如果某大模型插件将结果写到了 node.outputs['Summary'],您可以在脚本里写:
    let result = node.outputs['Summary'];
    if (result.includes("Error")) {
        node.title = "Status: Failed";
    }
    
    随后,当前节点最终的所有 outputs 变量会自动顺着连线,作为 inputs 参数传递给下游的下一个节点。

编写自定义插件

除了官方插件,您完全可以自己编写插件!MindLogic 提供了强大的 插件工作室 (Plugin Studio),无需手动编写 JSON 文件和打包,您可以在应用内可视化地创建和编辑插件。

创建与编辑

  1. 打开 工具 (Tools) -> 插件中心 (Plugin Center)
  2. 点击右上角的 创建插件 (Create Plugin) 按钮,即可打开插件工作室。
  3. 在左侧面板,您可以配置插件的元数据(名称、作者等),以及定义全局输入(如 API Key)和节点输入(提供给用户的 UI 表单项)。
  4. 在右侧面板的 脚本模板 (Script Template) 中,您可以使用 JavaScript 编写具体的执行逻辑。

调试与开发

MindLogic 提供了安全的 沙盒测试 (Sandbox Testing) 环境:

  • 在插件工作室中编写完代码后,您可以直接点击 测试 (Test) 按钮。
  • 在弹出的沙盒窗口中,输入模拟的测试数据,点击运行即可查看输出的执行日志和结果。
  • 这允许您在不影响画布文档的情况下,单独测试并完善插件代码。完成测试后,点击 保存并安装 (Save & Install) 即可将插件应用到本地。