# Joplin Explorer

一个 [Joplin](https://joplinapp.org/) 插件，将笔记本和笔记合并显示在一个统一的树形侧边栏中，类似文件资源管理器。

[English](README.md)

![Joplin Explorer 侧边栏](https://raw.githubusercontent.com/lim0513/joplin-explorer/HEAD/assets/1.png)

| 悬停预览 | 右键菜单 | 设置 |
| :---: | :---: | :---: |
| ![悬停预览](https://raw.githubusercontent.com/lim0513/joplin-explorer/HEAD/assets/2.png) | ![右键菜单](https://raw.githubusercontent.com/lim0513/joplin-explorer/HEAD/assets/3.png) | ![设置](https://raw.githubusercontent.com/lim0513/joplin-explorer/HEAD/assets/4.png) |

## 功能

- **统一树形视图** — 笔记本和笔记显示在同一个可折叠面板中
- **自定义图标** — 显示笔记本设置中的 emoji 图标；可在设置中自定义文件夹和收藏夹的图标（支持 emoji / 图片 URL / data URI / 本地文件路径）
- **折叠箭头开关** — 可在设置中隐藏展开/折叠箭头，界面更简洁
- **实时刷新** — 笔记标题或待办状态变化时面板自动原地更新
- **收藏夹（Pin）** — 收藏笔记和笔记本，固定在树顶部可折叠区段；拖拽项目到收藏夹直接收藏，收藏夹内拖拽排序；重启后保持
- **增强搜索** — 同时搜索笔记、笔记本和标签，关键词高亮；结果按类型分组可折叠；支持子串匹配（如 "8121R" 可匹配 "KY8121R"）
- **排序** — 按修改时间或标题排序（升序/降序切换）
- **右键菜单**
  - 笔记本：收藏/取消收藏、新建笔记、新建待办、新建子笔记本、重命名、导出、删除
  - 笔记：收藏/取消收藏、打开、在新窗口打开、复制 Markdown 链接、复制副本、笔记/待办切换、切换完成状态、重命名、查看属性、删除
- **拖拽** — 拖拽笔记到其他笔记本，拖拽文件夹调整层级；拖到底部空白区创建新笔记本；拖到收藏夹直接收藏
- **侧栏开关** — 工具栏按钮、**查看**菜单项，以及可自行绑定的快捷键都能隐藏/显示面板，不用禁用插件就能腾出宽度
- **行密度可调** — 行字号和行高可在高级设置里调整，大型笔记树能在一屏内显示更多内容
- **同步按钮** — 一键触发同步，带状态反馈（同步中 → 同步完成）；同步进行中会变成**取消**
- **自动展开** — 启动时自动展开到当前选中的笔记
- **全部折叠** — 一键折叠所有笔记本
- **滚动位置保持** — 切换笔记时不会跳到顶部
- **多语言** — 支持简体中文、繁体中文、英文、日语、俄语（跟随 Joplin 语言设置）

## 安装

### 从文件安装

1. 从 [最新 Release](https://github.com/lim0513/joplin-explorer/releases/latest) 下载 `joplin-explorer.jpl`
2. 打开 Joplin，进入 **工具 → 选项 → 插件**
3. 点击齿轮图标，选择 **从文件安装**
4. 选择下载的 `.jpl` 文件
5. 重启 Joplin

## 使用方法

安装后，Explorer 面板会出现在编辑器侧边。你可以：

- **点击** 笔记本展开/折叠
- **点击** 笔记打开它
- **右键** 弹出操作菜单（包含收藏/取消收藏）
- **拖拽** 笔记或笔记本来重新组织；拖到底部区域创建新笔记本；拖到收藏夹直接收藏
- 使用顶部 **工具栏** 快速新建笔记本/笔记/待办、排序、全部折叠
- 使用 **搜索栏** 搜索笔记、笔记本和标签
- 点击底部 **同步** 按钮触发同步，同步过程中再点一次即可取消
- 用工具栏按钮、**查看 → 显示/隐藏 Explorer 侧栏**，或在 Joplin 快捷键设置里自行绑定的按键来开关整个面板

## 开发

```bash
# 安装依赖
npm install

# 构建
npm run dist

# 监听模式
npm run dev
```

构建产物输出到 `publish/` 目录。本地测试时，在 Joplin 设置中将 `plugins.devPluginPaths` 指向 `publish/` 目录即可。

## 特别感谢

特别感谢 [@CJeffyB](https://github.com/CJeffyB)——他持续、高质量的问题反馈和功能建议塑造了 v1.5–v1.6 的大部分演进，还在 Ko-fi 上请项目喝了杯咖啡。☕

同时感谢 [@bwat47](https://github.com/bwat47) 的 PR [#30](https://github.com/lim0513/joplin-explorer/pull/30) 与多个敏锐的问题报告。

## 许可

MIT