核心概念

搞懂插件、指令、槽位这几个基本概念,用起来更顺手。

UDhold 的所有功能都围绕"插件"组织。理解下面几个概念,用起来会顺手很多。

插件

插件是 UDhold 扩展能力的基本单元。UDhold 自带的功能(文件管理、设置、插件市场)本身就是插件,你从插件市场装的第三方工具也是插件。每个插件提供一个或多个具体功能,比如翻译、截图、颜色吸取。

指令

指令是触发插件的"关键词"。你在搜索框里输入的内容,UDhold 会拿去和各个插件登记的指令做匹配:

  • 文字指令:直接输入字或词,比如输入"翻译"就找到翻译插件
  • 拼音:输中文拼音或首字母也行,比如 fy 能匹配到"翻译"
  • 文件指令:把文件拖进搜索框,支持处理文件的插件就会出现
  • 图片指令:复制了图片后,能处理图片的插件会被触发

一个插件可以有多个指令,你也可以给同一个插件的不同功能设置不同的触发词。所有指令都能在 所有指令 里集中查看和管理。

槽位

打开一个插件时,它会显示在界面的某个固定区域,这叫"槽位"。UDhold 的主面板把界面分成三块:

┌────────┬──────────────────────────┬────────────┐
│        │                          │            │
│ 左面板  │       工作区(多标签)     │  右面板     │
│        │                          │            │
└────────┴──────────────────────────┴────────────┘
  • 左侧面板:单面板,跟随菜单切换,主要放导航类内容(如文件树、设置分组),默认宽度 240px,可在 240~480px 间拖拽调整
  • 工作区:多 tab 容器,占满中间,是主操作区(文件浏览、设置详情、AI 对话历史),tab 可分离成独立窗口,还支持分栏
  • 右侧面板:全局单例,由插件 API 唤醒,放辅助工具(如 AI 助手常驻),默认宽度 280px,可在 280~480px 间调整

插件该显示在哪是由插件自己决定的,你打开时不用管,UDhold 会自动放到合适的位置。详细的布局和操作看 主面板布局

三套界面

UDhold 有三个面向用户的窗口,记住它们就掌握了 80% 的用法:

界面用途唤起方式
主搜索框(Spotlight)快速搜索应用和指令全局快捷键(默认 Alt+Z / macOS Option+Z
主面板(panel-shell)仿 VSCode 风格的工作台,承载所有插件界面点击托盘图标,或搜索框中点击头像
超级面板在任意应用中长按鼠标弹出的快捷指令面板长按鼠标键(默认关闭,需在设置开启)

插件市场

UDhold 内置一个插件市场,里面是社区和官方发布的插件。你可以一键浏览、安装、升级,不用手动下载解压。需要什么能力就去市场找,详见 插件管理

接下来可以看 主面板布局,熟悉搜索框和工作区的具体操作。