入门与设置 / DAYU TOOLBOX 5.0
接入概览
先了解用户扩展的安装方式、资料结构和适用范围。
这是一份可单独交给 AI 的公开接入文档,不是工具箱项目源码,也不是安装包。制作自己的插件时,把本文件夹和你自己的原始脚本或需求一起交给 AI。
正常产品形态是:安装一个 DAYU 工具箱,就拥有框架和随附的官方插件。用户自制插件是额外扩展,不替代官方插件,也不要求用户下载框架工程。
选哪份文档
| 你要做什么 | 阅读入口 |
|---|---|
| 让 AI 从需求制作插件,或转换已有 MS 窗口 | 交给 AI 的任务说明 |
| 普通按钮、输入框、下拉框和参数联动 | 普通接入 |
| 动态列表/预览、场景交互、连续编辑、后台任务、持久状态 | 复杂接入 |
| 控件、颜色层级、排版和缩放规则 | 控件与布局 |
| 编辑器边界、配置注释、文件体积和安全 | 编辑配置与安全 |
| 放入目录后不显示、执行错误、更新和兼容问题 | 发布与排错 |
| AI 需要精确字段结构或方法签名 | 声明格式、公共接口、能力清单 |
普通接入不需要先学习复杂服务。第三方不要求官方验证、签名、构建回执或官方打包工具;框架会自动检查格式、能力和身份冲突。这些接入规则不替代工具箱本体的使用授权;扩展在 Max 进程中执行,不是沙箱,只导入可信来源。
用户最终只做什么
- 让 AI 生成适配后的插件文件夹。
- 在
placement.json填写分类和排序。 - 可在设置 → 自定义插件中导入完整文件夹或 ZIP/RAR/7z 压缩包;也可将整个文件夹放入 Windows“文档”下的
DAYUCG/大鱼工具箱/自定义插件/插件包,再重启 Max 后打开工具箱。
plugin.json、placement.json、main.ms 是框架识别的固定文件名,不能翻译或重命名。文档、分类名、按钮名和提示可以用中文。
版本范围
公共作者合同:1.0.0 / 1.1.0,目标:author-services-v1。普通三文件插件可用 1.0.0;需要共享参数组等 1.1.0 特性时明确选择 1.1.0。配套统一安装测试包面向 3ds Max 2024–2027;实际安装与启动检查结果以安装包随附说明为准。框架能加载插件不等于该插件的业务算法已通过审核;作者仍需验证自己的操作、外部依赖及目标 Max 版本。
用户不需要提供框架源码、官方插件工程、测试日志或内部构建工具。遇到文档未定义的能力,AI 应列出缺口,不要求用户交出工具箱项目,也不编造私有接口。