@zhin.js/adapter-icqq 2.0.5 → 2.0.7

package/skills/icqq/SKILL.md

@@ -1,74 +1,41 @@
 ---
 name: icqq
-platforms:
-  - icqq
-description: ICQQ（QQ 协议）群管理：踢人、禁言、全员禁言、设管理员、改名片、头衔、群公告、戳一戳、点赞、群文件等。仅有昵称时请先 list_members 查 QQ 号。
-keywords:
-  - ICQQ
-  - QQ
-  - adapter:icqq
-  - 群管理
-  - 踢人
-  - 禁言
-  - 管理员
-  - 头衔
-  - 群公告
-  - 戳一戳
-  - list_members
-tags:
-  - group
-  - management
-  - im
-tools:
-  # 平台特有工具
-  - icqq_set_title
-  - icqq_announce
-  - icqq_poke
-  - icqq_list_muted
-  - icqq_send_user_like
-  - icqq_set_anonymous
-  - icqq_group_files
-  - icqq_friend_list
-  # 通用群管工具
-  - icqq_kick_member
-  - icqq_mute_member
-  - icqq_mute_all
-  - icqq_set_admin
-  - icqq_set_nickname
-  - icqq_set_group_name
-  - icqq_list_members
+description: 'Operate QQ account via icqq CLI. Use when asked to: send QQ message, manage QQ groups, check QQ friends, poke friend, like friend, mute member, kick member, set nickname, view QQ profile, handle friend/group requests, manage group files, set group announcement, QQ签到, 发消息, 管群, 好友操作, 群文件.'
+argument-hint: 'Describe what QQ operation to perform, e.g. "send hello to friend 12345" or "mute user 67890 in group 11111"'
+disable-model-invocation: true
 ---
 
-## 工具概览
+# icqq — QQ Account Operations via CLI
 
-### 平台特有
+Operate a QQ account through the `icqq` command-line tool. The daemon must be running first (`icqq login`).
 
-| 工具 | 说明 | 权限 |
-|------|------|------|
-| `icqq_set_title` | 设置群头衔 | group_admin |
-| `icqq_announce` | 发送群公告 | group_admin |
-| `icqq_poke` | 戳一戳互动 | user |
-| `icqq_list_muted` | 查询禁言列表 | user |
-| `icqq_send_user_like` | 给用户点赞 | user |
-| `icqq_set_anonymous` | 开启/关闭匿名聊天 | group_admin |
-| `icqq_group_files` | 获取群文件列表 | user |
-| `icqq_friend_list` | 获取好友列表 | user |
+## Procedure
 
-### 通用群管
+1. **Identify the module** — Match the user's intent to one of the modules below
+2. **Load the reference** — Read ONLY the relevant module reference file(s)
+3. **Check daemon** — Run `icqq status` if unsure whether the account is online
+4. **Execute** — Run the command in terminal and report results
 
-| 工具 | 说明 | 权限 |
-|------|------|------|
-| `icqq_kick_member` | 踢出成员 | group_admin |
-| `icqq_mute_member` | 禁言成员（duration=0 解除） | group_admin |
-| `icqq_mute_all` | 全员禁言/解除 | group_admin |
-| `icqq_set_admin` | 设置/取消管理员 | group_owner |
-| `icqq_set_nickname` | 修改群昵称/名片 | group_admin |
-| `icqq_set_group_name` | 修改群名称 | group_admin |
-| `icqq_list_members` | 获取群成员列表 | user |
+## Modules
 
-## 执行规则
+Load the corresponding reference file based on what the user wants:
 
-1. 仅有成员昵称时先 `icqq_list_members` 获取 QQ 号
-2. 禁言 duration 单位为秒，默认 600（10 分钟），设为 0 解除禁言
-3. 头衔设置需要群主权限
-4. 群公告仅管理员可发布
+| Intent | Module | Reference |
+|--------|--------|-----------|
+| 发消息、撤回、聊天记录、消息详情、合并转发 | Messaging | [messaging.md](./references/messaging.md) |
+| 好友列表、查看、发消息、戳一戳、点赞、删除、备注、文件、好友分组 | Friends | [friends.md](./references/friends.md) |
+| 群管理：发消息、禁言、踢人、公告、邀请、签到、精华、成员、表态 | Groups | [groups.md](./references/groups.md) |
+| 设置：昵称、头像、签名、群名片、群头衔、加群方式、匿名 | Settings | [settings.md](./references/settings.md) |
+| 好友/群请求处理 | Requests | [requests.md](./references/requests.md) |
+| 群文件：目录管理、上传下载、转发 | Group Files | [gfs.md](./references/gfs.md) |
+| 登录、状态、配置、OCR、黑名单、Webhook、通知、UID转换、陌生人、漫游表情、缓存、重载、频道与子频道（Guild & Channel）、补全 | General | [general.md](./references/general.md) |
+
+## Global Notes
+
+- All `<uid>` = QQ number (integer), `<gid>` = group number (integer)
+- Daemon must run first: `icqq login`
+- Multi-instance: use `-u <uin>` or `ICQQ_CURRENT_UIN` env to specify account; defaults to `config.currentUin`
+- **Use `icqq friend send` / `icqq group send` for non-interactive messaging** (agent-friendly); `icqq friend chat` / `icqq group chat` are interactive
+- CQ code syntax in messages: `[face:id]` `[image:path]` `[at:uid]` `[at:all]` `[dice]` `[rps]`
+- Quote strings with spaces: `icqq friend send 12345 "hello world"`
+- Chain batch ops with `&&`

package/skills/icqq/references/friends.md

@@ -0,0 +1,54 @@
+# 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

@@ -0,0 +1,145 @@
+# General
+
+## Account
+
+```
+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 status                    # Check all daemon/account statuses
+icqq stop                      # Stop the daemon
+icqq stop <uin>                # Stop specific daemon
+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
+```
+
+## 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)
+```
+
+## Examples
+
+```bash
+icqq 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

@@ -0,0 +1,49 @@
+# 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
+```

package/skills/icqq/references/groups.md

@@ -0,0 +1,71 @@
+# Groups
+
+## List & View
+
+```
+icqq group list                        # List all groups
+icqq group view <gid>                  # View group info
+icqq group member list <gid>           # List group members
+icqq group member view <gid> <uid>     # View member info
+icqq group avatar-url <gid>            # Get group avatar URL
+icqq group share <gid>                 # Get group share link
+icqq group anon-info <gid>             # View anonymous info
+icqq group at-all-remain <gid>         # Check @all remaining count
+icqq group muted-list <gid>            # View muted members list
+```
+
+## Mute
+
+```
+icqq group mute <gid> <uid> [-d seconds]   # Mute member (default 600s, -d 0 to unmute)
+icqq group mute-all <gid>                  # Mute all
+icqq group mute-all <gid> --off            # Unmute all
+icqq group mute-anon <gid> <flag>          # Mute anonymous member
+```
+
+## Kick & Quit
+
+```
+icqq group kick <gid> <uid> [-b]      # Kick member (-b: block rejoin)
+icqq group quit <gid>                 # Quit group
+icqq group screen-member <gid> <uid>  # Block/unblock member messages
+```
+
+## Social
+
+```
+icqq group send <gid> <message>         # Send group message
+icqq group poke <gid> <uid>             # Poke group member
+icqq group invite <gid> <uid>           # Invite friend to group
+icqq group sign <gid>                   # Group check-in
+```
+
+## Reactions
+
+```
+icqq group reaction add <msgid> <emoji>     # React to message
+icqq group reaction remove <msgid> <emoji>  # Remove reaction
+```
+
+## Announcement & Essence
+
+```
+icqq group announce <gid> <content>        # Post announcement
+icqq group essence add <message_id>        # Set essence message
+icqq group essence remove <message_id>     # Remove essence message
+```
+
+## Examples
+
+```bash
+icqq group list
+icqq group view 67890
+icqq group send 67890 "大家好"
+icqq group member list 67890
+icqq group member view 67890 12345
+icqq group mute 67890 12345 -d 3600
+icqq group kick 67890 12345 -b
+icqq group announce 67890 "今晚8点开会"
+icqq group sign 67890
+icqq group reaction add abc123 👍
+```

package/skills/icqq/references/messaging.md

@@ -0,0 +1,66 @@
+# Messaging
+
+## Send Message (non-interactive)
+
+```
+icqq friend send <uid> <message>    # Send private message
+icqq group send <gid> <message>     # Send group message
+```
+
+**IMPORTANT**: Always use `icqq friend send` / `icqq group send` for agent operations (non-interactive). The `icqq friend chat` / `icqq group chat` commands enter interactive mode that the agent cannot operate.
+
+## CQ Code Syntax
+
+Messages support inline CQ codes for rich content:
+
+```
+[face:178]              # QQ face emoji (id 0~348)
+[image:/path/to/pic.jpg]  # Image (local path or URL)
+[at:12345]              # @ a user
+[at:all]                # @ everyone
+[dice]                  # Dice
+[rps]                   # Rock-paper-scissors
+```
+
+Mixed example: `icqq group send 67890 "你好[face:178]看看[image:/tmp/pic.jpg]"`
+
+## Recall
+
+```
+icqq recall <message_id>
+```
+
+## Message Operations
+
+```
+icqq msg get <message_id>              # View message details
+icqq msg mark-read <message_id>        # Mark message as read
+icqq forward get <message_id>          # View forwarded message content
+```
+
+## Chat History
+
+```
+icqq friend chat history <uid> [-c count]   # Private chat history (default 20)
+icqq group chat history <gid> [-c count]    # Group chat history (default 20)
+```
+
+## Interactive Chat (human only)
+
+```
+icqq friend chat <uid>     # Enter private chat mode
+icqq group chat <gid>      # Enter group chat mode
+```
+
+> **Do NOT use interactive chat commands for agent operations.** Use `icqq friend send` / `icqq group send` instead.
+
+## Examples
+
+```bash
+icqq friend send 12345 "你好"
+icqq group send 67890 "大家好[face:21]"
+icqq friend send 12345 "[image:https://example.com/pic.jpg]看这个"
+icqq friend chat history 12345 -c 50
+icqq group chat history 67890
+icqq recall abc123
+```

package/skills/icqq/references/requests.md

@@ -0,0 +1,27 @@
+# Friend & Group Requests
+
+## View Pending Requests
+
+```
+icqq requests                  # Show all pending friend/group requests with flags
+```
+
+## Handle Requests
+
+```
+icqq request accept <flag>            # Accept friend request
+icqq request accept <flag> -g         # Accept group request
+icqq request reject <flag>            # Reject friend request
+icqq request reject <flag> -g         # Reject group request
+icqq request reject <flag> -g -r "理由"  # Reject with reason
+```
+
+The `<flag>` value is shown in `icqq requests` output.
+
+## Examples
+
+```bash
+icqq requests
+icqq request accept abc123
+icqq request reject def456 -g -r "群已满"
+```

package/skills/icqq/references/settings.md

@@ -0,0 +1,38 @@
+# Settings
+
+## Personal Settings
+
+```
+icqq set nickname <name>            # Set nickname
+icqq set gender <0|1|2>             # 0=unknown, 1=male, 2=female
+icqq set birthday <YYYYMMDD>        # Set birthday
+icqq set signature <text>           # Set signature
+icqq set description <text>         # Set description
+icqq set avatar <file>              # Set avatar (image file path)
+icqq set online-status <code>       # 11=online, 31=away, 41=invisible, 50=busy, 60=Q-me, 70=DND
+```
+
+## Group Settings
+
+```
+icqq group set name <gid> <name>              # Set group name
+icqq group set avatar <gid> <file>            # Set group avatar
+icqq group set card <gid> <uid> <card>        # Set member card/nickname
+icqq group set title <gid> <uid> <title>      # Set member special title
+icqq group set admin <gid> <uid>              # Set admin
+icqq group set admin <gid> <uid> -r           # Remove admin
+icqq group set remark <gid> <remark>          # Set group remark
+icqq group set anonymous <gid>                # Toggle anonymous
+icqq group set join-type <gid> <type>         # Set join method
+icqq group set rate-limit <gid> <limit>       # Set message rate limit
+```
+
+## Examples
+
+```bash
+icqq set nickname "新昵称"
+icqq set signature "今天天气不错"
+icqq set online-status 50
+icqq group set name 67890 "新群名"
+icqq group set card 67890 12345 "管理员小王"
+```