@zhin.js/adapter-icqq 2.0.25 → 3.0.0

package/src/adapter.ts

@@ -1,7 +1,7 @@
 /**
  * ICQQ 适配器 — 通过 @icqqjs/cli 守护进程 IPC 管理 Bot 实例
  */
-import { Adapter, Plugin } from "zhin.js";
+import { formatCompact, Adapter, Plugin } from 'zhin.js';
 import { IcqqBot } from "./bot.js";
 import type { IcqqBotConfig, IpcMemberInfo } from "./types.js";
 import { Actions } from "./protocol.js";
@@ -17,12 +17,11 @@ export class IcqqAdapter extends Adapter<IcqqBot> {
 
   async start(): Promise<void> {
     await super.start();
-    this.logger.info("ICQQ 适配器已启动");
   }
 
   async stop(): Promise<void> {
     await super.stop();
-    this.logger.info("ICQQ 适配器已停止");
+    this.logger.debug(formatCompact({ stop: true }));
   }
 
   // ── IGroupManagement 标准群管方法（通过 IPC） ─────────────────────

package/src/agent-prompt.ts

@@ -0,0 +1,115 @@
+import type {
+  AgentPromptBuildContext,
+  AgentPromptContributor,
+  AgentPromptSection,
+} from 'zhin.js';
+import type { AgentTool } from 'zhin.js';
+import { filterTools } from 'zhin.js';
+
+function isIcqqDelegatedTask(query: string, goal: string): boolean {
+  const text = `${query} ${goal}`;
+  const lower = text.toLowerCase();
+  if (/\bicqq\b|mcp_icqq|send_private_msg|friend\s+send/i.test(text)) return true;
+  if (/\bfriend\s+like\b/.test(lower) && /qq|好友|\d{5,}/i.test(text)) return true;
+  if (/点赞/.test(text) && /qq|好友|\d{5,}/i.test(text)) return true;
+  if (/发消息|发送消息|私聊/.test(text) && /qq|\d{5,}/i.test(text)) return true;
+  return false;
+}
+
+function selectIcqqDeferredTools(
+  query: string,
+  goal: string,
+  deferredCatalog: AgentTool[],
+  maxTools: number,
+): AgentTool[] {
+  const pool = deferredCatalog.filter(
+    t => !t.name.startsWith('mcp_filesystem') && !t.name.startsWith('mcp_memory_'),
+  );
+  const icqqMcpTools = pool.filter(t => t.name.startsWith('mcp_icqq_'));
+  const icqqTools = pool.filter(t => t.name.startsWith('icqq_'));
+  const pinned: AgentTool[] = [];
+  const bash = pool.find(t => t.name === 'bash');
+  if (bash) pinned.push(bash);
+  const preferOrder = [
+    'mcp_icqq_icqq_invoke',
+    'mcp_icqq_icqq_list_actions',
+    'icqq_send_user_like',
+    'icqq_friend_list',
+    'icqq_poke',
+  ];
+  for (const name of preferOrder) {
+    const t =
+      icqqMcpTools.find(x => x.name === name) ??
+      icqqTools.find(x => x.name === name);
+    if (t) pinned.push(t);
+  }
+  for (const t of [...icqqMcpTools, ...icqqTools]) {
+    if (pinned.length >= maxTools) break;
+    if (!pinned.some(p => p.name === t.name)) pinned.push(t);
+  }
+
+  const extra = filterTools(query, pool, { maxTools, minScore: 0.08 })
+    .filter(t => !pinned.some(p => p.name === t.name));
+
+  const merged: AgentTool[] = [...pinned];
+  for (const t of extra) {
+    if (merged.length >= maxTools) break;
+    merged.push(t);
+  }
+  return merged.slice(0, maxTools);
+}
+
+const ORCHESTRATOR_ICQQ = [
+  'On icqq/QQ: use run_deferred_task with tool_query "mcp_icqq_icqq_invoke" or "icqq_send_user_like".',
+  'Examples: send_private_msg, friend_like; do not use mcp_filesystem_* for QQ tasks.',
+  'Skip tool_search when the user clearly asks to send a message, like a friend, or poke on QQ.',
+].join('\n');
+
+const WORKER_ICQQ = [
+  'Send private message: `mcp_icqq_icqq_invoke` action `send_private_msg` params `{ user_id, message }`, or bash `icqq friend send <uid> "<text>"`.',
+  'Friend like: action `friend_like` or `icqq_send_user_like`, or bash `icqq friend like <uid> -t <times>`.',
+  'Use `icqq_list_actions` only if action name is unclear.',
+  'Do NOT use mcp_filesystem_* or explore node_modules / package.json to "discover" icqq.',
+  'Do not stop at --help; execute the action the goal describes.',
+].map(line => `- ${line}`).join('\n');
+
+export function createIcqqAgentPromptContributor(): AgentPromptContributor {
+  return {
+    platform: 'icqq',
+
+    async buildSections(ctx: AgentPromptBuildContext): Promise<AgentPromptSection[] | null> {
+      if (ctx.slot === 'orchestrator') {
+        if (!ctx.toolSearch) return null;
+        return [{
+          id: 'platform.icqq.orchestrator',
+          title: '## icqq / QQ',
+          body: ORCHESTRATOR_ICQQ,
+          priority: 50,
+        }];
+      }
+      if (ctx.slot === 'deferred_worker') {
+        const query = ctx.deferred?.toolQuery ?? ctx.deferred?.goal ?? '';
+        const goal = ctx.deferred?.goal ?? '';
+        if (!isIcqqDelegatedTask(query, goal)) return null;
+        return [{
+          id: 'platform.icqq.deferred_worker',
+          title: '## icqq / QQ（本任务）',
+          body: WORKER_ICQQ,
+          priority: 50,
+        }];
+      }
+      return null;
+    },
+
+    matchesDeferredTask(ctx: AgentPromptBuildContext): boolean {
+      const query = ctx.deferred?.toolQuery ?? ctx.deferred?.goal ?? ctx.userMessagePreview ?? '';
+      const goal = ctx.deferred?.goal ?? ctx.userMessagePreview ?? '';
+      return isIcqqDelegatedTask(query, goal);
+    },
+
+    selectDeferredTools(query, goal, catalog, maxTools) {
+      if (!isIcqqDelegatedTask(query, goal)) return null;
+      return selectIcqqDeferredTools(query, goal, catalog, maxTools);
+    },
+  };
+}

package/src/bot.ts

@@ -4,14 +4,7 @@
  * 不再直接依赖 @icqqjs/icqq 协议库。
  * 登录由 `icqq login` 完成，本 Bot 只负责连接守护进程并收发消息。
  */
-import {
-  Bot,
-  Message,
-  SendOptions,
-  MessageSegment,
-  SendContent,
-  segment,
-} from "zhin.js";
+import { formatCompact, Bot, Message, MessageSegment, segment, SendContent, SendOptions } from 'zhin.js';
 import type {
   IcqqBotConfig,
   IcqqSenderInfo,
@@ -64,20 +57,20 @@ export class IcqqBot implements Bot<IcqqBotConfig, IpcMessageEventData> {
     this.intentionalDisconnect = false;
     const rpc = this.$config.rpc;
 
-    if (rpc) {
-      this.logger.info(
-        `[${this.$id}] 正在通过 RPC 连接 icqq 守护进程 (${rpc.host}:${rpc.port})...`,
-      );
-    } else {
-      this.logger.info(`[${this.$id}] 正在连接 icqq 守护进程...`);
-    }
+    this.logger.debug(formatCompact( {
+      connecting: this.$id,
+      mode: rpc ? "rpc" : "ipc",
+      host: rpc?.host,
+      port: rpc?.port,
+    }));
 
     await this.rebindIpcSession();
 
-    this.logger.info(`[${this.$id}] 已连接守护进程${rpc ? " (RPC)" : ""}`);
-    this.logger.info(
-      `[${this.$id}] 登录成功，好友 ${this.friends.size}，群 ${this.groups.size}`,
-    );
+    this.logger.info(formatCompact( {
+      bot: this.$id,
+      friends: this.friends.size,
+      groups: this.groups.size,
+    }));
   }
 
   /** 建立或恢复与守护进程的 IPC/RPC 会话（订阅、缓存列表） */
@@ -147,23 +140,33 @@ export class IcqqBot implements Bot<IcqqBotConfig, IpcMessageEventData> {
         const delayMs = base + jitter;
 
         this.$connected = false;
-        this.logger.warn(
-          `[${this.$id}] 与 icqq 守护进程连接已断开，${delayMs}ms 后尝试重连（第 ${attempt + 1} 次）…`,
-        );
+        this.logger.warn(formatCompact( {
+          op: "disconnect",
+          bot: this.$id,
+          ok: false,
+          delay_ms: delayMs,
+          attempt: attempt + 1,
+        }));
 
         await new Promise<void>((r) => setTimeout(r, delayMs));
         if (this.intentionalDisconnect) break;
 
         try {
           await this.rebindIpcSession();
-          this.logger.info(
-            `[${this.$id}] 已重新连接守护进程，好友 ${this.friends.size}，群 ${this.groups.size}`,
-          );
+          this.logger.info(formatCompact( {
+            op: "reconnect",
+            bot: this.$id,
+            friends: this.friends.size,
+            groups: this.groups.size,
+          }));
           break;
         } catch (e: any) {
-          this.logger.warn(
-            `[${this.$id}] 重连失败: ${e?.message ?? String(e)}`,
-          );
+          this.logger.warn(formatCompact( {
+            op: "reconnect",
+            bot: this.$id,
+            ok: false,
+            error: e?.message ?? String(e),
+          }));
         }
       }
     } finally {
@@ -204,7 +207,7 @@ export class IcqqBot implements Bot<IcqqBotConfig, IpcMessageEventData> {
     this.subscriptions = [];
     this.ipc?.close();
     this.$connected = false;
-    this.logger.info(`[${this.$id}] 已断开连接`);
+    this.logger.info(formatCompact( { op: "disconnect", bot: this.$id }));
   }
 
   // ── 消息处理 ───────────────────────────────────────────────────────
@@ -245,9 +248,12 @@ export class IcqqBot implements Bot<IcqqBotConfig, IpcMessageEventData> {
       $timestamp: raw.time * 1000,
       $recall: async () => {
         // 合成 id 无法撤回
-        this.logger.warn(
-          `[${this.$id}] 收到的消息无法撤回（守护进程推送不含 message_id）`,
-        );
+        this.logger.warn(formatCompact( {
+          op: "recall",
+          bot: this.$id,
+          ok: false,
+          error: "no message_id in push",
+        }));
       },
       $reply: async (
         content: SendContent,
@@ -278,7 +284,12 @@ export class IcqqBot implements Bot<IcqqBotConfig, IpcMessageEventData> {
       message_id: id,
     });
     if (!resp.ok) {
-      this.logger.warn(`[${this.$id}] 撤回消息失败: ${resp.error}`);
+      this.logger.warn(formatCompact( {
+        op: "recall",
+        bot: this.$id,
+        ok: false,
+        error: resp.error,
+      }));
     }
   }
 

package/src/index.ts

@@ -2,7 +2,14 @@
  * ICQQ 适配器入口：类型扩展、导出、注册
  */
 import path from "path";
-import { usePlugin, type Plugin, type ToolFeature } from "zhin.js";
+import {
+  usePlugin,
+  type Plugin,
+  type ToolFeature,
+  registerAgentPromptContributor,
+  unregisterAgentPromptContributor,
+} from "zhin.js";
+import { createIcqqAgentPromptContributor } from "./agent-prompt.js";
 import type { Router } from "@zhin.js/http";
 import { PageManager } from "@zhin.js/console";
 import { IcqqAdapter } from "./adapter.js";
@@ -34,11 +41,13 @@ provide({
   name: "icqq",
   description: "ICQQ Adapter",
   mounted: async (p: Plugin) => {
+    registerAgentPromptContributor(createIcqqAgentPromptContributor());
     const adapter = new IcqqAdapter(p);
     await adapter.start();
     return adapter;
   },
   dispose: async (adapter: IcqqAdapter) => {
+    unregisterAgentPromptContributor("icqq");
     await adapter.stop();
   },
 } as any);

package/skills/icqq/SKILL.md

@@ -1,41 +0,0 @@
----
-name: icqq
-platforms:
-  - icqq
-description: '通过 icqq 命令行操作 QQ 账号。适用于：发私聊或群消息、撤回、查聊天记录；好友（列表、资料、备注、戳一戳、点赞、删好友、分组）；群（禁言、踢人、公告、签到、精华、成员、邀请、全体禁言）；好友/群验证与入群请求；群文件；昵称头像签名、在线状态；黑名单、OCR、Webhook、通知；登录与守护进程。用户提到 QQ、企鹅、好友、群聊、@、撤回、禁言、踢人、加群、好友请求、群文件、签到等时使用本技能。'
-argument-hint: '用一句话说明要对 QQ 执行的操作，例如「给好友 12345 发一条你好」或「把群 11111 里的用户 67890 禁言 10 分钟」'
-disable-model-invocation: true
----
-
-# icqq — 用命令行操作 QQ
-
-通过 **`icqq`** 命令行工具操作 QQ。需先 **`icqq login`** 启动守护进程后再执行其它命令。
-
-## 使用流程
-
-1. **判断模块** — 对照下方「模块表」，匹配用户意图属于哪一类
-2. **只读对应参考** — 仅打开与意图相关的 `references/*.md`，不要凭记忆猜命令
-3. **执行命令** — 在终端运行 `icqq …`，把结果回报给用户；未登录或守护未起时命令失败即如实说明
-
-## 模块表
-
-按用户想做的事，打开对应参考文件：
-
-| 用户意图 | 模块 | 参考文档 |
-|----------|------|----------|
-| 发消息、撤回、聊天记录、消息详情、合并转发 | 消息 | [messaging.md](./references/messaging.md) |
-| 好友列表、查看、发消息、戳一戳、点赞、删除、备注、文件、好友分组 | 好友 | [friends.md](./references/friends.md) |
-| 群：发消息、禁言、踢人、公告、邀请、签到、精华、成员、表态 | 群管理 | [groups.md](./references/groups.md) |
-| 昵称、头像、签名、群名片、群头衔、加群方式、匿名等设置 | 设置 | [settings.md](./references/settings.md) |
-| 好友请求、群请求、入群验证 | 请求 | [requests.md](./references/requests.md) |
-| 群文件：目录、上传下载、转发 | 群文件 | [gfs.md](./references/gfs.md) |
-| 登录、服务/守护、配置、OCR、黑名单、Webhook、通知、UID 转换、陌生人、漫游表情、缓存、重载、频道、RPC、补全 | 通用 | [general.md](./references/general.md) |
-
-## 全局约定
-
-- `<uid>` = QQ 号（数字），`<gid>` = 群号（数字）
-- 多账号：全局参数 `-u <uin>` 或环境变量 `ICQQ_CURRENT_UIN`；默认用配置里的 `currentUin`
-- **自动执行发消息** 优先用 **`icqq friend send` / `icqq group send`**（非交互）；`icqq friend chat` / `icqq group chat` 为交互式，不适合代理串行跑
-- CQ 码片段：`[face:id]` `[image:路径或URL]` `[at:uid]` `[at:all]` `[dice]` `[rps]`
-- 含空格的内容用英文双引号包起来：`icqq friend send 12345 "你好 世界"`
-- 批量操作用 `&&` 串联多条命令

package/skills/icqq/references/friends.md

@@ -1,54 +0,0 @@
-# Friends
-
-## List & View
-
-```
-icqq friend list              # List all friends
-icqq friend view <uid>        # View friend profile
-icqq friend avatar-url <uid>  # Get avatar URL
-```
-
-## Actions
-
-```
-icqq friend send <uid> <message>        # Send private message
-icqq friend poke <uid>                 # Poke a friend
-icqq friend like <uid> [-t times]      # Like (1-20 times, default 1)
-icqq friend delete <uid> [-b]          # Delete friend (-b: also block)
-icqq friend remark <uid> <remark>      # Set friend remark/alias
-icqq friend add <uid>                  # Add friend (optionally via group)
-```
-
-## Files
-
-```
-icqq friend send-file <uid> <file>      # Send file to friend
-icqq friend file-info <uid> <fid>      # Get file info
-icqq friend file-url <uid> <fid>       # Get file download URL
-icqq friend recall-file <uid> <fid>    # Recall a sent file
-```
-
-## Friend Classes (Groups)
-
-```
-icqq friend class list                 # List friend groups
-icqq friend class add <name>           # Create friend group
-icqq friend class delete <id>          # Delete friend group
-icqq friend class rename <id> <name>   # Rename friend group
-icqq friend class set <uid> <id>       # Move friend to group
-```
-
-## Examples
-
-```bash
-icqq friend list
-icqq friend view 12345
-icqq friend send 12345 "你好"
-icqq friend poke 12345
-icqq friend like 12345 -t 10
-icqq friend remark 12345 "小王"
-icqq friend delete 12345 -b
-icqq friend send-file 12345 ./doc.pdf
-icqq friend class list
-icqq friend class add "大学同学"
-```

package/skills/icqq/references/general.md

@@ -1,230 +0,0 @@
-# General
-
-## Account
-
-> Use **`icqq service status`** for service/daemon state, or **`icqq profile`** / **`icqq friend list`** to verify the daemon answers over IPC.
-
-```
-icqq login                     # Login QQ and start daemon (interactive wizard)
-icqq login -r                  # Quick reconnect using saved token
-icqq login -q <uid> -r         # Quick reconnect specific account
-icqq logout                    # Logout and stop daemon (token invalidated)
-icqq logout -k                 # Disconnect only, keep token (login -r still works)
-icqq logout <uin>              # Logout specific account
-icqq switch                    # Switch current account (interactive)
-icqq switch <uin>              # Switch to specific account
-icqq profile                   # View current account profile
-icqq requests                  # View pending friend/group requests
-```
-
-## System Service (auto-restart on crash, start on boot)
-
-```
-icqq service install           # Register daemon as system service (launchd/systemd)
-icqq service install -a        # Install service for all configured accounts
-icqq service uninstall         # Remove system service
-icqq service uninstall -a      # Uninstall all
-icqq service start             # Start installed service
-icqq service start -a          # Start all
-icqq service stop              # Stop service (keeps service file, no restart until start)
-icqq service stop -a           # Stop all
-icqq service status            # Show service install/running state
-icqq service status -a         # Show status for all accounts
-```
-
-Note: `icqq logout` does NOT prevent service auto-restart. To permanently stop, uninstall the service first.
-
-## Config
-
-```
-icqq config get                # View all config
-icqq config get <key>          # View specific config key (currentUin, webhookUrl, notifyEnabled)
-icqq config set <key> <value>  # Set config value
-```
-
-## Multi-Instance
-
-Use `-u <uin>` global flag or `ICQQ_CURRENT_UIN` env to target a specific account.
-Default falls back to `config.currentUin`.
-
-```
-icqq -u 12345 profile          # View profile for account 12345
-ICQQ_CURRENT_UIN=12345 icqq friend list
-```
-
-## Blacklist
-
-```
-icqq blacklist                 # View blacklist
-```
-
-## OCR
-
-```
-icqq ocr <image>               # OCR image text recognition (local file path)
-```
-
-## Webhook
-
-```
-icqq webhook                   # View current webhook config
-icqq webhook set <url>         # Set webhook URL (daemon pushes events via POST)
-icqq webhook off               # Disable webhook
-```
-
-## Notification
-
-```
-icqq notify                    # View notification status
-icqq notify on                 # Enable system notifications
-icqq notify off                # Disable system notifications
-```
-
-## Conversion
-
-```
-icqq convert uid <qq>          # QQ number to UID
-icqq convert uin <uid>         # UID to QQ number
-```
-
-## Keys & URLs
-
-```
-icqq get client-key            # Get ClientKey
-icqq get pskey                 # Get PSKey
-icqq get video-url <vid>       # Get video download URL
-```
-
-## Stranger
-
-```
-icqq stranger view <uid>           # View stranger profile
-icqq stranger status <uid>         # Check online status
-icqq stranger add-setting <uid>    # Check add-friend settings
-```
-
-## Roaming Emoji (Stamps)
-
-```
-icqq stamp list                # List roaming emojis
-icqq stamp delete              # Delete roaming emoji
-```
-
-## Cache & Reload
-
-```
-icqq cache clean               # Clear cache
-icqq reload friends            # Refresh friend list
-icqq reload groups             # Refresh group list
-icqq reload blacklist          # Reload blacklist
-icqq reload guilds             # Reload guild list
-icqq reload strangers          # Reload stranger list
-```
-
-## Guild (Server & Channel)
-
-```
-icqq guild list                                                # List guilds
-icqq guild info <guild_id>                                     # View guild info
-icqq guild members <guild_id>                                  # List guild members
-icqq guild channel list <guild_id>                             # List subchannels
-icqq guild channel send <guild_id> <channel_id> <message>      # Send channel message
-icqq guild channel chat <guild_id> <channel_id>                # Interactive channel chat
-icqq guild channel recall <guild_id> <channel_id> <seq>        # Recall channel message
-icqq guild channel share <guild_id> <channel_id> <url> <title> # Share post link
-icqq guild channel forum-url <guild_id> <channel_id> <forum_id> # Get forum URL
-```
-
-## Shell Completion
-
-```
-icqq completion [shell]        # Generate shell completion script (bash/zsh/fish)
-```
-
-## RPC (TCP Remote Connection)
-
-The daemon supports optional TCP remote access for cross-machine QQ account control.
-
-### Configuration
-
-In `~/.icqq/config.json`:
-
-```json
-{
-  "rpc": {
-    "enabled": true,
-    "host": "127.0.0.1",
-    "port": 0
-  }
-}
-```
-
-Or via CLI:
-
-```
-icqq config set rpc.enabled true    # Enable RPC TCP listener
-icqq config set rpc.host 0.0.0.0   # Listen on all interfaces (for remote access)
-icqq config set rpc.port 9100      # Set listen port (0 = auto-assign)
-```
-
-| Field | Description | Default |
-|-------|-------------|---------|
-| `enabled` | Enable RPC TCP listener | `false` |
-| `host` | Listen address, `"0.0.0.0"` for remote | `"127.0.0.1"` |
-| `port` | Listen port, `0` = auto-assign | `0` |
-
-### Security
-
-- **HMAC-SHA256 challenge-response auth** — token never transmitted over network
-- **IP rate limiting** — 5 failures in 5 minutes → auto-block
-- **Default localhost only** — must explicitly set `host: "0.0.0.0"` for remote access
-- **4KB unauthenticated buffer limit** — prevents memory exhaustion
-
-### Programmatic Access
-
-```typescript
-import { IpcClient } from "@icqqjs/cli/lib/ipc-client";
-
-// Option 1: Specify host/port/token directly
-const client = await IpcClient.connectRpc({
-  host: "192.168.1.100",
-  port: 9100,
-  token: "your-token-here",
-});
-
-// Option 2: Auto-read from daemon.rpc file (local only)
-const client = await IpcClient.connectRpcByUin(12345);
-
-const resp = await client.request("list_friends");
-client.close();
-```
-
-### Auth Flow
-
-1. Client connects to TCP port
-2. Server sends `{ "challenge": "<random-hex>" }`
-3. Client computes `HMAC-SHA256(token, challenge)` → digest
-4. Client sends `{ "action": "auth", "params": { "digest": "<hex>" } }`
-5. Server verifies → authenticated
-
-## Examples
-
-```bash
-icqq service status
-icqq profile
-icqq requests
-icqq login -r
-icqq config get
-icqq config set currentUin 12345
-icqq switch 12345
-icqq -u 12345 profile
-icqq ocr ./screenshot.png
-icqq webhook set https://example.com/hook
-icqq notify on
-icqq convert uid 12345
-icqq stranger view 12345
-icqq stamp list
-icqq cache clean
-icqq reload friends
-icqq guild list
-```

package/skills/icqq/references/gfs.md

@@ -1,49 +0,0 @@
-# Group File System (GFS)
-
-## List Files
-
-```
-icqq group fs list <gid>                # List root directory
-icqq group fs list <gid> -p <pid>      # List subdirectory by parent ID
-```
-
-## Info & Stats
-
-```
-icqq group fs info <gid>               # View GFS usage stats (space, file count)
-icqq group fs stat <gid> <fid>         # View file/directory details
-```
-
-## Manage
-
-```
-icqq group fs mkdir <gid> <name>              # Create directory
-icqq group fs delete <gid> <fid>              # Delete file/directory by ID
-icqq group fs rename <gid> <fid> <name>       # Rename file/directory
-icqq group fs move <gid> <fid> <pid>          # Move file to directory
-```
-
-## Upload & Download
-
-```
-icqq group fs upload <gid> <file>              # Upload file to group
-icqq group fs download <gid> <fid>            # Get download URL
-icqq group fs forward <gid> <fid> <target_gid> # Forward file to another group
-icqq group fs forward-offline <gid> <fid>      # Convert to offline file
-```
-
-The `<fid>` (file ID) is shown in `icqq group fs list` output.
-
-## Examples
-
-```bash
-icqq group fs list 67890
-icqq group fs info 67890
-icqq group fs stat 67890 abc123
-icqq group fs mkdir 67890 "会议资料"
-icqq group fs upload 67890 ./report.pdf
-icqq group fs download 67890 abc123
-icqq group fs rename 67890 abc123 "新文件名"
-icqq group fs move 67890 abc123 def456
-icqq group fs delete 67890 abc123
-```