@zhin.js/adapter-lark 1.0.76 → 1.0.77
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/CHANGELOG.md +8 -0
- package/package.json +4 -4
- package/skills/lark/SKILL.md +48 -25
package/CHANGELOG.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhin.js/adapter-lark",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.77",
|
|
4
4
|
"description": "Zhin.js adapter for Lark/Feishu (飞书)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./lib/index.js",
|
|
@@ -40,11 +40,11 @@
|
|
|
40
40
|
"@types/koa": "^2.15.0",
|
|
41
41
|
"@types/node": "^25.6.0",
|
|
42
42
|
"typescript": "^6.0.3",
|
|
43
|
-
"zhin.js": "1.0.
|
|
43
|
+
"zhin.js": "1.0.73"
|
|
44
44
|
},
|
|
45
45
|
"peerDependencies": {
|
|
46
|
-
"@zhin.js/http": "1.0.
|
|
47
|
-
"zhin.js": "1.0.
|
|
46
|
+
"@zhin.js/http": "1.0.66",
|
|
47
|
+
"zhin.js": "1.0.73"
|
|
48
48
|
},
|
|
49
49
|
"peerDependenciesMeta": {
|
|
50
50
|
"@zhin.js/http": {
|
package/skills/lark/SKILL.md
CHANGED
|
@@ -2,7 +2,11 @@
|
|
|
2
2
|
name: lark
|
|
3
3
|
platforms:
|
|
4
4
|
- lark
|
|
5
|
-
description:
|
|
5
|
+
description: >-
|
|
6
|
+
飞书/Lark 群聊管理能力。当用户在飞书中请求群管理（踢人、查成员、改群名）、
|
|
7
|
+
群聊创建/更新/解散、管理员设置/移除、用户查询或文件上传时使用。
|
|
8
|
+
即使用户没有提到飞书，只要上下文是 Lark 场景且涉及群聊或用户操作，就应触发。
|
|
9
|
+
仅有昵称时必须先 list_members 或 get_user 获取 user_id。
|
|
6
10
|
keywords:
|
|
7
11
|
- lark
|
|
8
12
|
- 飞书
|
|
@@ -11,6 +15,7 @@ keywords:
|
|
|
11
15
|
- 管理员
|
|
12
16
|
- 群聊
|
|
13
17
|
- 文件上传
|
|
18
|
+
- 解散
|
|
14
19
|
- list_members
|
|
15
20
|
tags:
|
|
16
21
|
- group
|
|
@@ -18,7 +23,6 @@ tags:
|
|
|
18
23
|
- im
|
|
19
24
|
- enterprise
|
|
20
25
|
tools:
|
|
21
|
-
# 平台特有工具
|
|
22
26
|
- lark_get_user
|
|
23
27
|
- lark_create_chat
|
|
24
28
|
- lark_update_chat
|
|
@@ -27,40 +31,59 @@ tools:
|
|
|
27
31
|
- lark_remove_managers
|
|
28
32
|
- lark_dissolve_chat
|
|
29
33
|
- lark_upload_file
|
|
30
|
-
# 通用群管工具
|
|
31
34
|
- lark_kick_member
|
|
32
35
|
- lark_list_members
|
|
33
36
|
- lark_get_group_info
|
|
34
37
|
- lark_set_group_name
|
|
35
38
|
---
|
|
36
39
|
|
|
37
|
-
|
|
40
|
+
# 飞书/Lark 群聊管理技能
|
|
38
41
|
|
|
39
|
-
|
|
42
|
+
飞书的群聊模型偏向企业场景，有群聊创建/解散的完整生命周期管理，以及文件上传能力。
|
|
40
43
|
|
|
41
|
-
|
|
44
|
+
## 核心原则
|
|
45
|
+
|
|
46
|
+
### 企业级 ID 体系
|
|
47
|
+
|
|
48
|
+
飞书的用户 ID 有三种形式（open_id / union_id / user_id），不同 API 可能需要不同 ID 类型。通过 `lark_get_user` 可以查询用户详情并获取各种 ID。
|
|
49
|
+
|
|
50
|
+
### 群聊生命周期
|
|
51
|
+
|
|
52
|
+
飞书支持完整的群聊生命周期管理：创建 → 添加成员 → 设管理员 → 正常使用 → 更新设置 → 解散。
|
|
53
|
+
|
|
54
|
+
**Example — 创建项目群：**
|
|
55
|
+
```
|
|
56
|
+
步骤1: lark_create_chat(name="XX项目组", members=[user1, user2])
|
|
57
|
+
步骤2: lark_set_managers(chat_id, managers=[user1]) # 设管理员
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## 工具分类
|
|
61
|
+
|
|
62
|
+
### 群聊管理
|
|
63
|
+
|
|
64
|
+
| 工具 | 用途 | 说明 |
|
|
42
65
|
|------|------|------|
|
|
43
|
-
| `
|
|
44
|
-
| `
|
|
45
|
-
| `
|
|
46
|
-
| `lark_add_members` |
|
|
47
|
-
| `
|
|
48
|
-
| `
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
66
|
+
| `lark_create_chat` | 创建群聊 | 需指定群名 + 初始成员 |
|
|
67
|
+
| `lark_update_chat` | 更新群设置 | 群名、群描述等 |
|
|
68
|
+
| `lark_dissolve_chat` | 解散群聊 | **不可逆**，需群主权限 |
|
|
69
|
+
| `lark_add_members` | 添加成员 | — |
|
|
70
|
+
| `lark_kick_member` | 移除成员 | — |
|
|
71
|
+
| `lark_set_managers` | 设管理员 | — |
|
|
72
|
+
| `lark_remove_managers` | 移除管理员 | — |
|
|
73
|
+
| `lark_set_group_name` | 改群名 | — |
|
|
74
|
+
| `lark_list_members` | 成员列表 | — |
|
|
75
|
+
| `lark_get_group_info` | 群信息 | — |
|
|
51
76
|
|
|
52
|
-
###
|
|
77
|
+
### 用户与文件
|
|
53
78
|
|
|
54
|
-
| 工具 |
|
|
79
|
+
| 工具 | 用途 | 说明 |
|
|
55
80
|
|------|------|------|
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
| `lark_get_group_info` | 获取群信息 | user |
|
|
59
|
-
| `lark_set_group_name` | 修改群名称 | group_admin |
|
|
81
|
+
| `lark_get_user` | 查询用户信息 | 可获取多种 ID 形式 |
|
|
82
|
+
| `lark_upload_file` | 上传文件 | 返回 file_key，可在消息中引用 |
|
|
60
83
|
|
|
61
|
-
##
|
|
84
|
+
## 易错点
|
|
62
85
|
|
|
63
|
-
1.
|
|
64
|
-
2.
|
|
65
|
-
3.
|
|
66
|
-
4.
|
|
86
|
+
1. **解散群聊不可逆**，需群主权限。确认用户意图后再执行。
|
|
87
|
+
2. **群聊创建至少需要群名和一个初始成员**。
|
|
88
|
+
3. **文件上传返回 file_key**，这个 key 用于在消息中引用文件，不是文件内容本身。
|
|
89
|
+
4. **飞书有 open_id / union_id / user_id 三种 ID**，操作时注意使用正确的 ID 类型。
|