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

插件反馈

插件下载:

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

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

安装方式:下载后用mn打开mnaddon文件,或在mn的插件界面导入插件

更新日志

  • 0.1.8
    1. 新功能:
      • 新增链接中心
      • 共享文档支持标签筛选
      • 支持下载Ohmymn中autoComplete的数据库并直接导入
      • 充值页面新增桌面端和移动端选项
        • 在mac端,选择桌面端后支付时会显示付款二维码
        • 在ipad端,选择桌面端后支付宝会显示付款二维码,微信会拉起微信支付,选择移动端后都是拉起对应软件支付
    2. 优化:
      • 改进查询额度的弹窗显示
      • 更新api
      • 从最小化显示时自动提高到最高层级
    3. bug修复:
      • 修复parseHexColor的bug
      • 修复一个订阅问题
      • 修复充值验证时额度用尽导致的APIKey禁用问题
      • 修复MNNote实例allText属性的bug
        mnutils_v0_1_8.mnaddon (2.1 MB)

常见问题

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

  • 新版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(已经购买过想充值的选择第二个充值按钮),选择需要购买/充值的金额,最后点击支付跳转到爱发电页面


付款后点击红色按钮(Show APIKey in DM),发送的消息中sk-开头的就是APIKEY,如果不出意外插件会自动检测到对应的APIKey,并弹窗询问是否使用该Key激活

如果没检测到APIKey的话,可以直接复制后点击粘贴按钮

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. 更多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账户等无关,因此每个终端需要单独计费。

免费额度:

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

使用apikay激活:

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

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

  • 使用量查询

离线订阅及自动订阅:

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

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

CleanShot 2024-04-21 at 20.22.58.gif

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

历史版本

  • 0.1.7
    mnutils_v0_1_7.mnaddon (2.1 MB)

    1. 修复mnutil.hasMNImages的问题
    2. 刷新内容方面增加重试机制
    3. 尝试下载分流和重试
    4. 修复一个不能打开学习集的问题
    5. 改进log方法
    6. 优化下载页面视图
    7. 修复留白相关的API bug
    8. 改进充值逻辑
    9. 增加配置备份功能,防止意外闪退导致的配置丢失,全自动,用户无需操作
  • 0.1.6
    mnutils_v0_1_6.mnaddon (2.1 MB)

    1. API 改进:
      • MNUtil新增静态方法focusHistory,记录最近十次的操作
      • 增加MNUtil增加isAddonRunning方法,用来判断某些插件是否处于运行状态
      • MNUtils.log()支持直接传入object,会自动转为detail中的值
      • 增加类MNLog,用以代替MNUtil.log,原API保留
      • 改进MNUtil.input方法,支持在弹出框中输入默认值
      • 新增MNUtil.doSegment方法,用于分词
      • MNNote新增一批实例方法
      • 修复menu.show()自动调整菜单宽度的bug
      • 忘了还有哪些了
    2. bug修复:
      • 修复从最小化恢复后未能刷新页面的bug
      • 修复共享中心的一些bug
      • 修复一些bug
    3. 改进:
      • 粘贴apikey时自动检测是否有效
      • 优化充值流程
      • 改进部分动画
      • 额度用尽时弹窗提示,且可以直接打开充值面板
      • 支付宝充值完成后尝试根据回调直接打开私信面板并检测apikey
      • 改进消费日志查询的进度提示
      • 改进悬浮按钮与打开后窗口的位置关系
      • 优化报错提醒
      • 改进在论坛中下载插件/学习集等情况的进度展示
      • 下载学习集时先检测学习集是否已经存在
      • 改进预览
      • 改进日志功能
      • 日志面板支持复制所有
      • 部分报错转移到log中,而不是剪贴板
      • 改进订阅时网络错误的处理逻辑
      • URL5回归
    4. 新功能:
      • 增加URL延迟测试
      • 支持通过URL Scheme切换页面
      • 点击Have questions?时加载订阅文档
      • 悬浮按钮模式下支持长按快速切换页面
      • 支持打开小红书主页
      • 支持打开常见问题页面
      • 支持快速加群
  • 0.1.5
    mnutils_v0_1_5.mnaddon (776.7 KB)

    1. 修复一个utils的问题(可能导致ChatAI同步bug)

    2. 暂时移除URL5

    3. 支持充值时自动填写要充值的apikey

    4. 提供一个反馈网址

    5. API更新

    6. 新增一个log viewer,支持用MNUtil.log("示例文本")

    7. 插件从插件栏中独立出来,支持全局显示,支持贴边

    8. 改进动画逻辑

    9. 新增shared Notebooks和shared Documents,可以用来下载共享的学习集和文档

    10. 下载插件时会发送一个http请求以便后台计数

    11. UI修改

    12. 修复一个bug

    13. 改进窗口切换逻辑

    14. 修复一个贴边错误的bug

    15. 改进MNUtil.copy方法

    16. 改进窗口弹出逻辑

  • 0.1.4
    mnutils_v0_1_4.mnaddon (752.4 KB)

    1. 修复打开侧边栏失败的问题

    2. 修复购买apikey链接无法打开的问题

    3. 改进无法刷新插件列表时的报错

    4. 修改URL3

    5. API更新和修复

    6. 修复报错提示的一点问题

    7. 修复一个无法resize窗口的问题

    8. 默认启动界面改为插件更新界面

    9. 改进一些提示

    10. 改进购买订阅按钮

    11. 改进创建卡片时学习集内无绑定文档的报错

    12. 改进插件未激活下的弹窗

    13. 改进订阅提醒

    14. 当一次性订阅天数超过10天时,需要弹窗确认

    15. 修复一些焦点占用问题

    16. 直接直接查询消费日志

    17. 大胡子变量模板支持管道操作符

    18. 改进插件内购买,会直接弹出付款二维码

    19. 增加一个为key充值额度的按钮

    20. 修复一个订阅问题

    21. 改进充值流程

    22. 添加常见问题按钮

  • 0.1.3
    mnutils_v0_1_3.mnaddon (516.7 KB)

    1. 增加历史版本下载功能

    2. 禁止同时下载多个插件,以避免可能带来的问题

    3. 当页面宽度足够时,插件管理页面点击插件自动展开文档页面

    4. 粘贴订阅key时检测格式

    5. 改进 waitHUD和 showHUD之间的可能冲突

    6. MNNote实例增加方法 copyURL和 removeTags

    7. getNoteById增加一个alert参数,默认为true,设为false后则在笔记不存在时不报错

    8. MNNote增加静态方法 exist,用于判断笔记是否存在

    9. 改进免费次数的提示

    10. 修复一个可能导致闪退的问题

    11. 支持一次订阅多个天数(多的保存在本地)

    12. 支持打开私信列表后自动弹出订阅确认

  • 0.1.2

    1. 改进md2html方法,支持mn图床
    2. 改进currentSelection属性
    3. 增加MNComment类
    4. MNUtil类新增 getCloudDataByKey、 setCloudDataByKey和 userSelect方法
    5. 改善对照模式下获取选中摘录的一点问题
    6. 下载插件时支持显示进度
    7. 增加下载错误检测
    8. 增加更新提示
    9. 为部分方法提供链式调用功能
    10. 改进MNButton.setColor方法

    mnutils_v0_1_2.mnaddon (443.6 KB)

  • 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)

  • 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)

5 个赞

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

1 个赞

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

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

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

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