@zhin.js/adapter-napcat 1.1.14 → 1.1.16

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # @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
+
+- 7d68df6: 精简 Agent 内置固定提示词与消息说明，保留工具、审批和结构化回复能力。适配器 Skill 按会话场景拆分，群／频道管理仅向对应场景披露；提示段与模型消息段支持场景声明，沿用当前回合权限和 generation 投影。
+- Updated dependencies [f98025b]
+- Updated dependencies [66ec1a5]
+- Updated dependencies [7d68df6]
+- Updated dependencies [bf0fa9f]
+- Updated dependencies [3326db3]
+- Updated dependencies [e91235e]
+- Updated dependencies [6da2bad]
+- Updated dependencies [3781f1c]
+  - @zhin.js/core@1.1.50
+  - @zhin.js/adapter@1.1.22
+  - @zhin.js/im-contract@1.1.6
+  - @zhin.js/tool@1.1.9
+  - @zhin.js/host-http@1.1.9
+  - @zhin.js/agent-feature@1.1.9
+  - @zhin.js/feature-kit@1.1.8
+  - @zhin.js/permission@1.1.8
+  - @zhin.js/skill@1.1.9
+
 ## 1.1.14
 
 ### 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-files-history/SKILL.md

@@ -2,21 +2,13 @@
 name: napcat-files-history
 platforms:
   - napcat
-description: NapCatQQ 群文件、下载地址和消息历史能力。
+description: NapCatQQ 文件下载。
 keywords:
-  - "napcat"
-  - "群文件"
-  - "下载"
-  - "消息历史"
+  - napcat
+  - 下载
 tools:
-  - "upload_group_file"
-  - "get_group_file_url"
-  - "get_group_root_files"
-  - "download_file"
-  - "get_group_msg_history"
-  - "get_friend_msg_history"
+  - download_file
 ---
-
 # napcat-files-history
 
-文件和历史记录可能包含敏感内容，只读取完成任务所需范围；上传前确认目标群和文件。
+下载给定文件到缓存目录；只读取任务必需范围，保留工具返回的真实路径。

package/agents/napcat/skills/napcat-group-content/SKILL.md

@@ -4,18 +4,19 @@ platforms:
   - napcat
 description: NapCatQQ 群公告与精华消息管理能力。
 keywords:
-  - "napcat"
-  - "群公告"
-  - "精华消息"
+  - napcat
+  - 群公告
+  - 精华消息
 tools:
-  - "set_essence_msg"
-  - "delete_essence_msg"
-  - "get_essence_list"
-  - "send_group_notice"
-  - "get_group_notice"
-  - "del_group_notice"
+  - set_essence_msg
+  - delete_essence_msg
+  - get_essence_list
+  - send_group_notice
+  - get_group_notice
+  - del_group_notice
+scopes:
+  - group
 ---
-
 # napcat-group-content
 
 先读取现有公告或精华列表，再进行创建、删除或变更；删除操作必须复核稳定 ID。

package/agents/napcat/skills/napcat-group-files-history/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: napcat-group-files-history
+platforms:
+  - napcat
+scopes:
+  - group
+description: NapCatQQ 群文件与群消息历史。
+keywords:
+  - napcat
+  - 群文件
+  - 消息历史
+tools:
+  - upload_group_file
+  - get_group_file_url
+  - get_group_root_files
+  - get_group_msg_history
+---
+# napcat-group-files-history
+
+文件和历史可能包含敏感内容，只读取任务必需范围；上传前确认目标群和文件。

package/agents/napcat/skills/napcat-group-media/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: napcat-group-media
+platforms:
+  - napcat
+scopes:
+  - group
+description: NapCatQQ 群 AI 语音角色查询与 TTS。
+keywords:
+  - napcat
+  - tts
+  - 语音
+tools:
+  - ai_tts
+  - get_ai_characters
+---
+# napcat-group-media
+
+先查询角色，再生成群 AI 语音；确认目标群。

package/agents/napcat/skills/napcat-group-settings/SKILL.md

@@ -4,20 +4,21 @@ platforms:
   - napcat
 description: NapCatQQ 群状态、群头像、头衔与签到设置能力。
 keywords:
-  - "napcat"
-  - "群设置"
-  - "群头像"
-  - "头衔"
-  - "签到"
-  - "禁言"
+  - napcat
+  - 群设置
+  - 群头像
+  - 头衔
+  - 签到
+  - 禁言
 tools:
-  - "get_group_shut_list"
-  - "set_group_portrait"
-  - "set_title"
-  - "group_sign"
-  - "get_group_info_ex"
+  - get_group_shut_list
+  - set_group_portrait
+  - set_title
+  - group_sign
+  - get_group_info_ex
+scopes:
+  - group
 ---
-
 # napcat-group-settings
 
 查询群状态后再修改群设置。头像和头衔变更遵守审批策略，不根据昵称猜测成员。

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-media/SKILL.md

@@ -2,22 +2,17 @@
 name: napcat-media
 platforms:
   - napcat
-description: NapCatQQ TTS、OCR、小程序卡片与翻译能力。
+description: NapCatQQ OCR、小程序卡片与翻译。
 keywords:
-  - "napcat"
-  - "tts"
-  - "ocr"
-  - "语音"
-  - "翻译"
-  - "小程序"
+  - napcat
+  - ocr
+  - 翻译
+  - 小程序
 tools:
-  - "ai_tts"
-  - "get_ai_characters"
-  - "ocr_image"
-  - "get_mini_app_ark"
-  - "translate"
+  - ocr_image
+  - get_mini_app_ark
+  - translate
 ---
-
 # napcat-media
 
-按媒体任务选择单个工具。生成语音前先确定角色；OCR 与翻译结果保留不确定性。
+按任务选择 OCR、小程序卡片或翻译工具；只使用真实输入，保留识别和翻译结果的不确定性。

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/agents/napcat/skills/napcat-private-history/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: napcat-private-history
+platforms:
+  - napcat
+scopes:
+  - private
+description: NapCatQQ 私聊消息历史。
+keywords:
+  - napcat
+  - 消息历史
+tools:
+  - get_friend_msg_history
+---
+# napcat-private-history
+
+只读取任务必需的私聊记录，不把其他会话的历史发送给当前用户。

package/agents/napcat/skills/{napcat-files-history → napcat-private-history}/tools/get_friend_msg_history/index.js

@@ -9,6 +9,7 @@ export default defineAgentTool({
         count: z.number().optional().describe('获取条数（可选）'),
     }),
     adapter: 'napcat',
+    scopes: ["private"],
     tags: ['napcat', 'qq'],
     keywords: ['私聊记录', '好友聊天记录', 'friend history'],
     async execute({ user_id, message_seq, count }, context) {

package/agents/napcat/skills/{napcat-files-history → napcat-private-history}/tools/get_friend_msg_history/index.ts

@@ -9,6 +9,7 @@ export default defineAgentTool<{ user_id: number; message_seq?: number; count?:
     count: z.number().optional().describe('获取条数（可选）'),
   }),
   adapter: 'napcat',
+  scopes: ["private"],
   tags: ['napcat', 'qq'],
   keywords: ['私聊记录', '好友聊天记录', 'friend history'],
   async execute({ user_id, message_seq, count }: { user_id: number; message_seq?: number; count?: number }, context) {

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.14",
+  "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.21",
-    "@zhin.js/agent-feature": "1.1.8",
-    "@zhin.js/feature-kit": "1.1.7",
-    "@zhin.js/host-http": "1.1.8",
-    "@zhin.js/im-contract": "1.1.5",
+    "@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.7",
-    "@zhin.js/skill": "1.1.8",
-    "@zhin.js/tool": "1.1.8",
-    "@zhin.js/core": "1.1.49"
+    "@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.8",
-    "zhin.js": "1.1.14"
+    "zhin.js": "1.1.16",
+    "@zhin.js/host-http": "1.1.10"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.21",
-    "@zhin.js/command": "^1.1.9",
-    "zhin.js": "^1.1.14",
-    "@zhin.js/core": "^1.1.49"
+    "@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,
+      });
+    },
   });
 }