用途:当用户需要为项目、服务器、VPS 或工作会话设置、激活、停用或验证知识补丁时使用本技能。
主要能力:先加载 knowledge-patch:using-knowledge-patch(若尚未加载),读取 ../../catalog/patches.json、../../catalog/aliases.json 和 ../../catalog/detection.json;检查当前项目及(相关时)服务器环境。检测信号中,普通检测文件检查路径是否存在,glob::marker 要求匹配文件包含指定字面标记;精选术语仅作辅助证据,不能替代更强的文件或清单证据。随后推荐相关补丁集,面向用户的激活消息使用各目录的 short_label。若证据看起来像服务器环境,在把服务补丁视为激活前先询问是否需要管理员指引。
使用方式:用户批准激活后,只写入优先级状态,不复制技能文件、不安装独立插件、不从网络获取任何内容。停用或移除补丁时,删除已解析的补丁名及其激活原因;若用户表示没有或要求清空全部激活,则写入空的 active_patches 列表和空的 activation_reasons 对象。首选项目状态路径为 .knowledge-patch/activation.json,用户级回退路径为 $XDG_STATE_HOME/knowledge-patch/activation.json。状态 JSON 含 schema_version、active_patches、activation_reasons、updated_at 字段。若状态文件已存在,保留无关字段;手动激活原因不应被较弱的自动检测覆盖。
适用场景:项目或服务器环境中的补丁检测与激活管理、会话级补丁优先级调整、补丁验证与清理。
限制:全部离线运行;内置技术补丁已位于 skills/ 下;激活只改变优先级与路由,不涉及安装;停用只移除优先级状态,不删除内置技能;钩子为可选项,通过本技能与 using-knowledge-patch 手动使用是可靠路径。其他细节暂未提供。