Koishi

Koishi 是一个在 Node.js 环境下运行的跨平台机器人框架，目前可支持 QQ，开黑啦，Telegram，Discord 等多个平台。

这个项目的名字和图标来源于东方 Project 中的角色古明地恋 (Komeiji Koishi)。

快速上手

# 进入文件夹
cd my-bot

安装 Koishi
yarn add koishi
初始化配置文件
yarn koishi init
运行你的 Bot
yarn koishi start

现在可以对你的机器人说话了：

> echo hello world
< hello world

完整版文档：https://koishi.js.org/guide/starter.html

优秀特性

开箱即用的 CLI

Koishi 高度配置化的命令行工具可以让你无需写代码就搭建属于你的机器人。与此同时，CLI 还配备了丰富和人性化的提示，进一步提高调试体验。

功能强大的 API

经过了几个版本的迭代，Koishi 已经发展出了丰富的 API，功能覆盖机器人领域的方方面面。从上层负责交互的指令、会话、中间件，再到中层负责控制的应用、上下文、插件，最后到底层的机器人和适配器，每一个部分都经过了精心的编写，可以让你轻松实现任何需求。

丰富的生态系统

Koishi 在编写时，也同样编写了大量的官方插件作为补充。它们有些作为 Koishi 的基础功能，有些则为 Koishi 的使用提供了许多便利。更重要的是，这数十个插件都可以作为 Koishi 插件开发的极好示范。

多账户与跨平台支持

Koishi 原生地支持了多账户与跨平台，同时为这些机器人之间互通数据、共用服务器、保证数据安全提供了原生的解决方案，这有助于在保持高性能的同时，将风控和迁移造成的影响降低到最小。

应用案例

欢迎向下面的列表中添加自己的插件或机器人。

社区插件

• koishi-plugin-blame: 拦截崩溃错误，推送到私信或群
• koishi-plugin-gosen-choyen: 生成并发送“我想要五千兆元！”风格的图片
• koishi-plugin-genshin: 查询原神国服玩家数据
• koishi-plugin-ink: 通过 ink 展示视觉小说
• koishi-plugin-bgp: BGP 工具集！
• koishi-plugin-dcqq-relay: 同步 Discord 与 QQ 间的消息
• koishi-plugin-forward: 将你的消息转发至其他平台！
• koishi-plugin-animal-picture: 发送各种动物图片
• koishi-plugin-shell: 使用 Koishi 执行终端命令
• koishi-plugin-eval-enhance: koishi-plugin-eval的增强！

社区项目

• ArilyChan/qq-bot: 小阿日
• hydro-dev/HydroBot: A Simple QQ Robot
• Wjghj-Project/Chatbot-SILI: 「即时通讯软件转接姬」SILI-t137-[Tumita][email protected](A)
• idlist/2bot-v3: 2bot（名称来源于 FFXIV 的阿尔博特）

官方生态

平台支持

• koishi-adapter-onebot: OneBot 协议支持，可用于 QQ
• koishi-adapter-discord: Discord 平台支持
• koishi-adapter-telegram: Telegram 平台支持
• koishi-adapter-kaiheila: 开黑啦 平台支持

数据库支持

• koishi-plugin-mongo: MongoDB 支持
• koishi-plugin-mysql: MySQL 5.7 / MariaDB 10.5 支持

核心插件

koishi-plugin-common 是一个插件合集，包含了一些最常用功能：

• 发送和广播消息
• 管理用户和频道数据
• 账号跨平台绑定
• 消息跨频道转发
• 输出聊天记录到控制台
• 定制复读，处理申请，自定义回复……

koishi-plugin-eval 允许用户直接使用机器人执行脚本。它利用了 Node.js 的 vm 和 worker_threads 模块，在保护执行安全的前提下能够获得较快的响应速度。同时，插件还提供了一些内置的 API 供用户调用，并允许用户编写自己的模块并永久保存，甚至可以动态定义新的指令。

koishi-plugin-teach 允许用户在运行时编写问答并由机器人触发。每个人都可以随时随地修改机器人的行为，大大提高了互动的灵活性。支持概率控制、称呼匹配、指令插值、权限管理、频道过滤、正则匹配、后继问答等多种功能，足以应对绝大部分使用场景。

其他官方插件

• koishi-plugin-assets / 资源转存
• koishi-plugin-chess / 棋类游戏
• koishi-plugin-github / 接入 GitHub
• koishi-plugin-image-search / 图片搜索
• koishi-plugin-puppeteer / 网页截图
• koishi-plugin-schedule / 计划任务
• koishi-plugin-tools / 实用工具
• koishi-plugin-webui / 网页控制台

使用协议

Koishi 完全使用 MIT 协议开源，维护良好的开源生态从我做起 (*>ω<)φ

Copyright © 2019-present, Shigma

贡献指南

查看这里

联系方式

本群只交流程序开发，不欢迎伸手党，禁止谈论商业行为。