本页目录
自定义控制栏按钮
概览
控制栏分为两个区域：
- 左侧（文件级别）： 与外部应用程序集成及快捷操作（例如“用...打开”、“在资源管理器中显示”）。这些可在
设置 - 控制栏中配置。 - 右侧（预览级别）： 视口预览控件（例如旋转、静音、缩放）。
本指南重点介绍如何扩展左侧区域。
添加控制项
在 设置 - 控制栏 中，您可以管理内置按钮、创建自定义操作或安装控制栏插件。
1. 自定义操作
- 点击操作列表下方的 + 并选择要运行的程序或脚本。
- 在右侧面板中配置操作详情：
- 名称：在工具提示中显示的名称。
- 可执行文件：目标可执行文件 (
.exe) 的路径。 - 参数：命令行参数。使用如
"${input_file}"等占位符来传递文件路径。 - 文件格式：目标扩展名（例如
png,zip）或特殊标记（例如${type_folder}）。 - 成功启动后关闭预览：外部程序成功启动后关闭预览窗口。Seer 不会等待该程序结束。
2. 控制栏插件
控制栏插件提供打包好的操作套件。它们与自定义操作不同，后者使用的是您电脑中已有的程序或脚本。
官方控制栏插件下载
官方控制栏插件包已统一汇总至下载中心，请前往 插件下载 - 控制栏插件 下载所需插件包（.zip）。下载后无需解压，可在 设置 > 控制栏 中直接导入使用。
安装下载的插件
- 在
设置 > 控制栏中，点击列表下方的 + 按钮。 - 直接选择下载的
.zip压缩包，或选择完整解压包中的plugin.json文件。 - 在右侧详情面板中检查导入操作支持的格式与行为。
- 点击确定保存并使用。点击取消将放弃导入。
如果导入的插件包属于其他类型，Seer 会自动跳转到对应的设置页面。
管理操作
- 重新排序：在列表中拖放项目以调整按钮在控制栏上的显示顺序。
- 启用 / 禁用：选中操作并在其详情中更改启用状态，随后保存设置。
- 自定义配置：对于已安装的插件，您可以随时自定义其匹配的文件格式与命令行参数，或恢复默认值。
- 内置按钮：内置操作（用默认程序打开、在资源管理器中显示、同类型浏览）可单独开启或关闭。
占位符与特殊标记
1. 命令行参数占位符
Seer 提供内置标记，在启动外部工具时会在运行时动态解析：
| 占位符 | 说明 | 示例 |
|---|---|---|
${input_file} |
当前预览文件或文件夹的绝对路径。 | C:\Users\Username\Documents\file.zip |
${7z} |
内置 7z.exe 的绝对路径，亦可在【可执行程序】路径中直接填写。 |
C:\Program Files\Seer\plugins\7z.exe |
${seer_exe} |
Seer.exe 的绝对路径。 |
C:\Program Files\Seer\Seer.exe |
${seerviewer_exe} |
SeerViewer.exe 的绝对路径。 |
C:\Program Files\Seer\SeerViewer.exe |
${seer_dir} |
包含 Seer.exe 的目录。 |
C:\Program Files\Seer |
${screenshot} |
当前视图截图的临时 PNG 绝对路径。 | C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png |
如果路径可能包含空格，请用双引号将占位符括起来："${input_file}"。
需要编写自定义控制栏插件？请参阅 插件开发与实现 获取完整的占位符与匹配标记矩阵，包括各类插件所支持的占位符范围。
2. 文件格式特殊标记
在文件格式字段中使用这些标记来匹配非标准文件类型或文件夹：
| 标记 | 说明 |
|---|---|
${type_folder} |
匹配目录与文件夹。 |
${type_file} |
匹配所有文件（包括无扩展名的文件）。 |
${type_all} |
匹配所有内容（同时匹配文件和文件夹）。 |
${type_pdf} |
匹配 PDF 文档。 |
${type_image} |
匹配图片文件，与内置图片查看器的分类一致。 |
${type_media} |
匹配音频/视频文件，与内置媒体查看器的分类一致。 |
${type_web} |
匹配网页文件（HTML 与 Markdown），与内置 HTML 查看器的分类一致。 |
${type_text} |
匹配文本/代码文件，与内置文本查看器的分类一致。 |
${type_none} |
匹配不属于以上任何类别的文件（例如压缩包、可执行程序）。 |
注意：标记不区分大小写，并且可以与扩展名使用空格或逗号组合（例如 png jpg ${type_folder}）。${type_*} 类别标记按扩展名分类，使用与内置查看器一致的扩展名表（包含 设置 - 类型 中的自定义支持/排除列表），因此控制操作的匹配范围与内置预览始终一致。类别标记只匹配文件，如需同时匹配文件夹请与 ${type_folder} 组合。
3. 配置示例：使用 7-Zip 解压文件
若要添加一个使用内置 7-Zip 解压压缩包的按钮：
- 可执行文件：
${7z}（或浏览选择您自己的7z.exe）。 - 参数：
x "${input_file}" -r -y -o"C:\Output\Path\" - 文件格式：
zip rar 7z tar gz
参数详细说明：
* x：保留完整路径解压。
* "${input_file}"：目标压缩包文件。
* -r：递归子目录。
* -y：自动默认确认所有询问（覆盖）。
* -o"..."：输出目录。