dingtalk-wiki 1.1.6 → 1.2.1

package/README.md

@@ -15,7 +15,8 @@
 ## Repository Highlights
 
 - **Official MCP gap**: Wiki / Docs read-write is not covered
-- **This project adds it**: workspace browsing, node browsing, and document creation
+- **This project adds it**: workspace browsing, node browsing, document CRUD, and full-text search
+- **Local search index**: MiniSearch + SQLite — full-text content search across docs and Notable tables
 - **MCP-compatible**: works with stdio-based MCP clients
 - **Agent-ready**: includes `SKILL.md` for OpenClaw-style skill workflows
 
@@ -124,6 +125,8 @@ node index.js
 | Browse workspaces              |                   Not covered |                      ✅ |
 | Browse nodes / folders         |                   Not covered |                      ✅ |
 | Read Notable / `.able` records |                   Not covered |                      ✅ |
+| Name search                    |                   Not covered |                      ✅ |
+| Full-text content search       |                   Not covered | ✅ MiniSearch + SQLite |
 | MCP client compatibility       | Partial / official scope only | ✅ stdio MCP-compatible |
 | OpenClaw skill packaging       |                            No |  ✅ includes `SKILL.md` |
 
@@ -143,7 +146,9 @@ node index.js
   - `WORKBOOK`
   - `MIND`
   - `FOLDER`
-- Search Wiki by linking to DingTalk search
+- Search by name (`search_wiki`, BFS directory traversal, always available)
+- Full-text content search (`search_wiki_content`, MiniSearch + SQLite index)
+- Search index management (`refresh_search_index`)
 - Read Notable / `.able` sheets and records via official API
 
 ### Organization
@@ -243,17 +248,22 @@ mcporter call --stdio "node ./index.js" create_wiki_doc workspace_id="your_works
 
 ## Available MCP tools
 
-- `list_wiki_workspaces`
-- `get_wiki_workspace`
-- `list_wiki_nodes`
-- `get_wiki_node`
-- `create_wiki_doc`
-- `search_wiki`
-- `list_departments`
-- `get_department_users`
-- `get_user_info`
-- `list_notable_sheets`
-- `list_notable_records`
+### Wiki / Docs
+- `list_wiki_workspaces` / `get_wiki_workspace`
+- `list_wiki_nodes` / `get_wiki_node`
+- `create_wiki_doc` / `delete_wiki_doc` / `rename_wiki_doc`
+- `get_wiki_doc_content` / `update_wiki_doc_content`
+- `search_wiki` — name search (BFS, no index needed)
+- `search_wiki_content` — full-text search (requires index)
+- `refresh_search_index` — rebuild search index
+
+### AI 表格 (Notable)
+- `list_notable_sheets` / `list_notable_records`
+- `create_notable_record` / `update_notable_record` / `delete_notable_record`
+- `create_notable_sheet` / `delete_notable_sheet`
+
+### Organization
+- `list_departments` / `get_department_users` / `get_user_info`
 
 ---
 
@@ -301,8 +311,9 @@ Please refer to DingTalk Open Platform documentation for the latest permission n
 
 - This is a community-maintained complement, not an official DingTalk project
 - Some APIs require enterprise approval on the DingTalk side
-- `search_wiki` is currently more of a search-entry helper than a full-text search implementation
-- Reading normal DingTalk document body content via official public API is still not implemented in this project
+- `search_wiki` traverses directory tree by name (always available)
+- `search_wiki_content` uses MiniSearch + SQLite for full-text search, requires `refresh_search_index` first
+- Search index updates on write operations (create/update/rename/delete) via async hooks
 - Notable / `.able` support currently covers sheets and records, not arbitrary document-body export
 
 ---

package/README.zh-CN.md

@@ -15,7 +15,8 @@
 ## 仓库要点
 
 - **官方 MCP 有空白**：没有覆盖 Wiki / Docs 读写
-- **这个项目补上了**：支持 workspace、node 浏览和文档创建
+- **这个项目补上了**：支持 workspace、node 浏览、文档 CRUD 和全文搜索
+- **本地搜索索引**：MiniSearch + SQLite — 全文搜索文档和 Notable 表格内容
 - **MCP 兼容**：兼容 stdio 模式的 MCP client
 - **Agent 友好**：自带 `SKILL.md`，可直接作为 skill 复用
 
@@ -124,6 +125,8 @@ node index.js
 | 浏览 workspace | 未覆盖 | ✅ |
 | 浏览 nodes / 目录 | 未覆盖 | ✅ |
 | 读取 Notable / `.able` 记录 | 未覆盖 | ✅ |
+| 名称搜索 | 未覆盖 | ✅ |
+| 全文内容搜索 | 未覆盖 | ✅ MiniSearch + SQLite |
 | MCP 客户端兼容性 | 官方范围内 | ✅ stdio 兼容 |
 | OpenClaw skill 化复用 | 无 | ✅ 自带 `SKILL.md` |
 
@@ -142,7 +145,9 @@ node index.js
   - `WORKBOOK`
   - `MIND`
   - `FOLDER`
-- 提供跳转式 Wiki 搜索能力
+- 按名称搜索（`search_wiki`，BFS 遍历目录树，无需索引）
+- 全文内容搜索（`search_wiki_content`，MiniSearch + SQLite 索引）
+- 搜索索引管理（`refresh_search_index`）
 - 通过官方 API 读取 Notable / `.able` 的数据表和记录
 
 ### 组织架构
@@ -236,17 +241,22 @@ mcporter call --stdio "node ./index.js" create_wiki_doc workspace_id="your_works
 
 ## 可用 MCP 工具
 
-- `list_wiki_workspaces`
-- `get_wiki_workspace`
-- `list_wiki_nodes`
-- `get_wiki_node`
-- `create_wiki_doc`
-- `search_wiki`
-- `list_departments`
-- `get_department_users`
-- `get_user_info`
-- `list_notable_sheets`
-- `list_notable_records`
+### Wiki / Docs
+- `list_wiki_workspaces` / `get_wiki_workspace`
+- `list_wiki_nodes` / `get_wiki_node`
+- `create_wiki_doc` / `delete_wiki_doc` / `rename_wiki_doc`
+- `get_wiki_doc_content` / `update_wiki_doc_content`
+- `search_wiki` — 名称搜索（BFS，无需索引）
+- `search_wiki_content` — 全文搜索（需先建索引）
+- `refresh_search_index` — 重建搜索索引
+
+### AI 表格（Notable）
+- `list_notable_sheets` / `list_notable_records`
+- `create_notable_record` / `update_notable_record` / `delete_notable_record`
+- `create_notable_sheet` / `delete_notable_sheet`
+
+### 组织架构
+- `list_departments` / `get_department_users` / `get_user_info`
 
 ---
 
@@ -295,9 +305,9 @@ mcporter call --stdio "node ./index.js" create_wiki_doc workspace_id="your_works
 
 - 本项目是社区补充实现，不是钉钉官方项目
 - 部分 API 需要企业侧权限审批
-- `search_wiki` 当前更偏向“跳转辅助”，不是完整全文检索实现
-- 目前项目仍未实现通过官方公开 API 读取普通 DingTalk 文档正文
-- 当前 Notable / `.able` 支持的是数据表和 records 读取，不是任意正文导出
+- `search_wiki` 通过 BFS 遍历目录树按名称匹配（始终可用）
+- `search_wiki_content` 使用 MiniSearch + SQLite 全文搜索，需先运行 `refresh_search_index`
+- 搜索索引在写入操作（创建/更新/重命名/删除）时通过异步 hook 自动更新
 
 ---
 

package/index.js

@@ -11,6 +11,8 @@ const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
 const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
 const { CallToolRequestSchema, ListToolsRequestSchema } = require('@modelcontextprotocol/sdk/types.js');
 const axios = require('axios');
+const MiniSearch = require('minisearch');
+const Database = require('better-sqlite3');
 const dotenv = require('dotenv');
 
 // 钉钉 API 配置
@@ -21,6 +23,7 @@ const path = require('path');
 const os = require('os');
 const CACHE_DIR = path.join(os.homedir(), '.cache', 'dingtalk-wiki');
 const UNIONID_CACHE_PATH = path.join(CACHE_DIR, 'unionid-cache.json');
+const SEARCH_INDEX_PATH = path.join(CACHE_DIR, 'search-index.sqlite');
 
 if (!fs.existsSync(CACHE_DIR)) {
   fs.mkdirSync(CACHE_DIR, { recursive: true });
@@ -43,6 +46,221 @@ function saveUnionIdCache() {
   }
 }
 
+class WikiSearchIndex {
+  constructor() {
+    this.db = new Database(SEARCH_INDEX_PATH);
+    this.db.pragma('journal_mode = WAL');
+    this.db.exec(`CREATE TABLE IF NOT EXISTS docs (
+      id TEXT PRIMARY KEY,
+      title TEXT NOT NULL DEFAULT '',
+      content TEXT NOT NULL DEFAULT '',
+      workspaceId TEXT NOT NULL DEFAULT '',
+      workspaceName TEXT NOT NULL DEFAULT '',
+      url TEXT NOT NULL DEFAULT '',
+      type TEXT NOT NULL DEFAULT ''
+    )`);
+    this._insertStmt = this.db.prepare(`INSERT OR REPLACE INTO docs (id, title, content, workspaceId, workspaceName, url, type) VALUES (?, ?, ?, ?, ?, ?, ?)`);
+    this._deleteStmt = this.db.prepare(`DELETE FROM docs WHERE id = ?`);
+    this._getStmt = this.db.prepare(`SELECT * FROM docs WHERE id = ?`);
+
+    this.index = new MiniSearch({
+      fields: ['title', 'content'],
+      storeFields: ['title', 'workspaceId', 'workspaceName', 'url', 'type'],
+    });
+
+    this._load();
+  }
+
+  _load() {
+    try {
+      const rows = this.db.prepare('SELECT id, title, content, workspaceId, workspaceName, url, type FROM docs').all();
+      for (const row of rows) {
+        this.index.add({
+          id: row.id, title: row.title, content: row.content,
+          workspaceId: row.workspaceId, workspaceName: row.workspaceName,
+          url: row.url, type: row.type,
+        });
+      }
+      console.error(`[钉钉MCP] 搜索索引已加载 (${rows.length} 篇文档)`);
+    } catch (e) {
+      console.error('[钉钉MCP] 加载搜索索引失败:', e.message);
+    }
+  }
+
+  add(docKey, data) {
+    this._insertStmt.run(docKey, data.title || '', data.content || '', data.workspaceId || '', data.workspaceName || '', data.url || '', data.type || '');
+    try {
+      this.index.add({ id: docKey, ...data });
+    } catch (e) {
+      console.error(`[钉钉MCP] 索引添加失败 [${docKey}]:`, e.message);
+    }
+  }
+
+  remove(docKey) {
+    this._deleteStmt.run(docKey);
+    try { this.index.remove({ id: docKey }); } catch (e) { /* not in index */ }
+  }
+
+  update(docKey, data) {
+    const existing = this._getStmt.get(docKey);
+    const merged = {
+      title: data.title ?? existing?.title ?? '',
+      content: data.content ?? existing?.content ?? '',
+      workspaceId: data.workspaceId ?? existing?.workspaceId ?? '',
+      workspaceName: data.workspaceName ?? existing?.workspaceName ?? '',
+      url: data.url ?? existing?.url ?? '',
+      type: data.type ?? existing?.type ?? '',
+    };
+    this._insertStmt.run(docKey, merged.title, merged.content, merged.workspaceId, merged.workspaceName, merged.url, merged.type);
+    try { this.index.remove({ id: docKey }); } catch (e) { /* ignore */ }
+    try {
+      this.index.add({ id: docKey, ...merged });
+    } catch (e) {
+      console.error(`[钉钉MCP] 索引更新失败 [${docKey}]:`, e.message);
+    }
+  }
+
+  search(keyword, maxResults = 20) {
+    const results = this.index.search(keyword, { prefix: true, fuzzy: 0.2 });
+    const top = results.slice(0, maxResults);
+    if (top.length === 0) return [];
+
+    const ids = top.map(r => r.id);
+    const placeholders = ids.map(() => '?').join(',');
+    const rows = this.db.prepare(`SELECT * FROM docs WHERE id IN (${placeholders})`).all(...ids);
+    const rowMap = Object.fromEntries(rows.map(r => [r.id, r]));
+
+    return top.map(r => ({
+      id: r.id, score: r.score,
+      title: rowMap[r.id]?.title || '',
+      content: rowMap[r.id]?.content || '',
+      workspaceId: rowMap[r.id]?.workspaceId || '',
+      workspaceName: rowMap[r.id]?.workspaceName || '',
+      url: rowMap[r.id]?.url || '',
+      type: rowMap[r.id]?.type || '',
+    }));
+  }
+
+  get size() {
+    return this.db.prepare('SELECT COUNT(*) as c FROM docs').get().c;
+  }
+
+  clear() {
+    this.db.exec('DELETE FROM docs');
+    this.index = new MiniSearch({
+      fields: ['title', 'content'],
+      storeFields: ['title', 'workspaceId', 'workspaceName', 'url', 'type'],
+    });
+  }
+}
+
+async function reindexNotableBase(baseId) {
+  try {
+    const sheetsRes = await dingtalk.notableRequest('GET', `/v1.0/notable/bases/${baseId}/sheets`);
+    const sheets = sheetsRes.value || [];
+    const texts = [];
+    for (const sheet of sheets) {
+      try {
+        const recordsRes = await dingtalk.notableRequest('POST', `/v1.0/notable/bases/${baseId}/sheets/${sheet.id}/records/list`, {
+          data: { maxResults: 500 }
+        });
+        const records = recordsRes.records || [];
+        for (const rec of records) {
+          for (const val of Object.values(rec.fields || {})) {
+            if (typeof val === 'string' || typeof val === 'number') {
+              texts.push(String(val));
+            }
+          }
+        }
+      } catch (e) { /* skip sheet */ }
+    }
+    wikiIndex.update(baseId, { content: texts.join('\n') });
+  } catch (e) {
+    console.error(`[钉钉MCP] 重建 Notable 表索引失败 [${baseId}]:`, e.message);
+  }
+}
+
+async function rebuildSearchIndex() {
+  const wsResult = await dingtalk.wikiRequest('workspaces');
+  const workspaces = wsResult.workspaces || [];
+
+  wikiIndex.clear();
+  let total = 0;
+
+  for (const ws of workspaces) {
+    const queue = [ws.rootNodeId];
+    const visited = new Set();
+
+    while (queue.length > 0) {
+      const dentryId = queue.shift();
+      if (!dentryId || visited.has(dentryId)) continue;
+      visited.add(dentryId);
+
+      try {
+        const result = await dingtalk.docRequest('GET', `/v2.0/doc/spaces/${ws.workspaceId}/directories`, {
+          extraParams: dentryId !== ws.rootNodeId ? { dentryId, maxResults: 500 } : { maxResults: 500 }
+        });
+
+        const children = result.children || [];
+        for (const child of children) {
+          const childId = child.dentryId || child.nodeId || child.id;
+          const name = child.name || '';
+          const isFolder = child.contentType === 'folder';
+
+          if (!isFolder && childId) {
+            let content = '';
+            try {
+              const blocks = await dingtalk.docRequest('GET', `/v1.0/doc/suites/documents/${childId}/blocks`);
+              const blockData = blocks.result?.data || [];
+              content = blockData.map(b => extractBlockText(b)).join('\n\n');
+            } catch (e) { /* content unavailable */ }
+
+            if (!content) {
+              try {
+                const sheetsRes = await dingtalk.notableRequest('GET', `/v1.0/notable/bases/${childId}/sheets`);
+                const sheets = sheetsRes.value || [];
+                const texts = [];
+                for (const sheet of sheets) {
+                  try {
+                    const recordsRes = await dingtalk.notableRequest('POST', `/v1.0/notable/bases/${childId}/sheets/${sheet.id}/records/list`, {
+                      data: { maxResults: 500 }
+                    });
+                    const records = recordsRes.records || [];
+                    for (const rec of records) {
+                      for (const val of Object.values(rec.fields || {})) {
+                        if (typeof val === 'string' || typeof val === 'number') {
+                          texts.push(String(val));
+                        }
+                      }
+                    }
+                  } catch (e) { /* skip sheet */ }
+                }
+                content = texts.join('\n');
+              } catch (e) { /* not a Notable table */ }
+            }
+
+            wikiIndex.add(childId, {
+              title: name, content,
+              workspaceId: ws.workspaceId,
+              workspaceName: ws.name,
+              url: child.url || '',
+              type: child.contentType || 'DOC',
+            });
+            total++;
+          }
+
+          if (child.hasChildren && childId && !visited.has(childId)) {
+            queue.push(childId);
+          }
+        }
+      } catch (e) { /* skip errored nodes */ }
+    }
+  }
+
+  console.error(`[钉钉MCP] 搜索索引重建完成 (${total} 篇文档)`);
+  return total;
+}
+
 function loadEnvFile(filePath) {
   if (!filePath || !fs.existsSync(filePath)) {
     return false;
@@ -378,6 +596,7 @@ class DingTalkClient {
 }
 
 const dingtalk = new DingTalkClient();
+const wikiIndex = new WikiSearchIndex();
 
 // MCP Server 定义
 const server = new Server(
@@ -503,7 +722,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'search_wiki',
-        description: '搜索知识库中的文档和文件夹（遍历目录树按名称匹配）',
+        description: '按名称搜索知识库中的文档和文件夹（遍历目录树，无需索引即可使用）',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            keyword: {
+              type: 'string',
+              description: '搜索关键词'
+            },
+            workspace_id: {
+              type: 'string',
+              description: '指定知识库 ID（可选，不传则搜索所有知识库）'
+            },
+            max_results: {
+              type: 'number',
+              description: '返回条数上限（默认 20，最大 50）'
+            },
+            operator_id: {
+              type: 'string',
+              description: '操作者 unionid（不传则使用默认用户）'
+            }
+          },
+          required: ['keyword']
+        }
+      },
+      {
+        name: 'refresh_search_index',
+        description: '全量重建搜索索引（遍历所有知识库读取文档内容，建立全文索引后 search_wiki_content 方可使用）',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            operator_id: {
+              type: 'string',
+              description: '操作者 unionid（不传则使用默认用户）'
+            }
+          }
+        }
+      },
+      {
+        name: 'search_wiki_content',
+        description: '全文搜索知识库文档内容（需先运行 refresh_search_index 建立索引）',
         inputSchema: {
           type: 'object',
           properties: {
@@ -1052,6 +1310,22 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             lines.push(`📂 Workspace ID: ${doc.workspaceId}`);
           }
 
+          setImmediate(() => {
+            wikiIndex.add(doc.nodeId || doc.docKey, {
+              title: name,
+              content: args.content || '',
+              workspaceId: workspace_id || doc.workspaceId,
+              workspaceName: '',
+              url: doc.url || '',
+              type: doc_type,
+            });
+            if (args.content && doc.nodeId) {
+              dingtalk.docRequest('POST', `/v1.0/doc/suites/documents/${doc.nodeId}/overwriteContent`, {
+                data: { content: args.content, contentType: 'markdown' }
+              }).catch(() => {});
+            }
+          });
+
           return {
             content: [{
               type: 'text',
@@ -1125,11 +1399,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           };
         }
 
-        const MAX_RESULTS = Math.min(max_results, 50);
         if (operator_id) {
           dingtalk.setOperatorId(operator_id);
         }
 
+        const MAX_RESULTS = Math.min(max_results, 50);
         const wsResult = await dingtalk.wikiRequest('workspaces');
         let workspaces = wsResult.workspaces || [];
         if (workspace_id) {
@@ -1144,70 +1418,92 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
 
         const matchedNodes = [];
-
         for (const ws of workspaces) {
           if (matchedNodes.length >= MAX_RESULTS) break;
-
           const queue = [ws.rootNodeId];
           const visited = new Set();
-
           while (queue.length > 0 && matchedNodes.length < MAX_RESULTS) {
             const dentryId = queue.shift();
             if (!dentryId || visited.has(dentryId)) continue;
             visited.add(dentryId);
-
             try {
               const result = await dingtalk.docRequest('GET', `/v2.0/doc/spaces/${ws.workspaceId}/directories`, {
-                operatorId: operator_id || null,
                 extraParams: dentryId !== ws.rootNodeId ? { dentryId, maxResults: 500 } : { maxResults: 500 }
               });
-
               const children = result.children || [];
               for (const child of children) {
                 const name = child.name || '';
                 if (name.includes(keyword)) {
-                  matchedNodes.push({
-                    name,
-                    nodeId: child.dentryId || child.nodeId || child.id,
-                    workspaceId: ws.workspaceId,
-                    workspaceName: ws.name,
-                    type: child.contentType === 'folder' ? '文件夹' : '文档',
-                    url: child.url || '',
-                    hasChildren: child.hasChildren
-                  });
-                }
-                if (child.hasChildren && matchedNodes.length < MAX_RESULTS) {
-                  const childId = child.dentryId || child.nodeId || child.id;
-                  if (childId && !visited.has(childId)) {
-                    queue.push(childId);
-                  }
+                  matchedNodes.push({ name, nodeId: child.dentryId || child.nodeId || child.id, workspaceId: ws.workspaceId, workspaceName: ws.name, type: child.contentType === 'folder' ? '文件夹' : '文档', url: child.url || '' });
                 }
+                const childId = child.dentryId || child.nodeId || child.id;
+                if (child.hasChildren && childId && !visited.has(childId)) queue.push(childId);
               }
-            } catch (e) {
-              // 单个节点遍历失败跳过，不中断整体搜索
-            }
+            } catch (e) { /* skip */ }
           }
         }
 
-        let output = `🔍 搜索 "${keyword}" (${matchedNodes.length}条)\n\n`;
+        let output = `🔍 搜索 "${keyword}" (${matchedNodes.length}条，按名称匹配)\n\n`;
         matchedNodes.slice(0, MAX_RESULTS).forEach((item, i) => {
           const icon = item.type === '文件夹' ? '📁' : '📄';
-          output += `${i + 1}. ${icon} ${item.name}\n`;
-          output += `   知识库: ${item.workspaceName} (${item.workspaceId})\n`;
+          output += `${i + 1}. ${icon} ${item.name}\n   知识库: ${item.workspaceName} (${item.workspaceId})\n`;
           if (item.url) output += `   链接: ${item.url}\n`;
           output += '\n';
         });
-
         if (matchedNodes.length === 0) {
           output += '没有找到匹配的文档或文件夹。\n';
-          output += `\n💡 此方式通过遍历目录树按名称匹配，非全文搜索。`;
-          output += `如需全文搜索，请在钉钉客户端中操作：\n`;
-          output += `https://alidocs.dingtalk.com/i/search?keyword=${encodeURIComponent(keyword)}`;
         }
 
-        return {
-          content: [{ type: 'text', text: output }]
-        };
+        return { content: [{ type: 'text', text: output }] };
+      }
+
+      case 'search_wiki_content': {
+        const { keyword, workspace_id, max_results = 20, operator_id } = args;
+        if (!keyword) {
+          return {
+            content: [{ type: 'text', text: '⚠️ 请提供搜索关键词 keyword' }],
+            isError: true
+          };
+        }
+
+        if (operator_id) {
+          dingtalk.setOperatorId(operator_id);
+        }
+
+        if (wikiIndex.size === 0) {
+          return {
+            content: [{
+              type: 'text',
+              text: '🔍 全文搜索索引为空，请先运行 refresh_search_index 工具遍历知识库建立索引。'
+            }]
+          };
+        }
+
+        const MAX_RESULTS = Math.min(max_results, 50);
+        let results = wikiIndex.search(keyword, MAX_RESULTS);
+        if (workspace_id) {
+          results = results.filter(r => r.workspaceId === workspace_id);
+        }
+
+        let output = `🔍 全文搜索 "${keyword}" (${results.length}条)\n\n`;
+        results.slice(0, MAX_RESULTS).forEach((item, i) => {
+          const icon = item.type === 'FOLDER' || item.type === 'folder' ? '📁' : '📄';
+          output += `${i + 1}. ${icon} ${item.title}\n`;
+          output += `   知识库: ${item.workspaceName} (${item.workspaceId})\n`;
+          output += `   匹配度: ${(item.score * 100).toFixed(0)}%\n`;
+          if (item.url) output += `   链接: ${item.url}\n`;
+          if (item.content) {
+            const preview = item.content.slice(0, 120).replace(/\n+/g, ' ');
+            output += `   内容预览: ${preview}${item.content.length > 120 ? '...' : ''}\n`;
+          }
+          output += '\n';
+        });
+
+        if (results.length === 0) {
+          output += '没有找到匹配的文档。\n';
+        }
+
+        return { content: [{ type: 'text', text: output }] };
       }
 
       case 'list_departments': {
@@ -1292,6 +1588,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           operatorId: operator_id || null,
           data: { content, contentType: 'markdown' }
         });
+        setImmediate(() => { wikiIndex.update(docKey, { content }); });
         return {
           content: [{ type: 'text', text: '✅ 文档内容已更新' }]
         };
@@ -1306,6 +1603,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           operatorId: operator_id || null,
           data: { name }
         });
+        setImmediate(() => { wikiIndex.update(node_id, { title: name }); });
         return {
           content: [{ type: 'text', text: `✅ 文档已重命名为: ${name}` }]
         };
@@ -1319,6 +1617,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         await dingtalk.docRequest('DELETE', `/v1.0/doc/workspaces/${workspace_id}/docs/${node_id}`, {
           operatorId: operator_id || null
         });
+        setImmediate(() => { wikiIndex.remove(node_id); });
         return {
           content: [{
             type: 'text',
@@ -1383,6 +1682,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           operatorId: operator_id || null,
           data: { records }
         });
+        setImmediate(() => reindexNotableBase(base_id));
         return {
           content: [{
             type: 'text',
@@ -1397,6 +1697,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           operatorId: operator_id || null,
           data: { records }
         });
+        setImmediate(() => reindexNotableBase(base_id));
         return {
           content: [{
             type: 'text',
@@ -1411,6 +1712,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           operatorId: operator_id || null,
           data: { recordIds: record_ids }
         });
+        setImmediate(() => reindexNotableBase(base_id));
         return {
           content: [{
             type: 'text',
@@ -1450,6 +1752,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      case 'refresh_search_index': {
+        const { operator_id } = args || {};
+        if (operator_id) {
+          dingtalk.setOperatorId(operator_id);
+        }
+        rebuildSearchIndex().catch(e => console.error('[钉钉MCP] 索引重建失败:', e.message));
+        return {
+          content: [{
+            type: 'text',
+            text: '🔄 搜索索引全量重建已启动（后台运行），完成后搜索将支持全文检索。\n\n这可能需要一些时间，取决于知识库中文档的数量和内容长度。'
+          }]
+        };
+      }
+
       default:
         throw new Error(`未知工具: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-wiki",
-  "version": "1.1.6",
+  "version": "1.2.1",
   "description": "DingTalk Wiki / Docs read-write MCP server that fills the gap left by DingTalk official MCP.",
   "main": "index.js",
   "bin": {
@@ -40,7 +40,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "axios": "latest",
+    "better-sqlite3": "^12.10.0",
     "dotenv": "latest",
+    "minisearch": "^7.2.0",
     "zod": "latest"
   }
 }

package/skill/SKILL.md

@@ -3,6 +3,9 @@
 钉钉知识库 MCP Server，支持通过 MCP 协议读写钉钉 Wiki / Docs 内容。
 
 ### 知识库管理
+- `search_wiki` - 按名称搜索知识库文档和文件夹（遍历目录树，无需索引）
+- `search_wiki_content` - 全文搜索文档内容 + Notable 表格内容（需先 `refresh_search_index`）
+- `refresh_search_index` - 全量重建搜索索引（支持普通文档和 Notable 表格）
 - `list_wiki_workspaces` - 列出知识库工作空间列表
 - `get_wiki_workspace` - 获取知识库详情
 - `list_wiki_nodes` - 列出知识库节点（文档 / 目录）
@@ -12,7 +15,6 @@
 - `update_wiki_doc_content` - 覆写文档内容（Markdown，⚠️ 全量覆盖）
 - `rename_wiki_doc` - 重命名文档
 - `delete_wiki_doc` - 删除文档节点
-- `search_wiki` - 搜索知识库内容
 - `list_notable_sheets` - 获取 `.able` / AI 表格中的所有数据表
 - `list_notable_records` - 获取指定数据表中的 records
 - `create_notable_record` - 创建记录（单条或多条）
@@ -100,7 +102,7 @@ mcporter call dingtalk-wiki.delete_wiki_doc \
   workspace_id="your_workspace_id" \
   node_id="your_node_id"
 
-# 搜索知识库
+# 按名称搜索
 mcporter call dingtalk-wiki.search_wiki keyword="项目规划"
 
 # 在指定知识库内搜索
@@ -108,11 +110,23 @@ mcporter call dingtalk-wiki.search_wiki keyword="项目规划" workspace_id="you
 
 # 自定义返回条数
 mcporter call dingtalk-wiki.search_wiki keyword="项目规划" max_results=5
+```
+
+### 全文搜索
+
+```bash
+# 先重建索引（遍历所有知识库获取文档和 Notable 表格内容）
+mcporter call dingtalk-wiki.refresh_search_index
+
+# 全文搜索文档内容（包括 Notable 表格记录）
+mcporter call dingtalk-wiki.search_wiki_content keyword="项目规划"
 
-# 分页搜索
-mcporter call dingtalk-wiki.search_wiki keyword="项目规划" next_token="your_next_token"
+# 搜索结果含匹配度和内容预览
+mcporter call dingtalk-wiki.search_wiki_content keyword="API集成" max_results=10
 ```
 
+> 💡 `search_wiki`（按名称搜索）无需索引即可使用，`search_wiki_content`（全文搜索）需先运行 `refresh_search_index`。
+
 ### AI 表格（Notable）
 
 ```bash