@zhin.js/adapter-icqq 1.1.29 → 1.1.30

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @zhin.js/adapter-icqq
 
+## 1.1.30
+
+### Patch Changes
+
+- e6d7cc1: 配置表单与插件显示名的多语言约定（#1250）：Schema 节点沿用已有的 `x-i18n`（`Schema#i18n()`），按 `zh-CN` / `en` 分别声明字段的 `title`、`description` 与 `enumLabels`；插件 `metadata`（`definePlugin` 或 `package.json#zhin.metadata`）新增可选的 `displayNameI18n: { 'zh-CN'?, en? }`，与 `displayName` 一样只能在一处声明，清单只接受这两个键且值必须是非空字符串。Console 插件列表（`/api/plugins`、插件详情）和 `feature.list` / `feature.matrix` 原样带出 `displayNameI18n`，由 Console 按界面语言选择（当前语言 → `en` → `displayName` → 实例 key）。没有这些字段时行为不变。
+
+  官方插件补齐中英文配置字段标题与说明（group-suite、repeater、roulette、answers、calendar、ledger、reminder、rss、earthquake、bilibili、content-moderation、lottery、nettools、60s、process-monitor、activity-feedback）以及全部官方插件的中英文显示名。
+
+- 7cd299e: ICQQ `system.*` 事件按语义分级记录（#1250）：上线（`system.online`）与等待人工处理的登录验证（二维码、设备锁、滑块、身份验证）记为 INFO，只有登录失败（`system.login.error`）与掉线（`system.offline*`）记为 WARN，正常登录不再进入「历史警告」。
+- 70ddaf4: 插件市场元数据（#1250 marketplace-metadata）：`package.json#zhin.metadata` 新增可选的 `descriptionI18n: { 'zh-CN'?, en? }`（本地化描述）与 `category`（`adapter`、`ai`、`admin`、`community`、`entertainment`、`game`、`information`、`moderation`、`service`、`utility` 之一），校验方式与 `displayNameI18n` 相同：只接受这两个语言键、值为非空字符串、分类必须在枚举内。这两个字段只能写在清单里，插件市场才能从发布的 `package.json` 读到。`@zhin.js/plugin-runtime` 导出 `PLUGIN_CATEGORIES`、`PLUGIN_CATEGORY_LABELS`、`informativeKeywords`、`packageAuthorName`、`readPluginMarketplaceMetadata` 等读取工具。
+
+  市场读取侧：`/pub/marketplace/search` 带出 `displayNameI18n` / `descriptionI18n`，分类读声明的 `category`（旧索引的 `util` 等按别名映射），可选 `locale=zh-CN|en` 按语言解析显示名与描述，并按两种语言的名称与描述搜索；`/pub/marketplace/detail/*` 带出发布清单的显示名、描述翻译与分类。作者一律取 `author`（没有时取 `maintainers`），不再显示发布账号——此前 `plugins.json` 生成脚本优先读 `_npmUser`，CI 可信发布的包因此都显示为「GitHub Actions」。keywords 去掉 `zhin`、`zhin.js`、`bot` 等通用词后展示与参与搜索。`zhin search` / `zhin info` 同样显示中文描述、分类和维护者，`zhin info` 不再读不存在的 `zhin.displayName` / `zhin.category`。
+
+  官方插件与适配器：显示名移到 `package.json#zhin.metadata`，补齐中英文描述、分类、3–6 个有信息量的 keywords，author 统一为 `{ name: "lc-cn", url: "https://github.com/zhinjs/zhin" }`（不再发布邮箱）；npm `description` 与英文描述一致。
+
+- Updated dependencies [7cd299e]
+- Updated dependencies [7cd299e]
+- Updated dependencies [9026329]
+- Updated dependencies [ccab2c1]
+- Updated dependencies [c6b5563]
+- Updated dependencies [f1a9745]
+- Updated dependencies [e0b4e51]
+- Updated dependencies [cca4427]
+- Updated dependencies [b08cff2]
+- Updated dependencies [704c7a4]
+- Updated dependencies [07bd3dc]
+  - @zhin.js/core@1.8.0
+  - @zhin.js/adapter@1.3.0
+  - @zhin.js/im-contract@1.2.0
+  - @zhin.js/console-contract@1.2.0
+  - @zhin.js/adapter-onebot-events@0.0.9
+  - @zhin.js/page@1.1.20
+  - @zhin.js/agent-feature@1.1.19
+  - @zhin.js/feature-kit@1.1.18
+  - @zhin.js/permission@1.2.2
+  - @zhin.js/skill@1.1.19
+  - @zhin.js/tool@1.1.21
+
 ## 1.1.29
 
 ### Patch Changes

package/lib/endpoint.d.ts

@@ -14,6 +14,12 @@ export interface IcqqEndpointOptions {
     /** Out-of-band outage notifier; absent in tests/hosts without outbound. */
     readonly notifier?: AdapterOutageNotifier;
 }
+/**
+ * Log level of an ICQQ `system.*` event by meaning: coming online and login challenges waiting for
+ * the person (QR code, device lock, slider, identity check) are normal progress (`info`); only
+ * failures (login errors, going offline) are `warn`, so a routine login stays out of the warnings.
+ */
+export declare function icqqSystemEventLogLevel(type: string): 'info' | 'warn';
 export declare class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
     #private;
     readonly [endpointSpec]: EndpointSpecification;

package/lib/endpoint.js

@@ -39,6 +39,14 @@ const BOUND_EVENTS = [
     'system.login.error',
     'system.login.auth',
 ];
+/**
+ * Log level of an ICQQ `system.*` event by meaning: coming online and login challenges waiting for
+ * the person (QR code, device lock, slider, identity check) are normal progress (`info`); only
+ * failures (login errors, going offline) are `warn`, so a routine login stays out of the warnings.
+ */
+export function icqqSystemEventLogLevel(type) {
+    return type === 'online' || type.startsWith('login.') && type !== 'login.error' ? 'info' : 'warn';
+}
 export class IcqqEndpoint extends ManagedIcqqClient {
     [endpointSpec];
     #logger;
@@ -969,7 +977,7 @@ export class IcqqEndpoint extends ManagedIcqqClient {
     #logSystemEvent(type, event, safe) {
         const payload = safe === undefined ? serializeIcqqEvent(event) : safe;
         const line = payload;
-        this.#logger.warn(formatCompact({
+        this.#logger[icqqSystemEventLogLevel(type)](formatCompact({
             op: `system.${type}`,
             endpoint: this.endpointName,
             ...(line ? { event: JSON.stringify(line) } : {}),

package/package.json

@@ -1,7 +1,17 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "1.1.29",
-  "description": "Zhin.js ICQQ adapter — direct connection to @icqqjs/icqq",
+  "version": "1.1.30",
+  "description": "ICQQ adapter: in-process @icqqjs/icqq client for QQ groups, private chats, temporary sessions and guild channels.",
+  "keywords": [
+    "zhin.js",
+    "icqq",
+    "qq",
+    "tencent"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "url": "https://github.com/zhinjs/zhin"
+  },
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -11,21 +21,6 @@
       "import": "./lib/index.js"
     }
   },
-  "keywords": [
-    "zhin",
-    "zhin.js",
-    "bot",
-    "adapter",
-    "icqq",
-    "qq",
-    "tencent",
-    "chatbot"
-  ],
-  "author": {
-    "name": "lc-cn",
-    "email": "admin@liucl.cn",
-    "url": "https://github.com/lc-cn"
-  },
   "license": "MIT",
   "repository": {
     "url": "git+https://github.com/zhinjs/zhin.git",
@@ -34,27 +29,27 @@
   },
   "dependencies": {
     "zod": "^4.6.7",
-    "@zhin.js/adapter": "1.1.34",
-    "@zhin.js/agent-feature": "1.1.18",
-    "@zhin.js/adapter-onebot-events": "0.0.8",
-    "@zhin.js/core": "1.7.0",
-    "@zhin.js/console-contract": "1.1.6",
-    "@zhin.js/im-contract": "1.1.14",
-    "@zhin.js/feature-kit": "1.1.17",
+    "@zhin.js/adapter": "1.3.0",
+    "@zhin.js/adapter-onebot-events": "0.0.9",
+    "@zhin.js/agent-feature": "1.1.19",
+    "@zhin.js/console-contract": "1.2.0",
+    "@zhin.js/core": "1.8.0",
+    "@zhin.js/feature-kit": "1.1.18",
+    "@zhin.js/im-contract": "1.2.0",
     "@zhin.js/logger": "1.1.3",
-    "@zhin.js/page": "1.1.19",
-    "@zhin.js/tool": "1.1.20",
-    "@zhin.js/skill": "1.1.18",
-    "@zhin.js/permission": "1.2.1"
+    "@zhin.js/page": "1.1.20",
+    "@zhin.js/permission": "1.2.2",
+    "@zhin.js/skill": "1.1.19",
+    "@zhin.js/tool": "1.1.21"
   },
   "peerDependencies": {
     "@icqqjs/icqq": "^1.12.2",
-    "@zhin.js/adapter": "^1.1.34",
-    "@zhin.js/agent": "^1.3.1",
-    "@zhin.js/command": "^1.2.2",
-    "@zhin.js/core": "^1.7.0",
-    "zhin.js": "^1.2.0",
-    "@zhin.js/prompt-section": "^1.1.17"
+    "@zhin.js/adapter": "^1.3.0",
+    "@zhin.js/agent": "^1.4.0",
+    "@zhin.js/command": "^1.3.0",
+    "@zhin.js/core": "^1.8.0",
+    "@zhin.js/prompt-section": "^1.1.18",
+    "zhin.js": "^1.3.0"
   },
   "peerDependenciesMeta": {
     "@icqqjs/icqq": {
@@ -78,9 +73,9 @@
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@zhin.js/prompt-section": "1.1.17",
-    "zhin.js": "1.2.0",
-    "@zhin.js/agent": "1.3.1"
+    "@zhin.js/agent": "1.4.0",
+    "@zhin.js/prompt-section": "1.1.18",
+    "zhin.js": "1.3.0"
   },
   "files": [
     "adapters",
@@ -140,7 +135,19 @@
         "optional": true
       }
     ],
-    "plugins": []
+    "plugins": [],
+    "metadata": {
+      "displayName": "ICQQ Adapter",
+      "displayNameI18n": {
+        "zh-CN": "ICQQ 适配器",
+        "en": "ICQQ Adapter"
+      },
+      "descriptionI18n": {
+        "zh-CN": "ICQQ 适配器：进程内直连 @icqqjs/icqq，支持 QQ 群聊、私聊、临时会话与频道消息。",
+        "en": "ICQQ adapter: in-process @icqqjs/icqq client for QQ groups, private chats, temporary sessions and guild channels."
+      },
+      "category": "adapter"
+    }
   },
   "scripts": {
     "build": "tsc",

package/plugin.js

@@ -6,9 +6,6 @@ import { icqqSensitiveExecRule } from "./lib/sensitive-commands.js";
 export default definePlugin({
     name: 'icqq',
     configUpdate: { featurePaths: [['nickname'], ['profile'], ['endpoints']] },
-    metadata: {
-        displayName: 'ICQQ Adapter',
-    },
     setup(context) {
         const disposeExecRule = registerSensitiveExecCommand(icqqSensitiveExecRule);
         return {

package/src/endpoint.ts

@@ -116,6 +116,15 @@ const BOUND_EVENTS = [
   'system.login.auth',
 ] as const;
 
+/**
+ * Log level of an ICQQ `system.*` event by meaning: coming online and login challenges waiting for
+ * the person (QR code, device lock, slider, identity check) are normal progress (`info`); only
+ * failures (login errors, going offline) are `warn`, so a routine login stays out of the warnings.
+ */
+export function icqqSystemEventLogLevel(type: string): 'info' | 'warn' {
+  return type === 'online' || type.startsWith('login.') && type !== 'login.error' ? 'info' : 'warn';
+}
+
 export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
   readonly [endpointSpec]: EndpointSpecification;
   readonly #logger: ReturnType<typeof getAdapterLogger>;
@@ -1032,7 +1041,7 @@ export class IcqqEndpoint extends ManagedIcqqClient implements Endpoint {
   #logSystemEvent(type: string, event: unknown, safe?: Record<string, unknown> | null): void {
     const payload = safe === undefined ? serializeIcqqEvent(event) : safe;
     const line = payload;
-    this.#logger.warn(formatCompact({
+    this.#logger[icqqSystemEventLogLevel(type)](formatCompact({
       op: `system.${type}`,
       endpoint: this.endpointName,
       ...(line ? { event: JSON.stringify(line) } : {}),