dingtalk-wiki 1.2.7 → 1.2.9

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,219 @@ 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
+        let wikiNodeResponse = null;
+        let wikiWsId = null;
+        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 }
+          });
+          wikiNodeResponse = nodeRes.data;
+          wikiWsId = wikiNodeResponse.workspaceId || wikiNodeResponse.node?.workspaceId || null;
+          const node = wikiNodeResponse;
+          steps.push({
+            step: 'wiki/nodes API',
+            result: '成功',
+            raw: node
+          });
+        } 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 || '(无)' }
+          });
+        }
+
+        const effectiveWsId = workspaceId || wikiWsId;
+
+        // 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 (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: effectiveWsId, maxResults: 50 }
+            });
+            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})`,
+              result: `成功 (${docs.length} 篇文档)` + (matched ? ', 找到匹配!' : ', 未找到匹配'),
+              raw: matched || `共 ${docs.length} 篇，第一篇 docKey=${docs[0]?.docKey || '(无)'}`
+            });
+          } catch (e) {
+            steps.push({
+              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', result: '跳过（无法获取 workspace_id）' });
+        }
+
+        // Step 7: 在知识库目录中查找此节点 + 查看是否有 docKey 字段
+        if (effectiveWsId) {
+          try {
+            const dirRes = await axios({
+              method: 'GET',
+              url: `${DINGTALK_API_V2}/v2.0/doc/spaces/${effectiveWsId}/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);
+            // 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' }
+            });
+            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 || '(无)' }
+            });
+          }
+        }
+
+        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('💡 提示:');
+        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') }] };
+      }
+
       case 'create_wiki_doc': {
         const { workspace_id, parent_node_id, name, doc_type = 'DOC', operator_id } = args;
         if (operator_id) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-wiki",
-  "version": "1.2.7",
+  "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": {