@wecom/wecom-openclaw-plugin 1.0.13-beta.0 → 1.0.13-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/skills/wecom-msg/SKILL.md +57 -46
package/package.json
CHANGED
|
@@ -37,73 +37,84 @@ metadata:
|
|
|
37
37
|
|
|
38
38
|
向单聊或群聊发送文本消息。参见 [API 详情](references/api-send-message.md)。
|
|
39
39
|
|
|
40
|
+
---
|
|
40
41
|
|
|
41
|
-
##
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
- `
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
-
|
|
51
|
-
|
|
42
|
+
## 核心规则
|
|
43
|
+
|
|
44
|
+
### 时间范围规则
|
|
45
|
+
- **格式**：所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式
|
|
46
|
+
- **默认范围**：用户未指定时，默认使用最近7天（当前时间往前推7天）
|
|
47
|
+
- **限制**：开始时间不能早于当前时间的7天前，不能晚于当前时间
|
|
48
|
+
- **相对时间支持**：支持"昨天"、"最近三天"等自动推算
|
|
49
|
+
|
|
50
|
+
### chatid查找规则
|
|
51
|
+
- 当用户提供人名或群名而非ID时：
|
|
52
|
+
1. 调用 `get_msg_chat_list` 获取会话列表
|
|
53
|
+
2. 在 `chats` 中按 `chat_name` 匹配
|
|
54
|
+
3. **匹配策略**：
|
|
55
|
+
- 精确匹配唯一结果：直接使用
|
|
56
|
+
- 模糊匹配多个结果：展示候选列表让用户选择
|
|
57
|
+
- 无匹配结果：告知用户未找到
|
|
58
|
+
|
|
59
|
+
### userid转username
|
|
60
|
+
**流程**：
|
|
61
|
+
1. 调用 `wecom-contact-lookup get_userlist` 获取用户列表
|
|
62
|
+
2. 建立userid到username的映射关系
|
|
63
|
+
3. **展示策略**：
|
|
64
|
+
- 精确匹配：显示username
|
|
65
|
+
- 无匹配：保持显示userid
|
|
52
66
|
|
|
53
67
|
---
|
|
54
68
|
|
|
55
69
|
## 典型工作流
|
|
56
70
|
|
|
57
71
|
### 查看会话列表
|
|
58
|
-
|
|
59
|
-
**经典 query 示例：**
|
|
72
|
+
**用户query示例**：
|
|
60
73
|
- "看看我最近一周有哪些聊天"
|
|
61
74
|
- "这几天谁给我发过消息"
|
|
62
|
-
- "最近有哪些群聊活跃"
|
|
63
75
|
|
|
64
|
-
|
|
65
|
-
1.
|
|
66
|
-
2.
|
|
67
|
-
3.
|
|
68
|
-
4.
|
|
76
|
+
**执行流程**：
|
|
77
|
+
1. 确定时间范围（用户指定或默认7天）
|
|
78
|
+
2. 验证时间参数有效性
|
|
79
|
+
3. 调用 `get_msg_chat_list`
|
|
80
|
+
4. 展示会话信息
|
|
81
|
+
5. 分页提示（如有更多数据）
|
|
69
82
|
|
|
70
83
|
### 查看聊天记录
|
|
71
|
-
|
|
72
|
-
**经典 query 示例：**
|
|
84
|
+
**用户query示例**：
|
|
73
85
|
- "帮我看看和张三最近的聊天记录"
|
|
74
86
|
- "看看项目群里最近的消息"
|
|
75
|
-
- "我和李四昨天聊了什么"
|
|
76
87
|
|
|
77
|
-
|
|
78
|
-
1.
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
88
|
+
**执行流程**：
|
|
89
|
+
1. 通过chatid查找规则确定目标会话
|
|
90
|
+
2. 确定时间范围
|
|
91
|
+
3. 查询user name映射关系
|
|
92
|
+
4. 调用 `get_messages` 拉取消息
|
|
93
|
+
5. 展示消息（userid转username，链接处理）
|
|
94
|
+
6. 分页提示
|
|
84
95
|
|
|
85
96
|
### 发送消息
|
|
86
|
-
|
|
87
|
-
**经典 query 示例：**
|
|
97
|
+
**用户query示例**：
|
|
88
98
|
- "帮我给张三发一条消息：明天会议改到下午3点"
|
|
89
99
|
- "在项目群里发一条消息：今天下午3点开会"
|
|
90
|
-
- "给李四回复：收到，谢谢"
|
|
91
100
|
|
|
92
|
-
|
|
93
|
-
1.
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
- 无匹配结果：告知用户未找到对应会话
|
|
97
|
-
2. **确认发送**：向用户确认发送对象和内容（如："即将向 张三 发送：'明天会议改到下午3点'，确认发送吗？"）
|
|
98
|
-
3. 用户确认后调用 `send_message` 发送
|
|
99
|
-
4. 展示发送结果
|
|
101
|
+
**执行流程**：
|
|
102
|
+
1. 通过chatid查找规则确定目标会话
|
|
103
|
+
2. 直接调用 `send_message` 发送
|
|
104
|
+
3. 展示发送结果
|
|
100
105
|
|
|
101
106
|
### 查看消息并回复
|
|
102
|
-
|
|
103
|
-
**经典 query 示例：**
|
|
107
|
+
**用户query示例**：
|
|
104
108
|
- "看看张三给我发了什么，然后帮我回复收到"
|
|
105
|
-
- "查看项目群消息，然后回复一下"
|
|
106
109
|
|
|
107
|
-
|
|
108
|
-
1.
|
|
109
|
-
2.
|
|
110
|
+
**执行流程**：
|
|
111
|
+
1. 先执行"查看聊天记录"流程
|
|
112
|
+
2. 再执行"发送消息"流程
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## 错误处理
|
|
117
|
+
- **时间范围超限**：告知用户7天限制并调整为有效范围
|
|
118
|
+
- **会话未找到**：明确告知用户未找到对应会话
|
|
119
|
+
- **API错误**：展示具体错误信息，必要时重试
|
|
120
|
+
- **网络问题**：HTTP错误时主动重试最多3次
|