工具箱设置 / DAYU TOOLBOX 5.0
自定义插件
把自己的MS脚本加入大鱼工具箱:简单脚本放入脚本目录直接运行,带参数界面的工具制作成用户扩展,统一放进分类与卷展栏,并管理后续更新。
快速开始
- 仅需运行脚本时使用“自定 → 脚本管理”,把可信脚本放入对应目录后刷新。
- 需要带参数与布局的工具时,打开“设置 → 自定义插件”,在页内列表导入和管理完整扩展。旧版若显示管理按钮,点击后进入独立管理窗口。
- 核对扩展来源、目标分类与版本,完成接入后从分类中找到功能。
本页概览为5.0.75实机界面。未展开的分组以正文说明为准;仍标注旧版本的细节图仅作参考。
选择接入方式
脚本管理适合已有的单个常用脚本,单击执行即可。完整扩展适合包含参数界面、多项功能和资源的工具组;功能与界面配置分开,便于后续维护。
一个工具组可以提供多个卷展栏,分类负责导航,不必把每个卷展栏拆成独立安装包。
要让 AI 将普通脚本转换为工具箱界面,可直接使用AI脚本接入指南,将其中的固定网址和自己的脚本一起交给 Agent。
文件放在哪里
完整插件文件夹默认放在 Windows 实际“文档/DAYUCG/大鱼工具箱/自定义插件/插件包”,包含 plugin.json、placement.json、清单指定的脚本或模块,以及所需资源。带原生组件的包还需包含对应 Max 年份的组件和依赖,不要只复制 main.ms。文档目录被 OneDrive 接管或迁移时,使用系统返回的实际位置。普通脚本放在“自定义插件/脚本”下,由脚本管理的 A–D 子目录组织。
导入文件夹、压缩包和更新时选择的是来源,存放位置统一由工具箱管理。点击“打开目录”查看实际目录,悬停该按钮也可查看完整路径;无需为每个插件另选安装位置。
完整插件和普通脚本是两种使用方式,不要只把 main.ms 单独拖入 Max 来代替扩展安装。旧版 ToolboxExtensions 中已归属的扩展在首次使用新默认位置时会校验迁移,原文件保留;详见目录与配置。
编写与编辑
制作自己的扩展时先列清输入对象、参数、执行结果和错误提示,再编辑界面与功能。可以借助 AI 编写,但生成代码仍需要阅读和确认用途。
先从一个按钮、一组明确参数开始,确认能在独立场景完成任务,再增加功能。不要把来源不明的脚本仅换个名称就导入工作场景。
导入、更新与迁移

左侧底部以低对比度小字显示当前安装版本;点击 DaYuCG.COM 打开官网查看更新。
管理列表嵌入“设置 → 自定义插件”:支持导入文件夹、导入 ZIP/RAR/7z 压缩包、打开统一目录和删除。已安装版本若尚无这些按钮,仍可按接入指南放入完整插件文件夹。该列表只管理自定义插件,官方工具仍由安装包管理。新包导入前检查清单和依赖,不执行脚本;同身份包不能直接覆盖,应选中已有插件后“导入更新”;更新来源选择完整新版文件夹,插件标识必须相同、版本号必须更高。
当前页面顶部的“打开布局编辑器…”与“编辑器说明”同排显示;底部操作行提供“AI 接入说明”按钮,直接打开脚本转换指南。选中“自定义插件”分类后,分类按钮上的 ? 仍打开本页。导入按钮的悬浮提示也会说明普通脚本需要先转换。目录和空列表说明放在对应控件的提示中,操作结果仍显示在列表下方。
导入、更新、回滚和删除独立于设置底部的“应用/取消”,重启 Max 后加载变更。删除会先标记,重启 Max 后将插件及更新记录移入自定义目录的恢复区,已有配置与资源保留;当前会话不会热替换或卸载已加载代码。
“刷新状态”只重新读取版本、待生效变更和错误,不加载新放入的代码。存在上一版本且没有待生效变更时,才可安排回滚。
扩展文件、用户配置和资源图库各自承担不同内容。分享工具时需要同时检查依赖与资源,不要以为导出工具箱配置就包含扩展源码和素材。
更新后检查原分类与卷展栏入口;需要外部直达时再到系统快捷键同步注册。简单脚本目录操作见脚本管理。
导出插件压缩包
在“设置 → 自定义插件”的列表中选中插件,点击“导出压缩包…”;也可从该插件的右键菜单选择同名操作。
导出的是选中插件当前实际版本的 ZIP,可在另一台电脑重新导入。请选择插件目录之外的保存位置和新的文件名;已有文件不会被覆盖。导出不会运行插件脚本,也不包含框架更新历史、管理缓存与用户凭据。
文件导出完成后再分享给对方。完整扩展需要对应的运行环境,导出成功不表示另一版本的 Max 一定兼容。导入、更新、回滚和删除后需要重启 Max;仅导出或打开插件目录不需要重启。
带原生组件的扩展怎样安装
5.0.75 加入原生组件扩展支持。仍从“自定义插件”导入作者提供的完整文件夹或压缩包,不需要把 DLL、DLX 逐个拖进 Max。包必须包含当前 Max 年份对应的 x64 组件和依赖;不同年份的组件不能混用。
导入后如提示“原生组件已登记”,关闭并重新启动 Max,再打开扩展。刷新列表、关闭工具箱或重新打开分类不能代替重启。更新已安排时同样先重启,不要在当前会话强行覆盖正在加载的文件。
| 提示 | 处理方法 |
|---|---|
| 不包含当前 Max 版本的原生组件 | 向作者取得支持当前年份的完整包。 |
| 组件或依赖缺失、文件校验不一致 | 重新取得并导入完整包,不混合不同版本的文件。 |
| 已加载其他位置的同名组件 | 核对重复安装位置,处理后重新启动 Max。 |
| Max 未加载已登记的 DLX | 核对年份、依赖和 Max 启动日志;此时扩展脚本不会继续执行。 |
原生支持不会自动授予第三方插件许可,也不保证任意旧插件都可以直接作为工具箱扩展。作者仍需按公开接入约定制作包;用户界面排版与原生组件加载分别管理。