README file from
GithubQuicker Wheel
Quicker Wheel is a mobile-friendly radial command wheel for Obsidian. It brings a Quicker-style circular menu, a configurable floating button, and eight-direction swipe actions to both desktop and mobile. You can bind wheel slots or floating-button gestures to Obsidian commands, notes in your vault, URI actions, or reusable wheel actions.
The plugin is designed for fast touch-first workflows: tap the floating button to open the wheel, swipe in one of eight directions to run an action, or long-press and drag to move the button.
一个面向 Obsidian 移动端优化的 Quicker 风格轮盘插件。它提供轮盘菜单、悬浮按钮、8 方向滑动动作,让常用命令和文件打开更快触达。
Features
- Open a Quicker-style radial wheel from the command palette or a floating button.
- Bind wheel slots to Obsidian commands, vault files, URI actions, and reserved script actions.
- Tap an empty wheel slot to create a new action for that exact position.
- Use the floating button on both desktop and mobile.
- Configure three floating-button gestures:
- Tap: open the wheel
- Quick swipe in eight directions: run the matching direction action
- Long press and drag: move the floating button
- Reuse existing wheel actions for floating-button direction actions.
- Customize wheel size, ring count, slot count, text size, opacity, colors, and gesture timing.
功能特点
- 通过命令或悬浮按钮打开 Quicker 风格轮盘。
- 轮盘格子支持绑定 Obsidian 命令、打开文件、URI 和预留脚本动作。
- 点击轮盘空格可以直接创建该位置的新动作。
- 移动端和桌面端都可以显示悬浮按钮。
- 悬浮按钮支持三种手势:
- 短按:打开轮盘
- 快速向 8 个方向滑动:执行对应方向动作
- 长按拖动:移动悬浮按钮位置
- 悬浮窗动作可以直接复用已有轮盘动作。
- 支持调整轮盘大小、圈数、格数、文字大小、透明度、颜色和触发时间。
安装方式
方式一:使用 BRAT 安装
- 在 Obsidian 中安装 BRAT。
- 打开 BRAT 设置。
- 选择
Add Beta plugin。 - 粘贴仓库地址:
https://github.com/nocodeuse-dev/obsidian-quicker-wheel
- 回到 Obsidian 的第三方插件列表,启用
Quicker Wheel。
方式二:手动安装
- 从最新 Release 下载这三个文件:
main.jsmanifest.jsonstyles.css
- 在你的 Obsidian 仓库中创建文件夹:
.obsidian/plugins/quicker-wheel/
- 把三个文件放进这个文件夹。
- 重启 Obsidian,或重新加载第三方插件。
- 在设置中启用
Quicker Wheel。
使用方式
在 Obsidian 命令面板中搜索并运行:
打开 Quicker Wheel 轮盘
也可以在插件设置中开启悬浮按钮。移动端推荐使用悬浮按钮作为主要入口:
- 短按悬浮按钮:打开轮盘
- 快速向某个方向滑动:执行该方向动作
- 长按并拖动:移动悬浮按钮
如果想快速进入插件设置,可以运行:
打开 Quicker Wheel 设置
设置说明
插件设置包含:
轮盘菜单设置轮盘动作管理悬浮窗设置悬浮窗动作管理其他
在 轮盘动作管理 中,可以编辑轮盘动作的名称、图标、动作类型和目标命令或文件。
在 悬浮窗动作管理 中,可以为 8 个方向分别设置动作,也可以直接复用已有轮盘动作。
官方社区插件提交说明
本仓库保留源码、构建配置、测试和发布产物,以便通过 Obsidian 官方社区插件审核。
隐私与外部链接
- 插件不收集遥测数据。
- 插件不要求登录任何账号。
- 插件会读取 vault 内 Markdown 文件路径,用于“打开文件”动作的搜索建议;不会上传文件路径或文件内容。
- 点击
其他页面中的帮助按钮会打开飞书文档链接。 - 如果你配置了 URI 动作,执行该动作时会打开你自己填写的外部链接。
Privacy and external links
- Quicker Wheel does not collect telemetry.
- Quicker Wheel does not require any account login.
- The plugin reads Markdown file paths from your vault to provide file search suggestions for "open file" actions. It does not upload file paths or file contents.
- The help button in the "Other" settings tab opens a Feishu document link.
- URI actions open the external links that you configure yourself.
从源码构建
npm install
npm run build
构建产物为:
main.jsmanifest.jsonstyles.css
开发
npm test
npm run build
本项目还包含本地同步脚本:
npm run sync
注意:sync 脚本使用的是作者本机 Obsidian 仓库路径,如果你要在自己的电脑上使用,需要先修改 scripts/sync.mjs 或设置 OBSIDIAN_QUICKER_TARGET 环境变量。
作者
nocodeuse
许可证
MIT