插件反馈
- 如果你对插件有任何反馈，都可以通过以下链接：https://mnaddon.craft.me
- 测试版下载：点击跳转到Utils测试版面板或https://marginnote.craft.me/changelog/utils
- 常见问题：常见问题（先看这里）
- 论坛更新较慢，最新文档请看：MN Utils
- 也可以加入qq群：539305227
插件下载：
所有功能都支持iPad和Mac
除官方签名版本外，安装插件需要在设置中允许“加载未经认证的插件”
安装方式：下载后用mn打开mnaddon文件，或在mn的插件界面导入插件
更新日志
最新版本：0.2.2
- mnutils_v0_2_2.mnaddon (2.7 MB)
- 新功能：
- 订阅相关：
- 引入新的订阅界面
- 更新URL5、URL6和URL7
- 新增URL的自动选择功能
- 改进订阅逻辑,现在未订阅用户可以直接生成新的APIKey(赠送0.5积分)
- 增加URL的监控页面
- 免费额度提升至100次
- 支持每日签到
- 插件商店相关：
- 插件更新面板尝试支持manifest文件
- 插件历史版本中逐步支持显示更新日志
- 支持通过URL Scheme安装插件
- 插件商店支持为插件设置依赖版本，下载插件时会首先下载对应版本的依赖插件
- 支持非常规的插件id
- i18n支持
- 新增通知视图和对应的MNNotification API
- 在特定场景下，顶部横栏左右会分别出现侧边栏按钮和最大化按钮
- 适配addonLib插件
- 新增MNCommand、MNKeyFlags和MNShortcutKey，用于统一配置插件快捷键
- 新增类UAPI，未来逐步适配UApiPro提供的公共API：https://uapis.cn/
- 支持检测docMapSplitMode状态的改变，并发出通知docMapSplitModeChanged
- 脑图手势检测：
- 除点击卡片外，点击空白处弹出的菜单支持发出通知：PopupMenuOnMindmapView 和 PopupMenuOnMindmapViewClosed
- 支持检测脑图卡片多选，并发出通知：mindmapViewOnMultipleSelection，
- 用户点击底部多选工具栏的关闭按钮时，发出通知：mindmapViewBottomToolbarClosed
- 订阅相关：
- API相关：
- 新增Locale类
- 改进Menu的addMenuItem和addItem，以支持i18n
- 其他一些小的API改进
- 文本压缩支持lz-string
- 改进文件类型识别
- 支持TocNoteURL
- 改进setTimeout和setInterval
- 改进图床功能
- 适配MN3
- 拓展marked.js，支持解析到公式块
- 改进对留白卡片的判断
- MNConnection相关改进，如增加静态方法isInChina，用于判断当前ip是否在国内
- DataConverter增加convertImagesDataToPdfData方法，可以将多张图片合为一个PDF文件，每张图片为一页
- 完善MNDocument相关api，如新增属性tableOfContents，可获取文档目录
- MNote相关：
- 修复MNNote.new的一些bug
- MNNote提供一个excerpt属性，返回摘录的类型（text、image、video和auido）和详细信息
- MNNote增加缓存功能，以提高性能
- 改进MNNote.getFocusNote方法，增加一个checkLatestSelection参数
- 改进openURL
- 其他API完善
- MNUtil星光：
- 新增moveToTempFolder：相比于moveToCacheFolder（相当于垃圾桶），更接近于直接删除文件
- 新增setDocSelection：设置文档选区
- 新增processCommandWithKeyFlagsInWindow：其中的command也许和executeCommand一样，暂不确定
- 新增getSearchWebview：用于获得研究视图中的UIWebview实例，实验性功能，不保证能正确运行
- 新增isMarkdown和markdownDetection：用于检测是否是markdown内容
- 改进MNUtil.copy
- 改进MNUtil.copyFile方法，增加option参数
- 尝试通过延迟刷新来减少refreshAfterDBChanged和refreshAddonCommands的资源消耗
- 修复导入PDF文档相关api的问题
- 改进：
- 改进一些性能
- 改进测试url等的问题
- 右侧文档右下角增加一个在其他位置打开网页的按钮
- 改进无网状态下的行为
- 改进插件商店(正式版)中海外用户的使用体验
- 优化日志页面
- 改进验证APIKey的逻辑
- 改进URL测试
- 改进部分配置,为热更新配置做准备
- 隐藏24小时订阅开关
- 改进下载记录
- 改进插件的下载和安装逻辑
- 优化了iOS端的一些问题
- 改进订阅逻辑
- 改进iPhone端的UI适配
- 改进消费日志视图
- 支持深色模式
- 改进接管研究视图的逻辑
- 改进iPhone竖屏下提示切换到横屏的逻辑
- 尝试使用通知视图代替部分打开其他应用的确认弹窗
- bug修复：
- 修复一个无法查询消费日志的问题
- 修复一个视频摘录图片的bug
- 修复一个取消下载的bug
- 修复一个插件无法删除的问题
- 修复版本历史界面中当前版本的显示问题
- 修复一个订阅界面没有自动切换主题的问题
- 修复一个侧边栏相关问题
- 改进窄窗口下的日志视图
- 修复MNUtil.openDoc在全脑图模式下的打开文档错误问题
常见问题
更新后在插件栏找不到美元符号的按钮了
- 新版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. 插件下载更新 （ 正式版｜ 测试版）
-
切换到Addon Store面板（带alpha/α的为测试版）
-
测试版与正式版都是未签名的版本
4. 共享中心
Utils提供三个文件共享中心（无需登录，免费下载）：
- 文档共享中心
点击import按钮直接下载并打开对应文档
- 学习集共享中心
点击学习集自动右侧打开对应网址
点击import按钮直接下载学习集并打开
- 链接中心
可以快速访问与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. 标签触发 | 当日订阅后无限使用 |
订阅费用如何计算：
- 无需第三方收费服务的部分，统一为0.1$的上限，即当日消耗0.1$订阅后，功能随意使用
- 需要第三方服务的部分，如接入其他平台OCR API
- 插件按终端订阅，订阅信息存储在本地，与iCloud账户等无关，因此每个终端需要单独计费。
免费额度：
即使是未订阅状态下，插件也提供每天十次的免费试用
使用apikay激活：
- 复制apikey并粘贴到插件内，然后点击激活按钮完成首次订阅，订阅状态下插件logo处于高亮状态
-
订阅后，即会产生一笔0.1$的消费日志，可在以下网址查询使用日志
离线订阅及自动订阅：
订阅本身是按日付费，考虑到可能某天处于断网状态，插件额外支持“囤”订阅天数的功能。
在当日已经订阅成功的情况下，继续点击订阅按钮便可增加“囤”的天数，在有额外“囤”天数的情况下，第二天会优先使用剩余天数维持订阅状态（这一过程不需要联网）。如果没有剩余天数，则需要联网产生新订阅。
自动订阅：如果开启了自动订阅，则会自动在打开笔记本时检查当日是否订阅，如果不在订阅状态，则自动联网产生新订阅
历史版本
-
0.2.1
mnutils_v0_2_1.mnaddon (2.3 MB)- 改进订阅提示信息
- 改进插件商店的获取逻辑
- 插件下载添加最大重试次数限制
- 适应MN4 4.2.3的插件认证识别逻辑
- 修复一些问题
- 更新部分内置库
- 增加图床功能
- 安装插件时会尝试先移除原插件目录(为了插件认证能被正确识别）
- 插件界面安装按钮左侧增加“更多”按钮
- 增加一个新的历史版本界面
- 修复iPad端按钮最小化后过于靠上和靠下的问题
- 增加MNWebview和DataConverter类
- MNUtil相关：
- 改进xorEncryptDecrypt、addErrorLog、getNoteIdByURL、getPageContent、MD5、btoa方法，
- 增加convertImageDataToPdfData、compressAndEncode、decodeAndDecompress、parseMNUIStatusURL和generateMNUIStatusURL、unzip和moveToCacheFolder
- MNComment相关：
- 改进MNComment对合并的子脑图评论的适配
- MNDocument相关：
- 增加实例方法getPageContent和getFileContent
- 增加静态方法extractPDFPage
- 修复MNDocument实例的一些问题
- MNLog相关
- 修复MNLog的一些bug
- 尝试将console设为MNLog（不确定是否会有大的bug）
- 改进MNLog.log
- 改进MNLog对数组的兼容性
- MNNote相关
- 修复MNNote实例的notes变量问题
- 增加实例方法getMNLinksInMarkdownContent
- 改进MNNote.new方法
- MNNote实例增加pageNos属性
- MNNotebook相关
- MNNotebook实例增加tagsTree参数
-
其他一些已经忘了的改进
mnutils_v0_2_2.mnaddon (2.7 MB)
-
0.2.0
mnutils_v0_2_0.mnaddon (2.1 MB)- 改进对markdown图片的检测
- 改进MNNote实例的delete方法
- 支持新的mn图床
- 改进频繁获取currentSelection的性能问题
- 改进安装提示
- 插件覆盖后自动显示一个提示页面，并且可以一键让MN闪退
- 修改缓存机制
- 新增选项show in notebook，默认开启，关闭后不在学习集中显示最小化按钮
- API更新
- 改进重试
- 改进对MN3的兼容性
- 改进下载显示
- 改进取消下载的逻辑
- 充值页面支持点击提醒
- 改进MNConnection.fetch
- addChild增加学习集判断，以兼容将文档上的摘录卡片移动为脑图子卡片的情况
- 尝试改进订阅逻辑：激活订阅后24小时内有效
- 引入Response类以改进http响应解析，目前MNConnection.fetchDev会返回Response对象
- 新增重试机制，在某个URL故障时尝试使用其他URL重试（可能还有bug）
- 修复正式版插件重试失败的问题
- 修复余额显示的问题
- 修复一个显示Unknown URL的问题
- 修复MNUtil.log的bug
- 修复addChild和insertChildAfter的问题
-
0.1.9
- 修复deepEqual的一个bug
- 修复额度显示问题，隐藏共享文档页面
- useInput API改进
- Menu API改进
- MNNote API改进
- 修复MNNote.getFocusNote的bug
- 修复纯文档模式下的一些bug
- 修复一个下载问题
- 改进不同版本的比较逻辑
- 支持跳转ima
- 修复无法下载历史版本的问题
- 修复焦点占用问题
- Update Manager 改名为 Addon Store
- Shared Notebooks 改名为 Notebook Center
- Shared Links 改名为 Link Center
- 改进API
- 将部分类拆分到mnnote.js文件中
- 增加类Frame
- 改进重试
mnutils_v0_1_9.mnaddon (2.1 MB)
-
0.1.8
- 新功能：
- 新增链接中心
- 共享文档支持标签筛选
- 支持下载Ohmymn中autoComplete的数据库并直接导入
- 充值页面新增桌面端和移动端选项
- 在mac端，选择桌面端后支付时会显示付款二维码
- 在ipad端，选择桌面端后支付宝会显示付款二维码，微信会拉起微信支付，选择移动端后都是拉起对应软件支付
- 优化：
- 改进查询额度的弹窗显示
- 更新api
- 从最小化显示时自动提高到最高层级
- bug修复：
- 修复parseHexColor的bug
- 修复一个订阅问题
- 修复充值验证时额度用尽导致的APIKey禁用问题
- 修复MNNote实例allText属性的bug
mnutils_v0_1_8.mnaddon (2.1 MB)
- 新功能：
-
0.1.7
mnutils_v0_1_7.mnaddon (2.1 MB)- 修复mnutil.hasMNImages的问题
- 刷新内容方面增加重试机制
- 尝试下载分流和重试
- 修复一个不能打开学习集的问题
- 改进log方法
- 优化下载页面视图
- 修复留白相关的API bug
- 改进充值逻辑
- 增加配置备份功能，防止意外闪退导致的配置丢失，全自动，用户无需操作
-
0.1.6
mnutils_v0_1_6.mnaddon (2.1 MB)- API 改进：
- MNUtil新增静态方法focusHistory,记录最近十次的操作
- 增加MNUtil增加isAddonRunning方法，用来判断某些插件是否处于运行状态
- MNUtils.log()支持直接传入object,会自动转为detail中的值
- 增加类MNLog,用以代替MNUtil.log,原API保留
- 改进MNUtil.input方法,支持在弹出框中输入默认值
- 新增MNUtil.doSegment方法,用于分词
- MNNote新增一批实例方法
- 修复menu.show()自动调整菜单宽度的bug
- 忘了还有哪些了
- bug修复：
- 修复从最小化恢复后未能刷新页面的bug
- 修复共享中心的一些bug
- 修复一些bug
- 改进：
- 粘贴apikey时自动检测是否有效
- 优化充值流程
- 改进部分动画
- 额度用尽时弹窗提示，且可以直接打开充值面板
- 支付宝充值完成后尝试根据回调直接打开私信面板并检测apikey
- 改进消费日志查询的进度提示
- 改进悬浮按钮与打开后窗口的位置关系
- 优化报错提醒
- 改进在论坛中下载插件/学习集等情况的进度展示
- 下载学习集时先检测学习集是否已经存在
- 改进预览
- 改进日志功能
- 日志面板支持复制所有
- 部分报错转移到log中,而不是剪贴板
- 改进订阅时网络错误的处理逻辑
- URL5回归
- 新功能：
- 增加URL延迟测试
- 支持通过URL Scheme切换页面
- 点击Have questions?时加载订阅文档
- 悬浮按钮模式下支持长按快速切换页面
- 支持打开小红书主页
- 支持打开常见问题页面
- 支持快速加群
- API 改进：
-
0.1.5
mnutils_v0_1_5.mnaddon (776.7 KB)-
修复一个utils的问题(可能导致ChatAI同步bug)
-
暂时移除URL5
-
支持充值时自动填写要充值的apikey
-
提供一个反馈网址
-
API更新
-
新增一个log viewer，支持用
MNUtil.log("示例文本") -
插件从插件栏中独立出来，支持全局显示，支持贴边
-
改进动画逻辑
-
新增shared Notebooks和shared Documents，可以用来下载共享的学习集和文档
-
下载插件时会发送一个http请求以便后台计数
-
UI修改
-
修复一个bug
-
改进窗口切换逻辑
-
修复一个贴边错误的bug
-
改进MNUtil.copy方法
-
改进窗口弹出逻辑
-
-
0.1.4
mnutils_v0_1_4.mnaddon (752.4 KB)-
修复打开侧边栏失败的问题
-
修复购买apikey链接无法打开的问题
-
改进无法刷新插件列表时的报错
-
修改URL3
-
API更新和修复
-
修复报错提示的一点问题
-
修复一个无法resize窗口的问题
-
默认启动界面改为插件更新界面
-
改进一些提示
-
改进购买订阅按钮
-
改进创建卡片时学习集内无绑定文档的报错
-
改进插件未激活下的弹窗
-
改进订阅提醒
-
当一次性订阅天数超过10天时,需要弹窗确认
-
修复一些焦点占用问题
-
直接直接查询消费日志
-
大胡子变量模板支持管道操作符
-
改进插件内购买,会直接弹出付款二维码
-
增加一个为key充值额度的按钮
-
修复一个订阅问题
-
改进充值流程
-
添加常见问题按钮
-
-
0.1.3
mnutils_v0_1_3.mnaddon (516.7 KB)-
增加历史版本下载功能
-
禁止同时下载多个插件，以避免可能带来的问题
-
当页面宽度足够时，插件管理页面点击插件自动展开文档页面
-
粘贴订阅key时检测格式
-
改进 waitHUD和 showHUD之间的可能冲突
-
MNNote实例增加方法 copyURL和 removeTags
-
getNoteById增加一个alert参数，默认为true，设为false后则在笔记不存在时不报错
-
MNNote增加静态方法 exist，用于判断笔记是否存在
-
改进免费次数的提示
-
修复一个可能导致闪退的问题
-
支持一次订阅多个天数（多的保存在本地）
-
支持打开私信列表后自动弹出订阅确认
-
-
0.1.2
- 改进md2html方法,支持mn图床
- 改进currentSelection属性
- 增加MNComment类
- MNUtil类新增 getCloudDataByKey、 setCloudDataByKey和 userSelect方法
- 改善对照模式下获取选中摘录的一点问题
- 下载插件时支持显示进度
- 增加下载错误检测
- 增加更新提示
- 为部分方法提供链式调用功能
- 改进MNButton.setColor方法
mnutils_v0_1_2.mnaddon (443.6 KB)
-
0.1.1
- 尝试修复在某些版本系统上的兼容性问题
- 新增一个alpha面板,目前两个面板内容一致,后续测试版只在alpha面板中展示,另一面板用来展示正式版
- 新增一个Roadmap选项,点击会通过MN Browser打开网址: https://mnaddon.craft.me/roadmap
- MNUtil新增方法
openDoc,importDocument,isNoteInReview,render,toggleExtensionPanel,constrain,emojiNumber,isIOS,isMacOS,isIPadOS,countWords,getNoteFileById,getRandomElement,isNSNull,runJavaScript - MNUtil新增属性
extensionPanelController,extensionPanelView - MNNote实例属性新增方法
insertChildBefore,removeFromParent,getMDContent - MNNote新增静态方法
fromSelection用于从文档选中文字创建摘录 - MNConnection新增方法
loadFile,loadHTML,getOnlineImage - 改进MNUtil的
currentSelection属性 - 新增类MNExtensionPanel,用于管理扩展面板
- 修复
getFocusNote无法获取保存的对照视图中的卡片的问题 - 修复
appendTags方法的问题 - 通过MNNote的
excerptText实例属性设置摘录文本时,如果检测到为图片摘录,则自动开启文本优先 - UI改进
- 新增一个闪退按钮
mnutils_v0_1_1.mnaddon (440.1 KB)
-
0.1.0
- 支持直接在MN内购买订阅key及查询消费日志
- 支持直接在MN内下载安装插件（最后依然需要重启）
- 订阅key默认隐藏，避免泄露
- 双击刷新按钮强制重新加载插件更新栏
- 支持在MN学习集内直接打开插件面板
- 改进订阅逻辑，在本地存有天数的情况下无论是否激活都能直接激活订阅
- MNNote实例补充属性：childMindMap，改进createChildNote和createBrotherNote
mnutils_v0_1_0.mnaddon (430.8 KB)
-
0.0.9
- 新增部分API并修复部分API问题
- 修复演示模式重启后的报错
- 修复文档摘录添加子节点的问题
- 整合MN subscription，因此可以删除MN subscription插件（删除不会移除配置）
- 修复自动订阅下可能的连续两次订阅问题
mnutils_v0_0_9.mnaddon (70.0 KB)
-
0.0.6
- 改进selectionText属性、getFocusNote()和getFocusNotes()方法，以兼容多文档分割视图
- MNUtils新增getDocImage()方法，以获得文档选中图片（支持多文档分割视图）
- MNNote新增getImageFromNote()方法
mnutils_v0_0_6.mnaddon (48.9 KB)
-
0.0.5
- 改进genFrame方法，可以一定程度上避免因参数失误带来的闪退问题
- getPopoverAndPresent方法支持设置弹出位置
- 改进MNNote.new()方法
- 新增类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)
