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

插件反馈

插件下载:

所有功能都支持iPad和Mac
除官方签名版本外,安装插件需要在设置中允许“加载未经认证的插件”
安装方式:下载后用mn打开mnaddon文件,或在mn的插件界面导入插件

更新日志

  • 0.1.1

    1. 尝试修复在某些版本系统上的兼容性问题
    2. 新增一个alpha面板,目前两个面板内容一致,后续测试版只在alpha面板中展示,另一面板用来展示正式版
    3. 新增一个Roadmap选项,点击会通过MN Browser打开网址: https://mnaddon.craft.me/roadmap
    4. MNUtil新增方法openDoc, importDocument, isNoteInReview, render, toggleExtensionPanel, constrain, emojiNumber, isIOS, isMacOS, isIPadOS, countWords, getNoteFileById, getRandomElement, isNSNull, runJavaScript
    5. MNUtil新增属性extensionPanelController, extensionPanelView
    6. MNNote实例属性新增方法insertChildBefore, removeFromParent, getMDContent
    7. MNNote新增静态方法 fromSelection 用于从文档选中文字创建摘录
    8. MNConnection新增方法loadFile, loadHTML, getOnlineImage
    9. 改进MNUtil的currentSelection属性
    10. 新增类MNExtensionPanel,用于管理扩展面板
    11. 修复getFocusNote无法获取保存的对照视图中的卡片的问题
    12. 修复 appendTags方法的问题
    13. 通过MNNote的 excerptText实例属性设置摘录文本时,如果检测到为图片摘录,则自动开启文本优先
    14. UI改进
    15. 新增一个闪退按钮

    mnutils_v0_1_1.mnaddon (440.1 KB)

介绍

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

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

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

  2. 提供插件控制面板

    • 订阅信息管理
      支持直接在MN内购买订阅key及查询消费日志


      购买演示:
      点击需要购买的金额,付款后点击红色按钮(Show APIKey in DM),发送的消息中sk-开头的就是APIKEY,直接复制后粘贴到文本框中,点击激活即可

    • 插件下载更新

URL切换:

  • 为保证订阅网络可用性,插件提供了五条用于验证订阅的通道,无法正常订阅的用户可以尝试切换URL
    该URL会同样应用于MN OCR通过订阅key调用OCR和MN ChatAI插件通过订阅key调用GPT

订阅key购买(推荐直接在插件内完成):

(需要登录,支付后在爱发电私信处查收apikey):

类型 价格 购买链接
5刀key 5元 点我购买
10刀key 9元 点我购买
20刀key 18元 点我购买
50刀key 40元 点我购买

订阅功能介绍

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

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

订阅方案:

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

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

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

插件 计费方式 说明
MN ChatAl: 1. prompt指定模型、函数
2. 配置导入导出/同步
3. 更多prompt
4. 标签触发prompt
5. key每日无限使用
6. 用订阅key调用GPT4等模型
7. 黑暗模式
1. 用订阅key调用GPT4等模型按token计费
2. 其他部分当日订阅后无限使用
使用自己的key调用大模型则计费与ChatAI无关
MNOCR: 1. 使用订阅key进行OCR
2. 解锁GPT-4o Vision方案
1. doc2x和simpletex的图片OCR每次OCR消耗0.005
2. doc2x PDF OCR: 页面数低于20,则单次消耗0.05 页面数高于20,则单次消耗0.1
3. 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账户等无关,因此每个终端需要单独计费。

免费额度:

即使是未订阅状态下,插件也提供每天十次的免费试用

Image.png

使用apikay激活:

  • 复制apikey并粘贴到插件内,然后点击激活按钮完成首次订阅,订阅状态下插件logo处于高亮状态

Image.png

  • 订阅后,即会产生一笔0.1$的消费日志,可在以下网址查询使用日志

  • 使用量查询

离线订阅及自动订阅:

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

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

CleanShot 2024-04-21 at 20.22.58.gif

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

历史版本

  • 0.1.0
    1. 支持直接在MN内购买订阅key及查询消费日志
    2. 支持直接在MN内下载安装插件(最后依然需要重启)
    3. 订阅key默认隐藏,避免泄露
    4. 双击刷新按钮强制重新加载插件更新栏
    5. 支持在MN学习集内直接打开插件面板
    6. 改进订阅逻辑,在本地存有天数的情况下无论是否激活都能直接激活订阅
    7. MNNote实例补充属性:childMindMap,改进createChildNote和createBrotherNote
    mnutils_v0_1_0.mnaddon (430.8 KB)

  • 0.0.9
    1. 新增部分API并修复部分API问题
    2. 修复演示模式重启后的报错
    3. 修复文档摘录添加子节点的问题
    4. 整合MN subscription,因此可以删除MN subscription插件(删除不会移除配置)
    5. 修复自动订阅下可能的连续两次订阅问题
    mnutils_v0_0_9.mnaddon (70.0 KB)

  • 0.0.6

    1. 改进selectionText属性、getFocusNote()和getFocusNotes()方法,以兼容多文档分割视图
    2. MNUtils新增getDocImage()方法,以获得文档选中图片(支持多文档分割视图)
    3. MNNote新增getImageFromNote()方法
      mnutils_v0_0_6.mnaddon (48.9 KB)
  • 0.0.5

    1. 改进genFrame方法,可以一定程度上避免因参数失误带来的闪退问题
    2. getPopoverAndPresent方法支持设置弹出位置
    3. 改进MNNote.new()方法
    4. 新增类MNConnection
      mnutils_v0_0_5.mnaddon (48.3 KB)
  • 0.0.2
    修改 md2html的一点配置
    mnutils_v0_0_2.mnaddon (47.4 KB)

  • 0.0.1
    mnutils_v0_0_1.mnaddon (47.3 KB)

2 个赞

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

1 个赞

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

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

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

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