需启用并正确配置脚本插件:一、确认activex引擎支持,将脚本存于/dopusdata/script addins目录;二、单个.js文件直接复制启用;三、.osp包拖入脚本管理器安装;四、.opusscriptinstall双击自动部署;五、通过“关于”和事件函数验证响应。

如果您已安装 Directory Opus 并希望扩展其功能,但发现内置命令无法满足自动化响应文件窗口打开、标签切换或视图变更等场景,则很可能是尚未启用或正确配置脚本插件。以下是完成第三方脚本插件安装与使用的具体步骤:
一、确认脚本插件支持环境
Directory Opus 脚本插件依赖 ActiveX 脚本引擎运行,需确保系统已启用 JScript 或 VBScript 支持(Windows 默认已安装)。脚本插件文件必须存放于特定目录才能被识别,该目录路径由 Opus 内部变量 /dopusdata/Script AddIns 指定,不可随意更改位置。
1、启动 Directory Opus,点击菜单栏“设置”→“首选项”。
2、在左侧树状列表中展开“工具”,选择“脚本管理”。
3、查看右侧“脚本插件文件夹”路径显示是否为 /dopusdata/Script AddIns;若为空或异常,点击“浏览”按钮手动定位至该路径并保存。
二、安装单个脚本文件(.js 或 .js.txt)
适用于轻量级、独立功能的脚本,如自动重命名模板或列计算逻辑。此类文件无需打包,直接放置即可生效,但须确保扩展名准确且内容为合法 JScript/VBScript 语法。
1、将下载得到的 xxx.js 或 xxx.js.txt 文件复制到 /dopusdata/Script AddIns 目录中。
2、返回 Opus 主界面,按 Ctrl+Shift+P 打开脚本管理对话框。
3、在脚本列表中查找刚放入的文件名,勾选其左侧复选框以启用。
4、若脚本声明了自定义命令或列,可在“设置”→“工具栏和热键”→“用户命令”中搜索对应名称并拖入工具栏使用。
三、安装脚本包(.osp 文件)
.osp 是 ZIP 格式压缩包,可包含多个脚本、图标资源及元数据描述,适合分发功能完整、结构复杂的插件。Opus 可原生识别并解压其内容至脚本插件目录,同时注册所有内嵌事件处理器与命令。
1、将 plugin_name.osp 文件拖拽至脚本管理对话框的空白区域。
2、弹出安装向导后,核对将安装的脚本列表,取消勾选不需要的子项(如仅需其中一项命令)。
3、点击“安装”,等待状态栏显示“完成”提示。
4、关闭对话框,在任意文件窗口中右键 → “脚本插件”子菜单下应可见新添加的命令条目。
四、使用脚本安装器(.opusscriptinstall 文件)
该格式由 Opus 官方生成,专为安全共享设计,内含校验信息与依赖检查机制。它能自动处理脚本所需的所有附属文件(如 include.js),避免因缺失引用导致运行失败。
1、双击 installer.opusscriptinstall 文件,系统将自动调用 Opus 脚本安装器(前提是 Opus 已正确安装且非便携模式运行)。
2、安装器加载后,显示版本对比信息:若检测到旧版同名脚本,会标出当前版本号与待安装版本号。
3、勾选“覆盖现有脚本”选项(如需更新),然后点击“下一步”开始部署。
4、安装完成后,结果对话框中列出新增命令与列;可直接将命令图标拖至工具栏,或将列标题拖至详细信息视图头部。
五、验证脚本插件是否正常响应事件
脚本插件的核心特性是事件驱动——例如当用户切换标签页时自动执行某段逻辑。若脚本未触发,常见原因为未启用对应事件入口点或脚本语法错误导致初始化失败。
1、在脚本管理对话框中选中目标脚本,点击下方“关于”按钮,确认其声明支持的事件类型(如 OnTabActivate、OnFolderChange)。
2、打开两个不同路径的标签页,手动切换焦点,观察状态栏是否出现预期提示(如有输出语句)。
3、若无反应,点击“编辑”按钮打开脚本源码,检查是否存在 function OnTabActivate() 等函数定义,且函数体未被注释或语法错误中断。











