@ynhcj/xiaoyi-channel 0.0.75-beta → 0.0.75-next

package/dist/src/self-evolution-handler.js

@@ -0,0 +1,140 @@
+import { readFileSync, writeFileSync } from "fs";
+import { v4 as uuidv4 } from "uuid";
+const XIAOYIRUNTIME_PATH = "/home/sandbox/.openclaw/.xiaoyiruntime";
+export function handleSelfEvolutionEvent(context, runtime) {
+    const log = runtime?.log ?? console.log;
+    const error = runtime?.error ?? console.error;
+    try {
+        const state = context.event?.payload?.selfEvolutionState;
+        if (typeof state !== "string") {
+            error("[SELF_EVOLUTION] invalid payload: missing selfEvolutionState");
+            return;
+        }
+        log(`[SELF_EVOLUTION] received state: ${state}`);
+        let content;
+        try {
+            content = readFileSync(XIAOYIRUNTIME_PATH, "utf-8");
+        }
+        catch {
+            // File doesn't exist yet — create it
+            log(`[SELF_EVOLUTION] ${XIAOYIRUNTIME_PATH} not found, creating new file`);
+            writeFileSync(XIAOYIRUNTIME_PATH, `selfEvolutionState=${state}\n`, "utf-8");
+            log(`[SELF_EVOLUTION] wrote selfEvolutionState=${state}`);
+            return;
+        }
+        const lines = content.split("\n");
+        const key = "selfEvolutionState";
+        let found = false;
+        const updated = lines.map((line) => {
+            if (line.startsWith(`${key}=`)) {
+                found = true;
+                return `${key}=${state}`;
+            }
+            return line;
+        });
+        if (!found) {
+            // Ensure trailing newline before appending
+            const trimmed = content.trimEnd();
+            writeFileSync(XIAOYIRUNTIME_PATH, `${trimmed}\n${key}=${state}\n`, "utf-8");
+        }
+        else {
+            writeFileSync(XIAOYIRUNTIME_PATH, updated.join("\n"), "utf-8");
+        }
+        log(`[SELF_EVOLUTION] updated selfEvolutionState=${state} in ${XIAOYIRUNTIME_PATH}`);
+    }
+    catch (err) {
+        error("[SELF_EVOLUTION] failed to handle event:", err);
+    }
+}
+/**
+ * 读取 .xiaoyiruntime 中的 selfEvolutionState 并直接通过 wsManager 下发指令回复设备
+ * 参考trigger实现：直接使用当前已连接的 wsManager 发送消息，避免 getXYWebSocketManager 返回未连接实例
+ */
+export async function handleSelfEvolutionStateGetEvent(context, cfg, runtime, wsManager) {
+    const log = runtime?.log ?? console.log;
+    const error = runtime?.error ?? console.error;
+    try {
+        const { sessionId, taskId } = context;
+        const messageId = context.messageId ?? uuidv4();
+        // 读取 selfEvolutionState
+        let state = "false";
+        try {
+            const content = readFileSync(XIAOYIRUNTIME_PATH, "utf-8");
+            for (const line of content.split("\n")) {
+                const trimmed = line.trim();
+                if (trimmed.startsWith("selfEvolutionState=")) {
+                    state = trimmed.slice("selfEvolutionState=".length).trim();
+                    break;
+                }
+            }
+        }
+        catch {
+            // 文件不存在，使用默认值 false
+        }
+        log(`[SELF_EVOLUTION_GET] read selfEvolutionState=${state}, sending command back`);
+        const command = {
+            header: {
+                namespace: "Common",
+                name: "Action",
+            },
+            payload: {
+                cardParam: {},
+                executeParam: {
+                    executeMode: "background",
+                    intentName: "ClawSelfEvolutionStateGet",
+                    bundleName: "com.huawei.hmos.vassistant",
+                    needUnlock: true,
+                    actionResponse: true,
+                    timeOut: 5,
+                    intentParam: {
+                        selfEvolutionState: state,
+                    },
+                    permissionId: [],
+                    achieveType: "INTENT",
+                },
+                responses: [{
+                        resultCode: "",
+                        displayText: "",
+                        ttsText: "",
+                    }],
+                needUploadResult: true,
+                noHalfPage: false,
+                pageControlRelated: false,
+            },
+        };
+        // 构造 artifact update 消息，直接通过当前 wsManager 发送
+        const jsonRpcResponse = {
+            jsonrpc: "2.0",
+            id: messageId,
+            result: {
+                taskId,
+                kind: "artifact-update",
+                append: false,
+                lastChunk: true,
+                final: false,
+                artifact: {
+                    artifactId: uuidv4(),
+                    parts: [{
+                            kind: "data",
+                            data: {
+                                commands: [command],
+                            },
+                        }],
+                },
+            },
+        };
+        const outboundMessage = {
+            msgType: "agent_response",
+            agentId: cfg.agentId,
+            sessionId,
+            taskId,
+            msgDetail: JSON.stringify(jsonRpcResponse),
+        };
+        log(`[A2A_COMMAND] 📤 Sending A2A command: taskId: ${taskId}`);
+        await wsManager.sendMessage(sessionId, outboundMessage);
+        log(`[SELF_EVOLUTION_GET] command sent successfully`);
+    }
+    catch (err) {
+        error("[SELF_EVOLUTION_GET] failed to handle event:", err);
+    }
+}

package/dist/src/self-evolution-keyword.d.ts

@@ -0,0 +1,9 @@
+export declare const SELF_EVOLUTION_KEYWORD_NUDGE_MESSAGE = "[\u7CFB\u7EDF\u6D88\u606F\uFF0C\u975E\u7528\u6237\u53D1\u8A00\uFF0C\u65E0\u9700\u4E3B\u52A8\u544A\u77E5\u7528\u6237] \u5F53\u524D\u7528\u6237\u8BF7\u6C42\u4E2D\u53EF\u80FD\u5305\u542B\u5E0C\u671B\u6C89\u6DC0\u7ECF\u9A8C\u3001\u957F\u671F\u8BB0\u5FC6\u3001\u907F\u514D\u91CD\u590D\u8E29\u5751\u3001\u7EA0\u9519\u7B49\u610F\u56FE\u3002\u5982\u679C\u4F60\u4ECE\u5F53\u524D\u4EFB\u52A1\u8FC7\u7A0B\u4E2D\u8BC6\u522B\u51FA\u53EF\u957F\u671F\u8BB0\u5FC6\u3001\u53EF\u590D\u7528\u7684\u5904\u7406\u89C4\u5219\u6216\u6392\u9519\u7ECF\u9A8C\u7B49\uFF0C\u53EF\u4EE5\u5728\u5B8C\u6210\u5F53\u524D\u4E3B\u8981\u4EFB\u52A1\u540E\uFF0C\u6B63\u5F0F\u56DE\u590D\u7528\u6237\u524D\uFF0C\u9605\u8BFBxiaoyi-self-evolution\u6280\u80FD\u4E86\u89E3\u81EA\u8FDB\u5316\u89C4\u5219\u3002\u6CE8\u610F\uFF0C\u4E0D\u8981\u6253\u65AD\u5F53\u524D\u4E3B\u4EFB\u52A1\uFF0C\u4EE5\u5B8C\u6210\u4EFB\u52A1\u4E3A\u6700\u9AD8\u4F18\u5148\u7EA7\u3002";
+export declare const SELF_EVOLUTION_KEYWORD_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+export declare const SELF_EVOLUTION_MECHANISM_DISCUSSION_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+export declare function isSelfEvolutionMechanismDiscussion(text: string): boolean;
+export declare function shouldNudgeForSelfEvolutionKeyword(text: string): boolean;
+export declare function appendSelfEvolutionKeywordNudge(text: string): {
+    text: string;
+    appended: boolean;
+};

package/dist/src/self-evolution-keyword.js

@@ -0,0 +1,147 @@
+export const SELF_EVOLUTION_KEYWORD_NUDGE_MESSAGE = "[系统消息，非用户发言，无需主动告知用户] 当前用户请求中可能包含希望沉淀经验、长期记忆、避免重复踩坑、纠错等意图。如果你从当前任务过程中识别出可长期记忆、可复用的处理规则或排错经验等，可以在完成当前主要任务后，正式回复用户前，阅读xiaoyi-self-evolution技能了解自进化规则。注意，不要打断当前主任务，以完成任务为最高优先级。";
+export const SELF_EVOLUTION_KEYWORD_PATTERNS = [
+    /进化/u,
+    /沉淀/u,
+    /记住/u,
+    /固化/u,
+    /下次都/u,
+    /记下来/u,
+    /记一个/u,
+    /记一下/u,
+    /给我记住/u,
+    /给我记下来/u,
+    /把(?:这个|这条|这点|这个要求|这个偏好)(?:记住|记下来|记录下来)/u,
+    /以后都/u,
+    /以后必须/u,
+    /以后统一/u,
+    /后面都/u,
+    /后续都/u,
+    /以后默认/u,
+    /下次默认/u,
+    /之后默认/u,
+    /后续默认/u,
+    /长期记住/u,
+    /永久记住/u,
+    /永远记住/u,
+    /记住我的(?:偏好|习惯|要求|规范|规则)/u,
+    /记住我(?:喜欢|不喜欢|习惯|偏好|要求|希望|倾向于)/u,
+    /记住(?:我|用户)(?:以后|之后|后续)?(?:喜欢|不喜欢|习惯|偏好|要求|希望|倾向于)/u,
+    /(?:我的|用户的)(?:偏好|习惯|要求|规范|规则)(?:要)?(?:记住|记录|保留|沿用)/u,
+    /以后按(?:我的)?(?:偏好|习惯|要求|规范|规则)/u,
+    /(?:以后|下次|后续|之后)(?:都|统一|默认)?(?:按|照|遵循|沿用)(?:我的|用户的)(?:偏好|习惯|要求|规范|规则)/u,
+    /形成规范/u,
+    /固化下来/u,
+    /固定下来/u,
+    /固定成(?:规范|规则|流程|模板|标准)/u,
+    /列为(?:规范|规则|流程|标准|最佳实践)/u,
+    /作为(?:规范|规则|流程|标准|最佳实践)(?:保存|沉淀|记录|保留)/u,
+    /记成规则/u,
+    /写成规则/u,
+    /定成规则/u,
+    /定为(?:规则|规范|流程|标准|模板)/u,
+    /纳入经验/u,
+    /写入经验/u,
+    /写进(?:经验|规则|规范|流程|最佳实践)/u,
+    /记录到(?:经验|规则|规范|流程|最佳实践)/u,
+    /加入(?:经验|规则|规范|流程|最佳实践)/u,
+    /保存成(?:经验|规则|规范|流程|模板|最佳实践)/u,
+    /沉淀成(?:经验|规则|规范|流程)/u,
+    /总结成(?:经验|规则|规范|流程|步骤|模板|最佳实践)/u,
+    /归纳成(?:经验|规则|规范|流程|模板|最佳实践)/u,
+    /提炼成(?:经验|规则|规范|流程|模板|最佳实践)/u,
+    /以后都按这个来/u,
+    /下次都这样处理/u,
+    /以后统一这样/u,
+    /后面都这样/u,
+    /以后照这个来/u,
+    /下次照这个来/u,
+    /后续照这个来/u,
+    /之后照这个来/u,
+    /以后就这么办/u,
+    /下次就这么办/u,
+    /以后就这样办/u,
+    /下次就这样办/u,
+    /以后沿用/u,
+    /下次沿用/u,
+    /后续沿用/u,
+    /后续按这个(?:规范|流程|模板|方案)/u,
+    /(?:以后|下次|后续|之后)(?:就)?(?:按|照|沿用|复用)(?:这个|这种|上述|前面这个|刚才这个)(?:规范|流程|模板|方案|格式|标准|做法|套路|模式)/u,
+    /(?:以后|下次|后续|之后)(?:回复|回答|输出|生成|整理|总结)(?:时)?(?:都|就|统一|默认|必须|要)(?:按|照|遵循|沿用|使用)(?:这个|这种|上述|当前)?(?:格式|模板|风格|口径|结构|标准)/u,
+    /(?:这个|这种|上述|当前)(?:格式|模板|风格|口径|结构|标准)(?:以后|下次|后续|之后)(?:都|就|统一|默认|复用|沿用)/u,
+    /以后(?:遇到|碰到)这种情况/u,
+    /类似(?:问题|情况|场景)都这样/u,
+    /类似(?:问题|情况|场景)都这样处理/u,
+    /类似(?:问题|情况|场景)(?:以后|下次|后续|之后)(?:都|就|统一|默认)/u,
+    /(?:同类|类似|这种|这类)(?:需求|任务|问题|情况|场景)(?:以后|下次|后续|之后)(?:都|就|统一|默认|按这个|照这个)/u,
+    /(?:这类|这种|类似|同类)(?:需求|任务|问题|场景)(?:处理|解决|回答|回复)(?:方式|流程|方法)(?:记住|固定|沉淀|沿用)/u,
+    /避免(?:再次|以后|下次)/u,
+    /避免再(?:犯错|踩坑|出错)/u,
+    /防止以后再犯/u,
+    /防止(?:以后|下次|后续|之后)(?:再)?(?:犯错|出错|踩坑|漏掉|遗漏|忘记)/u,
+    /别再(?:出错|犯错|踩坑|漏掉|忘记)/u,
+    /不要再(?:出错|犯错|踩坑|漏掉|忘记)/u,
+    /别再(?:这样|这么)(?:做|处理|回答|回复|输出|写|改)/u,
+    /不要再(?:这样|这么)(?:做|处理|回答|回复|输出|写|改)/u,
+    /以后别(?:这样|这么)(?:做|处理|回答|回复|输出|写|改)/u,
+    /以后不要(?:这样|这么)(?:做|处理|回答|回复|输出|写|改)/u,
+    /下次别再/u,
+    /以后不要再/u,
+    /以后别再/u,
+    /(?:下次|以后|后续|之后)(?:不要|别|不能|不许|禁止)(?:再)?(?:这样|这么)?(?:出错|犯错|踩坑|漏掉|遗漏|忘记)/u,
+    /(?:下次|以后|后续|之后)(?:不要|别|不能|不许|禁止)(?:再)?(?:省略|跳过|漏掉|遗漏)(?:检查|确认|验证|测试|构建|说明|引用|来源|步骤)/u,
+    /(?:下次|以后|后续|之后)(?:记得|一定要|务必|必须)(?:先|先去|优先|默认)?(?:检查|确认|使用|采用|调用|遵循|按照|参考|避免|不要|别|记住|保留|验证|测试|构建|运行)/u,
+    /(?:下次|以后|后续|之后)(?:先|优先|默认)(?:检查|确认|查找|搜索|读取|运行|验证|测试|构建|调用|使用)/u,
+    /这个坑(?:要)?记住/u,
+    /这(?:个|次)?(?:坑|错误|问题|教训)(?:别忘|不要忘|不能忘|得记住)/u,
+    /(?:踩坑|翻车|犯错|出错)(?:点|原因|教训)?(?:记住|记下来|沉淀|复盘)/u,
+    /吸取这次(?:教训|经验)/u,
+    /把(?:这个|这次|上述|刚才的)?(?:坑|问题|错误|教训|经验|做法|流程|规范|要求|偏好|格式|模板|标准)(?:记住|记下来|沉淀下来|固化下来|保存下来|记录下来)/u,
+    /(?:以后|下次|后续|之后)(?:遇到|碰到)(?:同类|类似|这种|这类)(?:需求|任务|问题|情况|场景)(?:时)?(?:都|就|统一|默认|应该|要|必须)/u,
+    /(?:以后|下次|后续|之后)(?:做|处理|执行)(?:同类|类似|这种|这类)(?:需求|任务|问题|情况|场景)(?:时)?(?:都|就|统一|默认|应该|要|必须)/u,
+    /(?:以后|下次|后续|之后)(?:都|统一|默认|应该|要)(?:按这个|这样|这么)(?:来|做|处理|执行)/u,
+    /(?:以后|下次|后续|之后)(?:都|统一|默认|应该|要|必须)(?:先|优先|总是|固定)?(?:使用|采用|走|遵循|参考|套用|复用|沿用)(?:这个|这种|上述|当前)?(?:方法|流程|规范|规则|模板|标准|方案|做法|模式|套路)/u,
+    /(?:以后|下次|后续|之后)(?:遇到|碰到)(?:类似)?(?:问题|情况|场景)(?:时)?(?:都|就)(?:按这个|这样|这么)(?:来|做|处理|执行)/u,
+    /(?:别再|不要再|避免)(?:犯错|出错|踩坑|漏掉|遗漏|忘记)/u,
+    /(?:总结|归纳|提炼|沉淀|复盘)(?:一个|一下|下)?(?:这次|这个|上述|刚才的)?(?:经验|教训|问题|规则|规范|流程|模板|标准|最佳实践)?/u,
+    /(?:把)?这次(?:经验|教训|规则|做法|流程|格式|模板|标准)(?:记住|记下来|沉淀下来|固化下来|记录下来)/u,
+    /(?:形成|整理成|沉淀成|提炼成)(?:一套|一个|一份)?(?:规则|规范|流程|步骤|模板|标准|最佳实践|操作手册|检查清单|checklist)/u,
+    /(?:作为|当作|用作)(?:以后|下次|后续|之后)(?:的)?(?:参考|模板|范例|案例|标准|最佳实践|默认做法)/u,
+    /(?:这次|这个|上述|刚才的)(?:处理方式|做法|流程|方案|模板|格式|标准|口径|风格)(?:以后|下次|后续|之后)(?:复用|沿用|照着来|照这个来|继续用)/u,
+    /(?:以后|下次|后续|之后)(?:工具|skill|技能|命令|脚本|流程)(?:选择|调用|使用)(?:都|就|统一|默认|优先|必须|要)/u,
+    /(?:以后|下次|后续|之后)(?:优先|默认|固定)(?:用|使用|调用)(?:这个|这种|上述|当前)?(?:工具|skill|技能|命令|脚本|流程|方法)/u,
+    /(?:这个|这种|上述|当前)(?:工具|skill|技能|命令|脚本|流程|方法)(?:以后|下次|后续|之后)(?:优先|默认|固定|继续)(?:用|使用|调用)/u,
+];
+export const SELF_EVOLUTION_MECHANISM_DISCUSSION_PATTERNS = [
+    /自进化(?:机制|功能|流程|原理|实现|设计|架构|链路|优化点|改进点)/u,
+    /(?:分析|讨论|了解|解释|看看|研究|检查|梳理|优化|改进|评估)(?:.{0,12})自进化/u,
+    /自进化(?:.{0,12})(?:怎么|如何|是否|能否|有没有|为什么)/u,
+    /自进化(?:是啥|是什么|的)/u,
+    /什么是自进化/u,
+    /啥是自进化/u,
+    /xiaoyi-self-evolution(?:-skill)?(?:.{0,12})(?:机制|功能|流程|原理|实现|设计|优化点|改进点)/iu,
+];
+export function isSelfEvolutionMechanismDiscussion(text) {
+    return SELF_EVOLUTION_MECHANISM_DISCUSSION_PATTERNS.some((pattern) => pattern.test(text));
+}
+export function shouldNudgeForSelfEvolutionKeyword(text) {
+    if (!text) {
+        return false;
+    }
+    if (isSelfEvolutionMechanismDiscussion(text)) {
+        return false;
+    }
+    return SELF_EVOLUTION_KEYWORD_PATTERNS.some((pattern) => pattern.test(text));
+}
+export function appendSelfEvolutionKeywordNudge(text) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        return { text, appended: false };
+    }
+    if (trimmed.includes(SELF_EVOLUTION_KEYWORD_NUDGE_MESSAGE)) {
+        return { text, appended: false };
+    }
+    return {
+        text: `${trimmed}\n\n${SELF_EVOLUTION_KEYWORD_NUDGE_MESSAGE}`,
+        appended: true,
+    };
+}

package/dist/src/self-evolution-tool-result-nudge.d.ts

@@ -0,0 +1,3 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare const SELF_EVOLUTION_TOOL_COUNT_NUDGE_MESSAGE = "[\u7CFB\u7EDF\u6D88\u606F] \u5F53\u524D\u4EFB\u52A1\u5DF2\u7ECF\u8C03\u7528\u4E86\u8F83\u591A\u6B21\u6570\u7684\u5DE5\u5177\u3002\u8BF7\u5728\u5B8C\u6210\u4EFB\u52A1\u540E\uFF0C\u5224\u65AD\u662F\u5426\u6709\u7A33\u5B9A\u3001\u901A\u7528\u3001\u53EF\u590D\u7528\u7684\u6D41\u7A0B\u3001\u6392\u9519\u7ECF\u9A8C\u6216\u8E29\u5751\u70B9\uFF0C\u5E76\u8003\u8651\u9605\u8BFB xiaoyi-self-evolution skill \u542F\u52A8\u81EA\u8FDB\u5316\u3002";
+export declare function registerSelfEvolutionToolResultNudge(api: OpenClawPluginApi): void;

package/dist/src/self-evolution-tool-result-nudge.js

@@ -0,0 +1,96 @@
+import { selfEvolutionManager } from "./utils/self-evolution-manager.js";
+import { toolCallNudgeManager, TOOL_CALL_NUDGE_THRESHOLD } from "./utils/tool-call-nudge-manager.js";
+export const SELF_EVOLUTION_TOOL_COUNT_NUDGE_MESSAGE = "[系统消息] 当前任务已经调用了较多次数的工具。请在完成任务后，判断是否有稳定、通用、可复用的流程、排错经验或踩坑点，并考虑阅读 xiaoyi-self-evolution skill 启动自进化。";
+function shouldCountToolCall(toolName) {
+    if (toolName === "save_self_evolution_skill") {
+        return false;
+    }
+    if (toolName === "call_device_tool") {
+        return false;
+    }
+    if (toolName.endsWith("_tool_schema")) {
+        return false;
+    }
+    return true;
+}
+function appendNudgeToToolResultPayload(message, nudge) {
+    const msg = message;
+    const nudgeTrim = nudge.trim();
+    if (!nudgeTrim) {
+        return message;
+    }
+    const content = msg.content;
+    if (typeof content === "string") {
+        if (content.includes(nudgeTrim)) {
+            return message;
+        }
+        return { ...msg, content: `${content}\n\n${nudge}` };
+    }
+    if (!Array.isArray(content)) {
+        return {
+            ...msg,
+            content: [{ type: "text", text: nudge }],
+        };
+    }
+    const newContent = content.map((block) => block && typeof block === "object" ? { ...block } : block);
+    for (let i = newContent.length - 1; i >= 0; i--) {
+        const block = newContent[i];
+        if (!block || typeof block !== "object") {
+            continue;
+        }
+        const rec = block;
+        if (rec.type !== "text") {
+            continue;
+        }
+        const text = rec.text;
+        if (typeof text !== "string") {
+            continue;
+        }
+        if (text.includes(nudgeTrim)) {
+            return message;
+        }
+        newContent[i] = { ...rec, type: "text", text: `${text}\n\n${nudge}` };
+        return { ...msg, content: newContent };
+    }
+    newContent.push({ type: "text", text: nudge });
+    return { ...msg, content: newContent };
+}
+export function registerSelfEvolutionToolResultNudge(api) {
+    api.on("tool_result_persist", (event, ctx) => {
+        const message = event.message;
+        if (message.role !== "toolResult") {
+            return undefined;
+        }
+        if (event.isSynthetic) {
+            return undefined;
+        }
+        const sessionKey = ctx?.sessionKey;
+        if (!sessionKey || sessionKey.includes(":subagent:")) {
+            return undefined;
+        }
+        if (!selfEvolutionManager.isEnabledSync()) {
+            return undefined;
+        }
+        const toolName = (event.toolName ?? message.toolName ?? "").trim();
+        if (!toolName || !shouldCountToolCall(toolName)) {
+            return undefined;
+        }
+        let shouldNudge;
+        let count = 0;
+        try {
+            const result = toolCallNudgeManager.recordToolCall(sessionKey);
+            shouldNudge = result.shouldNudge;
+            count = result.count;
+        }
+        catch {
+            return undefined;
+        }
+        api.logger.debug?.(`[SELF_EVOLUTION] tool_result_persist: tool=${toolName}, count=${count}, threshold=${TOOL_CALL_NUDGE_THRESHOLD}, sessionKey=${sessionKey}, shouldNudge=${shouldNudge}`);
+        if (!shouldNudge) {
+            return undefined;
+        }
+        api.logger.info?.(`[SELF_EVOLUTION] Tool call threshold reached, appending nudge to tool result: tool=${toolName}, count=${count}, sessionKey=${sessionKey}`);
+        const next = appendNudgeToToolResultPayload(event.message, SELF_EVOLUTION_TOOL_COUNT_NUDGE_MESSAGE);
+        return { message: next };
+    });
+}

package/dist/src/skill-retriever/config.d.ts

@@ -0,0 +1,4 @@
+import type { ToolRetrieverConfig } from "./types.js";
+export interface NormalizedConfig extends ToolRetrieverConfig {
+}
+export declare function normalizeToolRetrieverConfig(raw?: unknown): NormalizedConfig;

package/dist/src/skill-retriever/config.js

@@ -0,0 +1,23 @@
+const DEFAULT_CONFIG = {
+    enabled: true,
+    maxTools: 2,
+    includeUninstalledOnly: true,
+    envFilePath: "~/.openclaw/.xiaoyienv",
+    timeoutMs: 1000,
+};
+export function normalizeToolRetrieverConfig(raw) {
+    if (!raw || typeof raw !== "object") {
+        return { ...DEFAULT_CONFIG };
+    }
+    const cfg = raw;
+    return {
+        enabled: cfg.enabled ?? DEFAULT_CONFIG.enabled,
+        maxTools: Math.min(20, Math.max(1, cfg.maxTools ?? DEFAULT_CONFIG.maxTools)),
+        includeUninstalledOnly: cfg.includeUninstalledOnly ?? DEFAULT_CONFIG.includeUninstalledOnly,
+        envFilePath: cfg.envFilePath ?? DEFAULT_CONFIG.envFilePath,
+        serviceUrl: cfg.serviceUrl,
+        apiKey: cfg.apiKey,
+        uid: cfg.uid,
+        timeoutMs: cfg.timeoutMs ?? DEFAULT_CONFIG.timeoutMs,
+    };
+}

package/dist/src/skill-retriever/hooks.d.ts

@@ -0,0 +1,22 @@
+interface PluginHookBeforePromptBuildEvent {
+    prompt: string;
+    messages: unknown[];
+}
+interface PluginHookBeforePromptBuildResult {
+    systemPrompt?: string;
+    prependContext?: string;
+    prependSystemContext?: string;
+    appendSystemContext?: string;
+}
+interface PluginHookAgentContext {
+    agentId?: string;
+    sessionKey?: string;
+    sessionId?: string;
+    workspaceDir?: string;
+    messageProvider?: string;
+    trigger?: string;
+    channelId?: string;
+}
+import type { ToolRetrieverConfig } from "./types.js";
+export declare function createBeforePromptBuildHandler(config: ToolRetrieverConfig): (event: PluginHookBeforePromptBuildEvent, ctx?: PluginHookAgentContext) => Promise<PluginHookBeforePromptBuildResult | undefined>;
+export {};

package/dist/src/skill-retriever/hooks.js

@@ -0,0 +1,82 @@
+import { searchTools, formatToolsForContext, extractUserQuery } from "./tool-search.js";
+const TOOL_RETRIEVER_HEADER = `[系统消息，非用户发言]
+
+`;
+const TOOL_RETRIEVER_FOOTER = `
+以上是检索到的、与当前用户请求相关但用户尚未安装的skill，请按照TOOLS.md中find-skills中的[隐式推荐触发规则]来判断是否要给用户推荐。
+---以下是用户原始请求---
+`;
+const PLUGIN_LOG_PREFIX = "[skill-retriever]";
+const SKIP_KEYWORDS = ["安装", "装一下", "下载", "查询", "查找", "install", "卸载", "删除", "重载", "定时任务", "重装", "进化"];
+const SKIP_PATTERNS = [
+    "/new", "/reset", "/compact", "/stop", "/think", "/model", "/fast", "/verbose", "/config", "/debug", "/status", "/tasks", "/whoami", "/context", "/skill", "/commands", "/tools"
+];
+function shouldSkipSearch(prompt) {
+    const trimmedPrompt = prompt.trim();
+    if (trimmedPrompt.startsWith("/")) {
+        return "query starts with / (built-in command)";
+    }
+    const lowerPrompt = trimmedPrompt.toLowerCase();
+    for (const keyword of SKIP_KEYWORDS) {
+        if (lowerPrompt.includes(keyword.toLowerCase())) {
+            return `query contains keyword: ${keyword}`;
+        }
+    }
+    for (const pattern of SKIP_PATTERNS) {
+        if (lowerPrompt.includes(pattern.toLowerCase())) {
+            return `query matches pattern: ${pattern}`;
+        }
+    }
+    return null;
+}
+export function createBeforePromptBuildHandler(config) {
+    return async (event, ctx) => {
+        const userPrompt = event.prompt;
+        if (ctx?.sessionKey?.includes(":subagent:")) {
+            return undefined;
+        }
+        if (!config.enabled) {
+            return undefined;
+        }
+        if (!userPrompt || userPrompt.trim().length === 0) {
+            return undefined;
+        }
+        const extractedQuery = extractUserQuery(userPrompt);
+        if (!extractedQuery || extractedQuery.length === 0) {
+            return undefined;
+        }
+        const skipReason = shouldSkipSearch(extractedQuery);
+        if (skipReason) {
+            return undefined;
+        }
+        try {
+            const searchResult = await searchTools({
+                query: extractedQuery,
+                maxTools: config.maxTools,
+                includeUninstalledOnly: config.includeUninstalledOnly,
+                envFilePath: config.envFilePath,
+                serviceUrl: config.serviceUrl,
+                apiKey: config.apiKey,
+                uid: config.uid,
+                timeoutMs: config.timeoutMs,
+            });
+            if (!searchResult || searchResult.tools.length === 0) {
+                return undefined;
+            }
+            console.log(`${PLUGIN_LOG_PREFIX} [RESULT] Found ${searchResult.tools.length} skills, building context...`);
+            const toolsContext = formatToolsForContext(searchResult, config.includeUninstalledOnly);
+            if (!toolsContext) {
+                console.log(`${PLUGIN_LOG_PREFIX} [ERROR] Failed to format skills context`);
+                return undefined;
+            }
+            return {
+                prependContext: TOOL_RETRIEVER_HEADER + toolsContext + TOOL_RETRIEVER_FOOTER,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`${PLUGIN_LOG_PREFIX} [ERROR] ${errorMessage}, original query: "${extractedQuery}"`);
+            return undefined;
+        }
+    };
+}

package/dist/src/skill-retriever/tool-search.d.ts

@@ -0,0 +1,16 @@
+import type { EnvConfig, ToolSearchResult } from "./types.js";
+export declare function extractUserQuery(fullPrompt: string): string;
+export declare function readEnvFile(filePath: string): EnvConfig;
+export declare function getInstalledSkills(): string[];
+export interface SearchToolsOptions {
+    query: string;
+    maxTools?: number;
+    includeUninstalledOnly?: boolean;
+    envFilePath?: string;
+    serviceUrl?: string;
+    apiKey?: string;
+    uid?: string;
+    timeoutMs?: number;
+}
+export declare function searchTools(options: SearchToolsOptions): Promise<ToolSearchResult | null>;
+export declare function formatToolsForContext(result: ToolSearchResult, includeInstallUrl?: boolean): string;