Tuopan

中文 | English

让 Obsidian 在 Windows 上常驻系统托盘的插件：开机静默启动，关窗不退出，再次打开不弹选库窗，一个快捷键直达今天的快速笔记。

目前只在 Windows 上验证过，在其他系统上插件不会启用。

功能

• 开机自启并隐藏到托盘：只有开机自启时才隐藏，手动打开时正常显示。
• 关窗留在托盘：点 X 只隐藏窗口，弹出的副窗口一起隐藏和恢复。
• 不弹选库窗：Obsidian 已在运行时再点快捷方式，直接恢复窗口。
• 清晰的托盘图标：首次运行时生成多尺寸图标，Windows 按屏幕缩放选对应尺寸。
• 全局快捷键：可设置显示或隐藏窗口、打开今天的快速笔记，默认不占用任何按键。
• 快速笔记：同名笔记直接打开，在新标签页打开，不替换正在看的内容。
• 托盘菜单：显示或隐藏、快速笔记、重启 Obsidian、彻底退出。

安装

先关掉其他托盘插件，否则快捷键和关窗行为会冲突。

用 BRAT 安装

1. 在第三方插件里安装 BRAT。
2. 运行命令 BRAT: Add a beta plugin for testing，填入 incredible404-rgb/tuopan。
3. 在第三方插件里启用 Tuopan。

手动安装

1. 从 最新发布 下载 main.js 和 manifest.json。
2. 在仓库里新建 .obsidian/plugins/tuopan/ 文件夹，把两个文件放进去。
3. 在 设置 → 第三方插件 里刷新列表，启用 Tuopan。

使用

1. 打开 设置 → Tuopan，需要开机启动就打开“开机自启”。
2. “开机时隐藏到托盘”保持开启，开机后就在托盘里。点托盘图标显示或隐藏窗口。
3. 右键托盘图标可以打开快速笔记、重启 Obsidian 或彻底退出。真正关闭 Obsidian 要用“彻底退出”。
4. 需要快捷键时，在快捷键栏填 CmdOrCtrl+Alt+O 这样的值，离开输入框后全局生效。
5. 在“快速笔记”里设置存放文件夹和文件名格式。

运行细节

• 托盘图标创建失败时不隐藏窗口，点 X 会真正关闭，窗口不会找不回来。
• 开机自启默认关闭。自启项只在首次启用和切换开关时写入，你在任务管理器里关掉后不会被改回来。
• 关机和注销时不拦截退出，“重新加载应用”也能正常使用。

仓库以外的访问

本插件不联网，也没有遥测。下面是它访问仓库以外内容的全部情况：

• 读取 Obsidian.exe 的图标：用来生成插件文件夹里的 tray.ico。Obsidian 的图标不随本项目分发。
• 写入 Windows 登录启动项：只在打开“开机自启”时，写入当前用户的 Run 项 Obsidian 托盘，并删除 electron.app.Obsidian 和 Obsidian Windows Startup 两个其他托盘插件留下的项，避免开机启动两次。
• 注册系统全局快捷键：只注册你设置的快捷键。

致谢

设计时参考了 Background Tray、Traystone 和 Windows Startup and Tray 三个插件的功能。代码为独立编写，与这些项目以及 Obsidian 官方都没有隶属关系。

许可证

MIT