TRAE Skill v4.0.0 稳定版

N.E.K.O
插件开发 Skill

面向 N.E.K.O 插件开发的全方位辅助工具,整合 project-neko.online 官方文档、深度逆向分析十篇、45个已知陷阱与4个实战案例,从工程搭建到避坑上线,一站式覆盖。

N
plugin.toml
@llm_tool
PluginRouter
0
篇参考文档
覆盖开发全流程
0
个已知陷阱
避坑指南
0
个实战案例
完整可复用
0
条铁律
最佳实践总结

全方位开发支持

从配置到部署,从后端到前端,每一个环节都有详尽指南

🔧

装饰器体系

深入解析 10+ 个核心装饰器的用法与最佳实践。

  • @llm_tool 工具注册
  • 生命周期钩子
  • 数据库操作
  • 状态上报
🎨

Hosted UI 面板

UI 设置面板组件库与交互规范,打造专业插件界面。

  • Slider / Select 组件
  • StatusBadge 状态
  • ActionForm 表单
  • api.call 调用
🚦

PluginRouter 路由

插件路由系统深度解析,RESTful 风格 API 设计与前端联调。

  • 路由注册与分组
  • 请求参数校验
  • 响应格式规范
  • 错误处理机制
🔬

主程序深度逆向分析

十篇深度逆向分析文章,揭秘 N.E.K.O 内部机制——生命周期、ZMQ 消息总线、Push Message、Logger、Store-DB、i18n、Config 等核心模块的工作原理。

生命周期 ZMQ / Bus NekoPluginBase Store-DB i18n / Config Push Message
⚠️

45 个已知陷阱

踩坑经验汇总,避免重复犯错,加速开发进程。

  • 双装饰器顺序
  • 数据库线程安全
  • UI 异步更新
  • 路径编码问题
🧪

单元测试

插件单元测试框架搭建与测试用例编写规范。

  • 测试环境配置
  • Mock 工具使用
  • 覆盖率报告
  • CI/CD 集成
🚀

部署与同步

插件打包、发布、部署与多设备同步的完整流程。

  • 打包规范
  • 版本管理
  • 同步机制
  • 性能优化
🎯

AI 友好设计

让大模型更好地理解和使用你的插件,提升用户体验。

  • 命名规范
  • 描述优化
  • 参数设计
  • 返回格式

四个完整实战案例

从简单到复杂,循序渐进掌握插件开发

入门案例

Hello World 插件

从零开始创建第一个 N.E.K.O 插件,理解插件生命周期与基本结构。

工具类插件

数据处理工具集

批量数据处理插件,学习 @llm_tool 注册、参数校验与错误处理。

UI 插件

设置面板与交互

完整的 Hosted UI 面板开发,Slider、表单、状态展示与 api.call 联动。

综合案例

完整产品级插件

数据库、路由、UI、测试、部署全流程实战,打造生产级插件。

更新日志

持续迭代,不断进化

v4.0.0 最新 2025 · 第三季度
重大版本更新,全面升级文档体系与案例库。
  • 新增主程序深度逆向分析十篇(生命周期 / ZMQ / Bus / Store-DB 等)
  • 整合 project-neko.online 官方开发文档全量内容
  • 扩展技能包从 6 个升级至 11 个
  • 已知陷阱补充至 45 个,附带详细避坑方案
  • 新增 2 个完整实战案例,代码可直接复用
v3.0.0 2025 · 第一季度
PluginRouter 与 Hosted UI 深度解析。
  • PluginRouter 路由系统完整指南
  • Hosted UI 组件库与交互规范
  • 单元测试框架搭建与 CI/CD 集成
  • 部署同步与性能优化指南
v2.0.0 2024 · 第三季度
装饰器体系与数据库操作详解。
  • 10+ 核心装饰器深度解析
  • 数据库操作与线程安全
  • AI 友好设计原则
  • 首批 20 个已知陷阱汇总
v1.0.0 2024 · 第一季度
首个正式版本,基础插件开发指南。
  • plugin.toml 配置详解
  • 插件工程搭建与目录结构
  • Python 后端基础开发
  • 入门级 Hello World 案例

立即开始你的 N.E.K.O 插件之旅

访问 GitHub 仓库获取完整 Skill 包,按照 README 指引安装即可开始使用。遇到问题?欢迎提交 Issue,或者直接联系我交流。