@zhin.js/adapter-icqq 2.0.23 → 2.0.25

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @zhin.js/adapter-icqq
 
+## 2.0.25
+
+### Patch Changes
+
+- 3b3e49b: fix: ask 工具修复,icqq skill 优化
+  - zhin.js@1.0.80
+  - @zhin.js/console@2.0.23
+  - @zhin.js/http@1.0.73
+  - @zhin.js/core@1.1.22
+
+## 2.0.24
+
+### Patch Changes
+
+- dc04e4a: fix: skill 优化
+
 ## 2.0.23
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "2.0.23",
+  "version": "2.0.25",
   "description": "Zhin.js adapter for ICQQ (QQ Bot)",
   "type": "module",
   "main": "./lib/index.js",
@@ -51,16 +51,16 @@
     "lucide-react": "^1.14.0",
     "radix-ui": "^1.4.3",
     "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.75",
-    "@zhin.js/console": "2.0.22",
-    "zhin.js": "1.0.79"
+    "@zhin.js/cli": "1.0.76",
+    "@zhin.js/console": "2.0.23",
+    "zhin.js": "1.0.80"
   },
   "peerDependencies": {
     "@zhin.js/client": "1.0.18",
-    "@zhin.js/console": "2.0.22",
-    "@zhin.js/core": "1.1.21",
-    "@zhin.js/http": "1.0.72",
-    "zhin.js": "1.0.79"
+    "@zhin.js/console": "2.0.23",
+    "@zhin.js/core": "1.1.22",
+    "@zhin.js/http": "1.0.73",
+    "zhin.js": "1.0.80"
   },
   "peerDependenciesMeta": {
     "@zhin.js/client": {

package/skills/icqq/SKILL.md

@@ -2,43 +2,40 @@
 name: icqq
 platforms:
   - icqq
-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"'
+description: '通过 icqq 命令行操作 QQ 账号。适用于：发私聊或群消息、撤回、查聊天记录；好友（列表、资料、备注、戳一戳、点赞、删好友、分组）；群（禁言、踢人、公告、签到、精华、成员、邀请、全体禁言）；好友/群验证与入群请求；群文件；昵称头像签名、在线状态；黑名单、OCR、Webhook、通知；登录与守护进程。用户提到 QQ、企鹅、好友、群聊、@、撤回、禁言、踢人、加群、好友请求、群文件、签到等时使用本技能。'
+argument-hint: '用一句话说明要对 QQ 执行的操作，例如「给好友 12345 发一条你好」或「把群 11111 里的用户 67890 禁言 10 分钟」'
 disable-model-invocation: true
 ---
 
-# icqq — QQ Account Operations via CLI
+# icqq — 用命令行操作 QQ
 
-Operate a QQ account through the `icqq` command-line tool. The daemon must be running first (`icqq login`).
+通过 **`icqq`** 命令行工具操作 QQ。需先 **`icqq login`** 启动守护进程后再执行其它命令。
 
-## 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
+1. **判断模块** — 对照下方「模块表」，匹配用户意图属于哪一类
+2. **只读对应参考** — 仅打开与意图相关的 `references/*.md`，不要凭记忆猜命令
+3. **执行命令** — 在终端运行 `icqq …`，把结果回报给用户；未登录或守护未起时命令失败即如实说明
 
-## Modules
+## 模块表
 
-Load the corresponding reference file based on what the user wants:
+按用户想做的事，打开对应参考文件：
 
-| 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) |
+| 用户意图 | 模块 | 参考文档 |
+|----------|------|----------|
+| 发消息、撤回、聊天记录、消息详情、合并转发 | 消息 | [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) |
 
-## 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 `&&`
-- **Agent / bash**：`icqq …` 多由 `bash` 执行；`execSecurity: allowlist` 下非敏感子命令通常直接放行，敏感操作与 Owner `approve rule` / `approve always bash` 等见框架文档 [docs/advanced/ai.md](../../../../../docs/advanced/ai.md)（`#icqq-bash-exec`、`#owner-approve-commands`）。
+- `<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

@@ -12,20 +12,20 @@ icqq friend avatar-url <uid>  # Get avatar URL
 
 ```
 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)
+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
+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)

package/skills/icqq/references/general.md

@@ -2,19 +2,38 @@
 
 ## 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 status                    # Check all daemon/account statuses
-icqq stop                      # Stop the daemon
-icqq stop <uin>                # Stop specific daemon
+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
 
 ```
@@ -79,9 +98,9 @@ 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
+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)
@@ -122,10 +141,76 @@ icqq guild channel forum-url <guild_id> <channel_id> <forum_id> # Get forum URL
 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 status
+icqq service status
 icqq profile
 icqq requests
 icqq login -r

package/skills/icqq/references/gfs.md

@@ -3,7 +3,7 @@
 ## List Files
 
 ```
-icqq group fs list <gid>               # List root directory
+icqq group fs list <gid>                # List root directory
 icqq group fs list <gid> -p <pid>      # List subdirectory by parent ID
 ```
 
@@ -27,7 +27,7 @@ icqq group fs move <gid> <fid> <pid>          # Move file to directory
 
 ```
 icqq group fs upload <gid> <file>              # Upload file to group
-icqq group fs download <gid> <fid>             # Get download URL
+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
 ```

package/skills/icqq/references/groups.md

@@ -35,9 +35,9 @@ icqq group screen-member <gid> <uid>  # Block/unblock member messages
 
 ```
 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
+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

package/skills/icqq/references/messaging.md

@@ -22,7 +22,7 @@ Messages support inline CQ codes for rich content:
 [rps]                   # Rock-paper-scissors
 ```
 
-Mixed example: `icqq group send 67890 "你好[face:178]看看[image:/tmp/pic.jpg]"`
+Mixed example: `icqq send group 67890 "你好[face:178]看看[image:/tmp/pic.jpg]"`
 
 ## Recall
 
@@ -52,8 +52,6 @@ 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