📌 项目简介#

Mioku 是一个以初音未来为主题、基于 mioki 的 AI 优先 QQ 机器人框架。

• 仓库地址：https://github.com/mioku-lab/mioku
• 官网：https://mioku.pages.dev
• 开源协议：MIT
• 技术栈：TypeScript + Bun
• 底层协议：NapCat / OneBot v11

它不是传统意义上的「接大模型聊天机器人」，而是围绕 Agent / Skill 设计，让机器人可以自然地使用 QQ 功能、调用自己的插件完成各种任务。

✨ 核心特性#

官方还提供了配套项目：

• mioku-webui：可视化管理界面
• 多个官方插件：表情包、群管理、60s、MC 连接等

💖 为什么选择 Mioku？#

1. 真正 AI 优先
   不是简单对接大模型，而是围绕 Agent / Skill 设计，机器人可以主动完成任务。

2. 轻量高性能
   使用现代 TypeScript + Bun，官方称空载内存不超过 100MB。

3. 开发体验好
   插件以 npm 包形式管理，支持热插拔和配置热更新。

4. 一键启动友好
   npx mioku 即可创建项目，引导式配置，新手友好。

5. 自带 WebUI
   可视化管理插件、服务和配置，不用全程敲命令。

6. 初音主题加持
   对喜欢初音未来的用户，自带一份可爱滤镜～

目前项目还比较新，生态处于早期阶段。喜欢尝鲜和 AI Agent 玩法的朋友可以重点关注。

🛠️ 环境要求#

使用前请准备好以下环境：

• Bun（推荐一键安装：npm install -g bun）
• Git
• Chromium 内核浏览器（Chrome / Edge 等，用于截图服务）
• ffmpeg（部分插件需要）
• 一个可用的 NapCat 或其它 OneBot v11 实现端

🚀 快速开始#

1
npx mioku

1
cd <你的项目名>
2
bun run start

1
http://127.0.0.1:3339

1
# 安装插件示例
2
npx mioku install plugin 60s
3
npx mioku install plugin meme
4

5
# 安装服务示例
6
npx mioku install service ai
7

8
# 更新所有相关包
9
npx mioku update all
10

11
# 更新框架自身
12
npx mioku update self