Feishu (Lark)

🚀 使用指南

本指南詳細介紹瞭如何安裝、配置和使用相關項目，幫助你快速上手並解決可能遇到的問題。

🚀 快速開始

按照以下步驟，你可以快速完成項目的安裝與啟動：

1. 克隆倉庫。
2. 執行 pnpm install 安裝依賴。
3. 複製 .env.example 為 .env 並填入飛書應用憑證。
4. 使用 pnpm run dev 啟動服務器，可使用命令行參數。

📦 安裝指南

安裝依賴

克隆倉庫後，在項目根目錄下執行以下命令安裝所需依賴：

pnpm install

配置環境變量

複製 .env.example 文件為 .env，並根據實際情況填入飛書應用憑證：

• FEISHU_APP_ID：飛書應用 ID（必填）
• FEISHU_APP_SECRET：飛書應用密鑰（必填）
• PORT：服務器運行端口，默認為 3333

啟動服務器

使用以下命令啟動服務器，可根據需要使用命令行參數：

pnpm run dev

📚 詳細文檔

配置指南

環境變量配置

命令行參數

連接配置

若要在 Cursor 中使用該服務，需進行如下連接配置：

1. 打開 Cursor 設置。
2. 進入 Settings > AI > MCP Servers。
3. 添加新服務器，URL 設為 http://localhost:3333（或自定義端口）。
4. 點擊 "Verify Connection" 驗證連接狀態。

使用方法

在 Cursor 中使用該服務的具體步驟如下：

1. 在 Cursor 中打開 AI 面板（默認快捷鍵：Cmd+K 或 Ctrl+K）。
2. 新建飛書文檔時需指定 folderToken，例如訪問文件夾鏈接如：https://vq5xxxxx7bc.feishu.cn/drive/folder/FPKvfjdxxxxx706RnOc查找。
3. 修改文檔內容時需提供具體的文檔鏈接，例如：https://vq5ixxxx7bc.feishu.cn/docx/J6T0d6exxxxxxxDdc1zqwnph。
4. 提問或請求基於文檔內容的操作。

權限配置與問題排查

權限類型

• 機器人權限
• 文檔訪問權限

權限驗證與排查

• 獲取 token：https://open.feishu.cn/api-explorer/cli_a75a8ca0ac79100c?apiName=tenant_access_token_internal&from=op_doc&project=auth&resource=auth&version=v3
• 使用 token 驗證文檔訪問權限：https://open.feishu.cn/api-explorer/cli_a7582508c93ad16b?apiName=tenant_access_token_internal&from=op_doc&project=auth&resource=auth&version=v3

注意事項

⚠️ 重要提示

• 確保應用有足夠權限。
• 文檔鏈接需正確無誤。
• 查看控制檯輸出日誌。

附加信息

• 支持的命令行工具：pnpm、npm。
• 配置示例：.env 文件內容。
• 調試指南：如何排查問題。