插件反馈
- QQ 交流群：1045708101
！插件依赖 MN Utils 插件运行
！插件依赖 MN Utils 插件运行
！插件依赖 MN Utils 插件运行
请先安装MN Utils插件 
MN Utils
v4.2 后可通过长按
进入教程模式
目前论坛的文字部分教程不完善，但更新日志是完整的，可以查看参考。
近期会完善论坛的文字教程，以及后续有 b 站视频教程版本录制的计划。
目前可以借用插件内置的教程和手册进行学习使用
点击手册的某一项后，会跳转到具体的相应功能界面
MNPinner
简单来说，它就像是 VSCode 的侧边栏，或者是 Mac 的“台前调度”，帮你把 MarginNote 里最重要、最常用的内容“钉”在手边，随时调用。
它的应用取决于你的想象力：
- 任务管理
- 项目管理
- 文献管理
- 书签管理
- 子脑图管理
- ……
为什么做这个插件？（痛点）
在使用 MN4 深度学习或写论文时，我经常遇到这些打断心流的情况：
- 阅读打断：读到一半，需要回去查前文的“定义”或“图表”，翻回去看完再翻回来，思路断了。
- 迷失在大脑图里：脑图太大，刚才那条分支找不到了，像大海捞针一样缩放平移。
- 碎片化严重：复习时，相关的知识点（例题、错题、结论）散落在不同的文档和卡片里，想把它们凑在一起看很麻烦。
- 写作不便：写卡片笔记时，需要频繁参考大纲或外部链接，来回切换界面很累。
MNPinner 就是为了解决这些**“上下文丢失”**的问题。
核心功能
1. 
万物皆可 Pin
不只是笔记卡片！你可以把以下内容一键钉在悬浮面板上：
- 文档页面：高频查阅的图表页、目录页。
- 笔记卡片：核心定义、公式、待办事项。
- 外部链接：Notion 页面、参考文献 URL。
- 文本：临时复制的一段话、文档内选中的内容 （v4.2 后支持自动/手动 pin MNChatAI 插件的回答）
- 文档/剪切板中的图片
- 当前视图（uistate）状态：保存 MarginNote 的界面状态（脑图、文档等），一键还原。
(注：图片类型的 Pin 也有优秀的 MN Snipaste 插件支持)
2. 
树状层级管理
不再是乱糟糟的列表。你可以像电脑资源管理器一样，创建文件夹，按**「项目 / 课程 / 论文」**分类管理你的 Pin。
- 支持无限层级。
- 顶部面包屑导航，一眼看清当前位置。
- 最重要的是 Pin 住的卡片可以可逆地转化为文件夹！
3. 
极速跳转 (Killer Feature)
点击面板里的条目：
- 如果 Pin 的是卡片：立刻跳转到脑图对应位置并选中。
- 如果 Pin 的是页面：立刻翻到那页 PDF。
- 如果 Pin 的是 uistate：立刻恢复到保存时的界面状态。
- 如果 Pin 的是"https"链接，如果安装了 MN Browser 插件，可以直接打开对应网页，否则会在系统浏览器中打开。
- 如果 Pin 的是剪贴板文本，则会弹出一个对话框显示该文本内容，文本的标题和内容可以不同，可以修改文本的标题，并且可以一键将模板化的内容制卡
- 如果 Pin 的是图片，可以在新的独立面板中打开，并可以拖拽、添加到评论
价格与获取方式
为了保证插件能长期维护更新，MNPinner 采用**“免费试用 + 灵活付费”**模式。
免费版（足够轻度使用）
- 无需付费，安装即可用。
- 限制：仅限在默认的「Focus」面板下使用。
- 额度：每天 10 次 免费写入/跳转额度（次日自动刷新）。
- 适合：临时需要 Pin 几个图表对照阅读的场景。
付费版（解除限制 + 高级功能）
解锁多文件夹管理、无限层级、无限写入次数。我们提供了多种方案（主要通过闲鱼平台自动发货）：闲鱼宝贝详情
• 尝鲜券（¥1 / 3天）：每设备限兑 1 次，低成本体验。
• 周卡（¥3 / 7 天、¥5 / 14 天）
• 月卡（¥10 / 30 天）
• 年卡（¥45 / 365 天）
• 单设备买断（¥128）
邀请码奖励
你可以在插件的「 邀请码」界面将自己的邀请码分享给他人，别人在兑换年卡令牌前填写你的邀请码，双方都能额外获赠 30 天时长！
活动规则：
- 双方奖励：每成功邀请一位，双方各 +30 天。
安装指南
- 前置要求：必需安装并启用 MNUtils 插件（MNPinner 依赖它的底层能力）。
- 下载 MNPinner
- 安装：下载后在 MN4 中导入插件即可。
Q&A
- 只能在 MN4 用吗？
- 应该是的，MarginNote 3 没测试过，uistate 也是 MN4 才有的功能。
- 需要联网吗？
- 使用的时候不需要，所有数据都保存在本地，但是检查订阅、检查更新这些需要联网
- 怎么使用呢？不太会用
- 安装后在 MN4 侧边栏会出现 MNPinner 图标，点击即可打开悬浮面板。具体的使用方法等日后有空再写详细教程，目前大家可以自行探索，功能并不复杂，自己摸索一下应该就能上手。
- 为什么没有 1.0, 2.0 等版本，直接是 4.0？
- 因为前期内测版本没有发布， 4.0 经历了数据底层重新设计，功能重构等重大变化，直接从 4.0 开始发布。
感谢
感谢优秀的插件开发者 @linlifei （我比 @linlifei 菜多了）开发的众多优秀插件，尤其是封装了众多插件基础 API 的 MNUtils，是 MN Pinner 的主要上游插件。我也是学习 @linlifei 的 MNUtils, MNToolbar 一点点学会了一些插件开发的皮毛，特此鸣谢。
版本更新
v4.2
mnpinner_v4_2.mnaddon (2.3 MB)
MNPinner v4.2 更新日志
本次更新带来了强大的 AI 协作能力、全新的 Markdown 编辑器体验以及多项效率改进。现在，您可以更自然地定制工具栏，更流畅地编辑文本，甚至让插件自动帮您收集 AI 的灵感。
核心亮点：AI 与智能化集成
自然语言创建工具栏按钮
不懂代码也能做插件！现在你可以用大白话描述需求，AI 帮你写代码。
- 怎么用：打开配置管理器 → 「
动作」 → 点击「AI 助手」。输入如“我想要兄弟卡片的标题，用换行分隔”，AI 自动生成对应模板。 - 价值：零门槛实现复杂功能，支持中英文指令，让工具栏真正为你所用。
自动收集 AI 问答（联动 MNChatGLM）
不再错过任何灵感，让 AI 的回答自动沉淀到知识库。
- 怎么用：打开配置管理器 → 「
跨插件通信」 → 开启「自动 Pin AI 回答」。 - 价值：MNChatAI 的回答会自动保存为文本 Pin，支持指定节点存放，省去繁琐的复制粘贴。
内置 BigBang 分词
无需额外安装插件，MNPinner 现已自带分词能力。
- 怎么用：在文本 Pin 编辑面板点击「 BigBang」，即可对长文本进行分词、搜索、打标签或提取标题。
图片 Pin 自动 OCR
- 怎么用：安装 MNOCR 插件后，Pin 图片时会自动识别其中文字，方便检索与导出。
写作体验：Markdown 编辑器升级
全新 Markdown 分屏编辑器
告别简陋输入框，享受专业级的写作体验。
- 怎么用：长按文本 Pin 的「
编辑」按钮进入。左侧编辑，右侧实时预览。 - 亮点：支持大纲跳转、正则替换、快速插入链接，所见即所得。
悬浮文本编辑面板
- 怎么用：点击任意文本 Pin（剪贴板类型）即可唤起独立窗口。
- 亮点：窗口可拖动、缩放，支持多开。大屏编辑长文更舒适，不遮挡阅读视线。
交互升级：长按 vs 单击
- 编辑：单击「」快速修改；长按进入高级分屏编辑器。
智能 Title Case
- 优化：标题转英文大写时更加智能，自动识别并保留
a/an/the等虚词小写，符合出版规范。
效率工具：工作流与导出
新增「预订阅」与续费顺延
- 预订阅：网络不稳定时，可提前购买天数存入余额，需要时随时开启。
- 顺延：24h 窗口期内再次点击开启，时间自动顺延，无需等待过期。
导出功能大修
- 批量操作：支持多选 Pin 后批量导出为 Markdown、纯文本或图片。
- 智能识别：导出文本时会自动跳过图片 Pin，避免格式错误；导出图片时自动创建卡片。
- 联动 MNSnipaste：长按卡片 Pin 可直接发送至 MNSnipaste 查看或编辑。
用户工具栏增强
- 新增图片 Pin：一键将图片固定为 Pin，素材收集更顺手。
界面与交互优化
新增「教程模式」：在偏好设置中开启。开启后，点击界面按钮会弹出功能说明和下一步建议，新手也能快速掌握高级玩法。- 响应式布局：配置管理器在大屏下双列展示，小屏自动切换单列，Token 复制更方便。
搜索体验：搜索结果中的 Link 支持长按选择打开方式（如 Research 浏览器）。
筛选与排序：支持单独筛选「图片」类型；筛选文件夹支持手动拖拽排序。
改进与修复
- 配置稳定：重构了配置管理器，修复了偏好设置偶尔无法保存的问题。
- 排序修复：解决了批量 Pin 内容时顺序错乱的问题。
- 文案优化：将“归档”统一优化为“整理”，语义更清晰。
v4.1
mnpinner_v4_1.mnaddon (513.0 KB)
更新内容
更新
远程同步系统
- 启用远程同步: 支持多设备间自动同步 Pin 数据
- 自动拉取: 启动/回到前台/iCloud 变化时自动导入远端数据
- 冲突策略: 提供 4 种冲突处理策略
- 提示选择
- 优先本地
- 优先远端
- 合并 Pin
- iCloud 支持: 监听 iCloud KVS 外部变化,实现实时同步
- WebDAV 增强: 改进网络请求封装,支持状态码检测
图片 Pin 功能
- 完整的图片 Pin 支持: 可以 Pin 来自选区/剪贴板/相机的图片
- UIState 绑定: 长按保存时可同时记录选区范围,点击可定位到原文
- 图片预览:
- 单击查看图片
- 长按同时触发选区定位和图片预览
- 支持 WebView 渲染,改善缩放和交互体验
- 图片二级菜单:
- 更新图片
- 绑定/更新/清除 UIState
- 发送到 MNSnipaste 打开
- 修改标题
- 转换为文件夹
- 转移到其他节点
- 删除图片
- 卡片管理:
- 新增 Image 类型筛选按钮
- 显示图片尺寸/来源/UIState 标记
- 支持图片搜索
Pin 搜索面板
- 全局搜索: 可以搜索所有 Pin 的标题和内容
- 快速定位: 搜索结果直接跳转到对应 Pin
文件夹系统增强
- Pin 转文件夹: 支持将 Pin 探索为文件夹(二合一功能)
- Pin 自身携带 folderNodeId 指向节点树
- 可作为内容 Pin 使用,也可作为文件夹容器
- 文件夹树节点隐藏: 支持隐藏不需要的文件夹节点
- 节点选择器优化: 改进节点选择器的显示和交互体验
- 删除节点优化: 改进删除节点时的移动目标选择逻辑
功能增强
更新系统改进
- 简化更新机制:
- 移除 alpha/stable 双通道
- 移除自定义 manifest URL 配置
- 自动更新优化:
- 增加 MNConnection 就绪检测 (最多等待12秒)
- 启动检查失败时自动重试 (最多4次)
- 修复 sceneWillConnect 过早调用问题
- 增加内存中的节流 (1.5秒) 防止重复触发
- notebookWillOpen 时补充重试检查
批量操作增强
- 多选功能:
- 新增批量选择模式
- 支持全选/清空选择
- 选中项视觉反馈
- 批量操作:
- 批量转移 Pin 到其他节点
- 批量倒序排列
- 批量删除
标题编辑增强
- 自动使用选中文本: 编辑标题时,如果有选中文本,自动填充
- 预设短语改进:
- 拆分为「前插」和「后插」两个按钮
- 添加预设短语功能说明文字
- 修复 emoji 和特殊字符在 URL 编码中损坏问题 (改用扁平化参数传递)
界面优化
- 面板分隔器:
- 增加视觉提示图标 (↔)
- 添加悬停/拖拽动画
- 调整默认左右面板宽度比例 (45% → 56%)
- 配置管理器:
- 优化关闭按钮位置
- 新增远程同步相关设置选项
- 改进 URL 编码处理
- 版本显示优化:
- 调整版本标签文字 (“已安装 -” / “最新 -”)
- 移除更新通道选择下拉菜单
Bug 修复
- 修复 nodeId 丢失导致交互失效问题: 确保节点 ID 正确传递和保存
- 修复 WebView 中 textarea 自动高度调整的布局问题: 改进表单输入体验
- 修复选择功能和界面细节: 多选模式下的各种问题
- 修复配置持久化逻辑: 确保配置正确保存
- 修复 UIState 绑定问题: 无选区时自动使用当前文档信息
- 修复"转移到"功能能转到筛选文件夹的问题: 防止误操作
v4.0
mnpinner_v4_0.mnaddon (450.7 KB)