@zhin.js/adapter-icqq 1.1.19 → 1.1.21

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @zhin.js/adapter-icqq
 
+## 1.1.21
+
+### Patch Changes
+
+- af8f803: Use the current Endpoint's platform profile for Agent account identity, with per-field configured fallbacks and scoped, identity-approved profile tools. Keep SOUL first-person and independent of account names. Profile ports preserve the source Client, cancellation, truthful update outcomes and private image authority.
+
+  Adapter Feature API 2.1 and Tool Feature API 1.1 describe the additive profile requirements; new Core, official adapters and generated plugins declare the corresponding floors. Existing compatible API-2.0/API-1.0 plugins remain accepted by the newer providers. npm releases remain patch.
+
+  Private IM assets now bind to the full canonical conversation and principal. Existing IM asset records that contain only the earlier lossy hash remain on disk until their original expiry, but cannot be safely rebound; recapture them. No automatic file deletion, platform profile mutation or workspace SOUL rewrite occurs during upgrade.
+
+- Updated dependencies [b88e988]
+- Updated dependencies [f78eb84]
+- Updated dependencies [c15cef9]
+- Updated dependencies [b0c02a2]
+- Updated dependencies [af8f803]
+- Updated dependencies [26fda97]
+- Updated dependencies [976886c]
+- Updated dependencies [032dc96]
+  - @zhin.js/adapter@1.1.27
+  - @zhin.js/client@1.1.23
+  - @zhin.js/im-contract@1.1.10
+  - @zhin.js/core@1.1.55
+  - @zhin.js/tool@1.1.14
+  - @zhin.js/page@1.1.13
+  - @zhin.js/agent-feature@1.1.12
+  - @zhin.js/feature-kit@1.1.11
+  - @zhin.js/permission@1.1.11
+  - @zhin.js/skill@1.1.12
+
+## 1.1.20
+
+### Patch Changes
+
+- Updated dependencies [5e878ba]
+  - @zhin.js/page@1.1.12
+
 ## 1.1.19
 
 ### Patch Changes

package/README.md

@@ -249,3 +249,13 @@ ICQQ 要求分享、文件、语音、视频、JSON 卡片和合并转发单独
 Endpoint 管理和工具反馈跟随当前操作语言；登录没有当前聊天发送者，LoginAssist 提示采用项目语言。提示文案变化不改变扫码、短信、滑块验证过程，群管理权限、审批与平台结果检查保持原规则。
 
 Endpoint 添加用法中的调用头由当前环境的实际命令前缀与插件命名空间提供；未知时只提示所需参数，不生成猜测命令。
+
+## 当前账号资料
+
+`endpointSpec.profile` 接到原生 ICQQ Client 的资料卡与设置方法；Agent 通过统一的 `get_self_profile` / `set_self_profile` 工具访问当前账号，修改沿用身份类审批。平台资料优先于配置兜底，群名片仍是独立的场景资料。
+
+- 可读：昵称、性别、年龄、个性签名、头像 URL。只投影这些公开资料，不把 SDK 返回的邮箱、QID 等一起交给模型。
+- 可写：昵称、性别、签名、个人说明、头像。SDK 返回 `false` 时明确拒绝，不报告成功。头像输入经工具链解析为已授权图片，结果不回传图片 base64。
+- 年龄不反推生日；当前安装的 ICQQ 1.12.3 `setBirthday` 月日编码有缺陷，因此不开放生日写入。兴趣无对应已验证接口，只能使用配置兜底。
+
+配置的 `nickname`、`profile` 可放在适配器默认值或某个 `endpoints[]` 项中；Endpoint 逐字段覆盖默认值，只有平台未提供的字段才使用它们。配置兜底不会写回 QQ。

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

@@ -15,9 +15,9 @@ tools:
 ---
 # 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.
+Use `conversation_info` before claiming your 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 you are 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.
+Caller roles authorize a request; your 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.
 

package/agents/icqq/skills/icqq-conversation/tools/conversation_info/index.js

@@ -3,7 +3,7 @@ import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { currentConversation } from '../../../../conversation.js';
 export default defineAgentTool({
-    description: '读取当前 ICQQ 会话及机器人自己的群／频道身份；区分调用者权限、机器人平台权限和不支持的操作',
+    description: '读取当前 ICQQ 会话及你自己的群／频道身份；区分调用者权限、你的平台权限和不支持的操作',
     adapter: 'icqq',
     requiresApproval: 'never',
     inputSchema: z.object({}),

package/agents/icqq/skills/icqq-conversation/tools/conversation_info/index.ts

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { currentConversation } from '../../../../conversation.js';
 
 export default defineAgentTool({
-  description: '读取当前 ICQQ 会话及机器人自己的群／频道身份；区分调用者权限、机器人平台权限和不支持的操作',
+  description: '读取当前 ICQQ 会话及你自己的群／频道身份；区分调用者权限、你的平台权限和不支持的操作',
   adapter: 'icqq',
   requiresApproval: 'never',
   inputSchema: z.object({}),

package/agents/icqq/skills/icqq-group-admin/SKILL.md

@@ -35,8 +35,8 @@ scopes:
 
 已配置的自动审核流程可对入群 10 分钟内的明确广告直接踢出；该例外由审核流程核验，不授权本技能或普通对话绕过人工审批。
 
-`group_leave` 仅主人（master）可发起，每次人工审批，只能退出当前群。Bot 为群主时拒绝执行，因为 SDK 的退群会解散群。
+`group_leave` 仅主人（master）可发起，每次人工审批，只能退出当前群。你为群主时拒绝执行，因为 SDK 的退群会解散群。
 
-`recall_member_message` 沿用 master/admin/trusted/owner 发起权限，无需逐次审批；目标固定在当前群中的真实消息。执行前实时查询 Bot 与目标成员角色：管理员只能撤回普通成员，群主可撤回管理员或普通成员。平台时限与执行结果仍然有效，不自动重试未确认的结果。
+`recall_member_message` 沿用 master/admin/trusted/owner 发起权限，无需逐次审批；目标固定在当前群中的真实消息。执行前实时查询你与目标成员的角色：管理员只能撤回普通成员，群主可撤回管理员或普通成员。平台时限与执行结果仍然有效，不自动重试未确认的结果。
 
-撤回 Bot 自己的消息不要求群管角色：使用 `icqq-messages` 的 `recall_own_message`。已配置自动群审核的撤回继续走原有审核路径，不因本工具新增审批，也不扩大审核类别或目标群。
+撤回你自己的消息不要求群管角色：使用 `icqq-messages` 的 `recall_own_message`。已配置自动群审核的撤回继续走原有审核路径，不因本工具新增审批，也不扩大审核类别或目标群。

package/agents/icqq/skills/icqq-group-admin/tools/group_leave/index.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
 import { currentGroup } from '../../../../conversation.js';
 import { messages as t } from '../../../../messages.js';
 export default defineAgentTool({
-    description: '让机器人退出当前 QQ 群；仅主人可发起且每次人工审批，机器人是群主时拒绝执行以免解散群',
+    description: '退出你当前所在的 QQ 群；仅主人可发起且每次人工审批，你是群主时拒绝执行以免解散群',
     adapter: 'icqq',
     scopes: ['group'],
     currentConversationBotRoles: ['admin', 'member'],

package/agents/icqq/skills/icqq-group-admin/tools/group_leave/index.ts

@@ -4,7 +4,7 @@ import { currentGroup } from '../../../../conversation.js';
 import { messages as t } from '../../../../messages.js';
 
 export default defineAgentTool({
-  description: '让机器人退出当前 QQ 群；仅主人可发起且每次人工审批，机器人是群主时拒绝执行以免解散群',
+  description: '退出你当前所在的 QQ 群；仅主人可发起且每次人工审批，你是群主时拒绝执行以免解散群',
   adapter: 'icqq',
   scopes: ['group'],
   currentConversationBotRoles: ['admin', 'member'],

package/agents/icqq/skills/icqq-group-admin/tools/recall_member_message/index.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
 import { currentGroup, recallMessage, resolveMessage } from '../../../../conversation.js';
 import { messages as t } from '../../../../messages.js';
 export default defineAgentTool({
-    description: '撤回当前 QQ 群内他人的真实消息；需调用方具备群管发起权限及机器人具备实时平台权限，无需逐次审批',
+    description: '撤回当前 QQ 群内他人的真实消息；需调用方具备群管发起权限及你具备实时平台权限，无需逐次审批',
     adapter: 'icqq',
     scopes: ['group'],
     currentConversationBotRoles: ['owner', 'admin'],

package/agents/icqq/skills/icqq-group-admin/tools/recall_member_message/index.ts

@@ -4,7 +4,7 @@ import { currentGroup, recallMessage, resolveMessage } from '../../../../convers
 import { messages as t } from '../../../../messages.js';
 
 export default defineAgentTool({
-  description: '撤回当前 QQ 群内他人的真实消息；需调用方具备群管发起权限及机器人具备实时平台权限，无需逐次审批',
+  description: '撤回当前 QQ 群内他人的真实消息；需调用方具备群管发起权限及你具备实时平台权限，无需逐次审批',
   adapter: 'icqq',
   scopes: ['group'],
   currentConversationBotRoles: ['owner', 'admin'],

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

@@ -23,6 +23,6 @@ Only use real message IDs from the current conversation. Do not invent IDs, sour
 
 `quote_reply` sends a text reply quoting one original; `forward_messages` sends a merged forward of the supplied originals. Use `inspect_conversation_reference` to read an incoming quote/forward when available; it does not send messages.
 
-`recall_own_message` needs no management role or per-call approval, including when the bot is an ordinary group member. It verifies the bot authored the message. The platform decides the recall time window; never promise success before receiving confirmation or retry an unconfirmed result automatically. To recall another member's message, load `icqq-group-admin` instead.
+`recall_own_message` needs no management role or per-call approval, including when you are an ordinary group member. It verifies that you authored the message. The platform decides the recall time window; never promise success before receiving confirmation or retry an unconfirmed result automatically. To recall another member's message, load `icqq-group-admin` instead.
 
 These tools currently support QQ private/group conversations, not guild channels. A failed or suppressed outbound receipt is not a delivered message.

package/agents/icqq/skills/icqq-messages/tools/recall_own_message/index.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
 import { recallMessage, resolveMessage } from '../../../../conversation.js';
 import { messages as t } from '../../../../messages.js';
 export default defineAgentTool({
-    description: '撤回机器人在当前 QQ 群或私聊中自己的发言；无需群管角色或逐次审批，时限由平台决定',
+    description: '撤回你在当前 QQ 群或私聊中自己的发言；无需群管角色或逐次审批，时限由平台决定',
     adapter: 'icqq',
     scopes: ['private', 'group'],
     requiresApproval: 'never',

package/agents/icqq/skills/icqq-messages/tools/recall_own_message/index.ts

@@ -4,7 +4,7 @@ import { recallMessage, resolveMessage } from '../../../../conversation.js';
 import { messages as t } from '../../../../messages.js';
 
 export default defineAgentTool({
-  description: '撤回机器人在当前 QQ 群或私聊中自己的发言；无需群管角色或逐次审批，时限由平台决定',
+  description: '撤回你在当前 QQ 群或私聊中自己的发言；无需群管角色或逐次审批，时限由平台决定',
   adapter: 'icqq',
   scopes: ['private', 'group'],
   requiresApproval: 'never',

package/lib/endpoint.js

@@ -15,6 +15,7 @@ import { formatInboundContent, formatOutboundMessageParts, normalizeIcqqImageMed
 import { ManagedIcqqClient } from './managed-client.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
 import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
+import { createIcqqSelfProfile } from './self-profile.js';
 const BOUND_EVENTS = [
     'message.private',
     'message.group',
@@ -163,7 +164,7 @@ export class IcqqEndpoint extends ManagedIcqqClient {
             start: signal => this.#startFramework(signal), open: () => this.#openFramework(), close: () => this.#closeFramework(), stop: () => this.#stopFramework(),
             send: request => this.#sendFramework(request), get name() { return name(); },
             get transportState() { return state(); },
-            management: this.#management, control: this.#control,
+            management: this.#management, control: this.#control, profile: createIcqqSelfProfile(this),
             get content() { return content(); },
         });
         this.#contentResolver = new IcqqContentResolver(this);

package/lib/protocol.d.ts

@@ -1,3 +1,4 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 import type { Sendable } from '@icqqjs/icqq';
 import { type ConversationRef } from '@zhin.js/im-contract';
 import { type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
@@ -163,7 +164,7 @@ export declare const Actions: {
     readonly GET_NOTIFY: "get_notify";
 };
 /** One expanded ICQQ endpoint configuration produced by AdapterIndex. */
-export interface IcqqEndpointConfig {
+export interface IcqqEndpointConfig extends EndpointProfileConfiguration {
     readonly id: string;
     readonly autoReconnect?: boolean;
     readonly outboundMedia?: 'file' | 'base64';

package/lib/self-profile.d.ts

@@ -0,0 +1,6 @@
+import type { Client } from '@icqqjs/icqq';
+import { type EndpointProfile } from 'zhin.js/adapter';
+type IcqqProfileClient = Pick<Client, 'uin' | 'nickname' | 'isOnline' | 'getProfile' | 'setNickname' | 'setGender' | 'setSignature' | 'setDescription' | 'setAvatar'>;
+/** ICQQ owns the platform facts; config fallbacks and call leases belong to Adapter. */
+export declare function createIcqqSelfProfile(client: IcqqProfileClient): EndpointProfile;
+export {};

package/lib/self-profile.js

@@ -0,0 +1,56 @@
+import { createEndpointOperation } from 'zhin.js/adapter';
+/** ICQQ owns the platform facts; config fallbacks and call leases belong to Adapter. */
+export function createIcqqSelfProfile(client) {
+    return Object.freeze({
+        writableFields: Object.freeze(['nickname', 'gender', 'signature', 'bio', 'avatar']),
+        get current() { return client.isOnline() ? { nickname: client.nickname } : {}; },
+        async read({ signal }) {
+            const raw = await createEndpointOperation({ signal }).prepare(() => client.getProfile(client.uin));
+            const profile = {
+                ...(typeof raw.nickname === 'string' ? { nickname: raw.nickname } : {}),
+                ...(raw.sex === 'male' || raw.sex === 'female' || raw.sex === 'unknown' ? { gender: raw.sex } : {}),
+                ...(typeof raw.age === 'number' && Number.isFinite(raw.age) ? { age: raw.age } : {}),
+                ...(typeof raw.signature === 'string' ? { signature: raw.signature } : {}),
+                ...(typeof raw.avatar?.url === 'string' ? { avatar: raw.avatar.url } : {}),
+            };
+            return profile;
+        },
+        async write({ change, signal }) {
+            const operation = createEndpointOperation({ signal });
+            let accepted;
+            switch (change.field) {
+                case 'nickname':
+                    accepted = await operation.run(() => client.setNickname(change.value));
+                    break;
+                case 'gender': {
+                    if (change.value === 'other')
+                        return { status: 'rejected', message: 'ICQQ supports male, female or unknown gender' };
+                    const gender = change.value === 'male' ? 1 : change.value === 'female' ? 2 : 0;
+                    accepted = await operation.run(() => client.setGender(gender));
+                    break;
+                }
+                case 'signature':
+                    accepted = await operation.run(() => client.setSignature(change.value));
+                    break;
+                case 'bio':
+                    accepted = await operation.run(() => client.setDescription(change.value));
+                    break;
+                case 'avatar': {
+                    if (change.value.kind === 'file') {
+                        return { status: 'rejected', message: 'ICQQ avatar requires resolved image bytes, URL or local path' };
+                    }
+                    const image = change.value.kind === 'base64' ? Buffer.from(change.value.value, 'base64') : change.value.value;
+                    await operation.run(() => client.setAvatar(image));
+                    // The input is not the platform CDN URL; it must not become an observed avatar.
+                    return { status: 'updated' };
+                }
+                default: return { status: 'rejected', message: `ICQQ cannot safely update ${change.field}` };
+            }
+            if (accepted && change.field === 'nickname')
+                client.nickname = change.value;
+            return accepted
+                ? { status: 'updated', profile: { [change.field]: change.value } }
+                : { status: 'rejected', message: `ICQQ rejected the ${change.field} change` };
+        },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.19",
+  "version": "1.1.21",
   "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,27 +33,27 @@
     "directory": "plugins/adapters/icqq"
   },
   "dependencies": {
-    "@zhin.js/adapter": "1.1.26",
-    "@zhin.js/agent-feature": "1.1.11",
-    "@zhin.js/client": "1.1.22",
+    "@zhin.js/adapter": "1.1.27",
+    "@zhin.js/agent-feature": "1.1.12",
+    "@zhin.js/client": "1.1.23",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/core": "1.1.54",
-    "@zhin.js/feature-kit": "1.1.10",
-    "@zhin.js/im-contract": "1.1.9",
+    "@zhin.js/core": "1.1.55",
+    "@zhin.js/feature-kit": "1.1.11",
+    "@zhin.js/im-contract": "1.1.10",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.11",
-    "@zhin.js/permission": "1.1.10",
-    "@zhin.js/skill": "1.1.11",
-    "@zhin.js/tool": "1.1.13"
+    "@zhin.js/page": "1.1.13",
+    "@zhin.js/permission": "1.1.11",
+    "@zhin.js/skill": "1.1.12",
+    "@zhin.js/tool": "1.1.14"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.26",
-    "@zhin.js/command": "^1.1.12",
-    "@zhin.js/core": "^1.1.54",
-    "@zhin.js/prompt-section": "^1.1.10",
-    "zhin.js": "^1.1.19"
+    "@zhin.js/adapter": "^1.1.27",
+    "@zhin.js/command": "^1.1.13",
+    "@zhin.js/core": "^1.1.55",
+    "@zhin.js/prompt-section": "^1.1.11",
+    "zhin.js": "^1.1.20"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -78,8 +78,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/prompt-section": "1.1.10",
-    "zhin.js": "1.1.19"
+    "@zhin.js/prompt-section": "1.1.11",
+    "zhin.js": "1.1.20"
   },
   "files": [
     "adapters",
@@ -111,7 +111,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^2.0.0"
+        "api": "^2.1.0"
       },
       {
         "package": "@zhin.js/command",
@@ -119,7 +119,7 @@
       },
       {
         "package": "@zhin.js/tool",
-        "api": "^1.0.0"
+        "api": "^1.1.0"
       },
       {
         "package": "@zhin.js/skill",

package/prompt-sections/platform/index.js

@@ -4,7 +4,7 @@ export default defineAgentPromptSection({
     title: 'ICQQ / QQ',
     content: [
         'Use the current Skill catalog; discover the intent and load the matching Skill before its private Tool.',
-        'The current IM operation selects the bot Client automatically; never guess user_id or group_id.',
+        'The current IM operation selects your current endpoint Client automatically; never guess user_id or group_id.',
     ].join('\n'),
     layer: 'tools',
     order: 70,

package/prompt-sections/platform/index.ts

@@ -4,7 +4,7 @@ export default defineAgentPromptSection({
   title: 'ICQQ / QQ',
   content: [
     'Use the current Skill catalog; discover the intent and load the matching Skill before its private Tool.',
-    'The current IM operation selects the bot Client automatically; never guess user_id or group_id.',
+    'The current IM operation selects your current endpoint Client automatically; never guess user_id or group_id.',
   ].join('\n'),
   layer: 'tools',
   order: 70,

package/schema.json

@@ -433,6 +433,27 @@
               "endpoint",
               "id"
             ]
+          },
+          "nickname": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "账号昵称兜底",
+            "x-i18n": {
+              "en": {
+                "description": "Fallback account nickname"
+              }
+            }
+          },
+          "profile": {
+            "$ref": "#/$defs/selfProfileFallback",
+            "description": "账号资料兜底",
+            "x-i18n": {
+              "en": {
+                "description": "Fallback account profile"
+              }
+            }
           }
         },
         "required": [
@@ -541,10 +562,94 @@
         "endpoint",
         "id"
       ]
+    },
+    "nickname": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "账号昵称兜底",
+      "x-i18n": {
+        "en": {
+          "description": "Fallback account nickname"
+        }
+      }
+    },
+    "profile": {
+      "$ref": "#/$defs/selfProfileFallback",
+      "description": "账号资料兜底",
+      "x-i18n": {
+        "en": {
+          "description": "Fallback account profile"
+        }
+      }
     }
   },
   "required": [
     "master",
     "endpoints"
-  ]
+  ],
+  "$defs": {
+    "selfProfileFallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "gender": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "enum": [
+            "male",
+            "female",
+            "other",
+            "unknown",
+            null
+          ]
+        },
+        "age": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "birthday": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$"
+        },
+        "signature": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "avatar": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^(https?://[^\\s/?#]+(?:[/?#].*)?|)$"
+        },
+        "interests": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "bio": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
+  }
 }

package/src/endpoint.ts

@@ -79,6 +79,7 @@ import type { SystemMessage as IcqqSystemMessage } from './types.js';
 import { ManagedIcqqClient, type IcqqBackgroundOperation } from './managed-client.js';
 import { inspectGroupMember, moderateGroupMember } from './group-moderation.js';
 import { inspectGroupMemberProfile, inspectGroupScene } from './group-scene.js';
+import { createIcqqSelfProfile } from './self-profile.js';
 
 export interface IcqqEndpointOptions {
   readonly id: CapabilityId;
@@ -239,7 +240,7 @@ export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
       start: signal => this.#startFramework(signal), open: () => this.#openFramework(), close: () => this.#closeFramework(), stop: () => this.#stopFramework(),
       send: request => this.#sendFramework(request), get name() { return name(); },
       get transportState() { return state(); },
-      management: this.#management, control: this.#control,
+      management: this.#management, control: this.#control, profile: createIcqqSelfProfile(this),
       get content() { return content(); },
     });
     this.#contentResolver = new IcqqContentResolver(this);

package/src/protocol.ts

@@ -1,3 +1,4 @@
+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 { resolveAdapterNotifyTarget, type AdapterNotifyTarget, type ResolvedAdapterNotifyTarget } from 'zhin.js/adapter';
@@ -232,7 +233,7 @@ export const Actions = {
 } as const;
 
 /** One expanded ICQQ endpoint configuration produced by AdapterIndex. */
-export interface IcqqEndpointConfig {
+export interface IcqqEndpointConfig extends EndpointProfileConfiguration {
   readonly id: string;
   readonly autoReconnect?: boolean;
   readonly outboundMedia?: 'file' | 'base64';

package/src/self-profile.ts

@@ -0,0 +1,55 @@
+import type { Client } from '@icqqjs/icqq';
+import { createEndpointOperation, type EndpointProfile } from 'zhin.js/adapter';
+import type { SelfProfile } from '@zhin.js/im-contract';
+
+type IcqqProfileClient = Pick<Client,
+  'uin' | 'nickname' | 'isOnline' | 'getProfile' | 'setNickname' | 'setGender' |
+  'setSignature' | 'setDescription' | 'setAvatar'>;
+
+/** ICQQ owns the platform facts; config fallbacks and call leases belong to Adapter. */
+export function createIcqqSelfProfile(client: IcqqProfileClient): EndpointProfile {
+  return Object.freeze<EndpointProfile>({
+    writableFields: Object.freeze(['nickname', 'gender', 'signature', 'bio', 'avatar']),
+    get current() { return client.isOnline() ? { nickname: client.nickname } : {}; },
+    async read({ signal }) {
+      const raw = await createEndpointOperation({ signal }).prepare(() => client.getProfile(client.uin));
+      const profile: SelfProfile = {
+        ...(typeof raw.nickname === 'string' ? { nickname: raw.nickname } : {}),
+        ...(raw.sex === 'male' || raw.sex === 'female' || raw.sex === 'unknown' ? { gender: raw.sex } : {}),
+        ...(typeof raw.age === 'number' && Number.isFinite(raw.age) ? { age: raw.age } : {}),
+        ...(typeof raw.signature === 'string' ? { signature: raw.signature } : {}),
+        ...(typeof raw.avatar?.url === 'string' ? { avatar: raw.avatar.url } : {}),
+      };
+      return profile;
+    },
+    async write({ change, signal }) {
+      const operation = createEndpointOperation({ signal });
+      let accepted: boolean;
+      switch (change.field) {
+        case 'nickname': accepted = await operation.run(() => client.setNickname(change.value)); break;
+        case 'gender': {
+          if (change.value === 'other') return { status: 'rejected', message: 'ICQQ supports male, female or unknown gender' };
+          const gender = change.value === 'male' ? 1 : change.value === 'female' ? 2 : 0;
+          accepted = await operation.run(() => client.setGender(gender));
+          break;
+        }
+        case 'signature': accepted = await operation.run(() => client.setSignature(change.value)); break;
+        case 'bio': accepted = await operation.run(() => client.setDescription(change.value)); break;
+        case 'avatar': {
+          if (change.value.kind === 'file') {
+            return { status: 'rejected', message: 'ICQQ avatar requires resolved image bytes, URL or local path' };
+          }
+          const image = change.value.kind === 'base64' ? Buffer.from(change.value.value, 'base64') : change.value.value;
+          await operation.run(() => client.setAvatar(image));
+          // The input is not the platform CDN URL; it must not become an observed avatar.
+          return { status: 'updated' };
+        }
+        default: return { status: 'rejected', message: `ICQQ cannot safely update ${change.field}` };
+      }
+      if (accepted && change.field === 'nickname') client.nickname = change.value;
+      return accepted
+        ? { status: 'updated', profile: { [change.field]: change.value } }
+        : { status: 'rejected', message: `ICQQ rejected the ${change.field} change` };
+    },
+  });
+}