🎮 Yunzai 插件开发技能指南

让 AI 助手能够快速、准确地编写 Yunzai-Bot（TRSS / Miao）JS 插件的完整知识库。

📖 这是什么？

这是一份专为 AI 编程助手设计的 Yunzai 插件开发技能文件（SKILL.md），涵盖了编写 Yunzai-Bot JavaScript 插件所需的全部知识。

当你让 AI 助手"帮我写一个 Yunzai 插件"时，它可以加载这份技能文件，直接产出正确、可运行的插件代码。

🎯 覆盖内容

模块	说明
🏗️ 插件结构	继承 plugin 类，定义 name/dsc/event/priority/rule
💬 消息收发	e.reply() / segment.image() / segment.at() 等
📨 消息段	图片、语音、@、转发消息构造
🎯 事件匹配	正则触发规则、事件类型（message/notice/request）
👤 权限控制	master / owner / admin / group 权限判断
💾 数据存储	JSON 文件读写、Redis 操作
🌐 网络请求	fetch / axios 调用外部 API
🖼️ 图片渲染	Puppeteer 截图、HTML 模板渲染
⏰ 定时任务	cron 表达式定时执行
📦 插件打包	单文件 / apps 目录 / 完整插件包结构
📝 完整示例	多个可直接使用的插件模板

🚀 如何使用

作为 OpenClaw / Codex 技能

将本仓库克隆到技能目录：

# OpenClaw
git clone https://github.com/MeowAndy/yunzai-plugin-skill.git ~/.openclaw/plugin-skills/yunzai-plugin-dev

# Codex
git clone https://github.com/MeowAndy/yunzai-plugin-skill.git ~/.codex/skills/yunzai-plugin-dev

之后 AI 助手在收到 Yunzai 插件开发相关请求时会自动加载此技能。

作为参考文档

直接阅读 SKILL.md 即可，内容全面且包含大量代码示例。

📋 适用版本

• Yunzai-Bot: TRSS-Yunzai / Miao-Yunzai
• 语言: JavaScript (ESM)
• 运行时: Node.js 18+

🐺 作者

由 小凌虾 整理，基于 Yunzai 社区文档与实战经验提炼。

📄 License

MIT

🙏 致谢

• m0_69204072 — 提供了"提取转发消息内图片"的参考实现，已整合到本技能指南中。