chat-adapter-qq 0.0.0 → 0.0.1

package/README.md

@@ -1,8 +1,49 @@
 # chat-adapter-qq
 
+[![npm version](https://img.shields.io/npm/v/chat-adapter-qq)](https://www.npmjs.com/package/chat-adapter-qq)
+[![npm downloads](https://img.shields.io/npm/dm/chat-adapter-qq)](https://www.npmjs.com/package/chat-adapter-qq)
 [![CI](https://github.com/yjl9903/openana/actions/workflows/ci.yml/badge.svg)](https://github.com/yjl9903/openana/actions/workflows/ci.yml)
 
-Work in progress.
+QQ adapter for [Chat SDK](https://chat-sdk.dev/docs).
+
+## Installation
+
+```bash
+npm install chat chat-adapter-qq
+```
+
+## Quick start
+
+```ts
+import { Chat } from 'chat';
+import { createMemoryState } from '@chat-adapter/state-memory';
+import { create } from 'chat-adapter-qq';
+
+const bot = new Chat({
+  userName: '', // leave for empty
+  adapters: {
+    qq: createQQAdapter({
+      napcat: {
+        protocol: 'wss',
+        host: '<your napcat host>',
+        port: 443,
+        accessToken: '<your napcat access token>',
+        // ↓ 自动重连 (可选)
+        reconnection: {
+          enable: true,
+          attempts: 10,
+          delay: 5000
+        }
+      }
+    })
+  },
+  state: createMemoryState()
+});
+
+bot.onNewMention(async (thread, message) => {
+  await thread.post('Hello from QQ bot!');
+});
+```
 
 ## License
 

package/dist/index.cjs

@@ -1,7 +1,330 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/index.ts
-function hello() {
-	return "world";
+let chat = require("chat");
+let _chat_adapter_shared = require("@chat-adapter/shared");
+let node_napcat_ts = require("node-napcat-ts");
+//#region src/format-converter.ts
+/**
+* @todo
+*/
+var QQFormatConverter = class extends chat.BaseFormatConverter {
+	toAst(platformText) {
+		return (0, chat.parseMarkdown)(platformText);
+	}
+	fromAst(ast) {
+		return (0, chat.stringifyMarkdown)(ast);
+	}
+};
+//#endregion
+//#region src/utils.ts
+/** 将字符串 ID 转为正整数，失败时抛出 ValidationError。 */
+function toNumberId(value, fieldName) {
+	const num = Number(value);
+	if (!Number.isInteger(num) || num <= 0) throw new _chat_adapter_shared.ValidationError("qq", `QQ ${fieldName} must be a positive integer: ${value}`);
+	return num;
+}
+/** 判断消息是否由 bot 自己发送（用于避免回环处理）。 */
+function isSelfMessage(raw, selfId) {
+	if (!selfId) return false;
+	return String(raw.user_id) === selfId;
+}
+/** 判断消息是否命中 mention 语义。 */
+function isMention(raw, selfId) {
+	if (raw.message_type === "private") return true;
+	if (!selfId) return false;
+	return raw.message.some((segment) => segment.type === "at" && segment.data.qq !== "all" && String(segment.data.qq) === selfId);
+}
+/** 将 QQ 原始消息映射为统一的 QQ thread ID 结构。 */
+function toThreadId(raw) {
+	if (raw.message_type === "group") return {
+		chatType: "group",
+		peerId: String(raw.group_id)
+	};
+	return {
+		chatType: "private",
+		peerId: String(raw.user_id)
+	};
+}
+/** 将 QQ 原始作者信息映射为 Chat SDK Author。 */
+function toAuthor(raw, isMe) {
+	return {
+		userId: String(raw.user_id),
+		userName: String(raw.user_id),
+		fullName: raw.sender.card || raw.sender.nickname || String(raw.user_id),
+		isBot: isMe,
+		isMe
+	};
+}
+/** 从 NapCat segment 列表提取纯文本；必要时回退 raw_message。 */
+function extractText(raw) {
+	const text = raw.message.map(segmentToText).join("");
+	if (text.length > 0) return text;
+	return raw.raw_message ? (0, chat.toPlainText)((0, chat.parseMarkdown)(raw.raw_message)) : "";
+}
+/** 将 NapCat segment 中可识别的媒体映射为 Chat SDK attachments。 */
+function toAttachments(message) {
+	return message.map((segment) => {
+		if (segment.type === "image") return {
+			type: "image",
+			url: "url" in segment.data ? segment.data.url : void 0
+		};
+		if (segment.type === "file") return {
+			type: "file",
+			name: segment.data.file
+		};
+		if (segment.type === "video") return {
+			type: "video",
+			url: segment.data.url,
+			name: segment.data.file
+		};
+		if (segment.type === "record") return {
+			type: "audio",
+			name: segment.data.file
+		};
+		return null;
+	}).filter((attachment) => attachment !== null);
+}
+/** 将单个 NapCat segment 转为可读文本片段。 */
+function segmentToText(segment) {
+	if (segment.type === "text") return segment.data.text;
+	if (segment.type === "at") return segment.data.qq === "all" ? "@all" : `@${segment.data.qq}`;
+	if (segment.type === "face") return `[face:${segment.data.id}]`;
+	if (segment.type === "image") return "[image]";
+	if (segment.type === "file") return `[file:${segment.data.file}]`;
+	if (segment.type === "record") return "[audio]";
+	if (segment.type === "video") return "[video]";
+	if (segment.type === "markdown") return segment.data.content;
+	return "";
+}
+//#endregion
+//#region src/adapter.ts
+/**
+* Chat SDK QQ 平台适配器（基于 NapCat WebSocket）。
+*
+* 设计说明：
+* - 入口仅支持 WS 事件推送，不支持 HTTP webhook。
+* - thread 模型采用“会话即 thread”：
+*   - 群：`qq:group:{group_id}`
+*   - 私聊：`qq:private:{user_id}`
+*/
+var QQAdapter = class {
+	/** 适配器名称，作为 Chat SDK 的 adapter key。 */
+	name = "qq";
+	/** 机器人用户名（初始化后由登录信息填充）。 */
+	userName;
+	/** 机器人用户标识（初始化后由登录信息填充）。 */
+	botUserId;
+	config;
+	converter = new QQFormatConverter();
+	chat = null;
+	client;
+	selfId;
+	logger;
+	listenersBound = false;
+	initializing;
+	/** 创建 QQ 适配器实例（不发起连接）。 */
+	constructor(config) {
+		this.config = config;
+		this.userName = "";
+		this.logger = config.logger ?? {
+			child: () => this.logger,
+			debug: () => {},
+			info: () => {},
+			warn: () => {},
+			error: () => {}
+		};
+	}
+	/**
+	* 初始化适配器，建立 NapCat 连接并注册消息监听。
+	* 该方法具有幂等性，多次调用会复用同一初始化流程。
+	*/
+	async initialize(chat$1) {
+		if (this.initializing) return this.initializing;
+		this.initializing = this.doInitialize(chat$1).catch((error) => {
+			this.initializing = void 0;
+			throw error;
+		});
+		return this.initializing;
+	}
+	async doInitialize(chat$2) {
+		this.chat = chat$2;
+		this.logger = this.config.logger ?? chat$2.getLogger(this.name);
+		if (!this.client) this.client = new node_napcat_ts.NCWebsocket(this.config.napcat, this.config.debug ?? false);
+		this.bindListeners();
+		await this.client.connect();
+		const login = await this.client.get_login_info();
+		this.logger.info("login with", login);
+		this.selfId = String(login.user_id);
+		this.botUserId = login.nickname;
+		this.userName = login.nickname;
+	}
+	/** QQ 适配器为 WS-only 模式，HTTP webhook 入口固定返回 501。 */
+	async handleWebhook(_request, _options) {
+		return new Response("QQ adapter uses NapCat WebSocket ingress only.", { status: 501 });
+	}
+	/** 编码 thread ID：`qq:{chatType}:{peerId}`。 */
+	encodeThreadId(data) {
+		if (data.chatType !== "group" && data.chatType !== "private") throw new _chat_adapter_shared.ValidationError("qq", `Unsupported QQ chat type: ${data.chatType}`);
+		if (!data.peerId) throw new _chat_adapter_shared.ValidationError("qq", "QQ thread peerId is required");
+		return `qq:${data.chatType}:${data.peerId}`;
+	}
+	/** 解码 thread ID 并进行格式校验。 */
+	decodeThreadId(threadId) {
+		const parts = threadId.split(":");
+		if (parts.length !== 3 || parts[0] !== "qq") throw new _chat_adapter_shared.ValidationError("qq", `Invalid QQ thread ID: ${threadId}`);
+		const chatType = parts[1];
+		if (chatType !== "group" && chatType !== "private") throw new _chat_adapter_shared.ValidationError("qq", `Invalid QQ thread type in thread ID: ${threadId}`);
+		const peerId = parts[2];
+		if (!peerId) throw new _chat_adapter_shared.ValidationError("qq", `Invalid QQ thread peer ID in thread ID: ${threadId}`);
+		return {
+			chatType,
+			peerId
+		};
+	}
+	/** 当前模型下 channelId 与 threadId 一致。 */
+	channelIdFromThreadId(threadId) {
+		this.decodeThreadId(threadId);
+		return threadId;
+	}
+	/** 判断当前 thread 是否为私聊会话。 */
+	isDM(threadId) {
+		return this.decodeThreadId(threadId).chatType === "private";
+	}
+	/** 向群或私聊发送消息。 */
+	async postMessage(threadId, message) {
+		const client = this.requireClient();
+		const parsed = this.decodeThreadId(threadId);
+		const peerId = toNumberId(parsed.peerId, "peerId");
+		const text = this.converter.renderPostable(message);
+		const outgoingText = text.length > 0 ? text : " ";
+		const segments = [node_napcat_ts.Structs.text(outgoingText)];
+		this.logger.debug("post message", parsed.chatType, parsed.peerId, segments);
+		const sent = parsed.chatType === "group" ? await client.send_group_msg({
+			group_id: peerId,
+			message: segments
+		}) : await client.send_private_msg({
+			user_id: peerId,
+			message: segments
+		});
+		return {
+			id: String(sent.message_id),
+			raw: {
+				...sent,
+				threadId,
+				chatType: parsed.chatType
+			},
+			threadId
+		};
+	}
+	/** QQ 暂不支持编辑消息。 */
+	async editMessage(_threadId, _messageId, _message) {
+		throw new chat.NotImplementedError("QQ adapter does not support editMessage yet", "editMessage");
+	}
+	/** 删除指定消息。 */
+	async deleteMessage(_threadId, messageId) {
+		await this.requireClient().delete_msg({ message_id: toNumberId(messageId, "messageId") });
+	}
+	/** QQ 暂不支持反应能力（添加）。 */
+	async addReaction(_threadId, _messageId, _emoji) {
+		throw new chat.NotImplementedError("QQ adapter does not support addReaction yet", "addReaction");
+	}
+	/** QQ 暂不支持反应能力（移除）。 */
+	async removeReaction(_threadId, _messageId, _emoji) {
+		throw new chat.NotImplementedError("QQ adapter does not support removeReaction yet", "removeReaction");
+	}
+	/** QQ 暂不支持历史消息分页拉取。 */
+	async fetchMessages(_threadId, _options) {
+		throw new chat.NotImplementedError("QQ adapter does not support fetchMessages yet", "fetchMessages");
+	}
+	/** 获取 thread 基础信息。 */
+	async fetchThread(threadId) {
+		const parsed = this.decodeThreadId(threadId);
+		return {
+			id: threadId,
+			channelId: threadId,
+			isDM: parsed.chatType === "private",
+			metadata: {
+				chatType: parsed.chatType,
+				peerId: parsed.peerId
+			}
+		};
+	}
+	/** 当前实现不发送真实 typing，仅作为 no-op。 */
+	startTyping(_threadId, _status) {
+		return Promise.resolve();
+	}
+	/** 渲染格式化内容到 QQ 文本。 */
+	renderFormatted(content) {
+		return this.converter.fromAst(content);
+	}
+	/** 将 NapCat 原始消息转换为 Chat SDK 标准 Message。 */
+	parseMessage(raw) {
+		const threadId = this.encodeThreadId(toThreadId(raw));
+		const text = extractText(raw);
+		const isMe = this.selfId !== void 0 && String(raw.user_id) === this.selfId;
+		return new chat.Message({
+			id: String(raw.message_id),
+			threadId,
+			text,
+			formatted: this.converter.toAst(text),
+			author: toAuthor(raw, isMe),
+			metadata: {
+				dateSent: /* @__PURE__ */ new Date(raw.time * 1e3),
+				edited: false
+			},
+			attachments: toAttachments(raw.message),
+			raw
+		});
+	}
+	bindListeners() {
+		if (!this.client || this.listenersBound) return;
+		this.client.on("message.group", this.onGroupMessage);
+		this.client.on("message.private", this.onPrivateMessage);
+		this.listenersBound = true;
+	}
+	onGroupMessage = (raw) => {
+		this.dispatchIncomingMessage(raw);
+	};
+	onPrivateMessage = (raw) => {
+		this.dispatchIncomingMessage(raw);
+	};
+	/**
+	* 统一处理入站消息：
+	* - 过滤 bot 自己发送的消息
+	* - 计算 threadId 与 mention
+	* - 交给 Chat SDK `processMessage` 进入标准事件流
+	*/
+	dispatchIncomingMessage(raw) {
+		if (!this.chat) return;
+		if (isSelfMessage(raw, this.selfId)) return;
+		const threadId = this.encodeThreadId(toThreadId(raw));
+		const mention = isMention(raw, this.selfId);
+		this.chat.processMessage(this, threadId, async () => {
+			const message = this.parseMessage(raw);
+			message.isMention = mention;
+			return message;
+		});
+	}
+	/** 获取已初始化的 NapCat 客户端，否则抛出配置错误。 */
+	requireClient() {
+		if (!this.client) throw new _chat_adapter_shared.ValidationError("qq", "QQ adapter is not initialized. Attach it to Chat and call chat.initialize() first.");
+		return this.client;
+	}
+};
+//#endregion
+//#region src/factory.ts
+/**
+* 创建 QQ 适配器实例。
+* 仅支持显式配置，不读取环境变量。
+*
+* @param config QQ 适配器配置
+* @returns 已创建但未初始化的 QQAdapter 实例
+*/
+function createQQAdapter(config) {
+	if (!config || !config.napcat) throw new _chat_adapter_shared.ValidationError("qq", "QQ NapCat config is required. Pass { napcat: NCWebsocketOptions } to createQQAdapter(config).");
+	return new QQAdapter(config);
 }
 //#endregion
-exports.hello = hello;
+exports.QQAdapter = QQAdapter;
+exports.createQQAdapter = createQQAdapter;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["BaseFormatConverter","ValidationError","chat","NCWebsocket","ValidationError","Structs","NotImplementedError","Message","ValidationError"],"sources":["../src/format-converter.ts","../src/utils.ts","../src/adapter.ts","../src/factory.ts"],"sourcesContent":["import { BaseFormatConverter, parseMarkdown, stringifyMarkdown, type Root } from 'chat';\n\n/**\n * @todo\n */\nexport class QQFormatConverter extends BaseFormatConverter {\n  toAst(platformText: string): Root {\n    return parseMarkdown(platformText);\n  }\n\n  fromAst(ast: Root): string {\n    return stringifyMarkdown(ast);\n  }\n}\n","import type { Receive } from 'node-napcat-ts';\n\nimport { ValidationError } from '@chat-adapter/shared';\nimport { parseMarkdown, toPlainText, type Attachment, type Author } from 'chat';\n\nimport type { QQRawMessage, QQThreadId } from './types.js';\n\n/** NapCat 入站 message segment 的联合类型。 */\nexport type QQMessageSegment = Receive[keyof Receive];\n\n/** 将字符串 ID 转为正整数，失败时抛出 ValidationError。 */\nexport function toNumberId(value: string, fieldName: string): number {\n  const num = Number(value);\n  if (!Number.isInteger(num) || num <= 0) {\n    throw new ValidationError('qq', `QQ ${fieldName} must be a positive integer: ${value}`);\n  }\n  return num;\n}\n\n/** 判断消息是否由 bot 自己发送（用于避免回环处理）。 */\nexport function isSelfMessage(raw: QQRawMessage, selfId?: string): boolean {\n  if (!selfId) {\n    return false;\n  }\n\n  return String(raw.user_id) === selfId;\n}\n\n/** 判断消息是否命中 mention 语义。 */\nexport function isMention(raw: QQRawMessage, selfId?: string): boolean {\n  if (raw.message_type === 'private') {\n    return true;\n  }\n\n  if (!selfId) {\n    return false;\n  }\n\n  return raw.message.some(\n    (segment) =>\n      segment.type === 'at' && segment.data.qq !== 'all' && String(segment.data.qq) === selfId\n  );\n}\n\n/** 将 QQ 原始消息映射为统一的 QQ thread ID 结构。 */\nexport function toThreadId(raw: QQRawMessage): QQThreadId {\n  if (raw.message_type === 'group') {\n    return {\n      chatType: 'group',\n      peerId: String(raw.group_id)\n    };\n  }\n\n  return {\n    chatType: 'private',\n    peerId: String(raw.user_id)\n  };\n}\n\n/** 将 QQ 原始作者信息映射为 Chat SDK Author。 */\nexport function toAuthor(raw: QQRawMessage, isMe: boolean): Author {\n  return {\n    userId: String(raw.user_id),\n    userName: String(raw.user_id),\n    fullName: raw.sender.card || raw.sender.nickname || String(raw.user_id),\n    isBot: isMe,\n    isMe\n  };\n}\n\n/** 从 NapCat segment 列表提取纯文本；必要时回退 raw_message。 */\nexport function extractText(raw: QQRawMessage): string {\n  const text = raw.message.map(segmentToText).join('');\n  if (text.length > 0) {\n    return text;\n  }\n\n  return raw.raw_message ? toPlainText(parseMarkdown(raw.raw_message)) : '';\n}\n\n/** 将 NapCat segment 中可识别的媒体映射为 Chat SDK attachments。 */\nexport function toAttachments(message: QQMessageSegment[]): Attachment[] {\n  return message\n    .map((segment) => {\n      if (segment.type === 'image') {\n        return {\n          type: 'image' as const,\n          url: 'url' in segment.data ? segment.data.url : undefined\n        };\n      }\n\n      if (segment.type === 'file') {\n        return {\n          type: 'file' as const,\n          name: segment.data.file\n        };\n      }\n\n      if (segment.type === 'video') {\n        return {\n          type: 'video' as const,\n          url: segment.data.url,\n          name: segment.data.file\n        };\n      }\n\n      if (segment.type === 'record') {\n        return {\n          type: 'audio' as const,\n          name: segment.data.file\n        };\n      }\n\n      return null;\n    })\n    .filter((attachment): attachment is NonNullable<typeof attachment> => attachment !== null);\n}\n\n/** 将单个 NapCat segment 转为可读文本片段。 */\nexport function segmentToText(segment: QQMessageSegment): string {\n  if (segment.type === 'text') {\n    return segment.data.text;\n  }\n\n  if (segment.type === 'at') {\n    return segment.data.qq === 'all' ? '@all' : `@${segment.data.qq}`;\n  }\n\n  if (segment.type === 'face') {\n    return `[face:${segment.data.id}]`;\n  }\n\n  if (segment.type === 'image') {\n    return '[image]';\n  }\n\n  if (segment.type === 'file') {\n    return `[file:${segment.data.file}]`;\n  }\n\n  if (segment.type === 'record') {\n    return '[audio]';\n  }\n\n  if (segment.type === 'video') {\n    return '[video]';\n  }\n\n  if (segment.type === 'markdown') {\n    return segment.data.content;\n  }\n\n  return '';\n}\n","import {\n  type Adapter,\n  type AdapterPostableMessage,\n  type ChatInstance,\n  type EmojiValue,\n  type FetchOptions,\n  type FetchResult,\n  type FormattedContent,\n  type Logger,\n  type RawMessage,\n  type ThreadInfo,\n  type WebhookOptions,\n  NotImplementedError,\n  Message\n} from 'chat';\nimport { ValidationError } from '@chat-adapter/shared';\nimport { NCWebsocket, Structs, type SendMessageSegment } from 'node-napcat-ts';\n\nimport type {\n  QQAdapterConfig,\n  QQGroupMessage,\n  QQNapcatClient,\n  QQPrivateMessage,\n  QQRawMessage,\n  QQThreadId\n} from './types.js';\n\nimport { QQFormatConverter } from './format-converter.js';\nimport {\n  extractText,\n  isMention,\n  isSelfMessage,\n  toAttachments,\n  toAuthor,\n  toNumberId,\n  toThreadId\n} from './utils.js';\n\n/**\n * Chat SDK QQ 平台适配器（基于 NapCat WebSocket）。\n *\n * 设计说明：\n * - 入口仅支持 WS 事件推送，不支持 HTTP webhook。\n * - thread 模型采用“会话即 thread”：\n *   - 群：`qq:group:{group_id}`\n *   - 私聊：`qq:private:{user_id}`\n */\nexport class QQAdapter implements Adapter<QQThreadId, QQRawMessage> {\n  /** 适配器名称，作为 Chat SDK 的 adapter key。 */\n  readonly name = 'qq';\n\n  /** 机器人用户名（初始化后由登录信息填充）。 */\n  userName: string;\n\n  /** 机器人用户标识（初始化后由登录信息填充）。 */\n  botUserId?: string;\n\n  // ---\n\n  private readonly config: QQAdapterConfig;\n\n  private readonly converter = new QQFormatConverter();\n\n  private chat: ChatInstance | null = null;\n\n  private client?: QQNapcatClient;\n\n  private selfId?: string;\n\n  private logger: Logger;\n\n  private listenersBound = false;\n\n  private initializing?: Promise<void>;\n\n  /** 创建 QQ 适配器实例（不发起连接）。 */\n  public constructor(config: QQAdapterConfig) {\n    this.config = config;\n    this.userName = '';\n    this.logger = config.logger ?? {\n      child: () => this.logger,\n      debug: () => {},\n      info: () => {},\n      warn: () => {},\n      error: () => {}\n    };\n  }\n\n  /**\n   * 初始化适配器，建立 NapCat 连接并注册消息监听。\n   * 该方法具有幂等性，多次调用会复用同一初始化流程。\n   */\n  public async initialize(chat: ChatInstance): Promise<void> {\n    if (this.initializing) {\n      return this.initializing;\n    }\n\n    this.initializing = this.doInitialize(chat).catch((error) => {\n      this.initializing = undefined;\n      throw error;\n    });\n\n    return this.initializing;\n  }\n\n  private async doInitialize(chat: ChatInstance): Promise<void> {\n    this.chat = chat;\n    this.logger = this.config.logger ?? chat.getLogger(this.name);\n\n    if (!this.client) {\n      this.client = new NCWebsocket(this.config.napcat, this.config.debug ?? false);\n    }\n\n    this.bindListeners();\n\n    await this.client.connect();\n\n    const login = await this.client.get_login_info();\n    this.logger.info('login with', login);\n\n    this.selfId = String(login.user_id);\n    this.botUserId = login.nickname;\n    this.userName = login.nickname;\n  }\n\n  /** QQ 适配器为 WS-only 模式，HTTP webhook 入口固定返回 501。 */\n  public async handleWebhook(_request: Request, _options?: WebhookOptions): Promise<Response> {\n    return new Response('QQ adapter uses NapCat WebSocket ingress only.', {\n      status: 501\n    });\n  }\n\n  /** 编码 thread ID：`qq:{chatType}:{peerId}`。 */\n  public encodeThreadId(data: QQThreadId): string {\n    if (data.chatType !== 'group' && data.chatType !== 'private') {\n      throw new ValidationError('qq', `Unsupported QQ chat type: ${data.chatType}`);\n    }\n\n    if (!data.peerId) {\n      throw new ValidationError('qq', 'QQ thread peerId is required');\n    }\n\n    return `qq:${data.chatType}:${data.peerId}`;\n  }\n\n  /** 解码 thread ID 并进行格式校验。 */\n  public decodeThreadId(threadId: string): QQThreadId {\n    const parts = threadId.split(':');\n    if (parts.length !== 3 || parts[0] !== 'qq') {\n      throw new ValidationError('qq', `Invalid QQ thread ID: ${threadId}`);\n    }\n\n    const chatType = parts[1];\n    if (chatType !== 'group' && chatType !== 'private') {\n      throw new ValidationError('qq', `Invalid QQ thread type in thread ID: ${threadId}`);\n    }\n\n    const peerId = parts[2];\n    if (!peerId) {\n      throw new ValidationError('qq', `Invalid QQ thread peer ID in thread ID: ${threadId}`);\n    }\n\n    return {\n      chatType,\n      peerId\n    };\n  }\n\n  /** 当前模型下 channelId 与 threadId 一致。 */\n  public channelIdFromThreadId(threadId: string): string {\n    this.decodeThreadId(threadId);\n    return threadId;\n  }\n\n  /** 判断当前 thread 是否为私聊会话。 */\n  public isDM(threadId: string): boolean {\n    return this.decodeThreadId(threadId).chatType === 'private';\n  }\n\n  /** 向群或私聊发送消息。 */\n  public async postMessage(\n    threadId: string,\n    message: AdapterPostableMessage\n  ): Promise<RawMessage<QQRawMessage>> {\n    const client = this.requireClient();\n    const parsed = this.decodeThreadId(threadId);\n    const peerId = toNumberId(parsed.peerId, 'peerId');\n    const text = this.converter.renderPostable(message);\n    const outgoingText = text.length > 0 ? text : ' ';\n    const segments: SendMessageSegment[] = [Structs.text(outgoingText)];\n\n    this.logger.debug('post message', parsed.chatType, parsed.peerId, segments);\n\n    const sent =\n      parsed.chatType === 'group'\n        ? await client.send_group_msg({\n            group_id: peerId,\n            message: segments\n          })\n        : await client.send_private_msg({\n            user_id: peerId,\n            message: segments\n          });\n\n    return {\n      id: String(sent.message_id),\n      raw: {\n        ...sent,\n        threadId,\n        chatType: parsed.chatType\n      } as unknown as QQRawMessage,\n      threadId\n    };\n  }\n\n  /** QQ 暂不支持编辑消息。 */\n  public async editMessage(\n    _threadId: string,\n    _messageId: string,\n    _message: AdapterPostableMessage\n  ): Promise<RawMessage<QQRawMessage>> {\n    throw new NotImplementedError('QQ adapter does not support editMessage yet', 'editMessage');\n  }\n\n  /** 删除指定消息。 */\n  public async deleteMessage(_threadId: string, messageId: string): Promise<void> {\n    const client = this.requireClient();\n    await client.delete_msg({ message_id: toNumberId(messageId, 'messageId') });\n  }\n\n  /** QQ 暂不支持反应能力（添加）。 */\n  public async addReaction(\n    _threadId: string,\n    _messageId: string,\n    _emoji: EmojiValue | string\n  ): Promise<void> {\n    throw new NotImplementedError('QQ adapter does not support addReaction yet', 'addReaction');\n  }\n\n  /** QQ 暂不支持反应能力（移除）。 */\n  public async removeReaction(\n    _threadId: string,\n    _messageId: string,\n    _emoji: EmojiValue | string\n  ): Promise<void> {\n    throw new NotImplementedError(\n      'QQ adapter does not support removeReaction yet',\n      'removeReaction'\n    );\n  }\n\n  /** QQ 暂不支持历史消息分页拉取。 */\n  public async fetchMessages(\n    _threadId: string,\n    _options?: FetchOptions\n  ): Promise<FetchResult<QQRawMessage>> {\n    throw new NotImplementedError('QQ adapter does not support fetchMessages yet', 'fetchMessages');\n  }\n\n  /** 获取 thread 基础信息。 */\n  public async fetchThread(threadId: string): Promise<ThreadInfo> {\n    const parsed = this.decodeThreadId(threadId);\n\n    return {\n      id: threadId,\n      channelId: threadId,\n      isDM: parsed.chatType === 'private',\n      metadata: {\n        chatType: parsed.chatType,\n        peerId: parsed.peerId\n      }\n    };\n  }\n\n  /** 当前实现不发送真实 typing，仅作为 no-op。 */\n  public startTyping(_threadId: string, _status?: string): Promise<void> {\n    return Promise.resolve();\n  }\n\n  /** 渲染格式化内容到 QQ 文本。 */\n  public renderFormatted(content: FormattedContent): string {\n    return this.converter.fromAst(content);\n  }\n\n  /** 将 NapCat 原始消息转换为 Chat SDK 标准 Message。 */\n  public parseMessage(raw: QQRawMessage): Message<QQRawMessage> {\n    const threadId = this.encodeThreadId(toThreadId(raw));\n    const text = extractText(raw);\n    const isMe = this.selfId !== undefined && String(raw.user_id) === this.selfId;\n\n    return new Message<QQRawMessage>({\n      id: String(raw.message_id),\n      threadId,\n      text,\n      formatted: this.converter.toAst(text),\n      author: toAuthor(raw, isMe),\n      metadata: {\n        dateSent: new Date(raw.time * 1000),\n        edited: false\n      },\n      attachments: toAttachments(raw.message),\n      raw\n    });\n  }\n\n  private bindListeners(): void {\n    if (!this.client || this.listenersBound) {\n      return;\n    }\n\n    this.client.on('message.group', this.onGroupMessage);\n    this.client.on('message.private', this.onPrivateMessage);\n    this.listenersBound = true;\n  }\n\n  private readonly onGroupMessage = (raw: QQGroupMessage): void => {\n    this.dispatchIncomingMessage(raw);\n  };\n\n  private readonly onPrivateMessage = (raw: QQPrivateMessage): void => {\n    this.dispatchIncomingMessage(raw);\n  };\n\n  /**\n   * 统一处理入站消息：\n   * - 过滤 bot 自己发送的消息\n   * - 计算 threadId 与 mention\n   * - 交给 Chat SDK `processMessage` 进入标准事件流\n   */\n  private dispatchIncomingMessage(raw: QQRawMessage): void {\n    if (!this.chat) {\n      return;\n    }\n\n    if (isSelfMessage(raw, this.selfId)) {\n      return;\n    }\n\n    const threadId = this.encodeThreadId(toThreadId(raw));\n    const mention = isMention(raw, this.selfId);\n\n    this.chat.processMessage(this, threadId, async () => {\n      const message = this.parseMessage(raw);\n      message.isMention = mention;\n      return message;\n    });\n  }\n\n  /** 获取已初始化的 NapCat 客户端，否则抛出配置错误。 */\n  private requireClient(): QQNapcatClient {\n    if (!this.client) {\n      throw new ValidationError(\n        'qq',\n        'QQ adapter is not initialized. Attach it to Chat and call chat.initialize() first.'\n      );\n    }\n\n    return this.client;\n  }\n}\n","import { ValidationError } from '@chat-adapter/shared';\n\nimport type { QQAdapterConfig } from './types.js';\n\nimport { QQAdapter } from './adapter.js';\n\n/**\n * 创建 QQ 适配器实例。\n * 仅支持显式配置，不读取环境变量。\n *\n * @param config QQ 适配器配置\n * @returns 已创建但未初始化的 QQAdapter 实例\n */\nexport function createQQAdapter(config: QQAdapterConfig): QQAdapter {\n  if (!config || !config.napcat) {\n    throw new ValidationError(\n      'qq',\n      'QQ NapCat config is required. Pass { napcat: NCWebsocketOptions } to createQQAdapter(config).'\n    );\n  }\n\n  return new QQAdapter(config);\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,4 +1,127 @@
-//#region src/index.d.ts
-declare function hello(): string;
+import { Adapter, AdapterPostableMessage, ChatInstance, EmojiValue, FetchOptions, FetchResult, FormattedContent, Logger, Message, RawMessage, ThreadInfo, WebhookOptions } from "chat";
+import { MessageHandler, NCWebsocket, NCWebsocketOptions } from "node-napcat-ts";
+
+//#region src/types.d.ts
+/**
+ * QQ 会话类型。
+ * - `group`: 群会话
+ * - `private`: 私聊会话
+ */
+type QQChatType = 'group' | 'private';
+/**
+ * QQ thread ID 的解码结构。
+ * 对应编码格式：`qq:{chatType}:{peerId}`。
+ */
+interface QQThreadId {
+  /** 会话类型（群/私聊） */
+  chatType: QQChatType;
+  /** 对端 ID：群号或用户 QQ 号（字符串形式） */
+  peerId: string;
+}
+/** NapCat WebSocket 客户端类型别名。 */
+type QQNapcatClient = NCWebsocket;
+/** QQ 适配器统一使用的原始消息类型（message union）。 */
+type QQRawMessage = MessageHandler['message'];
+/** QQ 群消息原始类型。 */
+type QQGroupMessage = MessageHandler['message.group'];
+/** QQ 私聊消息原始类型。 */
+type QQPrivateMessage = MessageHandler['message.private'];
+/** QQ 适配器配置。 */
+interface QQAdapterConfig {
+  /** NapCat 连接配置（必填）。 */
+  napcat: NCWebsocketOptions;
+  /** 是否启用 NapCat SDK 的 debug 输出。 */
+  debug?: boolean;
+  /** 自定义 logger；未传时使用 Chat SDK 提供的 logger。 */
+  logger?: Logger;
+}
 //#endregion
-export { hello };
+//#region src/adapter.d.ts
+/**
+ * Chat SDK QQ 平台适配器（基于 NapCat WebSocket）。
+ *
+ * 设计说明：
+ * - 入口仅支持 WS 事件推送，不支持 HTTP webhook。
+ * - thread 模型采用“会话即 thread”：
+ *   - 群：`qq:group:{group_id}`
+ *   - 私聊：`qq:private:{user_id}`
+ */
+declare class QQAdapter implements Adapter<QQThreadId, QQRawMessage> {
+  /** 适配器名称，作为 Chat SDK 的 adapter key。 */
+  readonly name = "qq";
+  /** 机器人用户名（初始化后由登录信息填充）。 */
+  userName: string;
+  /** 机器人用户标识（初始化后由登录信息填充）。 */
+  botUserId?: string;
+  private readonly config;
+  private readonly converter;
+  private chat;
+  private client?;
+  private selfId?;
+  private logger;
+  private listenersBound;
+  private initializing?;
+  /** 创建 QQ 适配器实例（不发起连接）。 */
+  constructor(config: QQAdapterConfig);
+  /**
+   * 初始化适配器，建立 NapCat 连接并注册消息监听。
+   * 该方法具有幂等性，多次调用会复用同一初始化流程。
+   */
+  initialize(chat: ChatInstance): Promise<void>;
+  private doInitialize;
+  /** QQ 适配器为 WS-only 模式，HTTP webhook 入口固定返回 501。 */
+  handleWebhook(_request: Request, _options?: WebhookOptions): Promise<Response>;
+  /** 编码 thread ID：`qq:{chatType}:{peerId}`。 */
+  encodeThreadId(data: QQThreadId): string;
+  /** 解码 thread ID 并进行格式校验。 */
+  decodeThreadId(threadId: string): QQThreadId;
+  /** 当前模型下 channelId 与 threadId 一致。 */
+  channelIdFromThreadId(threadId: string): string;
+  /** 判断当前 thread 是否为私聊会话。 */
+  isDM(threadId: string): boolean;
+  /** 向群或私聊发送消息。 */
+  postMessage(threadId: string, message: AdapterPostableMessage): Promise<RawMessage<QQRawMessage>>;
+  /** QQ 暂不支持编辑消息。 */
+  editMessage(_threadId: string, _messageId: string, _message: AdapterPostableMessage): Promise<RawMessage<QQRawMessage>>;
+  /** 删除指定消息。 */
+  deleteMessage(_threadId: string, messageId: string): Promise<void>;
+  /** QQ 暂不支持反应能力（添加）。 */
+  addReaction(_threadId: string, _messageId: string, _emoji: EmojiValue | string): Promise<void>;
+  /** QQ 暂不支持反应能力（移除）。 */
+  removeReaction(_threadId: string, _messageId: string, _emoji: EmojiValue | string): Promise<void>;
+  /** QQ 暂不支持历史消息分页拉取。 */
+  fetchMessages(_threadId: string, _options?: FetchOptions): Promise<FetchResult<QQRawMessage>>;
+  /** 获取 thread 基础信息。 */
+  fetchThread(threadId: string): Promise<ThreadInfo>;
+  /** 当前实现不发送真实 typing，仅作为 no-op。 */
+  startTyping(_threadId: string, _status?: string): Promise<void>;
+  /** 渲染格式化内容到 QQ 文本。 */
+  renderFormatted(content: FormattedContent): string;
+  /** 将 NapCat 原始消息转换为 Chat SDK 标准 Message。 */
+  parseMessage(raw: QQRawMessage): Message<QQRawMessage>;
+  private bindListeners;
+  private readonly onGroupMessage;
+  private readonly onPrivateMessage;
+  /**
+   * 统一处理入站消息：
+   * - 过滤 bot 自己发送的消息
+   * - 计算 threadId 与 mention
+   * - 交给 Chat SDK `processMessage` 进入标准事件流
+   */
+  private dispatchIncomingMessage;
+  /** 获取已初始化的 NapCat 客户端，否则抛出配置错误。 */
+  private requireClient;
+}
+//#endregion
+//#region src/factory.d.ts
+/**
+ * 创建 QQ 适配器实例。
+ * 仅支持显式配置，不读取环境变量。
+ *
+ * @param config QQ 适配器配置
+ * @returns 已创建但未初始化的 QQAdapter 实例
+ */
+declare function createQQAdapter(config: QQAdapterConfig): QQAdapter;
+//#endregion
+export { QQAdapter, type QQAdapterConfig, type QQChatType, type QQGroupMessage, type QQNapcatClient, type QQPrivateMessage, type QQRawMessage, type QQThreadId, createQQAdapter };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,4 +1,127 @@
-//#region src/index.d.ts
-declare function hello(): string;
+import { Adapter, AdapterPostableMessage, ChatInstance, EmojiValue, FetchOptions, FetchResult, FormattedContent, Logger, Message, RawMessage, ThreadInfo, WebhookOptions } from "chat";
+import { MessageHandler, NCWebsocket, NCWebsocketOptions } from "node-napcat-ts";
+
+//#region src/types.d.ts
+/**
+ * QQ 会话类型。
+ * - `group`: 群会话
+ * - `private`: 私聊会话
+ */
+type QQChatType = 'group' | 'private';
+/**
+ * QQ thread ID 的解码结构。
+ * 对应编码格式：`qq:{chatType}:{peerId}`。
+ */
+interface QQThreadId {
+  /** 会话类型（群/私聊） */
+  chatType: QQChatType;
+  /** 对端 ID：群号或用户 QQ 号（字符串形式） */
+  peerId: string;
+}
+/** NapCat WebSocket 客户端类型别名。 */
+type QQNapcatClient = NCWebsocket;
+/** QQ 适配器统一使用的原始消息类型（message union）。 */
+type QQRawMessage = MessageHandler['message'];
+/** QQ 群消息原始类型。 */
+type QQGroupMessage = MessageHandler['message.group'];
+/** QQ 私聊消息原始类型。 */
+type QQPrivateMessage = MessageHandler['message.private'];
+/** QQ 适配器配置。 */
+interface QQAdapterConfig {
+  /** NapCat 连接配置（必填）。 */
+  napcat: NCWebsocketOptions;
+  /** 是否启用 NapCat SDK 的 debug 输出。 */
+  debug?: boolean;
+  /** 自定义 logger；未传时使用 Chat SDK 提供的 logger。 */
+  logger?: Logger;
+}
 //#endregion
-export { hello };
+//#region src/adapter.d.ts
+/**
+ * Chat SDK QQ 平台适配器（基于 NapCat WebSocket）。
+ *
+ * 设计说明：
+ * - 入口仅支持 WS 事件推送，不支持 HTTP webhook。
+ * - thread 模型采用“会话即 thread”：
+ *   - 群：`qq:group:{group_id}`
+ *   - 私聊：`qq:private:{user_id}`
+ */
+declare class QQAdapter implements Adapter<QQThreadId, QQRawMessage> {
+  /** 适配器名称，作为 Chat SDK 的 adapter key。 */
+  readonly name = "qq";
+  /** 机器人用户名（初始化后由登录信息填充）。 */
+  userName: string;
+  /** 机器人用户标识（初始化后由登录信息填充）。 */
+  botUserId?: string;
+  private readonly config;
+  private readonly converter;
+  private chat;
+  private client?;
+  private selfId?;
+  private logger;
+  private listenersBound;
+  private initializing?;
+  /** 创建 QQ 适配器实例（不发起连接）。 */
+  constructor(config: QQAdapterConfig);
+  /**
+   * 初始化适配器，建立 NapCat 连接并注册消息监听。
+   * 该方法具有幂等性，多次调用会复用同一初始化流程。
+   */
+  initialize(chat: ChatInstance): Promise<void>;
+  private doInitialize;
+  /** QQ 适配器为 WS-only 模式，HTTP webhook 入口固定返回 501。 */
+  handleWebhook(_request: Request, _options?: WebhookOptions): Promise<Response>;
+  /** 编码 thread ID：`qq:{chatType}:{peerId}`。 */
+  encodeThreadId(data: QQThreadId): string;
+  /** 解码 thread ID 并进行格式校验。 */
+  decodeThreadId(threadId: string): QQThreadId;
+  /** 当前模型下 channelId 与 threadId 一致。 */
+  channelIdFromThreadId(threadId: string): string;
+  /** 判断当前 thread 是否为私聊会话。 */
+  isDM(threadId: string): boolean;
+  /** 向群或私聊发送消息。 */
+  postMessage(threadId: string, message: AdapterPostableMessage): Promise<RawMessage<QQRawMessage>>;
+  /** QQ 暂不支持编辑消息。 */
+  editMessage(_threadId: string, _messageId: string, _message: AdapterPostableMessage): Promise<RawMessage<QQRawMessage>>;
+  /** 删除指定消息。 */
+  deleteMessage(_threadId: string, messageId: string): Promise<void>;
+  /** QQ 暂不支持反应能力（添加）。 */
+  addReaction(_threadId: string, _messageId: string, _emoji: EmojiValue | string): Promise<void>;
+  /** QQ 暂不支持反应能力（移除）。 */
+  removeReaction(_threadId: string, _messageId: string, _emoji: EmojiValue | string): Promise<void>;
+  /** QQ 暂不支持历史消息分页拉取。 */
+  fetchMessages(_threadId: string, _options?: FetchOptions): Promise<FetchResult<QQRawMessage>>;
+  /** 获取 thread 基础信息。 */
+  fetchThread(threadId: string): Promise<ThreadInfo>;
+  /** 当前实现不发送真实 typing，仅作为 no-op。 */
+  startTyping(_threadId: string, _status?: string): Promise<void>;
+  /** 渲染格式化内容到 QQ 文本。 */
+  renderFormatted(content: FormattedContent): string;
+  /** 将 NapCat 原始消息转换为 Chat SDK 标准 Message。 */
+  parseMessage(raw: QQRawMessage): Message<QQRawMessage>;
+  private bindListeners;
+  private readonly onGroupMessage;
+  private readonly onPrivateMessage;
+  /**
+   * 统一处理入站消息：
+   * - 过滤 bot 自己发送的消息
+   * - 计算 threadId 与 mention
+   * - 交给 Chat SDK `processMessage` 进入标准事件流
+   */
+  private dispatchIncomingMessage;
+  /** 获取已初始化的 NapCat 客户端，否则抛出配置错误。 */
+  private requireClient;
+}
+//#endregion
+//#region src/factory.d.ts
+/**
+ * 创建 QQ 适配器实例。
+ * 仅支持显式配置，不读取环境变量。
+ *
+ * @param config QQ 适配器配置
+ * @returns 已创建但未初始化的 QQAdapter 实例
+ */
+declare function createQQAdapter(config: QQAdapterConfig): QQAdapter;
+//#endregion
+export { QQAdapter, type QQAdapterConfig, type QQChatType, type QQGroupMessage, type QQNapcatClient, type QQPrivateMessage, type QQRawMessage, type QQThreadId, createQQAdapter };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,6 +1,328 @@
-//#region src/index.ts
-function hello() {
-	return "world";
+import { BaseFormatConverter, Message, NotImplementedError, parseMarkdown, stringifyMarkdown, toPlainText } from "chat";
+import { ValidationError } from "@chat-adapter/shared";
+import { NCWebsocket, Structs } from "node-napcat-ts";
+//#region src/format-converter.ts
+/**
+* @todo
+*/
+var QQFormatConverter = class extends BaseFormatConverter {
+	toAst(platformText) {
+		return parseMarkdown(platformText);
+	}
+	fromAst(ast) {
+		return stringifyMarkdown(ast);
+	}
+};
+//#endregion
+//#region src/utils.ts
+/** 将字符串 ID 转为正整数，失败时抛出 ValidationError。 */
+function toNumberId(value, fieldName) {
+	const num = Number(value);
+	if (!Number.isInteger(num) || num <= 0) throw new ValidationError("qq", `QQ ${fieldName} must be a positive integer: ${value}`);
+	return num;
+}
+/** 判断消息是否由 bot 自己发送（用于避免回环处理）。 */
+function isSelfMessage(raw, selfId) {
+	if (!selfId) return false;
+	return String(raw.user_id) === selfId;
+}
+/** 判断消息是否命中 mention 语义。 */
+function isMention(raw, selfId) {
+	if (raw.message_type === "private") return true;
+	if (!selfId) return false;
+	return raw.message.some((segment) => segment.type === "at" && segment.data.qq !== "all" && String(segment.data.qq) === selfId);
+}
+/** 将 QQ 原始消息映射为统一的 QQ thread ID 结构。 */
+function toThreadId(raw) {
+	if (raw.message_type === "group") return {
+		chatType: "group",
+		peerId: String(raw.group_id)
+	};
+	return {
+		chatType: "private",
+		peerId: String(raw.user_id)
+	};
+}
+/** 将 QQ 原始作者信息映射为 Chat SDK Author。 */
+function toAuthor(raw, isMe) {
+	return {
+		userId: String(raw.user_id),
+		userName: String(raw.user_id),
+		fullName: raw.sender.card || raw.sender.nickname || String(raw.user_id),
+		isBot: isMe,
+		isMe
+	};
+}
+/** 从 NapCat segment 列表提取纯文本；必要时回退 raw_message。 */
+function extractText(raw) {
+	const text = raw.message.map(segmentToText).join("");
+	if (text.length > 0) return text;
+	return raw.raw_message ? toPlainText(parseMarkdown(raw.raw_message)) : "";
+}
+/** 将 NapCat segment 中可识别的媒体映射为 Chat SDK attachments。 */
+function toAttachments(message) {
+	return message.map((segment) => {
+		if (segment.type === "image") return {
+			type: "image",
+			url: "url" in segment.data ? segment.data.url : void 0
+		};
+		if (segment.type === "file") return {
+			type: "file",
+			name: segment.data.file
+		};
+		if (segment.type === "video") return {
+			type: "video",
+			url: segment.data.url,
+			name: segment.data.file
+		};
+		if (segment.type === "record") return {
+			type: "audio",
+			name: segment.data.file
+		};
+		return null;
+	}).filter((attachment) => attachment !== null);
+}
+/** 将单个 NapCat segment 转为可读文本片段。 */
+function segmentToText(segment) {
+	if (segment.type === "text") return segment.data.text;
+	if (segment.type === "at") return segment.data.qq === "all" ? "@all" : `@${segment.data.qq}`;
+	if (segment.type === "face") return `[face:${segment.data.id}]`;
+	if (segment.type === "image") return "[image]";
+	if (segment.type === "file") return `[file:${segment.data.file}]`;
+	if (segment.type === "record") return "[audio]";
+	if (segment.type === "video") return "[video]";
+	if (segment.type === "markdown") return segment.data.content;
+	return "";
+}
+//#endregion
+//#region src/adapter.ts
+/**
+* Chat SDK QQ 平台适配器（基于 NapCat WebSocket）。
+*
+* 设计说明：
+* - 入口仅支持 WS 事件推送，不支持 HTTP webhook。
+* - thread 模型采用“会话即 thread”：
+*   - 群：`qq:group:{group_id}`
+*   - 私聊：`qq:private:{user_id}`
+*/
+var QQAdapter = class {
+	/** 适配器名称，作为 Chat SDK 的 adapter key。 */
+	name = "qq";
+	/** 机器人用户名（初始化后由登录信息填充）。 */
+	userName;
+	/** 机器人用户标识（初始化后由登录信息填充）。 */
+	botUserId;
+	config;
+	converter = new QQFormatConverter();
+	chat = null;
+	client;
+	selfId;
+	logger;
+	listenersBound = false;
+	initializing;
+	/** 创建 QQ 适配器实例（不发起连接）。 */
+	constructor(config) {
+		this.config = config;
+		this.userName = "";
+		this.logger = config.logger ?? {
+			child: () => this.logger,
+			debug: () => {},
+			info: () => {},
+			warn: () => {},
+			error: () => {}
+		};
+	}
+	/**
+	* 初始化适配器，建立 NapCat 连接并注册消息监听。
+	* 该方法具有幂等性，多次调用会复用同一初始化流程。
+	*/
+	async initialize(chat) {
+		if (this.initializing) return this.initializing;
+		this.initializing = this.doInitialize(chat).catch((error) => {
+			this.initializing = void 0;
+			throw error;
+		});
+		return this.initializing;
+	}
+	async doInitialize(chat) {
+		this.chat = chat;
+		this.logger = this.config.logger ?? chat.getLogger(this.name);
+		if (!this.client) this.client = new NCWebsocket(this.config.napcat, this.config.debug ?? false);
+		this.bindListeners();
+		await this.client.connect();
+		const login = await this.client.get_login_info();
+		this.logger.info("login with", login);
+		this.selfId = String(login.user_id);
+		this.botUserId = login.nickname;
+		this.userName = login.nickname;
+	}
+	/** QQ 适配器为 WS-only 模式，HTTP webhook 入口固定返回 501。 */
+	async handleWebhook(_request, _options) {
+		return new Response("QQ adapter uses NapCat WebSocket ingress only.", { status: 501 });
+	}
+	/** 编码 thread ID：`qq:{chatType}:{peerId}`。 */
+	encodeThreadId(data) {
+		if (data.chatType !== "group" && data.chatType !== "private") throw new ValidationError("qq", `Unsupported QQ chat type: ${data.chatType}`);
+		if (!data.peerId) throw new ValidationError("qq", "QQ thread peerId is required");
+		return `qq:${data.chatType}:${data.peerId}`;
+	}
+	/** 解码 thread ID 并进行格式校验。 */
+	decodeThreadId(threadId) {
+		const parts = threadId.split(":");
+		if (parts.length !== 3 || parts[0] !== "qq") throw new ValidationError("qq", `Invalid QQ thread ID: ${threadId}`);
+		const chatType = parts[1];
+		if (chatType !== "group" && chatType !== "private") throw new ValidationError("qq", `Invalid QQ thread type in thread ID: ${threadId}`);
+		const peerId = parts[2];
+		if (!peerId) throw new ValidationError("qq", `Invalid QQ thread peer ID in thread ID: ${threadId}`);
+		return {
+			chatType,
+			peerId
+		};
+	}
+	/** 当前模型下 channelId 与 threadId 一致。 */
+	channelIdFromThreadId(threadId) {
+		this.decodeThreadId(threadId);
+		return threadId;
+	}
+	/** 判断当前 thread 是否为私聊会话。 */
+	isDM(threadId) {
+		return this.decodeThreadId(threadId).chatType === "private";
+	}
+	/** 向群或私聊发送消息。 */
+	async postMessage(threadId, message) {
+		const client = this.requireClient();
+		const parsed = this.decodeThreadId(threadId);
+		const peerId = toNumberId(parsed.peerId, "peerId");
+		const text = this.converter.renderPostable(message);
+		const outgoingText = text.length > 0 ? text : " ";
+		const segments = [Structs.text(outgoingText)];
+		this.logger.debug("post message", parsed.chatType, parsed.peerId, segments);
+		const sent = parsed.chatType === "group" ? await client.send_group_msg({
+			group_id: peerId,
+			message: segments
+		}) : await client.send_private_msg({
+			user_id: peerId,
+			message: segments
+		});
+		return {
+			id: String(sent.message_id),
+			raw: {
+				...sent,
+				threadId,
+				chatType: parsed.chatType
+			},
+			threadId
+		};
+	}
+	/** QQ 暂不支持编辑消息。 */
+	async editMessage(_threadId, _messageId, _message) {
+		throw new NotImplementedError("QQ adapter does not support editMessage yet", "editMessage");
+	}
+	/** 删除指定消息。 */
+	async deleteMessage(_threadId, messageId) {
+		await this.requireClient().delete_msg({ message_id: toNumberId(messageId, "messageId") });
+	}
+	/** QQ 暂不支持反应能力（添加）。 */
+	async addReaction(_threadId, _messageId, _emoji) {
+		throw new NotImplementedError("QQ adapter does not support addReaction yet", "addReaction");
+	}
+	/** QQ 暂不支持反应能力（移除）。 */
+	async removeReaction(_threadId, _messageId, _emoji) {
+		throw new NotImplementedError("QQ adapter does not support removeReaction yet", "removeReaction");
+	}
+	/** QQ 暂不支持历史消息分页拉取。 */
+	async fetchMessages(_threadId, _options) {
+		throw new NotImplementedError("QQ adapter does not support fetchMessages yet", "fetchMessages");
+	}
+	/** 获取 thread 基础信息。 */
+	async fetchThread(threadId) {
+		const parsed = this.decodeThreadId(threadId);
+		return {
+			id: threadId,
+			channelId: threadId,
+			isDM: parsed.chatType === "private",
+			metadata: {
+				chatType: parsed.chatType,
+				peerId: parsed.peerId
+			}
+		};
+	}
+	/** 当前实现不发送真实 typing，仅作为 no-op。 */
+	startTyping(_threadId, _status) {
+		return Promise.resolve();
+	}
+	/** 渲染格式化内容到 QQ 文本。 */
+	renderFormatted(content) {
+		return this.converter.fromAst(content);
+	}
+	/** 将 NapCat 原始消息转换为 Chat SDK 标准 Message。 */
+	parseMessage(raw) {
+		const threadId = this.encodeThreadId(toThreadId(raw));
+		const text = extractText(raw);
+		const isMe = this.selfId !== void 0 && String(raw.user_id) === this.selfId;
+		return new Message({
+			id: String(raw.message_id),
+			threadId,
+			text,
+			formatted: this.converter.toAst(text),
+			author: toAuthor(raw, isMe),
+			metadata: {
+				dateSent: /* @__PURE__ */ new Date(raw.time * 1e3),
+				edited: false
+			},
+			attachments: toAttachments(raw.message),
+			raw
+		});
+	}
+	bindListeners() {
+		if (!this.client || this.listenersBound) return;
+		this.client.on("message.group", this.onGroupMessage);
+		this.client.on("message.private", this.onPrivateMessage);
+		this.listenersBound = true;
+	}
+	onGroupMessage = (raw) => {
+		this.dispatchIncomingMessage(raw);
+	};
+	onPrivateMessage = (raw) => {
+		this.dispatchIncomingMessage(raw);
+	};
+	/**
+	* 统一处理入站消息：
+	* - 过滤 bot 自己发送的消息
+	* - 计算 threadId 与 mention
+	* - 交给 Chat SDK `processMessage` 进入标准事件流
+	*/
+	dispatchIncomingMessage(raw) {
+		if (!this.chat) return;
+		if (isSelfMessage(raw, this.selfId)) return;
+		const threadId = this.encodeThreadId(toThreadId(raw));
+		const mention = isMention(raw, this.selfId);
+		this.chat.processMessage(this, threadId, async () => {
+			const message = this.parseMessage(raw);
+			message.isMention = mention;
+			return message;
+		});
+	}
+	/** 获取已初始化的 NapCat 客户端，否则抛出配置错误。 */
+	requireClient() {
+		if (!this.client) throw new ValidationError("qq", "QQ adapter is not initialized. Attach it to Chat and call chat.initialize() first.");
+		return this.client;
+	}
+};
+//#endregion
+//#region src/factory.ts
+/**
+* 创建 QQ 适配器实例。
+* 仅支持显式配置，不读取环境变量。
+*
+* @param config QQ 适配器配置
+* @returns 已创建但未初始化的 QQAdapter 实例
+*/
+function createQQAdapter(config) {
+	if (!config || !config.napcat) throw new ValidationError("qq", "QQ NapCat config is required. Pass { napcat: NCWebsocketOptions } to createQQAdapter(config).");
+	return new QQAdapter(config);
 }
 //#endregion
-export { hello };
+export { QQAdapter, createQQAdapter };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/format-converter.ts","../src/utils.ts","../src/adapter.ts","../src/factory.ts"],"sourcesContent":["import { BaseFormatConverter, parseMarkdown, stringifyMarkdown, type Root } from 'chat';\n\n/**\n * @todo\n */\nexport class QQFormatConverter extends BaseFormatConverter {\n  toAst(platformText: string): Root {\n    return parseMarkdown(platformText);\n  }\n\n  fromAst(ast: Root): string {\n    return stringifyMarkdown(ast);\n  }\n}\n","import type { Receive } from 'node-napcat-ts';\n\nimport { ValidationError } from '@chat-adapter/shared';\nimport { parseMarkdown, toPlainText, type Attachment, type Author } from 'chat';\n\nimport type { QQRawMessage, QQThreadId } from './types.js';\n\n/** NapCat 入站 message segment 的联合类型。 */\nexport type QQMessageSegment = Receive[keyof Receive];\n\n/** 将字符串 ID 转为正整数，失败时抛出 ValidationError。 */\nexport function toNumberId(value: string, fieldName: string): number {\n  const num = Number(value);\n  if (!Number.isInteger(num) || num <= 0) {\n    throw new ValidationError('qq', `QQ ${fieldName} must be a positive integer: ${value}`);\n  }\n  return num;\n}\n\n/** 判断消息是否由 bot 自己发送（用于避免回环处理）。 */\nexport function isSelfMessage(raw: QQRawMessage, selfId?: string): boolean {\n  if (!selfId) {\n    return false;\n  }\n\n  return String(raw.user_id) === selfId;\n}\n\n/** 判断消息是否命中 mention 语义。 */\nexport function isMention(raw: QQRawMessage, selfId?: string): boolean {\n  if (raw.message_type === 'private') {\n    return true;\n  }\n\n  if (!selfId) {\n    return false;\n  }\n\n  return raw.message.some(\n    (segment) =>\n      segment.type === 'at' && segment.data.qq !== 'all' && String(segment.data.qq) === selfId\n  );\n}\n\n/** 将 QQ 原始消息映射为统一的 QQ thread ID 结构。 */\nexport function toThreadId(raw: QQRawMessage): QQThreadId {\n  if (raw.message_type === 'group') {\n    return {\n      chatType: 'group',\n      peerId: String(raw.group_id)\n    };\n  }\n\n  return {\n    chatType: 'private',\n    peerId: String(raw.user_id)\n  };\n}\n\n/** 将 QQ 原始作者信息映射为 Chat SDK Author。 */\nexport function toAuthor(raw: QQRawMessage, isMe: boolean): Author {\n  return {\n    userId: String(raw.user_id),\n    userName: String(raw.user_id),\n    fullName: raw.sender.card || raw.sender.nickname || String(raw.user_id),\n    isBot: isMe,\n    isMe\n  };\n}\n\n/** 从 NapCat segment 列表提取纯文本；必要时回退 raw_message。 */\nexport function extractText(raw: QQRawMessage): string {\n  const text = raw.message.map(segmentToText).join('');\n  if (text.length > 0) {\n    return text;\n  }\n\n  return raw.raw_message ? toPlainText(parseMarkdown(raw.raw_message)) : '';\n}\n\n/** 将 NapCat segment 中可识别的媒体映射为 Chat SDK attachments。 */\nexport function toAttachments(message: QQMessageSegment[]): Attachment[] {\n  return message\n    .map((segment) => {\n      if (segment.type === 'image') {\n        return {\n          type: 'image' as const,\n          url: 'url' in segment.data ? segment.data.url : undefined\n        };\n      }\n\n      if (segment.type === 'file') {\n        return {\n          type: 'file' as const,\n          name: segment.data.file\n        };\n      }\n\n      if (segment.type === 'video') {\n        return {\n          type: 'video' as const,\n          url: segment.data.url,\n          name: segment.data.file\n        };\n      }\n\n      if (segment.type === 'record') {\n        return {\n          type: 'audio' as const,\n          name: segment.data.file\n        };\n      }\n\n      return null;\n    })\n    .filter((attachment): attachment is NonNullable<typeof attachment> => attachment !== null);\n}\n\n/** 将单个 NapCat segment 转为可读文本片段。 */\nexport function segmentToText(segment: QQMessageSegment): string {\n  if (segment.type === 'text') {\n    return segment.data.text;\n  }\n\n  if (segment.type === 'at') {\n    return segment.data.qq === 'all' ? '@all' : `@${segment.data.qq}`;\n  }\n\n  if (segment.type === 'face') {\n    return `[face:${segment.data.id}]`;\n  }\n\n  if (segment.type === 'image') {\n    return '[image]';\n  }\n\n  if (segment.type === 'file') {\n    return `[file:${segment.data.file}]`;\n  }\n\n  if (segment.type === 'record') {\n    return '[audio]';\n  }\n\n  if (segment.type === 'video') {\n    return '[video]';\n  }\n\n  if (segment.type === 'markdown') {\n    return segment.data.content;\n  }\n\n  return '';\n}\n","import {\n  type Adapter,\n  type AdapterPostableMessage,\n  type ChatInstance,\n  type EmojiValue,\n  type FetchOptions,\n  type FetchResult,\n  type FormattedContent,\n  type Logger,\n  type RawMessage,\n  type ThreadInfo,\n  type WebhookOptions,\n  NotImplementedError,\n  Message\n} from 'chat';\nimport { ValidationError } from '@chat-adapter/shared';\nimport { NCWebsocket, Structs, type SendMessageSegment } from 'node-napcat-ts';\n\nimport type {\n  QQAdapterConfig,\n  QQGroupMessage,\n  QQNapcatClient,\n  QQPrivateMessage,\n  QQRawMessage,\n  QQThreadId\n} from './types.js';\n\nimport { QQFormatConverter } from './format-converter.js';\nimport {\n  extractText,\n  isMention,\n  isSelfMessage,\n  toAttachments,\n  toAuthor,\n  toNumberId,\n  toThreadId\n} from './utils.js';\n\n/**\n * Chat SDK QQ 平台适配器（基于 NapCat WebSocket）。\n *\n * 设计说明：\n * - 入口仅支持 WS 事件推送，不支持 HTTP webhook。\n * - thread 模型采用“会话即 thread”：\n *   - 群：`qq:group:{group_id}`\n *   - 私聊：`qq:private:{user_id}`\n */\nexport class QQAdapter implements Adapter<QQThreadId, QQRawMessage> {\n  /** 适配器名称，作为 Chat SDK 的 adapter key。 */\n  readonly name = 'qq';\n\n  /** 机器人用户名（初始化后由登录信息填充）。 */\n  userName: string;\n\n  /** 机器人用户标识（初始化后由登录信息填充）。 */\n  botUserId?: string;\n\n  // ---\n\n  private readonly config: QQAdapterConfig;\n\n  private readonly converter = new QQFormatConverter();\n\n  private chat: ChatInstance | null = null;\n\n  private client?: QQNapcatClient;\n\n  private selfId?: string;\n\n  private logger: Logger;\n\n  private listenersBound = false;\n\n  private initializing?: Promise<void>;\n\n  /** 创建 QQ 适配器实例（不发起连接）。 */\n  public constructor(config: QQAdapterConfig) {\n    this.config = config;\n    this.userName = '';\n    this.logger = config.logger ?? {\n      child: () => this.logger,\n      debug: () => {},\n      info: () => {},\n      warn: () => {},\n      error: () => {}\n    };\n  }\n\n  /**\n   * 初始化适配器，建立 NapCat 连接并注册消息监听。\n   * 该方法具有幂等性，多次调用会复用同一初始化流程。\n   */\n  public async initialize(chat: ChatInstance): Promise<void> {\n    if (this.initializing) {\n      return this.initializing;\n    }\n\n    this.initializing = this.doInitialize(chat).catch((error) => {\n      this.initializing = undefined;\n      throw error;\n    });\n\n    return this.initializing;\n  }\n\n  private async doInitialize(chat: ChatInstance): Promise<void> {\n    this.chat = chat;\n    this.logger = this.config.logger ?? chat.getLogger(this.name);\n\n    if (!this.client) {\n      this.client = new NCWebsocket(this.config.napcat, this.config.debug ?? false);\n    }\n\n    this.bindListeners();\n\n    await this.client.connect();\n\n    const login = await this.client.get_login_info();\n    this.logger.info('login with', login);\n\n    this.selfId = String(login.user_id);\n    this.botUserId = login.nickname;\n    this.userName = login.nickname;\n  }\n\n  /** QQ 适配器为 WS-only 模式，HTTP webhook 入口固定返回 501。 */\n  public async handleWebhook(_request: Request, _options?: WebhookOptions): Promise<Response> {\n    return new Response('QQ adapter uses NapCat WebSocket ingress only.', {\n      status: 501\n    });\n  }\n\n  /** 编码 thread ID：`qq:{chatType}:{peerId}`。 */\n  public encodeThreadId(data: QQThreadId): string {\n    if (data.chatType !== 'group' && data.chatType !== 'private') {\n      throw new ValidationError('qq', `Unsupported QQ chat type: ${data.chatType}`);\n    }\n\n    if (!data.peerId) {\n      throw new ValidationError('qq', 'QQ thread peerId is required');\n    }\n\n    return `qq:${data.chatType}:${data.peerId}`;\n  }\n\n  /** 解码 thread ID 并进行格式校验。 */\n  public decodeThreadId(threadId: string): QQThreadId {\n    const parts = threadId.split(':');\n    if (parts.length !== 3 || parts[0] !== 'qq') {\n      throw new ValidationError('qq', `Invalid QQ thread ID: ${threadId}`);\n    }\n\n    const chatType = parts[1];\n    if (chatType !== 'group' && chatType !== 'private') {\n      throw new ValidationError('qq', `Invalid QQ thread type in thread ID: ${threadId}`);\n    }\n\n    const peerId = parts[2];\n    if (!peerId) {\n      throw new ValidationError('qq', `Invalid QQ thread peer ID in thread ID: ${threadId}`);\n    }\n\n    return {\n      chatType,\n      peerId\n    };\n  }\n\n  /** 当前模型下 channelId 与 threadId 一致。 */\n  public channelIdFromThreadId(threadId: string): string {\n    this.decodeThreadId(threadId);\n    return threadId;\n  }\n\n  /** 判断当前 thread 是否为私聊会话。 */\n  public isDM(threadId: string): boolean {\n    return this.decodeThreadId(threadId).chatType === 'private';\n  }\n\n  /** 向群或私聊发送消息。 */\n  public async postMessage(\n    threadId: string,\n    message: AdapterPostableMessage\n  ): Promise<RawMessage<QQRawMessage>> {\n    const client = this.requireClient();\n    const parsed = this.decodeThreadId(threadId);\n    const peerId = toNumberId(parsed.peerId, 'peerId');\n    const text = this.converter.renderPostable(message);\n    const outgoingText = text.length > 0 ? text : ' ';\n    const segments: SendMessageSegment[] = [Structs.text(outgoingText)];\n\n    this.logger.debug('post message', parsed.chatType, parsed.peerId, segments);\n\n    const sent =\n      parsed.chatType === 'group'\n        ? await client.send_group_msg({\n            group_id: peerId,\n            message: segments\n          })\n        : await client.send_private_msg({\n            user_id: peerId,\n            message: segments\n          });\n\n    return {\n      id: String(sent.message_id),\n      raw: {\n        ...sent,\n        threadId,\n        chatType: parsed.chatType\n      } as unknown as QQRawMessage,\n      threadId\n    };\n  }\n\n  /** QQ 暂不支持编辑消息。 */\n  public async editMessage(\n    _threadId: string,\n    _messageId: string,\n    _message: AdapterPostableMessage\n  ): Promise<RawMessage<QQRawMessage>> {\n    throw new NotImplementedError('QQ adapter does not support editMessage yet', 'editMessage');\n  }\n\n  /** 删除指定消息。 */\n  public async deleteMessage(_threadId: string, messageId: string): Promise<void> {\n    const client = this.requireClient();\n    await client.delete_msg({ message_id: toNumberId(messageId, 'messageId') });\n  }\n\n  /** QQ 暂不支持反应能力（添加）。 */\n  public async addReaction(\n    _threadId: string,\n    _messageId: string,\n    _emoji: EmojiValue | string\n  ): Promise<void> {\n    throw new NotImplementedError('QQ adapter does not support addReaction yet', 'addReaction');\n  }\n\n  /** QQ 暂不支持反应能力（移除）。 */\n  public async removeReaction(\n    _threadId: string,\n    _messageId: string,\n    _emoji: EmojiValue | string\n  ): Promise<void> {\n    throw new NotImplementedError(\n      'QQ adapter does not support removeReaction yet',\n      'removeReaction'\n    );\n  }\n\n  /** QQ 暂不支持历史消息分页拉取。 */\n  public async fetchMessages(\n    _threadId: string,\n    _options?: FetchOptions\n  ): Promise<FetchResult<QQRawMessage>> {\n    throw new NotImplementedError('QQ adapter does not support fetchMessages yet', 'fetchMessages');\n  }\n\n  /** 获取 thread 基础信息。 */\n  public async fetchThread(threadId: string): Promise<ThreadInfo> {\n    const parsed = this.decodeThreadId(threadId);\n\n    return {\n      id: threadId,\n      channelId: threadId,\n      isDM: parsed.chatType === 'private',\n      metadata: {\n        chatType: parsed.chatType,\n        peerId: parsed.peerId\n      }\n    };\n  }\n\n  /** 当前实现不发送真实 typing，仅作为 no-op。 */\n  public startTyping(_threadId: string, _status?: string): Promise<void> {\n    return Promise.resolve();\n  }\n\n  /** 渲染格式化内容到 QQ 文本。 */\n  public renderFormatted(content: FormattedContent): string {\n    return this.converter.fromAst(content);\n  }\n\n  /** 将 NapCat 原始消息转换为 Chat SDK 标准 Message。 */\n  public parseMessage(raw: QQRawMessage): Message<QQRawMessage> {\n    const threadId = this.encodeThreadId(toThreadId(raw));\n    const text = extractText(raw);\n    const isMe = this.selfId !== undefined && String(raw.user_id) === this.selfId;\n\n    return new Message<QQRawMessage>({\n      id: String(raw.message_id),\n      threadId,\n      text,\n      formatted: this.converter.toAst(text),\n      author: toAuthor(raw, isMe),\n      metadata: {\n        dateSent: new Date(raw.time * 1000),\n        edited: false\n      },\n      attachments: toAttachments(raw.message),\n      raw\n    });\n  }\n\n  private bindListeners(): void {\n    if (!this.client || this.listenersBound) {\n      return;\n    }\n\n    this.client.on('message.group', this.onGroupMessage);\n    this.client.on('message.private', this.onPrivateMessage);\n    this.listenersBound = true;\n  }\n\n  private readonly onGroupMessage = (raw: QQGroupMessage): void => {\n    this.dispatchIncomingMessage(raw);\n  };\n\n  private readonly onPrivateMessage = (raw: QQPrivateMessage): void => {\n    this.dispatchIncomingMessage(raw);\n  };\n\n  /**\n   * 统一处理入站消息：\n   * - 过滤 bot 自己发送的消息\n   * - 计算 threadId 与 mention\n   * - 交给 Chat SDK `processMessage` 进入标准事件流\n   */\n  private dispatchIncomingMessage(raw: QQRawMessage): void {\n    if (!this.chat) {\n      return;\n    }\n\n    if (isSelfMessage(raw, this.selfId)) {\n      return;\n    }\n\n    const threadId = this.encodeThreadId(toThreadId(raw));\n    const mention = isMention(raw, this.selfId);\n\n    this.chat.processMessage(this, threadId, async () => {\n      const message = this.parseMessage(raw);\n      message.isMention = mention;\n      return message;\n    });\n  }\n\n  /** 获取已初始化的 NapCat 客户端，否则抛出配置错误。 */\n  private requireClient(): QQNapcatClient {\n    if (!this.client) {\n      throw new ValidationError(\n        'qq',\n        'QQ adapter is not initialized. Attach it to Chat and call chat.initialize() first.'\n      );\n    }\n\n    return this.client;\n  }\n}\n","import { ValidationError } from '@chat-adapter/shared';\n\nimport type { QQAdapterConfig } from './types.js';\n\nimport { QQAdapter } from './adapter.js';\n\n/**\n * 创建 QQ 适配器实例。\n * 仅支持显式配置，不读取环境变量。\n *\n * @param config QQ 适配器配置\n * @returns 已创建但未初始化的 QQAdapter 实例\n */\nexport function createQQAdapter(config: QQAdapterConfig): QQAdapter {\n  if (!config || !config.napcat) {\n    throw new ValidationError(\n      'qq',\n      'QQ NapCat config is required. Pass { napcat: NCWebsocketOptions } to createQQAdapter(config).'\n    );\n  }\n\n  return new QQAdapter(config);\n}\n"],"mappings":";;;;;;;AAKA,IAAa,oBAAb,cAAuC,oBAAoB;CACzD,MAAM,cAA4B;AAChC,SAAO,cAAc,aAAa;;CAGpC,QAAQ,KAAmB;AACzB,SAAO,kBAAkB,IAAI;;;;;;ACAjC,SAAgB,WAAW,OAAe,WAA2B;CACnE,MAAM,MAAM,OAAO,MAAM;AACzB,KAAI,CAAC,OAAO,UAAU,IAAI,IAAI,OAAO,EACnC,OAAM,IAAI,gBAAgB,MAAM,MAAM,UAAU,+BAA+B,QAAQ;AAEzF,QAAO;;;AAIT,SAAgB,cAAc,KAAmB,QAA0B;AACzE,KAAI,CAAC,OACH,QAAO;AAGT,QAAO,OAAO,IAAI,QAAQ,KAAK;;;AAIjC,SAAgB,UAAU,KAAmB,QAA0B;AACrE,KAAI,IAAI,iBAAiB,UACvB,QAAO;AAGT,KAAI,CAAC,OACH,QAAO;AAGT,QAAO,IAAI,QAAQ,MAChB,YACC,QAAQ,SAAS,QAAQ,QAAQ,KAAK,OAAO,SAAS,OAAO,QAAQ,KAAK,GAAG,KAAK,OACrF;;;AAIH,SAAgB,WAAW,KAA+B;AACxD,KAAI,IAAI,iBAAiB,QACvB,QAAO;EACL,UAAU;EACV,QAAQ,OAAO,IAAI,SAAS;EAC7B;AAGH,QAAO;EACL,UAAU;EACV,QAAQ,OAAO,IAAI,QAAQ;EAC5B;;;AAIH,SAAgB,SAAS,KAAmB,MAAuB;AACjE,QAAO;EACL,QAAQ,OAAO,IAAI,QAAQ;EAC3B,UAAU,OAAO,IAAI,QAAQ;EAC7B,UAAU,IAAI,OAAO,QAAQ,IAAI,OAAO,YAAY,OAAO,IAAI,QAAQ;EACvE,OAAO;EACP;EACD;;;AAIH,SAAgB,YAAY,KAA2B;CACrD,MAAM,OAAO,IAAI,QAAQ,IAAI,cAAc,CAAC,KAAK,GAAG;AACpD,KAAI,KAAK,SAAS,EAChB,QAAO;AAGT,QAAO,IAAI,cAAc,YAAY,cAAc,IAAI,YAAY,CAAC,GAAG;;;AAIzE,SAAgB,cAAc,SAA2C;AACvE,QAAO,QACJ,KAAK,YAAY;AAChB,MAAI,QAAQ,SAAS,QACnB,QAAO;GACL,MAAM;GACN,KAAK,SAAS,QAAQ,OAAO,QAAQ,KAAK,MAAM,KAAA;GACjD;AAGH,MAAI,QAAQ,SAAS,OACnB,QAAO;GACL,MAAM;GACN,MAAM,QAAQ,KAAK;GACpB;AAGH,MAAI,QAAQ,SAAS,QACnB,QAAO;GACL,MAAM;GACN,KAAK,QAAQ,KAAK;GAClB,MAAM,QAAQ,KAAK;GACpB;AAGH,MAAI,QAAQ,SAAS,SACnB,QAAO;GACL,MAAM;GACN,MAAM,QAAQ,KAAK;GACpB;AAGH,SAAO;GACP,CACD,QAAQ,eAA6D,eAAe,KAAK;;;AAI9F,SAAgB,cAAc,SAAmC;AAC/D,KAAI,QAAQ,SAAS,OACnB,QAAO,QAAQ,KAAK;AAGtB,KAAI,QAAQ,SAAS,KACnB,QAAO,QAAQ,KAAK,OAAO,QAAQ,SAAS,IAAI,QAAQ,KAAK;AAG/D,KAAI,QAAQ,SAAS,OACnB,QAAO,SAAS,QAAQ,KAAK,GAAG;AAGlC,KAAI,QAAQ,SAAS,QACnB,QAAO;AAGT,KAAI,QAAQ,SAAS,OACnB,QAAO,SAAS,QAAQ,KAAK,KAAK;AAGpC,KAAI,QAAQ,SAAS,SACnB,QAAO;AAGT,KAAI,QAAQ,SAAS,QACnB,QAAO;AAGT,KAAI,QAAQ,SAAS,WACnB,QAAO,QAAQ,KAAK;AAGtB,QAAO;;;;;;;;;;;;;ACzGT,IAAa,YAAb,MAAoE;;CAElE,OAAgB;;CAGhB;;CAGA;CAIA;CAEA,YAA6B,IAAI,mBAAmB;CAEpD,OAAoC;CAEpC;CAEA;CAEA;CAEA,iBAAyB;CAEzB;;CAGA,YAAmB,QAAyB;AAC1C,OAAK,SAAS;AACd,OAAK,WAAW;AAChB,OAAK,SAAS,OAAO,UAAU;GAC7B,aAAa,KAAK;GAClB,aAAa;GACb,YAAY;GACZ,YAAY;GACZ,aAAa;GACd;;;;;;CAOH,MAAa,WAAW,MAAmC;AACzD,MAAI,KAAK,aACP,QAAO,KAAK;AAGd,OAAK,eAAe,KAAK,aAAa,KAAK,CAAC,OAAO,UAAU;AAC3D,QAAK,eAAe,KAAA;AACpB,SAAM;IACN;AAEF,SAAO,KAAK;;CAGd,MAAc,aAAa,MAAmC;AAC5D,OAAK,OAAO;AACZ,OAAK,SAAS,KAAK,OAAO,UAAU,KAAK,UAAU,KAAK,KAAK;AAE7D,MAAI,CAAC,KAAK,OACR,MAAK,SAAS,IAAI,YAAY,KAAK,OAAO,QAAQ,KAAK,OAAO,SAAS,MAAM;AAG/E,OAAK,eAAe;AAEpB,QAAM,KAAK,OAAO,SAAS;EAE3B,MAAM,QAAQ,MAAM,KAAK,OAAO,gBAAgB;AAChD,OAAK,OAAO,KAAK,cAAc,MAAM;AAErC,OAAK,SAAS,OAAO,MAAM,QAAQ;AACnC,OAAK,YAAY,MAAM;AACvB,OAAK,WAAW,MAAM;;;CAIxB,MAAa,cAAc,UAAmB,UAA8C;AAC1F,SAAO,IAAI,SAAS,kDAAkD,EACpE,QAAQ,KACT,CAAC;;;CAIJ,eAAsB,MAA0B;AAC9C,MAAI,KAAK,aAAa,WAAW,KAAK,aAAa,UACjD,OAAM,IAAI,gBAAgB,MAAM,6BAA6B,KAAK,WAAW;AAG/E,MAAI,CAAC,KAAK,OACR,OAAM,IAAI,gBAAgB,MAAM,+BAA+B;AAGjE,SAAO,MAAM,KAAK,SAAS,GAAG,KAAK;;;CAIrC,eAAsB,UAA8B;EAClD,MAAM,QAAQ,SAAS,MAAM,IAAI;AACjC,MAAI,MAAM,WAAW,KAAK,MAAM,OAAO,KACrC,OAAM,IAAI,gBAAgB,MAAM,yBAAyB,WAAW;EAGtE,MAAM,WAAW,MAAM;AACvB,MAAI,aAAa,WAAW,aAAa,UACvC,OAAM,IAAI,gBAAgB,MAAM,wCAAwC,WAAW;EAGrF,MAAM,SAAS,MAAM;AACrB,MAAI,CAAC,OACH,OAAM,IAAI,gBAAgB,MAAM,2CAA2C,WAAW;AAGxF,SAAO;GACL;GACA;GACD;;;CAIH,sBAA6B,UAA0B;AACrD,OAAK,eAAe,SAAS;AAC7B,SAAO;;;CAIT,KAAY,UAA2B;AACrC,SAAO,KAAK,eAAe,SAAS,CAAC,aAAa;;;CAIpD,MAAa,YACX,UACA,SACmC;EACnC,MAAM,SAAS,KAAK,eAAe;EACnC,MAAM,SAAS,KAAK,eAAe,SAAS;EAC5C,MAAM,SAAS,WAAW,OAAO,QAAQ,SAAS;EAClD,MAAM,OAAO,KAAK,UAAU,eAAe,QAAQ;EACnD,MAAM,eAAe,KAAK,SAAS,IAAI,OAAO;EAC9C,MAAM,WAAiC,CAAC,QAAQ,KAAK,aAAa,CAAC;AAEnE,OAAK,OAAO,MAAM,gBAAgB,OAAO,UAAU,OAAO,QAAQ,SAAS;EAE3E,MAAM,OACJ,OAAO,aAAa,UAChB,MAAM,OAAO,eAAe;GAC1B,UAAU;GACV,SAAS;GACV,CAAC,GACF,MAAM,OAAO,iBAAiB;GAC5B,SAAS;GACT,SAAS;GACV,CAAC;AAER,SAAO;GACL,IAAI,OAAO,KAAK,WAAW;GAC3B,KAAK;IACH,GAAG;IACH;IACA,UAAU,OAAO;IAClB;GACD;GACD;;;CAIH,MAAa,YACX,WACA,YACA,UACmC;AACnC,QAAM,IAAI,oBAAoB,+CAA+C,cAAc;;;CAI7F,MAAa,cAAc,WAAmB,WAAkC;AAE9E,QADe,KAAK,eAAe,CACtB,WAAW,EAAE,YAAY,WAAW,WAAW,YAAY,EAAE,CAAC;;;CAI7E,MAAa,YACX,WACA,YACA,QACe;AACf,QAAM,IAAI,oBAAoB,+CAA+C,cAAc;;;CAI7F,MAAa,eACX,WACA,YACA,QACe;AACf,QAAM,IAAI,oBACR,kDACA,iBACD;;;CAIH,MAAa,cACX,WACA,UACoC;AACpC,QAAM,IAAI,oBAAoB,iDAAiD,gBAAgB;;;CAIjG,MAAa,YAAY,UAAuC;EAC9D,MAAM,SAAS,KAAK,eAAe,SAAS;AAE5C,SAAO;GACL,IAAI;GACJ,WAAW;GACX,MAAM,OAAO,aAAa;GAC1B,UAAU;IACR,UAAU,OAAO;IACjB,QAAQ,OAAO;IAChB;GACF;;;CAIH,YAAmB,WAAmB,SAAiC;AACrE,SAAO,QAAQ,SAAS;;;CAI1B,gBAAuB,SAAmC;AACxD,SAAO,KAAK,UAAU,QAAQ,QAAQ;;;CAIxC,aAAoB,KAA0C;EAC5D,MAAM,WAAW,KAAK,eAAe,WAAW,IAAI,CAAC;EACrD,MAAM,OAAO,YAAY,IAAI;EAC7B,MAAM,OAAO,KAAK,WAAW,KAAA,KAAa,OAAO,IAAI,QAAQ,KAAK,KAAK;AAEvE,SAAO,IAAI,QAAsB;GAC/B,IAAI,OAAO,IAAI,WAAW;GAC1B;GACA;GACA,WAAW,KAAK,UAAU,MAAM,KAAK;GACrC,QAAQ,SAAS,KAAK,KAAK;GAC3B,UAAU;IACR,0BAAU,IAAI,KAAK,IAAI,OAAO,IAAK;IACnC,QAAQ;IACT;GACD,aAAa,cAAc,IAAI,QAAQ;GACvC;GACD,CAAC;;CAGJ,gBAA8B;AAC5B,MAAI,CAAC,KAAK,UAAU,KAAK,eACvB;AAGF,OAAK,OAAO,GAAG,iBAAiB,KAAK,eAAe;AACpD,OAAK,OAAO,GAAG,mBAAmB,KAAK,iBAAiB;AACxD,OAAK,iBAAiB;;CAGxB,kBAAmC,QAA8B;AAC/D,OAAK,wBAAwB,IAAI;;CAGnC,oBAAqC,QAAgC;AACnE,OAAK,wBAAwB,IAAI;;;;;;;;CASnC,wBAAgC,KAAyB;AACvD,MAAI,CAAC,KAAK,KACR;AAGF,MAAI,cAAc,KAAK,KAAK,OAAO,CACjC;EAGF,MAAM,WAAW,KAAK,eAAe,WAAW,IAAI,CAAC;EACrD,MAAM,UAAU,UAAU,KAAK,KAAK,OAAO;AAE3C,OAAK,KAAK,eAAe,MAAM,UAAU,YAAY;GACnD,MAAM,UAAU,KAAK,aAAa,IAAI;AACtC,WAAQ,YAAY;AACpB,UAAO;IACP;;;CAIJ,gBAAwC;AACtC,MAAI,CAAC,KAAK,OACR,OAAM,IAAI,gBACR,MACA,qFACD;AAGH,SAAO,KAAK;;;;;;;;;;;;ACxVhB,SAAgB,gBAAgB,QAAoC;AAClE,KAAI,CAAC,UAAU,CAAC,OAAO,OACrB,OAAM,IAAI,gBACR,MACA,gGACD;AAGH,QAAO,IAAI,UAAU,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-adapter-qq",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "description": "Community chat adapter for QQ based on NapCat",
   "keywords": [
     "qq",
@@ -8,7 +8,8 @@
     "onebot",
     "bot",
     "chat",
-    "adapter"
+    "chat-sdk",
+    "chat-adapter"
   ],
   "homepage": "https://github.com/yjl9903/openana#readme",
   "bugs": {
@@ -37,10 +38,12 @@
     "dist"
   ],
   "dependencies": {
-    "@chat-adapter/shared": "^4.0.0"
+    "@chat-adapter/shared": "^4.0.0",
+    "node-napcat-ts": "^0.4.21"
   },
   "devDependencies": {
-    "chat": "^4.0.0"
+    "@chat-adapter/state-memory": "^4.18.0",
+    "chat": "^4.18.0"
   },
   "peerDependencies": {
     "chat": "^4.0.0"