napcat-sdk 0.2.5

NapCat SDK for Python - Fully typed and async ready

NapCat-SDK for Python

Type-Safe • Async-Ready • Framework-Free

Stop guessing parameter types. Let the IDE do the work.

告别查文档，享受 100% 类型覆盖 带来的极致补全体验。

---

⚡ The "IDE Magic"

这就是为什么你应该选择 NapCat-SDK：

智能 API 补全 + 精准参数提示	原生开发体验 + 零心智负担

👆 真正的 140+ API 全量类型覆盖，每一次按键都有 IDE 的守护。

---

✨ Features

• 🚀 完全异步: 基于 websockets + asyncio，高并发无压力。
• 💎 强类型优先: 每一个 Event、每一个 MessageSegment 都有严格定义。
• 🔌 双模式支持: Client (正向) / Server (反向) 随意切换。
• 🛠 零依赖: 仅依赖 websockets 和 orjson，极其轻量。

---

📸 Quick Look

🖱️ 点击复制代码文本

import asyncio
from napcat import NapCatClient, GroupMessageEvent, PrivateMessageEvent

# --- 消费者 A: 监听私聊 ---
async def listen_private(client: NapCatClient):
    print(">> 私聊监听启动")
    # 独立的 async for，享受完整的事件流副本
    async for event in client.events():
        match event:
            case PrivateMessageEvent():
                print(f"[私信] {event.sender.nickname}: {event.raw_message}")
                await event.send_msg("已阅")
            case _:
                pass

# --- 消费者 B: 监听群聊 ---
async def listen_group(client: NapCatClient):
    print(">> 群聊监听启动")
    # 另一个独立的 async for，互不抢占
    async for event in client.events():
        match event:
            case GroupMessageEvent():
                print(f"[群消息] {event.group_id}: {event.raw_message}")
                await event.reply("复读")
            case _:
                pass

async def main():
    # 正向 WebSocket 连接
    async with NapCatClient(ws_url="ws://localhost:80", token="123") as client:
        # 关键点：使用 gather 同时运行多个消费者
        await asyncio.gather(
            listen_private(client),
            listen_group(client)
        )

if __name__ == "__main__":
    asyncio.run(main())

---

📦 Installation

uv add napcat-sdk
# or
pip install napcat-sdk