dingtalk-wiki 1.2.8 → 1.2.10

package/index.js

@@ -1327,6 +1327,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         steps.push({ step: 'URL 提取', result: urlExtracted || '无匹配', raw: urlMatch ? urlMatch[0] : null });
 
         // Step 2: wiki/nodes API
+        let wikiNodeResponse = null;
+        let wikiWsId = null;
         try {
           const nodeRes = await axios({
             method: 'GET',
@@ -1334,19 +1336,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             headers: { 'x-acs-dingtalk-access-token': token },
             params: { operatorId: opId }
           });
-          const node = nodeRes.data;
+          wikiNodeResponse = nodeRes.data;
+          wikiWsId = wikiNodeResponse.workspaceId || wikiNodeResponse.node?.workspaceId || null;
+          const node = wikiNodeResponse;
           steps.push({
             step: 'wiki/nodes API',
             result: '成功',
-            raw: {
-              nodeId: node.nodeId || node.id || node.node?.nodeId || '(无)',
-              name: node.name || node.node?.name || '(无)',
-              docKey: node.document?.docKey || node.docKey || node.node?.document?.docKey || '(无)',
-              dentryUuid: node.dentryUuid || node.node?.dentryUuid || '(无)',
-              hasChildren: node.hasChildren || node.node?.hasChildren || '(无)',
-              type: node.type || node.node?.type || '(无)',
-              workspaceId: node.workspaceId || node.node?.workspaceId || '(无)',
-            }
+            raw: node
           });
         } catch (e) {
           steps.push({
@@ -1356,6 +1352,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           });
         }
 
+        const effectiveWsId = workspaceId || wikiWsId;
+
         // Step 3: doc metadata API (GET /v1.0/doc/suites/documents/{docKey})
         try {
           const metaRes = await axios({
@@ -1421,67 +1419,106 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           });
         }
 
-        // Step 6: search docs API (requires workspaceId)
-        if (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',
               url: `${DINGTALK_API_V2}/v1.0/doc/docs`,
               headers: { 'x-acs-dingtalk-access-token': token },
-              params: { operatorId: opId, workspaceId, maxResults: 10 }
+              params: { operatorId: opId, workspaceId: effectiveWsId, maxResults: 50 }
             });
             const docs = searchRes.data?.docs || [];
-            const matched = docs.find(d => d.nodeBO?.nodeId === input || d.nodeBO?.dentryUuid === input || d.docKey === input);
+            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 (v1.0/doc/docs)',
-              result: `成功 (${docs.length} 篇文档)` + (matched ? ', 找到匹配' : ', 未找到匹配'),
-              raw: matched || `${docs.length} results, first doc docKey=${docs[0]?.docKey || '(none)'}`
+              step: `doc search API (workspace=${effectiveWsId}, no keyword)`,
+              result: `成功 (${docs.length} 篇文档)` + (matched ? ', 找到匹配!' : ', 未找到匹配'),
+              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 (v1.0/doc/docs)',
+              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 (v1.0/doc/docs)', result: '跳过（需 workspace_id）' });
+          steps.push({ step: 'doc search API', result: '跳过（无法获取 workspace_id）' });
         }
 
-        // Step 7: wiki workspaces + directories search (try all workspaces)
-        if (!workspaceId) {
+        // Step 7: 在知识库目录中查找此节点 + 查看是否有 docKey 字段
+        if (effectiveWsId) {
           try {
-            const wsRes = await axios({
+            const dirRes = await axios({
               method: 'GET',
-              url: `${DINGTALK_API_V2}/v2.0/wiki/workspaces`,
+              url: `${DINGTALK_API_V2}/v2.0/doc/spaces/${effectiveWsId}/directories`,
               headers: { 'x-acs-dingtalk-access-token': token },
-              params: { operatorId: opId }
+              params: { operatorId: opId, maxResults: 500 }
             });
-            const workspaces = wsRes.data?.workspaces || [];
-            let found = null;
-            for (const ws of workspaces) {
-              if (found) break;
-              try {
-                const dirRes = await axios({
-                  method: 'GET',
-                  url: `${DINGTALK_API_V2}/v2.0/doc/spaces/${ws.workspaceId}/directories`,
-                  headers: { 'x-acs-dingtalk-access-token': token },
-                  params: { operatorId: opId, maxResults: 500 }
-                });
-                const children = dirRes.data?.children || [];
-                const match = children.find(c => c.dentryUuid === input || c.dentryId === input || c.id === input);
-                if (match) {
-                  found = { workspaceId: ws.workspaceId, workspaceName: ws.name, node: match };
-                }
-              } catch (dirErr) { /* skip workspace */ }
-            }
+            const children = dirRes.data?.children || [];
+            const match = children.find(c => c.dentryUuid === input || c.dentryId === input || c.id === input);
+            // Show first few children's available fields so user can see what fields exist
+            const sampleKeys = children.length > 0 ? Object.keys(children[0]) : [];
             steps.push({
-              step: '遍历知识库目录匹配',
-              result: found ? `在知识库 ${found.workspaceName}(${found.workspaceId}) 中找到` : '在所有知识库中未找到匹配',
-              raw: found ? { workspaceId: found.workspaceId, name: found.node?.name, dentryUuid: found.node?.dentryUuid, dentryId: found.node?.dentryId, hasChildren: found.node?.hasChildren, contentType: found.node?.contentType, docKey: found.node?.docKey || '(无)' } : null
+              step: `知识库目录 (workspace=${effectiveWsId})`,
+              result: `${children.length} 个子节点` + (match ? ', 找到匹配!' : ', 未找到匹配'),
+              raw: match ? match : { sampleFields: sampleKeys, firstChildSample: children[0] || null }
             });
           } catch (e) {
-            steps.push({ step: '遍历知识库目录匹配', result: '失败', raw: e.message });
+            steps.push({
+              step: `知识库目录 (workspace=${effectiveWsId})`,
+              result: '失败',
+              raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+            });
+          }
+        }
+
+        // Step 8: 用 workspaceId 再次尝试 overwriteContent（确认文档套件是否完全不可用）
+        if (effectiveWsId) {
+          try {
+            const overwriteRes = await axios({
+              method: 'POST',
+              url: `${DINGTALK_API_V2}/v1.0/doc/suites/documents/${input}/overwriteContent`,
+              headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
+              params: { operatorId: opId },
+              data: { content: 'test', contentType: 'markdown' }
+            });
+            steps.push({
+              step: 'overwriteContent（带 workspaceId）',
+              result: '成功',
+              raw: overwriteRes.data
+            });
+          } catch (e) {
+            steps.push({
+              step: 'overwriteContent（带 workspaceId）',
+              result: '失败',
+              raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+            });
           }
         }
 
@@ -1494,12 +1531,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }
           lines.push('');
         });
-        lines.push('💡 提示: 如果 wiki/nodes API 成功并返回了 docKey，请使用该 docKey 调用 get_wiki_doc_content');
-        lines.push('   如果 doc metadata API 成功，说明该 docKey 在 doc suite 中有效');
-        lines.push('   如果 blocks API 失败但 overwriteContent 成功，问题在 blocks API 端');
-        lines.push('   如果所有 API 都失败，说明该 docKey 在 doc suite 中不存在');
-        if (!workspaceId) {
-          lines.push('   建议提供 workspace_id 参数以启用搜索回退路径');
+        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}`);
         }
 
         return { content: [{ type: 'text', text: lines.join('\n') }] };

package/package.json

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