功能截图

功能特性

笔记本树形视图

• 层级展开/折叠 — 以树形结构浏览所有笔记本与子笔记本，支持一键展开/折叠
• 实时高亮 — 当前打开的笔记在树中高亮显示，并自动滚动到可视区域
• 笔记计数 — 每个文件夹旁显示包含的笔记数量
• Emoji 图标支持 — 自动识别并显示 Joplin 笔记本的 Emoji 图标
• 待办状态 — 区分普通笔记与待办事项（已完成/未完成不同图标）

智能导航历史

• 光标位置追踪 — 自动记录编辑器内的光标位置，每2秒保存一次
• 跨文件导航 — 支持在不同笔记之间前进和后退
• 精确恢复 — 恢复到记录的精确光标位置（行号和列号）
• 鼠标侧键支持 — 在插件面板内使用鼠标按键3/4快速导航
• 全局快捷键 — Ctrl+Alt+Left/Right 在任何地方都能使用
• 智能去重 — 自动合并相似位置，避免冗余历史记录

双栏标签页

• Notebooks — 笔记本与笔记的树形导航
• Outline — 自动提取当前笔记的 Markdown 标题大纲，点击即可跳转到对应位置

搜索与筛选

• 实时搜索 — 支持按关键词快速搜索笔记和笔记本
• 搜索历史 — 自动保存最近搜索记录，支持快捷回溯
• 高级筛选 — 可按类型（笔记/笔记本）、修改日期范围进行组合筛选
• 排除管理 — 可将特定笔记或笔记本加入排除列表，在视图中隐藏

右键操作菜单

• 新建笔记 / 新建子笔记本
• 重命名（行内编辑）
• 在新窗口中打开
• 创建副本 / 复制 Markdown 链接
• 移动到其他笔记本
• 导出为 Markdown / HTML / PDF / JEX
• 查看属性 / 发布
• 删除（带二次确认，删除笔记本需输入名称确认）

同步与设置

• 一键同步 — 底部集成同步按钮与同步状态/日志面板
• 隐藏标题栏 — 可在设置中隐藏笔记编辑器上方的标题输入框，获得更沉浸的编辑体验

安装

通过 Joplin 插件仓库安装（推荐）

1. 打开 Joplin，进入 工具 → 选项 → 插件
2. 在搜索框中输入 Full Notebook View
3. 点击安装即可

手动安装

1. 手动编译本仓库， 获取 .jpl 文件
2. 打开 Joplin，进入 工具 → 选项 → 插件
3. 点击 从文件安装，选择下载的 .jpl 文件

使用说明

打开面板

安装后，插件会在 Joplin 右侧新增一个侧边栏面板。你也可以通过工具栏上的 树形图标按钮 切换面板显示/隐藏。

快捷键与交互

| 操作 | 说明 | |------|------| | 点击 ▶/▼ | 展开或折叠文件夹 | | 点击笔记名称 | 在编辑器中打开该笔记 | | 右键点击 | 打开操作菜单（新建、导出、删除等） | | Outline 标签页 | 点击标题跳转到笔记对应位置 | | 鼠标按键 3 (插件面板内) | 后退到上一个光标位置 | | 鼠标按键 4 (插件面板内) | 前进到下一个光标位置 | | Ctrl + Alt + Left | 后退到上一个光标位置（全局快捷键） | | Ctrl + Alt + Right | 前进到下一个光标位置（全局快捷键） |

设置

进入 工具 → 选项 → Full Notebook View 可调整：

• Hide note title bar — 隐藏笔记标题输入栏

构建

# 安装依赖
npm install

# 构建插件（生成 dist/ 与 publish/）
npm run dist

构建完成后，publish/ 目录下会生成 .jpl 插件包和 .json 清单文件。

技术栈

• TypeScript
• Joplin Plugin API
• 原生 WebView（Vanilla JS + CSS）

兼容性

• Joplin v3.5+
• 支持 Windows、macOS、Linux

贡献

欢迎提交 Issue 和 Pull Request！

如果你有任何建议或发现了 Bug，请通过 GitHub Issues 反馈。

许可证

本项目基于 MIT 许可证开源。