Skip to content

脚本管理

在「脚本管理」页面,你可以看到所有已安装的脚本,并进行安装、运行、卸载等操作。


查看脚本列表

页面以卡片列表的形式展示所有脚本。每张卡片包含:

  • 图标 — 脚本的自定义图标(未设置时显示默认图标)
  • 名称 — 脚本的显示名称
  • 描述 — 脚本功能简介
  • 标签 — 灰色标签表示脚本是本地安装的,其他颜色表示来自脚本市场
  • 操作按钮 — 运行、置顶、卸载等

我的脚本-不忙脚本盒子


安装脚本

从脚本市场安装

  1. 点击左上角 「安装脚本」 按钮
  2. 在脚本市场中搜索你需要的脚本
  3. 点击脚本右下角的安装按钮即可

安装脚本-不忙脚本盒子

详见 脚本市场

从本地安装

  1. 同样点击 「安装脚本」
  2. 在弹出的窗口中点击右上角的「本地安装」
  3. 选择 .zip 脚本压缩包文件
  4. 点击安装即可

本地安装-不忙脚本盒子

本地安装的脚本需要符合盒子的配置规范,具体要求见开发指南 → 脚本目录结构规范

安装失败怎么办?

安装过程中出错时,盒子会自动回滚——删除已创建的脚本目录、移除已注册的右键菜单,并返回错误提示。不会留下装了一半的残骸。

请根据错误提示修正后重试。常见原因见 脚本市场 → 安装失败怎么办


运行脚本

直接运行

点击脚本卡片即可运行。

脚本运行时有没有窗口,取决于脚本作者设置的终端模式

模式表现适合
静默模式后台执行,不弹窗口跑完就完事的任务(如文件整理)
弹窗模式弹出控制台窗口需要看输出过程的脚本
智能模式有参数时静默,无参数时弹窗兼顾两种场景
反转模式有参数时弹窗,无参数时静默调用时想看进度、手动运行时走 GUI 的脚本

反转模式(inverse)和智能模式正好相反:你通过右键菜单、快捷键调用脚本时它弹窗显示进度,但在盒子里手动点击运行时反而静默。适合带进度的批量处理——比如你要处理 100 个文件、想看到实时进度条的场景。

点了没反应?

如果点了脚本卡片什么都不出现,大概率是静默模式——脚本其实在后台跑,只是没窗口。

可以观察系统托盘图标,或者去「设置」→「日志管理」查看运行日志确认。

通过触发器运行

除了点卡片,脚本装好后还能用四种方式触发。具体用哪种取决于脚本作者开启了哪些支持:

方式说明详见
快捷键在任意应用中按下预设热键快捷键管理
右键菜单在资源管理器中右键文件或文件夹右键菜单管理
超级复制双击 Ctrl+C超级复制
定时任务按计划自动执行定时任务

拿不准该用哪种?先看 四种触发方式怎么选

不是每个脚本都支持全部四种方式——支持哪些由脚本作者决定。如果某个脚本在对应管理页面里找不到,说明作者没开启。


卸载脚本

在脚本卡片上单击右键,选择 「卸载」

卸载操作会:

  1. 清除该脚本绑定的快捷键
  2. 移除右键菜单注册
  3. 删除脚本目录和运行环境
  4. 从数据库中删除记录

卸载不可恢复

卸载会连脚本的运行环境一起删掉,重新安装的脚本需要重新走一遍环境部署。

如果只是暂时不想用,建议关掉对应触发器页面的开关,而不是卸载。


更新脚本

从脚本市场安装的脚本均支持自动更新:

  1. 如果已安装的脚本有了新版本,软件上会有气泡提示
  2. 打开「设置」→「脚本更新」→ 点击「更新脚本」,等待更新完成即可

脚本更新-不忙脚本盒子

更新不会清除你已绑定的快捷键和右键菜单设置。


下一步

文档版本 0.3.0 · MIT License