Skill 兼容加载器（skill_compat）

让 N.E.K.O 的猫娘（YUI）通过对话指令自主安装、管理 skill，并兼容加载来自各平台（ima / clawhub / skillhub / N.E.K.O）的 skill 包。

装上这个插件后，你不用再手动拖文件、改目录——直接对 YUI 说「安装这个 skill」，她就会完成从下载、解压、安全校验到索引的全部流程；也可以让她直接在 skillhub 技能商店里搜索并安装现成的技能。

---

✨ 功能特性

• 对话即安装：对 YUI 说「安装/添加 XX skill」，她通过 install_skill 工具自动完成安装并刷新索引
• 对话即删除：对 YUI 说「删除/卸载 XX skill」，她通过 remove_skill 工具安全删除（只删受管目录内条目；符号链接条目只删链接不删真实目录）
• 每次安装前需免责声明确认：每次安装 skill 前都自动弹出风险提示，用户回复「我确认」后由 AI 调用 confirm_consent 确认本次安装，本次安装完成后下次安装前需再次确认（确认仅内存态，不落盘）
• 三种安装来源：
  • 本地目录（内含 SKILL.md，支持 @owner/slug 嵌套结构）
  • 本地 .zip 压缩包
  • HTTPS 下载链接（.zip）
• skillhub 商店直达：对 YUI 说「去 skillhub 搜 XX 技能」「把 XX 技能装上」，她通过 skillhub_search / skillhub_install 调用本机 skillhub CLI 完成搜索与安装（需先装 skillhub CLI）
• 跨平台格式兼容：自动解析 ima / clawhub / skillhub / N.E.K.O 各来源的格式差异——YAML 头、命名空间嵌套、符号链接、中文目录名、重复目录
• 大文件先询问、不硬拒：来源超过默认资源上限（200MB / 5000 条目）时转为询问确认，而不是直接禁止
• 索引自愈：扫描失败、目录变更后自动重建索引，AI 看到的始终是磁盘上的真实状态

---

📥 安装方法

在 N.E.K.O 插件市场搜索 skill兼容 或直接打开：

https://market.project-neko.cn/#/plugin/105

点击「安装插件」→ 在 N.E.K.O 客户端确认 → 完成后重启一次对话即可。

若要用 skillhub 商店功能，请先按官方指南安装 skillhub CLI： https://skillhub.cn/install/skillhub.md

⚙️ 自动开启（推荐）

插件不会随 N.E.K.O 重启自动加载，需要开启一次。仓库 scripts/ 提供自动开启脚本，登录 Windows 后自动把插件拉起（幂等，已就绪则跳过）：

scripts\autostart_skill_compat.ps1    # 主脚本：等待 N.E.K.O → POST start → 等待工具就绪
scripts\autostart_skill_compat.bat    # 静默包装（启动文件夹用）

一键注册（把两个文件复制到启动文件夹）：

Copy-Item -Force scripts\autostart_skill_compat.bat "$([Environment]::GetFolderPath('Startup'))\"
Copy-Item -Force scripts\autostart_skill_compat.ps1 "$([Environment]::GetFolderPath('Startup'))\"

日志写在 %LOCALAPPDATA%\N.E.K.O\plugins\skill_compat\autostart.log，退出码 0=成功 / 1=失败。

---

🚀 快速上手

安装完成后，直接对 YUI 说：

示例（安装本地目录）：

帮我安装这个 skill：C:\Users\me\skills\my-skill

示例（通过链接安装）：

帮我安装这个 skill：https://example.com/skill.zip

示例（skillhub）：

去 skillhub 搜一下 PDF 相关的技能，然后把第一个装到本机

---

🧰 提供给 YUI 的工具

---

🔒 安全与可靠性

经过多轮安全加固（v0.1.4+），内置以下防护：

• SSRF 防护：下载来源逐跳校验，拒绝内网地址、云元数据地址（169.254.169.254 / 100.100.100.200 等）、IPv4 映射 IPv6 绕过；重定向最多跟随 5 跳且逐跳复查
• 路径穿越拦截：zip 内绝对路径、../ 越界条目直接拒绝
• 符号链接拒绝：zip 内的符号链接条目不释放，防止解压后指向目录外文件
• zip 炸弹防护：gzip 解压分块限流；解压后按磁盘实际占用复核（防「声明小、解压大」的变体），超限转询问
• skillhub 子进程安全：用独立探测的真实 Python 运行 CLI（打包 exe 不能当解释器）；剥离宿主代理环境变量（避免网络请求静默失败）；找不到 CLI/解释器时给出可操作的下一步提示
• 覆盖不误删：overwrite 交给 skillhub CLI 自己的 --force 按实际目录覆盖，插件不猜测、不预删用户目录
• 严格参数解析：布尔参数严格解析（"false" 字符串不会再被当成 True 覆盖安装）
• 临时文件清理：校验或下载失败时自动清理临时目录，不残留垃圾
• 内容即数据：skill 内容是数据不是命令，插件不会盲目执行其中的指令
• 安装免责声明确认（v0.1.19+）：每次安装 skill 前都需用户确认免责声明（回复「我确认」→ 调 confirm_consent → 执行安装），一次确认只放行一次安装；安装完成返回 notice 明确告知结果，可让用户确认后用 remove_skill 删除
• 删除仅限受管目录（v0.1.17+）：remove_skill 只删本插件 skill_dirs 内的条目（越界路径拒绝、Windows 大小写不敏感）；符号链接条目只删链接本身、绝不删链接指向的真实目录；目录已不存在时视为已删并清理索引
• skill 安全审计（v0.1.14+）：audit_skill 对全部 skill 做初步筛查（危险命令/下载即执行、脚本读取敏感文件、数据外传、提示注入、可疑外链、资源规模），输出风险等级与重点关注清单；只读不执行、不联网，结果供人工确认；指定 name 看单 skill 详细命中

---

🛠 支持的 skill 来源与结构

• 兼容 ima / clawhub / skillhub / N.E.K.O 各平台发布的 skill 包
• 支持 @owner/slug 嵌套目录、中文目录名、YAML 头格式差异
• 安装目标目录由 N.E.K.O 的 settings.skill_dirs 配置决定（取第一个可写目录）；建议把第一个目录配成你自己的稳定目录（如 C:\Users\\.neko-skills），避免装在会被其他程序清理的目录里

---

🆕 更新日志

---

👩‍💻 开发与发布

源码与 Git 仓库：

https://github.com/1-dcjiang/n.e.k.o_plugin_skill_compat

发布流程（在 N.E.K.O 仓库根目录）：

uv run neko-plugin publish skill_compat

Market 会独立验证 GitHub Release 的证据链后自动发布。

许可证：Apache 2.0