feishu-user-plugin 1.0.1 → 1.0.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "feishu-user-plugin",
-  "version": "1.0.0",
-  "description": "All-in-one Feishu plugin for Claude Code — send messages as yourself, read chats, manage docs/tables/wiki. 33 tools + 8 skills, 3 auth layers.",
+  "version": "1.0.2",
+  "description": "All-in-one Feishu plugin for Claude Code — send messages as yourself, read chats, manage docs/tables/wiki. 33 tools + 9 skills, 3 auth layers.",
   "author": {
     "name": "EthanQC"
   },

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.0.2] - 2026-03-10
+
+### Fixed
+- `list_user_chats` description incorrectly claimed "including P2P" — actually only returns groups
+- OAuth scope `contact:user.id:readonly` → `contact:user.base:readonly` in README
+- Cookie length validation range (500-5000, was 1000-5000)
+- Version inconsistency across `server.json`, `plugin.json`, `SKILL.md`, `src/index.js`
+- Skill count: 8 → 9 (was missing `/drive`)
+- README_CN.md Claude Desktop config missing `env` block
+
+### Added
+- Startup auth diagnostics in `src/index.js` (Cookie/App/UAT status logging)
+- `LARK_USER_REFRESH_TOKEN` to all MCP config examples
+- Troubleshooting for `invalid_grant` errors (28003/20003/20005)
+- Troubleshooting for `oauth.js` requiring APP_ID/SECRET in `.env`
+- Playwright cookie setup: two-step extraction, `clearCookies()`, ASCII validation
+- `LARK_USER_REFRESH_TOKEN` to `server.json` environment_variables
+
+### Changed
+- All 5 env vars marked as required for full functionality
+- Improved `read_p2p_messages` chat_id description (numeric + oc_xxx both accepted)
+
 ## [1.0.0] - 2026-03-09
 
 ### Changed

package/README.md

@@ -6,7 +6,7 @@
 [![Tools](https://img.shields.io/badge/Tools-33-orange.svg)](#tools-33-total)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
-**All-in-one Feishu/Lark MCP Server -- 33 tools, 8 skills, 3 auth layers for messaging, docs, tables, wiki, and drive.**
+**All-in-one Feishu/Lark MCP Server -- 33 tools, 9 skills, 3 auth layers for messaging, docs, tables, wiki, and drive.**
 
 The only MCP server that lets you send messages as your **personal identity** (not a bot), while also integrating the full official Feishu API for documents, spreadsheets, wikis, and more.
 
@@ -82,7 +82,7 @@ Go to **Permissions & Scopes** (权限管理) and add the following scopes:
 | `bitable:record` | Read and write Bitable records |
 | `wiki:wiki:readonly` | Read wiki spaces and nodes |
 | `drive:drive:readonly` | List Drive files and folders |
-| `contact:user.id:readonly` | Look up users by email/mobile |
+| `contact:user.base:readonly` | Look up users by email/mobile |
 
 > Add more scopes as needed depending on which tools you use.
 
@@ -338,7 +338,7 @@ Send messages as yourself, not as a bot.
 | Tool | Description |
 |------|-------------|
 | `read_p2p_messages` | Read P2P (direct message) history. Works for chats the bot cannot access. |
-| `list_user_chats` | List all chats the user is in, including P2P. |
+| `list_user_chats` | List group chats the user is in. Note: only returns groups, not P2P. |
 
 ### Official API -- IM (Bot Identity)
 
@@ -388,9 +388,9 @@ Send messages as yourself, not as a bot.
 |------|-------------|
 | `find_user` | Find user by email or mobile number |
 
-## Claude Code Slash Commands (8 skills)
+## Claude Code Slash Commands (9 skills)
 
-This plugin includes 8 built-in skills in `skills/feishu-user-plugin/`:
+This plugin includes 9 built-in skills in `skills/feishu-user-plugin/`:
 
 | Skill | Usage | Description |
 |-------|-------|-------------|
@@ -401,6 +401,7 @@ This plugin includes 8 built-in skills in `skills/feishu-user-plugin/`:
 | `/doc` | `/doc search MCP` | Search, read, or create documents |
 | `/table` | `/table query appXxx` | Query or create Bitable records |
 | `/wiki` | `/wiki search protocol` | Search and browse wiki |
+| `/drive` | `/drive list folderToken` | List files or create folders in Drive |
 | `/status` | `/status` | Check login and auth status |
 
 Skills are automatically available when the plugin is installed.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feishu-user-plugin",
-  "version": "1.0.1",
-  "description": "All-in-one Feishu plugin for Claude Code — send messages as yourself, read chats, manage docs/tables/wiki. 33 tools + 8 skills, 3 auth layers.",
+  "version": "1.0.2",
+  "description": "All-in-one Feishu plugin for Claude Code — send messages as yourself, read chats, manage docs/tables/wiki. 33 tools + 9 skills, 3 auth layers.",
   "main": "src/index.js",
   "bin": {
     "feishu-user-plugin": "src/index.js"

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

@@ -1,6 +1,6 @@
 ---
 name: feishu-user-plugin
-version: "1.0.0"
+version: "1.0.2"
 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

package/src/index.js

@@ -490,7 +490,7 @@ const TOOLS = [
 // --- Server ---
 
 const server = new Server(
-  { name: 'feishu-user-plugin', version: '1.0.0' },
+  { name: 'feishu-user-plugin', version: '1.0.2' },
   { capabilities: { tools: {} } }
 );
 
@@ -696,7 +696,7 @@ async function main() {
   const hasCookie = !!process.env.LARK_COOKIE;
   const hasApp = !!(process.env.LARK_APP_ID && process.env.LARK_APP_SECRET);
   const hasUAT = !!process.env.LARK_USER_ACCESS_TOKEN;
-  console.error(`[feishu-user-plugin] MCP Server v1.0.1 — ${TOOLS.length} tools`);
+  console.error(`[feishu-user-plugin] MCP Server v1.0.2 — ${TOOLS.length} tools`);
   console.error(`[feishu-user-plugin] Auth: Cookie=${hasCookie ? 'YES' : 'NO'} App=${hasApp ? 'YES' : 'NO'} UAT=${hasUAT ? 'YES' : 'NO'}`);
   if (!hasCookie) console.error('[feishu-user-plugin] WARNING: LARK_COOKIE not set — user identity tools (send_to_user, etc.) will fail');
   if (!hasApp) console.error('[feishu-user-plugin] WARNING: LARK_APP_ID/SECRET not set — official API tools (read_messages, docs, etc.) will fail');

package/src/test-comprehensive.js

@@ -274,7 +274,7 @@ async function testUAT() {
 }
 
 async function main() {
-  console.log('=== feishu-user-plugin v1.0.0 — Comprehensive Test ===\n');
+  console.log('=== feishu-user-plugin v1.0.2 — Comprehensive Test ===\n');
 
   await testUserIdentity();
   console.log('');