@zhin.js/adapter-icqq 2.0.22 → 2.0.24

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @zhin.js/adapter-icqq
 
+## 2.0.24
+
+### Patch Changes
+
+- dc04e4a: fix: skill 优化
+
+## 2.0.23
+
+### Patch Changes
+
+- 92da96d: fix skill 激活优化
+  - zhin.js@1.0.79
+  - @zhin.js/console@2.0.22
+  - @zhin.js/http@1.0.72
+  - @zhin.js/core@1.1.21
+
 ## 2.0.22
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-icqq",
-  "version": "2.0.22",
+  "version": "2.0.24",
   "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.74",
-    "@zhin.js/console": "2.0.21",
-    "zhin.js": "1.0.78"
+    "@zhin.js/cli": "1.0.75",
+    "@zhin.js/console": "2.0.22",
+    "zhin.js": "1.0.79"
   },
   "peerDependencies": {
     "@zhin.js/client": "1.0.18",
-    "@zhin.js/console": "2.0.21",
-    "@zhin.js/core": "1.1.20",
-    "@zhin.js/http": "1.0.71",
-    "zhin.js": "1.0.78"
+    "@zhin.js/console": "2.0.22",
+    "@zhin.js/core": "1.1.21",
+    "zhin.js": "1.0.79",
+    "@zhin.js/http": "1.0.72"
   },
   "peerDependenciesMeta": {
     "@zhin.js/client": {

package/skills/icqq/SKILL.md

@@ -1,5 +1,7 @@
 ---
 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"'
 disable-model-invocation: true
@@ -13,7 +15,7 @@ Operate a QQ account through the `icqq` command-line tool. The daemon must be ru
 
 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
+3. **Check daemon** — Use `icqq service status` for install/running state, then probe the account with `icqq profile` or `icqq friend list` to confirm IPC responds
 4. **Execute** — Run the command in terminal and report results
 
 ## Modules
@@ -28,7 +30,7 @@ Load the corresponding reference file based on what the user wants:
 | 设置：昵称、头像、签名、群名片、群头衔、加群方式、匿名 | 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) |
+| 登录、服务/守护、配置、OCR、黑名单、Webhook、通知、UID转换、陌生人、漫游表情、缓存、重载、频道与子频道（Guild & Channel）、RPC 远程连接、补全 | General | [general.md](./references/general.md) |
 
 ## Global Notes
 
@@ -39,4 +41,3 @@ Load the corresponding reference file based on what the user wants:
 - 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`）。

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