skill-auto-loader-hook-paperfly777 0.1.8 → 0.1.10

package/index.ts

@@ -65,6 +65,13 @@ function safeString(value: unknown): string {
   return typeof value === "string" ? value : "";
 }
 
+function shortText(text: string, max = 120): string {
+  if (!text) {
+    return "";
+  }
+  return text.length > max ? `${text.slice(0, max)}...` : text;
+}
+
 // 工具函数：把 "~/" 展开为用户 home 目录绝对路径
 function expandHome(inputPath: string): string {
   if (!inputPath) {
@@ -374,49 +381,71 @@ async function callDecisionModel(
 
   let text = "";
 
-  if (modelCfg.apiType === "openai-completions") {
-    const response = await fetch(`${baseUrl}/chat/completions`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        model: modelCfg.modelId,
-        temperature: 0,
-        max_tokens: 300,
-        response_format: { type: "json_object" },
-        messages: [
-          { role: "system", content: system },
-          { role: "user", content: user },
-        ],
-      }),
-    });
-    const data = (await response.json()) as any;
-    text = safeString(data?.choices?.[0]?.message?.content);
-  } else if (modelCfg.apiType === "openai-responses") {
-    const response = await fetch(`${baseUrl}/responses`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        model: modelCfg.modelId,
-        temperature: 0,
-        max_output_tokens: 300,
-        input: [
-          { role: "system", content: [{ type: "input_text", text: system }] },
-          { role: "user", content: [{ type: "input_text", text: user }] },
-        ],
-      }),
-    });
-    const data = (await response.json()) as any;
-    text =
-      safeString(data?.output_text) ||
-      safeString(data?.output?.[0]?.content?.[0]?.text) ||
-      safeString(data?.choices?.[0]?.message?.content);
-  } else {
+  try {
+    if (modelCfg.apiType === "openai-completions") {
+      const response = await fetch(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          model: modelCfg.modelId,
+          temperature: 0,
+          max_tokens: 300,
+          response_format: { type: "json_object" },
+          messages: [
+            { role: "system", content: system },
+            { role: "user", content: user },
+          ],
+        }),
+      });
+      const data = (await response.json()) as any;
+      text = safeString(data?.choices?.[0]?.message?.content);
+    } else if (modelCfg.apiType === "openai-responses") {
+      const response = await fetch(`${baseUrl}/responses`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          model: modelCfg.modelId,
+          temperature: 0,
+          max_output_tokens: 300,
+          input: [
+            { role: "system", content: [{ type: "input_text", text: system }] },
+            { role: "user", content: [{ type: "input_text", text: user }] },
+          ],
+        }),
+      });
+      const data = (await response.json()) as any;
+      text =
+        safeString(data?.output_text) ||
+        safeString(data?.output?.[0]?.content?.[0]?.text) ||
+        safeString(data?.choices?.[0]?.message?.content);
+    } else {
+      return null;
+    }
+  } catch {
     return null;
   }
 
   return parseDecisionJson(text, candidateSkills);
 }
 
+function fallbackDecisionFromRules(candidateSkills: SkillMeta[], matchedRules: RoutingRule[]): ModelDecision | null {
+  const preferred = new Set<string>();
+  for (const rule of matchedRules) {
+    (rule.preferSkills || []).forEach((name) => preferred.add(name));
+  }
+
+  const selected = candidateSkills.filter((skill) => preferred.has(skill.name)).slice(0, 3);
+  if (selected.length === 0) {
+    return null;
+  }
+
+  return {
+    use_skill: true,
+    selected_skills: selected.map((skill) => skill.name),
+    reason: "模型路由未返回有效结果，已回退到规则 preferSkills。",
+  };
+}
+
 // 解析 SKILL.md 头部 frontmatter（name/description）
 function parseYamlLikeFrontmatter(raw: string): { name: string; description: string } {
   const result = { name: "", description: "" };
@@ -661,19 +690,25 @@ export default definePluginEntry({
         // 步骤 1：读取插件配置与独立路由配置
         const cfg = normalizePluginConfig(api);
         if (!cfg.enabled) {
+          api.logger?.debug?.("skill-auto-loader-hook: plugin disabled, skip");
           return undefined;
         }
 
         const routerCfg = readRouterConfig(cfg.routerConfigPath!, __dirname);
         if (routerCfg.enabled === false) {
+          api.logger?.debug?.("skill-auto-loader-hook: router config disabled, skip");
           return undefined;
         }
 
         // 步骤 2：提取本轮用户输入
         const userText = extractLatestUserText(event);
         if (!userText) {
+          api.logger?.debug?.("skill-auto-loader-hook: no user text extracted, skip");
           return undefined;
         }
+        if (routerCfg.logRouting) {
+          api.logger?.info?.(`skill-auto-loader-hook: extracted userText="${shortText(userText)}"`);
+        }
 
         // 步骤 3：扫描并收集可用 skill
         const scanDirs =
@@ -684,19 +719,52 @@ export default definePluginEntry({
         const allSkills = scanInstalledSkills(scanDirs);
         const matchedRules = (routerCfg.rules || []).filter((rule) => rule.enabled !== false && matchesRule(userText, rule));
         const defaultBehavior = routerCfg.defaultBehavior || "no-op";
+        if (routerCfg.logRouting) {
+          const ruleIds = matchedRules.map((rule) => rule.id).join(",") || "none";
+          api.logger?.info?.(`skill-auto-loader-hook: matchedRules=${ruleIds} defaultBehavior=${defaultBehavior}`);
+        }
         // 步骤 4：默认 no-op 时，未命中规则就不注入（避免每轮追加）
         if (matchedRules.length === 0 && defaultBehavior === "no-op") {
+          api.logger?.debug?.("skill-auto-loader-hook: no rules matched and defaultBehavior=no-op, skip");
           return undefined;
         }
         // 步骤 5：先根据规则收缩候选 skill 范围
         const candidateSkills = applyRuleFiltering(allSkills, routerCfg, matchedRules);
+        if (routerCfg.logRouting) {
+          api.logger?.info?.(
+            `skill-auto-loader-hook: candidateSkills=${candidateSkills.map((skill) => skill.name).join(",") || "none"}`,
+          );
+        }
         if (candidateSkills.length === 0) {
+          api.logger?.debug?.("skill-auto-loader-hook: no candidate skills after filtering, skip");
           return undefined;
         }
 
         // 步骤 6：主动调用一次默认大模型，让模型在候选 skill 中做最终路由判断
-        const decision = await callDecisionModel(cfg.openclawConfigPath!, userText, candidateSkills, matchedRules, routerCfg);
+        if (routerCfg.logRouting) {
+          api.logger?.info?.("skill-auto-loader-hook: calling decision model");
+        }
+        let decision = await callDecisionModel(cfg.openclawConfigPath!, userText, candidateSkills, matchedRules, routerCfg);
+        if (routerCfg.logRouting) {
+          api.logger?.info?.(
+            `skill-auto-loader-hook: decisionModelResult=${decision ? JSON.stringify(decision) : "null"}`,
+          );
+        }
+        if ((!decision || !decision.use_skill || decision.selected_skills.length === 0) && matchedRules.length > 0) {
+          if (routerCfg.logRouting) {
+            api.logger?.info?.("skill-auto-loader-hook: model decision empty, fallback to preferSkills");
+          }
+          decision = fallbackDecisionFromRules(candidateSkills, matchedRules);
+          if (routerCfg.logRouting) {
+            api.logger?.info?.(
+              `skill-auto-loader-hook: fallbackDecision=${decision ? JSON.stringify(decision) : "null"}`,
+            );
+          }
+        }
         if (!decision || !decision.use_skill || decision.selected_skills.length === 0) {
+          if (routerCfg.logRouting) {
+            api.logger?.info?.("skill-auto-loader-hook: no valid decision returned by model and no fallback applied");
+          }
           return undefined;
         }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-auto-loader-hook-paperfly777",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "OpenClaw hook plugin that routes each user message to the most relevant installed skill.",
   "license": "MIT",
   "type": "module",