feishu-user-plugin 1.0.0

package/proto/lark.proto

@@ -0,0 +1,317 @@
+syntax = "proto3";
+
+// ============================================================
+// Feishu/Lark Internal Protobuf Protocol
+// Reverse-engineered from Feishu Web Client
+// Reference: https://github.com/cv-cat/LarkAgentX
+// ============================================================
+
+// --- Transport Layer ---
+
+message Frame {
+  optional uint64 seqid = 1;
+  optional uint64 logid = 2;
+  optional int32 service = 3;
+  optional int32 method = 4;
+  repeated ExtendedEntry headers = 5;
+  optional string payloadEncoding = 6;
+  optional string payloadType = 7;
+  optional bytes payload = 8;
+}
+
+message Packet {
+  optional string sid = 1;
+  optional PayloadType payloadType = 2;
+  optional int32 cmd = 3;
+  optional uint32 status = 4;
+  optional bytes payload = 5;
+  optional string cid = 6;
+}
+
+enum PayloadType {
+  TYPE_UNKNOWN = 0;
+  PB2 = 1;
+  JSON = 2;
+}
+
+message ExtendedEntry {
+  optional string key = 1;
+  optional string value = 2;
+}
+
+// --- Message Types ---
+
+enum Type {
+  UNKNOWN = 0;
+  POST = 2;
+  FILE = 3;
+  TEXT = 4;
+  IMAGE = 5;
+  SYSTEM = 6;
+  AUDIO = 7;
+  STICKER = 10;
+  CARD = 14;
+  MEDIA = 15;
+}
+
+enum FromType {
+  UNKNOWN_FROMTYPE = 0;
+  USER = 1;
+  BOT = 2;
+}
+
+enum ChatType {
+  UNKNOWN_CHAT_TYPE = 0;
+  P2P = 1;
+  GROUP = 2;
+  TOPIC_GROUP = 3;
+}
+
+// --- Send Message (cmd=5) ---
+
+message PutMessageRequest {
+  optional Type type = 1;
+  optional Content content = 2;
+  optional string chatId = 3;
+  optional string rootId = 4;
+  optional string parentId = 5;
+  optional string cid = 6;
+  optional bool isNotified = 7;
+  optional bool sendToChat = 8;
+  optional int32 version = 9;
+}
+
+// --- Receive Messages (WebSocket push) ---
+
+message PushMessagesRequest {
+  map<string, MessageEntity> messages = 1;
+  map<string, bool> participatedMessageIds = 3;
+  map<string, bool> forcePush = 8;
+  map<string, bool> messagesAtMe = 9;
+}
+
+message MessageEntity {
+  optional string id = 1;
+  optional Type type = 2;
+  optional string fromId = 3;
+  optional int64 createTime = 4;
+  optional bytes content = 5;
+  optional MessageStatus status = 6;
+  optional FromType fromType = 7;
+  optional string rootId = 8;
+  optional string parentId = 9;
+  optional string chatId = 10;
+  optional int64 lastModifyTime = 11;
+  optional string cid = 12;
+  optional int32 position = 13;
+  optional int64 updateTime = 14;
+  optional bool isNotified = 15;
+  optional string threadId = 20;
+  optional ChatType chatType = 46;
+
+  enum MessageStatus {
+    UNKNOWN_STATUS = 0;
+    NORMAL = 1;
+    DELETED = 2;
+    MODIFIED = 3;
+  }
+}
+
+// --- Content ---
+
+message Content {
+  optional string text = 1;
+  optional string imageKey = 2;
+  optional string title = 3;
+  optional string fileKey = 6;
+  optional string audioKey = 7;
+  optional string fileName = 11;
+  optional RichText richText = 14;
+  optional string stickerSetId = 24;
+  optional string stickerId = 25;
+}
+
+message TextContent {
+  optional string text = 1;
+  optional RichText richText = 3;
+}
+
+message RichText {
+  repeated string elementIds = 1;
+  optional string innerText = 2;
+  optional RichTextElements elements = 3;
+}
+
+message RichTextElements {
+  map<string, RichTextElement> dictionary = 1;
+}
+
+message RichTextElement {
+  optional Tag tag = 1;
+  map<string, string> style = 2;
+  optional bytes property = 3;
+  repeated string childIds = 4;
+
+  enum Tag {
+    UNKNOWN_TAG = 0;
+    TEXT = 1;
+    IMG = 2;
+    P = 3;
+    FIGURE = 4;
+    AT = 5;
+    A = 6;
+  }
+}
+
+message TextProperty {
+  optional string content = 1;
+}
+
+// --- Chat Operations ---
+
+// Create P2P chat (cmd=13)
+message PutChatRequest {
+  optional Type type = 1;
+  repeated string userIds = 2;
+  repeated string chatterIds = 6;
+}
+
+message PutChatResponse {
+  optional Chat chat = 1;
+}
+
+// Get group info (cmd=64)
+message GetGroupInfoRequest {
+  optional string chatId = 1;
+}
+
+message GetGroupInfoResponse {
+  optional Chat chat = 1;
+}
+
+message Chat {
+  optional string id = 1;
+  optional ChatTypeEnum type = 2;
+  optional string lastMessageId = 3;
+  optional string name = 4;
+  optional string ownerId = 6;
+  optional int32 newMessageCount = 7;
+  optional int64 updateTime = 9;
+  optional string description = 11;
+  optional int32 memberCount = 12;
+  optional bool isPublic = 14;
+  optional int32 lastMessagePosition = 15;
+  optional int32 userCount = 16;
+  optional int64 createTime = 18;
+  optional string tenantId = 25;
+  optional bool isDissolved = 30;
+  optional bool isCrossTenant = 41;
+  optional Announcement announcement = 24;
+
+  enum ChatTypeEnum {
+    UNKNOWN_CHAT = 0;
+    P2P_CHAT = 1;
+    GROUP_CHAT = 2;
+    TOPIC_GROUP_CHAT = 3;
+  }
+
+  message Announcement {
+    optional string content = 1;
+    optional int64 updateTime = 2;
+    optional string lastEditorId = 3;
+    optional string docUrl = 4;
+  }
+}
+
+// --- Search (cmd=11021) ---
+
+message UniversalSearchRequest {
+  optional SearchCommonRequestHeader header = 1;
+}
+
+message SearchCommonRequestHeader {
+  optional string searchSession = 1;
+  optional int32 sessionSeqId = 2;
+  optional string query = 3;
+  optional string paginationToken = 4;
+  optional SearchContext searchContext = 5;
+  optional string locale = 6;
+  optional int32 pageSize = 11;
+
+  message SearchContext {
+    optional string tagName = 1;
+    repeated EntityItem entityItems = 2;
+    optional CommonFilter commonFilter = 3;
+    optional string sourceKey = 5;
+  }
+}
+
+message EntityItem {
+  optional SearchEntityType type = 1;
+  optional EntityFilter filter = 2;
+
+  message EntityFilter {
+    oneof filter {
+      GroupChatFilter groupChatFilter = 2;
+    }
+  }
+}
+
+message GroupChatFilter {}
+
+message CommonFilter {
+  optional bool includeOuterTenant = 1;
+}
+
+enum SearchEntityType {
+  SEARCH_UNKNOWN = 0;
+  SEARCH_USER = 1;
+  SEARCH_BOT = 2;
+  SEARCH_GROUP_CHAT = 3;
+}
+
+message UniversalSearchResponse {
+  optional SearchResponseHeader header = 1;
+  repeated SearchResult results = 2;
+}
+
+message SearchResponseHeader {
+  optional int32 total = 3;
+  optional bool hasMore = 4;
+}
+
+message SearchResult {
+  optional string id = 1;
+  optional SearchEntityType type = 2;
+  optional string titleHighlighted = 3;
+  optional string summaryHighlighted = 4;
+  optional string avatarKey = 6;
+}
+
+// --- User Info (cmd=5023) ---
+
+message GetUserInfoRequest {
+  optional int64 chatId = 1;
+  optional int64 userId = 3;
+  optional int32 userType = 4;
+}
+
+message UserInfo {
+  optional UserInfoDetail userInfoDetail = 1;
+}
+
+message UserInfoDetail {
+  optional Detail detail = 2;
+}
+
+message Detail {
+  optional bytes nickname = 2;
+  optional bytes nickname1 = 4;
+  optional bytes nickname4 = 17;
+  repeated LocaleEntry locales = 18;
+}
+
+message LocaleEntry {
+  optional string key_string = 1;
+  optional string translation = 2;
+}

package/skills/feishu-user-plugin/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: feishu-user-plugin
+version: "1.0.0"
+description: "All-in-one Feishu plugin — send messages as yourself, read group/P2P chats, manage docs/tables/wiki. Replaces and extends the official Feishu MCP."
+allowed-tools: send_to_user, send_to_group, send_as_user, send_image_as_user, send_file_as_user, send_post_as_user, send_sticker_as_user, send_audio_as_user, search_contacts, create_p2p_chat, get_chat_info, get_user_info, get_login_status, read_p2p_messages, list_user_chats, list_chats, read_messages, reply_message, forward_message, search_docs, read_doc, create_doc, list_bitable_tables, list_bitable_fields, search_bitable_records, create_bitable_record, update_bitable_record, list_wiki_spaces, search_wiki, list_wiki_nodes, list_files, create_folder, find_user
+user_invocable: true
+---
+
+# Feishu User Plugin
+
+All-in-one Feishu plugin for Claude Code with three auth layers:
+- **User Identity** (cookie auth): Send messages as yourself — text, image, file, rich text, sticker, audio
+- **Official API** (app credentials): Read group messages, docs, tables, wiki, drive, contacts
+- **User OAuth** (user_access_token): Read P2P (direct message) chat history
+
+This plugin replaces and extends the official Feishu MCP. No need to install two packages.
+
+## Trigger Conditions
+
+Activate when the user mentions:
+- Sending Feishu messages ("发飞书消息给 XXX", "send a message to XXX on Feishu")
+- Reading Feishu chats ("读飞书群聊 / 单聊", "read Feishu chat history")
+- Feishu documents ("搜飞书文档", "search Feishu docs")
+- Feishu tables ("查飞书表格", "query Bitable")
+- Feishu wiki ("搜飞书知识库", "search wiki")
+- Login status ("飞书登录状态", "check Feishu login")
+
+## 9 Built-in Skills
+
+### /send — Send message as yourself
+Parse "recipient: message" format, auto-detect user vs group, confirm before sending.
+
+### /reply — Read messages and reply
+Search chat → read recent messages → show summary → user picks a message → reply.
+
+### /digest — Chat message digest
+Search chat → read N days of messages → filter valuable content → summarize key insights.
+
+### /search — Search contacts
+Search users and groups by name, display results grouped by type.
+
+### /doc — Document operations
+Search (search_docs), read (read_doc), create (create_doc) — three in one.
+
+### /table — Bitable operations
+Query (list tables → list fields → search records), create records, update records.
+
+### /wiki — Wiki management
+List spaces (list_wiki_spaces), search content (search_wiki), browse nodes (list_wiki_nodes).
+
+### /drive — Drive file management
+List files in folders, create new folders in Feishu Drive.
+
+### /status — Check login status
+Check cookie / app credentials / UAT — all three auth layers at once.
+
+## Auth Configuration
+
+| Env Variable | Who Provides | Purpose | Required |
+|---|---|---|---|
+| LARK_COOKIE | **You** | Send messages as yourself | Yes (for messaging) |
+| LARK_APP_ID | **You** (create a Feishu app) | Official API access | Yes |
+| LARK_APP_SECRET | **You** (from your Feishu app) | Official API access | Yes |
+| LARK_USER_ACCESS_TOKEN | **You** (OAuth flow, optional) | Read P2P chat history | Optional |
+
+### Getting Your Cookie (Automated via Playwright)
+
+**Prerequisite: Playwright MCP must be installed.** If not, run:
+```
+npx @anthropic-ai/claude-code mcp add playwright -- npx @anthropic-ai/mcp-server-playwright
+```
+Then restart Claude Code.
+
+**Automated flow (recommended, zero manual cookie copying):**
+> Just tell Claude Code: "Help me set up my Feishu cookie"
+>
+> Claude Code will automatically:
+> 1. Open feishu.cn in a browser via Playwright
+> 2. Show you the QR code — scan it with Feishu mobile app
+> 3. Extract the full cookie (including HttpOnly) via `context.cookies()`
+> 4. Write it to your `.mcp.json` LARK_COOKIE field
+> 5. Prompt you to restart Claude Code
+
+**Manual fallback (if Playwright is unavailable):**
+1. Open https://www.feishu.cn/messenger/ and log in
+2. DevTools → **Network** tab → Disable cache → Reload
+3. Click the first request → Request Headers → **Cookie** → right-click → Copy value
+4. Paste into your `.mcp.json` env `LARK_COOKIE` field
+
+> Do NOT use `document.cookie` or Application → Cookies — they miss HttpOnly cookies required for auth.
+
+### Creating a Feishu App (for Official API)
+
+1. Go to https://open.feishu.cn/app → Create Custom App (自建应用)
+2. Add scopes: `im:message`, `im:message:readonly`, `im:chat:readonly`, `contact:user.base:readonly`
+3. Copy the App ID and App Secret to your `.mcp.json`
+4. Add the bot to any group chats you want to read
+
+## Known Limitations
+
+- Image/file sending requires uploading via Official API first to get keys
+- CARD message type (type=14) not yet supported
+- Cookie session valid for ~12h, auto-refreshed via built-in heartbeat (4h interval)

package/skills/feishu-user-plugin/references/CLAUDE.md

@@ -0,0 +1,94 @@
+# feishu-user-plugin — Claude Code Instructions
+
+## What This Is
+All-in-one Feishu plugin for Claude Code with three auth layers:
+- **User Identity** (cookie auth): Send messages (text, image, file, post, sticker, audio) as yourself
+- **Official API** (app credentials): Read group messages, docs, tables, wiki, drive, contacts
+- **User OAuth UAT** (user_access_token): Read P2P chat history
+
+## Tool Categories
+
+### User Identity — Messaging (reverse-engineered, cookie-based)
+- `send_to_user` — Search user + send text (one step, most common)
+- `send_to_group` — Search group + send text (one step)
+- `send_as_user` — Send text to any chat by ID, supports reply threading (root_id/parent_id)
+- `send_image_as_user` — Send image (requires image_key from upload)
+- `send_file_as_user` — Send file (requires file_key from upload)
+- `send_post_as_user` — Send rich text with title + formatted paragraphs
+- `send_sticker_as_user` — Send sticker/emoji
+- `send_audio_as_user` — Send audio message
+
+### User Identity — Contacts & Info
+- `search_contacts` — Search users/groups by name
+- `create_p2p_chat` — Create/get P2P chat
+- `get_chat_info` — Group details (name, members, owner)
+- `get_user_info` — User display name lookup (from search cache)
+- `get_login_status` — Check cookie, app, and UAT status
+
+### User OAuth UAT Tools (P2P chat reading)
+- `read_p2p_messages` — Read P2P (direct message) chat history. Requires OAuth setup.
+- `list_user_chats` — List group chats the user is in. Note: API only returns groups, not P2P. For P2P, use: `search_contacts` → `create_p2p_chat` → `read_p2p_messages`.
+
+### Official API Tools (app credentials)
+- `list_chats` / `read_messages` — Chat history (read_messages accepts chat name, auto-resolves to oc_ ID)
+- `reply_message` / `forward_message` — Message operations (as bot). reply_message only works for text messages.
+- `search_docs` / `read_doc` / `create_doc` — Document operations
+- `list_bitable_tables` / `list_bitable_fields` / `search_bitable_records` — Table queries
+- `create_bitable_record` / `update_bitable_record` — Table writes
+- `list_wiki_spaces` / `search_wiki` / `list_wiki_nodes` — Wiki
+- `list_files` / `create_folder` — Drive
+- `find_user` — Contact lookup by email/mobile
+
+## Usage Patterns
+- Send text as yourself → `send_to_user` or `send_to_group`
+- Send rich content → `send_post_as_user` (formatted text), `send_image_as_user` (images)
+- Read group chat history → `read_messages` with chat name or oc_ ID
+- Read P2P chat history → `search_contacts` → `create_p2p_chat` → `read_p2p_messages` (requires OAuth UAT)
+- Reply as user in thread → `send_as_user` with root_id
+- Reply as bot → `reply_message` (official API, text messages only)
+- Diagnose issues → `get_login_status` first
+
+## Auth & Session
+- **LARK_COOKIE**: Required for user identity tools. Session auto-refreshed every 4h via heartbeat.
+- **LARK_APP_ID + LARK_APP_SECRET**: Required for official API tools.
+- **LARK_USER_ACCESS_TOKEN**: Required for P2P reading. Obtained via OAuth flow. Auto-refreshed via refresh_token.
+
+## Automated Cookie Setup via Playwright
+
+When LARK_COOKIE is missing or expired, automatically obtain it using Playwright MCP.
+Do NOT ask the user to manually copy cookies from DevTools.
+
+### Prerequisites
+Playwright MCP must be available. If not, tell the user:
+> Run: `npx @anthropic-ai/claude-code mcp add playwright -- npx @anthropic-ai/mcp-server-playwright`
+> Then restart Claude Code.
+
+### Automated Flow
+1. `browser_navigate` → `https://www.feishu.cn/messenger/`
+2. `browser_take_screenshot` → show QR code to user, ask them to scan with Feishu app
+3. Poll `browser_snapshot` every 3-5s until messenger page loads
+4. `browser_run_code`:
+   ```js
+   const cookies = await context.cookies('https://www.feishu.cn');
+   const feishuCookies = cookies.filter(c => c.domain.endsWith('feishu.cn'));
+   const cookieStr = feishuCookies.map(c => c.name + '=' + c.value).join('; ');
+   ```
+5. Read user's `.mcp.json`, update `LARK_COOKIE` value
+6. Tell user to restart Claude Code
+
+### Cookie Refresh
+When cookie auth fails, offer to re-run the Playwright flow. Heartbeat auto-refreshes every 4h.
+
+## Troubleshooting
+
+### If cookie authentication fails
+- **Best method**: Playwright `context.cookies()` (includes HttpOnly)
+- **Manual fallback**: Network tab → Disable cache → reload → first request → Request Headers → Cookie → Copy value
+- Do NOT use `document.cookie` or Application → Cookies (misses HttpOnly cookies)
+
+### If list_user_chats doesn't return P2P chats
+- This is expected — the Feishu API only returns group chats at this endpoint.
+- Use the P2P flow: `search_contacts` → `create_p2p_chat` → `read_p2p_messages`.
+
+### If reply_message fails with error 230054
+- "This operation is not supported for this message type" — only text messages can be replied to.

package/skills/feishu-user-plugin/references/digest.md

@@ -0,0 +1,26 @@
+整理飞书群聊或单聊的最近消息。
+
+## 参数
+- $ARGUMENTS：聊天名关键词，可选指定天数（默认 3 天）
+
+## 执行步骤
+
+### 群聊摘要
+1. 用 `read_messages` 读取最近 N 天的消息（传群名自动解析，计算 start_time 时间戳）
+2. 按以下标准筛选有价值内容：
+   - 包含可操作的具体方法论或工具推荐 → 高价值
+   - 包含带数据支撑的趋势分析 → 高价值
+   - 包含可复现的实践经验 → 高价值
+   - 纯寒暄/水聊 → 跳过
+3. 向用户汇报：共读取 X 条，筛选 Y 条有价值内容，涉及的主题分类
+4. 等用户确认后，用自己的语言概括核心观点
+
+### 单聊摘要
+1. 用 `search_contacts` 搜索对方 → `create_p2p_chat` 获取 chat_id
+2. 用 `read_p2p_messages` 读取消息
+3. 按同样标准筛选和汇总
+
+## 注意
+- 群聊需要机器人在群内
+- 单聊需要 OAuth UAT 授权
+- 如有外部链接可用 Playwright 抓取全文

package/skills/feishu-user-plugin/references/doc.md

@@ -0,0 +1,27 @@
+操作飞书云文档：搜索、读取或创建。
+
+## 参数
+- $ARGUMENTS：操作类型 + 文档标识或内容
+
+## 执行步骤
+
+### 搜索文档
+1. 用 `search_docs` 搜索关键词
+2. 展示文档列表（标题、文档 ID）
+
+### 读取文档
+1. 用 `read_doc` 读取文档内容（传入 document_id）
+2. 展示内容摘要
+
+### 创建文档
+1. 用 `create_doc` 创建新文档（传入标题和可选 folder_id）
+2. 返回文档 ID
+
+## 示例
+- `/doc search MCP 协议`
+- `/doc read doxcnXXXXXX`
+- `/doc create 本周工作总结`
+
+## 注意
+- 文档操作使用 Official API（需要 LARK_APP_ID）
+- 搜索结果受机器人权限范围限制

package/skills/feishu-user-plugin/references/drive.md

@@ -0,0 +1,24 @@
+管理飞书云盘文件和文件夹。
+
+## 参数
+- $ARGUMENTS：操作类型 + 文件夹标识
+
+## 执行步骤
+
+### 列出文件
+1. 用 `list_files` 列出文件夹内容
+   - 不传 folder_token 则列出根目录
+   - 传入 folder_token 则列出指定文件夹
+
+### 创建文件夹
+1. 用 `create_folder` 创建新文件夹
+   - 传入 name 和可选的 parent_token
+
+## 示例
+- `/drive list` — 列出根目录文件
+- `/drive list folderXxx` — 列出指定文件夹
+- `/drive create 项目资料` — 在根目录创建文件夹
+
+## 注意
+- 使用 Official API，需要 LARK_APP_ID
+- 文件列表受机器人权限范围限制

package/skills/feishu-user-plugin/references/reply.md

@@ -0,0 +1,23 @@
+读取飞书聊天的最近消息并回复。
+
+## 参数
+- $ARGUMENTS：群名关键词或 chat_id，可选指定消息数量（默认 10 条）
+
+## 执行步骤
+
+### 群聊消息
+1. 用 `read_messages` 读取消息（直接传群名，会自动搜索解析为 oc_ ID）
+2. 向用户展示最近 N 条消息摘要（标注发送人和时间）
+3. 用户指定要回复哪条消息后，用 `reply_message` 回复（以机器人身份）
+4. 如需以个人身份回复，用 `send_as_user` 并传 `root_id`（话题回复）
+
+### 单聊消息（P2P）
+1. 用 `search_contacts` 搜索对方用户名
+2. 用 `create_p2p_chat` 获取单聊 chat_id（数字格式）
+3. 用 `read_p2p_messages` 读取历史消息（需要 OAuth UAT）
+4. 如需回复，用 `send_as_user` 发送
+
+## 注意
+- 群聊读取用 `read_messages`（Official API，机器人需在群内）
+- 单聊读取用 `read_p2p_messages`（User OAuth，需要 UAT 授权）
+- `reply_message` 只能回复**文本类型**消息，其他类型会返回 230054 错误

package/skills/feishu-user-plugin/references/search.md

@@ -0,0 +1,22 @@
+搜索飞书联系人或群组。
+
+## 参数
+- $ARGUMENTS: 搜索关键词
+
+## 执行步骤
+1. 使用 `search_contacts` 搜索 $ARGUMENTS
+2. 将结果按类型分组展示：
+   - 用户（user）：显示名称和 ID
+   - 群组（group）：显示群名和 ID
+   - 机器人（bot）：显示名称和 ID
+3. 提示用户可用的后续操作：
+   - `/send 用户名: 消息` 发送消息
+   - `/reply 群名` 读取群聊并回复
+   - `/digest 群名` 整理聊天摘要
+
+## 通过邮箱或手机号查找
+如果用户提供了邮箱或手机号，改用 `find_user`：
+```
+find_user({ email: "xxx@xxx.com" })
+find_user({ mobile: "+86xxx" })
+```

package/skills/feishu-user-plugin/references/send.md

@@ -0,0 +1,28 @@
+以你本人的飞书身份发送消息（非机器人）。
+
+## 参数
+- $ARGUMENTS：收件人和消息内容，格式："收件人: 消息内容"
+
+## 执行步骤
+1. 解析 $ARGUMENTS，以第一个冒号分离收件人和消息内容
+2. 判断收件人类型：
+   - 如果是人名 → 使用 `send_to_user`（自动搜索用户 → 创建单聊 → 发送）
+   - 如果是群名 → 使用 `send_to_group`（自动搜索群 → 发送）
+   - 如果是 chat_id（纯数字）→ 使用 `send_as_user`
+3. 发送前向用户确认收件人和消息内容
+4. 发送并返回结果
+
+## 富文本消息
+如果消息包含格式化需求（加粗、链接、@人），改用 `send_post_as_user`：
+```
+send_post_as_user({
+  chat_id: "xxx",
+  title: "标题（可选）",
+  paragraphs: [[{tag:"text",text:"普通文本"}, {tag:"text",text:"加粗",style:["bold"]}]]
+})
+```
+
+## 注意
+- 消息以你的**个人飞书身份**发送，不是机器人
+- 支持发送给个人（单聊）和群组
+- 如需回复某条消息的话题，用 `send_as_user` 并传 `root_id`

package/skills/feishu-user-plugin/references/status.md

@@ -0,0 +1,22 @@
+检查飞书所有认证层的登录状态。
+
+## 执行步骤
+
+1. 使用 `get_login_status` 检查三层认证状态：
+   - **Cookie 会话**：是否有效，当前登录用户
+   - **App 凭证**：LARK_APP_ID / LARK_APP_SECRET 是否配置
+   - **User Access Token**：UAT 是否可用（P2P 单聊读取需要）
+
+2. 根据结果给出建议：
+   - Cookie 过期 → 提示用 Playwright 自动获取新 Cookie
+   - App 凭证缺失 → 提示配置 .mcp.json
+   - UAT 缺失 → 提示运行 `npx feishu-user-plugin oauth`
+
+## Cookie 自动获取（Playwright）
+如果 Cookie 过期且 Playwright MCP 可用：
+1. `browser_navigate` → `https://www.feishu.cn/messenger/`
+2. `browser_take_screenshot` → 展示二维码让用户扫码
+3. 轮询 `browser_snapshot` 直到登录成功
+4. `browser_run_code`: `const cookies = await context.cookies('https://www.feishu.cn'); cookies.filter(c => c.domain.endsWith('feishu.cn')).map(c => c.name + '=' + c.value).join('; ')`
+5. 更新 `.mcp.json` 中的 LARK_COOKIE
+6. 提示重启 Claude Code