@zhin.js/adapter-icqq 1.1.18 → 1.1.20

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @zhin.js/adapter-icqq
 
+## 1.1.20
+
+### Patch Changes
+
+- Updated dependencies [5e878ba]
+  - @zhin.js/page@1.1.12
+
+## 1.1.19
+
+### Patch Changes
+
+- 2c3610a: Move account lifecycle ownership into the generic Adapter base and let native Endpoints retain their SDK Client inheritance. Infer platform-specific operation Sessions from a single adapter registry while preserving command parameter, option, configuration and factory inference.
+
+  Bind message replies, management ports, login challenges and Agent cancellation to the captured account incarnation. Persist runtime account intent with encrypted, revision-checked Host storage; keep account management independent of Root process restarts. Require explicit operator confirmation before importing existing accounts, and give replacement accounts a new identity without inheriting previous Sessions.
+
+  Expose account save, start, stop, update and replacement through the existing adapter Console, with exact account ownership, truthful pending/unknown outcomes and no startup configuration or environment-file rewrites.
+
+  Complete the target migration across every adapter, the public authoring API, generators, examples and Console. This intentionally removes the old create factory, inheritable Endpoint/ClientEndpoint classes, Client descriptors and file-rewrite account management; plugin authors must use createAdapter, native Client inheritance and the single AdapterRegistry. Satori and OneBot12 require explicit platform/userId selection, and WeCom requires a separate agentId.
+
+  Verify opaque credential changes before the same configuration snapshot is committed. Drain admitted native callbacks across close/rollback, cancel target work on stop, and keep raw transport parsing, platform ACK timing and SDK native methods under their existing owners. Account metadata conceals credentials carried in URLs.
+
+- a9f4e48: PATCH COMPATIBILITY CUTOVER: this batch intentionally changes plugin APIs. The maintainer explicitly chose patch releases with declared version boundaries. Upgrade the complete tested dependency set; patch numbering does not promise compatibility with the removed interfaces.
+
+  The first planned floors are zhin.js 1.1.19, Core 1.1.54, Adapter 1.1.26, FeatureKit 1.1.10, Plugin Runtime 1.1.18, Runtime/Isolate 1.1.16 and Agent 1.1.45. Keep old-interface plugins with the earlier locked stack until they are migrated. Adapter's independent Feature API changes from 1.0.0 to 2.0.0; official consumers declare ^2.0.0. Existing Feature API admission rejects explicitly incompatible ranges; omitted API metadata keeps its existing behavior and does not certify compatibility. Runtime engine and patch-only release gates remain unchanged.
+
+  Use the native-Client Adapter target contract, canonical FeatureKit AdapterRegistry augmentation and named Endpoint control/management requests. Route message controls from canonical message/conversation refs; retain exact source authority and propagate caller/account/explicit-Root-stop cancellation. Replace removed Agent activity feedback exports with source-bound feedback. HMR pause/resume belongs to concrete plugin instances; plugins choose accepted-work policy without changing Controller commit/rollback authority. Cooperative worker/process control cancellation does not kill an isolate or reopen retired business admission.
+
+  Provide authenticated historical-data preview, exact selected binding, transactional application, authoritative inspection and explicit resumption, including active games. Preserve before-images and journals; never replay an unconfirmed effect, infer an account from an alias, or reuse historical permission grants. Owner V2 approvals remain inactive legacy data, while new writes use V3. Rollback requires matching software, lockfile and verified data; installing old code alone cannot read a new V3 approval file. Conflicting after-images are never overwritten.
+
+  See docs/plans/adapter-operation-version-boundaries.md and the Chinese/English upgrade guide for the complete version inventory, custom-plugin changes, acceptance and recovery sequence. These code and metadata changes do not authorize merging, publication, deployment, login, production migration or removal of installed workspace patches.
+
+- Updated dependencies [2c3610a]
+- Updated dependencies [a9f4e48]
+- Updated dependencies [f8505b0]
+  - @zhin.js/adapter@1.1.26
+  - @zhin.js/feature-kit@1.1.10
+  - @zhin.js/core@1.1.54
+  - @zhin.js/client@1.1.22
+  - @zhin.js/page@1.1.11
+  - @zhin.js/agent-feature@1.1.11
+  - @zhin.js/skill@1.1.11
+  - @zhin.js/tool@1.1.13
+  - @zhin.js/permission@1.1.10
+
 ## 1.1.18
 
 ### Patch Changes

package/README.md

@@ -5,7 +5,7 @@ ICQQ Plugin Runtime 适配器 — 进程内直接使用 [@icqqjs/icqq](https://g
 ## 功能特性
 
 - 群聊 / 私聊 / 群临时会话 / QQ 频道消息
-- 入站：ICQQ Client 原始事件经 `Endpoint.emit(...)` 唯一入口上送；文本与图片 / 语音 / 视频 / 文件统一归一为 canonical `Segment` + `MediaRef`
+- 入站：ICQQ Client 原始事件经 `endpoint[endpointSpec].events` 唯一入口上送；文本与图片 / 语音 / 视频 / 文件统一归一为 canonical `Segment` + `MediaRef`
 - 出站：canonical Segment 直接投影为 ICQQ 原生 `Sendable`，再由 `sendGroupMsg` / `sendPrivateMsg` / …发送
 - 群聊 reaction：`control.addReaction` / `removeReaction`（协议 ACK 失败不阻塞后续发送）
 - Agent 工具：按职责拆分在 `agents/icqq/skills/icqq-*/tools/`，只在对应 Skill 激活后披露
@@ -97,9 +97,9 @@ export default defineHandler({
 })
 ```
 
-`client` 就是当前账号的真实 ICQQ SDK 实例，不是 Endpoint facade。未知扩展事件可显式使用
+原生 Handler 参数中的 `client` 就是当前账号的真实 ICQQ SDK 实例，`event` 保留同一原生事件对象、原型和方法。消息操作的 `session.endpoint`、`session.event` 与 `session.adapter` 分别提供同一个实际 Endpoint、原始消息事件和所属 Adapter。未知扩展事件可显式使用
 `event: '*'`；此时 Client 类型保持完整，事件 payload 为 `unknown`。普通消息回复仍应走
-`Message.$reply`；群管理、请求审批与 ICQQ 专属查询可直接调用当前事件的 `client`。
+`Message.$reply`；群管理、请求审批与 ICQQ 专属查询可直接调用当前 Session 的 Endpoint。
 
 Command context 的 `$client` 是按需读取的 getter：
 
@@ -140,16 +140,16 @@ export default defineAgentTool({
 
 `adapter` 缺失时 `$client` 静态类型为 `unknown`；声明后若实际 operation 不属于 ICQQ，
 运行时会在执行前拒绝。Client 只能在当前 operation 内使用。task、schedule 或 Host 等脱离
-IM turn 的场景，才使用 `icqqClient.get(context, endpointId)` 显式选择账号。
+IM turn 的场景，应通过 Host 提供的显式账号作用域操作，不能缓存旧 Client 或从另一个可写目录选择账号。
 
 ## 架构
 
 - `plugin.ts` + `adapters/icqq/index.ts`：Plugin Runtime 入口与 `defineAdapter` 声明
-- `src/endpoint.ts`：组合 ICQQ `Client`，只协调账号 transport、Zhin lifecycle 与各能力端口
+- `src/endpoint.ts`：继承真实 ICQQ `Client`，只协调账号 transport、Zhin lifecycle 与各能力端口
 - `src/content-resolver.ts`：保存已观察消息，并按深度和条数限制递归展开合并转发
 - `src/icqq-inbound.ts`：把 ICQQ 原生消息归一为 Zhin 入站消息
 - `src/protocol.ts`：配置解析、会话映射与出站目标转换
-- `src/client.ts`：向插件作者暴露 ICQQ `Client` / `EventMap` 类型注册
+- `src/client.ts`：从原生 SDK 推导事件类型，并将实际 `IcqqAdapter` 注册到唯一 `AdapterRegistry`
 - Agent 工具：`agents/icqq/skills/icqq-*/tools/<name>/index.ts`；权限说明见 `PERMITS.md`
 
 阅读适配器实现时从 `endpoint.ts` 看能力装配，再进入对应能力文件。包外代码只从
@@ -163,7 +163,7 @@ IM turn 的场景，才使用 `icqqClient.get(context, endpointId)` 显式选择
 - ICQQ 的语音、视频、文件是独立消息元素；它们与其他段混发时适配器会明确拒绝，避免协议栈静默丢段。
 - 入站语音 / 视频在 Endpoint 持有原生 Client 时解析可下载 URL；解析失败则保留真实平台引用，不伪造或丢弃媒体。
 - **Console 社交/群管 RPC 已接线**：endpoint 把好友/群/群成员列表、请求审批和群管操作归一化为冻结的 `EndpointManagement`。Host 只消费该语义端口。
-- 好友/入群请求与通知：经 the unified `Endpoint.emit(...)` ingress 分发到 `handlers`（`notice.receive` / `request.receive`）；审批走 `Request.$approve` / `EndpointManagement.approveRequest`。Console `request.list` 优先读 `management.listRequests()`（`getSystemMsg`），不再写入 `unified_inbox_request/notice`。
+- 好友/入群请求与通知：经 the unified `endpoint[endpointSpec].events` ingress 分发到 `handlers`（`notice.receive` / `request.receive`）；审批走 `Request.$approve` / `EndpointManagement.approveRequest`。Console `request.list` 优先读 `management.listRequests()`（`getSystemMsg`），不再写入 `unified_inbox_request/notice`。
 - `system.*`（登录扫码等）分发到 `system.receive`。
 - **登录辅助**：`system.login.qrcode|slider|device|auth` 经 `loginAssistToken`（`LoginAssist`）挂起待办；刷新后可用 Console `login.list` / `login.submit` 或终端 stdin 继续（对齐 icqq 官方 stdin 流程）。`system.online` / `login.error` 会清理该 endpoint 待办。
 
@@ -178,13 +178,17 @@ ICQQ Agent 可按需加载 `icqq-conversation` 查询当前群／频道和 Bot
 启动后打开 Console 的「ICQQ」页（地址 `/icqq`），可以：
 
 - 查看运行中的连接、点「测试连接」做连通性诊断；
-- 增删 `plugins.icqq.endpoints`（凭据写入 `.env`，配置里只保留 `${ENV}` 引用）；
+- 在账号库保存、修改、启动、停止、替换或删除该 Adapter 的账号；新增仅保存，不创建 SDK Client，需手动启动；
 - 处理登录待办（扫码 / 滑块 / 设备确认等，来自 LoginAssist）；
 
 ICQQ 首次登录的二维码、滑块、设备确认会出现在「登录待办」里，不需要再回到终端确认。
 
 读取需要 `icqq:read`，写操作需要 `icqq:write`；管理员 full token 不受限。页面里的「添加 endpoint」等价于原来的 `icqq endpoint add`。
 
+首次修改启动配置里的既有账号前，管理员必须核对清单并确认一次迁移。原 canonical 身份与历史保留，完整账号配置加密进入 Host 数据库；此后账号管理只写数据库，不修改启动文件或 `.env`，不重启进程。没有持久化账号端口的环境可使用静态配置连接，动态写操作明确不可用。
+
+启停意图在进程重启后恢复。停止或删除会取消并关闭目标账号的在途操作，其他账号继续运行；删除保留历史。已启动账号的连接配置更新先关闭旧 incarnation，再仅重连该账号；平台身份变化按替换处理，分配新内部身份、保留旧历史，新账号不继承旧 Session、个人设置或启动意图。提交结果未知时先刷新核实，不自动重复 CAS 或平台操作。
+
 ## 掉线通知与重新登录
 
 配置 `notify` 后，ICQQ 被踢下线、登录失败或启动失败时，会通过另一个适配器实例给 master 发通知。例如用 QQ 官方机器人实例通知：

package/adapters/icqq/index.js

@@ -1,15 +1,10 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { projectLocaleToken } from 'zhin.js/i18n';
+import { IcqqAdapter } from "../../lib/adapter.js";
 /**
  * Convention entry: discover `adapters/icqq/index.ts` → defineAdapter.
  */
-import { createAdapterOutageNotifier, defineAdapter } from 'zhin.js/adapter';
-import { loginAssistToken } from '@zhin.js/core/runtime';
-import { outboundHostToken } from 'zhin.js';
-import { IcqqEndpoint } from "../../lib/endpoint.js";
-import { icqqRuntimeStateToken } from "../../lib/icqq-runtime-state.js";
-import { icqqLoginControlToken } from "../../lib/icqq-login-control.js";
-import { resolveIcqqConfig, } from "../../lib/protocol.js";
+import { defineAdapter } from 'zhin.js/adapter';
+import {} from "../../lib/protocol.js";
 export { IcqqEndpoint } from "../../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
@@ -39,24 +34,5 @@ export default defineAdapter({
             },
         },
     },
-    create(context) {
-        const config = resolveIcqqConfig(context.config);
-        // 注册到插件运行时状态（icqq endpoint list 的"运行中"数据源）
-        context.use(icqqRuntimeStateToken).endpoints.set(config.id, {
-            id: config.id,
-            mode: 'direct',
-        });
-        const outbound = context.has?.(outboundHostToken) ? context.use(outboundHostToken) : undefined;
-        const endpoint = new IcqqEndpoint({
-            id: context.id,
-            loginAssist: context.use(loginAssistToken),
-            locale: context.use(projectLocaleToken),
-            config,
-            notifier: createAdapterOutageNotifier(outbound, config.notify),
-        });
-        if (context.has?.(icqqLoginControlToken)) {
-            context.use(icqqLoginControlToken).set(config.id, endpoint.loginControl);
-        }
-        return endpoint;
-    },
+    createAdapter: context => new IcqqAdapter(context),
 });

package/adapters/icqq/index.ts

@@ -1,27 +1,15 @@
-import { projectLocaleToken } from 'zhin.js/i18n';
+import { IcqqAdapter } from '../../src/adapter.js';
 /**
  * Convention entry: discover `adapters/icqq/index.ts` → defineAdapter.
  */
-import { createAdapterOutageNotifier, defineAdapter } from 'zhin.js/adapter';
-import { loginAssistToken } from '@zhin.js/core/runtime';
-import { outboundHostToken } from 'zhin.js';
-import { IcqqEndpoint } from '../../src/endpoint.js';
-import { icqqRuntimeStateToken } from '../../src/icqq-runtime-state.js';
-import { icqqLoginControlToken } from '../../src/icqq-login-control.js';
+import { defineAdapter } from 'zhin.js/adapter';
 import {
-  resolveIcqqConfig,
   type IcqqEndpointConfig,
 } from '../../src/protocol.js';
 
 export { IcqqEndpoint } from '../../src/endpoint.js';
 export type { IcqqEndpointOptions } from '../../src/endpoint.js';
 
-declare module '@zhin.js/core' {
-  interface AdapterEndpoints {
-    icqq: import('../../src/endpoint.js').IcqqEndpoint;
-  }
-}
-
 export default defineAdapter<IcqqEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: ['recall', 'reaction'],
@@ -50,24 +38,5 @@ export default defineAdapter<IcqqEndpointConfig>({
       },
     },
   },
-  create(context) {
-    const config = resolveIcqqConfig(context.config);
-    // 注册到插件运行时状态（icqq endpoint list 的"运行中"数据源）
-    context.use(icqqRuntimeStateToken).endpoints.set(config.id, {
-      id: config.id,
-      mode: 'direct',
-    });
-    const outbound = context.has?.(outboundHostToken) ? context.use(outboundHostToken) : undefined;
-    const endpoint = new IcqqEndpoint({
-      id: context.id,
-      loginAssist: context.use(loginAssistToken),
-      locale: context.use(projectLocaleToken),
-      config,
-      notifier: createAdapterOutageNotifier(outbound, config.notify),
-    });
-    if (context.has?.(icqqLoginControlToken)) {
-      context.use(icqqLoginControlToken).set(config.id, endpoint.loginControl);
-    }
-    return endpoint;
-  },
+  createAdapter: context => new IcqqAdapter(context),
 });

package/commands/icqq/endpoint/definition.js

@@ -1,33 +1,11 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../lib/i18n.js";
-import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
+import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { icqqRuntimeStateToken } from "../../../lib/icqq-runtime-state.js";
 export const icqqEndpointCommands = createEndpointCommands({
     adapterKey: 'icqq',
     adapterDisplayName: 'ICQQ',
-    running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
     describeEntry: (_entry, locale) => t(locale, 'direct'),
-    addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
-    addDescriptionI18n: { en: 'Register an ICQQ endpoint; restart zhin to apply' },
-    bindFlow: async ({ id, use, locale, formatCommand }) => {
-        if (!id) {
-            const command = formatCommand?.('icqq endpoint add');
-            return command ? t(locale, 'addUsage', { command }) : t(locale, 'uinRequired');
-        }
-        if (!/^\d+$/.test(id)) {
-            return t(locale, 'uinInvalid');
-        }
-        try {
-            const { filePath } = await use(endpointConfigurationStoreToken).add({
-                adapterKey: 'icqq',
-                entry: { id },
-                environment: {},
-            });
-            return t(locale, 'endpointAdded', { id, file: filePath });
-        }
-        catch (error) {
-            return t(locale, 'endpointAddFailed', { error: error instanceof Error ? error.message : String(error) });
-        }
-    },
+    addDescription: '保存 ICQQ 账号；保存后需手动启动',
+    addDescriptionI18n: { en: 'Save an ICQQ account; start it explicitly after saving' },
 }, defineCommand);

package/commands/icqq/endpoint/definition.ts

@@ -1,32 +1,11 @@
 import { messages as t } from '../../../src/i18n.js';
-import { createEndpointCommands, endpointConfigurationStoreToken } from 'zhin.js/adapter';
+import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { icqqRuntimeStateToken } from '../../../src/icqq-runtime-state.js';
 
 export const icqqEndpointCommands = createEndpointCommands({
   adapterKey: 'icqq',
   adapterDisplayName: 'ICQQ',
-  running: (use) => use(icqqRuntimeStateToken).endpoints.values(),
   describeEntry: (_entry, locale) => t(locale, 'direct'),
-  addDescription: '登记 ICQQ endpoint（重启 zhin 生效）',
-  addDescriptionI18n: { en: 'Register an ICQQ endpoint; restart zhin to apply' },
-  bindFlow: async ({ id, use, locale, formatCommand }) => {
-    if (!id) {
-      const command = formatCommand?.('icqq endpoint add');
-      return command ? t(locale, 'addUsage', { command }) : t(locale, 'uinRequired');
-    }
-    if (!/^\d+$/.test(id)) {
-      return t(locale, 'uinInvalid');
-    }
-    try {
-      const { filePath } = await use(endpointConfigurationStoreToken).add({
-        adapterKey: 'icqq',
-        entry: { id },
-        environment: {},
-      });
-      return t(locale, 'endpointAdded', { id, file: filePath });
-    } catch (error) {
-      return t(locale, 'endpointAddFailed', { error: error instanceof Error ? error.message : String(error) });
-    }
-  },
+  addDescription: '保存 ICQQ 账号；保存后需手动启动',
+  addDescriptionI18n: { en: 'Save an ICQQ account; start it explicitly after saving' },
 }, defineCommand);

package/commands/icqq/login/code/index.js

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { icqqLoginControlToken, icqqLoginForbidden, isIcqqLoginOperator, pendingTaskLabel, pickIcqqLoginControl, } from '../definition.js';
+import { icqqLoginControls, icqqLoginForbidden, isIcqqLoginOperator, pendingTaskLabel, pickIcqqLoginControl, } from '../definition.js';
 export default defineCommand({
     description: '提交 ICQQ 滑块/短信/设备验证内容',
     descriptionI18n: { en: 'Submit an ICQQ slider, SMS or device verification value' },
-    async execute({ args, config, input, use }) {
+    async execute({ args, config, input, project, owner }) {
         if (!isIcqqLoginOperator(config, input))
             return icqqLoginForbidden();
-        const controls = use(icqqLoginControlToken);
+        const controls = icqqLoginControls({ project, owner });
         // One endpoint: the whole argument is the code. Multiple: first arg selects the UIN.
         const requested = controls.size > 1 ? args[0] : undefined;
         const value = (controls.size > 1 ? args.slice(1) : args).join(' ').trim();

package/commands/icqq/login/code/index.ts

@@ -1,6 +1,6 @@
 import { defineCommand } from 'zhin.js/command';
 import {
-  icqqLoginControlToken,
+  icqqLoginControls,
   icqqLoginForbidden,
   isIcqqLoginOperator,
   pendingTaskLabel,
@@ -10,9 +10,9 @@ import {
 export default defineCommand({
   description: '提交 ICQQ 滑块/短信/设备验证内容',
   descriptionI18n: { en: 'Submit an ICQQ slider, SMS or device verification value' },
-  async execute({ args, config, input, use }) {
+  async execute({ args, config, input, project, owner }) {
     if (!isIcqqLoginOperator(config, input)) return icqqLoginForbidden();
-    const controls = use(icqqLoginControlToken);
+    const controls = icqqLoginControls({ project, owner });
     // One endpoint: the whole argument is the code. Multiple: first arg selects the UIN.
     const requested = controls.size > 1 ? args[0] : undefined;
     const value = (controls.size > 1 ? args.slice(1) : args).join(' ').trim();

package/commands/icqq/login/confirm/index.js

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { icqqLoginControlToken, icqqLoginForbidden, isIcqqLoginOperator, pickIcqqLoginControl, } from '../definition.js';
+import { icqqLoginControls, icqqLoginForbidden, isIcqqLoginOperator, pickIcqqLoginControl, } from '../definition.js';
 export default defineCommand({
     description: '确认已完成 ICQQ 扫码登录',
     descriptionI18n: { en: 'Confirm the ICQQ QR login was scanned' },
-    async execute({ args, config, input, use }) {
+    async execute({ args, config, input, project, owner }) {
         if (!isIcqqLoginOperator(config, input))
             return icqqLoginForbidden();
-        const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+        const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
         if (!picked.control)
             return picked.text ?? 'ICQQ 适配器还没有启动';
         const task = picked.control.pending().find((item) => item.type === 'qrcode' || item.type === 'auth');

package/commands/icqq/login/confirm/index.ts

@@ -1,6 +1,6 @@
 import { defineCommand } from 'zhin.js/command';
 import {
-  icqqLoginControlToken,
+  icqqLoginControls,
   icqqLoginForbidden,
   isIcqqLoginOperator,
   pickIcqqLoginControl,
@@ -9,9 +9,9 @@ import {
 export default defineCommand({
   description: '确认已完成 ICQQ 扫码登录',
   descriptionI18n: { en: 'Confirm the ICQQ QR login was scanned' },
-  async execute({ args, config, input, use }) {
+  async execute({ args, config, input, project, owner }) {
     if (!isIcqqLoginOperator(config, input)) return icqqLoginForbidden();
-    const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+    const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
     if (!picked.control) return picked.text ?? 'ICQQ 适配器还没有启动';
     const task = picked.control.pending().find((item) => item.type === 'qrcode' || item.type === 'auth');
     if (!task) return '当前没有等待确认的扫码登录；发送 `icqq login qr` 获取二维码。';

package/commands/icqq/login/definition.js

@@ -7,8 +7,8 @@
  * master can fetch the QR image and confirm/send verification codes without the
  * Console or terminal.
  */
-import { icqqLoginControlToken } from "../../../lib/icqq-login-control.js";
-export { icqqLoginControlToken };
+import { icqqLoginControls } from "../../../lib/icqq-login-control.js";
+export { icqqLoginControls };
 /** Master = framework master(s), or the configured outage-notify conversation id(s). */
 export function isIcqqLoginOperator(config, input) {
     const cfg = (config ?? {});

package/commands/icqq/login/definition.ts

@@ -6,9 +6,9 @@
  * master can fetch the QR image and confirm/send verification codes without the
  * Console or terminal.
  */
-import { icqqLoginControlToken, type IcqqLoginControl } from '../../../src/icqq-login-control.js';
+import { icqqLoginControls, type IcqqLoginControl } from '../../../src/icqq-login-control.js';
 
-export { icqqLoginControlToken };
+export { icqqLoginControls };
 
 /** Master = framework master(s), or the configured outage-notify conversation id(s). */
 export function isIcqqLoginOperator(config: unknown, input: unknown): boolean {

package/commands/icqq/login/qr/index.js

@@ -1,14 +1,14 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { icqqLoginControlToken, icqqLoginForbidden, isIcqqLoginOperator, pickIcqqLoginControl, } from '../definition.js';
+import { icqqLoginControls, icqqLoginForbidden, isIcqqLoginOperator, pickIcqqLoginControl, } from '../definition.js';
 const QR_IMAGE = /^data:image\/[a-z0-9.+-]+;base64,(.+)$/iu;
 export default defineCommand({
     description: '获取 ICQQ 登录二维码（发给当前会话）',
     descriptionI18n: { en: 'Fetch the ICQQ login QR code into this conversation' },
-    async execute({ args, config, input, use }) {
+    async execute({ args, config, input, project, owner }) {
         if (!isIcqqLoginOperator(config, input))
             return icqqLoginForbidden();
-        const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+        const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
         if (!picked.control)
             return picked.text ?? 'ICQQ 适配器还没有启动';
         const control = picked.control;

package/commands/icqq/login/qr/index.ts

@@ -1,6 +1,6 @@
 import { defineCommand } from 'zhin.js/command';
 import {
-  icqqLoginControlToken,
+  icqqLoginControls,
   icqqLoginForbidden,
   isIcqqLoginOperator,
   pickIcqqLoginControl,
@@ -11,9 +11,9 @@ const QR_IMAGE = /^data:image\/[a-z0-9.+-]+;base64,(.+)$/iu;
 export default defineCommand({
   description: '获取 ICQQ 登录二维码（发给当前会话）',
   descriptionI18n: { en: 'Fetch the ICQQ login QR code into this conversation' },
-  async execute({ args, config, input, use }) {
+  async execute({ args, config, input, project, owner }) {
     if (!isIcqqLoginOperator(config, input)) return icqqLoginForbidden();
-    const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+    const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
     if (!picked.control) return picked.text ?? 'ICQQ 适配器还没有启动';
     const control = picked.control;
     const findQr = () => control.pending().find((task) => task.type === 'qrcode' || task.type === 'auth');

package/commands/icqq/login/retry/index.js

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { icqqLoginControlToken, icqqLoginForbidden, isIcqqLoginOperator, pickIcqqLoginControl, } from '../definition.js';
+import { icqqLoginControls, icqqLoginForbidden, isIcqqLoginOperator, pickIcqqLoginControl, } from '../definition.js';
 export default defineCommand({
     description: '重新触发 ICQQ 登录',
     descriptionI18n: { en: 'Trigger an ICQQ login attempt again' },
-    async execute({ args, config, input, use }) {
+    async execute({ args, config, input, project, owner }) {
         if (!isIcqqLoginOperator(config, input))
             return icqqLoginForbidden();
-        const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+        const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
         if (!picked.control)
             return picked.text ?? 'ICQQ 适配器还没有启动';
         try {

package/commands/icqq/login/retry/index.ts

@@ -1,6 +1,6 @@
 import { defineCommand } from 'zhin.js/command';
 import {
-  icqqLoginControlToken,
+  icqqLoginControls,
   icqqLoginForbidden,
   isIcqqLoginOperator,
   pickIcqqLoginControl,
@@ -9,9 +9,9 @@ import {
 export default defineCommand({
   description: '重新触发 ICQQ 登录',
   descriptionI18n: { en: 'Trigger an ICQQ login attempt again' },
-  async execute({ args, config, input, use }) {
+  async execute({ args, config, input, project, owner }) {
     if (!isIcqqLoginOperator(config, input)) return icqqLoginForbidden();
-    const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+    const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
     if (!picked.control) return picked.text ?? 'ICQQ 适配器还没有启动';
     try {
       await picked.control.relogin();

package/commands/icqq/login/status/index.js

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { icqqLoginControlToken, icqqLoginForbidden, isIcqqLoginOperator, pendingTaskLabel, pickIcqqLoginControl, } from '../definition.js';
+import { icqqLoginControls, icqqLoginForbidden, isIcqqLoginOperator, pendingTaskLabel, pickIcqqLoginControl, } from '../definition.js';
 export default defineCommand({
     description: '查看 ICQQ 掉线状态与登录待办',
     descriptionI18n: { en: 'Show ICQQ offline status and pending login tasks' },
-    async execute({ args, config, input, use }) {
+    async execute({ args, config, input, project, owner }) {
         if (!isIcqqLoginOperator(config, input))
             return icqqLoginForbidden();
-        const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+        const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
         if (!picked.control)
             return picked.text ?? 'ICQQ 适配器还没有启动';
         const state = picked.control.state();

package/commands/icqq/login/status/index.ts

@@ -1,6 +1,6 @@
 import { defineCommand } from 'zhin.js/command';
 import {
-  icqqLoginControlToken,
+  icqqLoginControls,
   icqqLoginForbidden,
   isIcqqLoginOperator,
   pendingTaskLabel,
@@ -10,9 +10,9 @@ import {
 export default defineCommand({
   description: '查看 ICQQ 掉线状态与登录待办',
   descriptionI18n: { en: 'Show ICQQ offline status and pending login tasks' },
-  async execute({ args, config, input, use }) {
+  async execute({ args, config, input, project, owner }) {
     if (!isIcqqLoginOperator(config, input)) return icqqLoginForbidden();
-    const picked = pickIcqqLoginControl(use(icqqLoginControlToken), args[0]);
+    const picked = pickIcqqLoginControl(icqqLoginControls({ project, owner }), args[0]);
     if (!picked.control) return picked.text ?? 'ICQQ 适配器还没有启动';
     const state = picked.control.state();
     const lines = [

package/lib/adapter.d.ts

@@ -0,0 +1,13 @@
+import { Adapter, type AdapterContext, type EndpointCreationContext } from 'zhin.js/adapter';
+import { IcqqEndpoint } from './endpoint.js';
+import { type IcqqEndpointConfig } from './protocol.js';
+import type { IcqqClientEventMap } from './client.js';
+/** ICQQ account construction and actual SDK ownership belong to this Adapter. */
+export declare class IcqqAdapter extends Adapter<IcqqEndpoint, IcqqEndpointConfig, IcqqClientEventMap> {
+    #private;
+    get configurationIdentityFields(): readonly string[];
+    get configurationUpdateFields(): readonly string[];
+    constructor(context: AdapterContext<IcqqEndpointConfig>);
+    protected validateConfiguration(config: IcqqEndpointConfig): void;
+    protected createEndpoint(input: IcqqEndpointConfig, execution: EndpointCreationContext): IcqqEndpoint;
+}

package/lib/adapter.js

@@ -0,0 +1,27 @@
+import { Adapter, createAdapterOutageNotifier } from 'zhin.js/adapter';
+import { projectLocaleToken } from 'zhin.js/i18n';
+import { loginAssistToken } from '@zhin.js/core/runtime';
+import { outboundHostToken } from 'zhin.js';
+import { IcqqEndpoint } from './endpoint.js';
+import { resolveIcqqConfig } from './protocol.js';
+/** ICQQ account construction and actual SDK ownership belong to this Adapter. */
+export class IcqqAdapter extends Adapter {
+    get configurationIdentityFields() { return ['id']; }
+    get configurationUpdateFields() {
+        return ['password', 'platform', 'ver', 'dataDir', 'signApiAddr', 'autoReconnect', 'autoServer', 'qqnt', 'ntLogin'];
+    }
+    #context;
+    constructor(context) { super(); this.#context = context; }
+    validateConfiguration(config) { resolveIcqqConfig(config); }
+    createEndpoint(input, execution) {
+        const context = this.#context;
+        const config = resolveIcqqConfig(input);
+        const outbound = context.has?.(outboundHostToken) ? context.use(outboundHostToken) : undefined;
+        const endpoint = new IcqqEndpoint({ id: execution.canonicalId, config,
+            signal: execution.signal, endpointIdentity: { canonicalId: execution.canonicalId, instanceId: execution.instanceId, epoch: execution.epoch, incarnationId: execution.incarnationId },
+            loginAssist: context.use(loginAssistToken), locale: context.use(projectLocaleToken),
+            notifier: createAdapterOutageNotifier(outbound, config.notify),
+        });
+        return endpoint;
+    }
+}

package/lib/client.d.ts

@@ -1,19 +1,16 @@
-import type { Client, EventMap } from '@icqqjs/icqq';
+import type { IcqqAdapter } from './adapter.js';
+import type { IcqqEndpoint } from './endpoint.js';
+import type { EventMap } from '@icqqjs/icqq';
 type EventPayload<TListener> = TListener extends (event: infer TEvent, ...rest: readonly unknown[]) => unknown ? TEvent : never;
 /** The actual ICQQ SDK instance exposed by every ICQQ Endpoint event. */
-export type IcqqClient = Client;
+export type IcqqClient = IcqqEndpoint;
 /** Native ICQQ event-name → first public event payload, derived from the SDK SSOT. */
 export type IcqqClientEventMap = {
     readonly [TName in keyof EventMap]: EventPayload<EventMap[TName]>;
 };
 declare module '@zhin.js/feature-kit' {
-    interface AdapterClientRegistry {
-        readonly icqq: {
-            readonly client: IcqqClient;
-            readonly events: IcqqClientEventMap;
-        };
+    interface AdapterRegistry {
+        readonly icqq: IcqqAdapter;
     }
 }
-/** Typed, generation-checked identity used by handlers, commands, tools and schedules. */
-export declare const icqqClient: import("@zhin.js/adapter").EndpointClientToken<Client, IcqqClientEventMap>;
 export {};

package/lib/client.js

@@ -1,3 +1 @@
-import { defineEndpointClient } from 'zhin.js/adapter';
-/** Typed, generation-checked identity used by handlers, commands, tools and schedules. */
-export const icqqClient = defineEndpointClient('icqq');
+export {};

package/lib/console-spec.js

@@ -1,7 +1,17 @@
 export const icqqConsoleSpec = {
     adapterKey: 'icqq',
     adapterDisplayName: 'ICQQ',
-    fields: [],
+    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' },
+    ],
     docsUrl: 'https://zhin.js.org/adapters/icqq',
     readPermission: 'icqq:read',
     writePermission: 'icqq:write',

package/lib/console.d.ts

@@ -1,8 +1,2 @@
-/**
- * ICQQ Console RPC：运行状态 + endpoint 增删（原 `icqq endpoint` 聊天命令）。
- *
- * 页面绑定 `pages/index`，读取 / 写入分别要求 `<adapter>:read` / `<adapter>:write`。
- */
-import { type AdapterConsoleResources } from 'zhin.js/adapter';
 import type { PluginConsoleRpc } from 'zhin.js';
-export declare function createIcqqConsoleRpc(resources: AdapterConsoleResources, getConfig: () => unknown): PluginConsoleRpc;
+export declare function createIcqqConsoleRpc(getConfig: () => unknown): PluginConsoleRpc;