foliko 1.0.74 → 1.0.76

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.
Files changed (238) hide show
  1. package/.agent/.shared/ui-ux-pro-max/data/charts.csv +26 -0
  2. package/.agent/.shared/ui-ux-pro-max/data/colors.csv +97 -0
  3. package/.agent/.shared/ui-ux-pro-max/data/icons.csv +101 -0
  4. package/.agent/.shared/ui-ux-pro-max/data/landing.csv +31 -0
  5. package/.agent/.shared/ui-ux-pro-max/data/products.csv +97 -0
  6. package/.agent/.shared/ui-ux-pro-max/data/prompts.csv +24 -0
  7. package/.agent/.shared/ui-ux-pro-max/data/react-performance.csv +45 -0
  8. package/.agent/.shared/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  9. package/.agent/.shared/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  10. package/.agent/.shared/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  11. package/.agent/.shared/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  12. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  13. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  14. package/.agent/.shared/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  15. package/.agent/.shared/ui-ux-pro-max/data/stacks/react.csv +54 -0
  16. package/.agent/.shared/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  17. package/.agent/.shared/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  18. package/.agent/.shared/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  19. package/.agent/.shared/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  20. package/.agent/.shared/ui-ux-pro-max/data/styles.csv +59 -0
  21. package/.agent/.shared/ui-ux-pro-max/data/typography.csv +58 -0
  22. package/.agent/.shared/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  23. package/.agent/.shared/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  24. package/.agent/.shared/ui-ux-pro-max/data/web-interface.csv +31 -0
  25. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
  26. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  27. package/.agent/.shared/ui-ux-pro-max/scripts/core.py +258 -0
  28. package/.agent/.shared/ui-ux-pro-max/scripts/design_system.py +1067 -0
  29. package/.agent/.shared/ui-ux-pro-max/scripts/search.py +106 -0
  30. package/.agent/ARCHITECTURE.md +288 -0
  31. package/.agent/agents/ambient-agent.md +57 -0
  32. package/.agent/agents/debugger.md +55 -0
  33. package/.agent/agents/email-assistant.md +49 -0
  34. package/.agent/agents/file-manager.md +42 -0
  35. package/.agent/agents/python-developer.md +60 -0
  36. package/.agent/agents/scheduler.md +59 -0
  37. package/.agent/agents/web-developer.md +45 -0
  38. package/.agent/data/default.json +29 -0
  39. package/.agent/data/plugins-state.json +255 -0
  40. package/.agent/mcp_config.json +4 -0
  41. package/.agent/mcp_config_updated.json +12 -0
  42. package/.agent/plugins.json +5 -0
  43. package/.agent/rules/GEMINI.md +273 -0
  44. package/.agent/rules/allow-rule.md +77 -0
  45. package/.agent/rules/log-rule.md +83 -0
  46. package/.agent/rules/security-rule.md +93 -0
  47. package/.agent/scripts/auto_preview.py +148 -0
  48. package/.agent/scripts/checklist.py +217 -0
  49. package/.agent/scripts/session_manager.py +120 -0
  50. package/.agent/scripts/verify_all.py +327 -0
  51. package/.agent/skills/api-patterns/SKILL.md +81 -0
  52. package/.agent/skills/api-patterns/api-style.md +42 -0
  53. package/.agent/skills/api-patterns/auth.md +24 -0
  54. package/.agent/skills/api-patterns/documentation.md +26 -0
  55. package/.agent/skills/api-patterns/graphql.md +41 -0
  56. package/.agent/skills/api-patterns/rate-limiting.md +31 -0
  57. package/.agent/skills/api-patterns/response.md +37 -0
  58. package/.agent/skills/api-patterns/rest.md +40 -0
  59. package/.agent/skills/api-patterns/scripts/api_validator.py +211 -0
  60. package/.agent/skills/api-patterns/security-testing.md +122 -0
  61. package/.agent/skills/api-patterns/trpc.md +41 -0
  62. package/.agent/skills/api-patterns/versioning.md +22 -0
  63. package/.agent/skills/app-builder/SKILL.md +75 -0
  64. package/.agent/skills/app-builder/agent-coordination.md +71 -0
  65. package/.agent/skills/app-builder/feature-building.md +53 -0
  66. package/.agent/skills/app-builder/project-detection.md +34 -0
  67. package/.agent/skills/app-builder/scaffolding.md +118 -0
  68. package/.agent/skills/app-builder/tech-stack.md +40 -0
  69. package/.agent/skills/app-builder/templates/SKILL.md +39 -0
  70. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  71. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  72. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  73. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  74. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  75. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  76. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  77. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
  78. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
  79. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
  80. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
  81. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  82. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
  83. package/.agent/skills/architecture/SKILL.md +55 -0
  84. package/.agent/skills/architecture/context-discovery.md +43 -0
  85. package/.agent/skills/architecture/examples.md +94 -0
  86. package/.agent/skills/architecture/pattern-selection.md +68 -0
  87. package/.agent/skills/architecture/patterns-reference.md +50 -0
  88. package/.agent/skills/architecture/trade-off-analysis.md +77 -0
  89. package/.agent/skills/clean-code/SKILL.md +201 -0
  90. package/.agent/skills/doc.md +177 -0
  91. package/.agent/skills/frontend-design/SKILL.md +418 -0
  92. package/.agent/skills/frontend-design/animation-guide.md +331 -0
  93. package/.agent/skills/frontend-design/color-system.md +311 -0
  94. package/.agent/skills/frontend-design/decision-trees.md +418 -0
  95. package/.agent/skills/frontend-design/motion-graphics.md +306 -0
  96. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  97. package/.agent/skills/frontend-design/scripts/ux_audit.py +722 -0
  98. package/.agent/skills/frontend-design/typography-system.md +345 -0
  99. package/.agent/skills/frontend-design/ux-psychology.md +1116 -0
  100. package/.agent/skills/frontend-design/visual-effects.md +383 -0
  101. package/.agent/skills/i18n-localization/SKILL.md +154 -0
  102. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  103. package/.agent/skills/mcp-builder/SKILL.md +176 -0
  104. package/.agent/skills/web-design-guidelines/SKILL.md +57 -0
  105. package/.agent/workflows/brainstorm.md +113 -0
  106. package/.agent/workflows/create.md +59 -0
  107. package/.agent/workflows/debug.md +103 -0
  108. package/.agent/workflows/deploy.md +176 -0
  109. package/.agent/workflows/enhance.md +63 -0
  110. package/.agent/workflows/orchestrate.md +237 -0
  111. package/.agent/workflows/plan.md +89 -0
  112. package/.agent/workflows/preview.md +81 -0
  113. package/.agent/workflows/simple-test.md +42 -0
  114. package/.agent/workflows/status.md +86 -0
  115. package/.agent/workflows/structured-orchestrate.md +180 -0
  116. package/.agent/workflows/test.md +144 -0
  117. package/.agent/workflows/ui-ux-pro-max.md +296 -0
  118. package/.claude/settings.local.json +11 -1
  119. package/.editorconfig +56 -0
  120. package/.husky/pre-commit +4 -0
  121. package/.lintstagedrc +7 -0
  122. package/.prettierignore +29 -0
  123. package/.prettierrc +11 -0
  124. package/CLAUDE.md +2 -0
  125. package/README.md +64 -55
  126. package/SPEC.md +102 -61
  127. package/cli/bin/foliko.js +11 -11
  128. package/cli/src/commands/chat.js +143 -141
  129. package/cli/src/commands/list.js +93 -90
  130. package/cli/src/index.js +75 -75
  131. package/cli/src/ui/chat-ui.js +201 -199
  132. package/cli/src/utils/ansi.js +40 -40
  133. package/cli/src/utils/markdown.js +292 -296
  134. package/docker-compose.yml +1 -1
  135. package/docs/ai-sdk-optimization.md +655 -643
  136. package/docs/features.md +80 -80
  137. package/docs/quick-reference.md +49 -46
  138. package/docs/user-manual.md +411 -380
  139. package/examples/ambient-example.js +194 -196
  140. package/examples/basic.js +50 -45
  141. package/examples/bootstrap.js +121 -112
  142. package/examples/mcp-example.js +19 -16
  143. package/examples/skill-example.js +20 -20
  144. package/examples/test-chat.js +137 -135
  145. package/examples/test-mcp.js +85 -79
  146. package/examples/test-reload.js +59 -61
  147. package/examples/test-telegram.js +50 -50
  148. package/examples/test-tg-bot.js +45 -42
  149. package/examples/test-tg-simple.js +47 -46
  150. package/examples/test-tg.js +62 -62
  151. package/examples/test-think.js +43 -37
  152. package/examples/test-web-plugin.js +103 -98
  153. package/examples/test-weixin-feishu.js +103 -100
  154. package/examples/workflow.js +158 -158
  155. package/package.json +37 -3
  156. package/plugins/ai-plugin.js +102 -100
  157. package/plugins/ambient-agent/EventWatcher.js +113 -0
  158. package/plugins/ambient-agent/ExplorerLoop.js +640 -0
  159. package/plugins/ambient-agent/GoalManager.js +197 -0
  160. package/plugins/ambient-agent/Reflector.js +95 -0
  161. package/plugins/ambient-agent/StateStore.js +90 -0
  162. package/plugins/ambient-agent/constants.js +101 -0
  163. package/plugins/ambient-agent/index.js +579 -0
  164. package/plugins/audit-plugin.js +187 -187
  165. package/plugins/default-plugins.js +662 -649
  166. package/plugins/email/constants.js +64 -0
  167. package/plugins/email/handlers.js +461 -0
  168. package/plugins/email/index.js +278 -0
  169. package/plugins/email/monitor.js +269 -0
  170. package/plugins/email/parser.js +138 -0
  171. package/plugins/email/reply.js +151 -0
  172. package/plugins/email/utils.js +124 -0
  173. package/plugins/feishu-plugin.js +481 -477
  174. package/plugins/file-system-plugin.js +826 -476
  175. package/plugins/install-plugin.js +199 -197
  176. package/plugins/python-executor-plugin.js +367 -365
  177. package/plugins/python-plugin-loader.js +481 -479
  178. package/plugins/rules-plugin.js +294 -292
  179. package/plugins/scheduler-plugin.js +691 -689
  180. package/plugins/session-plugin.js +369 -367
  181. package/plugins/shell-executor-plugin.js +197 -197
  182. package/plugins/storage-plugin.js +240 -238
  183. package/plugins/subagent-plugin.js +845 -785
  184. package/plugins/telegram-plugin.js +482 -475
  185. package/plugins/think-plugin.js +345 -343
  186. package/plugins/tools-plugin.js +196 -194
  187. package/plugins/web-plugin.js +606 -604
  188. package/plugins/weixin-plugin.js +545 -538
  189. package/reports/system-health-report-20260401.md +79 -0
  190. package/skills/ambient-agent/SKILL.md +49 -39
  191. package/skills/foliko-dev/AGENTS.md +64 -61
  192. package/skills/foliko-dev/SKILL.md +125 -119
  193. package/skills/mcp-usage/SKILL.md +19 -17
  194. package/skills/python-plugin-dev/SKILL.md +16 -15
  195. package/skills/skill-guide/SKILL.md +12 -12
  196. package/skills/subagent-guide/SKILL.md +237 -0
  197. package/skills/workflow-guide/SKILL.md +90 -45
  198. package/skills/workflow-troubleshooting/DEBUGGING.md +36 -21
  199. package/skills/workflow-troubleshooting/SKILL.md +156 -79
  200. package/src/capabilities/index.js +11 -11
  201. package/src/capabilities/skill-manager.js +609 -595
  202. package/src/capabilities/workflow-engine.js +1109 -1195
  203. package/src/core/agent-chat.js +882 -735
  204. package/src/core/agent.js +892 -688
  205. package/src/core/framework.js +465 -431
  206. package/src/core/index.js +19 -19
  207. package/src/core/plugin-base.js +219 -219
  208. package/src/core/plugin-manager.js +863 -767
  209. package/src/core/provider.js +114 -111
  210. package/src/core/sub-agent-config.js +264 -0
  211. package/src/core/system-prompt-builder.js +120 -0
  212. package/src/core/tool-registry.js +517 -134
  213. package/src/core/tool-router.js +297 -216
  214. package/src/executors/executor-base.js +12 -12
  215. package/src/executors/mcp-executor.js +741 -729
  216. package/src/index.js +25 -37
  217. package/src/utils/circuit-breaker.js +301 -0
  218. package/src/utils/error-boundary.js +363 -0
  219. package/src/utils/error.js +374 -0
  220. package/src/utils/event-emitter.js +97 -97
  221. package/src/utils/id.js +133 -0
  222. package/src/utils/index.js +217 -3
  223. package/src/utils/logger.js +181 -0
  224. package/src/utils/plugin-helpers.js +90 -0
  225. package/src/utils/retry.js +122 -0
  226. package/src/utils/sandbox.js +292 -0
  227. package/test/tool-registry-validation.test.js +218 -0
  228. package/test_report.md +70 -0
  229. package/website/docs/api.html +169 -107
  230. package/website/docs/configuration.html +296 -144
  231. package/website/docs/plugin-development.html +154 -85
  232. package/website/docs/project-structure.html +110 -109
  233. package/website/docs/skill-development.html +117 -61
  234. package/website/index.html +209 -205
  235. package/website/script.js +136 -133
  236. package/website/styles.css +1 -1
  237. package/plugins/ambient-agent-plugin.js +0 -1565
  238. package/plugins/email.js +0 -1142
@@ -1,477 +1,481 @@
1
- /**
2
- * 飞书插件
3
- * 使用 @larksuiteoapi/node-sdk 的 WebSocket 长连接模式
4
- *
5
- * 配置:
6
- * - appId: 飞书应用 ID
7
- * - appSecret: 飞书应用密钥
8
- * - allowedUsers: 允许的用户 openId 数组
9
- */
10
-
11
- const { Plugin } = require('../src/core/plugin-base')
12
- const {cleanResponse} =require('../src/utils')
13
- const removeMarkdown = require('remove-markdown');
14
- class FeishuPlugin extends Plugin {
15
- constructor(config = {}) {
16
- super()
17
- this.name = 'feishu'
18
- this.version = '1.1.0'
19
- this.description = '飞书对话插件,使用 WebSocket 长连接接收消息'
20
- this.priority = 80
21
- this.enabled = false
22
- this.systemPrompt = `你是一个飞书助手。
23
-
24
- **重要:**
25
- -回复内容使用纯文本,不要使用markdown
26
-
27
- **命令执行规范:**
28
- - 执行 npx skills add / npx skills remove / npx skills list 命令时,必须自动添加参数:-a openclaw -y
29
- - 禁止添加 -g 参数
30
- - 例如:npx skills add xxx 应该执行为 npx skills add xxx -a openclaw -y`
31
-
32
- this.config = {
33
- appId: config.appId || process.env.FEISHU_APP_ID,
34
- appSecret: config.appSecret || process.env.FEISHU_APP_SECRET,
35
- allowedUsers: config.allowedUsers || []
36
- }
37
-
38
- this._framework = null
39
- this._client = null
40
- this._wsClient = null
41
- this._sessionPlugin = null
42
- this._sessionDeleteHandler = null
43
- this._sessionAgents = new Map()
44
- this._initialized = false
45
- this._processedMessages = new Set()
46
- this._messageCleanupInterval = null
47
- this._processingLock = new Map()
48
- }
49
-
50
- install(framework) {
51
- this._framework = framework
52
- return this
53
- }
54
-
55
- start(framework) {
56
- if (this._initialized) return this
57
- this._initialized = true
58
-
59
- if (!this.config.appId || !this.config.appSecret) {
60
- console.warn('[Feishu] No appId or appSecret.')
61
- return this
62
- }
63
-
64
- this._framework = framework
65
- this._sessionPlugin = framework.pluginManager.get('session')
66
-
67
- if (this._sessionPlugin) {
68
- this._sessionDeleteHandler = (sessionId) => {
69
- if (sessionId.startsWith('feishu_')) {
70
- console.log(`[Feishu] Session deleted: ${sessionId}`)
71
- }
72
- }
73
- this._sessionPlugin.on('session:deleted', this._sessionDeleteHandler)
74
- }
75
-
76
- this._initClient()
77
- return this
78
- }
79
-
80
- _initClient() {
81
- try {
82
- const { Client, WSClient, EventDispatcher } = require('@larksuiteoapi/node-sdk')
83
-
84
- this._client = new Client({
85
- appId: this.config.appId,
86
- appSecret: this.config.appSecret,
87
- logger: console
88
- })
89
-
90
- this._wsClient = new WSClient({
91
- appId: this.config.appId,
92
- appSecret: this.config.appSecret,
93
- logger: console
94
- })
95
-
96
- const eventDispatcher = new EventDispatcher({}).register({
97
- 'im.message.receive_v1': async (data) => {
98
- await this._handleMessage(data)
99
- }
100
- })
101
-
102
- this._wsClient.start({ eventDispatcher })
103
-
104
- this._messageCleanupInterval = setInterval(() => {
105
- this._processedMessages.clear()
106
- }, 60000)
107
-
108
- if (this._framework) {
109
- this._framework.on('scheduler:reminder', async (data) => {
110
- await this._handleScheduledReminder(data)
111
- })
112
-
113
- // 监听 webhook 事件
114
- this._framework.on('webhook:received', async (data) => {
115
- await this._handleWebhookNotification(data)
116
- })
117
-
118
- // 监听统一通知事件
119
- this._framework.on('notification', async (data) => {
120
- await this._handleNotification(data)
121
- })
122
- }
123
-
124
- console.log('[Feishu] WebSocket client started')
125
- } catch (err) {
126
- console.error('[Feishu] Failed to initialize client:', err.message, err.stack)
127
- }
128
- }
129
-
130
- async _handleMessage(data) {
131
- try {
132
- if (!data || !data.message || Object.keys(data.message).length === 0) {
133
- return
134
- }
135
-
136
- const message = data.message
137
- const chatId = message.chat_id
138
- const messageId = message.message_id
139
- const openId = message.sender?.sender_id?.open_id || message.sender?.open_id || message.open_id || chatId
140
- const messageType = message.message_type
141
- let content = {}
142
-
143
- try {
144
- content = message.content ? JSON.parse(message.content) : {}
145
- } catch (e) {
146
- return
147
- }
148
-
149
- if (messageId && this._processedMessages.has(messageId)) {
150
- return
151
- }
152
- if (messageId) this._processedMessages.add(messageId)
153
-
154
- if (messageType !== 'text') return
155
-
156
- const text = content.text?.trim()
157
- if (!text) return
158
-
159
- if (!this._checkPermission(openId)) return
160
-
161
- if (text.startsWith('/')) {
162
- await this._handleCommand(openId, text, message)
163
- return
164
- }
165
-
166
- if (this._processingLock.get(openId)) return
167
- this._processingLock.set(openId, true)
168
-
169
- try {
170
- await this._processChat(openId, text, message)
171
- } finally {
172
- this._processingLock.set(openId, false)
173
- }
174
- } catch (err) {
175
- console.error('[Feishu] Error handling message:', err.message)
176
- }
177
- }
178
-
179
- async _handleCommand(openId, text, originalMsg) {
180
- const parts = text.split(' ')
181
- const command = parts[0].substring(1)
182
- const args = parts.slice(1).join(' ')
183
-
184
- switch (command.toLowerCase()) {
185
- case 'start':
186
- case 'help':
187
- await this._sendMessage(openId,
188
- '👋 欢迎使用 AI 助手!\n\n直接发送消息即可与我对话。\n\n可用命令:\n/start - 显示帮助\n/clear - 清除对话历史\n/history - 查看历史消息数',
189
- originalMsg)
190
- break
191
- case 'clear':
192
- this._clearSession(openId)
193
- await this._sendMessage(openId, '✅ 对话历史已清除', originalMsg)
194
- break
195
- case 'history':
196
- if (this._sessionPlugin) {
197
- const session = this._sessionPlugin.getSession(`feishu_${openId}`)
198
- const sessions = this._sessionPlugin.listSessions().filter(s => s.id.startsWith('feishu_'))
199
- await this._sendMessage(openId,
200
- `📊 当前状态\n\n会话数:${sessions.length}\n历史消息:${session?.messages?.length || 0}\n最后活跃:${session?.lastActive?.toLocaleString() || '无'}`,
201
- originalMsg)
202
- } else {
203
- await this._sendMessage(openId, '❌ 会话服务不可用', originalMsg)
204
- }
205
- break
206
- default:
207
- await this._processChat(openId, text, originalMsg)
208
- }
209
- }
210
-
211
- _getSessionAgent(openId) {
212
- if (this._sessionAgents.has(openId)) {
213
- return { agent: this._sessionAgents.get(openId), sessionId: `feishu_${openId}` }
214
- }
215
-
216
- const agent = this._framework.createSessionAgent(`feishu_${openId}`, {
217
- systemPrompt: this.systemPrompt,
218
- sharedPrompt: `工作目录: {{WORK_DIR}}`,
219
- metadata: { WORK_DIR: process.cwd() }
220
- })
221
- this._sessionAgents.set(openId, agent)
222
-
223
- if (this._sessionPlugin) {
224
- this._sessionPlugin.getOrCreateSession(`feishu_${openId}`, {
225
- metadata: { platform: 'feishu', openId }
226
- })
227
- }
228
-
229
- return { agent, sessionId: `feishu_${openId}` }
230
- }
231
-
232
- async _handleScheduledReminder(data) {
233
- const { taskName, message, sessionId } = data
234
- const reminderText = `🔔 [${taskName}]\n\n${message}`
235
-
236
- if (sessionId && sessionId.startsWith('feishu_')) {
237
- const openId = sessionId.replace('feishu_', '')
238
- try {
239
- await this._sendTextMessage(openId, reminderText)
240
- } catch (err) {
241
- console.error(`[Feishu] Failed to send reminder:`, err.message)
242
- }
243
- return
244
- }
245
-
246
- if (this._sessionPlugin) {
247
- const sessions = this._sessionPlugin.listSessions()
248
- .filter(s => s.id.startsWith('feishu_'))
249
- .sort((a, b) => new Date(b.lastActive).getTime() - new Date(a.lastActive).getTime())
250
-
251
- if (sessions.length > 0) {
252
- const openId = sessions[0].id.replace('feishu_', '')
253
- try {
254
- await this._sendTextMessage(openId, reminderText)
255
- } catch (err) {
256
- console.error(`[Feishu] Failed to send reminder:`, err.message)
257
- }
258
- }
259
- }
260
- }
261
-
262
- /**
263
- * 处理 webhook 通知
264
- */
265
- async _handleWebhookNotification(data) {
266
- const { data: webhookData, response, sessionId } = data
267
-
268
- if (!sessionId || !sessionId.startsWith('feishu_')) {
269
- return
270
- }
271
-
272
- const openId = sessionId.replace('feishu_', '')
273
- const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
274
-
275
- try {
276
- await this._sendTextMessage(openId, notificationText)
277
- console.log(`[Feishu] Webhook notification sent to ${openId}`)
278
- } catch (err) {
279
- console.error(`[Feishu] Failed to send webhook notification:`, err.message)
280
- }
281
- }
282
-
283
- /**
284
- * 处理统一通知
285
- */
286
- async _handleNotification(data) {
287
- const { title, message, source, level, sessionId } = data
288
-
289
- // 确定 openId
290
- let openId = null
291
- let effectiveSessionId = sessionId
292
-
293
- // 如果没有 sessionId,尝试从执行上下文获取
294
- if (!effectiveSessionId) {
295
- const ctx = this._framework.getExecutionContext()
296
- if (ctx?.sessionId) {
297
- effectiveSessionId = ctx.sessionId
298
- }
299
- }
300
-
301
- if (effectiveSessionId && effectiveSessionId.startsWith('feishu_')) {
302
- openId = effectiveSessionId.replace('feishu_', '')
303
- } else if (this._sessionPlugin) {
304
- // 获取最近的 feishu 会话
305
- const sessions = this._sessionPlugin.listSessions()
306
- .filter(s => s.id.startsWith('feishu_'))
307
- .sort((a, b) => new Date(b.lastActive).getTime() - new Date(a.lastActive).getTime())
308
- if (sessions.length > 0) {
309
- openId = sessions[0].id.replace('feishu_', '')
310
- }
311
- }
312
-
313
- if (!openId) {
314
- console.warn('[Feishu] No feishu session found for notification')
315
- return
316
- }
317
-
318
- // 格式化通知消息
319
- const levelEmoji = {
320
- info: 'ℹ️',
321
- warning: '⚠️',
322
- success: '✅',
323
- error: '❌'
324
- }
325
- const emoji = levelEmoji[level] || 'ℹ️'
326
- const notificationText = `${emoji} [${source}] ${title}\n\n${message}`
327
-
328
- try {
329
- await this._sendTextMessage(openId, notificationText)
330
- console.log(`[Feishu] Notification sent to ${openId}`)
331
- } catch (err) {
332
- console.error(`[Feishu] Failed to send notification:`, err.message)
333
- }
334
- }
335
-
336
- async _processChat(openId, text, originalMsg) {
337
- const sessionInfo = this._getSessionAgent(openId)
338
- if (!sessionInfo) return
339
-
340
- const { agent, sessionId } = sessionInfo
341
-
342
- if (this._sessionPlugin) {
343
- this._sessionPlugin.addMessage(sessionId, { role: 'user', content: text })
344
- }
345
-
346
- try {
347
- // 使用非流式响应
348
- const result = await agent.chat(text, { sessionId })
349
- const fullResponse = cleanResponse(result.message || '')
350
-
351
- if (this._sessionPlugin) {
352
- this._sessionPlugin.addMessage(sessionId, { role: 'assistant', content: fullResponse })
353
- }
354
-
355
- if (fullResponse) {
356
- await this._sendMessage(openId, fullResponse, originalMsg)
357
- } else {
358
- await this._sendMessage(openId, '抱歉,我没有收到有效的回复。', originalMsg)
359
- }
360
- } catch (err) {
361
- console.error('[Feishu] Chat error:', err)
362
- await this._sendMessage(openId, `发生错误:${err.message}`, originalMsg)
363
- }
364
- }
365
-
366
- async _sendTextMessage(openId, text) {
367
- if (!this._client) return
368
- try {
369
- await this._client.im.message.create({
370
- params: { receive_id_type: 'chat_id' },
371
- data: {
372
- receive_id: openId,
373
- content: JSON.stringify({ text }),
374
- msg_type: 'text'
375
- }
376
- })
377
- } catch (err) {
378
- console.error('[Feishu] Failed to send text message:', err.message)
379
- throw err
380
- }
381
- }
382
-
383
- async _sendMessage(openId, text, originalMsg) {
384
- if (!this._client) return
385
- text=removeMarkdown(text)
386
- try {
387
- const chatId = originalMsg?.chat_id || originalMsg?.message?.chat_id
388
- if (!chatId) return
389
-
390
- await this._client.im.message.create({
391
- params: { receive_id_type: 'chat_id' },
392
- data: {
393
- receive_id: chatId,
394
- content: JSON.stringify({ text }),
395
- msg_type: 'text'
396
- }
397
- })
398
- } catch (err) {
399
- console.error('[Feishu] Failed to send message:', err.message)
400
- }
401
- }
402
-
403
- _checkPermission(openId) {
404
- return this.config.allowedUsers.length === 0 || this.config.allowedUsers.includes(openId)
405
- }
406
-
407
- _clearSession(openId) {
408
- if (this._sessionPlugin) {
409
- this._sessionPlugin.deleteSession(`feishu_${openId}`)
410
- }
411
- }
412
-
413
- getStatus() {
414
- let sessions = []
415
- if (this._sessionPlugin) {
416
- sessions = this._sessionPlugin.listSessions()
417
- .filter(s => s.id.startsWith('feishu_'))
418
- .map(s => ({
419
- openId: s.id.replace('feishu_', ''),
420
- historyLength: s.messageCount,
421
- lastActive: s.lastActive
422
- }))
423
- }
424
- return {
425
- connected: !!this._wsClient,
426
- sessionCount: sessions.length,
427
- sessions,
428
- config: {
429
- appId: this.config.appId ? `${this.config.appId.substring(0, 10)}...` : null,
430
- allowedUsersCount: this.config.allowedUsers.length
431
- }
432
- }
433
- }
434
-
435
- stopClient() {
436
- if (this._wsClient) {
437
- try { this._wsClient.close() } catch (e) { /* ignore */ }
438
- this._wsClient = null
439
- this._client = null
440
- console.log('[Feishu] Client stopped')
441
- }
442
- }
443
-
444
- stop() {
445
- this.stopClient()
446
- }
447
-
448
- reload(framework) {
449
- this._framework = framework
450
- this._initialized = false
451
- this.stopClient()
452
- this.start(framework)
453
- }
454
-
455
- uninstall() {
456
- for (const agent of this._sessionAgents.values()) {
457
- agent.destroy()
458
- }
459
- this._sessionAgents.clear()
460
-
461
- if (this._messageCleanupInterval) {
462
- clearInterval(this._messageCleanupInterval)
463
- this._messageCleanupInterval = null
464
- }
465
- this._processedMessages.clear()
466
-
467
- this.stopClient()
468
- if (this._sessionPlugin && this._sessionDeleteHandler) {
469
- this._sessionPlugin.off('session:deleted', this._sessionDeleteHandler)
470
- this._sessionDeleteHandler = null
471
- }
472
- this._sessionPlugin = null
473
- this._framework = null
474
- }
475
- }
476
-
477
- module.exports = { FeishuPlugin }
1
+ /**
2
+ * 飞书插件
3
+ * 使用 @larksuiteoapi/node-sdk 的 WebSocket 长连接模式
4
+ *
5
+ * 配置:
6
+ * - appId: 飞书应用 ID
7
+ * - appSecret: 飞书应用密钥
8
+ * - allowedUsers: 允许的用户 openId 数组
9
+ */
10
+
11
+ const { Plugin } = require('../src/core/plugin-base')
12
+ const { logger } = require('../src/utils/logger')
13
+ const log = logger.child('Feishu')
14
+ const {cleanResponse} =require('../src/utils')
15
+ const removeMarkdown = require('remove-markdown');
16
+ class FeishuPlugin extends Plugin {
17
+ constructor(config = {}) {
18
+ super()
19
+ this.name = 'feishu'
20
+ this.version = '1.1.0'
21
+ this.description = '飞书对话插件,使用 WebSocket 长连接接收消息'
22
+ this.priority = 80
23
+ this.enabled = false
24
+ this.systemPrompt = `你是一个飞书助手。回复内容不要使用markdown格式文本。
25
+
26
+ **重要:** 子Agent 匹配规则必须遵守:
27
+ - 根据【子 Agent 匹配表】,将任务委托给最匹配的子Agent处理
28
+ - 使用 subagent_call 工具并指定 agentName 来委托任务
29
+ - 只有当没有匹配的子Agent时,才直接调用工具
30
+
31
+ **命令执行规范:**
32
+ - 执行 npx skills add / npx skills remove / npx skills list 命令时,必须自动添加参数:-a openclaw -y
33
+ - 禁止添加 -g 参数
34
+ - 例如:npx skills add xxx 应该执行为 npx skills add xxx -a openclaw -y`
35
+
36
+ this.config = {
37
+ appId: config.appId || process.env.FEISHU_APP_ID,
38
+ appSecret: config.appSecret || process.env.FEISHU_APP_SECRET,
39
+ allowedUsers: config.allowedUsers || []
40
+ }
41
+
42
+ this._framework = null
43
+ this._client = null
44
+ this._wsClient = null
45
+ this._sessionPlugin = null
46
+ this._sessionDeleteHandler = null
47
+ this._sessionAgents = new Map()
48
+ this._initialized = false
49
+ this._processedMessages = new Set()
50
+ this._messageCleanupInterval = null
51
+ this._processingLock = new Map()
52
+ }
53
+
54
+ install(framework) {
55
+ this._framework = framework
56
+ return this
57
+ }
58
+
59
+ start(framework) {
60
+ if (this._initialized) return this
61
+ this._initialized = true
62
+
63
+ if (!this.config.appId || !this.config.appSecret) {
64
+ log.warn(' No appId or appSecret.')
65
+ return this
66
+ }
67
+
68
+ this._framework = framework
69
+ this._sessionPlugin = framework.pluginManager.get('session')
70
+
71
+ if (this._sessionPlugin) {
72
+ this._sessionDeleteHandler = (sessionId) => {
73
+ if (sessionId.startsWith('feishu_')) {
74
+ log.info(` Session deleted: ${sessionId}`)
75
+ }
76
+ }
77
+ this._sessionPlugin.on('session:deleted', this._sessionDeleteHandler)
78
+ }
79
+
80
+ this._initClient()
81
+ return this
82
+ }
83
+
84
+ _initClient() {
85
+ try {
86
+ const { Client, WSClient, EventDispatcher } = require('@larksuiteoapi/node-sdk')
87
+
88
+ this._client = new Client({
89
+ appId: this.config.appId,
90
+ appSecret: this.config.appSecret,
91
+ logger: console
92
+ })
93
+
94
+ this._wsClient = new WSClient({
95
+ appId: this.config.appId,
96
+ appSecret: this.config.appSecret,
97
+ logger: console
98
+ })
99
+
100
+ const eventDispatcher = new EventDispatcher({}).register({
101
+ 'im.message.receive_v1': async (data) => {
102
+ await this._handleMessage(data)
103
+ }
104
+ })
105
+
106
+ this._wsClient.start({ eventDispatcher })
107
+
108
+ this._messageCleanupInterval = setInterval(() => {
109
+ this._processedMessages.clear()
110
+ }, 60000)
111
+
112
+ if (this._framework) {
113
+ this._framework.on('scheduler:reminder', async (data) => {
114
+ await this._handleScheduledReminder(data)
115
+ })
116
+
117
+ // 监听 webhook 事件
118
+ this._framework.on('webhook:received', async (data) => {
119
+ await this._handleWebhookNotification(data)
120
+ })
121
+
122
+ // 监听统一通知事件
123
+ this._framework.on('notification', async (data) => {
124
+ await this._handleNotification(data)
125
+ })
126
+ }
127
+
128
+ log.info(' WebSocket client started')
129
+ } catch (err) {
130
+ log.error(' Failed to initialize client:', err.message, err.stack)
131
+ }
132
+ }
133
+
134
+ async _handleMessage(data) {
135
+ try {
136
+ if (!data || !data.message || Object.keys(data.message).length === 0) {
137
+ return
138
+ }
139
+
140
+ const message = data.message
141
+ const chatId = message.chat_id
142
+ const messageId = message.message_id
143
+ const openId = message.sender?.sender_id?.open_id || message.sender?.open_id || message.open_id || chatId
144
+ const messageType = message.message_type
145
+ let content = {}
146
+
147
+ try {
148
+ content = message.content ? JSON.parse(message.content) : {}
149
+ } catch (e) {
150
+ return
151
+ }
152
+
153
+ if (messageId && this._processedMessages.has(messageId)) {
154
+ return
155
+ }
156
+ if (messageId) this._processedMessages.add(messageId)
157
+
158
+ if (messageType !== 'text') return
159
+
160
+ const text = content.text?.trim()
161
+ if (!text) return
162
+
163
+ if (!this._checkPermission(openId)) return
164
+
165
+ if (text.startsWith('/')) {
166
+ await this._handleCommand(openId, text, message)
167
+ return
168
+ }
169
+
170
+ if (this._processingLock.get(openId)) return
171
+ this._processingLock.set(openId, true)
172
+
173
+ try {
174
+ await this._processChat(openId, text, message)
175
+ } finally {
176
+ this._processingLock.set(openId, false)
177
+ }
178
+ } catch (err) {
179
+ log.error(' Error handling message:', err.message)
180
+ }
181
+ }
182
+
183
+ async _handleCommand(openId, text, originalMsg) {
184
+ const parts = text.split(' ')
185
+ const command = parts[0].substring(1)
186
+ const args = parts.slice(1).join(' ')
187
+
188
+ switch (command.toLowerCase()) {
189
+ case 'start':
190
+ case 'help':
191
+ await this._sendMessage(openId,
192
+ '👋 欢迎使用 AI 助手!\n\n直接发送消息即可与我对话。\n\n可用命令:\n/start - 显示帮助\n/clear - 清除对话历史\n/history - 查看历史消息数',
193
+ originalMsg)
194
+ break
195
+ case 'clear':
196
+ this._clearSession(openId)
197
+ await this._sendMessage(openId, '✅ 对话历史已清除', originalMsg)
198
+ break
199
+ case 'history':
200
+ if (this._sessionPlugin) {
201
+ const session = this._sessionPlugin.getSession(`feishu_${openId}`)
202
+ const sessions = this._sessionPlugin.listSessions().filter(s => s.id.startsWith('feishu_'))
203
+ await this._sendMessage(openId,
204
+ `📊 当前状态\n\n会话数:${sessions.length}\n历史消息:${session?.messages?.length || 0}\n最后活跃:${session?.lastActive?.toLocaleString() || '无'}`,
205
+ originalMsg)
206
+ } else {
207
+ await this._sendMessage(openId, '❌ 会话服务不可用', originalMsg)
208
+ }
209
+ break
210
+ default:
211
+ await this._processChat(openId, text, originalMsg)
212
+ }
213
+ }
214
+
215
+ _getSessionAgent(openId) {
216
+ if (this._sessionAgents.has(openId)) {
217
+ return { agent: this._sessionAgents.get(openId), sessionId: `feishu_${openId}` }
218
+ }
219
+
220
+ const agent = this._framework.createSessionAgent(`feishu_${openId}`, {
221
+ systemPrompt: this.systemPrompt,
222
+ sharedPrompt: `工作目录: {{WORK_DIR}}`,
223
+ metadata: { WORK_DIR: process.cwd() }
224
+ })
225
+ this._sessionAgents.set(openId, agent)
226
+
227
+ if (this._sessionPlugin) {
228
+ this._sessionPlugin.getOrCreateSession(`feishu_${openId}`, {
229
+ metadata: { platform: 'feishu', openId }
230
+ })
231
+ }
232
+
233
+ return { agent, sessionId: `feishu_${openId}` }
234
+ }
235
+
236
+ async _handleScheduledReminder(data) {
237
+ const { taskName, message, sessionId } = data
238
+ const reminderText = `🔔 [${taskName}]\n\n${message}`
239
+
240
+ if (sessionId && sessionId.startsWith('feishu_')) {
241
+ const openId = sessionId.replace('feishu_', '')
242
+ try {
243
+ await this._sendTextMessage(openId, reminderText)
244
+ } catch (err) {
245
+ log.error(` Failed to send reminder:`, err.message)
246
+ }
247
+ return
248
+ }
249
+
250
+ if (this._sessionPlugin) {
251
+ const sessions = this._sessionPlugin.listSessions()
252
+ .filter(s => s.id.startsWith('feishu_'))
253
+ .sort((a, b) => new Date(b.lastActive).getTime() - new Date(a.lastActive).getTime())
254
+
255
+ if (sessions.length > 0) {
256
+ const openId = sessions[0].id.replace('feishu_', '')
257
+ try {
258
+ await this._sendTextMessage(openId, reminderText)
259
+ } catch (err) {
260
+ log.error(` Failed to send reminder:`, err.message)
261
+ }
262
+ }
263
+ }
264
+ }
265
+
266
+ /**
267
+ * 处理 webhook 通知
268
+ */
269
+ async _handleWebhookNotification(data) {
270
+ const { data: webhookData, response, sessionId } = data
271
+
272
+ if (!sessionId || !sessionId.startsWith('feishu_')) {
273
+ return
274
+ }
275
+
276
+ const openId = sessionId.replace('feishu_', '')
277
+ const notificationText = `📥 [Webhook 接收]\n\n路径: ${webhookData.path}\n方法: ${webhookData.method}\n\n处理结果: ${response || '处理中...'}`
278
+
279
+ try {
280
+ await this._sendTextMessage(openId, notificationText)
281
+ log.info(` Webhook notification sent to ${openId}`)
282
+ } catch (err) {
283
+ log.error(` Failed to send webhook notification:`, err.message)
284
+ }
285
+ }
286
+
287
+ /**
288
+ * 处理统一通知
289
+ */
290
+ async _handleNotification(data) {
291
+ const { title, message, source, level, sessionId } = data
292
+
293
+ // 确定 openId
294
+ let openId = null
295
+ let effectiveSessionId = sessionId
296
+
297
+ // 如果没有 sessionId,尝试从执行上下文获取
298
+ if (!effectiveSessionId) {
299
+ const ctx = this._framework.getExecutionContext()
300
+ if (ctx?.sessionId) {
301
+ effectiveSessionId = ctx.sessionId
302
+ }
303
+ }
304
+
305
+ if (effectiveSessionId && effectiveSessionId.startsWith('feishu_')) {
306
+ openId = effectiveSessionId.replace('feishu_', '')
307
+ } else if (this._sessionPlugin) {
308
+ // 获取最近的 feishu 会话
309
+ const sessions = this._sessionPlugin.listSessions()
310
+ .filter(s => s.id.startsWith('feishu_'))
311
+ .sort((a, b) => new Date(b.lastActive).getTime() - new Date(a.lastActive).getTime())
312
+ if (sessions.length > 0) {
313
+ openId = sessions[0].id.replace('feishu_', '')
314
+ }
315
+ }
316
+
317
+ if (!openId) {
318
+ log.warn(' No feishu session found for notification')
319
+ return
320
+ }
321
+
322
+ // 格式化通知消息
323
+ const levelEmoji = {
324
+ info: 'ℹ️',
325
+ warning: '⚠️',
326
+ success: '✅',
327
+ error: '❌'
328
+ }
329
+ const emoji = levelEmoji[level] || 'ℹ️'
330
+ const notificationText = `${emoji} [${source}] ${title}\n\n${message}`
331
+
332
+ try {
333
+ await this._sendTextMessage(openId, notificationText)
334
+ log.info(` Notification sent to ${openId}`)
335
+ } catch (err) {
336
+ log.error(` Failed to send notification:`, err.message)
337
+ }
338
+ }
339
+
340
+ async _processChat(openId, text, originalMsg) {
341
+ const sessionInfo = this._getSessionAgent(openId)
342
+ if (!sessionInfo) return
343
+
344
+ const { agent, sessionId } = sessionInfo
345
+
346
+ if (this._sessionPlugin) {
347
+ this._sessionPlugin.addMessage(sessionId, { role: 'user', content: text })
348
+ }
349
+
350
+ try {
351
+ // 使用非流式响应
352
+ const result = await agent.chat(text, { sessionId })
353
+ const fullResponse = cleanResponse(result.message || '')
354
+
355
+ if (this._sessionPlugin) {
356
+ this._sessionPlugin.addMessage(sessionId, { role: 'assistant', content: fullResponse })
357
+ }
358
+
359
+ if (fullResponse) {
360
+ await this._sendMessage(openId, fullResponse, originalMsg)
361
+ } else {
362
+ await this._sendMessage(openId, '抱歉,我没有收到有效的回复。', originalMsg)
363
+ }
364
+ } catch (err) {
365
+ log.error(' Chat error:', err)
366
+ await this._sendMessage(openId, `发生错误:${err.message}`, originalMsg)
367
+ }
368
+ }
369
+
370
+ async _sendTextMessage(openId, text) {
371
+ if (!this._client) return
372
+ try {
373
+ await this._client.im.message.create({
374
+ params: { receive_id_type: 'chat_id' },
375
+ data: {
376
+ receive_id: openId,
377
+ content: JSON.stringify({ text }),
378
+ msg_type: 'text'
379
+ }
380
+ })
381
+ } catch (err) {
382
+ log.error(' Failed to send text message:', err.message)
383
+ throw err
384
+ }
385
+ }
386
+
387
+ async _sendMessage(openId, text, originalMsg) {
388
+ if (!this._client) return
389
+ text=removeMarkdown(text)
390
+ try {
391
+ const chatId = originalMsg?.chat_id || originalMsg?.message?.chat_id
392
+ if (!chatId) return
393
+
394
+ await this._client.im.message.create({
395
+ params: { receive_id_type: 'chat_id' },
396
+ data: {
397
+ receive_id: chatId,
398
+ content: JSON.stringify({ text }),
399
+ msg_type: 'text'
400
+ }
401
+ })
402
+ } catch (err) {
403
+ log.error(' Failed to send message:', err.message)
404
+ }
405
+ }
406
+
407
+ _checkPermission(openId) {
408
+ return this.config.allowedUsers.length === 0 || this.config.allowedUsers.includes(openId)
409
+ }
410
+
411
+ _clearSession(openId) {
412
+ if (this._sessionPlugin) {
413
+ this._sessionPlugin.deleteSession(`feishu_${openId}`)
414
+ }
415
+ }
416
+
417
+ getStatus() {
418
+ let sessions = []
419
+ if (this._sessionPlugin) {
420
+ sessions = this._sessionPlugin.listSessions()
421
+ .filter(s => s.id.startsWith('feishu_'))
422
+ .map(s => ({
423
+ openId: s.id.replace('feishu_', ''),
424
+ historyLength: s.messageCount,
425
+ lastActive: s.lastActive
426
+ }))
427
+ }
428
+ return {
429
+ connected: !!this._wsClient,
430
+ sessionCount: sessions.length,
431
+ sessions,
432
+ config: {
433
+ appId: this.config.appId ? `${this.config.appId.substring(0, 10)}...` : null,
434
+ allowedUsersCount: this.config.allowedUsers.length
435
+ }
436
+ }
437
+ }
438
+
439
+ stopClient() {
440
+ if (this._wsClient) {
441
+ try { this._wsClient.close() } catch (e) { /* ignore */ }
442
+ this._wsClient = null
443
+ this._client = null
444
+ log.info(' Client stopped')
445
+ }
446
+ }
447
+
448
+ stop() {
449
+ this.stopClient()
450
+ }
451
+
452
+ reload(framework) {
453
+ this._framework = framework
454
+ this._initialized = false
455
+ this.stopClient()
456
+ this.start(framework)
457
+ }
458
+
459
+ uninstall() {
460
+ for (const agent of this._sessionAgents.values()) {
461
+ agent.destroy()
462
+ }
463
+ this._sessionAgents.clear()
464
+
465
+ if (this._messageCleanupInterval) {
466
+ clearInterval(this._messageCleanupInterval)
467
+ this._messageCleanupInterval = null
468
+ }
469
+ this._processedMessages.clear()
470
+
471
+ this.stopClient()
472
+ if (this._sessionPlugin && this._sessionDeleteHandler) {
473
+ this._sessionPlugin.off('session:deleted', this._sessionDeleteHandler)
474
+ this._sessionDeleteHandler = null
475
+ }
476
+ this._sessionPlugin = null
477
+ this._framework = null
478
+ }
479
+ }
480
+
481
+ module.exports = { FeishuPlugin }