﻿# DAYU 用户插件接入文档

这是一份可单独交给 AI 的公开接入文档，不是工具箱项目源码，也不是安装包。制作自己的插件时，把本文件夹和**你自己的原始脚本或需求**一起交给 AI。

正常产品形态是：安装一个 DAYU 工具箱，就拥有框架和随附的官方插件。用户自制插件是额外扩展，不替代官方插件，也不要求用户下载框架工程。

## 选哪份文档

| 你要做什么 | 阅读入口 |
| --- | --- |
| 让 AI 从需求制作插件，或转换已有 MS 窗口 | [交给 AI 的任务说明](agent-task.md) |
| 普通按钮、输入框、下拉框和参数联动 | [普通接入](basic.md) |
| 动态列表/预览、场景交互、连续编辑、后台任务、持久状态 | [复杂接入](advanced.md) |
| 控件、颜色层级、排版和缩放规则 | [控件与布局](controls.md) |
| 编辑器边界、配置注释、文件体积和安全 | [编辑配置与安全](editing.md) |
| 放入目录后不显示、执行错误、更新和兼容问题 | [发布与排错](troubleshooting.md) |
| AI 需要精确字段结构或方法签名 | [声明格式](reference/plugin-schema.json)、[公共接口](reference/public-api.md)、[能力清单](reference/capabilities.json) |

普通接入不需要先学习复杂服务。第三方不要求官方验证、签名、构建回执或官方打包工具；框架会自动检查格式、能力和身份冲突。这些接入规则不替代工具箱本体的使用授权；扩展在 Max 进程中执行，不是沙箱，只导入可信来源。

## 用户最终只做什么

1. 让 AI 生成适配后的插件文件夹。
2. 在 `placement.json` 填写分类和排序。
3. 可在设置 → 自定义插件中导入完整文件夹或 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 应列出缺口，不要求用户交出工具箱项目，也不编造私有接口。
