dingtalk-wiki 1.2.6 → 1.2.8

package/index.js

@@ -726,6 +726,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ['node_id']
         }
       },
+      {
+        name: 'debug_resolve_doc_key',
+        description: '[调试] 诊断 docKey 解析问题，测试所有可能的 API 路径并返回原始响应',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            doc_key: {
+              type: 'string',
+              description: '文档标识（dentryUuid / docKey / nodeId / URL）'
+            },
+            workspace_id: {
+              type: 'string',
+              description: '知识库 ID（可选）'
+            },
+            operator_id: {
+              type: 'string',
+              description: '操作者 unionid（不传则使用默认用户）'
+            }
+          },
+          required: ['doc_key']
+        }
+      },
       {
         name: 'search_wiki',
         description: '按名称搜索知识库中的文档和文件夹（遍历目录树，无需索引即可使用）',
@@ -1286,6 +1308,203 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      case 'debug_resolve_doc_key': {
+        const { doc_key: docKey, workspace_id: workspaceId, operator_id } = args;
+        if (operator_id) {
+          dingtalk.setOperatorId(operator_id);
+        }
+
+        const token = await dingtalk.getAccessToken();
+        const opId = await dingtalk.resolveOperatorId(operator_id || null);
+        const steps = [];
+        const input = String(docKey);
+
+        steps.push({ step: '输入', result: input });
+
+        // Step 1: URL extraction
+        const urlMatch = input.match(/\/i\/nodes\/([^\/\?#]+)/);
+        const urlExtracted = urlMatch ? urlMatch[1] : null;
+        steps.push({ step: 'URL 提取', result: urlExtracted || '无匹配', raw: urlMatch ? urlMatch[0] : null });
+
+        // Step 2: wiki/nodes API
+        try {
+          const nodeRes = await axios({
+            method: 'GET',
+            url: `${DINGTALK_API_V2}/v2.0/wiki/nodes/${input}`,
+            headers: { 'x-acs-dingtalk-access-token': token },
+            params: { operatorId: opId }
+          });
+          const node = nodeRes.data;
+          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 || '(无)',
+            }
+          });
+        } catch (e) {
+          steps.push({
+            step: 'wiki/nodes API',
+            result: '失败',
+            raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+          });
+        }
+
+        // Step 3: doc metadata API (GET /v1.0/doc/suites/documents/{docKey})
+        try {
+          const metaRes = await axios({
+            method: 'GET',
+            url: `${DINGTALK_API_V2}/v1.0/doc/suites/documents/${input}`,
+            headers: { 'x-acs-dingtalk-access-token': token },
+            params: { operatorId: opId }
+          });
+          steps.push({
+            step: 'doc metadata API (GET /documents/{docKey})',
+            result: '成功',
+            raw: metaRes.data
+          });
+        } catch (e) {
+          steps.push({
+            step: 'doc metadata API (GET /documents/{docKey})',
+            result: '失败',
+            raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+          });
+        }
+
+        // Step 4: blocks API
+        try {
+          const blocksRes = await axios({
+            method: 'GET',
+            url: `${DINGTALK_API_V2}/v1.0/doc/suites/documents/${input}/blocks`,
+            headers: { 'x-acs-dingtalk-access-token': token },
+            params: { operatorId: opId }
+          });
+          const blockCount = blocksRes.data?.result?.data?.length || 0;
+          steps.push({
+            step: 'blocks API',
+            result: `成功 (${blockCount} 个 block)`,
+            raw: blocksRes.data
+          });
+        } catch (e) {
+          steps.push({
+            step: 'blocks API',
+            result: '失败',
+            raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+          });
+        }
+
+        // Step 5: overwriteContent API (test with empty content — don't actually write)
+        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 API',
+            result: '成功（可写入）',
+            raw: overwriteRes.data
+          });
+        } catch (e) {
+          steps.push({
+            step: 'overwriteContent API',
+            result: '失败',
+            raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
+          });
+        }
+
+        // Step 6: search docs API (requires workspaceId)
+        if (workspaceId) {
+          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 }
+            });
+            const docs = searchRes.data?.docs || [];
+            const matched = docs.find(d => d.nodeBO?.nodeId === input || d.nodeBO?.dentryUuid === input || d.docKey === 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)'}`
+            });
+          } catch (e) {
+            steps.push({
+              step: 'doc search API (v1.0/doc/docs)',
+              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）' });
+        }
+
+        // Step 7: wiki workspaces + directories search (try all workspaces)
+        if (!workspaceId) {
+          try {
+            const wsRes = await axios({
+              method: 'GET',
+              url: `${DINGTALK_API_V2}/v2.0/wiki/workspaces`,
+              headers: { 'x-acs-dingtalk-access-token': token },
+              params: { operatorId: opId }
+            });
+            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
+            });
+          } catch (e) {
+            steps.push({ step: '遍历知识库目录匹配', result: '失败', raw: e.message });
+          }
+        }
+
+        const lines = ['🔍 docKey 诊断报告', '', `输入: ${input}`, `operatorId: ${opId}`, ''];
+        steps.forEach(s => {
+          lines.push(`--- ${s.step} ---`);
+          lines.push(`结果: ${s.result}`);
+          if (s.raw) {
+            lines.push(`详情: ${JSON.stringify(s.raw, null, 2)}`);
+          }
+          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 参数以启用搜索回退路径');
+        }
+
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+      }
+
       case 'create_wiki_doc': {
         const { workspace_id, parent_node_id, name, doc_type = 'DOC', operator_id } = args;
         if (operator_id) {
@@ -1632,23 +1851,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           } catch (e) { console.error(`[DEBUG] get_wiki_doc_content: search fallback failed: ${e.message}`); }
         }
 
-        console.error(`[DEBUG] get_wiki_doc_content: calling blocks API with docKey=${realDocKey}`);
-        const result = await dingtalk.docRequest('GET', `/v1.0/doc/suites/documents/${realDocKey}/blocks`, { operatorId: operator_id || null });
-        const blocks = result.result?.data || [];
-        let output = '';
-        blocks.forEach((block) => {
-          const text = extractBlockText(block);
-          output += text + '\n\n';
-        });
-        if (!blocks.length) {
-          output = '（文档为空或无可读内容）';
+        try {
+          const result = await dingtalk.docRequest('GET', `/v1.0/doc/suites/documents/${realDocKey}/blocks`, { operatorId: operator_id || null });
+          const blocks = result.result?.data || [];
+          let output = '';
+          blocks.forEach((block) => {
+            const text = extractBlockText(block);
+            output += text + '\n\n';
+          });
+          if (!blocks.length) {
+            output = '（文档为空或无可读内容）';
+          }
+          return {
+            content: [{
+              type: 'text',
+              text: output.trim()
+            }]
+          };
+        } catch (blocksErr) {
+          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 || '未提供（将自动解析）'}`
+            }],
+            isError: true
+          };
         }
-        return {
-          content: [{
-            type: 'text',
-            text: output.trim()
-          }]
-        };
       }
 
       case 'update_wiki_doc_content': {

package/package.json

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