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 插件仅作为开发测试用途,未在此处列出)
插件使用指南
-
安装插件: 下载上述
.mlplugin文件。打开 MindLogic,在顶部菜单栏选择 工具 (Tools) -> 插件中心 (Plugin Center),然后点击右上角的 导入 (Import) 图标,选择下载的插件文件即可完成安装。 -
全局配置: 部分插件(例如 OpenAI LLM 插件)可能需要 API Key 或其他全局参数。在“插件中心”选择已安装的插件,点击 编辑全局配置,填入您的 Key 并保存。这些配置对所有使用该插件的节点均有效。
-
在节点中使用: 选中画布上的任意节点。在右侧的属性检查器 (Inspector) 底部,展开 插件 (Plugin) 面板,从下拉列表中选择您需要的插件。 选中后,面板会展开该插件特有的输入框(例如:提示词、目标 URL 等)。您既可以直接输入静态文本,也可以使用
{}语法引用上游节点的数据(例如{ node.inputs['City'] })。 -
查看执行结果: 当图谱计算流经该节点且所有的输入就绪时,插件会自动在后台执行。成功后,其返回结果会注入到节点的属性中,您可以在节点的下游继续使用这些结果。
执行顺序与参数传递逻辑
为了能最大限度地发挥插件和脚本的威力,您需要了解 MindLogic 节点在运行时的先后执行顺序。整个计算流遵循以下三大阶段:
- 数学与公式引擎 (Math & Formula Engine) 优先执行:
系统首先拉取所有上游节点传递过来的
Inputs变量,然后计算当前节点属性检查器中定义的各种“公式 (Formulas)”。此时,node.inputs和node.outputs会被赋予初始的静态计算结果。 - 插件脚本 (Plugin Script) 隐式执行:
如果您为节点配置了插件,插件底层的代码片段会紧接着公式之后执行。插件可以通过
{ 变量 }读取节点数据,通过系统接口发起网络/AI请求,并通常将获得的数据直接赋值给node.outputs['特定属性']或者是修改节点的标题node.title。 - 节点自定义脚本 (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 文件和打包,您可以在应用内可视化地创建和编辑插件。
创建与编辑
- 打开 工具 (Tools) -> 插件中心 (Plugin Center)。
- 点击右上角的 创建插件 (Create Plugin) 按钮,即可打开插件工作室。
- 在左侧面板,您可以配置插件的元数据(名称、作者等),以及定义全局输入(如 API Key)和节点输入(提供给用户的 UI 表单项)。
- 在右侧面板的 脚本模板 (Script Template) 中,您可以使用 JavaScript 编写具体的执行逻辑。
调试与开发
MindLogic 提供了安全的 沙盒测试 (Sandbox Testing) 环境:
- 在插件工作室中编写完代码后,您可以直接点击 测试 (Test) 按钮。
- 在弹出的沙盒窗口中,输入模拟的测试数据,点击运行即可查看输出的执行日志和结果。
- 这允许您在不影响画布文档的情况下,单独测试并完善插件代码。完成测试后,点击 保存并安装 (Save & Install) 即可将插件应用到本地。
