juhecli-wx-room 个微群组
SKILL: juhecli-wx-room — 微信个微群组的完整管理操作,包括群信息查询、成员管理、群设置、创建群组、加人踢人等 21+ 个命令
使用案例
创建微信群,群主 Hanson,群成员 Jony 和 Tony查看技术群的成员修改群名为项目组
创建群并拉人
>创建群拉张三李四
// Agent 先通过 db contact search 查询成员 username
$juhe-cli db contact search --keyword 张三
{
"username": "wxid_zhangsan",
"nickname": "张三"
}
$juhe-cli db contact search --keyword 李四
{
"username": "wxid_lisi",
"nickname": "李四"
}
// Agent 调用 wx room create 创建群组
$juhe-cli wx room create --username_list ["wxid_zhangsan","wxid_lisi"]
{
"room_username": "12345678@chatroom",
"member_count": 3
}
查看群成员
>查看项目讨论群的成员
// Agent 先查找群 ID
$juhe-cli db room list
{
"rooms": [
{
"room_username": "12345678@chatroom",
"name": "项目讨论群",
"member_count": 28
}
]
}
// Agent 调用 wx room members 获取成员列表
$juhe-cli wx room members --room_username 12345678@chatroom
{
"members": [
{
"username": "wxid_zhangsan",
"nickname": "张三"
},
{
"username": "wxid_lisi",
"nickname": "李四"
},
{
"username": "wxid_wangwu",
"nickname": "王五"
}
]
}
概述
个微群组 SKILL 由 juhecli-wx-room 提供,包含 21+ 个命令,覆盖群信息查询、 成员管理、群组创建、添加/移除成员、转让群主、群设置修改、群置顶消息管理以及添加群成员为好友等功能。
群组操作的
room_username 需通过 db room list 或 db contact search 获取。 群成员的 username 需通过 db contact search 查询获得。触发方式
当用户说出以下内容时,Agent 应触发此 SKILL:
- "创建群拉张三李四"
- "邀请王五进群"
- "踢出张三"
- "修改群名"
- "转让群主"
- "查看群详情"
- "设置群公告"
- "开群消息免打扰"
- "置顶群聊"
- "加群里的张三为好友"
SKILL 包
| SKILL 名称 | 说明 |
|---|---|
juhecli-wx-room | 个微群组管理 - 群信息/成员/创建/加人/踢人/改名/公告/置顶/免打扰/转让等 21+ 命令 |
命令详细说明与 Agent 交互示例
wx room detail — 获取群详情
获取指定群组的详细信息。Agent 需先通过 db room list 或 db contact search 获取群 ID。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
text
用户:查看项目讨论群的详情
Agent:好的,我来查找群信息。
→ 调用 db room list → 找到"项目讨论群" room_username
→ 调用 wx room detail {"room_username":"xxx@chatroom"}
Agent:项目讨论群详情:
- 群名:项目讨论群
- 成员数:28
- 群主:张三wx room members — 获取群成员详情
获取群组内所有成员的详细信息。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
version | int | 版本号,默认 0 | 可选 |
text
用户:查看项目群有哪些人
Agent:好的,我来查询群成员。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room members {"room_username":"xxx@chatroom"}
Agent:项目群共有 28 位成员:
- 张三(群主)
- 李四
- 王五
- ...(共 28 人)wx room qrcode — 获取群二维码
获取群组的二维码,可用于邀请他人扫码入群。
text
用户:获取项目群的二维码
Agent:好的,正在获取群二维码。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room qrcode {"room_username":"xxx@chatroom"}
Agent:群二维码已生成,分享此二维码即可邀请入群。[展示二维码]wx room create — 创建群组
创建新的群聊。至少需要 2 个成员(不包括创建者)。Agent 需先查询所有成员的 username。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
username_list | array | 群成员 username 列表(至少 2 人) | [需查询] |
创建群至少需要 2 个成员(不包括创建者自己)。
text
用户:创建一个群聊,包含张三和李四
Agent:好的,我来查找张三和李四。
→ 调用 db contact search {"keyword":"张三"} → wxid_zhangsan
→ 调用 db contact search {"keyword":"李四"} → wxid_lisi
→ 调用 wx room create {"username_list":["wxid_zhangsan","wxid_lisi"]}
Agent:群聊已创建,张三和李四已加入。wx room add_member — 添加群成员(低于40人)
直接添加成员进群,仅适用于群成员低于 40 人的群。被添加者无需确认直接入群。
text
用户:把王五加到项目讨论群
Agent:好的,我来查找群和王五。
→ 调用 db room list → 找到"项目讨论群"
→ 调用 db contact search {"keyword":"王五"} → wxid_wangwu
→ 调用 wx room add_member {"room_username":"xxx@chatroom","username_list":["wxid_wangwu"]}
Agent:王五已加入项目讨论群。wx room invite — 邀请群成员(超过40人)
邀请成员入群,适用于 40 人以上的群。被邀请者需要同意才能入群。
text
用户:邀请赵六进大群
Agent:好的,我来查找群和赵六。
→ 调用 db room list → 找到"大群"
→ 调用 db contact search {"keyword":"赵六"} → wxid_zhaoliu
→ 调用 wx room invite {"room_username":"xxx@chatroom","username_list":["wxid_zhaoliu"]}
Agent:已邀请赵六加入大群,等待对方确认。wx room del_member — 移除群成员
将成员从群中移除。需要群主或管理员权限。
移除群成员需要群主或管理员权限。
text
用户:把张三踢出项目讨论群
Agent:确认将张三移出项目讨论群吗?
用户:确认
Agent:正在操作。
→ 调用 db room list → 找到"项目讨论群"
→ 调用 db contact search {"keyword":"张三"} → wxid_zhangsan
→ 调用 wx room del_member {"room_username":"xxx@chatroom","username_list":["wxid_zhangsan"]}
Agent:张三已从项目讨论群中移除。wx room quit — 退出群
退出指定的群聊。Agent 应在执行前向用户确认。
text
用户:退出那个广告群
Agent:确认退出广告群吗?
用户:确认
Agent:正在退出。
→ 调用 db room list → 找到"广告群"
→ 调用 wx room quit {"room_username":"xxx@chatroom"}
Agent:已退出广告群。wx room transfer_owner — 转让群主
将群主身份转让给指定成员。需要当前群主权限,转让后不可撤销。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
username | string | 新群主 username | [需查询] |
转让群主需要当前群主权限,转让后不可撤销。Agent 应在执行前明确提醒用户。
text
用户:把项目讨论群的群主转让给李四
Agent:确认转让群主吗?转让后不可撤销,您将不再是群主。
用户:确认
Agent:正在转让。
→ 调用 db room list → 找到"项目讨论群"
→ 调用 db contact search {"keyword":"李四"} → wxid_lisi
→ 调用 wx room transfer_owner {"room_username":"xxx@chatroom","username":"wxid_lisi"}
Agent:已将项目讨论群的群主转让给李四。wx room modify_name — 修改群名称
修改群组的名称。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
name | string | 新群名 | [用户提供] |
text
用户:把项目群的群名改成"新项目群"
Agent:好的,我来修改。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room modify_name {"room_username":"xxx@chatroom","name":"新项目群"}
Agent:群名已改为"新项目群"。wx room announcement — 设置群公告
设置或修改群公告内容。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
announcement | string | 公告内容 | [用户提供] |
text
用户:把项目群公告设为"每周一开会"
Agent:好的,我来设置群公告。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room announcement {"room_username":"xxx@chatroom","announcement":"每周一开会"}
Agent:群公告已设置为"每周一开会"。wx room display_name — 修改群内昵称
修改自己在某个群里的显示昵称。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
display_name | string | 群内昵称 | [用户提供] |
text
用户:在项目群里把我的昵称改成"产品经理"
Agent:好的,我来修改群内昵称。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room display_name {"room_username":"xxx@chatroom","display_name":"产品经理"}
Agent:已将您在项目群的昵称改为"产品经理"。群状态设置(0/1 开关命令)
以下命令均接受 room_username [需查询] 和 status(0=关闭, 1=开启)参数:
wx room show_name— 显示/隐藏群成员昵称wx room disturb— 消息免打扰wx room top_flag— 群置顶开关wx room fold— 折叠/展开群wx room contact_flag— 保存群到通讯录
text
用户:把项目群开免打扰,并置顶
Agent:好的,我来设置。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room disturb {"room_username":"xxx@chatroom","status":1}
→ 调用 wx room top_flag {"room_username":"xxx@chatroom","status":1}
Agent:项目群已开启免打扰并置顶。群置顶消息管理
支持设置、移除和查看群置顶消息。
wx room set_top_msg— 设置群置顶消息,需room_username和msg_idwx room remove_top_msg— 移除群置顶消息,需room_username和msg_idwx room top_msg_list— 获取群置顶消息列表,需room_username
text
用户:查看项目群的置顶消息
Agent:好的,我来查看。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room top_msg_list {"room_username":"xxx@chatroom"}
Agent:项目群当前有 2 条置顶消息:
1. "每周一上午10点站会" — 张三
2. "项目文档链接:..." — 李四wx room add_friend — 添加群成员为好友
向群内非好友成员发送好友申请。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
room_username | string | 群 ID | [需查询] |
username | string | 群成员 username | [需查询] |
verify_content | string | 验证消息 | [用户提供] |
text
用户:加项目群里的王五为好友
Agent:好的,我来查找群和王五。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room members → 找到王五的 username
→ 调用 wx room add_friend {"room_username":"xxx@chatroom","username":"wxid_wangwu","verify_content":"你好,我是群友"}
Agent:好友申请已发送给王五,请等待对方确认。参数来源说明
| 参数 | 来源标记 | 获取方式 |
|---|---|---|
room_username | [需查询] | db room list 或 db contact search 按群名查询 |
username / username_list | [需查询] | db contact search 按姓名查询 |
name / announcement / display_name | [用户提供] | 用户直接提供 |
status | 固定值 | 0=关闭, 1=开启 |
典型工作流
- 创建群:
db contact search查询所有成员 →wx room create - 邀请入群:
db room list找到群 →db contact search找到人 →wx room invite - 管理群设置:
db room list找到群 →wx room modify_name/announcement/display_name等 - 添加群成员为好友:
wx room members获取成员列表 →wx room add_friend
错误处理
- room_username 不存在或已解散:Agent 应提示该群不存在或已解散
- 无权限操作:非群主/管理员会返回权限不足,Agent 应提示用户
- add_member 超过 40 人限制:Agent 应自动改用
wx room invite - 创建群至少需要 2 人:username_list 至少 2 个成员,Agent 应提示用户
添加成员时注意群人数限制:40 人以下用
add_member,以上用 invite。 建议操作前先确认当前账号在群组中的角色和权限。