dingtalk-wiki 1.2.15 → 1.2.17

package/index.js

@@ -213,7 +213,28 @@ async function rebuildSearchIndex() {
               const blocks = await dingtalk.docRequest('GET', `/v1.0/doc/suites/documents/${childId}/blocks`);
               const blockData = blocks.result?.data || [];
               content = blockData.map(b => extractBlockText(b)).join('\n\n');
-            } catch (e) { /* content unavailable */ }
+            } catch (e) { /* content unavailable via blocks */ }
+
+            // Fallback: 存储 v1.0 下载 API（对上传的 .md 等文件有效）
+            if (!content && child.spaceId) {
+              try {
+                const token = await dingtalk.getAccessToken();
+                const dlRes = await axios({
+                  method: 'POST',
+                  url: `${DINGTALK_API_V2}/v1.0/storage/spaces/${child.spaceId}/dentries/${child.dentryId}/downloadInfos/query`,
+                  headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
+                  params: { unionId: await dingtalk.resolveOperatorId(null) },
+                  data: {}
+                });
+                const data = dlRes.data;
+                const downloadUrl = data.downloadInfo?.resourceUrl || data.resourceUrl || data.downloadUrl || data.url;
+                const downloadHeaders = data.downloadInfo?.headers || data.headers || {};
+                if (downloadUrl) {
+                  const contentRes = await axios({ method: 'GET', url: downloadUrl, headers: downloadHeaders, responseType: 'text' });
+                  content = contentRes.data;
+                }
+              } catch (e) { /* storage v1.0 unavailable */ }
+            }
 
             if (!content) {
               try {
@@ -726,28 +747,6 @@ 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: '按名称搜索知识库中的文档和文件夹（遍历目录树，无需索引即可使用）',
@@ -1308,418 +1307,6 @@ 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 + 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: 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}, 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 (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）' });
-        }
-
-        // 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 || '(无)' }
-            });
-          }
-        }
-
-        // Step 9: 递归遍历目录树查找文档 + 存储API下载内容
-        let foundDentry = null;
-        let foundSpaceId = null;
-        if (effectiveWsId) {
-          try {
-            // BFS 遍历目录树查找 dentry
-            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 });
-          }
-        }
-
-        // Step 10: 存储 API - 文件下载（.md 文件内容 = 文件下载）
-        if (foundSpaceId) {
-          // 方式1: storage/spaces/files/{dentryUuid}
-          for (const path of [
-            `/v2.0/storage/spaces/files/${input}/downloadInfos/query`,
-            `/v2.0/storage/spaces/files/${foundDentry.dentryId}/downloadInfos/query`,
-          ]) {
-            try {
-              const dlRes = await axios({
-                method: 'POST',
-                url: `${DINGTALK_API_V2}${path}`,
-                headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
-                params: { operatorId: opId },
-                data: {}
-              });
-              steps.push({
-                step: `存储下载 (POST ${path})`,
-                result: '成功',
-                raw: dlRes.data
-              });
-            } catch (e) {
-              steps.push({
-                step: `存储下载 (POST ${path})`,
-                result: '失败',
-                raw: { message: e.response?.data?.message || e.message, code: e.response?.data?.code || '(无)', status: e.response?.status || '(无)' }
-              });
-            }
-          }
-          // 方式2: storage/spaces/download 的 GET 变体
-          for (const path of [
-            `/v2.0/storage/spaces/files/${input}/downloadInfo`,
-            `/v2.0/storage/spaces/${foundSpaceId}/files/${input}/downloadInfos/query`,
-            `/v2.0/storage/spaces/${foundSpaceId}/files/${foundDentry.dentryId}/downloadInfos/query`,
-          ]) {
-            try {
-              const dlRes = await axios({
-                method: 'POST',
-                url: `${DINGTALK_API_V2}${path}`,
-                headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
-                params: { operatorId: opId },
-                data: {}
-              });
-              steps.push({
-                step: `存储下载 (POST ${path})`,
-                result: '成功',
-                raw: dlRes.data
-              });
-            } catch (e) {
-              steps.push({
-                step: `存储下载 (POST ${path})`,
-                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(`   输入 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('📌 DocContent API (GET /v2.0/doc/dentries/{uuid}/contents) ✅ 接受 dentryUuid');
-        lines.push('   上次失败原因: 503 ServiceUnavailable（临时服务器问题）');
-        if (effectiveWsId) {
-          lines.push(`   此文档 workspaceId: ${effectiveWsId}`);
-        }
-        lines.push('📌 请重新运行此工具，已加自动重试逻辑');
-
-        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) {
@@ -2050,22 +1637,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         let realDocKey = await resolveDocKey(docKey, operator_id || null, dingtalk);
         console.error(`[DEBUG] get_wiki_doc_content: input=${docKey}, resolved=${realDocKey}`);
 
-        // 如果 resolve 后值没变（可能是 create 返回的 nodeId），尝试搜索 API 查找
-        if (realDocKey === docKey && workspaceId) {
-          try {
-            const searchRes = await dingtalk.docRequest('GET', `/v1.0/doc/docs`, {
-              operatorId: operator_id || null,
-              extraParams: { workspaceId, keyword: '', maxResults: 50 }
-            });
-            const docs = searchRes.docs || [];
-            const matched = docs.find(d => d.nodeBO?.nodeId === docKey || d.nodeBO?.nodeId === realDocKey) || docs[0];
-            if (matched?.nodeBO?.nodeId) {
-              realDocKey = matched.nodeBO.nodeId;
-              console.error(`[DEBUG] get_wiki_doc_content: search fallback resolved to ${realDocKey}`);
-            }
-          } catch (e) { console.error(`[DEBUG] get_wiki_doc_content: search fallback failed: ${e.message}`); }
-        }
-
+        // 尝试 blocks API 读取 .adoc 在线文档内容
         try {
           const result = await dingtalk.docRequest('GET', `/v1.0/doc/suites/documents/${realDocKey}/blocks`, { operatorId: operator_id || null });
           const blocks = result.result?.data || [];
@@ -2085,9 +1657,76 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           };
         } catch (blocksErr) {
           const isDocKeyIllegal = blocksErr.message.includes('doc key is illegal');
+
+          // Fallback: 尝试存储 v1.0 下载 API（对上传的 .md 等文件有效）
+          if (isDocKeyIllegal && workspaceId) {
+            try {
+              const token = await dingtalk.getAccessToken();
+              const opId = await dingtalk.resolveOperatorId(operator_id || null);
+
+              // BFS 遍历查找 dentry
+              const queue = [''];
+              const visited = new Set();
+              let foundDentry = null;
+              let foundSpaceId = null;
+              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/${workspaceId}/directories`,
+                    headers: { 'x-acs-dingtalk-access-token': token },
+                    params: dirParams
+                  });
+                  const children = dirRes.data?.children || [];
+                  for (const child of children) {
+                    if (child.dentryUuid === realDocKey || child.dentryId === realDocKey || child.id === realDocKey) {
+                      foundDentry = child;
+                      foundSpaceId = child.spaceId;
+                      break;
+                    }
+                    if (child.hasChildren && child.dentryId && !visited.has(child.dentryId)) {
+                      queue.push(child.dentryId);
+                    }
+                  }
+                } catch (e) { /* skip */ }
+              }
+
+              if (foundDentry && foundSpaceId) {
+                const dlRes = await axios({
+                  method: 'POST',
+                  url: `${DINGTALK_API_V2}/v1.0/storage/spaces/${foundSpaceId}/dentries/${foundDentry.dentryId}/downloadInfos/query`,
+                  headers: { 'x-acs-dingtalk-access-token': token, 'Content-Type': 'application/json' },
+                  params: { unionId: opId },
+                  data: {}
+                });
+                const data = dlRes.data;
+                const downloadUrl = data.downloadInfo?.resourceUrl || data.resourceUrl || data.downloadUrl || data.url;
+                const downloadHeaders = data.downloadInfo?.headers || data.headers || {};
+                if (downloadUrl) {
+                  const contentRes = await axios({ method: 'GET', url: downloadUrl, headers: downloadHeaders, responseType: 'text' });
+                  return {
+                    content: [{ type: 'text', text: contentRes.data }]
+                  };
+                }
+              }
+            } catch (fallbackErr) {
+              console.error(`[钉钉MCP] 存储 v1.0 fallback 失败: ${fallbackErr.message}`);
+            }
+          }
+
           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）。`;
+            hint = `\n\n原因: 此文档不是 .adoc 在线文档，blocks API 无法读取。`;
+            if (workspaceId) {
+              hint += `\n已尝试存储 v1.0 下载 API 但仍失败（需开通 Storage.DownloadInfo.Read 权限）。`;
+            } else {
+              hint += `\n请提供 workspace_id 以尝试存储 v1.0 下载 API。`;
+            }
           }
           return {
             content: [{
@@ -2107,20 +1746,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
         let realDocKey = await resolveDocKey(docKey, operator_id || null, dingtalk);
 
-        if (realDocKey === docKey && workspaceId) {
-          try {
-            const searchRes = await dingtalk.docRequest('GET', `/v1.0/doc/docs`, {
-              operatorId: operator_id || null,
-              extraParams: { workspaceId, keyword: '', maxResults: 50 }
-            });
-            const docs = searchRes.docs || [];
-            const matched = docs.find(d => d.nodeBO?.nodeId === docKey || d.nodeBO?.nodeId === realDocKey) || docs[0];
-            if (matched?.nodeBO?.nodeId) {
-              realDocKey = matched.nodeBO.nodeId;
-            }
-          } catch (e) { /* ignore */ }
-        }
-
+        // 尝试 overwriteContent API 写入 .adoc 在线文档内容
         try {
           await dingtalk.docRequest('POST', `/v1.0/doc/suites/documents/${realDocKey}/overwriteContent`, {
             operatorId: operator_id || null,
@@ -2130,7 +1756,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           const isDocKeyIllegal = e.message.includes('doc key is illegal');
           let hint = '';
           if (isDocKeyIllegal) {
-            hint = `\n\n原因: 此文档在 Doc Suite API 中无关联 docKey。overwriteContent 仅对通过 create_wiki_doc 创建的文档有效。`;
+            hint = `\n\n原因: 此文档不是 .adoc 在线文档（可能是上传的 .md 文件），不支持修改。overwriteContent 仅对 .adoc 在线文档有效。`;
           }
           return {
             content: [{ type: 'text', text: `❌ 写入文档内容失败\n${e.message}${hint}` }],

package/package.json

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