@zhin.js/adapter-napcat 1.1.15 → 1.1.16

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @zhin.js/adapter-napcat
 
+## 1.1.16
+
+### Patch Changes
+
+- 334e92d: 公告：草稿 → 审批 → 发送（ADR 0037 第 1 期切片 B）。
+
+  - 新表 `ai_announcements` 与 `AiAnnouncements`：状态只前进 `draft` → `pending` → `approved` → `sent`，旁路 `rejected` / `expired` / `failed`；`revision` 乐观并发；改正文回到 `draft` 并重算 `content_hash`；待审批默认 24 小时超时。
+  - 新工具 `announcement_draft`（`risk: safe`）：模型只能建草稿，不能提交、审批或发送。
+  - Console `plugin.root.announcements` / `announcement`（读）与 `announcement-create` / `-edit` / `-submit` / `-approve` / `-reject` / `-resend`（动作，暂用 `control:read` / `control:write`）。
+  - 批准即发送：摘要复核 → 控制面 → 会话画像 → 硬闸以公告审批记录作批准（`ToolHardGate.checkPreApproved`，不弹第二张卡）→ `EndpointManagement.sendGroupNotice`（icqq / napcat）。被拦或失败置 `failed`，不自动重试；重发回到 `pending` 需再批一次；摘要不符拒绝（`announcement_hash_mismatch`）。
+  - 审计追加 kind `announcement` 与码 `announcement_drafted` / `_submitted` / `_approved` / `_rejected` / `_expired` / `_sent` / `_send_failed` / `_resend` / `_hash_mismatch`。
+
+- 53bc6a0: 适配器配置标签、端点命令和工具反馈支持中英文；复用当前操作语言，保持协议值、用户内容、身份、权限与发送链路不变。Sandbox 展示使用项目语言，QQ 绑定与交互状态保留完整会话身份。
+- Updated dependencies [334e92d]
+- Updated dependencies [f3b7c9f]
+- Updated dependencies [658a5fb]
+- Updated dependencies [144a17b]
+- Updated dependencies [18296cf]
+- Updated dependencies [08e64de]
+- Updated dependencies [9cade30]
+- Updated dependencies [53bc6a0]
+- Updated dependencies [7595136]
+- Updated dependencies [66b6404]
+- Updated dependencies [adb4af2]
+- Updated dependencies [69f9ef6]
+- Updated dependencies [17d1301]
+  - @zhin.js/adapter@1.1.23
+  - @zhin.js/host-http@1.1.10
+  - @zhin.js/core@1.1.51
+  - @zhin.js/permission@1.1.9
+  - @zhin.js/tool@1.1.10
+  - @zhin.js/skill@1.1.10
+  - @zhin.js/im-contract@1.1.7
+  - @zhin.js/agent-feature@1.1.10
+  - @zhin.js/feature-kit@1.1.9
+
 ## 1.1.15
 
 ### Patch Changes

package/agents/napcat/messages.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    "likesSent": {
+        "zh-CN": "已给 {p0} 点赞 {p1} 次",
+        "en": "Sent {p1} likes to {p0}"
+    },
+    "memberTitleSet": {
+        "zh-CN": "已设置 {p0} 头衔为 \"{p1}\"",
+        "en": "Title for {p0} set to \"{p1}\""
+    },
+    "userPoked": {
+        "zh-CN": "已戳 {p0}",
+        "en": "Poked {p0}"
+    }
+});

package/agents/napcat/messages.ts

@@ -0,0 +1,16 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  "likesSent": {
+    "zh-CN": "已给 {p0} 点赞 {p1} 次",
+    "en": "Sent {p1} likes to {p0}"
+  },
+  "memberTitleSet": {
+    "zh-CN": "已设置 {p0} 头衔为 \"{p1}\"",
+    "en": "Title for {p0} set to \"{p1}\""
+  },
+  "userPoked": {
+    "zh-CN": "已戳 {p0}",
+    "en": "Poked {p0}"
+  }
+});

package/agents/napcat/skills/napcat-account/tools/send_like/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -13,6 +14,6 @@ export default defineAgentTool({
     async execute({ user_id, times }, context) {
         const endpoint = context.$client;
         await endpoint.sendLike(user_id, times || 1);
-        return { success: true, message: `已给 ${user_id} 点赞 ${times || 1} 次` };
+        return { success: true, message: t(context.locale, 'likesSent', { p0: user_id, p1: times || 1 }) };
     },
 });

package/agents/napcat/skills/napcat-account/tools/send_like/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -13,6 +14,6 @@ export default defineAgentTool<{ user_id: number; times?: number }>({
   async execute({ user_id, times }: { user_id: number; times?: number }, context) {
     const endpoint = context.$client;
       await endpoint.sendLike(user_id, times || 1);
-      return { success: true, message: `已给 ${user_id} 点赞 ${times || 1} 次` };
+      return { success: true, message: t(context.locale, 'likesSent', { p0: user_id, p1: times || 1 }) };
   },
 });

package/agents/napcat/skills/napcat-group-settings/tools/set_title/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -16,6 +17,6 @@ export default defineAgentTool({
     async execute({ group_id, user_id, title }, context) {
         const endpoint = context.$client;
         await endpoint.setTitle(group_id, user_id, title);
-        return { success: true, message: `已设置 ${user_id} 头衔为 "${title}"` };
+        return { success: true, message: t(context.locale, 'memberTitleSet', { p0: user_id, p1: title }) };
     },
 });

package/agents/napcat/skills/napcat-group-settings/tools/set_title/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -16,6 +17,6 @@ export default defineAgentTool<{ group_id: number; user_id: number; title: strin
   async execute({ group_id, user_id, title }: { group_id: number; user_id: number; title: string }, context) {
     const endpoint = context.$client;
       await endpoint.setTitle(group_id, user_id, title);
-      return { success: true, message: `已设置 ${user_id} 头衔为 "${title}"` };
+      return { success: true, message: t(context.locale, 'memberTitleSet', { p0: user_id, p1: title }) };
   },
 });

package/agents/napcat/skills/napcat-messaging/tools/send_poke/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
@@ -13,6 +14,6 @@ export default defineAgentTool({
     async execute({ user_id, group_id }, context) {
         const endpoint = context.$client;
         await endpoint.sendPoke(user_id, group_id);
-        return { success: true, message: `已戳 ${user_id}` };
+        return { success: true, message: t(context.locale, 'userPoked', { p0: user_id }) };
     },
 });

package/agents/napcat/skills/napcat-messaging/tools/send_poke/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from "../../../../messages.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
@@ -13,6 +14,6 @@ export default defineAgentTool<{ user_id: number; group_id?: number }>({
   async execute({ user_id, group_id }: { user_id: number; group_id?: number }, context) {
     const endpoint = context.$client;
       await endpoint.sendPoke(user_id, group_id);
-      return { success: true, message: `已戳 ${user_id}` };
+      return { success: true, message: t(context.locale, 'userPoked', { p0: user_id }) };
   },
 });

package/commands/napcat/endpoint/definition.js

@@ -10,10 +10,10 @@ export const napcatEndpointCommands = createEndpointCommands({
     adapterKey: 'napcat',
     adapterDisplayName: 'NapCat',
     fields: [
-        { key: 'url', description: 'NapCat WebSocket URL（connection: ws 必填）' },
-        { key: 'path', description: 'reverse-wss 路径（connection: wss）' },
-        { key: 'http_url', description: 'HTTP API base URL（connection: http 出站）' },
-        { key: 'post_path', description: 'HTTP POST 事件路径（connection: http 入站）' },
+        { key: 'url', description: 'NapCat WebSocket URL（connection: ws 必填）', descriptionI18n: { en: "NapCat WebSocket URL (required for connection: ws)" } },
+        { key: 'path', description: 'reverse-wss 路径（connection: wss）', descriptionI18n: { en: "Reverse WebSocket path (connection: wss)" } },
+        { key: 'http_url', description: 'HTTP API base URL（connection: http 出站）', descriptionI18n: { en: "HTTP API base URL (outbound connection: http)" } },
+        { key: 'post_path', description: 'HTTP POST 事件路径（connection: http 入站）', descriptionI18n: { en: "HTTP POST event path (inbound connection: http)" } },
         { key: 'access_token', env: true, description: 'NapCat access token' },
     ],
     running: (use) => use(napcatRuntimeStateToken).endpoints.values(),

package/commands/napcat/endpoint/definition.ts

@@ -10,10 +10,10 @@ export const napcatEndpointCommands = createEndpointCommands({
   adapterKey: 'napcat',
   adapterDisplayName: 'NapCat',
   fields: [
-    { key: 'url', description: 'NapCat WebSocket URL（connection: ws 必填）' },
-    { key: 'path', description: 'reverse-wss 路径（connection: wss）' },
-    { key: 'http_url', description: 'HTTP API base URL（connection: http 出站）' },
-    { key: 'post_path', description: 'HTTP POST 事件路径（connection: http 入站）' },
+    { key: 'url', description: 'NapCat WebSocket URL（connection: ws 必填）', descriptionI18n: { en: "NapCat WebSocket URL (required for connection: ws)" } },
+    { key: 'path', description: 'reverse-wss 路径（connection: wss）', descriptionI18n: { en: "Reverse WebSocket path (connection: wss)" } },
+    { key: 'http_url', description: 'HTTP API base URL（connection: http 出站）', descriptionI18n: { en: "HTTP API base URL (outbound connection: http)" } },
+    { key: 'post_path', description: 'HTTP POST 事件路径（connection: http 入站）', descriptionI18n: { en: "HTTP POST event path (inbound connection: http)" } },
     { key: 'access_token', env: true, description: 'NapCat access token' },
   ],
   running: (use) => use(napcatRuntimeStateToken).endpoints.values(),

package/lib/endpoint-management.js

@@ -27,6 +27,12 @@ export function createNapCatEndpointManagement(endpoint) {
             });
             return toArray(data);
         },
+        async sendGroupNotice(groupId, content) {
+            await endpoint.callApi('_send_group_notice', {
+                group_id: toNumberId(groupId, 'group_id'),
+                content,
+            });
+        },
     });
 }
 function asRecord(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-napcat",
-  "version": "1.1.15",
+  "version": "1.1.16",
   "description": "Zhin.js NapCat adapter for Plugin Runtime (WebSocket client, OneBot11 + NapCat extensions)",
   "type": "module",
   "main": "./lib/index.js",
@@ -44,16 +44,16 @@
   },
   "dependencies": {
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.22",
-    "@zhin.js/agent-feature": "1.1.9",
-    "@zhin.js/core": "1.1.50",
-    "@zhin.js/feature-kit": "1.1.8",
-    "@zhin.js/host-http": "1.1.9",
-    "@zhin.js/im-contract": "1.1.6",
+    "@zhin.js/adapter": "1.1.23",
+    "@zhin.js/agent-feature": "1.1.10",
+    "@zhin.js/core": "1.1.51",
+    "@zhin.js/im-contract": "1.1.7",
+    "@zhin.js/feature-kit": "1.1.9",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/permission": "1.1.8",
-    "@zhin.js/skill": "1.1.9",
-    "@zhin.js/tool": "1.1.9"
+    "@zhin.js/permission": "1.1.9",
+    "@zhin.js/host-http": "1.1.10",
+    "@zhin.js/skill": "1.1.10",
+    "@zhin.js/tool": "1.1.10"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -61,15 +61,15 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.9",
-    "zhin.js": "1.1.15"
+    "zhin.js": "1.1.16",
+    "@zhin.js/host-http": "1.1.10"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.22",
-    "@zhin.js/command": "^1.1.10",
-    "@zhin.js/core": "^1.1.50",
-    "zhin.js": "^1.1.15"
+    "@zhin.js/adapter": "^1.1.23",
+    "@zhin.js/core": "^1.1.51",
+    "@zhin.js/command": "^1.1.11",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {

package/schema.json

@@ -30,7 +30,12 @@
         "string",
         "number"
       ],
-      "description": "框架 master（QQ uin；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+      "description": "框架 master（QQ uin；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Framework masters (QQ uin; AI/tool permissions and endpoint management). endpoints[i].master can override this value."
+        }
+      }
     },
     "trusted": {
       "type": "array",
@@ -41,7 +46,12 @@
         ],
         "description": "Trusted QQ uin"
       },
-      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加",
+      "x-i18n": {
+        "en": {
+          "description": "Framework trusted users, below master authority. endpoints[i].trusted can add users."
+        }
+      }
     },
     "endpoints": {
       "type": "array",
@@ -56,7 +66,12 @@
               "string",
               "number"
             ],
-            "description": "本 endpoint 的框架 master（QQ uin）；覆盖顶层 master"
+            "description": "本 endpoint 的框架 master（QQ uin）；覆盖顶层 master",
+            "x-i18n": {
+              "en": {
+                "description": "Framework masters for this endpoint (QQ uin), overriding the top-level master list."
+              }
+            }
           },
           "trusted": {
             "type": "array",
@@ -67,7 +82,12 @@
               ],
               "description": "Trusted QQ uin"
             },
-            "description": "本 endpoint 的 trusted 列表"
+            "description": "本 endpoint 的 trusted 列表",
+            "x-i18n": {
+              "en": {
+                "description": "Trusted users for this endpoint."
+              }
+            }
           },
           "connection": {
             "type": "string",
@@ -117,12 +137,22 @@
         "required": [
           "id"
         ]
+      },
+      "x-i18n": {
+        "en": {
+          "description": "Multiple accounts: mount multiple endpoints in one plugin instance. Each entry uses the top-level fields; id is required and other fields override defaults."
+        }
       }
     },
     "commandPrefix": {
       "type": "string",
       "default": "",
-      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖"
+      "description": "命令前缀（默认 '' 无前缀，任意文本按命令匹配；如 '/' 要求 / 开头）。endpoints[i] 可逐项覆盖",
+      "x-i18n": {
+        "en": {
+          "description": "Command prefix. The default empty string allows unprefixed commands; '/' requires a leading slash. Each endpoints[i] can override it."
+        }
+      }
     }
   },
   "required": [

package/src/endpoint-management.ts

@@ -49,6 +49,12 @@ export function createNapCatEndpointManagement(
       });
       return toArray(data);
     },
+    async sendGroupNotice(groupId: string, content: string): Promise<void> {
+      await endpoint.callApi('_send_group_notice', {
+        group_id: toNumberId(groupId, 'group_id'),
+        content,
+      });
+    },
   });
 }