跳转到主要内容

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 listdb contact search 获取。 群成员的 username 需通过 db contact search 查询获得。

触发方式

当用户说出以下内容时,Agent 应触发此 SKILL:

  • "创建群拉张三李四"
  • "邀请王五进群"
  • "踢出张三"
  • "修改群名"
  • "转让群主"
  • "查看群详情"
  • "设置群公告"
  • "开群消息免打扰"
  • "置顶群聊"
  • "加群里的张三为好友"

SKILL 包

SKILL 名称说明
juhecli-wx-room个微群组管理 - 群信息/成员/创建/加人/踢人/改名/公告/置顶/免打扰/转让等 21+ 命令

命令详细说明与 Agent 交互示例

wx room detail — 获取群详情

获取指定群组的详细信息。Agent 需先通过 db room listdb contact search 获取群 ID。

参数类型说明来源
room_usernamestring群 ID[需查询]
text
用户:查看项目讨论群的详情
Agent:好的,我来查找群信息。
→ 调用 db room list → 找到"项目讨论群" room_username
→ 调用 wx room detail {"room_username":"xxx@chatroom"}
Agent:项目讨论群详情:
- 群名:项目讨论群
- 成员数:28
- 群主:张三

wx room members — 获取群成员详情

获取群组内所有成员的详细信息。

参数类型说明来源
room_usernamestring群 ID[需查询]
versionint版本号,默认 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_listarray群成员 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_usernamestring群 ID[需查询]
usernamestring新群主 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_usernamestring群 ID[需查询]
namestring新群名[用户提供]
text
用户:把项目群的群名改成"新项目群"
Agent:好的,我来修改。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room modify_name {"room_username":"xxx@chatroom","name":"新项目群"}
Agent:群名已改为"新项目群"。

wx room announcement — 设置群公告

设置或修改群公告内容。

参数类型说明来源
room_usernamestring群 ID[需查询]
announcementstring公告内容[用户提供]
text
用户:把项目群公告设为"每周一开会"
Agent:好的,我来设置群公告。
→ 调用 db room list → 找到项目群 room_username
→ 调用 wx room announcement {"room_username":"xxx@chatroom","announcement":"每周一开会"}
Agent:群公告已设置为"每周一开会"。

wx room display_name — 修改群内昵称

修改自己在某个群里的显示昵称。

参数类型说明来源
room_usernamestring群 ID[需查询]
display_namestring群内昵称[用户提供]
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_usernamemsg_id
  • wx room remove_top_msg — 移除群置顶消息,需 room_usernamemsg_id
  • wx 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_usernamestring群 ID[需查询]
usernamestring群成员 username[需查询]
verify_contentstring验证消息[用户提供]
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 listdb contact search 按群名查询
username / username_list[需查询]db contact search 按姓名查询
name / announcement / display_name[用户提供]用户直接提供
status固定值0=关闭, 1=开启

典型工作流

  1. 创建群:db contact search 查询所有成员 → wx room create
  2. 邀请入群:db room list 找到群 → db contact search 找到人 → wx room invite
  3. 管理群设置:db room list 找到群 → wx room modify_name / announcement / display_name
  4. 添加群成员为好友: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。 建议操作前先确认当前账号在群组中的角色和权限。