@zhin.js/adapter-napcat 0.1.0

package/lib/types.d.ts

@@ -0,0 +1,275 @@
+/**
+ * NapCat 适配器类型定义
+ * 覆盖 OneBot11 标准 + go-cqhttp 扩展 + NapCat 独有 API
+ */
+export interface NapCatConfigBase {
+    context: 'napcat';
+    name: string;
+    access_token?: string;
+}
+/** 正向 WebSocket */
+export interface NapCatWsClientConfig extends NapCatConfigBase {
+    connection: 'ws';
+    url: string;
+    reconnect_interval?: number;
+    heartbeat_interval?: number;
+}
+/** 反向 WebSocket */
+export interface NapCatWsServerConfig extends NapCatConfigBase {
+    connection: 'wss';
+    path: string;
+    heartbeat_interval?: number;
+}
+/** HTTP API + POST 上报 */
+export interface NapCatHttpConfig extends NapCatConfigBase {
+    connection: 'http';
+    /** NapCat HTTP API 地址，如 http://127.0.0.1:3000 */
+    http_url: string;
+    /** HTTP POST 事件上报接收路径，如 /napcat/post */
+    post_path: string;
+    /** 轮询间隔(ms)，用于 HTTP 心跳检测，默认 30000 */
+    poll_interval?: number;
+}
+export type NapCatBotConfig = NapCatWsClientConfig | NapCatWsServerConfig | NapCatHttpConfig;
+export interface ApiResponse<T = any> {
+    status: string;
+    retcode: number;
+    data: T;
+    echo?: string;
+    message?: string;
+    wording?: string;
+}
+export interface MessageSegment {
+    type: string;
+    data: Record<string, any>;
+}
+export interface NapCatEvent {
+    post_type: 'message' | 'message_sent' | 'notice' | 'request' | 'meta_event';
+    self_id: number;
+    time: number;
+}
+export interface NapCatMessageEvent extends NapCatEvent {
+    post_type: 'message' | 'message_sent';
+    message_type: 'private' | 'group';
+    sub_type: string;
+    message_id: number;
+    user_id: number;
+    group_id?: number;
+    message: MessageSegment[];
+    raw_message: string;
+    font: number;
+    sender: {
+        user_id: number;
+        nickname: string;
+        card?: string;
+        sex?: string;
+        age?: number;
+        area?: string;
+        level?: string;
+        role?: 'owner' | 'admin' | 'member';
+        title?: string;
+    };
+}
+export interface NapCatNoticeEvent extends NapCatEvent {
+    post_type: 'notice';
+    notice_type: string;
+    sub_type?: string;
+    group_id?: number;
+    user_id?: number;
+    operator_id?: number;
+    message_id?: number;
+    target_id?: number;
+    file?: {
+        id: string;
+        name: string;
+        size: number;
+        busid: number;
+        url?: string;
+    };
+    duration?: number;
+    sender_id?: number;
+    title?: string;
+    action?: string;
+    suffix?: string;
+    comment?: string;
+    flag?: string;
+}
+export interface NapCatRequestEvent extends NapCatEvent {
+    post_type: 'request';
+    request_type: 'friend' | 'group';
+    sub_type?: string;
+    user_id: number;
+    group_id?: number;
+    comment?: string;
+    flag: string;
+}
+export interface NapCatMetaEvent extends NapCatEvent {
+    post_type: 'meta_event';
+    meta_event_type: string;
+    sub_type?: string;
+    status?: any;
+    interval?: number;
+}
+export interface SenderInfo {
+    id: string;
+    name: string;
+    role?: 'owner' | 'admin' | 'member';
+    isOwner?: boolean;
+    isAdmin?: boolean;
+    card?: string;
+    title?: string;
+}
+export interface LoginInfo {
+    user_id: number;
+    nickname: string;
+}
+export interface StrangerInfo {
+    user_id: number;
+    nickname: string;
+    sex: string;
+    age: number;
+    qid?: string;
+    level?: number;
+    login_days?: number;
+}
+export interface FriendInfo {
+    user_id: number;
+    nickname: string;
+    remark: string;
+}
+export interface GroupInfo {
+    group_id: number;
+    group_name: string;
+    group_memo?: string;
+    group_create_time?: number;
+    group_level?: number;
+    member_count: number;
+    max_member_count: number;
+}
+export interface GroupMemberInfo {
+    group_id: number;
+    user_id: number;
+    nickname: string;
+    card: string;
+    sex: string;
+    age: number;
+    area: string;
+    join_time: number;
+    last_sent_time: number;
+    level: string;
+    role: 'owner' | 'admin' | 'member';
+    unfriendly: boolean;
+    title: string;
+    title_expire_time: number;
+    card_changeable: boolean;
+    shut_up_timestamp?: number;
+}
+export interface MessageInfo {
+    time: number;
+    message_type: string;
+    message_id: number;
+    real_id: number;
+    sender: {
+        user_id: number;
+        nickname: string;
+        card?: string;
+    };
+    message: MessageSegment[];
+}
+export interface ForwardMessage {
+    messages: Array<{
+        content: MessageSegment[];
+        sender: {
+            nickname: string;
+            user_id: number;
+        };
+        time: number;
+    }>;
+}
+export interface GroupHonorInfo {
+    group_id: number;
+    current_talkative?: {
+        user_id: number;
+        nickname: string;
+        avatar: string;
+        day_count: number;
+    };
+    talkative_list?: any[];
+    performer_list?: any[];
+    legend_list?: any[];
+    strong_newbie_list?: any[];
+    emotion_list?: any[];
+}
+export interface EssenceMessage {
+    sender_id: number;
+    sender_nick: string;
+    sender_time: number;
+    operator_id: number;
+    operator_nick: string;
+    operator_time: number;
+    message_id: number;
+}
+export interface GroupFileSystemInfo {
+    file_count: number;
+    limit_count: number;
+    used_space: number;
+    total_space: number;
+}
+export interface GroupFileInfo {
+    files: Array<{
+        group_id: number;
+        file_id: string;
+        file_name: string;
+        busid: number;
+        file_size: number;
+        upload_time: number;
+        dead_time: number;
+        modify_time: number;
+        download_times: number;
+        uploader: number;
+        uploader_name: string;
+    }>;
+    folders: Array<{
+        group_id: number;
+        folder_id: string;
+        folder_name: string;
+        create_time: number;
+        creator: number;
+        creator_name: string;
+        total_file_count: number;
+    }>;
+}
+export interface GroupNotice {
+    sender_id: number;
+    publish_time: number;
+    message: {
+        text: string;
+        images?: Array<{
+            id: string;
+            height: string;
+            width: string;
+        }>;
+    };
+}
+export interface VersionInfo {
+    app_name: string;
+    app_version: string;
+    protocol_version: string;
+    [key: string]: any;
+}
+export interface OnlineStatus {
+    status: number;
+    ext_status: number;
+}
+export interface AiCharacter {
+    character_id: string;
+    character_name: string;
+    preview_url?: string;
+}
+export interface CollectionItem {
+    id: string;
+    type: number;
+    content: string;
+    create_time: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mBAAmB;AACnB,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,UAAU,EAAE,IAAI,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,mBAAmB;AACnB,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,UAAU,EAAE,KAAK,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAI7F,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAID,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,SAAS,EAAE,SAAS,GAAG,cAAc,CAAC;IACtC,YAAY,EAAE,SAAS,GAAG,OAAO,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,SAAS,EAAE,QAAQ,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,SAAS,EAAE,YAAY,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7G;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,GAAG,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvO,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpK;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC1F;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/lib/types.js

@@ -0,0 +1,6 @@
+/**
+ * NapCat 适配器类型定义
+ * 覆盖 OneBot11 标准 + go-cqhttp 扩展 + NapCat 独有 API
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@zhin.js/adapter-napcat",
+  "version": "0.1.0",
+  "description": "Zhin.js adapter for NapCatQQ (OneBot11 superset with go-cqhttp & NapCat extensions)",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "src",
+    "lib",
+    "skills",
+    "plugin.yml",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "bot",
+    "adapter",
+    "napcat",
+    "napneko",
+    "onebot",
+    "onebot11",
+    "qq",
+    "chatbot"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "repository": {
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "type": "git",
+    "directory": "plugins/adapters/napcat"
+  },
+  "dependencies": {
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^6.0.3",
+    "zhin.js": "1.0.72",
+    "@zhin.js/cli": "1.0.68"
+  },
+  "peerDependencies": {
+    "@zhin.js/http": "1.0.65",
+    "zhin.js": "1.0.72"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/http": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "zhin build",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,3 @@
+name: adapter-napcat
+description: NapCatQQ 适配器：OneBot11 + go-cqhttp 扩展 + NapCat 独有 API（戳一戳、表情回应、AI语音、群文件、精华消息、群公告等）
+version: 0.1.0

package/skills/napcat/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: napcat
+platforms:
+  - napcat
+description: >-
+  NapCatQQ 完整能力：群管理（踢人、禁言、管理员、群名片、头衔）、消息收发、
+  戳一戳、表情回应、合并转发、群文件管理、精华消息、群公告、AI语音TTS、
+  图片OCR、小程序卡片、消息历史、在线状态、个人资料修改等。
+  仅有昵称时请先 napcat_list_members 获取 user_id。
+keywords:
+  - napcat
+  - napneko
+  - onebot11
+  - adapter:napcat
+  - qq
+  - 群管理
+  - 头衔
+  - 戳一戳
+  - 表情回应
+  - 合并转发
+  - 群文件
+  - 精华消息
+  - 群公告
+  - AI语音
+  - OCR
+  - 小程序
+  - list_members
+tags:
+  - group
+  - management
+  - im
+  - qq
+  - napcat
+tools:
+  # 通用群管工具（IGroupManagement 自动生成）
+  - napcat_kick_member
+  - napcat_mute_member
+  - napcat_mute_all
+  - napcat_set_admin
+  - napcat_set_nickname
+  - napcat_set_group_name
+  - napcat_list_members
+  - napcat_get_group_info
+  # NapCat 扩展工具
+  - napcat_send_poke
+  - napcat_set_emoji_reaction
+  - napcat_send_forward_msg
+  - napcat_forward_single_msg
+  - napcat_send_like
+  - napcat_set_essence_msg
+  - napcat_delete_essence_msg
+  - napcat_get_essence_list
+  - napcat_send_group_notice
+  - napcat_get_group_notice
+  - napcat_del_group_notice
+  - napcat_upload_group_file
+  - napcat_get_group_file_url
+  - napcat_get_group_root_files
+  - napcat_get_group_shut_list
+  - napcat_set_group_portrait
+  - napcat_set_title
+  - napcat_group_sign
+  - napcat_ai_tts
+  - napcat_get_ai_characters
+  - napcat_ocr_image
+  - napcat_get_mini_app_ark
+  - napcat_get_group_msg_history
+  - napcat_get_friend_msg_history
+  - napcat_get_user_status
+  - napcat_get_group_info_ex
+  - napcat_set_profile
+  - napcat_set_avatar
+  - napcat_set_online_status
+  - napcat_set_signature
+  - napcat_translate
+  - napcat_mark_msg_as_read
+  - napcat_download_file
+  - napcat_delete_friend
+---
+
+## 工具概览
+
+### 通用群管（IGroupManagement 自动生成）
+
+| 工具 | 说明 | 权限 |
+|------|------|------|
+| `napcat_kick_member` | 踢出成员 | group_admin |
+| `napcat_mute_member` | 禁言成员（duration=0 解除） | group_admin |
+| `napcat_mute_all` | 全员禁言/解除 | group_admin |
+| `napcat_set_admin` | 设置/取消管理员 | group_owner |
+| `napcat_set_nickname` | 修改群昵称/名片 | group_admin |
+| `napcat_set_group_name` | 修改群名称 | group_admin |
+| `napcat_list_members` | 获取群成员列表 | user |
+| `napcat_get_group_info` | 获取群信息 | user |
+
+### NapCat 扩展
+
+| 工具 | 说明 | 权限 |
+|------|------|------|
+| `napcat_send_poke` | 戳一戳 | user |
+| `napcat_set_emoji_reaction` | 表情回应 | user |
+| `napcat_send_forward_msg` | 合并转发 | user |
+| `napcat_forward_single_msg` | 单条转发 | user |
+| `napcat_send_like` | 好友点赞 | user |
+| `napcat_set_essence_msg` | 设置精华消息 | group_admin |
+| `napcat_delete_essence_msg` | 取消精华消息 | group_admin |
+| `napcat_get_essence_list` | 精华消息列表 | user |
+| `napcat_send_group_notice` | 发群公告 | group_admin |
+| `napcat_get_group_notice` | 获取群公告 | user |
+| `napcat_del_group_notice` | 删除群公告 | group_admin |
+| `napcat_upload_group_file` | 上传群文件 | user |
+| `napcat_get_group_file_url` | 获取文件链接 | user |
+| `napcat_get_group_root_files` | 群文件列表 | user |
+| `napcat_get_group_shut_list` | 禁言列表 | user |
+| `napcat_set_group_portrait` | 设置群头像 | group_admin |
+| `napcat_set_title` | 设置专属头衔 | group_owner |
+| `napcat_group_sign` | 群签到/打卡 | user |
+| `napcat_ai_tts` | AI 文字转语音 | user |
+| `napcat_get_ai_characters` | AI 语音角色列表 | user |
+| `napcat_ocr_image` | 图片 OCR | user |
+| `napcat_get_mini_app_ark` | 小程序卡片签名 | user |
+| `napcat_get_group_msg_history` | 群消息历史 | user |
+| `napcat_get_friend_msg_history` | 私聊历史 | user |
+| `napcat_get_user_status` | 用户在线状态 | user |
+| `napcat_get_group_info_ex` | 群额外信息 | user |
+| `napcat_set_profile` | 修改资料 | user |
+| `napcat_set_avatar` | 修改头像 | user |
+| `napcat_set_online_status` | 设置在线状态 | user |
+| `napcat_set_signature` | 设置个性签名 | user |
+| `napcat_translate` | 英译中翻译 | user |
+| `napcat_mark_msg_as_read` | 标记已读 | user |
+| `napcat_download_file` | 下载文件 | user |
+| `napcat_delete_friend` | 删除好友 | group_admin |
+
+## 执行规则
+
+1. 仅有昵称时先 `napcat_list_members` 获取用户 QQ 号
+2. 禁言 duration 单位为秒，默认 600（10 分钟），设为 0 解除
+3. 头衔设置需要群主权限
+4. AI 语音发送前可先用 `napcat_get_ai_characters` 查询可用角色
+5. 合并转发的 messages 参数为 JSON 格式的 node 数组

package/src/adapter.ts

@@ -0,0 +1,100 @@
+/**
+ * NapCat 适配器：支持正向 WS / 反向 WS / HTTP
+ */
+import type { Router } from '@zhin.js/http';
+import { Adapter, Plugin } from 'zhin.js';
+import { NapCatWsClient } from './bot-ws-client.js';
+import { NapCatWsServer } from './bot-ws-server.js';
+import { NapCatHttpBot } from './bot-http.js';
+import type { NapCatBotConfig, NapCatWsClientConfig, NapCatWsServerConfig, NapCatHttpConfig } from './types.js';
+
+export type NapCatBot = NapCatWsClient | NapCatWsServer | NapCatHttpBot;
+
+export class NapCatAdapter extends Adapter<NapCatBot> {
+  #router?: Router;
+
+  constructor(plugin: Plugin) {
+    super(plugin, 'napcat', []);
+  }
+
+  createBot(config: NapCatBotConfig): NapCatBot {
+    const connection = config.connection ?? 'ws';
+    switch (connection) {
+      case 'ws':
+        return new NapCatWsClient(this, config as NapCatWsClientConfig);
+      case 'wss':
+        if (!this.#router) throw new Error('NapCat connection: wss requires router. Enable @zhin.js/http first.');
+        return new NapCatWsServer(this, this.#router, config as NapCatWsServerConfig);
+      case 'http':
+        if (!this.#router) throw new Error('NapCat connection: http requires router. Enable @zhin.js/http first.');
+        return new NapCatHttpBot(this, this.#router, config as NapCatHttpConfig);
+      default:
+        throw new Error(`Unknown NapCat connection: ${connection}`);
+    }
+  }
+
+  // ── 群管理接口（IGroupManagement 适配）──────────────────────────
+
+  async kickMember(botId: string, sceneId: string, userId: string) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.kickMember(Number(sceneId), Number(userId));
+  }
+
+  async muteMember(botId: string, sceneId: string, userId: string, duration = 600) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.muteMember(Number(sceneId), Number(userId), duration);
+  }
+
+  async muteAll(botId: string, sceneId: string, enable = true) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.muteAll(Number(sceneId), enable);
+  }
+
+  async setAdmin(botId: string, sceneId: string, userId: string, enable = true) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.setAdmin(Number(sceneId), Number(userId), enable);
+  }
+
+  async setMemberNickname(botId: string, sceneId: string, userId: string, nickname: string) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.setCard(Number(sceneId), Number(userId), nickname);
+  }
+
+  async setGroupName(botId: string, sceneId: string, name: string) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.setGroupName(Number(sceneId), name);
+  }
+
+  async listMembers(botId: string, sceneId: string) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    const members = await bot.getMemberList(Number(sceneId));
+    return {
+      members: members.map((m: any) => ({
+        user_id: m.user_id, nickname: m.nickname, card: m.card, role: m.role, title: m.title,
+      })),
+      count: members.length,
+    };
+  }
+
+  async getGroupInfo(botId: string, sceneId: string) {
+    const bot = this.bots.get(botId);
+    if (!bot) throw new Error(`Bot ${botId} not found`);
+    return bot.getGroupInfo(Number(sceneId));
+  }
+
+  async start(): Promise<void> {
+    this.#router = (this.plugin.inject as (key: string) => Router | undefined)('router');
+    (this.plugin.useContext as (key: string, fn: (router: Router) => void) => void)('router', (router: Router) => {
+      this.#router = router;
+    });
+    await super.start();
+    this.plugin.logger.info('NapCat adapter started');
+  }
+}