@zhin.js/adapter-napcat 1.1.21 → 1.1.23

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @zhin.js/adapter-napcat
 
+## 1.1.23
+
+### Patch Changes
+
+- bc6ccb1: Deep audit bug fixes and 7 architectural improvements:
+  - Sink Agent Turn ingress pipeline from `@zhin.js/cli` into `@zhin.js/agent/runtime` (`plugin-runtime/ingress/`) and decompose `ingress-route.ts` into modular pipeline stages.
+  - Bind Session State Plane (`JsxButtonRegistry`, `InteractionRuntime`, `RuntimeInteractiveRouter`) to `PluginIncarnationRef` so active buttons and interactions survive unrelated-plugin HMR while expiring when the owning plugin reloads, and support per-conversation fallback numbering (`numberingScope: 'conversation'`).
+  - Establish `conversation_events` as the canonical message SSOT and reference `conversation_event_id`, `conversation_key`, `platform_message_id`, and `message_key` in `agent_messages` (`AGENT_MESSAGE_QUERY_VERSION = 2`), threading `conversationSequence` across inbound and outbound delivery receipts.
+  - Push down `DatabaseContextRepository` and `DatabaseScheduleJobStorage` full-session/full-table memory scans to indexed SQL queries.
+  - Add kernel-level inbound `replyTo` and `mentioned` auto-promotion (`promoteInboundMessagePayload`) plus reusable `InboundDeduper` and `TtlLookupCache` primitives in `@zhin.js/adapter`.
+  - Add `MiddlewareContext.dispatch` (`InboundDispatchSummary`) and `onAfterDispatch` hooks for `after-dispatch` middlewares, and support incremental rendering of in-place `envelope.payload` array mutations in `OutboundDeliveryRuntime`.
+  - Unify `HistoryWindowTracker` and `AgentCompactionRuntime` token/message budgets (`resolveUnifiedHistoryAndCompactionBudget`).
+  - Fix schema validation, database transaction connection cleanup and SQLite WAL mode, schedule timer wheel head-of-line blocking, security policy bash read paths and subagent guard propagation, group merge window permission carrier handoff, micro-compact namespaced tool matching, and WebSocket force-close / inbound segment mapping across adapters.
+- Updated dependencies [3a8504b]
+- Updated dependencies [6163abc]
+- Updated dependencies [fed2c27]
+- Updated dependencies [bc6ccb1]
+- Updated dependencies [72b5a12]
+- Updated dependencies [aa41889]
+- Updated dependencies [4427e72]
+- Updated dependencies [22bd14a]
+  - @zhin.js/agent-feature@1.1.14
+  - @zhin.js/core@1.1.57
+  - @zhin.js/client@1.1.25
+  - @zhin.js/page@1.1.15
+  - @zhin.js/im-contract@1.1.12
+  - @zhin.js/adapter@1.1.29
+  - @zhin.js/host-http@1.1.15
+  - @zhin.js/feature-kit@1.1.13
+  - @zhin.js/tool@1.1.16
+  - @zhin.js/adapter-onebot-events@0.0.2
+  - @zhin.js/permission@1.1.13
+  - @zhin.js/skill@1.1.14
+
+## 1.1.22
+
+### Patch Changes
+
+- b249e5e: ADR 0044 C4：事件映射迁出 core。新增 `@zhin.js/adapter-onebot-events`，承载 OneBot v11 / NapCat / icqq 的原始通知与请求 → 标准事件映射（`receiveOneBotLikeSideEvent`、`mapNoticeParts`、`mapRequestParts`、`resolveSideEventDedupeKey` 及 OneBot 映射表，icqq 差异用覆盖表表达）；KOOK、Slack 的映射迁入各自适配器；`@zhin.js/core` 只保留标准事件名、类型与 `buildNotice` / `buildRequest` / `buildSystem` / `senderFromId`，不再含任何平台名。core 不再导出上述映射函数与 `ONEBOT_/KOOK_/SLACK_NOTICE_PARTS_MAP`、`SideEventPlatform`、`OneBotLike*` 类型，适配器改从共享包导入。
+- 41ff1a5: ADR 0044 C5: every official adapter now declares a capability `profile` (its `segments` moved into `profile.default.messaging.segments`). icqq declares the complete profile (per conversation kind: scene, all 14 actions with real limits, events, feedback, delivery) and implements the seven new management ports (`pokeUser`, `unmuteGroupMember`, `muteAllGroupMembers`, `setGroupCard`, `setGroupTitle`, `setGroupEssence`, `inviteGroupMember`) with fresh bot-role reads. qq official declares its passive reply windows; undeclared capabilities stay unsupported.
+- cbd3f14: ADR 0044 integration and C6 guard. `delivery.spool` now reproduces the pre-0044 media rule (icqq `false`, every other official adapter `true`). icqq narrows `actions.recall.others` unless the Bot is admin or owner, and declares recall for groups. Endpoint kind capabilities merge the Endpoint's `operations` (Discord reactions keep working; Discord declares reaction feedback). Adapters in the `@zhin.js/` scope are trusted: their custom prompt text is not labelled `external_content`. Core no longer keeps a telegram/discord interactive-policy table (adapters declare `segments.interactive`). New `pnpm check:no-platform-branches` blocks platform-name branches in runtime code.
+- 4fe49b5: 支持配置按需生效：分离保存与有效版本，独立变更先应用，账号资料更新保留连接，模型按回合使用确定版本；Console 返回结构化应用结果。监听改为仅显式 --watch 启用，开发模板显式选择源码和配置监听。
+
+  自变更消费配置应用回执，避免已处理配置被二次重载；持久化本次写入修订和应用结果，未知结果或修订冲突时停止自动续作并保留现场，恢复不会覆盖未经本次变更确认的配置。
+
+- Updated dependencies [b249e5e]
+- Updated dependencies [57661f6]
+- Updated dependencies [cbd3f14]
+- Updated dependencies [299863a]
+- Updated dependencies [aaa93d7]
+- Updated dependencies [bd524d1]
+- Updated dependencies [126ae99]
+- Updated dependencies [4fe49b5]
+- Updated dependencies [cce07db]
+- Updated dependencies [b652db3]
+- Updated dependencies [0315ba0]
+- Updated dependencies [00be764]
+  - @zhin.js/adapter-onebot-events@0.0.1
+  - @zhin.js/core@1.1.56
+  - @zhin.js/adapter@1.1.28
+  - @zhin.js/im-contract@1.1.11
+  - @zhin.js/tool@1.1.15
+  - @zhin.js/skill@1.1.13
+  - @zhin.js/host-http@1.1.14
+  - @zhin.js/feature-kit@1.1.12
+  - @zhin.js/client@1.1.24
+  - @zhin.js/page@1.1.14
+  - @zhin.js/agent-feature@1.1.13
+  - @zhin.js/permission@1.1.12
+
 ## 1.1.21
 
 ### Patch Changes

package/adapters/napcat/index.js

@@ -9,12 +9,25 @@ export { NapCatWsEndpoint, } from "../../lib/ws-endpoint.js";
 export { NapCatWssEndpoint, } from "../../lib/wss-endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
-    operations: ['recall'],
     // OneBot file 参数原生消费 url / base64:// 媒体，file:// 本地路径由 NapCat 侧读盘；
     // 无卡片交互面，交互段降级纯文本。
-    segments: {
-        outboundMedia: ['url', 'base64', 'path'],
-        interactive: 'text',
+    profile: {
+        default: {
+            messaging: {
+                segments: {
+                    outboundMedia: ['url', 'base64', 'path'],
+                    interactive: 'text',
+                },
+                quote: true,
+                recall: {},
+            },
+            actions: {
+                recall: { scopes: ['private', 'group'] },
+                quoteReply: { scopes: ['private', 'group'] },
+                announce: { scopes: ['group'], requiresRole: 'admin' },
+            },
+            delivery: { send: true, proactive: true, spool: true },
+        },
     },
     createAdapter: context => new NapcatAdapter(context),
 });

package/adapters/napcat/index.ts

@@ -21,12 +21,25 @@ export type { NapCatWsSocket, NapCatWsCreateOptions } from '../../src/ws-types.j
 
 export default defineAdapter<NapCatEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
-  operations: ['recall'],
   // OneBot file 参数原生消费 url / base64:// 媒体，file:// 本地路径由 NapCat 侧读盘；
   // 无卡片交互面，交互段降级纯文本。
-  segments: {
-    outboundMedia: ['url', 'base64', 'path'],
-    interactive: 'text',
+  profile: {
+    default: {
+      messaging: {
+        segments: {
+          outboundMedia: ['url', 'base64', 'path'],
+          interactive: 'text',
+        },
+        quote: true,
+        recall: {},
+      },
+      actions: {
+        recall: { scopes: ['private', 'group'] },
+        quoteReply: { scopes: ['private', 'group'] },
+        announce: { scopes: ['group'], requiresRole: 'admin' },
+      },
+      delivery: { send: true, proactive: true, spool: true },
+    },
   },
   createAdapter: context => new NapcatAdapter(context),
 });

package/lib/http-endpoint.js

@@ -1,10 +1,11 @@
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 import { createEndpointSpecification, endpointSpec, createRecallEndpointControl, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createNapCatEndpointManagement } from './endpoint-management.js';
 import { createNapcatSelfProfile } from './self-profile.js';
 import { InboundMessageDeduper, isNapCatBotMentioned, isSelfMessage, normalizeMessage, } from './napcat-inbound.js';
-import { buildSendAction, callNapCatHttpAction, formatInboundContent, formatOutboundSegments, isMessageEvent, napcatInboundConversation, napcatOutboundTarget, senderNickname, senderUserId, } from './protocol.js';
+import { buildSendAction, callNapCatHttpAction, extractQuoteId, formatInboundContent, formatOutboundSegments, isMessageEvent, napcatInboundConversation, napcatOutboundTarget, senderNickname, senderUserId, } from './protocol.js';
 import { receiveNapCatSideEvent } from './side-event-dispatch.js';
 import { createNapCatContentPort } from './onebot-get-msg.js';
 import { NapcatClient } from './client.js';
@@ -120,12 +121,15 @@ export class NapCatHttpEndpoint extends NapcatClient {
         const conversation = { ...napcatInboundConversation(String(this.#options.id), ev), endpoint: this[endpointSpec].identity };
         const nickname = senderNickname(ev);
         const mentioned = isNapCatBotMentioned(ev);
+        const quoteId = extractQuoteId(ev);
+        const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
         void this[endpointSpec].events.message({
             event: nativeEvent,
             ...(typeof nativeEvent.time === 'number' ? { platformSentAt: nativeEvent.time * 1000 } : {}),
             conversation,
             message: { conversation, id: msgId },
             content: formatInboundContent(ev),
+            ...(segments?.length ? { segments } : {}),
             sender: {
                 id: senderUserId(ev),
                 name: nickname,
@@ -133,6 +137,7 @@ export class NapCatHttpEndpoint extends NapcatClient {
             },
             endpointId: this.#options.config.id,
             ...(mentioned ? { mentioned: true } : {}),
+            ...(quoteId ? { replyTo: { id: quoteId } } : {}),
             metadata: Object.freeze({
                 message_type: ev.message_type,
                 user_id: ev.user_id != null ? String(ev.user_id) : undefined,

package/lib/napcat-inbound.d.ts

@@ -1,12 +1,9 @@
 /**
  * NapCat 入站消息治理：去重、自发过滤、消息归一化
  */
+import { InboundMessageDeduper } from 'zhin.js/adapter';
 import type { NapCatMessageEvent, MessageSegment } from './protocol.js';
-export declare class InboundMessageDeduper {
-    private readonly seen;
-    shouldProcess(messageId: string): boolean;
-    clear(): void;
-}
+export { InboundMessageDeduper };
 /** 判断是否为 bot 自身发出的消息 */
 export declare function isSelfMessage(event: NapCatMessageEvent | {
     post_type?: string;

package/lib/napcat-inbound.js

@@ -1,21 +1,8 @@
-const DEDUPE_TTL_MS = 120_000;
-export class InboundMessageDeduper {
-    seen = new Map();
-    shouldProcess(messageId) {
-        const now = Date.now();
-        for (const [id, t] of this.seen) {
-            if (now - t > DEDUPE_TTL_MS)
-                this.seen.delete(id);
-        }
-        if (this.seen.has(messageId))
-            return false;
-        this.seen.set(messageId, now);
-        return true;
-    }
-    clear() {
-        this.seen.clear();
-    }
-}
+/**
+ * NapCat 入站消息治理：去重、自发过滤、消息归一化
+ */
+import { InboundMessageDeduper, promoteInboundMessagePayload } from 'zhin.js/adapter';
+export { InboundMessageDeduper };
 /** 判断是否为 bot 自身发出的消息 */
 export function isSelfMessage(event) {
     if (event.post_type === 'message_sent')
@@ -53,9 +40,8 @@ export function isNapCatBotMentioned(ev) {
     if (!uin)
         return false;
     const segments = normalizeMessage(ev.message ?? []);
-    for (const seg of segments) {
-        if (seg.type === 'at' && atTargetMatchesUin(seg.data?.qq, uin))
-            return true;
+    if (promoteInboundMessagePayload({ segments }, uin).mentioned === true) {
+        return true;
     }
     const text = segments
         .map((seg) => (seg.type === 'text' ? String(seg.data?.text ?? '') : ''))

package/lib/onebot-get-msg.js

@@ -67,9 +67,10 @@ export function createNapCatContentPort(callApi) {
         },
     });
 }
+import { toCanonicalSegments } from '@zhin.js/core';
 function canonicalSegments(content) {
-    return Object.freeze(content.map((segment) => Object.freeze({
-        type: segment.type,
+    return Object.freeze(toCanonicalSegments(content).map((segment) => Object.freeze({
+        ...segment,
         data: Object.freeze(segment.data ?? {}),
     })));
 }

package/lib/protocol.d.ts

@@ -119,6 +119,11 @@ export declare function formatInboundContent(ev: NapCatEvent): string;
 export declare function senderUserId(ev: NapCatEvent): string;
 /** 显示名（群名片 card 优先于 nickname），没有则 undefined。 */
 export declare function senderNickname(ev: NapCatEvent): string | undefined;
+/**
+ * 回复引用 id：优先取 message 数组中的 {type:'reply', data:{id}} 段；
+ * 兼容部分实现把 reply 放在事件顶层（标量或带 message_id 的对象）。
+ */
+export declare function extractQuoteId(ev: NapCatEvent): string | undefined;
 /**
  * canonical MediaRef → OneBot `file` 参数：url 直传、base64 → `base64://`、
  * 本地路径 → `file://`（路径在 OneBot 实现侧解析）、kind=file 不透明引用原样透传。

package/lib/protocol.js

@@ -157,6 +157,27 @@ export function senderNickname(ev) {
     const name = ev.sender?.card || ev.sender?.nickname;
     return typeof name === 'string' && name ? name : undefined;
 }
+/**
+ * 回复引用 id：优先取 message 数组中的 {type:'reply', data:{id}} 段；
+ * 兼容部分实现把 reply 放在事件顶层（标量或带 message_id 的对象）。
+ */
+export function extractQuoteId(ev) {
+    if (Array.isArray(ev.message)) {
+        for (const seg of ev.message) {
+            if (seg?.type === 'reply' && seg.data?.id != null)
+                return String(seg.data.id);
+        }
+    }
+    const reply = ev.reply;
+    if (typeof reply === 'number' || typeof reply === 'string')
+        return String(reply);
+    if (reply && typeof reply === 'object' && 'message_id' in reply) {
+        const id = reply.message_id;
+        if (id != null)
+            return String(id);
+    }
+    return undefined;
+}
 /**
  * canonical MediaRef → OneBot `file` 参数：url 直传、base64 → `base64://`、
  * 本地路径 → `file://`（路径在 OneBot 实现侧解析）、kind=file 不透明引用原样透传。

package/lib/side-event-dispatch.js

@@ -1,4 +1,4 @@
-import { receiveOneBotLikeSideEvent } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent } from '@zhin.js/adapter-onebot-events';
 import { formatCompact } from '@zhin.js/logger';
 export function receiveNapCatSideEvent(emit, endpointKey, caller, raw, logger) {
     if (!emit)

package/lib/ws-endpoint.js

@@ -1,4 +1,5 @@
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 /**
  * NapCat WS client endpoint — outbound connect to NapCat.
  */
@@ -8,7 +9,7 @@ import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createNapCatEndpointManagement } from './endpoint-management.js';
 import { createNapcatSelfProfile } from './self-profile.js';
 import { InboundMessageDeduper, isNapCatBotMentioned, isSelfMessage, normalizeMessage, } from './napcat-inbound.js';
-import { buildSendAction, buildWsConnectOptions, formatInboundContent, formatOutboundSegments, isMessageEvent, napcatInboundConversation, napcatOutboundTarget, senderNickname, senderUserId, } from './protocol.js';
+import { buildSendAction, buildWsConnectOptions, extractQuoteId, formatInboundContent, formatOutboundSegments, isMessageEvent, napcatInboundConversation, napcatOutboundTarget, senderNickname, senderUserId, } from './protocol.js';
 import { receiveNapCatSideEvent } from './side-event-dispatch.js';
 import { createNapCatContentPort } from './onebot-get-msg.js';
 import { NapcatClient } from './client.js';
@@ -134,12 +135,15 @@ export class NapCatWsEndpoint extends NapcatClient {
         const content = formatInboundContent(ev);
         const nickname = senderNickname(ev);
         const mentioned = isNapCatBotMentioned(ev);
+        const quoteId = extractQuoteId(ev);
+        const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
         void this[endpointSpec].events.message({
             event: nativeEvent,
             ...(typeof nativeEvent.time === 'number' ? { platformSentAt: nativeEvent.time * 1000 } : {}),
             conversation,
             message: { conversation, id: msgId },
             content,
+            ...(segments?.length ? { segments } : {}),
             sender: {
                 id: senderUserId(ev),
                 name: nickname,
@@ -147,6 +151,7 @@ export class NapCatWsEndpoint extends NapcatClient {
             },
             endpointId: this.#options.config.id,
             ...(mentioned ? { mentioned: true } : {}),
+            ...(quoteId ? { replyTo: { id: quoteId } } : {}),
             metadata: Object.freeze({
                 message_type: ev.message_type,
                 user_id: ev.user_id != null ? String(ev.user_id) : undefined,
@@ -178,6 +183,7 @@ export class NapCatWsEndpoint extends NapcatClient {
                 }
                 try {
                     ws.close();
+                    ws.terminate?.();
                 }
                 catch {
                     /* ignore */

package/lib/ws-types.d.ts

@@ -3,6 +3,7 @@ export interface NapCatWsSocket {
     readonly readyState: number;
     send(data: string): void;
     close(code?: number, reason?: string): void;
+    terminate?(): void;
     ping?(): void;
     on(event: 'open' | 'message' | 'close' | 'error' | 'pong', listener: (...args: unknown[]) => void): void;
 }

package/lib/wss-endpoint.js

@@ -1,4 +1,5 @@
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 /**
  * NapCat reverse WSS endpoint — accepts inbound WebSocket from NapCat.
  */
@@ -7,7 +8,7 @@ import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import { createNapCatEndpointManagement } from './endpoint-management.js';
 import { createNapcatSelfProfile } from './self-profile.js';
 import { InboundMessageDeduper, isNapCatBotMentioned, isSelfMessage, normalizeMessage, } from './napcat-inbound.js';
-import { buildSendAction, formatInboundContent, formatOutboundSegments, isMessageEvent, napcatInboundConversation, napcatOutboundTarget, senderNickname, senderUserId, } from './protocol.js';
+import { buildSendAction, extractQuoteId, formatInboundContent, formatOutboundSegments, isMessageEvent, napcatInboundConversation, napcatOutboundTarget, senderNickname, senderUserId, } from './protocol.js';
 import { receiveNapCatSideEvent } from './side-event-dispatch.js';
 import { createNapCatContentPort } from './onebot-get-msg.js';
 import { NapcatClient } from './client.js';
@@ -147,12 +148,15 @@ export class NapCatWssEndpoint extends NapcatClient {
         const conversation = { ...napcatInboundConversation(String(this.#options.id), ev), endpoint: this[endpointSpec].identity };
         const nickname = senderNickname(ev);
         const mentioned = isNapCatBotMentioned(ev);
+        const quoteId = extractQuoteId(ev);
+        const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
         void this[endpointSpec].events.message({
             event: nativeEvent,
             ...(typeof nativeEvent.time === 'number' ? { platformSentAt: nativeEvent.time * 1000 } : {}),
             conversation,
             message: { conversation, id: msgId },
             content: formatInboundContent(ev),
+            ...(segments?.length ? { segments } : {}),
             sender: {
                 id: senderUserId(ev),
                 name: nickname,
@@ -160,6 +164,7 @@ export class NapCatWssEndpoint extends NapcatClient {
             },
             endpointId: this.#options.config.id,
             ...(mentioned ? { mentioned: true } : {}),
+            ...(quoteId ? { replyTo: { id: quoteId } } : {}),
             metadata: Object.freeze({
                 message_type: ev.message_type,
                 user_id: ev.user_id != null ? String(ev.user_id) : undefined,
@@ -197,6 +202,7 @@ export class NapCatWssEndpoint extends NapcatClient {
                 }
                 try {
                     socket.close();
+                    socket.terminate?.();
                 }
                 catch {
                     /* ignore */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-napcat",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "description": "Zhin.js NapCat adapter for Plugin Runtime (WebSocket client, OneBot11 + NapCat extensions)",
   "type": "module",
   "main": "./lib/index.js",
@@ -45,19 +45,20 @@
   },
   "dependencies": {
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.27",
-    "@zhin.js/agent-feature": "1.1.12",
-    "@zhin.js/client": "1.1.23",
+    "@zhin.js/adapter-onebot-events": "0.0.2",
+    "@zhin.js/adapter": "1.1.29",
+    "@zhin.js/agent-feature": "1.1.14",
+    "@zhin.js/client": "1.1.25",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/core": "1.1.55",
-    "@zhin.js/feature-kit": "1.1.11",
-    "@zhin.js/host-http": "1.1.13",
-    "@zhin.js/im-contract": "1.1.10",
+    "@zhin.js/core": "1.1.57",
+    "@zhin.js/feature-kit": "1.1.13",
+    "@zhin.js/host-http": "1.1.15",
+    "@zhin.js/im-contract": "1.1.12",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.13",
-    "@zhin.js/permission": "1.1.11",
-    "@zhin.js/skill": "1.1.12",
-    "@zhin.js/tool": "1.1.14"
+    "@zhin.js/page": "1.1.15",
+    "@zhin.js/permission": "1.1.13",
+    "@zhin.js/skill": "1.1.14",
+    "@zhin.js/tool": "1.1.16"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -65,15 +66,15 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.13",
-    "zhin.js": "1.1.20"
+    "@zhin.js/host-http": "1.1.15",
+    "zhin.js": "1.1.22"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.27",
-    "@zhin.js/command": "^1.1.13",
-    "@zhin.js/core": "^1.1.55",
-    "zhin.js": "^1.1.20"
+    "@zhin.js/adapter": "^1.1.29",
+    "@zhin.js/command": "^1.1.15",
+    "@zhin.js/core": "^1.1.57",
+    "zhin.js": "^1.1.22"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/plugin.js

@@ -4,6 +4,7 @@ import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/pe
 import { createNapcatConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'napcat',
+    configUpdate: { featurePaths: [['nickname'], ['profile'], ['endpoints']] },
     metadata: {
         displayName: 'NapCat Adapter',
     },

package/src/http-endpoint.ts

@@ -1,4 +1,5 @@
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 /**
  * NapCat HTTP endpoint — POST inbound events + HTTP API outbound.
  */
@@ -25,6 +26,7 @@ import {
 import {
   buildSendAction,
   callNapCatHttpAction,
+  extractQuoteId,
   formatInboundContent,
   formatOutboundSegments,
   isMessageEvent,
@@ -171,12 +173,15 @@ export class NapCatHttpEndpoint extends NapcatClient implements Endpoint {
     const conversation = { ...napcatInboundConversation(String(this.#options.id), ev), endpoint: this[endpointSpec].identity };
     const nickname = senderNickname(ev);
     const mentioned = isNapCatBotMentioned(ev);
+    const quoteId = extractQuoteId(ev);
+    const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
     void this[endpointSpec].events.message({
       event: nativeEvent,
       ...(typeof nativeEvent.time === 'number' ? { platformSentAt: nativeEvent.time * 1000 } : {}),
       conversation,
       message: { conversation, id: msgId },
       content: formatInboundContent(ev),
+      ...(segments?.length ? { segments } : {}),
       sender: {
         id: senderUserId(ev),
         name: nickname,
@@ -184,6 +189,7 @@ export class NapCatHttpEndpoint extends NapcatClient implements Endpoint {
       },
       endpointId: this.#options.config.id,
       ...(mentioned ? { mentioned: true } : {}),
+      ...(quoteId ? { replyTo: { id: quoteId } } : {}),
       metadata: Object.freeze({
         message_type: ev.message_type,
         user_id: ev.user_id != null ? String(ev.user_id) : undefined,

package/src/napcat-inbound.ts

@@ -1,27 +1,10 @@
 /**
  * NapCat 入站消息治理：去重、自发过滤、消息归一化
  */
+import { InboundMessageDeduper, promoteInboundMessagePayload } from 'zhin.js/adapter';
 import type { NapCatMessageEvent, MessageSegment } from './protocol.js';
 
-const DEDUPE_TTL_MS = 120_000;
-
-export class InboundMessageDeduper {
-  private readonly seen = new Map<string, number>();
-
-  shouldProcess(messageId: string): boolean {
-    const now = Date.now();
-    for (const [id, t] of this.seen) {
-      if (now - t > DEDUPE_TTL_MS) this.seen.delete(id);
-    }
-    if (this.seen.has(messageId)) return false;
-    this.seen.set(messageId, now);
-    return true;
-  }
-
-  clear(): void {
-    this.seen.clear();
-  }
-}
+export { InboundMessageDeduper };
 
 /** 判断是否为 bot 自身发出的消息 */
 export function isSelfMessage(event: NapCatMessageEvent | {
@@ -67,8 +50,8 @@ export function isNapCatBotMentioned(ev: {
   const uin = String(ev.self_id).trim();
   if (!uin) return false;
   const segments = normalizeMessage(ev.message ?? []);
-  for (const seg of segments) {
-    if (seg.type === 'at' && atTargetMatchesUin(seg.data?.qq, uin)) return true;
+  if (promoteInboundMessagePayload<{ segments: MessageSegment[]; mentioned?: boolean }>({ segments }, uin).mentioned === true) {
+    return true;
   }
   const text = segments
     .map((seg) => (seg.type === 'text' ? String(seg.data?.text ?? '') : ''))

package/src/onebot-get-msg.ts

@@ -82,9 +82,13 @@ export function createNapCatContentPort(
   });
 }
 
+import { toCanonicalSegments } from '@zhin.js/core';
+import type { PendingRpcRequest, EndpointContentPort, EndpointContentResolveContext } from 'zhin.js/adapter';
+import type { ConversationMessage, ConversationReference, ForwardEntry } from '@zhin.js/im-contract';
+
 function canonicalSegments(content: Array<{ type: string; data?: Record<string, unknown> }>) {
-  return Object.freeze(content.map((segment) => Object.freeze({
-    type: segment.type,
+  return Object.freeze(toCanonicalSegments(content).map((segment) => Object.freeze({
+    ...segment,
     data: Object.freeze(segment.data ?? {}),
   })));
 }
@@ -93,5 +97,3 @@ function toMillis(value: unknown): number {
   const time = Number(value);
   return Number.isFinite(time) ? (time < 10_000_000_000 ? time * 1000 : time) : Date.now();
 }
-import type { PendingRpcRequest, EndpointContentPort, EndpointContentResolveContext } from 'zhin.js/adapter';
-import type { ConversationMessage, ConversationReference, ForwardEntry } from '@zhin.js/im-contract';

package/src/protocol.ts

@@ -283,6 +283,25 @@ export function senderNickname(ev: NapCatEvent): string | undefined {
   return typeof name === 'string' && name ? name : undefined;
 }
 
+/**
+ * 回复引用 id：优先取 message 数组中的 {type:'reply', data:{id}} 段；
+ * 兼容部分实现把 reply 放在事件顶层（标量或带 message_id 的对象）。
+ */
+export function extractQuoteId(ev: NapCatEvent): string | undefined {
+  if (Array.isArray(ev.message)) {
+    for (const seg of ev.message) {
+      if (seg?.type === 'reply' && seg.data?.id != null) return String(seg.data.id);
+    }
+  }
+  const reply = ev.reply;
+  if (typeof reply === 'number' || typeof reply === 'string') return String(reply);
+  if (reply && typeof reply === 'object' && 'message_id' in reply) {
+    const id = (reply as { message_id?: unknown }).message_id;
+    if (id != null) return String(id);
+  }
+  return undefined;
+}
+
 /**
  * canonical MediaRef → OneBot `file` 参数：url 直传、base64 → `base64://`、
  * 本地路径 → `file://`（路径在 OneBot 实现侧解析）、kind=file 不透明引用原样透传。

package/src/side-event-dispatch.ts

@@ -1,4 +1,4 @@
-import { receiveOneBotLikeSideEvent } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent } from '@zhin.js/adapter-onebot-events';
 import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
 import type { NapCatEvent } from './protocol.js';

package/src/ws-endpoint.ts

@@ -1,4 +1,5 @@
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 /**
  * NapCat WS client endpoint — outbound connect to NapCat.
  */
@@ -27,6 +28,7 @@ import {
 import {
   buildSendAction,
   buildWsConnectOptions,
+  extractQuoteId,
   formatInboundContent,
   formatOutboundSegments,
   isMessageEvent,
@@ -190,12 +192,15 @@ export class NapCatWsEndpoint extends NapcatClient implements Endpoint {
     const content = formatInboundContent(ev);
     const nickname = senderNickname(ev);
     const mentioned = isNapCatBotMentioned(ev);
+    const quoteId = extractQuoteId(ev);
+    const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
     void this[endpointSpec].events.message({
       event: nativeEvent,
       ...(typeof nativeEvent.time === 'number' ? { platformSentAt: nativeEvent.time * 1000 } : {}),
       conversation,
       message: { conversation, id: msgId },
       content,
+      ...(segments?.length ? { segments } : {}),
       sender: {
         id: senderUserId(ev),
         name: nickname,
@@ -203,6 +208,7 @@ export class NapCatWsEndpoint extends NapcatClient implements Endpoint {
       },
       endpointId: this.#options.config.id,
       ...(mentioned ? { mentioned: true } : {}),
+      ...(quoteId ? { replyTo: { id: quoteId } } : {}),
       metadata: Object.freeze({
         message_type: ev.message_type,
         user_id: ev.user_id != null ? String(ev.user_id) : undefined,
@@ -237,6 +243,7 @@ export class NapCatWsEndpoint extends NapcatClient implements Endpoint {
         }
         try {
           ws.close();
+          ws.terminate?.();
         } catch {
           /* ignore */
         }

package/src/ws-types.ts

@@ -3,6 +3,7 @@ export interface NapCatWsSocket {
   readonly readyState: number;
   send(data: string): void;
   close(code?: number, reason?: string): void;
+  terminate?(): void;
   ping?(): void;
   on(event: 'open' | 'message' | 'close' | 'error' | 'pong', listener: (...args: unknown[]) => void): void;
 }

package/src/wss-endpoint.ts

@@ -1,4 +1,5 @@
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { toCanonicalSegments } from '@zhin.js/core';
 /**
  * NapCat reverse WSS endpoint — accepts inbound WebSocket from NapCat.
  */
@@ -25,6 +26,7 @@ import {
 } from './napcat-inbound.js';
 import {
   buildSendAction,
+  extractQuoteId,
   formatInboundContent,
   formatOutboundSegments,
   isMessageEvent,
@@ -195,12 +197,15 @@ export class NapCatWssEndpoint extends NapcatClient implements Endpoint {
     const conversation = { ...napcatInboundConversation(String(this.#options.id), ev), endpoint: this[endpointSpec].identity };
     const nickname = senderNickname(ev);
     const mentioned = isNapCatBotMentioned(ev);
+    const quoteId = extractQuoteId(ev);
+    const segments = Array.isArray(ev.message) ? toCanonicalSegments(ev.message) : undefined;
     void this[endpointSpec].events.message({
       event: nativeEvent,
       ...(typeof nativeEvent.time === 'number' ? { platformSentAt: nativeEvent.time * 1000 } : {}),
       conversation,
       message: { conversation, id: msgId },
       content: formatInboundContent(ev),
+      ...(segments?.length ? { segments } : {}),
       sender: {
         id: senderUserId(ev),
         name: nickname,
@@ -208,6 +213,7 @@ export class NapCatWssEndpoint extends NapcatClient implements Endpoint {
       },
       endpointId: this.#options.config.id,
       ...(mentioned ? { mentioned: true } : {}),
+      ...(quoteId ? { replyTo: { id: quoteId } } : {}),
       metadata: Object.freeze({
         message_type: ev.message_type,
         user_id: ev.user_id != null ? String(ev.user_id) : undefined,
@@ -246,6 +252,7 @@ export class NapCatWssEndpoint extends NapcatClient implements Endpoint {
         }
         try {
           socket.close();
+          socket.terminate?.();
         } catch {
           /* ignore */
         }