mioki 简介

mioki 是基于 NapCat 的插件式 OneBot 机器人框架，KiviBot 的精神继任者。

mioki 继承了 KiviBot 的轻量、优雅和易用的设计理念，并在此基础上替换了底层通信库为 NapCat SDK，提供了更现代化的 TypeScript 支持和更强大的功能扩展能力。

本项目开发初衷在于提高群活跃氛围、方便群管理，仅供个人娱乐、学习和交流使用，不得将本项目用于任何非法用途。

为什么选择 mioki

🌟 KiviBot 继任者：继任 KiviBot 的优良传统和设计理念
🧩 插件式架构：支持热插拔插件，运行时动态启用/禁用/重载，方便扩展功能
🚀 基于 NapCat：利用 NapCat 的强大功能和稳定性
💡 简单易用：简洁的 API 设计，快速上手
📦 TypeScript 优先：完整的类型定义，极致的开发体验
⏱️ 定时任务：内置 cron 表达式支持，轻松实现定时任务
🛠️ 丰富的工具函数：提供大量实用工具函数，简化插件开发

更多特性等你探索...

插件示例

仅需编写少量代码即可实现丰富功能，比如：

import { definePlugin } from 'mioki'

export default definePlugin({
  name: 'words',
  version: '1.0.0',
  async setup(ctx) {
    ctx.logger.info('插件 Words 已加载！')
    ctx.logger.info(`当前登录账号: ${ctx.bot.nickname}（${ctx.bot.uin}）`)

    ctx.handle('message', async (event) => {
      ctx.match(
        event,
        {
          hello: 'world',

          现在几点: () => new Date().toLocaleTimeString('zh-CN'),

          赞我: async () => {
            await ctx.bot.sendLike(event.user_id, 10)
            return ['已为您点赞 10 次', ctx.segment.face(66)]
          },

          '我要头衔*': async (matches, event) => {
            if (event.message_type !== 'group') return

            const title = matches[0].slice(4)
            await event.group.setTitle(event.user_id, title)
            return `头衔已设置：${title}`
          },

          '查信息*': async (matches) => {
            const uin = Number(matches[0].slice(3))
            if (!uin || isNaN(uin)) return '请输入正确的 QQ 号'
            const info = await ctx.bot.getStrangerInfo(uin)
            return JSON.stringify(info, null, 2)
          },

          '*油价': async (matches) => {
            const regionEncoded = encodeURIComponent(matches[0].slice(0, -2) || '北京')
            const api = `https://60s.viki.moe/v2/fuel-price?region=${regionEncoded}&encoding=text`
            return await (await fetch(api)).text()
          },

          '/^(?<city>.{2,10})天气$/': async (matches) => {
            const cityEncoded = encodeURIComponent(matches.groups?.city || '北京')
            const api = `https://60s.viki.moe/v2/weather/realtime?query=${cityEncoded}&encoding=text`
            return await (await fetch(api)).text()
          },
        },
        true,
      )
    })

    return () => {
      ctx.logger.info('插件 Words 已卸载！')
    }
  },
})

mioki 简介 ​

为什么选择 mioki ​

插件示例 ​

mioki 简介

为什么选择 mioki

插件示例