Feishu Suite Skill
环境变量
FEISHU_APP_IDFEISHU_APP_SECRET
API 总览
文档/知识库/云空间 (Docs)
createDocument(title, folderToken?)getDocument(documentId)getDocumentRawContent(documentId)listDocumentBlocks(documentId, pageToken?, pageSize?)appendText(documentId, text, targetBlockId?)appendBlocks(documentId, blocks, targetBlockId?)getPublicPermission(token, type?)updatePublicPermission(token, type, data)addMemberPermission(token, type, memberId, memberType, role)listFiles(folderToken?, pageToken?, pageSize?)uploadFile(filePath, parentNode, fileName?)createFolder(name, folderToken)listWikiSpaces(pageToken?, pageSize?)getWikiSpace(spaceId)listWikiNodes(spaceId, parentNodeToken?, pageToken?, pageSize?)getNodeInfo(token)
表格/多维表格 (Data)
createSpreadsheet(title, folderToken?)getSpreadsheet(spreadsheetToken)getSheetValues(spreadsheetToken, sheetId, range)updateSheetValues(spreadsheetToken, sheetId, range, values)appendSheetValues(spreadsheetToken, sheetId, range, values)prependSheetValues(spreadsheetToken, sheetId, range, values)listRecords(appToken, tableId, filter?, sort?, pageToken?, pageSize?)getRecord(appToken, tableId, recordId)createRecord(appToken, tableId, fields)batchCreateRecords(appToken, tableId, records)updateRecord(appToken, tableId, recordId, fields)batchUpdateRecords(appToken, tableId, records)deleteRecord(appToken, tableId, recordId)batchDeleteRecords(appToken, tableId, recordIds)copyBitable(appToken, name, folderToken?)
IM 消息/话题/群聊 (IM)
listMessages(params)recallMessage(messageId)updateMessage(messageId, content)pinMessage(messageId)unpinMessage(messageId)react(messageId, emoji)sendAttachment(receiveId, receiveIdType, filePath, fileName?)replyInThread(messageId, content, replyInThread?, msgType?)listThreadMessages(chatId, threadId)getChatInfo(chatId)listChats(pageToken?, pageSize?)getChatMembers(chatId, memberIdType?, pageToken?, pageSize?)isInChat(chatId)createChat(params)addChatMembers(chatId, idList, memberIdType?)removeChatMembers(chatId, idList, memberIdType?)
组织/通讯录/日程/任务 (Org)
getUser(userId, userIdType?)getDepartment(departmentId, userIdType?)listDepartmentUsers(departmentId, pageToken?, pageSize?)getGroup(groupId, userIdType?)listCalendars(pageToken?, pageSize?)createCalendarEvent(calendarId, summary, startTime, endTime, description?)deleteCalendarEvent(calendarId, eventId)listTasks(pageToken?, pageSize?)createTask(summary, description?, dueTime?)completeTask(taskId)
AI 能力 (AI)
translateText(text, sourceLang, targetLang)detectLanguage(text)ocrImage(filePath)speechToText(filePath, format?)
💡 飞书协作最佳实践 (Best Practices)
1. 文档权限与 Fallback 策略
- 预先授权：在向他人发送飞书文档链接前，必须先通过
updatePublicPermission或addMemberPermission开启可读权限。 - 权限不足时的 Fallback (重要)：如果应用缺少
docs:permission.setting:write_only权限（报错 99991672），请采用以下方案：
- 方案 A (推荐)：父文件夹继承。在一个已公开的文件夹内创建文档，文档会自动继承文件夹的权限，无需额外调用权限 API。 - 方案 B：内容提取。若无法授权且必须即时交付，先将文档内容提取并通过 IM 消息（如 replyInThread）直接发送原文。 - 方案 C：知识库 (Wiki)。在已公开的知识库空间创建页面，通常不需要二次授权。
- 避免尴尬：严禁发送“对方无权查看”的文档，这会降低协作效率。
2. 沟通礼仪与情感
- 表情回复：积极使用飞书表情（
reactAPI）回复他人消息。适时的表情符号能传达温暖和认可，让对方感到开心。 - 话题回复：在群聊人数较多或讨论特定技术/细节时，优先使用
replyInThread。这样可以保持主聊天界面的整洁，避免刷屏打扰不相关的成员。 - 视情况而定：对于需要全员关注的重要通知，可以直接发到主群。