dingtalk-wiki 1.2.8 → 1.2.9

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,81 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           });
         }
 
-        // Step 6: search docs API (requires workspaceId)
-        if (workspaceId) {
+        // Step 6: search docs API (v1.0/doc/docs) — 需要 workspaceId
+        if (effectiveWsId) {
           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})`,
+              result: `成功 (${docs.length} 篇文档)` + (matched ? ', 找到匹配!' : ', 未找到匹配'),
+              raw: matched || `共 ${docs.length} 篇，第一篇 docKey=${docs[0]?.docKey || '(无)'}`
             });
           } catch (e) {
             steps.push({
-              step: 'doc search API (v1.0/doc/docs)',
+              step: `doc search API (workspace=${effectiveWsId})`,
               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 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: `知识库目录 (workspace=${effectiveWsId})`,
+              result: `${children.length} 个子节点` + (match ? ', 找到匹配!' : ', 未找到匹配'),
+              raw: match ? match : { sampleFields: sampleKeys, firstChildSample: children[0] || null }
+            });
+          } catch (e) {
+            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' }
             });
-            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 */ }
-            }
             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: 'overwriteContent（带 workspaceId）',
+              result: '成功',
+              raw: overwriteRes.data
             });
           } catch (e) {
-            steps.push({ step: '遍历知识库目录匹配', result: '失败', raw: e.message });
+            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 +1506,16 @@ 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('   - 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 特有的问题');
+        if (effectiveWsId) {
+          lines.push(`   - 自动检测到 workspaceId: ${effectiveWsId}`);
+        }
+        if (workspaceId) {
+          lines.push('   - 已提供 workspaceId: ' + workspaceId);
         }
 
         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.9",
   "description": "DingTalk Wiki / Docs read-write MCP server that fills the gap left by DingTalk official MCP.",
   "main": "index.js",
   "bin": {