dingtalk-wiki 1.2.9 → 1.2.11

package/index.js

@@ -872,7 +872,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'get_wiki_doc_content',
-        description: '读取文档正文内容（返回 Block 结构，含标题、段落、表格等）',
+        description: '读取文档正文内容（返回 Block 结构）。注意：仅对 create_wiki_doc 创建的文档有效；知识库中已有文档（非通过此工具创建的）不受支持——钉钉未提供公开 REST API 读取已有知识库文档内容。若需读取已有文档内容，可使用 DingTalk 官方 MCP 服务器的 get_document_content 工具。',
         inputSchema: {
           type: 'object',
           properties: {
@@ -894,7 +894,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'update_wiki_doc_content',
-        description: '覆写文档正文内容（⚠️ 全量覆盖，不可撤销）',
+        description: '覆写文档正文内容（⚠️ 全量覆盖，不可撤销）。注意：仅对 create_wiki_doc 创建的文档有效；知识库中已有文档（非通过此工具创建的）不受支持。',
         inputSchema: {
           type: 'object',
           properties: {
@@ -1419,8 +1419,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           });
         }
 
-        // Step 6: search docs API (v1.0/doc/docs) — 需要 workspaceId
+        // Step 6: search docs API (v1.0/doc/docs) — 需要 workspaceId + keyword
         if (effectiveWsId) {
+          // Try without keyword first (might list all)
           try {
             const searchRes = await axios({
               method: 'GET',
@@ -1431,17 +1432,41 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const docs = searchRes.data?.docs || [];
             const matched = docs.find(d => d.nodeBO?.nodeId === input || d.nodeBO?.dentryUuid === input || d.docKey === input || d.nodeBO?.dentryId === input);
             steps.push({
-              step: `doc search API (workspace=${effectiveWsId})`,
+              step: `doc search API (workspace=${effectiveWsId}, no keyword)`,
               result: `成功 (${docs.length} 篇文档)` + (matched ? ', 找到匹配!' : ', 未找到匹配'),
-              raw: matched || `共 ${docs.length} 篇，第一篇 docKey=${docs[0]?.docKey || '(无)'}`
+              raw: docs.length > 0 ? { count: docs.length, firstDocDocKey: docs[0]?.docKey || '(无)', firstDocNodeId: docs[0]?.nodeBO?.nodeId || '(无)', firstDocName: docs[0]?.name || '(无)' } : '空结果'
             });
           } catch (e) {
             steps.push({
-              step: `doc search API (workspace=${effectiveWsId})`,
+              step: `doc search API (workspace=${effectiveWsId}, no keyword)`,
               result: '失败',
               raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
             });
           }
+          // Try with keyword from wiki/nodes name if available
+          const wikiName = wikiNodeResponse?.node?.name || wikiNodeResponse?.name || '';
+          if (wikiName) {
+            try {
+              const searchRes = await axios({
+                method: 'GET',
+                url: `${DINGTALK_API_V2}/v1.0/doc/docs`,
+                headers: { 'x-acs-dingtalk-access-token': token },
+                params: { operatorId: opId, workspaceId: effectiveWsId, keyword: wikiName.replace(/\.\w+$/, ''), maxResults: 10 }
+              });
+              const docs = searchRes.data?.docs || [];
+              steps.push({
+                step: `doc search API (keyword="${wikiName}")`,
+                result: `成功 (${docs.length} 篇)`,
+                raw: docs.length > 0 ? docs.map(d => ({ docKey: d.docKey || '(无)', name: d.name || '(无)', nodeId: d.nodeBO?.nodeId || '(无)', dentryUuid: d.nodeBO?.dentryUuid || '(无)' })) : '空结果'
+              });
+            } catch (e) {
+              steps.push({
+                step: `doc search API (keyword="${wikiName}")`,
+                result: '失败',
+                raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+              });
+            }
+          }
         } else {
           steps.push({ step: 'doc search API', result: '跳过（无法获取 workspace_id）' });
         }
@@ -1497,6 +1522,117 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }
         }
 
+        // Step 9: 递归遍历目录树查找文档 + 存储API下载内容
+        if (effectiveWsId) {
+          try {
+            // BFS 遍历目录树查找 dentry
+            let foundDentry = null;
+            let foundSpaceId = null;
+            const queue = [''];
+            const visited = new Set();
+            while (queue.length > 0 && !foundDentry) {
+              const parentId = queue.shift();
+              if (visited.has(parentId)) continue;
+              visited.add(parentId);
+              try {
+                const dirParams = { operatorId: opId, maxResults: 500 };
+                if (parentId) dirParams.dentryId = parentId;
+                const dirRes = await axios({
+                  method: 'GET',
+                  url: `${DINGTALK_API_V2}/v2.0/doc/spaces/${effectiveWsId}/directories`,
+                  headers: { 'x-acs-dingtalk-access-token': token },
+                  params: dirParams
+                });
+                const children = dirRes.data?.children || [];
+                for (const child of children) {
+                  if (child.dentryUuid === input || child.dentryId === input) {
+                    foundDentry = child;
+                    foundSpaceId = child.spaceId;
+                    break;
+                  }
+                  if (child.hasChildren && child.dentryId && !visited.has(child.dentryId)) {
+                    queue.push(child.dentryId);
+                  }
+                }
+              } catch (e) { /* skip */ }
+            }
+
+            if (foundDentry) {
+              steps.push({
+                step: 'BFS 目录遍历找到文档',
+                result: `spaceId=${foundSpaceId}, dentryId=${foundDentry.dentryId}, name=${foundDentry.name}`,
+                raw: foundDentry
+              });
+
+              // 尝试存储 API 获取 dentry 详情（含 docKey）
+              try {
+                const dentryRes = await axios({
+                  method: 'GET',
+                  url: `${DINGTALK_API_V2}/v2.0/storage/spaces/${foundSpaceId}/dentries/${foundDentry.dentryId}`,
+                  headers: { 'x-acs-dingtalk-access-token': token },
+                  params: { operatorId: opId }
+                });
+                steps.push({
+                  step: '存储 API dentry 详情',
+                  result: '成功',
+                  raw: dentryRes.data
+                });
+              } catch (e) {
+                steps.push({
+                  step: '存储 API dentry 详情',
+                  result: '失败',
+                  raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+                });
+              }
+
+              // 尝试存储 API 下载
+              try {
+                const dlRes = await axios({
+                  method: 'POST',
+                  url: `${DINGTALK_API_V2}/v2.0/storage/spaces/${foundSpaceId}/dentries/${foundDentry.dentryId}/downloadInfos/query`,
+                  headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
+                  params: { operatorId: opId },
+                  data: {}
+                });
+                steps.push({
+                  step: '存储 API 获取下载链接',
+                  result: '成功',
+                  raw: dlRes.data
+                });
+                // 尝试从下载链接获取内容
+                const dlInfo = dlRes.data;
+                const downloadUrl = dlInfo.headerSignatureInfo?.resourceUrls?.[0] || dlInfo.downloadUrl || dlInfo.url;
+                if (downloadUrl) {
+                  try {
+                    const contentRes = await axios({ method: 'GET', url: downloadUrl, responseType: 'text' });
+                    steps.push({
+                      step: '存储 API 下载内容',
+                      result: `成功 (${contentRes.data.length} 字符)`,
+                      raw: contentRes.data.slice(0, 500) + (contentRes.data.length > 500 ? '\n... (截断)' : '')
+                    });
+                  } catch (dlErr) {
+                    steps.push({
+                      step: '存储 API 下载内容',
+                      result: '失败',
+                      raw: dlErr.message
+                    });
+                  }
+                }
+              } catch (e) {
+                steps.push({
+                  step: '存储 API 获取下载链接',
+                  result: '失败',
+                  raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+                });
+              }
+            } else {
+              steps.push({ step: 'BFS 目录遍历', result: '未找到匹配（文档可能在深层目录）' });
+            }
+          } catch (e) {
+            steps.push({ step: 'BFS 目录遍历', result: '失败', raw: e.message });
+          }
+        }
+
         const lines = ['🔍 docKey 诊断报告', '', `输入: ${input}`, `operatorId: ${opId}`, ''];
         steps.forEach(s => {
           lines.push(`--- ${s.step} ---`);
@@ -1506,16 +1642,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }
           lines.push('');
         });
-        lines.push('💡 提示:');
-        lines.push('   - wiki/nodes API 成功但无 docKey → 此文档在 doc suite 中没有关联的 docKey');
-        lines.push('   - docKey 是 create_wiki_doc 返回的独立 ID，与 nodeId/dentryUuid 不同');
-        lines.push('   - 对于已有文档（非新建），doc suite API 可能完全不支持');
-        lines.push('   - overwriteContent 也失败 → 不是 blocks 特有的问题');
+        lines.push('💡 诊断结论:');
+        lines.push(`   输入 ID: ${input}`);
+        lines.push(`   操作者: ${opId}`);
+        lines.push('');
+        lines.push('   1️⃣ wiki/nodes API → ✅ 成功。节点存在，但无 document.docKey');
+        lines.push('   2️⃣ blocks API → ❌ "doc key is illegal"');
+        lines.push('   3️⃣ overwriteContent → ❌ 同上错误');
+        lines.push('   4️⃣ doc metadata → ❌ 404（该端点不存在）');
+        lines.push('');
+        lines.push('📌 结论：此 dentryUuid 在 Wiki API 中有效，但在 Doc Suite API 中无效。');
+        lines.push('   blocks/overwriteContent 仅对通过 create_wiki_doc 创建的文档有效');
+        lines.push('   （这类文档返回独立的 docKey，与 nodeId/dentryUuid 不同）');
+        lines.push('');
+        lines.push('📌 现有知识库文档内容读写：无公开 REST API 支持');
+        lines.push('   若需要读取内容，可用 DingTalk 官方 MCP 服务器的 get_document_content');
         if (effectiveWsId) {
-          lines.push(`   - 自动检测到 workspaceId: ${effectiveWsId}`);
-        }
-        if (workspaceId) {
-          lines.push('   - 已提供 workspaceId: ' + workspaceId);
+          lines.push(`   - 此文档 workspaceId: ${effectiveWsId}`);
         }
 
         return { content: [{ type: 'text', text: lines.join('\n') }] };
@@ -1885,10 +2028,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }]
           };
         } catch (blocksErr) {
+          const isDocKeyIllegal = blocksErr.message.includes('doc key is illegal');
+          let hint = '';
+          if (isDocKeyIllegal) {
+            hint = `\n\n原因: 此文档的 dentryUuid 在 Doc Suite API 中无关联 docKey。blocks/overwriteContent\n仅对通过 create_wiki_doc 创建的文档有效。对于知识库中已有文档，钉钉未提供公\n开 REST API 读取内容。可通过 DingTalk 官方 MCP 服务器读取（get_document_content）。`;
+          }
           return {
             content: [{
               type: 'text',
-              text: `❌ blocks API 调用失败\n错误: ${blocksErr.message}\n\n调试信息:\n- 输入 doc_key: ${docKey}\n- 解析后 realDocKey: ${realDocKey}\n- workspaceId: ${workspaceId || '未提供'}\n- operator_id: ${operator_id || '未提供（将自动解析）'}`
+              text: `❌ 读取文档内容失败\n错误: ${blocksErr.message}${hint}\n\n调试信息:\n- 输入 doc_key: ${docKey}\n- 解析后 realDocKey: ${realDocKey}\n- workspaceId: ${workspaceId || '未提供'}\n- operator_id: ${operator_id || '未提供（将自动解析）'}`
             }],
             isError: true
           };
@@ -1917,10 +2065,22 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           } catch (e) { /* ignore */ }
         }
 
-        await dingtalk.docRequest('POST', `/v1.0/doc/suites/documents/${realDocKey}/overwriteContent`, {
-          operatorId: operator_id || null,
-          data: { content, contentType: 'markdown' }
-        });
+        try {
+          await dingtalk.docRequest('POST', `/v1.0/doc/suites/documents/${realDocKey}/overwriteContent`, {
+            operatorId: operator_id || null,
+            data: { content, contentType: 'markdown' }
+          });
+        } catch (e) {
+          const isDocKeyIllegal = e.message.includes('doc key is illegal');
+          let hint = '';
+          if (isDocKeyIllegal) {
+            hint = `\n\n原因: 此文档在 Doc Suite API 中无关联 docKey。overwriteContent 仅对通过 create_wiki_doc 创建的文档有效。`;
+          }
+          return {
+            content: [{ type: 'text', text: `❌ 写入文档内容失败\n${e.message}${hint}` }],
+            isError: true
+          };
+        }
         setImmediate(() => { wikiIndex.update(docKey, { content }); });
         return {
           content: [{ type: 'text', text: '✅ 文档内容已更新' }]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-wiki",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "description": "DingTalk Wiki / Docs read-write MCP server that fills the gap left by DingTalk official MCP.",
   "main": "index.js",
   "bin": {