【第三方MN插件】MN Utils,提供封装API,必装插件

插件反馈

插件下载:

网页版插件商店

:white_check_mark: 所有功能都支持iPad和Mac

:warning: 除官方签名版本外,安装插件需要在设置中允许“加载未经认证的插件”

安装方式:

  1. 下载后用mn打开mnaddon文件,或在mn的插件界面导入插件
  2. 如果已安装 MNUtils,可以在插件商店中更新
  3. 如果已安装 MNUtils,可以在网页版插件商店中安装

更新日志

最新版本:0.2.5

mnutils_v0_2_5.mnaddon (4.7 MB)

  1. 新功能
    • MNUtil新增undoGroupingAsync方法,同时部分使用了undoGrouping方法的提供一个异步版本,如MNNote.createChildNoteAsync,可以等待undoGrouping内执行方法的完成
    • 新增插件内反馈功能,通过通知实现
    • 新增MNUtil.getLatestFileInfoFromMultiSources,并行读取多个网络位置的配置文件并返回最新版
    • 插件商店支持显示插件简介
    • 更新 URL,部分URL需要密码验证,最新版启动时自动验证
    • 支持打开网页版插件商店
  2. 优化
    • MN4.5 开始不再显示闪退相关按钮
    • 改进插件下载通知的逻辑
    • 改进MNNote相关API:
      • 支持设置要绑定的文档和页码
      • 支持获取和设置branchStyle,必须在当前脑图中唯一选中
      • 支持实例方法selectBranch,必须在当前脑图中唯一选中
      • 改进一些 MNNote 和 MNComment 的一些 api
      • 改进对留白卡片的识别,MNNote的 type 新增blankImageNote,MNNote 新增实例属性hasMask和maskImageData
    • 改进 MNNotification:
      • MNNotification的正文的 markdown 渲染支持latex公式
      • 改进MNNotification.handleOpenAIRequest,支持思考内容和报错显示
      • MNNotification.handleOpenAIRequest支持指定 id
      • 新增通知tagInput、menu和jsonEditor
      • 通知中心显示倒计时
    • 改进一个卡片聚焦的问题
    • 改进插件配置的识别和修正
    • 改进MNUtil.copyImage
    • 支持编辑 tagComment
  3. bug修复
    • 修复文档页码的识别错误问题
    • 修复一些UI问题
    • 修复MNNote创建卡片的一些问题
    • 修复MNUtil.getLatestSelection的一个 bug
    • 修复MNUtil.typeof 的 bug
    • 修复充值页面手动验证 apikey 失败的问题
    • 修复getFileInfoWithFallback未正确返回header的问题
    • 修复一个检测ip带来的延迟问题
    • 修复下载通知已经完成时,点击关闭按钮还会提示“下载已取消"的问题
    • 修复刷新商店配置的问题
    • 修复卡片无颜色(colorIndex 为-1)时的报错
    • 修复一个卡片聚焦的问题
    • 修复一个订阅成功后提示消息的问题

常见问题

更新后在插件栏找不到美元符号的按钮了

  • 新版MN Utils升级为全局显示了,支持在学习集外显示,支持拖拽移动贴边
    你大概率可以在左边靠上找到它(如果没移动过的话)

介绍

建议所有人安装,因为这将会是以后插件运行的一个必要前提条件
该插件有以下几个作用:

1. 用于向开发者提供High-level的MN API

该插件对用户而言没有实际功能,仅用于向开发者提供High-level的MN API,目前主要包括MNUtil,MNButton,MNNote三个类

插件会尽量部分保持与ohmymn API的一致,避免API命名等带来的混乱。其中MNNote大量内容借鉴ohmymn的API文档,但部分API依然会存在一些不同。同时为避免与ohmymn的冲突,定义的类名会有所不同
API文档见下方链接:

2. 订阅信息管理

支持直接在MN内购买订阅key及查询消费日志


查看订阅APIKey


新用户支持免费生成一个APIKey,包含0.5积分

3. 插件下载更新 ( 正式版测试版

4. 共享中心

Utils提供三个文件共享中心(无需登录,免费下载):

  1. 文档共享中心

点击import按钮直接下载并打开对应文档

  1. 学习集共享中心

点击学习集自动右侧打开对应网址

点击import按钮直接下载学习集并打开

  1. 链接中心
    可以快速访问与MN相关的链接,如用户手册

URL切换:

  • 为保证订阅网络可用性,插件提供了五条用于验证订阅的通道,无法正常订阅的用户可以尝试切换URL
    该URL会同样应用于MN OCR通过订阅key调用OCR和MN ChatAI插件通过订阅key调用GPT
    不确定应该使用哪个URL的可以点击Test URL,会对所有可用URL进行测试(或者直接点击自动选择)

订阅功能介绍

MN的插件开发长期以来都是处于“为爱发电”的状态,即使作者有收费的想法,如何实现插件的验证、激活和订阅都是一件很麻烦的事情。

借助于开源项目newapi的强大能力,我们可以将其作为后端,直接使用其现成的账号管理、令牌验证、扣费管理。MN插件通过网络请求来验证订阅状态。

订阅方案:

不同于常见的按月/按年订阅,用户可能订阅后只使用几次/几天,但却为此支付不低的费用,这里采用按日付费的订阅方案,每次订阅在对应自然日内生效,费用为0.1$,订阅内容包括我的所有插件的高级功能(除第三方服务外)。因此,即使是每日满订阅,每月的费用也只有3$,一年最多36.5$。

PS: 不要把“$”理解成美元哈,它只是个符号,理解成Q币或者积分这种东西就行,日常价格是1元1$,下面活动价是1元5$

哪些功能需要订阅(更多高级功能敬请期待):

插件 计费方式 说明
MN ChatAl: 1. prompt指定模型、函数2. 配置导入导出/同步3. 更多prompt4. 标签触发prompt5. key每日无限使用6. 用订阅key调用GPT4等模型7. 黑暗模式 1. 用订阅key调用GPT4等模型按token计费2. 其他部分当日订阅后无限使用 使用自己的key调用大模型则计费与ChatAI无关
MNOCR: 1. 使用订阅key进行OCR2. 解锁GPT-4o Vision方案 1. doc2x和simpletex的图片OCR每次OCR消耗0.0052. doc2x PDF OCR: 页面数低于20,则单次消耗0.05 页面数高于20,则单次消耗0.13. GPT-4o Vision: 按token计费 使用自己的key没有限制,没有额外消耗(注意gpt-4o需要订阅)
MN Browser: 1. 配置导入导出2. 自定义按钮3. 视频摘录 当日订阅后无限使用
MN Toolbar: 1. 自定义动作2. 背景颜色切换3. 显示更多按钮 当日订阅后无限使用
MN Editor: 1. 替换自带弹出菜单的编辑按钮 当日订阅后无限使用
MN AutoStyle: 1. 标签触发 当日订阅后无限使用

订阅费用如何计算:

  1. 无需第三方收费服务的部分,统一为0.1$的上限,即当日消耗0.1$订阅后,功能随意使用
  2. 需要第三方服务的部分,如接入其他平台OCR API
  3. 插件按终端订阅,订阅信息存储在本地,与iCloud账户等无关,因此每个终端需要单独计费。

免费额度:

即使是未订阅状态下,插件也提供每天100次的免费试用,这100次也包括ChatAI插件中Built-In源的每次AI调用和MN OCR中免费模型的每次调用

生成新的APIKey:

离线订阅及自动订阅:

订阅本身是按日付费,考虑到可能某天处于断网状态,插件额外支持“囤”订阅天数的功能。

在当日已经订阅成功的情况下,继续点击订阅按钮便可增加“囤”的天数,在有额外“囤”天数的情况下,第二天会优先使用剩余天数维持订阅状态(这一过程不需要联网)。如果没有剩余天数,则需要联网产生新订阅。

自动订阅:如果开启了自动订阅,则会自动在打开笔记本时检查当日是否订阅,如果不在订阅状态,则自动联网产生新订阅

历史版本

顶一个,Marginnote3插件开发需要更多人的参与


MN Utils导入后会有什么反应吗?我好像没找到专门的界面,MN Editor也提示我要安装MN Utils

目前系统版本偏老会无法启动

导入插件后也没有看到专门的界面,是要升级到什么系统才行啊

不确定,尽量往上升吧,某个版本的Safari有问题