name: qiwei-group-management

description: 迁移自 Qiwei 项目的群管理能力：同步外部群列表、按关键词分析/识别客户群、确认/手动添加外部群、同步群历史消息。支持自建群与非自建群扫描，所有调用通过 Fmode 网关，状态以文件形式保存在 outputs/groups/ 和 outputs/messages/。

企微群管理

使用边界

本 skill 负责群的发现、识别、确认和消息同步：

同步群列表（支持自建群、最近会话群、消息流反推三种来源）；
列出已同步群，并按状态/关键词/来源过滤；
分析群详情，按可配置关键词自动识别客户群；
手动确认某个群为客户群，并关联客户；
手动添加同步列表之外的 roomId；
手动拒绝某个群；
配置客户群识别关键词与匹配模式；
同步已确认群的历史消息。

不要在这里重新实现登录、订阅、通用 API 检索流程。遇到未登录、订阅不足、token 缺失时，转用已有工具：

qiwei_login_status
qiwei_login_start
qiwei_subscription_status
qiwei_subscribe
qiwei_api_search
qiwei_api_doc

接口规范

业务工具必须符合 mcp/catalog/qiwei-endpoints.json：

同步自建群列表使用 /room/getRoomList；
扫描最近会话群使用 /session/getSessionPage，sessionType=1 表示群；
消息流反推群使用 /msg/syncMsg + /room/batchGetRoomDetail；
分析群详情使用 /room/batchGetRoomDetail；
同步消息使用 /msg/syncMsg；
请求信封固定为 { "uid": "...", "method": "...", "params": {...} }；
鉴权固定走 Authorization: Bearer <Fmode token>；
guid 必须来自已登录设备。

标准流程

第 0 步：确认群创建方式

先询问用户："您要识别的客户群，是您自己创建的吗？"

是 → 调用 qiwei_sync_external_groups，scope: "self"（仅扫描 /room/getRoomList）。
否 / 不确定 → 调用 qiwei_sync_external_groups，scope: "all"；如需深度兜底，可附加 scanFromMessages: true。

第 1 步：同步外部群

示例（用户不确定是否自建）：

{
  "guid": "<已登录设备 guid>",
  "scope": "all",
  "scanFromMessages": false,
  "maxPages": 50,
  "autoClassify": true,
  "matchMode": "threshold",
  "threshold": 2,
  "previewMessages": 10,
  "previewOnlyForUnsure": true
}

previewMessages：对不确定的群拉取最近 N 条消息辅助识别，默认 0 表示不拉取；
previewOnlyForUnsure：仅对初筛不是 AUTO_CONFIRMED 的群拉消息，默认 true。

结果写入：

outputs/groups/2026-07-15/142030-sync-external-groups/rooms-<timestamp>.json
outputs/groups/rooms-latest.json
outputs/groups/group-scan-manifest.json

群记录包含：

source / sources：群来自哪个扫描来源（roomList、session、messages）
roomExtType：0=内部群，2=外部群
reviewStatus：IMPORTED / SUGGESTED / AUTO_CONFIRMED
confidence：置信度
reason：识别原因
matchedKeywords：命中关键词

第 2 步：列出并识别客户群

{
  "status": "AUTO_CONFIRMED"
}

返回最近一次同步的群，每个群附带：

reviewStatus: IMPORTED / SUGGESTED / AUTO_CONFIRMED / CONFIRMED / REJECTED
reason: 识别原因
matchedKeywords: 命中关键词

也可调用 qiwei_analyze_group_members 对指定 roomId 做更详细的群详情分析：

{
  "guid": "<已登录设备 guid>",
  "roomIds": ["r-1", "r-2"],
  "previewMessages": 10,
  "updateSnapshot": true
}

第 3 步：确认或拒绝客户群

对最近一次同步列表中的 roomId 确认：

{
  "roomId": "r-1",
  "externalUserId": "wx-u-1",
  "customerName": "张三"
}

映射写入 outputs/groups/confirmed-mapping.json。

如需拒绝：

{
  "roomId": "r-2",
  "reason": "内部通知群"
}

写入 outputs/groups/rejected-mapping.json。

如需添加同步列表之外的群，使用 qiwei_add_external_group：

{
  "roomId": "r-99",
  "roomName": "李四服务群",
  "externalUserId": "wx-u-2"
}

第 4 步：配置关键词（可选）

当自动分类效果不佳时，调优关键词：

{
  "keywords": ["客户群", "服务群", "售后群", "VIP群"],
  "highConfidenceTerms": ["客户群", "服务群"],
  "matchMode": "threshold",
  "threshold": 2
}

配置持久化到 outputs/groups/customer-keywords.json，会立即影响后续 qiwei_sync_external_groups 和 qiwei_list_external_groups 的分类结果。

第 5 步：同步群消息

对已确认的客户群同步历史消息：

{
  "guid": "<已登录设备 guid>"
}

不传 roomIds 时默认同步所有已确认映射中的群。结果按 room 写入 outputs/messages/room-<roomId>-<timestamp>.json。

状态说明

IMPORTED：已扫描但未命中关键词
SUGGESTED：低置信候选，建议人工确认
AUTO_CONFIRMED：自动命中关键词或高置信度词
CONFIRMED：经纪人手动确认
REJECTED：经纪人手动拒绝

迁移说明

原 Qiwei 项目中的 ExternalGroup SQLite 表、群状态机和关键词识别逻辑改为文件化：

群列表 → outputs/groups/rooms-*.json
最新快照 → outputs/groups/rooms-latest.json
确认映射 → outputs/groups/confirmed-mapping.json
拒绝映射 → outputs/groups/rejected-mapping.json
关键词配置 → outputs/groups/customer-keywords.json
扫描摘要 → outputs/groups/group-scan-manifest.json
群消息 → outputs/messages/room-*.json

MCP 工具：

qiwei_sync_external_groups
qiwei_list_external_groups
qiwei_analyze_group_members
qiwei_confirm_external_group
qiwei_add_external_group
qiwei_reject_external_group
qiwei_configure_group_keywords
qiwei_sync_group_messages

SKILL.md 5.8 KB Историја Датотека