名单： *
判据与能力目录 / 模型侧过滤**完全一致**（{@code visibleTools}），
+ * 因此不存在「直达出一个本身份无权使用的表单」的可能；不命中或不适用就返回 {@code null}，
+ * 照常交给大模型处理。
+ */
+ private ChatResponse directForm(String message, CallerContext caller, Set 用于业务模块的字典接口（班级、学生名单、请假类型…）——这些接口只认浏览器 CAS 会话，
+ * 服务端直调必然 302，所以只能把地址交给前端、由前端带用户登录态去取。
+ */
+ private BrowserToolRequest.BrowserCall buildOptionCall(ToolParam p, CallerContext caller) {
+ if (StringUtils.isBlank(p.getOptionsFrom())) {
+ return null;
+ }
+ try {
+ ToolDef dict = registry.get(p.getOptionsFrom());
+ if (dict == null || !dict.isReadOnly()) {
+ return null;
+ }
+ // 与 fetchDictOptions 同源的角色约束：越权的字典不外泄地址
+ if (settings.isEnforceRolePermission() && !dict.allowsAny(caller.getRoles())) {
+ return null;
+ }
+ return executor.prepareOptionCall(dict, p.getDependsOn());
+ } catch (Exception e) {
+ log.warn("生成代取选项描述失败 {}：{}", p.getOptionsFrom(), e.toString());
+ return null;
+ }
+ }
+
/** 取字典选项（带缓存；取不到返回空列表，调用方据此退化为普通输入框） */
private List ⚠️ 这里**不能放「请」**：{@code 请假申请} 本身以「请」开头，剥掉就变成「假申请」，
+ * 反而会让标准说法匹配不上。只放意义明确的多字助动词。
+ */
+ private static final String[] PREFIXES = {
+ "我想要", "我需要", "我要", "我想", "帮我", "帮忙", "麻烦",
+ "给我", "替我", "替", "申请", "提交", "办理", "办"
+ };
+
+ /** 后缀（语气词），同上 */
+ private static final String[] SUFFIXES = {
+ "一下", "吧", "呢", "啊", "哦", "呀", "嘛", "了", "的"
+ };
+
+ /**
+ * 判断一句话是不是「裸请假意图」。
+ *
+ * @return 命中的意图；不是裸意图（含细节、或别的意图）返回 {@code null}
+ */
+ public Intent match(String rawMessage) {
+ String normalized = normalize(rawMessage);
+ // 长度门槛：真·裸意图都很短；长句几乎必然带时间/事由等细节，交给模型更合适
+ if (normalized.length() < 2 || normalized.length() > 12) {
+ return null;
+ }
+ if (LEAVE_BARE.contains(stripDecorations(normalized))) {
+ return LEAVE;
+ }
+ return null;
+ }
+
+ /** 去掉空白与标点（中英文都要），便于按「标准说法」比对 */
+ private String normalize(String s) {
+ if (StringUtils.isBlank(s)) {
+ return "";
+ }
+ return s.replaceAll("[\\s\\u3000]+", "")
+ .replaceAll("[，。！？、,.!?~～\"'“”‘’：:；;（）()《》\\[\\]【】]", "");
+ }
+
+ /** 剥掉「我要 / 帮我 / 麻烦…」这类前缀与「吧 / 了 / 一下」这类后缀，只留核心说法 */
+ private String stripDecorations(String n) {
+ String key = n;
+ // 前缀可能叠加（如「麻烦帮我」），循环剥到不能再剥
+ boolean changed = true;
+ while (changed) {
+ changed = false;
+ for (String p : PREFIXES) {
+ if (key.length() > p.length() && key.startsWith(p)) {
+ key = key.substring(p.length());
+ changed = true;
+ break;
+ }
+ }
+ }
+ for (String suf : SUFFIXES) {
+ if (key.length() > suf.length() && key.endsWith(suf)) {
+ return key.substring(0, key.length() - suf.length());
+ }
+ }
+ return key;
+ }
+}
diff --git a/src/main/java/com/yunhai/agent/tool/FormField.java b/src/main/java/com/yunhai/agent/tool/FormField.java
index eb9f2c4..c322596 100644
--- a/src/main/java/com/yunhai/agent/tool/FormField.java
+++ b/src/main/java/com/yunhai/agent/tool/FormField.java
@@ -49,4 +49,24 @@ public class FormField {
/** 下拉选项 [{value,label}] */
private List 地址串里可能含 {@code {{字段名}}} 占位符（见 {@link #dependsOn}），
+ * 前端在依赖字段有值时做替换（值需 URL 编码）后才发起请求。
+ */
+ private com.yunhai.agent.model.BrowserToolRequest.BrowserCall optionCall;
+
+ /** 本字段选项依赖的先序字段名（如「学生」依赖「班级」）；依赖未填时前端应清空并提示先选 */
+ private List ★ 值类型用 {@code Object} 而不是 {@code String}：{@code type}/{@code continuousLeave}
+ * 这类字段在模块侧是**整型/枚举**，下发字符串 {@code "2"} 可能被 Jackson 判为非法枚举名，
+ * 必须按数字下发（{@code {"type":2}}）。需要字符串就直接传 String，不必再转换。
+ */
+ private Map 与 {@link #prepareBrowserCall} 的差别：**不做必填校验**，而是把依赖字段写成
+ * {@code {{字段名}}} 占位符（如 {@code /homeleave/api/leave/ClassStudents?classId={{classId}}}），
+ * 由前端在依赖字段有值后替换再发起请求 —— 这样「学生」这种依赖「班级」的下拉才拉得动。
+ *
+ * @param dict 只读字典工具（如 leave.classStudents）
+ * @param placeholders 需要留占位符的依赖字段名（可为空 = 无参字典）
+ * @return 调用描述；字典工具非法或模块未配置地址时返回 {@code null}
+ */
+ public com.yunhai.agent.model.BrowserToolRequest.BrowserCall prepareOptionCall(
+ ToolDef dict, java.util.Collection ★ 为什么必须显式声明：模块字典返回的是业务 VO（{@code TeachingClassVo{classId,className}}、
+ * {@code ClassStudentVo{stuId,stuName}}），字段名五花八门，靠「猜常见键名」不可靠。
+ * 显式声明后，前端在浏览器里取到原始数据也能**确定性地**映射成下拉项。
+ */
+ private String optionValueKey;
+
+ /** 选项显示名取自字典返回对象的哪个字段（如 {@code className} / {@code stuName}） */
+ private String optionLabelKey;
+
+ /**
+ * 本字段的选项依赖哪些其它字段（如「学生」下拉依赖先选好「班级」）。
+ *
+ * 作用有两个：① 生成表单时把依赖名带给前端，前端据此清空/重新拉取选项；
+ * ② 生成「浏览器代取选项」的地址时，把依赖字段位置留成占位符（{@code ?classId={{classId}}}）。
+ */
+ private List 例：{@code optionsKeys("classId","className")} 对应 {@code {classId,className}} 这种业务 VO。
+ */
+ public ToolParam optionsKeys(String valueKey, String labelKey) {
+ this.optionValueKey = valueKey;
+ this.optionLabelKey = labelKey;
+ return this;
+ }
+
+ /** 本字段的选项依赖的先序字段（用于联动下拉，如「学生」依赖「班级」） */
+ public ToolParam dependsOn(String... fieldNames) {
+ this.dependsOn = Arrays.asList(fieldNames);
+ return this;
+ }
+
/** 表单里显示的名字 */
public String labelOf() {
return StringUtils.isNotBlank(label) ? label : name;
@@ -225,6 +261,9 @@ public class ToolParam {
f.setOptions(optionList());
// 把「动态选项来源」一并下发：前端据此区分「本来就没有选项」和「字典没取到」
f.setOptionsFrom(optionsFrom);
+ f.setDependsOn(dependsOn);
+ f.setValueKey(optionValueKey);
+ f.setLabelKey(optionLabelKey);
// 选项是内置兜底（不是学校实时字典）时如实告知，前端可提示用户
f.setOptionsFallback(isUsingFallbackOptions());
return f;
diff --git a/src/main/java/com/yunhai/agent/tool/defs/LeaveTools.java b/src/main/java/com/yunhai/agent/tool/defs/LeaveTools.java
index 6e0f848..33f2941 100644
--- a/src/main/java/com/yunhai/agent/tool/defs/LeaveTools.java
+++ b/src/main/java/com/yunhai/agent/tool/defs/LeaveTools.java
@@ -8,9 +8,24 @@ import java.util.Arrays;
import java.util.List;
/**
- * 学生请假模块工具（后端 HomeSchLeave，前缀 /api/leave、/api/dict、/api/leavestats）。
+ * 学生请假模块工具（后端 HomeSchLeave / HomeLeave，前缀 /api/leave、/api/dict、/api/leavestats）。
*
- * 平台菜单 modId（HomeLeave routes.ts 契约）：2 请假申请 / 3 我的请假 / 4 请假审批 / 5 请假登记 / 6 请假统计 / 7 应用设置
+ * 平台菜单 modId（HomeLeave routes.ts 契约）：2 请假申请 / 3 我的请假 / 4 请假审批 /
+ * 5 请假登记 / 6 请假统计 / 7 应用设置
+ *
+ * 权威来源是字典接口 {@code GET /api/dict/LeaveTypeOptions}（学校可在「应用设置」里自定义），
- * 但该接口需登录会话、Agent 侧常取不到；没有兜底时表单会退化成让用户填「类型编号」的数字框。
+ * 该接口需登录会话、服务端取不到 —— 表单会带上下拉并交给浏览器用用户登录态取实时字典，
+ * 这份兜底保证「取不到时下拉里也还有标准项」，不会退化成让用户填「类型编号」的数字框。
*/
private static final String[] LEAVE_TYPE_VALUES = {"1", "2"};
@@ -36,19 +52,25 @@ public final class LeaveTools {
// ---------- 只读：辅助信息 ----------
list.add(ToolDef.of("leave.types", MODULE, "请假类型",
- "查询本校本模块可选的请假类型（病假/事假等）及其编号。用户说“请假”但没给类型时，先调它拿到 leaveType 编号。",
+ "查询本校本模块可选的请假类型（病假/事假等）及其编号。"
+ + "仅在用户明确问「有哪些请假类型」时使用；"
+ + "用户说要请假时**不要**先调它 —— 请假表单里的「请假类型」下拉会自动带出可选值。",
"GET", "/api/dict/LeaveTypeOptions")
.readAt("/apply")
.modId(2));
list.add(ToolDef.of("leave.myClasses", MODULE, "我的班级",
- "查询当前用户关联的班级（学生=所在班级；教师=任教班级；校管理员=全校班级）。登记请假、筛选前先调它拿 classId。",
+ "查询当前用户关联的班级（学生=所在班级；教师=任教班级；校管理员=全校班级）。"
+ + "仅在用户明确询问自己的班级时使用（如「我教哪几个班」）；"
+ + "填表/登记请假时**不要**先调它 —— 表单的「班级」下拉会自动取到这个列表。",
"GET", "/api/leave/MyClasses")
.readAt("/apply")
.modId(2));
list.add(ToolDef.of("leave.classStudents", MODULE, "班级学生名单",
- "查询某班级的学生名单（教师给学生登记请假时选人用）。",
+ "查询某班级的学生名单。"
+ + "仅在用户明确要看某个班的学生名单时使用；"
+ + "登记请假时**不要**先调它 —— 表单的「学生」下拉会在选好班级后自动带出名单。",
"GET", "/api/leave/ClassStudents")
.p(ToolParam.required("classId", "integer", "班级 id，来自 leave.myClasses"))
.readAt("/register")
@@ -57,7 +79,7 @@ public final class LeaveTools {
// ---------- 只读：查询 ----------
list.add(ToolDef.of("leave.myLeaves", MODULE, "查询请假记录",
"分页查询请假记录。学生查本人、教师查任教班级、管理员查全校（数据范围由后端按身份收敛）。"
- + "用户问“我请了几天假”“上次请假通过没”时用它。",
+ + "用户问「我请了几天假」「上次请假通过没」时用它。",
"GET", "/api/leave/List")
.p(ToolParam.optional("pageIndex", "integer", "页码，从 1 开始").dft("1"),
ToolParam.optional("pageSize", "integer", "每页条数，默认 10").dft("10"),
@@ -86,31 +108,61 @@ public final class LeaveTools {
.readAt("/stats")
.modId(6));
- // ---------- 写：提交 / 审批 / 销假 ----------
+ // ---------- 写：学生请假申请（type=2，待审核） ----------
list.add(ToolDef.of("leave.submit", MODULE, "提交请假申请",
"学生提交一条请假申请（提交后状态为待审核，等班主任审批）。"
+ + "教师给学生请假请改用「帮学生登记请假」，不要用本工具。"
+ "尽量确认：请假类型 leaveType、开始时间 startDate、结束时间 endDate、事由 remarks；"
+ "不确定的字段直接省略，系统会弹表单让用户补齐，不要用文字反复追问。",
"POST_JSON", "/api/leave/Save")
.p(ToolParam.required("leaveType", "integer", "请假类型：1 病假、2 事假及其他")
.label("请假类型")
.fallbackOptions(LEAVE_TYPE_VALUES, LEAVE_TYPE_LABELS)
- .optionsFrom("leave.types"),
+ .optionsFrom("leave.types").optionsKeys("k", "v"),
ToolParam.required("startDate", "string", "请假开始时间，" + DT_HINT)
.label("开始时间").eg("2026-10-12 08:00:00"),
ToolParam.required("endDate", "string", "请假结束时间，" + DT_HINT)
.label("结束时间").eg("2026-10-12 17:00:00"),
ToolParam.required("remarks", "string", "请假事由")
.label("请假事由").as("textarea").eg("发烧就医，需在家休息"),
- ToolParam.optional("classId", "integer", "班级 id；用户只有唯一班级时可不传")
- .label("班级"),
- ToolParam.optional("stuId", "integer", "学生 id（教师代学生登记时用）")
- .label("学生"))
- .fix("type", "2")
- .fix("continuousLeave", "0")
+ ToolParam.optional("classId", "integer", "班级 id；只有一个班级时可不传（后端会取默认班级）")
+ .label("班级")
+ .optionsFrom("leave.myClasses").optionsKeys("classId", "className"))
+ .fix("type", 2)
+ .fix("continuousLeave", 0)
.write("/my")
.modId(2));
+ // ---------- 写：教师代学生登记请假（type=1，免审通过） ----------
+ list.add(ToolDef.of("leave.register", MODULE, "帮学生登记请假",
+ "教师/管理员给学生登记请假（教师登记免审，直接生效）。"
+ + "需要先确定班级与学生，再填请假类型、起止时间与事由。"
+ + "学生自己请假请改用「提交请假申请」，不要用本工具。"
+ + "不确定的字段直接省略，系统会弹表单让用户补齐，不要用文字反复追问。",
+ "POST_JSON", "/api/leave/Save")
+ .p(ToolParam.required("classId", "integer", "学生所在班级 id（决定下面「学生」下拉的可选项）")
+ .label("班级")
+ .optionsFrom("leave.myClasses").optionsKeys("classId", "className"),
+ ToolParam.required("stuId", "integer", "学生 id（该班里要登记请假的那个学生）")
+ .label("学生")
+ .optionsFrom("leave.classStudents").optionsKeys("stuId", "stuName")
+ .dependsOn("classId"),
+ ToolParam.required("leaveType", "integer", "请假类型：1 病假、2 事假及其他")
+ .label("请假类型")
+ .fallbackOptions(LEAVE_TYPE_VALUES, LEAVE_TYPE_LABELS)
+ .optionsFrom("leave.types").optionsKeys("k", "v"),
+ ToolParam.required("startDate", "string", "请假开始时间，" + DT_HINT)
+ .label("开始时间").eg("2026-10-12 08:00:00"),
+ ToolParam.required("endDate", "string", "请假结束时间，" + DT_HINT)
+ .label("结束时间").eg("2026-10-12 17:00:00"),
+ ToolParam.required("remarks", "string", "请假事由")
+ .label("请假事由").as("textarea").eg("家中有事，需请假一天"))
+ .fix("type", 1)
+ .fix("continuousLeave", 0)
+ .write("/register")
+ .modId(5));
+
+ // ---------- 写：撤销 / 销假 / 审批 ----------
list.add(ToolDef.of("leave.withdraw", MODULE, "撤销请假",
"撤销一条请假申请。待审核可直接撤销；已通过则转为待撤销（需教师审批）。",
"POST_FORM", "/api/leave/Withdraw")
@@ -128,7 +180,7 @@ public final class LeaveTools {
.label("实际返校时间").eg("2026-10-12 08:00:00"),
ToolParam.optional("endDate", "string", "实际结束时间，" + DT_HINT)
.label("实际结束时间").eg("2026-10-12 17:00:00"))
- .fix("continuousLeave", "0")
+ .fix("continuousLeave", 0)
.write("/my")
.modId(3));
diff --git a/src/test/java/com/yunhai/agent/IntentDirectFormTest.java b/src/test/java/com/yunhai/agent/IntentDirectFormTest.java
new file mode 100644
index 0000000..e1d6f81
--- /dev/null
+++ b/src/test/java/com/yunhai/agent/IntentDirectFormTest.java
@@ -0,0 +1,193 @@
+package com.yunhai.agent;
+
+import com.alibaba.fastjson.JSONArray;
+import com.yunhai.agent.auth.AgentRole;
+import com.yunhai.agent.config.AgentSettings;
+import com.yunhai.agent.llm.LlmClient;
+import com.yunhai.agent.llm.dto.ChatMessage;
+import com.yunhai.agent.llm.dto.ChatResult;
+import com.yunhai.agent.model.ChatRequest;
+import com.yunhai.agent.model.ChatResponse;
+import com.yunhai.agent.service.AgentAuditService;
+import com.yunhai.agent.service.AgentOrchestrator;
+import com.yunhai.agent.service.EventSink;
+import com.yunhai.agent.service.IntentShortcut;
+import com.yunhai.agent.service.SessionStore;
+import com.yunhai.agent.tool.CallerContext;
+import com.yunhai.agent.tool.FormField;
+import com.yunhai.agent.tool.ToolExecutor;
+import com.yunhai.agent.tool.ToolRegistry;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.mockito.Mockito;
+import org.springframework.web.client.RestTemplate;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Set;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.Mockito.when;
+
+/**
+ * 「我要请假」在编排层的端到端断言：**同一句话、不同身份 → 不同表单**，且**不经过大模型**。
+ *
+ * 这是本次修复的核心承诺：用户说「我要请假」应当**直接**看到表单，
+ * 而不是先被模型拿去查字典、或自行编造时间直接提交、或反过来追问用户。
+ * 因此测试里的 {@link LlmClient} 被设成「一旦被调用就失败」，用来证明这条链路真的没走模型。
+ */
+class IntentDirectFormTest {
+
+ private AgentSettings settings;
+ private ToolRegistry registry;
+ private SessionStore sessionStore;
+ private AgentOrchestrator orchestrator;
+
+ /** 被调用即失败的模型客户端：证明「意图直达」路径压根不碰大模型 */
+ private static final LlmClient EXPLODING_LLM = new LlmClient() {
+ @Override
+ public ChatResult chat(List 背景：同一句「我要请假」在两个身份下要落到不同工具、不同表单 ——
+ * 学生 = 请假申请（type=2 待审核），教职工 = 请假登记（type=1 免审，须先选班级与学生）。
+ */
+class LeaveIntentFormTest {
+
+ private IntentShortcut shortcut;
+ private ToolRegistry registry;
+ private AgentSettings settings;
+ private ToolExecutor executor;
+
+ @BeforeEach
+ void setUp() {
+ shortcut = new IntentShortcut();
+ settings = new AgentSettings();
+ settings.getModules().put("homeleave", "http://base.yunhaixingtong.com/homeleave");
+ registry = new ToolRegistry(settings);
+ registry.init();
+ executor = new ToolExecutor(settings, new RestTemplate());
+ }
+
+ /* ==================== 意图直达规则 ==================== */
+
+ @Test
+ void bareLeaveIntentIsRecognized() {
+ for (String text : Arrays.asList(
+ "我要请假", "请假", "我想请假", "请个假", "麻烦帮我请假吧",
+ "申请请假", "提交请假申请", "请假申请", "我要请假了", "帮学生请假", "登记请假")) {
+ assertNotNull(shortcut.match(text), "「" + text + "」应被识别为裸请假意图");
+ }
+ }
+
+ @Test
+ void bareIntentResolvesToDifferentToolsPerIdentity() {
+ IntentShortcut.Intent it = shortcut.match("我要请假");
+ assertNotNull(it);
+ assertEquals("leave.submit", it.getStudentTool(), "学生应走「提交请假申请」");
+ assertEquals("leave.register", it.getStaffTool(), "教职工应走「帮学生登记请假」");
+ }
+
+ @Test
+ void detailedSentencesAreNotHijacked() {
+ // 带时间/事由的句子交给模型（模型能一次填全参数），不能被直接劫持成空表单
+ for (String text : Arrays.asList(
+ "我要请10月12日上午的病假，发烧就医",
+ "我请假那天作业怎么办",
+ "请假条怎么写",
+ "我要请假一天",
+ "请假流程是什么")) {
+ assertNull(shortcut.match(text), "「" + text + "」含细节，不应被直达规则命中");
+ }
+ }
+
+ @Test
+ void unrelatedOrEmptyInputIsIgnored() {
+ assertNull(shortcut.match(null));
+ assertNull(shortcut.match(""));
+ assertNull(shortcut.match(" "));
+ assertNull(shortcut.match("我要吃饭"));
+ assertNull(shortcut.match("我要请假我要请假我要请假我要请假"));
+ // 销假是另一个动作，不能当成请假
+ assertNull(shortcut.match("我要销假"));
+ }
+
+ /* ==================== 两条请假链路的工具定义 ==================== */
+
+ @Test
+ void studentFlowSubmitsApplicationWithType2() {
+ ToolDef submit = registry.get("leave.submit");
+ assertNotNull(submit);
+ assertFalse(submit.isReadOnly(), "请假申请是写操作");
+ assertEquals(2, ((Number) submit.getFixed().get("type")).intValue(),
+ "学生申请必须固定 type=2（待审核）");
+ assertEquals(0, ((Number) submit.getFixed().get("continuousLeave")).intValue());
+
+ // 学生表单的必填项：类型 / 起止时间 / 事由
+ assertTrue(requiredNames(submit).contains("leaveType"));
+ assertTrue(requiredNames(submit).contains("startDate"));
+ assertTrue(requiredNames(submit).contains("endDate"));
+ assertTrue(requiredNames(submit).contains("remarks"));
+ assertFalse(requiredNames(submit).contains("stuId"), "学生自查请假不该出现「学生」字段");
+ }
+
+ @Test
+ void teacherFlowRegistersLeaveWithType1AndStudentPicker() {
+ ToolDef register = registry.get("leave.register");
+ assertNotNull(register);
+ assertFalse(register.isReadOnly(), "请假登记是写操作");
+ assertEquals(1, ((Number) register.getFixed().get("type")).intValue(),
+ "教师登记必须固定 type=1（免审直接生效）");
+
+ // 教师必须选到人：班级 + 学生 都是必填，表单才会把这两项摆出来
+ assertTrue(requiredNames(register).contains("classId"), "教师登记必须选班级");
+ assertTrue(requiredNames(register).contains("stuId"), "教师登记必须选学生");
+
+ ToolParam stuId = param(register, "stuId");
+ assertEquals(Collections.singletonList("classId"), stuId.getDependsOn(),
+ "「学生」下拉依赖先选好「班级」");
+ assertEquals("stuId", stuId.getOptionValueKey());
+ assertEquals("stuName", stuId.getOptionLabelKey());
+ }
+
+ /* ==================== 下拉选项的「代取地址」 ==================== */
+
+ @Test
+ void optionCallKeepsPlaceholderForDependentField() {
+ ToolDef dict = registry.get("leave.classStudents");
+ BrowserToolRequest.BrowserCall call = executor.prepareOptionCall(dict, Collections.singletonList("classId"));
+ assertNotNull(call);
+ assertEquals("GET", call.getMethod());
+ assertEquals("/homeleave/api/leave/ClassStudents?classId={{classId}}", call.getPathAndQuery(),
+ "依赖字段必须留成占位符，由前端填入用户选的班级后自取名单");
+ }
+
+ @Test
+ void optionCallWithoutDependencyIsPlainUrl() {
+ BrowserToolRequest.BrowserCall call =
+ executor.prepareOptionCall(registry.get("leave.types"), null);
+ assertNotNull(call);
+ assertEquals("/homeleave/api/dict/LeaveTypeOptions", call.getPathAndQuery());
+ }
+
+ @Test
+ void optionCallIsNullWhenModuleAddressMissing() {
+ AgentSettings bare = new AgentSettings();
+ ToolExecutor noModule = new ToolExecutor(bare, new RestTemplate());
+ assertNull(noModule.prepareOptionCall(registry.get("leave.types"), null),
+ "模块没配地址时不该下发一个必然打不通的代取地址");
+ }
+
+ /* ==================== 辅助 ==================== */
+
+ private java.util.List为什么需要它
+ * 同一句「我要请假」，模型可能给出三种都不合预期的反应：
+ *
+ *
+ * 用户的预期是立刻看到表单。表单本来就能承载「补全 + 确认」，所以这里直接短路到表单，
+ * 既准（参数一定是用户填的）又快（省掉一轮模型往返）。
+ *
+ * 为什么用「显式短语表」而不是宽松正则
+ * 宽松匹配（如"含『请假』二字就直达"）会把「我请假那天作业怎么办」「10月12日病假发烧就医」
+ * 这类**带信息**的句子也劫持掉，反而更不准。这里只认「剥掉语气词后正好等于某个标准说法」的句子，
+ * 命中即直达、不命中就照常交给模型 —— 宁可少直达，不可错直达。
+ *
+ * 身份差异
+ * 同一个意图在两个身份下落到不同工具：学生 = 请假申请（{@code type=2} 待审核），
+ * 教职工 = 请假登记（{@code type=1} 免审通过，需先选班级与学生）。表单字段由工具定义推导，
+ * 因此「对应好表单」是自动成立的。
+ */
+@Component
+public class IntentShortcut {
+
+ /** 一个意图在两种身份下的落点与引导话术 */
+ public static class Intent {
+
+ /** 学生身份用的工具（内部点分名） */
+ private final String studentTool;
+
+ /** 教职工身份用的工具（null = 该身份下不直达） */
+ private final String staffTool;
+
+ /** 学生身份的表单引导语 */
+ private final String studentReply;
+
+ /** 教职工身份的表单引导语 */
+ private final String staffReply;
+
+ Intent(String studentTool, String staffTool, String studentReply, String staffReply) {
+ this.studentTool = studentTool;
+ this.staffTool = staffTool;
+ this.studentReply = studentReply;
+ this.staffReply = staffReply;
+ }
+
+ public String getStudentTool() {
+ return studentTool;
+ }
+
+ public String getStaffTool() {
+ return staffTool;
+ }
+
+ public String getStudentReply() {
+ return studentReply;
+ }
+
+ public String getStaffReply() {
+ return staffReply;
+ }
+ }
+
+ /** 请假意图：学生 → 请假申请；教职工 → 请假登记（帮学生请假） */
+ private static final Intent LEAVE = new Intent(
+ "leave.submit",
+ "leave.register",
+ "好的，下面是**请假申请**表单：选好请假类型、起止时间和事由，点「确认提交」我就直接提交，"
+ + "提交后由班主任审核。",
+ "好的，下面是**请假登记**表单：先选班级、再选学生，填好请假类型、起止时间和事由，"
+ + "点「确认提交」我直接登记（教师登记免审，立即生效）。");
+
+ /**
+ * 标准说法全集（已剥掉语气词与标点后的形态）。
+ * 新增意图时在这里加词 + 补一条 {@link #match(String)} 分支即可。
+ */
+ private static final Set★ 为什么「请假」要拆成两个工具
+ * 模块只有一个写接口 {@code POST /api/leave/Save}，靠 {@code type} 区分两种业务：
+ *
+ *
+ * 早先合成一个工具并写死 {@code type=2}，结果是：教师说「帮学生请假」会被提交成一条
+ * 待审核的学生申请（类型错），而且表单里根本没有「班级 / 学生」可选（那两个参数是可选，
+ * 不满足"缺参才出表单"的条件）。拆开之后：
+ *
+ *
*/
public final class LeaveTools {
@@ -22,7 +37,8 @@ public final class LeaveTools {
/**
* 请假类型内置兜底（与 HomeLeave 前端 {@code LEAVE_TYPE_OPTIONS}、后端字典种子一致）。
*