@zhin.js/adapter-icqq 1.1.25 → 1.1.27

package/commands/icqq/login/definition.ts

@@ -3,40 +3,40 @@
  *
  * They are registered by the ICQQ plugin but can be invoked from any connected
  * adapter (typically the QQ instance that delivered the outage notice), so the
- * master can fetch the QR image and confirm/send verification codes without the
+ * owner can fetch the QR image and confirm/send verification codes without the
  * Console or terminal.
  */
 import { icqqLoginControls, type IcqqLoginControl } from '../../../src/icqq-login-control.js';
 
 export { icqqLoginControls };
 
-/** Master = framework master(s), or the configured outage-notify conversation id(s). */
+/**
+ * Operator = a **global** chat-role `owner` (ADR 0056 §2: the command reaches an ICQQ account from
+ * any adapter, so a conversation / account owner elsewhere does not qualify), or the configured
+ * outage-notify conversation id(s).
+ */
 export function isIcqqLoginOperator(config: unknown, input: unknown): boolean {
   const cfg = (config ?? {}) as {
-    master?: unknown;
     notify?: { id?: unknown };
-    endpoints?: readonly { master?: unknown; notify?: { id?: unknown } }[];
+    endpoints?: readonly { notify?: { id?: unknown } }[];
   };
-  const masters = new Set<string>();
+  const sender = (input as { sender?: { id?: unknown; chatRole?: unknown; chatRoleLevels?: { owner?: unknown } } } | null | undefined)?.sender;
+  const senderId = (typeof sender === 'object' && sender?.id) ? String(sender.id).trim() : '';
+  if (!senderId) return false;
+  if (sender?.chatRole === 'owner' && sender.chatRoleLevels?.owner === 'global') return true;
+  const targets = new Set<string>();
   const collect = (value: unknown) => {
     if (value === undefined || value === null) return;
     const text = String(value).trim();
-    if (text) masters.add(text);
+    if (text) targets.add(text);
   };
-  collect(cfg.master);
   collect(cfg.notify?.id);
   if (Array.isArray(cfg.endpoints)) {
-    for (const endpoint of cfg.endpoints) {
-      collect(endpoint.master);
-      collect(endpoint.notify?.id);
-    }
+    for (const endpoint of cfg.endpoints) collect(endpoint.notify?.id);
   }
-  // Login control is account-sensitive: without an explicit master/notify target,
-  // refuse chat recovery and leave it to the authenticated Console page.
-  if (masters.size === 0) return false;
-  const senderRaw = (input as { sender?: { id?: unknown } } | null | undefined)?.sender;
-  const senderId = (typeof senderRaw === 'object' && senderRaw?.id) ? String(senderRaw.id).trim() : '';
-  return senderId !== '' && masters.has(senderId);
+  // Login control is account-sensitive: without an owner or a notify target, chat recovery is
+  // refused and left to the authenticated Console page.
+  return targets.has(senderId);
 }
 
 export function pickIcqqLoginControl(
@@ -57,7 +57,7 @@ export function pickIcqqLoginControl(
 }
 
 export function icqqLoginForbidden(): string {
-  return '仅 master 或 notify 目标账号可以操作 ICQQ 登录';
+  return '仅 owner（聊天角色）或 notify 目标账号可以操作 ICQQ 登录';
 }
 
 export function pendingTaskLabel(type: string): string {

package/lib/console-spec.js

@@ -2,15 +2,109 @@ export const icqqConsoleSpec = {
     adapterKey: 'icqq',
     adapterDisplayName: 'ICQQ',
     fields: [
-        { key: 'password', env: true, description: 'QQ password; leave blank to retain the saved credential' },
-        { key: 'platform', type: 'number', description: 'ICQQ platform number' },
-        { key: 'ver', description: 'ICQQ protocol version' },
-        { key: 'dataDir', description: 'ICQQ device and session directory' },
-        { key: 'signApiAddr', description: 'ICQQ signing service URL' },
-        { key: 'autoReconnect', type: 'boolean', description: 'ICQQ reconnect setting' },
-        { key: 'autoServer', type: 'boolean', description: 'ICQQ automatic server selection' },
-        { key: 'qqnt', type: 'boolean', description: 'QQNT protocol' },
-        { key: 'ntLogin', type: 'boolean', description: 'QQNT login' },
+        {
+            key: 'password',
+            env: true,
+            label: 'QQ 密码',
+            labelI18n: { en: 'QQ Password' },
+            group: '基础认证',
+            groupI18n: { en: 'Basic Auth' },
+            placeholder: '留空可使用扫码登录或保留已存密码',
+            placeholderI18n: { en: 'Leave blank for QR login or to retain saved password' },
+            description: 'QQ 登录密码；留空则保留已保存的凭据或使用扫码登录',
+            descriptionI18n: { en: 'QQ password; leave blank to retain the saved credential' },
+        },
+        {
+            key: 'platform',
+            type: 'number',
+            label: '登录协议',
+            labelI18n: { en: 'Login Platform' },
+            group: '协议与签名',
+            groupI18n: { en: 'Protocol & Signing' },
+            placeholder: '5 (推荐 iPad 协议)',
+            placeholderI18n: { en: '5 (iPad recommended)' },
+            description: '登录设备协议（1:安卓手机 2:aPad 3:安卓手表 4:MacOS 5:iPad 6:安卓Pad）',
+            descriptionI18n: { en: 'ICQQ platform number (1:Android Phone 2:aPad 3:Watch 4:macOS 5:iPad 6:Android Pad)' },
+            options: [
+                { value: '1', label: '1 - 安卓手机 (Android Phone)', labelI18n: { en: '1 - Android Phone' } },
+                { value: '2', label: '2 - aPad 平板 (aPad)', labelI18n: { en: '2 - aPad' } },
+                { value: '3', label: '3 - 安卓手表 (Android Watch)', labelI18n: { en: '3 - Android Watch' } },
+                { value: '4', label: '4 - MacOS 桌面 (macOS)', labelI18n: { en: '4 - macOS' } },
+                { value: '5', label: '5 - iPad 平板（推荐）', labelI18n: { en: '5 - iPad (Recommended)' } },
+                { value: '6', label: '6 - 安卓平板 (Android Pad)', labelI18n: { en: '6 - Android Pad' } },
+            ],
+        },
+        {
+            key: 'signApiAddr',
+            label: '签名服务地址',
+            labelI18n: { en: 'Sign API URL' },
+            group: '协议与签名',
+            groupI18n: { en: 'Protocol & Signing' },
+            placeholder: 'http://127.0.0.1:8080/sign',
+            description: 'ICQQ 第三方签名服务地址（qsign）',
+            descriptionI18n: { en: 'ICQQ signing service URL' },
+        },
+        {
+            key: 'ver',
+            label: '协议版本',
+            labelI18n: { en: 'Protocol Version' },
+            group: '协议与签名',
+            groupI18n: { en: 'Protocol & Signing' },
+            placeholder: '例如 9.0.50（留空使用默认）',
+            placeholderI18n: { en: 'e.g. 9.0.50 (blank for default)' },
+            description: '指定客户端协议版本号',
+            descriptionI18n: { en: 'ICQQ protocol version' },
+        },
+        {
+            key: 'dataDir',
+            label: '会话数据目录',
+            labelI18n: { en: 'Session Data Directory' },
+            group: '连接与高可用',
+            groupI18n: { en: 'Connection & Storage' },
+            placeholder: './data/icqq',
+            description: '设备锁与登录会话缓存目录',
+            descriptionI18n: { en: 'ICQQ device and session directory' },
+        },
+        {
+            key: 'autoReconnect',
+            type: 'boolean',
+            label: '自动重连',
+            labelI18n: { en: 'Auto Reconnect' },
+            group: '连接与高可用',
+            groupI18n: { en: 'Connection & Storage' },
+            description: '掉线后是否自动重新连接',
+            descriptionI18n: { en: 'ICQQ reconnect setting' },
+        },
+        {
+            key: 'autoServer',
+            type: 'boolean',
+            label: '自动优选服务器',
+            labelI18n: { en: 'Auto Server Selection' },
+            group: '连接与高可用',
+            groupI18n: { en: 'Connection & Storage' },
+            description: '自动选择最优连接服务器节点',
+            descriptionI18n: { en: 'ICQQ automatic server selection' },
+        },
+        {
+            key: 'qqnt',
+            type: 'boolean',
+            label: 'QQNT 协议',
+            labelI18n: { en: 'QQNT Protocol' },
+            group: '协议与签名',
+            groupI18n: { en: 'Protocol & Signing' },
+            description: '启用新版 QQNT 协议栈',
+            descriptionI18n: { en: 'QQNT protocol' },
+        },
+        {
+            key: 'ntLogin',
+            type: 'boolean',
+            label: 'QQNT 登录流',
+            labelI18n: { en: 'QQNT Login' },
+            group: '协议与签名',
+            groupI18n: { en: 'Protocol & Signing' },
+            description: '启用 QQNT 登录验证模式',
+            descriptionI18n: { en: 'QQNT login' },
+        },
     ],
     docsUrl: 'https://zhin.js.org/adapters/icqq',
     readPermission: 'icqq:read',

package/lib/endpoint.js

@@ -16,7 +16,7 @@ import { formatInboundContent, formatOutboundMessageParts, normalizeIcqqImageMed
 import { ManagedIcqqClient } from './managed-client.js';
 import { createIcqqActionPorts } from './group-actions.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
-import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
+import { inspectGroupMemberProfile, inspectGroupScene, inspectSelfStanding } from './group-scene.js';
 import { createIcqqSelfProfile } from './self-profile.js';
 const BOUND_EVENTS = [
     'message.private',
@@ -69,6 +69,7 @@ export class IcqqEndpoint extends ManagedIcqqClient {
         inspectGroupMember: request => inspectGroupMember(this, request),
         inspectGroupScene: request => inspectGroupScene(this, request),
         inspectGroupMemberProfile: request => inspectGroupMemberProfile(this, request),
+        inspectSelfStanding: request => inspectSelfStanding(this, request),
         moderateGroupMember: request => moderateGroupMember({ client: this, isActive: () => this.#open && !this.#retiring && !this.#stopped }, request),
         listFriends: async (request = {}) => createEndpointOperation(request).run(() => Array.from(this.fl.values()).map((f) => ({
             user_id: f.user_id,
@@ -977,7 +978,7 @@ export class IcqqEndpoint extends ManagedIcqqClient {
             sender: {
                 id: normalized.userId,
                 name: normalized.nickname || undefined,
-                ...(normalized.senderRole ? { roles: [normalized.senderRole] } : {}),
+                ...(normalized.senderRole ? { platform: { standing: normalized.senderRole } } : {}),
             },
             channelType: normalized.channelType,
             ...(quoteId ? { replyTo: { id: quoteId } } : {}),

package/lib/group-scene.d.ts

@@ -1,4 +1,5 @@
 import type { Client } from '@icqqjs/icqq';
+import { type PlatformStanding, type SelfStandingRequest } from '@zhin.js/im-contract';
 import { type EndpointGroupInspectionRequest, type EndpointMemberInspectionRequest, type GroupMemberProfile, type GroupSceneFacts } from 'zhin.js/adapter';
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
 export declare const ADMIN_SCAN_MAX_MEMBERS = 1000;
@@ -9,3 +10,5 @@ export declare const ADMIN_SCAN_MAX_MEMBERS = 1000;
 export declare function inspectGroupScene(client: Client, { groupId, signal }: EndpointGroupInspectionRequest): Promise<GroupSceneFacts>;
 /** ADR 0041 member facts from one uncached lookup (same rationale as the agent `freshMember` helper). */
 export declare function inspectGroupMemberProfile(client: Client, { groupId, userId, signal }: EndpointMemberInspectionRequest): Promise<GroupMemberProfile>;
+/** ADR 0056 §1: the Bot's own standing in a group (`scene.selfStanding`); undefined outside groups. */
+export declare function inspectSelfStanding(client: Client, { conversation, signal }: SelfStandingRequest): Promise<PlatformStanding | undefined>;

package/lib/group-scene.js

@@ -1,3 +1,4 @@
+import { standingFromMemberRole } from '@zhin.js/im-contract';
 import { createEndpointOperation } from 'zhin.js/adapter';
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
 export const ADMIN_SCAN_MAX_MEMBERS = 1000;
@@ -70,3 +71,13 @@ export async function inspectGroupMemberProfile(client, { groupId, userId, signa
             ? { mutedUntil: shutupSeconds * 1000 > Date.now() ? shutupSeconds * 1000 : 0 } : {}),
     };
 }
+/** ADR 0056 §1: the Bot's own standing in a group (`scene.selfStanding`); undefined outside groups. */
+export async function inspectSelfStanding(client, { conversation, signal }) {
+    if (conversation.kind !== 'group')
+        return undefined;
+    const self = client.uin;
+    if (!self)
+        return undefined;
+    const profile = await inspectGroupMemberProfile(client, { groupId: conversation.id, userId: String(self), signal });
+    return standingFromMemberRole(profile.platformRole);
+}

package/lib/protocol.d.ts

@@ -1,6 +1,6 @@
 import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import type { Sendable } from '@icqqjs/icqq';
-import { type ConversationRef } from '@zhin.js/im-contract';
+import { type ConversationRef, type PlatformStanding } from '@zhin.js/im-contract';
 import { type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
 import type { MessageSegment, SendContent } from "zhin.js";
 export type ActionResult = {
@@ -217,9 +217,11 @@ export interface IcqqInboundMessage {
      * 与 content（CQ 原文纯文本视图）同源，随 gateway.receive 上送。
      */
     readonly segments?: readonly MessageSegment[];
+    /** `platform`: ADR 0056 §1 normalized standing (group messages only). */
     readonly sender: {
         readonly id: string;
         readonly name?: string;
+        readonly platform?: PlatformStanding;
     };
     readonly channelType: 'private' | 'group' | 'channel';
     readonly metadata?: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.25",
+  "version": "1.1.27",
   "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,28 +33,28 @@
     "directory": "plugins/adapters/icqq"
   },
   "dependencies": {
-    "@zhin.js/adapter-onebot-events": "0.0.4",
-    "@zhin.js/adapter": "1.1.31",
-    "@zhin.js/agent-feature": "1.1.16",
-    "@zhin.js/console-contract": "1.1.5",
-    "@zhin.js/core": "1.1.59",
-    "@zhin.js/feature-kit": "1.1.15",
-    "@zhin.js/im-contract": "1.1.13",
-    "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.17",
-    "@zhin.js/permission": "1.1.15",
-    "@zhin.js/skill": "1.1.16",
-    "@zhin.js/tool": "1.1.18"
+    "zod": "^4.6.7",
+    "@zhin.js/adapter": "1.1.33",
+    "@zhin.js/adapter-onebot-events": "0.0.6",
+    "@zhin.js/agent-feature": "1.1.17",
+    "@zhin.js/console-contract": "1.1.6",
+    "@zhin.js/core": "1.2.0",
+    "@zhin.js/feature-kit": "1.1.16",
+    "@zhin.js/im-contract": "1.1.14",
+    "@zhin.js/logger": "1.1.3",
+    "@zhin.js/page": "1.1.18",
+    "@zhin.js/permission": "1.2.0",
+    "@zhin.js/skill": "1.1.17",
+    "@zhin.js/tool": "1.1.19"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
-    "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.31",
-    "@zhin.js/agent": "^1.1.50",
-    "@zhin.js/command": "^1.1.17",
-    "@zhin.js/core": "^1.1.59",
-    "@zhin.js/prompt-section": "^1.1.15",
-    "zhin.js": "^1.1.24"
+    "@zhin.js/adapter": "^1.1.33",
+    "@zhin.js/agent": "^1.2.0",
+    "@zhin.js/command": "^1.2.0",
+    "@zhin.js/core": "^1.2.0",
+    "@zhin.js/prompt-section": "^1.1.16",
+    "zhin.js": "^1.1.26"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -71,9 +71,6 @@
     },
     "zhin.js": {
       "optional": true
-    },
-    "zod": {
-      "optional": true
     }
   },
   "devDependencies": {
@@ -81,10 +78,9 @@
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.50",
-    "@zhin.js/prompt-section": "1.1.15",
-    "zhin.js": "1.1.24"
+    "@zhin.js/agent": "1.2.0",
+    "@zhin.js/prompt-section": "1.1.16",
+    "zhin.js": "1.1.26"
   },
   "files": [
     "adapters",
@@ -137,6 +133,11 @@
       {
         "package": "@zhin.js/page",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/prompt-section",
+        "api": "^1.0.0",
+        "optional": true
       }
     ],
     "plugins": []
@@ -144,7 +145,7 @@
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "pnpm run test:types && NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/adapters/icqq/tests",
+    "test": "pnpm run test:types && vitest run --root ../../.. plugins/adapters/icqq/tests",
     "test:types": "tsc -p tsconfig.type-tests.json"
   }
 }

package/plugin.js

@@ -1,6 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { definePlugin } from 'zhin.js';
-import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/permission';
 import { registerSensitiveExecCommand } from '@zhin.js/agent';
 import { createIcqqConsoleRpc } from "./lib/console.js";
 import { icqqSensitiveExecRule } from "./lib/sensitive-commands.js";
@@ -11,15 +10,11 @@ export default definePlugin({
         displayName: 'ICQQ Adapter',
     },
     setup(context) {
-        const disposePlatform = context.resources.has(permissionHostToken)
-            ? context.resources.use(permissionHostToken).registerPlatform('icqq', createSceneRolePlatformChecker())
-            : undefined;
         const disposeExecRule = registerSensitiveExecCommand(icqqSensitiveExecRule);
         return {
             consoleRpc: createIcqqConsoleRpc(() => context.config.get()),
             dispose: () => {
                 disposeExecRule();
-                disposePlatform?.();
             },
         };
     },

package/schema.json

@@ -3,33 +3,6 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "master": {
-      "type": [
-        "string",
-        "number"
-      ],
-      "description": "框架 master QQ uin（/approve、AI/工具权限）；endpoints[i].master 可逐项覆盖",
-      "x-i18n": {
-        "en": {
-          "description": "Framework master QQ uin list for approval and AI/tool permissions. endpoints[i].master can override this value."
-        }
-      }
-    },
-    "trusted": {
-      "type": "array",
-      "items": {
-        "type": [
-          "string",
-          "number"
-        ]
-      },
-      "description": "框架 trusted QQ uin 列表（弱于 master）",
-      "x-i18n": {
-        "en": {
-          "description": "Framework trusted QQ uin list, below master authority."
-        }
-      }
-    },
     "password": {
       "type": "string",
       "description": "QQ 密码（可选，不填则扫码登录）",
@@ -181,33 +154,6 @@
             "pattern": "^[0-9]+$",
             "description": "QQ uin"
           },
-          "master": {
-            "type": [
-              "string",
-              "number"
-            ],
-            "description": "本 endpoint 的 master QQ uin；覆盖顶层 master",
-            "x-i18n": {
-              "en": {
-                "description": "Master QQ uin list for this endpoint, overriding the top-level master list."
-              }
-            }
-          },
-          "trusted": {
-            "type": "array",
-            "items": {
-              "type": [
-                "string",
-                "number"
-              ]
-            },
-            "description": "本 endpoint 的 trusted 列表",
-            "x-i18n": {
-              "en": {
-                "description": "Trusted users for this endpoint."
-              }
-            }
-          },
           "password": {
             "type": "string",
             "description": "本 endpoint 的 QQ 密码",
@@ -586,7 +532,6 @@
     }
   },
   "required": [
-    "master",
     "endpoints"
   ],
   "$defs": {

package/src/console-spec.ts

@@ -7,15 +7,109 @@ export const icqqConsoleSpec = {
   adapterKey: 'icqq',
   adapterDisplayName: 'ICQQ',
   fields: [
-    { key: 'password', env: true, description: 'QQ password; leave blank to retain the saved credential' },
-    { key: 'platform', type: 'number', description: 'ICQQ platform number' },
-    { key: 'ver', description: 'ICQQ protocol version' },
-    { key: 'dataDir', description: 'ICQQ device and session directory' },
-    { key: 'signApiAddr', description: 'ICQQ signing service URL' },
-    { key: 'autoReconnect', type: 'boolean', description: 'ICQQ reconnect setting' },
-    { key: 'autoServer', type: 'boolean', description: 'ICQQ automatic server selection' },
-    { key: 'qqnt', type: 'boolean', description: 'QQNT protocol' },
-    { key: 'ntLogin', type: 'boolean', description: 'QQNT login' },
+    {
+      key: 'password',
+      env: true,
+      label: 'QQ 密码',
+      labelI18n: { en: 'QQ Password' },
+      group: '基础认证',
+      groupI18n: { en: 'Basic Auth' },
+      placeholder: '留空可使用扫码登录或保留已存密码',
+      placeholderI18n: { en: 'Leave blank for QR login or to retain saved password' },
+      description: 'QQ 登录密码；留空则保留已保存的凭据或使用扫码登录',
+      descriptionI18n: { en: 'QQ password; leave blank to retain the saved credential' },
+    },
+    {
+      key: 'platform',
+      type: 'number',
+      label: '登录协议',
+      labelI18n: { en: 'Login Platform' },
+      group: '协议与签名',
+      groupI18n: { en: 'Protocol & Signing' },
+      placeholder: '5 (推荐 iPad 协议)',
+      placeholderI18n: { en: '5 (iPad recommended)' },
+      description: '登录设备协议（1:安卓手机 2:aPad 3:安卓手表 4:MacOS 5:iPad 6:安卓Pad）',
+      descriptionI18n: { en: 'ICQQ platform number (1:Android Phone 2:aPad 3:Watch 4:macOS 5:iPad 6:Android Pad)' },
+      options: [
+        { value: '1', label: '1 - 安卓手机 (Android Phone)', labelI18n: { en: '1 - Android Phone' } },
+        { value: '2', label: '2 - aPad 平板 (aPad)', labelI18n: { en: '2 - aPad' } },
+        { value: '3', label: '3 - 安卓手表 (Android Watch)', labelI18n: { en: '3 - Android Watch' } },
+        { value: '4', label: '4 - MacOS 桌面 (macOS)', labelI18n: { en: '4 - macOS' } },
+        { value: '5', label: '5 - iPad 平板（推荐）', labelI18n: { en: '5 - iPad (Recommended)' } },
+        { value: '6', label: '6 - 安卓平板 (Android Pad)', labelI18n: { en: '6 - Android Pad' } },
+      ],
+    },
+    {
+      key: 'signApiAddr',
+      label: '签名服务地址',
+      labelI18n: { en: 'Sign API URL' },
+      group: '协议与签名',
+      groupI18n: { en: 'Protocol & Signing' },
+      placeholder: 'http://127.0.0.1:8080/sign',
+      description: 'ICQQ 第三方签名服务地址（qsign）',
+      descriptionI18n: { en: 'ICQQ signing service URL' },
+    },
+    {
+      key: 'ver',
+      label: '协议版本',
+      labelI18n: { en: 'Protocol Version' },
+      group: '协议与签名',
+      groupI18n: { en: 'Protocol & Signing' },
+      placeholder: '例如 9.0.50（留空使用默认）',
+      placeholderI18n: { en: 'e.g. 9.0.50 (blank for default)' },
+      description: '指定客户端协议版本号',
+      descriptionI18n: { en: 'ICQQ protocol version' },
+    },
+    {
+      key: 'dataDir',
+      label: '会话数据目录',
+      labelI18n: { en: 'Session Data Directory' },
+      group: '连接与高可用',
+      groupI18n: { en: 'Connection & Storage' },
+      placeholder: './data/icqq',
+      description: '设备锁与登录会话缓存目录',
+      descriptionI18n: { en: 'ICQQ device and session directory' },
+    },
+    {
+      key: 'autoReconnect',
+      type: 'boolean',
+      label: '自动重连',
+      labelI18n: { en: 'Auto Reconnect' },
+      group: '连接与高可用',
+      groupI18n: { en: 'Connection & Storage' },
+      description: '掉线后是否自动重新连接',
+      descriptionI18n: { en: 'ICQQ reconnect setting' },
+    },
+    {
+      key: 'autoServer',
+      type: 'boolean',
+      label: '自动优选服务器',
+      labelI18n: { en: 'Auto Server Selection' },
+      group: '连接与高可用',
+      groupI18n: { en: 'Connection & Storage' },
+      description: '自动选择最优连接服务器节点',
+      descriptionI18n: { en: 'ICQQ automatic server selection' },
+    },
+    {
+      key: 'qqnt',
+      type: 'boolean',
+      label: 'QQNT 协议',
+      labelI18n: { en: 'QQNT Protocol' },
+      group: '协议与签名',
+      groupI18n: { en: 'Protocol & Signing' },
+      description: '启用新版 QQNT 协议栈',
+      descriptionI18n: { en: 'QQNT protocol' },
+    },
+    {
+      key: 'ntLogin',
+      type: 'boolean',
+      label: 'QQNT 登录流',
+      labelI18n: { en: 'QQNT Login' },
+      group: '协议与签名',
+      groupI18n: { en: 'Protocol & Signing' },
+      description: '启用 QQNT 登录验证模式',
+      descriptionI18n: { en: 'QQNT login' },
+    },
   ] as readonly AdapterConsoleField[],
   docsUrl: 'https://zhin.js.org/adapters/icqq',
   readPermission: 'icqq:read',

package/src/endpoint.ts

@@ -80,7 +80,7 @@ import type { SystemMessage as IcqqSystemMessage } from './types.js';
 import { ManagedIcqqClient, type IcqqBackgroundOperation } from './managed-client.js';
 import { createIcqqActionPorts } from './group-actions.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
-import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
+import { inspectGroupMemberProfile, inspectGroupScene, inspectSelfStanding } from './group-scene.js';
 import { createIcqqSelfProfile } from './self-profile.js';
 
 export interface IcqqEndpointOptions {
@@ -147,6 +147,7 @@ export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
     inspectGroupMember: request => inspectGroupMember(this, request),
     inspectGroupScene: request => inspectGroupScene(this, request),
     inspectGroupMemberProfile: request => inspectGroupMemberProfile(this, request),
+    inspectSelfStanding: request => inspectSelfStanding(this, request),
     moderateGroupMember: request => moderateGroupMember({ client: this, isActive: () => this.#open && !this.#retiring && !this.#stopped }, request),
     listFriends: async (request: EndpointManagementRequest = {}) =>
       createEndpointOperation(request).run(() => Array.from(this.fl.values()).map((f) => ({
@@ -1054,7 +1055,7 @@ export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
       sender: {
         id: normalized.userId,
         name: normalized.nickname || undefined,
-        ...(normalized.senderRole ? { roles: [normalized.senderRole] } : {}),
+        ...(normalized.senderRole ? { platform: { standing: normalized.senderRole } } : {}),
       },
       channelType: normalized.channelType,
       ...(quoteId ? { replyTo: { id: quoteId } } : {}),

package/src/group-scene.ts

@@ -1,4 +1,5 @@
 import type { Client } from '@icqqjs/icqq';
+import { standingFromMemberRole, type PlatformStanding, type SelfStandingRequest } from '@zhin.js/im-contract';
 import { createEndpointOperation, type EndpointGroupInspectionRequest, type EndpointMemberInspectionRequest, type GroupMemberProfile, type GroupSceneFacts } from 'zhin.js/adapter';
 
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
@@ -74,3 +75,14 @@ export async function inspectGroupMemberProfile(
       ? { mutedUntil: shutupSeconds * 1000 > Date.now() ? shutupSeconds * 1000 : 0 } : {}),
   };
 }
+
+/** ADR 0056 §1: the Bot's own standing in a group (`scene.selfStanding`); undefined outside groups. */
+export async function inspectSelfStanding(
+  client: Client, { conversation, signal }: SelfStandingRequest,
+): Promise<PlatformStanding | undefined> {
+  if (conversation.kind !== 'group') return undefined;
+  const self = client.uin;
+  if (!self) return undefined;
+  const profile = await inspectGroupMemberProfile(client, { groupId: conversation.id, userId: String(self), signal });
+  return standingFromMemberRole(profile.platformRole);
+}

package/src/protocol.ts

@@ -1,6 +1,6 @@
 import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import type { MessageElem, Sendable, ShareElem } from '@icqqjs/icqq';
-import { isMediaRef, type ConversationRef } from '@zhin.js/im-contract';
+import { isMediaRef, type ConversationRef, type PlatformStanding } from '@zhin.js/im-contract';
 import { resolveAdapterNotifyTarget, type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
 import type { MessageSegment, SendContent } from "zhin.js";
 import { resolveIcqqMediaFile } from "./cq-message.js";
@@ -289,7 +289,8 @@ export interface IcqqInboundMessage {
    * 与 content（CQ 原文纯文本视图）同源，随 gateway.receive 上送。
    */
   readonly segments?: readonly MessageSegment[];
-  readonly sender: { readonly id: string; readonly name?: string };
+  /** `platform`: ADR 0056 §1 normalized standing (group messages only). */
+  readonly sender: { readonly id: string; readonly name?: string; readonly platform?: PlatformStanding };
   readonly channelType: 'private' | 'group' | 'channel';
   readonly metadata?: Record<string, unknown>;
   readonly replyTo?: { readonly id: string };