@zhin.js/adapter-onebot11 1.1.20 → 1.1.22

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # @zhin.js/adapter-onebot11
 
+## 1.1.22
+
+### Patch Changes
+
+- b249e5e: ADR 0044 C4：事件映射迁出 core。新增 `@zhin.js/adapter-onebot-events`，承载 OneBot v11 / NapCat / icqq 的原始通知与请求 → 标准事件映射（`receiveOneBotLikeSideEvent`、`mapNoticeParts`、`mapRequestParts`、`resolveSideEventDedupeKey` 及 OneBot 映射表，icqq 差异用覆盖表表达）；KOOK、Slack 的映射迁入各自适配器；`@zhin.js/core` 只保留标准事件名、类型与 `buildNotice` / `buildRequest` / `buildSystem` / `senderFromId`，不再含任何平台名。core 不再导出上述映射函数与 `ONEBOT_/KOOK_/SLACK_NOTICE_PARTS_MAP`、`SideEventPlatform`、`OneBotLike*` 类型，适配器改从共享包导入。
+- 41ff1a5: ADR 0044 C5: every official adapter now declares a capability `profile` (its `segments` moved into `profile.default.messaging.segments`). icqq declares the complete profile (per conversation kind: scene, all 14 actions with real limits, events, feedback, delivery) and implements the seven new management ports (`pokeUser`, `unmuteGroupMember`, `muteAllGroupMembers`, `setGroupCard`, `setGroupTitle`, `setGroupEssence`, `inviteGroupMember`) with fresh bot-role reads. qq official declares its passive reply windows; undeclared capabilities stay unsupported.
+- cbd3f14: ADR 0044 integration and C6 guard. `delivery.spool` now reproduces the pre-0044 media rule (icqq `false`, every other official adapter `true`). icqq narrows `actions.recall.others` unless the Bot is admin or owner, and declares recall for groups. Endpoint kind capabilities merge the Endpoint's `operations` (Discord reactions keep working; Discord declares reaction feedback). Adapters in the `@zhin.js/` scope are trusted: their custom prompt text is not labelled `external_content`. Core no longer keeps a telegram/discord interactive-policy table (adapters declare `segments.interactive`). New `pnpm check:no-platform-branches` blocks platform-name branches in runtime code.
+- 4fe49b5: 支持配置按需生效：分离保存与有效版本，独立变更先应用，账号资料更新保留连接，模型按回合使用确定版本；Console 返回结构化应用结果。监听改为仅显式 --watch 启用，开发模板显式选择源码和配置监听。
+
+  自变更消费配置应用回执，避免已处理配置被二次重载；持久化本次写入修订和应用结果，未知结果或修订冲突时停止自动续作并保留现场，恢复不会覆盖未经本次变更确认的配置。
+
+- Updated dependencies [b249e5e]
+- Updated dependencies [57661f6]
+- Updated dependencies [cbd3f14]
+- Updated dependencies [299863a]
+- Updated dependencies [aaa93d7]
+- Updated dependencies [bd524d1]
+- Updated dependencies [126ae99]
+- Updated dependencies [4fe49b5]
+- Updated dependencies [cce07db]
+- Updated dependencies [b652db3]
+- Updated dependencies [0315ba0]
+- Updated dependencies [00be764]
+  - @zhin.js/adapter-onebot-events@0.0.1
+  - @zhin.js/core@1.1.56
+  - @zhin.js/adapter@1.1.28
+  - @zhin.js/im-contract@1.1.11
+  - @zhin.js/tool@1.1.15
+  - @zhin.js/skill@1.1.13
+  - @zhin.js/host-http@1.1.14
+  - @zhin.js/feature-kit@1.1.12
+  - @zhin.js/client@1.1.24
+  - @zhin.js/page@1.1.14
+  - @zhin.js/agent-feature@1.1.13
+  - @zhin.js/permission@1.1.12
+
+## 1.1.21
+
+### Patch Changes
+
+- b88e988: Preserve account-profile write acknowledgements already observed before cancellation, distinguish native Discord REST rejection from unknown outcomes, and retain the last valid profile when a newer concurrent read fails. Keep scene-scoped SOUL presence consistent with the actual prompt and allow discovered URLs to pass through the existing network authorization policy.
+- 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/host-http@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

package/adapters/onebot11/index.js

@@ -9,11 +9,23 @@ export { OneBot11WsEndpoint } from "../../lib/ws-endpoint.js";
 export { OneBot11WssEndpoint } from "../../lib/wss-endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
-    operations: ['recall'],
     // OneBot file 参数原生消费 url / base64:// 媒体；无卡片交互面，交互段降级纯文本。
-    segments: {
-        outboundMedia: ['url', 'base64'],
-        interactive: 'text',
+    profile: {
+        default: {
+            messaging: {
+                segments: {
+                    outboundMedia: ['url', 'base64'],
+                    interactive: 'text',
+                },
+                quote: true,
+                recall: {},
+            },
+            actions: {
+                recall: { scopes: ['private', 'group'] },
+                quoteReply: { scopes: ['private', 'group'] },
+            },
+            delivery: { send: true, proactive: true, spool: true },
+        },
     },
     createAdapter: context => new Onebot11Adapter(context),
 });

package/adapters/onebot11/index.ts

@@ -15,11 +15,23 @@ export type { OneBot11WsSocket, OneBot11WsCreateOptions } from '../../src/ws-typ
 
 export default defineAdapter<OneBot11EndpointConfig>({
   capabilities: ['inbound', 'outbound'],
-  operations: ['recall'],
   // OneBot file 参数原生消费 url / base64:// 媒体；无卡片交互面，交互段降级纯文本。
-  segments: {
-    outboundMedia: ['url', 'base64'],
-    interactive: 'text',
+  profile: {
+    default: {
+      messaging: {
+        segments: {
+          outboundMedia: ['url', 'base64'],
+          interactive: 'text',
+        },
+        quote: true,
+        recall: {},
+      },
+      actions: {
+        recall: { scopes: ['private', 'group'] },
+        quoteReply: { scopes: ['private', 'group'] },
+      },
+      delivery: { send: true, proactive: true, spool: true },
+    },
   },
   createAdapter: context => new Onebot11Adapter(context),
 });

package/lib/protocol.d.ts

@@ -1,3 +1,4 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 /**
  * OneBot 11 protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -5,7 +6,7 @@
  */
 import { type MediaRef, type ConversationRef } from '@zhin.js/im-contract';
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface OneBot11EndpointConfig {
+export interface OneBot11EndpointConfig extends EndpointProfileConfiguration {
     readonly connection?: 'ws' | 'wss';
     readonly id: string;
     readonly access_token?: string;

package/lib/self-profile.d.ts

@@ -0,0 +1,12 @@
+import type { EndpointProfile, PendingRpcRequest } from 'zhin.js/adapter';
+interface Onebot11SelfProfileOptions {
+    readonly call: (request: PendingRpcRequest) => Promise<unknown>;
+    readonly reportAccount: (id: string | undefined) => void;
+}
+interface Onebot11SelfProfile extends EndpointProfile {
+    /** The same verified account observations used by transport ingress and shutdown. */
+    reportAccount(id: string | undefined): void;
+}
+/** OneBot11's standard self-information action has no standard profile mutation counterpart. */
+export declare function createOnebot11SelfProfile({ call, reportAccount }: Onebot11SelfProfileOptions): Onebot11SelfProfile;
+export {};

package/lib/self-profile.js

@@ -0,0 +1,56 @@
+/** OneBot11's standard self-information action has no standard profile mutation counterpart. */
+export function createOnebot11SelfProfile({ call, reportAccount }) {
+    let nickname;
+    let accountId;
+    let accountRevision = 0;
+    let readSequence = 0;
+    let publishedSequence = 0;
+    return Object.freeze({
+        writableFields: Object.freeze([]),
+        get current() { return nickname === undefined ? {} : { nickname }; },
+        reportAccount(id) {
+            if (id !== accountId || id === undefined) {
+                accountId = id;
+                nickname = undefined;
+                accountRevision++;
+                readSequence++;
+                publishedSequence = readSequence;
+            }
+            reportAccount(id);
+        },
+        async read({ signal }) {
+            const revision = accountRevision;
+            const sequence = ++readSequence;
+            const assertAccount = () => {
+                signal.throwIfAborted();
+                if (revision !== accountRevision)
+                    throw new Error('OneBot11 account changed while reading self profile');
+            };
+            const self = await call({ action: 'get_login_info', signal });
+            assertAccount();
+            if (!self?.user_id || typeof self.nickname !== 'string')
+                throw new Error('OneBot11 returned an incomplete self profile');
+            if (sequence > publishedSequence) {
+                publishedSequence = sequence;
+                accountId = String(self.user_id);
+                nickname = self.nickname;
+                reportAccount(accountId);
+            }
+            // Keep confirmed login facts in current, while lookup errors remain lookup errors.
+            const details = await call({ action: 'get_stranger_info', params: { user_id: self.user_id, no_cache: true }, signal });
+            assertAccount();
+            if (!details || String(details.user_id) !== String(self.user_id))
+                throw new Error('OneBot11 returned another account profile');
+            const observedNickname = typeof details.nickname === 'string' ? details.nickname : self.nickname;
+            if (sequence >= publishedSequence) {
+                publishedSequence = sequence;
+                nickname = observedNickname;
+            }
+            const profile = { nickname: observedNickname,
+                ...(details.sex === 'male' || details.sex === 'female' || details.sex === 'unknown' ? { gender: details.sex } : {}),
+                ...(typeof details.age === 'number' && Number.isFinite(details.age) ? { age: details.age } : {}),
+            };
+            return profile;
+        },
+    });
+}

package/lib/side-event-dispatch.js

@@ -1,4 +1,4 @@
-import { receiveOneBotLikeSideEvent } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent } from '@zhin.js/adapter-onebot-events';
 import { formatCompact } from '@zhin.js/logger';
 export function receiveOneBot11SideEvent(raw, context) {
     const { emit, endpointKey, caller, logger } = context;

package/lib/ws-endpoint.js

@@ -1,3 +1,4 @@
+import { createOnebot11SelfProfile } from './self-profile.js';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /**
  * OneBot11 WS client endpoint — outbound connect to OneBot implementation.
@@ -25,6 +26,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
     #ws;
     #stopped = false;
     #rpc;
+    #profile;
     constructor(options) {
         const rpc = createOneBot11Rpc({ endpointId: options.config.id, signal: options.signal,
             socket: () => this.#lifecycle.state === 'open' ? this.#ws : undefined,
@@ -36,6 +38,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
         const callApi = (request) => this.#rpc.call(request).then(readOnebot11Response);
         this.#management = createOneBot11EndpointManagement({ callApi });
         this.#content = createOneBot11ContentPort(callApi);
+        this.#profile = createOnebot11SelfProfile({ call: callApi, reportAccount: id => this[endpointSpec].reportSelfUserId(id) });
         const readTransportState = () => this.#lifecycle.state;
         this[endpointSpec] = createEndpointSpecification(this, {
             name: options.config.id,
@@ -44,6 +47,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
             send: request => this.#send(request),
             get transportState() { return readTransportState(); },
             management: this.#management, control: this.#control, content: this.#content,
+            profile: this.#profile,
         });
         this.#releaseClientEvents = forwardOnebot11ClientEvents(this, (name, payload) => {
             void this[endpointSpec].events.run(() => {
@@ -106,7 +110,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
             this.#rpc.dispose();
             this.#releaseClientEvents();
             this.#ws = undefined;
-            this[endpointSpec].reportSelfUserId(undefined);
+            this.#profile.reportAccount(undefined);
         }
     }
     async #send({ conversation, payload, signal }) {
@@ -134,7 +138,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
     #admitRaw(ev) {
         const selfId = resolveOnebot11SelfId(ev.self_id);
         if (!this.#stopped && selfId)
-            this[endpointSpec].reportSelfUserId(selfId);
+            this.#profile.reportAccount(selfId);
         if (!isMessageEvent(ev)) {
             receiveOneBot11SideEvent(ev, {
                 emit: (name, payload) => this[endpointSpec].events.emit(name, payload),
@@ -181,7 +185,7 @@ export class OneBot11WsEndpoint extends Onebot11Client {
         if (this.#stopped || this.#transportState !== 'open')
             return;
         if (selfId)
-            this[endpointSpec].reportSelfUserId(selfId);
+            this.#profile.reportAccount(selfId);
     }
     #warnPlatformEvent(error) {
         this.#logger.warn(formatCompact({

package/lib/wss-endpoint.js

@@ -1,3 +1,4 @@
+import { createOnebot11SelfProfile } from './self-profile.js';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /**
  * OneBot11 reverse WSS endpoint — accepts inbound WebSocket from OneBot implementation.
@@ -26,6 +27,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
     #connectionLifecycle;
     #connectionTask = Promise.resolve();
     #rpc;
+    #profile;
     #started = false;
     #stopped = false;
     constructor(options) {
@@ -44,6 +46,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
         const callApi = (request) => this.#rpc.call(request).then(readOnebot11Response);
         this.#management = createOneBot11EndpointManagement({ callApi });
         this.#content = createOneBot11ContentPort(callApi);
+        this.#profile = createOnebot11SelfProfile({ call: callApi, reportAccount: id => this[endpointSpec].reportSelfUserId(id) });
         const readTransportState = () => this.#transportState;
         this[endpointSpec] = createEndpointSpecification(this, {
             name: options.config.id,
@@ -52,6 +55,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
             send: request => this.#send(request),
             get transportState() { return readTransportState(); },
             management: this.#management, control: this.#control, content: this.#content,
+            profile: this.#profile,
         });
         this.#releaseClientEvents = forwardOnebot11ClientEvents(this, (name, payload) => {
             void this[endpointSpec].events.run(() => {
@@ -121,7 +125,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
             this.#releaseClientEvents();
             this.#ws = undefined;
             this.#started = false;
-            this[endpointSpec].reportSelfUserId(undefined);
+            this.#profile.reportAccount(undefined);
         }
     }
     async #send({ conversation, payload, signal }) {
@@ -142,7 +146,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
     #admitRaw(ev) {
         const selfId = resolveOnebot11SelfId(ev.self_id);
         if (!this.#stopped && selfId)
-            this[endpointSpec].reportSelfUserId(selfId);
+            this.#profile.reportAccount(selfId);
         if (!isMessageEvent(ev)) {
             receiveOneBot11SideEvent(ev, {
                 emit: (name, payload) => this[endpointSpec].events.emit(name, payload),
@@ -188,7 +192,7 @@ export class OneBot11WssEndpoint extends Onebot11Client {
         if (this.#stopped || this.#transportState !== 'open')
             return;
         if (selfId)
-            this[endpointSpec].reportSelfUserId(selfId);
+            this.#profile.reportAccount(selfId);
     }
     #warnPlatformEvent(error) {
         this.#logger.warn(formatCompact({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-onebot11",
-  "version": "1.1.20",
+  "version": "1.1.22",
   "description": "Zhin.js OneBot 11 adapter for Plugin Runtime (WebSocket client)",
   "type": "module",
   "main": "./lib/index.js",
@@ -45,19 +45,20 @@
     "@imhelper/onebot-v11": "1.0.7",
     "imhelper": "1.0.7",
     "ws": "^8.21.1",
-    "@zhin.js/adapter": "1.1.26",
-    "@zhin.js/agent-feature": "1.1.11",
-    "@zhin.js/client": "1.1.22",
+    "@zhin.js/adapter-onebot-events": "0.0.1",
+    "@zhin.js/adapter": "1.1.28",
+    "@zhin.js/agent-feature": "1.1.13",
+    "@zhin.js/client": "1.1.24",
     "@zhin.js/console-contract": "1.1.3",
-    "@zhin.js/core": "1.1.54",
-    "@zhin.js/feature-kit": "1.1.10",
-    "@zhin.js/host-http": "1.1.12",
-    "@zhin.js/im-contract": "1.1.9",
+    "@zhin.js/core": "1.1.56",
+    "@zhin.js/feature-kit": "1.1.12",
+    "@zhin.js/host-http": "1.1.14",
+    "@zhin.js/im-contract": "1.1.11",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/page": "1.1.12",
-    "@zhin.js/permission": "1.1.10",
-    "@zhin.js/skill": "1.1.11",
-    "@zhin.js/tool": "1.1.13"
+    "@zhin.js/page": "1.1.14",
+    "@zhin.js/permission": "1.1.12",
+    "@zhin.js/skill": "1.1.13",
+    "@zhin.js/tool": "1.1.15"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -65,15 +66,15 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/host-http": "1.1.12",
-    "zhin.js": "1.1.19"
+    "@zhin.js/host-http": "1.1.14",
+    "zhin.js": "1.1.21"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.26",
-    "@zhin.js/command": "^1.1.12",
-    "@zhin.js/core": "^1.1.54",
-    "zhin.js": "^1.1.19"
+    "@zhin.js/adapter": "^1.1.28",
+    "@zhin.js/command": "^1.1.14",
+    "@zhin.js/core": "^1.1.56",
+    "zhin.js": "^1.1.21"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -107,7 +108,7 @@
     "features": [
       {
         "package": "@zhin.js/adapter",
-        "api": "^2.0.0"
+        "api": "^2.1.0"
       },
       {
         "package": "@zhin.js/command",
@@ -115,7 +116,7 @@
       },
       {
         "package": "@zhin.js/tool",
-        "api": "^1.0.0"
+        "api": "^1.1.0"
       },
       {
         "package": "@zhin.js/skill",

package/plugin.js

@@ -4,6 +4,7 @@ import { permissionHostToken, createSceneRolePlatformChecker } from '@zhin.js/pe
 import { createOnebot11ConsoleRpc } from "./lib/console.js";
 export default definePlugin({
     name: 'onebot11',
+    configUpdate: { featurePaths: [['nickname'], ['profile'], ['endpoints']] },
     metadata: {
         displayName: 'OneBot 11 Adapter',
     },

package/schema.json

@@ -115,6 +115,27 @@
           "id": {
             "type": "string",
             "description": "OneBot11 bot name"
+          },
+          "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": [
@@ -136,9 +157,93 @@
           "description": "Command prefix. The default empty string allows unprefixed commands; '/' requires a leading slash. Each endpoints[i] can override it."
         }
       }
+    },
+    "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": [
     "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/protocol.ts

@@ -1,3 +1,4 @@
+import type { EndpointProfileConfiguration } from 'zhin.js/adapter';
 /**
  * OneBot 11 protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
  * Canonicalization is owned by gateway/core before endpoint.send.
@@ -9,7 +10,7 @@ import { formatCompact, getLogger } from '@zhin.js/logger';
 const logger = getLogger('onebot11');
 
 /** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
-export interface OneBot11EndpointConfig {
+export interface OneBot11EndpointConfig extends EndpointProfileConfiguration {
   readonly connection?: 'ws' | 'wss';
   readonly id: string;
   readonly access_token?: string;

package/src/self-profile.ts

@@ -0,0 +1,67 @@
+import type { EndpointProfile, PendingRpcRequest } from 'zhin.js/adapter';
+import type { SelfProfile } from '@zhin.js/im-contract';
+
+interface Onebot11SelfProfileOptions {
+  readonly call: (request: PendingRpcRequest) => Promise<unknown>;
+  readonly reportAccount: (id: string | undefined) => void;
+}
+interface Onebot11SelfProfile extends EndpointProfile {
+  /** The same verified account observations used by transport ingress and shutdown. */
+  reportAccount(id: string | undefined): void;
+}
+
+/** OneBot11's standard self-information action has no standard profile mutation counterpart. */
+export function createOnebot11SelfProfile({ call, reportAccount }: Onebot11SelfProfileOptions): Onebot11SelfProfile {
+  let nickname: string | undefined;
+  let accountId: string | undefined;
+  let accountRevision = 0;
+  let readSequence = 0;
+  let publishedSequence = 0;
+  return Object.freeze<Onebot11SelfProfile>({
+    writableFields: Object.freeze([]),
+    get current() { return nickname === undefined ? {} : { nickname }; },
+    reportAccount(id) {
+      if (id !== accountId || id === undefined) {
+        accountId = id;
+        nickname = undefined;
+        accountRevision++;
+        readSequence++;
+        publishedSequence = readSequence;
+      }
+      reportAccount(id);
+    },
+    async read({ signal }) {
+      const revision = accountRevision;
+      const sequence = ++readSequence;
+      const assertAccount = () => {
+        signal.throwIfAborted();
+        if (revision !== accountRevision) throw new Error('OneBot11 account changed while reading self profile');
+      };
+      const self = await call({ action: 'get_login_info', signal }) as { user_id?: number | string; nickname?: string } | undefined;
+      assertAccount();
+      if (!self?.user_id || typeof self.nickname !== 'string') throw new Error('OneBot11 returned an incomplete self profile');
+      if (sequence > publishedSequence) {
+        publishedSequence = sequence;
+        accountId = String(self.user_id);
+        nickname = self.nickname;
+        reportAccount(accountId);
+      }
+      // Keep confirmed login facts in current, while lookup errors remain lookup errors.
+      const details = await call({ action: 'get_stranger_info', params: { user_id: self.user_id, no_cache: true }, signal }) as {
+        user_id?: number | string; nickname?: string; sex?: string; age?: number;
+      } | undefined;
+      assertAccount();
+      if (!details || String(details.user_id) !== String(self.user_id)) throw new Error('OneBot11 returned another account profile');
+      const observedNickname = typeof details.nickname === 'string' ? details.nickname : self.nickname;
+      if (sequence >= publishedSequence) {
+        publishedSequence = sequence;
+        nickname = observedNickname;
+      }
+      const profile: SelfProfile = { nickname: observedNickname,
+        ...(details.sex === 'male' || details.sex === 'female' || details.sex === 'unknown' ? { gender: details.sex } : {}),
+        ...(typeof details.age === 'number' && Number.isFinite(details.age) ? { age: details.age } : {}),
+      };
+      return profile;
+    },
+  });
+}

package/src/side-event-dispatch.ts

@@ -1,4 +1,4 @@
-import { receiveOneBotLikeSideEvent } from '@zhin.js/core';
+import { receiveOneBotLikeSideEvent } from '@zhin.js/adapter-onebot-events';
 import type { EndpointEventEmitter } from 'zhin.js/adapter';
 import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
 import type { OneBot11Event } from './protocol.js';

package/src/ws-endpoint.ts

@@ -1,3 +1,4 @@
+import { createOnebot11SelfProfile } from './self-profile.js';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /**
  * OneBot11 WS client endpoint — outbound connect to OneBot implementation.
@@ -68,6 +69,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
   #ws?: OneBot11WsSocket;
   #stopped = false;
   readonly #rpc: OneBot11Rpc;
+  readonly #profile: ReturnType<typeof createOnebot11SelfProfile>;
 
   constructor(options: OneBot11WsEndpointOptions) {
     const rpc = createOneBot11Rpc({ endpointId: options.config.id, signal: options.signal,
@@ -80,6 +82,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
     const callApi = (request: PendingRpcRequest) => this.#rpc.call(request).then(readOnebot11Response);
     this.#management = createOneBot11EndpointManagement({ callApi });
     this.#content = createOneBot11ContentPort(callApi);
+    this.#profile = createOnebot11SelfProfile({ call: callApi, reportAccount: id => this[endpointSpec].reportSelfUserId(id) });
     const readTransportState = () => this.#lifecycle.state;
     this[endpointSpec] = createEndpointSpecification(this, {
       name: options.config.id,
@@ -88,6 +91,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
       send: request => this.#send(request),
       get transportState() { return readTransportState(); },
       management: this.#management, control: this.#control, content: this.#content,
+      profile: this.#profile,
     });
     this.#releaseClientEvents = forwardOnebot11ClientEvents(this, (name, payload) => {
       void this[endpointSpec].events.run(() => {
@@ -145,7 +149,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
       this.#rpc.dispose();
       this.#releaseClientEvents();
       this.#ws = undefined;
-      this[endpointSpec].reportSelfUserId(undefined);
+      this.#profile.reportAccount(undefined);
     }
   }
 
@@ -175,7 +179,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
 
   #admitRaw(ev: OneBot11Event): void {
     const selfId = resolveOnebot11SelfId(ev.self_id);
-    if (!this.#stopped && selfId) this[endpointSpec].reportSelfUserId(selfId);
+    if (!this.#stopped && selfId) this.#profile.reportAccount(selfId);
     if (!isMessageEvent(ev)) {
       receiveOneBot11SideEvent(ev, {
         emit: (name, payload) => this[endpointSpec].events.emit(name, payload),
@@ -221,7 +225,7 @@ export class OneBot11WsEndpoint extends Onebot11Client implements Endpoint {
       }));
     });
     if (this.#stopped || this.#transportState !== 'open') return;
-    if (selfId) this[endpointSpec].reportSelfUserId(selfId);
+    if (selfId) this.#profile.reportAccount(selfId);
   }
 
   #warnPlatformEvent(error: unknown): void {

package/src/wss-endpoint.ts

@@ -1,3 +1,4 @@
+import { createOnebot11SelfProfile } from './self-profile.js';
 import { EndpointDeliveryError } from '@zhin.js/im-contract';
 /**
  * OneBot11 reverse WSS endpoint — accepts inbound WebSocket from OneBot implementation.
@@ -64,6 +65,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
   readonly #connectionLifecycle: EndpointLifecycle;
   #connectionTask = Promise.resolve();
   readonly #rpc: OneBot11Rpc;
+  readonly #profile: ReturnType<typeof createOnebot11SelfProfile>;
   #started = false;
   #stopped = false;
 
@@ -83,6 +85,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
     const callApi = (request: PendingRpcRequest) => this.#rpc.call(request).then(readOnebot11Response);
     this.#management = createOneBot11EndpointManagement({ callApi });
     this.#content = createOneBot11ContentPort(callApi);
+    this.#profile = createOnebot11SelfProfile({ call: callApi, reportAccount: id => this[endpointSpec].reportSelfUserId(id) });
     const readTransportState = () => this.#transportState;
     this[endpointSpec] = createEndpointSpecification(this, {
       name: options.config.id,
@@ -91,6 +94,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
       send: request => this.#send(request),
       get transportState() { return readTransportState(); },
       management: this.#management, control: this.#control, content: this.#content,
+      profile: this.#profile,
     });
     this.#releaseClientEvents = forwardOnebot11ClientEvents(this, (name, payload) => {
       void this[endpointSpec].events.run(() => {
@@ -155,7 +159,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
       this.#releaseClientEvents();
       this.#ws = undefined;
       this.#started = false;
-      this[endpointSpec].reportSelfUserId(undefined);
+      this.#profile.reportAccount(undefined);
     }
   }
 
@@ -178,7 +182,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
 
   #admitRaw(ev: OneBot11Event): void {
     const selfId = resolveOnebot11SelfId(ev.self_id);
-    if (!this.#stopped && selfId) this[endpointSpec].reportSelfUserId(selfId);
+    if (!this.#stopped && selfId) this.#profile.reportAccount(selfId);
     if (!isMessageEvent(ev)) {
       receiveOneBot11SideEvent(ev, {
         emit: (name, payload) => this[endpointSpec].events.emit(name, payload),
@@ -223,7 +227,7 @@ export class OneBot11WssEndpoint extends Onebot11Client implements Endpoint {
       }));
     });
     if (this.#stopped || this.#transportState !== 'open') return;
-    if (selfId) this[endpointSpec].reportSelfUserId(selfId);
+    if (selfId) this.#profile.reportAccount(selfId);
   }
 
   #warnPlatformEvent(error: unknown): void {