工具 API

slide_add_image

在指定幻灯片插入一张图片。【图片来源选择优先级（按推荐顺序）】方式一（⭐首选）：本地脚本（insert_image.py）通过 HTTP 直接调用 MCP endpoint 插入图片，无需把图片 base64 通过 MCP 通道透传，避免大图触发上下文/传输限制，速度也更快。方式二（备选）：传 image_id —— 当无法在本地执行脚本，但可以先通过 upload_image MCP 工具或腾讯文档开放平台 OpenAPI 把图片上传后获取 image_id 时使用。方式三（兜底）：传 content（图片 base64 字符串，不含 data URI 前缀）—— 仅适合图片体积较小的场景；若 base64 超出 MCP 单次传输限制会失败，此时请回退到方式一脚本调用。【限制】单张图片大小不超过 10MB；支持 PNG / JPG / JPEG / GIF / BMP / WEBP / SVG 格式；【⭐图片等比缩放（强制，禁止违反）】入参 w / h 必须严格保持图片原始宽高比（uniform scale only）：即 w / h == 原图 width / height；绝对禁止只调宽不调高、或只调高不调宽——任何横向单独缩放/纵向单独缩放都会导致图片变形，属于硬性禁令；推荐做法：先取得图片原始尺寸，按目标占位框 (W,H) 计算 s = min(W/origW, H/origH)，最终传入 w = origW * s，h = origH * s；简化：若仅指定 w，则按 h = w * origH / origW 推算 h；仅指定 h 同理；w / h 同时 <= 0 时使用图片自身原始尺寸；如果图片在目标占位框内放不下（按等比缩放后会留大块空白或溢出画布），禁止通过非等比拉伸强行填满——应重新设计该页面布局；画布默认 16:9 = 960 x 540 pt；调用 slide_get_page_info 获取实际尺寸后再决定占位框范围。（SLIDE） if both tencent-docs (personal) and tencent-docs-oa (enterprise) are connected, use AskUserQuestion to let the user pick the target account before invoking this tool.