feat(form): 发布表单字段与各模块「新建发布」页完全对齐

原来助手表单只渲染"缺失的必填项"，且控件只有文本/单选/时间 —— 与各模块
自己的发布页相比缺了接收对象多选、附件、定时发送、置顶、紧急程度、回执单据、
发布方式等字段，用户没法"填得一样"。

补齐一层共享的表单能力，再把三个发布工具按模块页逐字段重写：

共享能力
- ToolParam: 新增 join(分隔符)/multiple/allOption(哨兵)/scopes(推送范围)，
  array 类型有选项来源时自动用多选控件；数组 schema 补 items
- ToolDef: 新增 fullForm() —— 表单渲染全部字段（不再只渲染缺失必填）
- ToolExecutor: POST_JSON 前按 joinSeparator 把数组拼成模块要的逗号串；
  allToken 与具体项互斥（只选具体项→拼串，否则发哨兵）
- AgentOrchestrator: file 控件补 uploadPath（/<模块>/api/base/FileUpload）
- 模板/参数文件同步下发 joinSeparator/uploadPath/multiple/allToken/scopeType

三个发布工具
- notice.publish: 补重要程度/接收班级(pushScopes 对象数组)/置顶/短信/阅读回执/
  附件/定时发送/发布方式；新增 notice.stuTree（组织树）
- dorm.publish: 补紧急程度/生效时间/回执截止/回执单据/接收宿舍(多选,ALL)/
  宿管配合/置顶/短信/附件/定时发送/存草稿
- activity.publish: 补报名截止/回执方式三档/名额上限/家长随行/活动费用/
  接收班级(多选,ALL)/短信/附件/定时发送/存草稿
- leave.submit/register: 连续请假改为可填参数，补连续天数与佐证材料附件

测试：发布工具契约 + 表单字段与模块页一致性断言；90 tests 全绿

src/main/java/com/yunhai/agent/tool/ToolParam.java

@@ -62,9 +62,52 @@ public class ToolParam {
     /** 示例值（表单 placeholder，如 2026-10-11 08:00:00），也会进入给模型的描述 */
     private String example;
 
-    /** 控件类型：text / textarea / number / date / datetime / select；缺省按参数名与类型自动推断 */
+    /**
+     * 控件类型：text / textarea / number / date / datetime / select / multiselect / file；
+     * 缺省按参数名与类型自动推断。
+     *
+     * <ul>
+     *   <li>{@code multiselect}：多选下拉（配合 {@code type=array}），用于「接收班级 / 宿舍 / 审批人」这类
+     *       模块里是多选的字段。</li>
+     *   <li>{@code file}：附件上传（对齐模块页的「添加附件」），上传后得到 fileid 列表。</li>
+     * </ul>
+     */
     private String widget;
 
+    /**
+     * 数组值的序列化分隔符（仅 {@code POST_JSON} 生效）。
+     *
+     * <p>★ 为什么需要：模块的很多字段在 wire 上是「逗号串」而不是 JSON 数组
+     * （如宿舍通知 {@code receiveList="1,2,3"}、附件 {@code fileIds="11,12"}），
+     * 但表单里用户是多选的（天然是数组）。声明 {@code .join(",")} 后，执行器会在发请求前
+     * 把数组拼成模块要的字符串，避免"页面里选得到、提交后端判非法"。
+     */
+    private String joinSeparator;
+
+    /** {@code widget=file} 时是否允许多个附件（缺省 true）；对齐模块页 AttachmentUpload 的 multiple */
+    private Boolean multiple;
+
+    /**
+     * 「全部」哨兵值。
+     *
+     * <p>★ 用途：模块的接收对象多选里都有一个「全部班级 / 全部宿舍」开关，wire 上是 {@code "ALL"}。
+     * 声明后：① 表单把它作为第一个选项摆进多选；② 提交时若用户既没选具体项、又没选它，
+     * 视作「全部」（保持"默认发全体"的语义）；③ 若同时选了具体项与它，以**具体项**为准（折叠掉它）。
+     */
+    private String allToken;
+
+    /** 「全部」选项在表单里显示的中文名，如「全部班级」/「全部宿舍」 */
+    private String allTokenLabel;
+
+    /**
+     * 「推送范围」控件（widget=scopes）的节点类型。
+     *
+     * <p>校园公告的接收对象 {@code pushScopes} 在 wire 上是
+     * {@code [{scopeType,scopeId,scopeName}]}（1 全校 / 2 学部 / 3 年级 / 4 班级 / 5 训练队 / 6 指定学员）。
+     * 声明后前端把多选结果拼成这个对象数组；选「全部」则发出 {@code [{scopeType:1,scopeId:0,scopeName:"全部班级"}]}。
+     */
+    private Integer scopeType;
+
     /** 是否在表单里隐藏（如由系统固定填入的参数，用户无需看见） */
     private boolean hidden;
 
@@ -185,6 +228,43 @@ public class ToolParam {
         return this;
     }
 
+    /**
+     * 数组值序列化分隔符：{@code POST_JSON} 时把多选的数组拼成模块要的「逗号串」。
+     * 例：{@code optional("fileIds","array",...).join(",")} → {@code "11,12,13"}。
+     */
+    public ToolParam join(String separator) {
+        this.joinSeparator = separator;
+        return this;
+    }
+
+    /** 附件是否可多选（仅 {@code widget=file} 有意义） */
+    public ToolParam multiple(boolean value) {
+        this.multiple = value;
+        return this;
+    }
+
+    /**
+     * 「全部」哨兵值（如 {@code "ALL"}）：表单会把它作为多选的第一个选项，
+     * 提交时与具体项互斥（见 {@link #allToken} 字段说明）。
+     */
+    public ToolParam allOption(String token, String label) {
+        this.allToken = token;
+        this.allTokenLabel = label;
+        return this;
+    }
+
+    /**
+     * 声明为「推送范围」多选：提交时把选中的节点拼成
+     * {@code [{scopeType,scopeId,scopeName}]}（校园公告的 {@code pushScopes}）。
+     *
+     * @param type 节点类型：1 全校 / 2 学部 / 3 年级 / 4 班级 / 5 训练队 / 6 指定学员
+     */
+    public ToolParam scopes(int type) {
+        this.widget = "scopes";
+        this.scopeType = type;
+        return this;
+    }
+
     /** 表单里显示的名字 */
     public String labelOf() {
         return StringUtils.isNotBlank(label) ? label : name;
@@ -216,6 +296,12 @@ public class ToolParam {
     public String resolveWidget() {
         if (StringUtils.isNotBlank(widget)) return widget;
         List<String> vals = effectiveValues();
+        boolean isArray = "array".equalsIgnoreCase(StringUtils.trimToEmpty(type));
+        if (isArray) {
+            // 数组参数：有选项来源（枚举或字典）→ 多选下拉；否则退化成文本（用户手填逗号串）
+            if ((vals != null && !vals.isEmpty()) || StringUtils.isNotBlank(optionsFrom)) return "multiselect";
+            return "text";
+        }
         if (vals != null && !vals.isEmpty()) return "select";
 
         String t = StringUtils.trimToEmpty(type).toLowerCase();
@@ -264,6 +350,11 @@ public class ToolParam {
         f.setDependsOn(dependsOn);
         f.setValueKey(optionValueKey);
         f.setLabelKey(optionLabelKey);
+        f.setJoinSeparator(joinSeparator);
+        f.setMultiple(multiple == null || multiple);
+        f.setAllToken(allToken);
+        f.setAllTokenLabel(allTokenLabel);
+        f.setScopeType(scopeType);
         // 选项是内置兜底（不是学校实时字典）时如实告知，前端可提示用户
         f.setOptionsFallback(isUsingFallbackOptions());
         return f;
@@ -273,6 +364,11 @@ public class ToolParam {
     public JSONObject toSchema() {
         JSONObject o = new JSONObject();
         o.put("type", type);
+        if ("array".equalsIgnoreCase(StringUtils.trimToEmpty(type))) {
+            JSONObject items = new JSONObject();
+            items.put("type", "string");
+            o.put("items", items);
+        }
         String desc = description == null ? "" : description;
         List<String> vals = effectiveValues();
         if (vals != null && !vals.isEmpty()) {