手瓜一十雪 b15d02535e refactor: minor lint and consistency fixes
Apply a collection of small code cleanups across the repo for consistency and lint-safety. Changes include:

- Use strict equality (===) where appropriate (GetEmojiLikes, about page checks).
- Replace Array.map used for side effects with Array.forEach (GetMsg).
- Rename unused catch parameters to underscore-prefixed names to avoid lint warnings (multiple backend/middleware files).
- Replace void with undefined in an actions.call invocation (builtin plugin index).
- Remove an unused loadedCount variable when reading .env (napcat-shell).
- Rename promise resolver parameter to `resolve` for clarity in tests and keep setTimeout usage (rpc.test.ts).
- Strengthen external shims types by changing generic parameter names to _T and update inversify ServiceIdentifier generic param (external-shims.d.ts).
- Simplify post-build script imports and comment out an external-type mapping block; fix a regex character class bug (post-build.mjs).
- Prefix several unused test stub variables with underscore to indicate intentional unused status (test-dist.ts).
- Minor JSX formatting/indentation fixes in password_login component and UI text indentation in system_info.
- Misc: SSE/config and plugin config handlers adjusted to consistent catch parameter naming; update mirror/download error catch variable name.

These edits are non-functional refactors focused on code style, lint compliance and small robustness/clarity improvements.
2026-03-05 18:53:58 +08:00
2025-03-16 09:33:06 +08:00
2024-11-23 18:52:53 +08:00
2025-11-13 15:39:42 +08:00
2026-02-05 12:56:53 +08:00
2025-03-16 09:36:27 +08:00

NapCat

NapCat

Modern protocol-side framework implemented based on NTQQ.

Where clouds rise and winds are born, the heart yearns for distant lands yet untraveled.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Русский | العربية


Notice

NapCat is currently looking for a new primary maintainer. Please email nanaeonn@outlook.com if you are interested.

Community Groups

You can get the join password directly from the About page of the WebUI.

Note: The join key is only valid for the latest 100 versions, and requires NapCat version >= 4.17.31. If it fails, please update.

Welcome

  • NapCatQQ is a modern implementation of the Bot protocol based on NTQQ.

Features

  • Easy to Use
    • Beginners can get started effortlessly.
  • Quick and Efficient
    • Runs for extended periods on low-memory systems.
  • Rich API Interface
    • Fully implements most standard interfaces.
  • Stable and Reliable
    • Continuous and stable development and maintenance.

Quick Start

Download the latest version from the Release page.

First-time users should make sure to read the documentation below for a usage guide.

This is a non-profit project. For integration issues, basic questions, or underlying framework issues, please search for solutions on your own — this project's community does not provide such support.

Docs Github.IO Cloudflare.Worker Cloudflare.HKServer
Docs Cloudflare.Pages Server.Other NapCat.Top
DeepWiki Ask DeepWiki
QQ Groups Happy Family Royal Relatives Loving Family Joyful Family

Please do not mention this project in other communities (including other protocol-side or related application-side projects) to avoid disputes. If you have suggestions, please discuss them in the official group or submit a PR.

Thanks

  • Lagrange — Great support for this project; some code was referenced (with permission)

  • AstrBot — An LLM Bot framework that perfectly integrates with this project

  • MaiBot — A cyber companion Bot framework

  • qq-chat-exporter — A message export tool based on NapCat

  • And most importantly, thank you — the person reading this right now~


License

This project is open-sourced under a hybrid license. When using this project, please note the following:

  1. Third-party library code or modified portions follow their original open-source licenses.
  2. This project has obtained authorization from certain projects and is not subject to some restrictions.
  3. The remaining logic code of the project is governed by the repository license.

This repository is solely intended to improve usability and implement message push features. Furthermore, developing any project based on NapCat code without prior authorization from the repository's main author is prohibited. Please comply with local laws and regulations when using this project. Any issues arising from misuse are the responsibility of the user and anyone providing tutorials for unauthorized use.

S
Description
No description provided
Readme
385 MiB
Languages
TypeScript 97.7%
JavaScript 1.3%
HTML 0.4%
Python 0.2%
Batchfile 0.2%
Other 0.2%