@zhin.js/adapter-icqq 1.1.15 → 1.1.17

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # @zhin.js/adapter-icqq
 
+## 1.1.17
+
+### Patch Changes
+
+- e23cabc: ADR 0041 slice B: the turn context now carries real scene facts. `EndpointManagement` gains `inspectGroupScene` (name, owner, admins, member count, global mute) and `inspectGroupMemberProfile` (role, card, title, mute expiry; one lookup), implemented by the ICQQ adapter from uncached group/member reads. The CLI resolves them per turn (bot role always fresh; group and sender facts reuse a 60 s, 256-entry in-memory cache scoped to the generation; failures omit fields) and the inbound actor now carries `groupNickname` / `groupTitle` / `mutedUntil` plus the platform role. The Session / Bot state blocks are replaced by one projected scene line `[scene_id:…;scene_type:…;scene_name:…;owner_id:…;admins:…;member_count:…;global_mute:…;assistant_role:…;]` (values escaped and clipped to 64 chars). No new on-disk state.
+- 4d728c0: ADR 0043 §4 + §5 (H4) and the ADR 0041 actor-only amendment. Participant headers are no longer stored: user messages keep only `actor`, assistant messages keep `assistantActor` (plus the delivered `messageId`), and the header is rendered at the LLM boundary; legacy rows that still carry `name` are read as before. Headers now use session message aliases `id:m<n>` (an ordinal over the stored active path, so already-sent prefixes never change), `time:HH:mm` shown only when a minute has passed since the last shown time (the first message and the first message of a day also carry `date`), and `reply_to:m<n>` when the message replies to one inside the visible window. A reply to a message outside the window gets one `[quote id:…;user_id:…;time:…;] <first 120 chars>` line (media as placeholders, a forward expanded one level) so the model no longer needs `inspect_conversation_reference` for ordinary quotes; the quote is resolved by the ingress through the reference port (3 s timeout) and stored as structured `UserMessage.quote`. Tool arguments named `message_id` / `message_ids` / `*_message_id` / `reference` and `reply` segments accept the alias as well as the platform id; `inspect_conversation_reference` also accepts the quoted message id.
+- 51f1328: 修复 icqq 群成员相关 Agent 工具：`group_member_info` 返回空对象（模型据此误判成员不在群里）、`group_invite` 永远判定"已在群里"、`set_mute` / `set_title` / `set_anonymous` 读旧缓存误判 Bot 不是管理员。统一改为实时查询群成员。
+- d0e1fac: Keep stable prompt instructions ahead of turn-specific capabilities, project unchanged context without placeholder text, and retain scoped state snapshots with readable updates and compaction recovery. Preserve native conversation/tool chronology and separate participant identity from runtime guidance.
+
+  Resolve the ICQQ bot account and current-group role before capability discovery, and support explicitly declared current-conversation bot-role requirements without changing existing requester permissions or approvals. Keep role lookup failures unknown and preserve execution-time platform checks.
+
+- 3771f7a: 修复同一群先后两人入群时后一次入群被当重复事件丢掉：side event 去重键（core 与 icqq）加入成员与操作人。
+- 4f96ad5: Fix member-join welcome display: icqq now sends the mention's display name as the `at` element text, the joining member's nickname from the notice is threaded into `target.name`, and icqq group messages populate `conversation.name` from `group_name` so `{group}` renders the group name instead of the group number.
+- Updated dependencies [f67883e]
+- Updated dependencies [e23cabc]
+- Updated dependencies [4d728c0]
+- Updated dependencies [eb8feeb]
+- Updated dependencies [24a2b71]
+- Updated dependencies [d0e1fac]
+- Updated dependencies [3771f7a]
+- Updated dependencies [4f96ad5]
+  - @zhin.js/core@1.1.52
+  - @zhin.js/adapter@1.1.24
+  - @zhin.js/tool@1.1.11
+  - @zhin.js/im-contract@1.1.8
+
+## 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`。
+
+- 08e64de: Expose current ICQQ conversation and bot-role inspection through a private Agent skill. Add conversation-scoped quote, merged-forward, own/member recall, and owner-approved leave-group tools with live platform checks and documented guild-channel limitations.
+
+  Include real message IDs in the existing turn and conversation context so message operations can target actual messages without guessing.
+
+- 53bc6a0: 适配器配置标签、端点命令和工具反馈支持中英文；复用当前操作语言，保持协议值、用户内容、身份、权限与发送链路不变。Sandbox 展示使用项目语言，QQ 绑定与交互状态保留完整会话身份。
+- Updated dependencies [334e92d]
+- 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/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/PERMITS.md

@@ -1,24 +1,20 @@
-# ICQQ Platform Permits（QQ 群）
+# ICQQ Agent 权限与会话信息
 
-## 入站字段
+调用者的角色与 Bot 的平台角色相互独立。`role(master,admin,trusted,owner)` 由框架校验调用者；它不代表 Bot 是群管理员。群管操作还需检查 Bot 与目标成员的实时平台身份。
 
-群成员 `owner` / `admin` / `member` 写入 `$sender.role`（IPC 侧已有）。
+选择 ICQQ Agent 后，先从目录加载对应 Skill，其私有工具才会暴露。`icqq-conversation` 的 `conversation_info` 按当前 endpoint 查询 Bot 自己的身份及群／频道信息，不把共享会话画像当作权限依据，也不在每条聊天消息前增加一次角色查询。
 
-## Permit 词汇表
+| Skill / 工具 | 调用方要求 | 平台能力与审批 |
+|---|---|---|
+| `icqq-conversation` / `conversation_info` | 当前 ICQQ 会话 | 只读，无逐次审批；群角色实时查询，频道查不到自身记录时为 unknown |
+| `icqq-messages` / `quote_reply`、`forward_messages` | 普通消息操作权限 | 当前群／私聊的真实消息，无逐次审批；发送经过统一出站链路 |
+| `icqq-messages` / `recall_own_message` | 不要求群管角色 | 必须是 Bot 自己在当前群／私聊的发言，无逐次审批；由平台决定可撤回时限 |
+| `icqq-group-admin` / `recall_member_message` | master/admin/trusted/owner | 无逐次审批；Bot 管理员可撤回普通成员，Bot 群主可撤回管理员或普通成员，执行前实时检查 |
+| `icqq-group-admin` / `group_leave` | 仅 master | 当前群，每次人工审批；Bot 为群主时拒绝，以免 SDK 解散群 |
+| `icqq-group-admin` / `group_kick` | master/admin/trusted/owner | 每次人工审批；执行前检查 Bot 与目标成员角色 |
 
-平台范围用工具的 `platforms: ['icqq']`，不要写非法的 `platform(icqq)`（缺 perm 时 PermissionHost 会直接拒绝，工具对模型不可见）。
+已配置的自动群审核独立按获准规则执行撤回；上述工具不新增审核触发条件、敏感类别、处罚或目标群。Bot 对自己的消息始终不需要群管权限；平台拒绝或未确认时不能宣称撤回成功，也不自动重试。
 
-| `platform(icqq,…)` | 含义 |
-|--------------------|------|
-| `scene_owner` | 群主 |
-| `scene_admin` | 群管理员（含群主） |
+引用和转发只接受当前会话内可核实的原消息 ID，不允许跨会话读取／转发或伪造作者。读取入站引用和转发仍使用 `inspect_conversation_reference`，它不是发送工具。
 
-## 扩展工具示例
-
-| 工具 | permit |
-|------|--------|
-| `icqq_set_title` | `scene_owner` |
-| `icqq_announce` / `icqq_essence` / `icqq_list_muted` | `scene_admin` |
-| `icqq_set_anonymous` | `scene_owner` |
-
-工厂群管工具使用默认 `scene_admin` / `scene_owner`。
+当前 guild-channel 接入可查询频道信息和 Bot 的 guild 角色，但没有这些消息操作和退群工具。SDK 的成员列表可能不完整；`channel_admin` 也未携带所管子频道的范围，不能据此判断当前子频道有管理权限。不要把 QQ 号、群号、guild ID 和 tiny ID 混用。

package/README.md

@@ -167,6 +167,12 @@ IM turn 的场景，才使用 `icqqClient.get(context, endpointId)` 显式选择
 - `system.*`（登录扫码等）分发到 `system.receive`。
 - **登录辅助**：`system.login.qrcode|slider|device|auth` 经 `loginAssistToken`（`LoginAssist`）挂起待办；刷新后可用 Console `login.list` / `login.submit` 或终端 stdin 继续（对齐 icqq 官方 stdin 流程）。`system.online` / `login.error` 会清理该 endpoint 待办。
 
+## Agent 会话与消息操作
+
+ICQQ Agent 可按需加载 `icqq-conversation` 查询当前群／频道和 Bot 自身角色。`icqq-messages` 提供当前会话的引用回复、真实消息合并转发和撤回自己发言；自己的消息撤回不要求群管身份或逐次审批，时限由平台决定。
+
+`icqq-group-admin` 新增撤回他人消息与退群：前者保留群管发起权限、实时平台角色检查，无需逐次审批；退群仅主人可发起、每次审批，Bot 为群主时拒绝执行。引用／转发走统一发送链路，不支持跨会话转发。当前 guild-channel 接入仅提供身份查询，不能使用这些群／私聊操作。详见 [权限与能力说明](./PERMITS.md)。
+
 ## 故障排查
 
 | 现象 | 排查 |
@@ -192,3 +198,9 @@ ICQQ 要求分享、文件、语音、视频、JSON 卡片和合并转发单独
 
 - 回执的消息 ID 取第一条拿到 ID 的部分；所有部分都没有 ID（如单独一张分享）时，仍报告投递结果未知。
 - 第一条就失败时原样报告失败；后面的部分失败时报告 `partial_delivery`（结果未知），因为前面的部分已经送达，重发会重复。
+
+## 语言
+
+Endpoint 管理和工具反馈跟随当前操作语言；登录没有当前聊天发送者，LoginAssist 提示采用项目语言。提示文案变化不改变扫码、短信、滑块验证过程，群管理权限、审批与平台结果检查保持原规则。
+
+Endpoint 添加用法中的调用头由当前环境的实际命令前缀与插件命名空间提供；未知时只提示所需参数，不生成猜测命令。

package/adapters/icqq/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { projectLocaleToken } from 'zhin.js/i18n';
 /**
  * Convention entry: discover `adapters/icqq/index.ts` → defineAdapter.
  */
@@ -46,6 +47,7 @@ export default defineAdapter({
         return new IcqqEndpoint({
             id: context.id,
             loginAssist: context.use(loginAssistToken),
+            locale: context.use(projectLocaleToken),
             config,
         });
     },

package/adapters/icqq/index.ts

@@ -1,3 +1,4 @@
+import { projectLocaleToken } from 'zhin.js/i18n';
 /**
  * Convention entry: discover `adapters/icqq/index.ts` → defineAdapter.
  */
@@ -57,6 +58,7 @@ export default defineAdapter<IcqqEndpointConfig>({
     return new IcqqEndpoint({
       id: context.id,
       loginAssist: context.use(loginAssistToken),
+      locale: context.use(projectLocaleToken),
       config,
     });
   },

package/agents/icqq/conversation.js

@@ -0,0 +1,72 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { parseDmMessageId, parseGroupMessageId } from '@icqqjs/icqq';
+import { outboundMessageToken } from '@zhin.js/core/runtime';
+import { messages as t } from './messages.js';
+/** The trusted turn owns the account and address; model input cannot select another one. */
+export function currentConversation(context) {
+    const { origin } = context;
+    if (origin.kind !== 'im' || origin.platform !== 'icqq' || !origin.conversation) {
+        throw new Error(t(context.locale, 'conversationRequired'));
+    }
+    context.signal.throwIfAborted();
+    return origin.conversation;
+}
+export function currentGroup(context) {
+    const conversation = currentConversation(context);
+    if (conversation.kind !== 'group')
+        throw new Error(t(context.locale, 'groupRequired'));
+    return Number(conversation.id);
+}
+/** getMsg returns the last history item, which is not necessarily the requested message. */
+export async function resolveMessage(context, id) {
+    const conversation = currentConversation(context);
+    const invalid = () => new Error(t(context.locale, 'messageOutsideConversation'));
+    if (conversation.kind === 'channel')
+        throw new Error(t(context.locale, 'channelOperationUnsupported'));
+    // Check the encoded destination before requesting any history from the platform.
+    try {
+        const address = id.length > 24 ? parseGroupMessageId(id) : parseDmMessageId(id);
+        if (conversation.kind === 'group'
+            ? !('group_id' in address) || String(address.group_id) !== conversation.id
+            : 'group_id' in address || String(address.user_id) !== conversation.id)
+            throw invalid();
+    }
+    catch {
+        throw invalid();
+    }
+    const message = await context.$client.getMsg(id);
+    context.signal.throwIfAborted();
+    if (!message || message.message_id !== id)
+        throw invalid();
+    if (conversation.kind === 'group') {
+        if (message.message_type !== 'group' || String(message.group_id) !== conversation.id)
+            throw invalid();
+    }
+    else {
+        if (message.message_type !== 'private')
+            throw invalid();
+        const self = context.$client.uin;
+        const peer = Number(conversation.id);
+        if (!((message.from_id === self && message.to_id === peer)
+            || (message.from_id === peer && message.to_id === self)))
+            throw invalid();
+        const parent = conversation.parent?.kind === 'group' ? Number(conversation.parent.id) : undefined;
+        if (message.sender.group_id !== parent)
+            throw invalid();
+    }
+    return message;
+}
+export async function sendToConversation(context, content) {
+    const conversation = currentConversation(context);
+    const receipt = await context.use(outboundMessageToken).send({
+        requester: context.owner.id,
+        conversation,
+        content,
+    });
+    return { success: receipt.status === 'sent', receipt };
+}
+export async function recallMessage(context, id) {
+    context.signal.throwIfAborted();
+    const success = await context.$client.deleteMsg(id);
+    return { success, message: t(context.locale, success ? 'messageRecalled' : 'recallUnconfirmed') };
+}

package/agents/icqq/conversation.ts

@@ -0,0 +1,67 @@
+import { parseDmMessageId, parseGroupMessageId, type GroupMessage, type PrivateMessage } from '@icqqjs/icqq';
+import { outboundMessageToken, type SendContent } from '@zhin.js/core/runtime';
+import type { ToolExecutionContext } from '@zhin.js/tool';
+import { messages as t } from './messages.js';
+
+export type IcqqToolContext = ToolExecutionContext<unknown, 'icqq'>;
+
+/** The trusted turn owns the account and address; model input cannot select another one. */
+export function currentConversation(context: IcqqToolContext) {
+  const { origin } = context;
+  if (origin.kind !== 'im' || origin.platform !== 'icqq' || !origin.conversation) {
+    throw new Error(t(context.locale, 'conversationRequired'));
+  }
+  context.signal.throwIfAborted();
+  return origin.conversation;
+}
+
+export function currentGroup(context: IcqqToolContext) {
+  const conversation = currentConversation(context);
+  if (conversation.kind !== 'group') throw new Error(t(context.locale, 'groupRequired'));
+  return Number(conversation.id);
+}
+
+/** getMsg returns the last history item, which is not necessarily the requested message. */
+export async function resolveMessage(context: IcqqToolContext, id: string): Promise<GroupMessage | PrivateMessage> {
+  const conversation = currentConversation(context);
+  const invalid = () => new Error(t(context.locale, 'messageOutsideConversation'));
+  if (conversation.kind === 'channel') throw new Error(t(context.locale, 'channelOperationUnsupported'));
+  // Check the encoded destination before requesting any history from the platform.
+  try {
+    const address = id.length > 24 ? parseGroupMessageId(id) : parseDmMessageId(id);
+    if (conversation.kind === 'group'
+      ? !('group_id' in address) || String(address.group_id) !== conversation.id
+      : 'group_id' in address || String(address.user_id) !== conversation.id) throw invalid();
+  } catch { throw invalid(); }
+  const message = await context.$client.getMsg(id);
+  context.signal.throwIfAborted();
+  if (!message || message.message_id !== id) throw invalid();
+  if (conversation.kind === 'group') {
+    if (message.message_type !== 'group' || String(message.group_id) !== conversation.id) throw invalid();
+  } else {
+    if (message.message_type !== 'private') throw invalid();
+    const self = context.$client.uin;
+    const peer = Number(conversation.id);
+    if (!((message.from_id === self && message.to_id === peer)
+      || (message.from_id === peer && message.to_id === self))) throw invalid();
+    const parent = conversation.parent?.kind === 'group' ? Number(conversation.parent.id) : undefined;
+    if (message.sender.group_id !== parent) throw invalid();
+  }
+  return message;
+}
+
+export async function sendToConversation(context: IcqqToolContext, content: SendContent) {
+  const conversation = currentConversation(context);
+  const receipt = await context.use(outboundMessageToken).send({
+    requester: context.owner.id,
+    conversation,
+    content,
+  });
+  return { success: receipt.status === 'sent', receipt };
+}
+
+export async function recallMessage(context: IcqqToolContext, id: string) {
+  context.signal.throwIfAborted();
+  const success = await context.$client.deleteMsg(id);
+  return { success, message: t(context.locale, success ? 'messageRecalled' : 'recallUnconfirmed') };
+}

package/agents/icqq/members.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * 实时查询群成员（跳过缓存）；不在群里或查询失败返回 undefined。
+ * 不要用 `pickMember`：它总会返回实体对象（判空永远为真），`is_admin` 等也读旧缓存——Bot 刚被设为管理员时会误判。
+ */
+export async function freshMember(client, groupId, userId) {
+    try {
+        return await client.getGroupMemberInfo(groupId, userId, true);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function isGroupManager(info) {
+    return info?.role === 'owner' || info?.role === 'admin';
+}

package/agents/icqq/members.ts

@@ -0,0 +1,17 @@
+import type { Client, MemberInfo } from '@icqqjs/icqq';
+
+/**
+ * 实时查询群成员（跳过缓存）；不在群里或查询失败返回 undefined。
+ * 不要用 `pickMember`：它总会返回实体对象（判空永远为真），`is_admin` 等也读旧缓存——Bot 刚被设为管理员时会误判。
+ */
+export async function freshMember(client: Client, groupId: number, userId: number): Promise<MemberInfo | undefined> {
+  try {
+    return await client.getGroupMemberInfo(groupId, userId, true);
+  } catch {
+    return undefined;
+  }
+}
+
+export function isGroupManager(info: MemberInfo | undefined): boolean {
+  return info?.role === 'owner' || info?.role === 'admin';
+}

package/agents/icqq/messages.js

@@ -0,0 +1,144 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
+export const messages = createMessages({
+    conversationRequired: {
+        'zh-CN': '此操作需要当前 ICQQ 会话',
+        en: 'This operation requires the current ICQQ conversation',
+    },
+    groupRequired: {
+        'zh-CN': '此操作仅支持当前 QQ 群',
+        en: 'This operation requires the current QQ group',
+    },
+    messageOutsideConversation: {
+        'zh-CN': '无法在当前会话中核实该原消息，请勿猜测消息 ID',
+        en: 'The original message could not be verified in this conversation; do not guess message IDs',
+    },
+    channelOperationUnsupported: {
+        'zh-CN': '当前 ICQQ 频道接入不支持此消息操作',
+        en: 'The current ICQQ channel integration does not support this message operation',
+    },
+    ownMessageRequired: {
+        'zh-CN': '该工具只能撤回机器人自己发送的消息',
+        en: 'This tool can only recall messages sent by the bot itself',
+    },
+    recallForbidden: {
+        'zh-CN': '机器人或目标成员的当前平台角色不允许撤回该消息',
+        en: 'Current bot or target member roles do not permit recalling this message',
+    },
+    messageRecalled: {
+        'zh-CN': '平台已确认撤回消息',
+        en: 'The platform confirmed the message was recalled',
+    },
+    recallUnconfirmed: {
+        'zh-CN': '平台未确认撤回成功，可能已超过时限或被平台拒绝，请勿自动重试',
+        en: 'Recall was not confirmed; the time window may have expired or the platform may have rejected it. Do not retry automatically',
+    },
+    leaveForbidden: {
+        'zh-CN': '目标必须是当前群，且机器人必须是普通成员或管理员；群主退群会解散群，不能执行',
+        en: 'The target must be the current group and the bot must be a member or admin. An owner cannot leave because the SDK would dissolve the group',
+    },
+    groupLeft: {
+        'zh-CN': '平台已确认退群',
+        en: 'The platform confirmed the bot left the group',
+    },
+    leaveUnconfirmed: {
+        'zh-CN': '平台未确认退群成功，请勿自动重试',
+        en: 'The platform did not confirm leaving the group; do not retry automatically',
+    },
+    "userInfo": {
+        "zh-CN": "已获取 {p0} 的用户信息:{p1}",
+        "en": "User information for {p0}:{p1}"
+    },
+    "announcementSent": {
+        "zh-CN": "群公告已发送",
+        "en": "Group announcement sent"
+    },
+    "essenceRemoved": {
+        "zh-CN": "已移除精华",
+        "en": "Featured status removed"
+    },
+    "essenceAdded": {
+        "zh-CN": "已设为精华",
+        "en": "Message marked as featured"
+    },
+    "inviteAttempted": {
+        "zh-CN": "已尝试邀请 {p0} 加入群 {p1}",
+        "en": "Attempted to invite {p0} to group {p1}"
+    },
+    "memberExists": {
+        "zh-CN": "目标成员已加入群",
+        "en": "The member has already joined the group"
+    },
+    "groupMissing": {
+        "zh-CN": "目标群不存在",
+        "en": "The target group does not exist"
+    },
+    "memberKicked": {
+        "zh-CN": "已踢出 {p0} 成员",
+        "en": "Member {p0} removed"
+    },
+    "kickUnconfirmed": {
+        "zh-CN": "平台未确认踢出成功，请勿自动重试",
+        "en": "The platform did not confirm removal; do not retry automatically"
+    },
+    "kickForbidden": {
+        "zh-CN": "当前权限或成员状态不允许踢出",
+        "en": "Current permissions or member status do not allow removal"
+    },
+    "anonymousDisabled": {
+        "zh-CN": "已关闭匿名聊天",
+        "en": "Anonymous chat disabled"
+    },
+    "anonymousEnabled": {
+        "zh-CN": "已开启匿名聊天",
+        "en": "Anonymous chat enabled"
+    },
+    "anonymousForbidden": {
+        "zh-CN": "机器人不是群主或管理员，无法开启或关闭匿名聊天",
+        "en": "The bot must be a group owner or administrator to change anonymous chat"
+    },
+    "muted": {
+        "zh-CN": "已禁言 {user} 成员({seconds}秒)",
+        "en": "Muted member {user} ({seconds} seconds)"
+    },
+    "unmuted": {
+        "zh-CN": "已解除禁言 {user} 成员",
+        "en": "Unmuted member {user}"
+    },
+    "memberMissing": {
+        "zh-CN": "目标成员不存在",
+        "en": "The target member does not exist"
+    },
+    "muteForbidden": {
+        "zh-CN": "机器人不是群主或管理员，无法禁言/解除禁言成员",
+        "en": "The bot must be a group owner or administrator to mute or unmute members"
+    },
+    "titleChanged": {
+        "zh-CN": "已将 {p0} 的头衔设为 \"{p1}\"",
+        "en": "Title for {p0} set to \"{p1}\""
+    },
+    "titleForbidden": {
+        "zh-CN": "机器人不是群主或管理员，无法设置头衔",
+        "en": "The bot must be a group owner or administrator to set member titles"
+    },
+    "checkedIn": {
+        "zh-CN": "群签到成功",
+        "en": "Checked in to the group"
+    },
+    "poked": {
+        "zh-CN": "已戳了戳 {p0}",
+        "en": "Poked {p0}"
+    },
+    "filesEmpty": {
+        "zh-CN": "群文件为空",
+        "en": "The group has no files"
+    },
+    "likesSent": {
+        "zh-CN": "已给 {p0} 点赞 {p1} 次",
+        "en": "Sent {p1} likes to {p0}"
+    },
+    "likeFailed": {
+        "zh-CN": "点赞失败",
+        "en": "Could not send a like"
+    }
+});

package/agents/icqq/messages.ts

@@ -0,0 +1,144 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  conversationRequired: {
+    'zh-CN': '此操作需要当前 ICQQ 会话',
+    en: 'This operation requires the current ICQQ conversation',
+  },
+  groupRequired: {
+    'zh-CN': '此操作仅支持当前 QQ 群',
+    en: 'This operation requires the current QQ group',
+  },
+  messageOutsideConversation: {
+    'zh-CN': '无法在当前会话中核实该原消息，请勿猜测消息 ID',
+    en: 'The original message could not be verified in this conversation; do not guess message IDs',
+  },
+  channelOperationUnsupported: {
+    'zh-CN': '当前 ICQQ 频道接入不支持此消息操作',
+    en: 'The current ICQQ channel integration does not support this message operation',
+  },
+  ownMessageRequired: {
+    'zh-CN': '该工具只能撤回机器人自己发送的消息',
+    en: 'This tool can only recall messages sent by the bot itself',
+  },
+  recallForbidden: {
+    'zh-CN': '机器人或目标成员的当前平台角色不允许撤回该消息',
+    en: 'Current bot or target member roles do not permit recalling this message',
+  },
+  messageRecalled: {
+    'zh-CN': '平台已确认撤回消息',
+    en: 'The platform confirmed the message was recalled',
+  },
+  recallUnconfirmed: {
+    'zh-CN': '平台未确认撤回成功，可能已超过时限或被平台拒绝，请勿自动重试',
+    en: 'Recall was not confirmed; the time window may have expired or the platform may have rejected it. Do not retry automatically',
+  },
+  leaveForbidden: {
+    'zh-CN': '目标必须是当前群，且机器人必须是普通成员或管理员；群主退群会解散群，不能执行',
+    en: 'The target must be the current group and the bot must be a member or admin. An owner cannot leave because the SDK would dissolve the group',
+  },
+  groupLeft: {
+    'zh-CN': '平台已确认退群',
+    en: 'The platform confirmed the bot left the group',
+  },
+  leaveUnconfirmed: {
+    'zh-CN': '平台未确认退群成功，请勿自动重试',
+    en: 'The platform did not confirm leaving the group; do not retry automatically',
+  },
+  "userInfo": {
+    "zh-CN": "已获取 {p0} 的用户信息:{p1}",
+    "en": "User information for {p0}:{p1}"
+  },
+  "announcementSent": {
+    "zh-CN": "群公告已发送",
+    "en": "Group announcement sent"
+  },
+  "essenceRemoved": {
+    "zh-CN": "已移除精华",
+    "en": "Featured status removed"
+  },
+  "essenceAdded": {
+    "zh-CN": "已设为精华",
+    "en": "Message marked as featured"
+  },
+  "inviteAttempted": {
+    "zh-CN": "已尝试邀请 {p0} 加入群 {p1}",
+    "en": "Attempted to invite {p0} to group {p1}"
+  },
+  "memberExists": {
+    "zh-CN": "目标成员已加入群",
+    "en": "The member has already joined the group"
+  },
+  "groupMissing": {
+    "zh-CN": "目标群不存在",
+    "en": "The target group does not exist"
+  },
+  "memberKicked": {
+    "zh-CN": "已踢出 {p0} 成员",
+    "en": "Member {p0} removed"
+  },
+  "kickUnconfirmed": {
+    "zh-CN": "平台未确认踢出成功，请勿自动重试",
+    "en": "The platform did not confirm removal; do not retry automatically"
+  },
+  "kickForbidden": {
+    "zh-CN": "当前权限或成员状态不允许踢出",
+    "en": "Current permissions or member status do not allow removal"
+  },
+  "anonymousDisabled": {
+    "zh-CN": "已关闭匿名聊天",
+    "en": "Anonymous chat disabled"
+  },
+  "anonymousEnabled": {
+    "zh-CN": "已开启匿名聊天",
+    "en": "Anonymous chat enabled"
+  },
+  "anonymousForbidden": {
+    "zh-CN": "机器人不是群主或管理员，无法开启或关闭匿名聊天",
+    "en": "The bot must be a group owner or administrator to change anonymous chat"
+  },
+  "muted": {
+    "zh-CN": "已禁言 {user} 成员({seconds}秒)",
+    "en": "Muted member {user} ({seconds} seconds)"
+  },
+  "unmuted": {
+    "zh-CN": "已解除禁言 {user} 成员",
+    "en": "Unmuted member {user}"
+  },
+  "memberMissing": {
+    "zh-CN": "目标成员不存在",
+    "en": "The target member does not exist"
+  },
+  "muteForbidden": {
+    "zh-CN": "机器人不是群主或管理员，无法禁言/解除禁言成员",
+    "en": "The bot must be a group owner or administrator to mute or unmute members"
+  },
+  "titleChanged": {
+    "zh-CN": "已将 {p0} 的头衔设为 \"{p1}\"",
+    "en": "Title for {p0} set to \"{p1}\""
+  },
+  "titleForbidden": {
+    "zh-CN": "机器人不是群主或管理员，无法设置头衔",
+    "en": "The bot must be a group owner or administrator to set member titles"
+  },
+  "checkedIn": {
+    "zh-CN": "群签到成功",
+    "en": "Checked in to the group"
+  },
+  "poked": {
+    "zh-CN": "已戳了戳 {p0}",
+    "en": "Poked {p0}"
+  },
+  "filesEmpty": {
+    "zh-CN": "群文件为空",
+    "en": "The group has no files"
+  },
+  "likesSent": {
+    "zh-CN": "已给 {p0} 点赞 {p1} 次",
+    "en": "Sent {p1} likes to {p0}"
+  },
+  "likeFailed": {
+    "zh-CN": "点赞失败",
+    "en": "Could not send a like"
+  }
+});

package/agents/icqq/skills/icqq-conversation/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: icqq-conversation
+platforms:
+  - icqq
+description: 查询当前群或频道信息、机器人自身身份（群主／管理员／成员）以及当前会话支持的操作和权限边界。
+keywords:
+  - 当前群
+  - 当前频道
+  - 你是管理员吗
+  - 群主
+  - 机器人权限
+  - 身份
+tools:
+  - conversation_info
+---
+# icqq-conversation
+
+Use `conversation_info` before claiming the bot's role or available platform permissions. It uses the current endpoint account, not the sender's role. Group roles are refreshed from the platform on demand; failure is not evidence that the bot is an ordinary member.
+
+Caller roles authorize a request; bot platform roles determine whether QQ can execute it. They are independent. A successful inspection does not replace the live permission check before a management action.
+
+Guild member lookup can be incomplete. Missing self membership means `unknown`. A `channel_admin` record does not identify which child channels it governs, so it cannot authorize an operation in the current channel.
+
+Load `icqq-messages` for quote/forward/own-message recall, or `icqq-group-admin` for member-message recall and leaving the current group. These operations are unavailable in the current guild-channel integration. Do not infer capability from a group role or substitute a group API for a channel API.