feishu-mcp 0.2.2 → 0.2.7

package/dist/types/taskSchema.js

@@ -0,0 +1,166 @@
+/**
+ * 任务模块 Schema 定义（task/v2 API）
+ *
+ * ## Schema 描述规范
+ *
+ * 明确必填/可选、格式与示例，表述简洁。
+ */
+import { z } from 'zod';
+/** 任务 GUID（必填）。任务全局唯一标识，最大 100 字符。 */
+export const TaskGuidSchema = z
+    .string()
+    .min(1)
+    .max(100)
+    .describe('Task GUID (required). Global unique ID of the task. Max 100 characters.');
+/** 父任务 GUID（可选）。填写则在父任务下创建子任务，需具备父任务编辑权限。 */
+export const TaskParentTaskGuidSchema = TaskGuidSchema.optional().describe('Parent task GUID (optional). When set, creates a subtask under this task; requires edit permission on the parent.');
+/** 批量删除时的任务 GUID 列表。最少 1 个，最多 50 个。 */
+export const TaskDeleteBatchSchema = z
+    .array(TaskGuidSchema)
+    .min(1)
+    .max(50)
+    .describe('Task GUIDs to delete (required). Min 1, max 50 per call. Requires edit permission on each task.');
+/** 任务标题（必填）。最大 3000 UTF-8 字符。 */
+export const TaskSummarySchema = z
+    .string()
+    .min(1)
+    .max(3000)
+    .describe('Task title (required). Max 3000 UTF-8 characters.');
+/** 任务描述（可选）。最大 3000 UTF-8 字符。 */
+export const TaskDescriptionSchema = z
+    .string()
+    .max(3000)
+    .optional()
+    .describe('Task description (optional). Max 3000 UTF-8 characters.');
+/** 时间戳，毫秒，自 1970-01-01 00:00:00 UTC 起。 */
+export const TaskTimestampSchema = z
+    .string()
+    .optional()
+    .describe('Timestamp in milliseconds since 1970-01-01 00:00:00 UTC. Example: "1675454764000".');
+/** 是否全天（仅日期）。 */
+export const TaskIsAllDaySchema = z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe('Whether the time is all-day. If true, only the date part of timestamp is used.');
+/** 任务截止时间。 */
+export const TaskDueSchema = z
+    .object({
+    timestamp: TaskTimestampSchema,
+    is_all_day: TaskIsAllDaySchema,
+})
+    .optional()
+    .describe('Task due time (optional). Set timestamp and is_all_day.');
+/** 任务开始时间。若与 due 同时设置，start 须 <= due 且 is_all_day 一致。 */
+export const TaskStartSchema = z
+    .object({
+    timestamp: TaskTimestampSchema,
+    is_all_day: TaskIsAllDaySchema,
+})
+    .optional()
+    .describe('Task start time (optional). If set with due, start must be <= due and is_all_day must match.');
+/** 成员角色：assignee（负责人）或 follower（关注者）。 */
+export const TaskMemberRoleSchema = z
+    .enum(['assignee', 'follower'])
+    .describe('Member role: "assignee" for owner, "follower" for watcher.');
+/** 任务成员（负责人或关注者）。id 为 get_feishu_users 返回的 open_id。 */
+export const TaskMemberSchema = z.object({
+    id: z.string().min(1).describe('User open_id (required). Use open_id from get_feishu_users.'),
+    type: z.literal('user').optional().default('user'),
+    role: TaskMemberRoleSchema,
+    name: z.string().optional().describe('Member display name (optional).'),
+});
+/** 任务成员列表，最多 50 人（去重）。 */
+export const TaskMembersSchema = z
+    .array(TaskMemberSchema)
+    .max(50)
+    .optional()
+    .describe('Task members: assignees and followers (optional). Max 50. Use open_id from get_feishu_users.');
+/** 负责人 open_id 列表（可选）。来自 search_feishu_users，最多 50。 */
+export const TaskAssigneeIdsSchema = z
+    .array(z.string().min(1))
+    .max(50)
+    .optional()
+    .describe('Assignee open_ids (optional). Use open_id from get_feishu_users. Max 50.');
+/** 关注者 open_id 列表（可选）。来自 search_feishu_users，最多 50。 */
+export const TaskFollowerIdsSchema = z
+    .array(z.string().min(1))
+    .max(50)
+    .optional()
+    .describe('Follower open_ids (optional). Use open_id from get_feishu_users. Max 50.');
+/** 提醒相对截止时间的分钟数（可选）。0=截止时提醒，30=截止前30分钟。非负整数。任务需先有 due；当前每任务仅支持 1 个提醒，已有提醒时需先移除再添加。 */
+export const TaskReminderRelativeMinutesSchema = z
+    .number()
+    .int()
+    .min(0)
+    .optional()
+    .describe('Reminder: minutes before due (0 = at due time, 30 = 30 min before). Task must have due; only one reminder per task—remove existing first if needed.');
+/** 要移除的提醒 id 列表（可选）。id 来自任务详情的 reminders[].id。 */
+export const TaskReminderIdsSchema = z
+    .array(z.string().min(1))
+    .optional()
+    .describe('Reminder ids to remove (from task.reminders[].id).');
+/** 列取任务列表的分页标记（可选）。首次不传，后续用上响应的 page_token。 */
+export const TaskListPageTokenSchema = z
+    .string()
+    .optional()
+    .describe('Page token for list tasks (omit on first request; use page_token from previous response for next page).');
+/** 列取任务时按完成状态过滤（可选）。true=仅已完成，false=仅未完成，不传=不过滤。 */
+export const TaskListCompletedSchema = z
+    .boolean()
+    .optional()
+    .describe('Filter by completion: true = only completed, false = only todo, omit = no filter.');
+/** 重复规则。如 "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR"。 */
+export const TaskRepeatRuleSchema = z
+    .string()
+    .max(1000)
+    .optional()
+    .describe('Recurrence rule (optional). Example: "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR".');
+/** 完成时间戳（毫秒）。不填或 "0" 表示未完成。 */
+export const TaskCompletedAtSchema = z
+    .string()
+    .optional()
+    .describe('Completion timestamp in ms (optional). Omit or "0" = unfinished; set to create a completed task.');
+/** 任务模式：1 = 会签（均需完成），2 = 或签（任一人完成即可）。默认 2。 */
+export const TaskModeSchema = z
+    .union([z.literal(1), z.literal(2)])
+    .optional()
+    .default(2)
+    .describe('Task mode (optional): 1 = all assignees must complete, 2 = any assignee can complete. Default 2.');
+/** 是否为里程碑任务。 */
+export const TaskIsMilestoneSchema = z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe('Whether the task is a milestone (optional). Default false.');
+/** 批量创建时的单条任务入参。可设 parentTaskGuid 在已有任务下建子任务，或设 subTasks 建嵌套子任务。 */
+export const TaskCreateItemSchema = z
+    .object({
+    parentTaskGuid: TaskParentTaskGuidSchema,
+    summary: TaskSummarySchema,
+    description: TaskDescriptionSchema,
+    dueTimestamp: TaskTimestampSchema,
+    isDueAllDay: TaskIsAllDaySchema,
+    completedAt: TaskCompletedAtSchema,
+    assigneeIds: TaskAssigneeIdsSchema,
+    followerIds: TaskFollowerIdsSchema,
+    repeatRule: TaskRepeatRuleSchema,
+    startTimestamp: TaskTimestampSchema,
+    isStartAllDay: TaskIsAllDaySchema,
+    mode: TaskModeSchema,
+    isMilestone: TaskIsMilestoneSchema,
+    subTasks: z.lazy(() => TaskSubTasksSchema),
+})
+    .describe('Task item: summary (required), optional description/due/members/subTasks etc. Use subTasks for nested subtasks.');
+/** 嵌套子任务数组（可选）。与父任务同结构，支持多层，每层最多 50 个。 */
+export const TaskSubTasksSchema = z
+    .array(z.lazy(() => TaskCreateItemSchema))
+    .max(50)
+    .optional()
+    .describe('Nested subtasks (optional). Same shape as parent; supports multi-level nesting. Max 50 per level.');
+/** 待创建任务列表。顶层 1～50 条，每条可有 subTasks 做嵌套创建。 */
+export const TaskCreateBatchSchema = z
+    .array(TaskCreateItemSchema)
+    .min(1)
+    .max(50)
+    .describe('Array of tasks to create (required). Each item has summary, description?, parentTaskGuid? (for subtask under existing task), subTasks? (nested subtasks). Min 1, max 50 top-level.');

package/dist/utils/auth/tokenCacheManager.js

@@ -42,6 +42,12 @@ export class TokenCacheManager {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "cleanupTimerId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
         this.cache = new Map();
         this.cacheDir = this.resolveCacheDir();
         this.userTokenCacheFile = path.join(this.cacheDir, 'user_token_cache.json');
@@ -147,7 +153,12 @@ export class TokenCacheManager {
      */
     getUserTokenInfo(key) {
         const cacheKey = `user_access_token:${key}`;
-        const cacheItem = this.cache.get(cacheKey);
+        let cacheItem = this.cache.get(cacheKey);
+        // 内存未命中时，尝试从文件重新加载（应对多进程 stdio 场景：callback 在进程 A，API 调用在进程 B）
+        if (!cacheItem && fs.existsSync(this.userTokenCacheFile)) {
+            this.loadUserTokenCache();
+            cacheItem = this.cache.get(cacheKey);
+        }
         if (!cacheItem) {
             Logger.debug(`用户token信息未找到: ${key}`);
             return null;
@@ -215,7 +226,7 @@ export class TokenCacheManager {
         const cacheKey = `tenant_access_token:${key}`;
         const result = this.cache.delete(cacheKey);
         if (result) {
-            this.saveUserTokenCache();
+            this.saveTenantTokenCache();
             Logger.debug(`租户token删除成功: ${key}`);
         }
         return result;
@@ -455,9 +466,11 @@ export class TokenCacheManager {
      */
     startCacheCleanupTimer() {
         // 每5分钟清理一次过期缓存
-        setInterval(() => {
+        this.cleanupTimerId = setInterval(() => {
             this.cleanExpiredTokens();
         }, 5 * 60 * 1000);
+        // 不阻止进程在 stdio 模式下自然退出
+        this.cleanupTimerId.unref();
         Logger.info('Token缓存清理定时器已启动，每5分钟执行一次');
     }
     /**

package/dist/utils/auth/tokenRefreshManager.js

@@ -50,10 +50,11 @@ export class TokenRefreshManager {
         Logger.info(`启动Token自动刷新管理器，检查间隔: ${this.checkInterval / 1000}秒`);
         // 立即执行一次检查
         this.checkAndRefreshTokens();
-        // 设置定时器
+        // 设置定时器（不阻止进程在 stdio 模式下自然退出）
         this.intervalId = setInterval(() => {
             this.checkAndRefreshTokens();
         }, this.checkInterval);
+        this.intervalId.unref();
         this.isRunning = true;
         Logger.info('Token自动刷新管理器已启动');
     }

package/dist/utils/config.js

@@ -3,6 +3,7 @@ import { hideBin } from 'yargs/helpers';
 import yargs from 'yargs';
 import { Logger, LogLevel } from './logger.js';
 import { serverInfo } from '../mcp/feishuMcp.js';
+import { ModuleRegistry } from '../modules/ModuleRegistry.js';
 /**
  * 配置来源枚举
  */
@@ -46,6 +47,12 @@ export class Config {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "features", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "configSources", {
             enumerable: true,
             configurable: true,
@@ -66,6 +73,8 @@ export class Config {
         this.log = this.initLogConfig(argv);
         // 配置缓存
         this.cache = this.initCacheConfig(argv);
+        // 配置功能模块
+        this.features = this.initFeaturesConfig(argv);
     }
     /**
      * 获取配置单例
@@ -127,6 +136,10 @@ export class Config {
             'user-key': {
                 type: 'string',
                 description: 'stdio 模式下的用户标识，默认 stdio'
+            },
+            'enabled-modules': {
+                type: 'string',
+                description: '启用的功能模块列表（逗号分隔），可选值: document,task,calendar 或 all，默认 document'
             }
         })
             .help()
@@ -347,6 +360,24 @@ export class Config {
         }
         return cacheConfig;
     }
+    /**
+     * 初始化功能模块配置
+     * @param argv 命令行参数
+     * @returns 功能模块配置
+     */
+    initFeaturesConfig(argv) {
+        const featuresConfig = {
+            enabledModules: ['document'],
+        };
+        const rawValue = argv['enabled-modules'] ?? process.env.FEISHU_ENABLED_MODULES;
+        if (rawValue) {
+            featuresConfig.enabledModules = String(rawValue)
+                .split(',')
+                .map(s => s.trim())
+                .filter(Boolean);
+        }
+        return featuresConfig;
+    }
     /**
      * 从字符串获取日志级别
      * @param levelStr 日志级别字符串
@@ -368,6 +399,8 @@ export class Config {
      * @param isStdioMode 是否在stdio模式下
      */
     printConfig(isStdioMode = false) {
+        // 模块配置信息始终输出（含认证类型导致的跳过提醒）
+        this.printModuleConfig();
         if (isStdioMode)
             return;
         Logger.info(`应用版本: ${serverInfo.version}`);
@@ -394,6 +427,20 @@ export class Config {
         Logger.info(`- 缓存TTL: ${this.cache.ttl}秒 (来源: ${this.configSources['cache.ttl']})`);
         Logger.info(`- 最大缓存条目: ${this.cache.maxSize} (来源: ${this.configSources['cache.maxSize']})`);
     }
+    /**
+     * 输出模块配置及认证限制提醒（stdio 模式下也会输出）
+     */
+    printModuleConfig() {
+        const authType = this.feishu.authType;
+        const effectiveModules = ModuleRegistry.getEnabledModules(this.features.enabledModules, authType);
+        Logger.info(`[模块] 配置: ${this.features.enabledModules.join(', ') || 'document'} → 实际加载: ${effectiveModules.map(m => m.id).join(', ') || '(无)'}`);
+        if (authType === 'tenant') {
+            const userOnlyRequested = this.features.enabledModules.some(id => ['task', 'calendar', 'member', 'all'].includes(id));
+            if (userOnlyRequested) {
+                Logger.warn('[模块] task、calendar、member 需 user 认证，当前为 tenant 模式已跳过。设置 FEISHU_AUTH_TYPE=user 以启用。');
+            }
+        }
+    }
     /**
      * 掩盖API密钥
      * @param key API密钥

package/dist/utils/document.js

@@ -8,7 +8,7 @@
  * @param input 文档URL或ID
  * @returns 提取的文档ID或null
  */
-export function extractDocumentId(input) {
+function extractDocumentId(input) {
     // 移除首尾空白
     input = input.trim();
     // 处理各种URL格式
@@ -29,7 +29,7 @@ export function extractDocumentId(input) {
  * @param input Wiki URL或Token
  * @returns 提取的Wiki Token或null
  */
-export function extractWikiToken(input) {
+function extractWikiToken(input) {
     // 移除首尾空白
     input = input.trim();
     // 处理Wiki URL格式
@@ -136,127 +136,127 @@ export function renderFeishuAuthResultHtml(data) {
         expiresIn = expiresIn - now;
     if (refreshExpiresIn && refreshExpiresIn > 1000000000)
         refreshExpiresIn = refreshExpiresIn - now;
-    const tokenBlock = data && !isError ? `
-    <div class="card">
-      <h3>Token 信息</h3>
-      <ul class="kv-list">
-        <li><b>token_type:</b> <span>${data.token_type || ''}</span></li>
-        <li><b>access_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.access_token || ''}</pre></li>
-        <li><b>expires_in:</b> <span>${formatExpire(expiresIn)}</span></li>
-        <li><b>refresh_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.refresh_token || ''}</pre></li>
-        <li><b>refresh_token_expires_in:</b> <span>${formatExpire(refreshExpiresIn)}</span></li>
-        <li><b>scope:</b> <pre class="scope">${(data.scope || '').replace(/ /g, '\n')}</pre></li>
-      </ul>
-      <div class="success-action">
-        <span class="success-msg">授权成功，继续完成任务</span>
-        <button class="copy-btn" onclick="copySuccessMsg(this)">点击复制到粘贴板</button>
-      </div>
-    </div>
+    const tokenBlock = data && !isError ? `
+    <div class="card">
+      <h3>Token 信息</h3>
+      <ul class="kv-list">
+        <li><b>token_type:</b> <span>${data.token_type || ''}</span></li>
+        <li><b>access_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.access_token || ''}</pre></li>
+        <li><b>expires_in:</b> <span>${formatExpire(expiresIn)}</span></li>
+        <li><b>refresh_token:</b> <span class="foldable" onclick="toggleFold(this)">点击展开/收起</span><pre class="fold scrollable">${data.refresh_token || ''}</pre></li>
+        <li><b>refresh_token_expires_in:</b> <span>${formatExpire(refreshExpiresIn)}</span></li>
+        <li><b>scope:</b> <pre class="scope">${(data.scope || '').replace(/ /g, '\n')}</pre></li>
+      </ul>
+      <div class="success-action">
+        <span class="success-msg">授权成功，继续完成任务</span>
+        <button class="copy-btn" onclick="copySuccessMsg(this)">点击复制到粘贴板</button>
+      </div>
+    </div>
   ` : '';
     let userBlock = '';
     const userInfo = data && data.userInfo && data.userInfo.data;
     if (userInfo) {
-        userBlock = `
-      <div class="card user-card">
-        <div class="avatar-wrap">
-          <img src="${userInfo.avatar_big || userInfo.avatar_thumb || userInfo.avatar_url || ''}" class="avatar" />
-        </div>
-        <div class="user-info">
-          <div class="user-name">${userInfo.name || ''}</div>
-          <div class="user-en">${userInfo.en_name || ''}</div>
-        </div>
-      </div>
+        userBlock = `
+      <div class="card user-card">
+        <div class="avatar-wrap">
+          <img src="${userInfo.avatar_big || userInfo.avatar_thumb || userInfo.avatar_url || ''}" class="avatar" />
+        </div>
+        <div class="user-info">
+          <div class="user-name">${userInfo.name || ''}</div>
+          <div class="user-en">${userInfo.en_name || ''}</div>
+        </div>
+      </div>
     `;
     }
-    const errorBlock = isError ? `
-    <div class="card error-card">
-      <h3>授权失败</h3>
-      <div class="error-msg">${escapeHtml(data.error || '')}</div>
-      <div class="error-code">错误码: ${data.code || ''}</div>
-    </div>
+    const errorBlock = isError ? `
+    <div class="card error-card">
+      <h3>授权失败</h3>
+      <div class="error-msg">${escapeHtml(data.error || '')}</div>
+      <div class="error-code">错误码: ${data.code || ''}</div>
+    </div>
   ` : '';
-    return `
-    <html>
-      <head>
-        <title>飞书授权结果</title>
-        <meta charset="utf-8"/>
-        <meta name="viewport" content="width=device-width,initial-scale=1"/>
-        <style>
-          body { background: #f7f8fa; font-family: 'Segoe UI', Arial, sans-serif; margin:0; padding:0; }
-          .container { max-width: 600px; margin: 40px auto; padding: 16px; }
-          .card { background: #fff; border-radius: 12px; box-shadow: 0 2px 12px #0001; margin-bottom: 24px; padding: 24px 20px; }
-          .user-card { display: flex; align-items: center; gap: 24px; }
-          .avatar-wrap { flex-shrink: 0; }
-          .avatar { width: 96px; height: 96px; border-radius: 50%; box-shadow: 0 2px 8px #0002; display: block; margin: 0 auto; }
-          .user-info { flex: 1; }
-          .user-name { font-size: 1.5em; font-weight: bold; margin-bottom: 4px; }
-          .user-en { color: #888; margin-bottom: 10px; }
-          .kv-list { list-style: none; padding: 0; margin: 0; }
-          .kv-list li { margin-bottom: 6px; word-break: break-all; }
-          .kv-list b { color: #1976d2; }
-          .scope { background: #f0f4f8; border-radius: 4px; padding: 6px; font-size: 0.95em; white-space: pre-line; }
-          .foldable { color: #1976d2; cursor: pointer; text-decoration: underline; margin-left: 8px; }
-          .fold { display: none; background: #f6f6f6; border-radius: 4px; padding: 6px; margin: 4px 0; font-size: 0.92em; max-width: 100%; overflow-x: auto; word-break: break-all; }
-          .scrollable { max-width: 100%; overflow-x: auto; font-family: 'Fira Mono', 'Consolas', 'Menlo', monospace; font-size: 0.93em; }
-          .success-action { margin-top: 18px; display: flex; align-items: center; gap: 16px; }
-          .success-msg { color: #388e3c; font-weight: bold; }
-          .copy-btn { background: #1976d2; color: #fff; border: none; border-radius: 4px; padding: 6px 16px; font-size: 1em; cursor: pointer; transition: background 0.2s; }
-          .copy-btn:hover { background: #125ea2; }
-          .error-card { border-left: 6px solid #e53935; background: #fff0f0; color: #b71c1c; }
-          .error-msg { font-size: 1.1em; margin-bottom: 8px; }
-          .error-code { color: #b71c1c; font-size: 0.95em; }
-          .raw-block { margin-top: 24px; }
-          .raw-toggle { color: #1976d2; cursor: pointer; text-decoration: underline; margin-bottom: 8px; display: inline-block; }
-          .raw-pre { display: none; background: #23272e; color: #fff; border-radius: 6px; padding: 12px; font-size: 0.95em; overflow-x: auto; max-width: 100%; }
-          @media (max-width: 700px) {
-            .container { max-width: 98vw; padding: 4vw; }
-            .card { padding: 4vw 3vw; }
-            .avatar { width: 64px; height: 64px; }
-          }
-        </style>
-        <script>
-          function toggleFold(el) {
-            var pre = el.nextElementSibling;
-            if (pre.style.display === 'block') {
-              pre.style.display = 'none';
-            } else {
-              pre.style.display = 'block';
-            }
-          }
-          function toggleRaw() {
-            var pre = document.getElementById('raw-pre');
-            if (pre.style.display === 'block') {
-              pre.style.display = 'none';
-            } else {
-              pre.style.display = 'block';
-            }
-          }
-          function copySuccessMsg(btn) {
-            var text = '授权成功，继续完成任务';
-            navigator.clipboard.writeText(text).then(function() {
-              btn.innerText = '已复制';
-              btn.disabled = true;
-              setTimeout(function() {
-                btn.innerText = '点击复制到粘贴板';
-                btn.disabled = false;
-              }, 2000);
-            });
-          }
-        </script>
-      </head>
-      <body>
-        <div class="container">
-          <h2 style="margin-bottom:24px;">飞书授权结果</h2>
-          ${errorBlock}
-          ${tokenBlock}
-          ${userBlock}
-          <div class="card raw-block">
-            <span class="raw-toggle" onclick="toggleRaw()">点击展开/收起原始数据</span>
-            <pre id="raw-pre" class="raw-pre">${escapeHtml(JSON.stringify(data, null, 2))}</pre>
-          </div>
-        </div>
-      </body>
-    </html>
+    return `
+    <html>
+      <head>
+        <title>飞书授权结果</title>
+        <meta charset="utf-8"/>
+        <meta name="viewport" content="width=device-width,initial-scale=1"/>
+        <style>
+          body { background: #f7f8fa; font-family: 'Segoe UI', Arial, sans-serif; margin:0; padding:0; }
+          .container { max-width: 600px; margin: 40px auto; padding: 16px; }
+          .card { background: #fff; border-radius: 12px; box-shadow: 0 2px 12px #0001; margin-bottom: 24px; padding: 24px 20px; }
+          .user-card { display: flex; align-items: center; gap: 24px; }
+          .avatar-wrap { flex-shrink: 0; }
+          .avatar { width: 96px; height: 96px; border-radius: 50%; box-shadow: 0 2px 8px #0002; display: block; margin: 0 auto; }
+          .user-info { flex: 1; }
+          .user-name { font-size: 1.5em; font-weight: bold; margin-bottom: 4px; }
+          .user-en { color: #888; margin-bottom: 10px; }
+          .kv-list { list-style: none; padding: 0; margin: 0; }
+          .kv-list li { margin-bottom: 6px; word-break: break-all; }
+          .kv-list b { color: #1976d2; }
+          .scope { background: #f0f4f8; border-radius: 4px; padding: 6px; font-size: 0.95em; white-space: pre-line; }
+          .foldable { color: #1976d2; cursor: pointer; text-decoration: underline; margin-left: 8px; }
+          .fold { display: none; background: #f6f6f6; border-radius: 4px; padding: 6px; margin: 4px 0; font-size: 0.92em; max-width: 100%; overflow-x: auto; word-break: break-all; }
+          .scrollable { max-width: 100%; overflow-x: auto; font-family: 'Fira Mono', 'Consolas', 'Menlo', monospace; font-size: 0.93em; }
+          .success-action { margin-top: 18px; display: flex; align-items: center; gap: 16px; }
+          .success-msg { color: #388e3c; font-weight: bold; }
+          .copy-btn { background: #1976d2; color: #fff; border: none; border-radius: 4px; padding: 6px 16px; font-size: 1em; cursor: pointer; transition: background 0.2s; }
+          .copy-btn:hover { background: #125ea2; }
+          .error-card { border-left: 6px solid #e53935; background: #fff0f0; color: #b71c1c; }
+          .error-msg { font-size: 1.1em; margin-bottom: 8px; }
+          .error-code { color: #b71c1c; font-size: 0.95em; }
+          .raw-block { margin-top: 24px; }
+          .raw-toggle { color: #1976d2; cursor: pointer; text-decoration: underline; margin-bottom: 8px; display: inline-block; }
+          .raw-pre { display: none; background: #23272e; color: #fff; border-radius: 6px; padding: 12px; font-size: 0.95em; overflow-x: auto; max-width: 100%; }
+          @media (max-width: 700px) {
+            .container { max-width: 98vw; padding: 4vw; }
+            .card { padding: 4vw 3vw; }
+            .avatar { width: 64px; height: 64px; }
+          }
+        </style>
+        <script>
+          function toggleFold(el) {
+            var pre = el.nextElementSibling;
+            if (pre.style.display === 'block') {
+              pre.style.display = 'none';
+            } else {
+              pre.style.display = 'block';
+            }
+          }
+          function toggleRaw() {
+            var pre = document.getElementById('raw-pre');
+            if (pre.style.display === 'block') {
+              pre.style.display = 'none';
+            } else {
+              pre.style.display = 'block';
+            }
+          }
+          function copySuccessMsg(btn) {
+            var text = '授权成功，继续完成任务';
+            navigator.clipboard.writeText(text).then(function() {
+              btn.innerText = '已复制';
+              btn.disabled = true;
+              setTimeout(function() {
+                btn.innerText = '点击复制到粘贴板';
+                btn.disabled = false;
+              }, 2000);
+            });
+          }
+        </script>
+      </head>
+      <body>
+        <div class="container">
+          <h2 style="margin-bottom:24px;">飞书授权结果</h2>
+          ${errorBlock}
+          ${tokenBlock}
+          ${userBlock}
+          <div class="card raw-block">
+            <span class="raw-toggle" onclick="toggleRaw()">点击展开/收起原始数据</span>
+            <pre id="raw-pre" class="raw-pre">${escapeHtml(JSON.stringify(data, null, 2))}</pre>
+          </div>
+        </div>
+      </body>
+    </html>
   `;
 }
 function escapeHtml(str) {

package/dist/utils/error.js

@@ -164,17 +164,6 @@ export function formatErrorMessage(error, context) {
         return typeof error === 'string' ? error : '发生未知错误';
     }
 }
-/**
- * 包装错误为标准格式
- *
- * @param message 错误消息前缀
- * @param originalError 原始错误
- * @returns 包装后的错误对象
- */
-export function wrapError(message, originalError) {
-    const errorMessage = formatErrorMessage(originalError);
-    return new Error(`${message}: ${errorMessage}`);
-}
 /**
  * 授权异常类
  * 用于处理需要用户授权的情况

package/dist/utils/paramUtils.js

@@ -197,35 +197,4 @@ export class ParamUtils {
             throw new ParamValidationError('whiteboardId', formatErrorMessage(error));
         }
     }
-    /**
-     * 批量处理通用参数
-     * 验证并规范化常用参数集
-     *
-     * @param params 通用参数对象
-     * @returns 处理后的参数对象
-     */
-    static processCommonParams(params) {
-        const result = { ...params };
-        // 处理文档ID
-        if (params.documentId) {
-            result.documentId = ParamUtils.processDocumentId(params.documentId);
-        }
-        // 处理块ID
-        if (params.blockId) {
-            result.blockId = ParamUtils.processBlockId(params.blockId);
-        }
-        // 处理父块ID
-        if (params.parentBlockId) {
-            result.parentBlockId = ParamUtils.processParentBlockId(params.parentBlockId);
-        }
-        // 处理索引
-        if (params.index !== undefined) {
-            result.index = ParamUtils.processIndex(params.index);
-        }
-        // 处理起始索引
-        if (params.startIndex !== undefined) {
-            result.startIndex = ParamUtils.processIndex(params.startIndex);
-        }
-        return result;
-    }
 }