Skip to content

Instantly share code, notes, and snippets.

@jenaiho

jenaiho/koishi-chat.md

Created August 16, 2026 02:08
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save jenaiho/6cab6e4cc1550a32af465838c7e2c229 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save jenaiho/6cab6e4cc1550a32af465838c7e2c229 to your computer and use it in GitHub Desktop.
Download ZIP
Koishi.js 深度了解 —— 跨平台聊天機器人框架（原文 collapsed 附文末）
Raw
koishi-chat.md

Koishi.js 深度了解 —— 跨平台聊天機器人框架

研究日期：2026-08-15 來源：koishi.chat ｜ GitHub koishijs/koishi

一句話總結

Koishi（古明地戀，東方 Project 角色）係一個 MIT 開源嘅跨平台聊天機器人框架——完全 TypeScript 開發，支援 QQ、Telegram、Discord、飛書等主流平台，超過 3000 個插件，提供控制台/沙盒/熱重載等開發者功能。本質上同我哋而家用嘅 Hermes gateway 係同一類嘢——一個平台，接入多個聊天平台。

核心資料

項目 資料
GitHub stars 5,904
Forks 307
語言 TypeScript（完全）
License MIT
建立 2019-12-03
開發者 Shigma（個人為主力）
插件數量 3,000+（官方 + 社區）
支援平台 QQ、Telegram、Discord、飛書、KOOK、LINE、Matrix、Slack、WhatsApp、釘釘、企業微信、微信公眾號、郵件、Satori

核心特性

  1. 開箱即用：控制台 + 線上插件市場，幾分鐘搭好機器人——即使冇編程基礎都可以喺控制台裝插件
  2. 生態豐富：4 年迭代，3,000+ 插件覆蓋平台支援、數據庫、資源存儲、網頁控制台、狀態管理到具體業務功能
  3. 專為開發者：
    • 頂級 TypeScript 類型支援——寫 code 甚至唔使睇文檔
    • 單元測試——核心功能全部測試覆蓋
    • 模組熱重載——保存即生效，唔使重啟機器人

關鍵架構概念

  • Adapter（適配器）：每個平台一個 adapter，Koishi 統一抽象，實現「一次編寫，多平台運行」
  • Plugin（插件）：功能模組，由插件市場安裝，覆蓋平台支援/數據庫/業務功能
  • 控制台（Console）：網頁儀表盤——實時監控、插件管理、沙盒模擬聊天（安裝插件後即刻試效果）
  • 數據庫：多驅動支援，可處理百萬級數據
  • Satori：Koishi 提出嘅開放協議，用於跨平台消息標準化

深度分析

1. 同我哋嘅 setup 係同類——值得對照 Koishi 同 Hermes 嘅 gateway 做嘅係同一件事：一個核心，接入多平台。對照：

功能 Koishi Hermes
平台接入 QQ/Telegram/Discord/飛書等 14+ Telegram/Discord/Slack/WhatsApp 等 20+
插件生態 3,000+（npm） skills + plugins（較新）
控制台 網頁儀表盤 + 沙盒 CLI + desktop app
開發語言 TypeScript Python
授權 MIT 開源

2. 名字背後嘅文化：Koishi 嚟自東方 Project 嘅古明地戀——「會做出無意識舉動嘅角色」，象徵聊天機器人主題 + 開發者嘅熱愛。呢個命名方式同我哋 Jena（昭君神韻）有異曲同工——技術項目承載文化靈魂。

3. 亮點：沙盒模擬聊天——裝完插件即刻喺控制台模擬對話睇效果，唔使真係喺 Telegram/QQ 度試。呢個係佢哋 UX 上最聰明嘅位——降低試錯成本。

4. 亮點：Satori 協議——Koishi 提出開放跨平台消息標準，試圖令「一次開發，處處運行」真正成立。呢個係佢哋對 chatbot 生態嘅最大概念貢獻（類似 MCP 之於 AI 工具）。

5. 香港用戶角度：如果 ohho 想將 Jena 接入 QQ/KOOK 等中國平台（Hermes 未必原生支援），Koishi 會係一個可行嘅補完方案——但要注意佢係獨立框架，唔係 Hermes 插件，兩者並行會係兩個系統。

對 ohho 嘅意義

  • 如果想將 Jena 接入 QQ/微信/飛書等中國平台——Koishi 係最成熟嘅開源方案（MIT，14+ 平台）
  • Satori 協議值得留意——跨平台消息標準化嘅嘗試，對任何多平台 bot 架構都有參考價值
  • 沙盒模擬聊天概念——可以偷師，諗下我哋自己有冇「裝完即刻試」嘅快速反饋機制

資料來源

原文全文

點擊展開完整原文（Koishi README）

Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架。

它的名字和图标设计来源于来源于东方 Project 中的角色古明地恋 (Komeiji Koishi)。古明地恋是一个会做出无意识举动的角色，取这个名字既象征着聊天机器人的主题，也蕴含了开发者为之倾注的热爱。

特性

开箱即用

Koishi 提供了高度便利的控制台，让你无需基础让你在几分钟之内搭建自己的聊天机器人。

  • 提供在线插件市场，即使没有任何编程基础，也能轻松在控制台中下载安装插件
  • 支持 QQ，Telegram，Discord，飞书等主流聊天平台，支持多账户和跨平台数据互通
  • 随时随地通过控制面板监控运行状态，控制机器人的行为，甚至上号聊天

生态丰富

经过了长达四年的迭代，Koishi 已经发展出了丰富的插件生态和与之匹配的健壮系统。超过 3000 个官方和社区插件覆盖了机器人开发的方方面面，从平台支持、数据库、资源存储、网页控制台、状态管理到具体的业务功能一应俱全。无论你的目标是构建大型交互应用还是轻量级的辅助机器人，Koishi 都为你提供了最佳实践。如果担心在复杂的功能中迷失方向，我们也准备了细致的文档来提供帮助。

专为开发者打造

Koishi 更为开发者准备了众多专业功能，使插件开发者得以在各种复杂需求中构建规模化的解决方案。

  • 类型支持：Koishi 完全基于 TypeScript 开发，拥有顶级的类型支持，丰富的代码提示让你在编写代码的时候甚至无需查看文档
  • 单元测试：所有核心功能均已经通过单元测试，既确保了可靠性，也为开发者提供了一套测试插件和定位问题的最佳实践
  • 模块热重载：开发 Koishi 插件时，只需轻点保存即可热重载，无需频繁重启机器人，如同前端开发一样丝滑顺畅

快速起步

前往文档

许可证

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

Copyright © 2019-2023, Shigma

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment