ToolkitPlugin for Obsidian

ToolkitPlugin 是一款为 Obsidian 打造的综合功能增强插件，旨在通过一系列实用的微调和自动化功能来提升您的笔记工作流。

目前它主要解决了从Wolai等块式笔记系统导入数据后的结构痛点，并提供了自由的视觉控制。

🚀 主要功能

1. 文件夹快速新建 (Quick Create Button)

在文件夹右侧添加一个+图标（悬停时显示），点击即可在文件夹内快速新建笔记。

• 自动展开：如果文件夹处于收起状态，点击+会自动将其展开。
• 焦点定位：新建笔记后，文件树会自动定位并高亮显示该笔记，方便立即开始编辑。
• 智能拦截：针对已展开的文件夹，点击+绝不会触发误收起。

2. 文件夹自动打开 (Auto-open Wolai-style Folders)

针对特定的文件夹结构（文件夹名与内部唯一的.md文件名一致），实现“点击/双击”文件夹直接打开正文的功能。

• 自动识别：智能匹配文件名与目录名。
• 干扰排除：自动忽略image文件夹，确保在 Wolai 风格结构下依然能一键触达内容。

3. 文件拖拽锁定 (Drag-and-Drop Lock)

防止在文件列表中浏览时误触导致的文件/文件夹移动。

• 即时锁定：开启后，文件树内的所有拖拽操作将被拦截并提示。
• 便捷切换：通过侧边栏的“锁”图标或命令面板快速加锁/解锁。

4. 视觉清理 (Visual Cleaning)

一键隐藏/显示文件列表中的特定资源目录。

• 全局隐藏：默认支持匹配所有层级的image文件夹（不分大小写）。
• 快捷切换：通过 Ribbon 图标、命令面板或快捷键即时切换。

5. 一键折叠 (One-Click Folding)

针对当前正在阅读的 Markdown 文件，实现快速折叠/展开特定层级标题的功能。

• 智能切换：通过侧边栏图标（双向箭头）即时折叠/展开当前文件的所有一级标题（H1）。
• 层级控制：支持通过命令面板快速折叠 H1、H2 或 H3 级别的所有标题。
• 高度灵活：可以在设置中自定义侧边栏按钮默认折叠的标题深度（1-6 级）。
• 右键集成：支持在编辑器内通过右键菜单快速触发折叠。

6. Mermaid 流程图适配与全屏查看 (Mermaid Scaling & Fullscreen)

解决 Mermaid 流程图显示受限的问题，提供多维度的查看方案。

• 自适应宽度：默认自动缩放至笔记宽度，美观统一。
• 互动缩放：控制条支持实时+/-缩放，鼠标离开自动恢复。
• 一键全屏：新增Maximize按钮，点击可在沉浸式弹窗中查看图表原始全尺寸。
• 手势支持：全屏模式下支持Cmd/Ctrl + 滚轮（或触摸板捏合）进行缩放，支持左键抓取进行平移。
• 灵敏度可调：可在设置中调节Mermaid Zoom Sensitivity（默认 1.0），适配不同触控板手感。
• 独立开关：可在设置中切换适配功能的开启状态。

7. 多语言支持 (Multi-language Support)

插件界面（设置、命令、提示等）会自动适配 Obsidian 的界面语言。

• 支持语言：简体中文 (zh)、繁体中文 (zh-tw)、英语 (en)。
• 自动回退：若当前语言不被支持，将自动显示英文界面。

8. 高度可配置

所有功能都可以在插件设置页面进行独立开关，满足不同场景下的需求。

🛠️ 安装说明

1. 在您的 Obsidian 库中创建目录：.obsidian/plugins/obsidian-toolkit-plugin/。
2. 将以下文件放入该目录：
   • main.js
   • manifest.json
   • styles.css
3. 在 Obsidian 设置中启用ToolkitPlugin。

⚒️ 开发与构建

如果您想自行修改并构建插件，可以参考以下命令：

1. 安装依赖：

   npminstall

2. 开发模式 (自动编译)：

   npmrun dev

3. 生产构建：

   npmrun build /nodeesbuild.config.mjs production

   构建完成后，新的main.js将出现在项目根目录下。

📈 未来规划

ToolkitPlugin 作为一个通用增强包，未来将持续集成更多提升效率的功能，包括但不限于：

• 更多排版优化工具。
• 增强型文件管理自动化。
• 自定义样式注入。

📜 许可证

MIT

Developed byTangren