tencent-docs

# 腾讯文档 MCP 使用指南

腾讯文档 MCP 提供了一套完整的在线文档操作工具，支持创建、查询、编辑多种类型的在线文档。

## 支持的文档类型

| 类型    | doc_type             | 推荐度       | 说明                                                   |
|-------| -------------------- | ------------ | ------------------------------------------------------ |
| 智能文档  | smartcanvas          | ⭐⭐⭐  | 排版美观，支持丰富组件；MDX 格式兼容全部 Markdown 语法 |
| Excel | sheet / tencentsheet | ⭐⭐⭐          | 数据表格专用                                           |
| PPT   | slide / tencentslide | ⭐⭐⭐          | 幻灯片，演示文稿专用                                   |
| 思维导图  | mind                 | ⭐⭐⭐          | 知识图谱专用                                           |
| 流程图   | flowchart            | ⭐⭐⭐          | 流程展示专用                                           |
| Word  | doc / tencentdoc     | ⭐⭐           | 传统格式，排版一般                                     |
| 收集表   | form / tencentform   | ⭐⭐           | 表单收集                                               |
| 智能表格  | smartsheet           | ⭐⭐⭐          | 高级结构化表格，支持多视图、字段管理                   |
| Html  | smartpage            | ⭐⭐⭐          | html演示文稿专用                                       |

## ⚙️ 快速配置

本 skill 由 Pinvou 工具商店的「腾讯文档 MCP」连接器自动安装，四个 MCP 服务（tencent-docs / tdoc-slide / tdoc-doc / tdoc-sheet）共用同一个 Token，已由连接器写入本机系统凭据，无需在对话中配置。鉴权报错时见 `references/auth.md` 的处理指引。

## 🎯 场景路由表

**先判断用户的操作意图属于以下 4 大类中的哪一类，再按子表路由到对应工具与参考文档。** 同一句话可能混合多个意图（如"把这份 PPT 改一下并重命名"），按"主操作"归类，必要时分步执行。

```
用户意图
 ├─ 想"从无到有"产出一份文档        → 1️⃣ 文档创建
 ├─ 想修改 / 增删 已有文档的内容    → 2️⃣ 文档改写、内容增删
 ├─ 只动文件/目录本身（不碰内容）   → 3️⃣ 文件管理动作
 └─ 想把图片/其他格式转成文档       → 4️⃣ 转换工具
```

### 1️⃣ 文档创建（从无到有新建文档）

根据用户意图**识别目标品类**，路由到该品类的创建方法。**创建空白文档使用 `manage.create_file`**。

| 用户意图 / 关键词                                | 品类          | 首选创建方法                                         | 参考文档                                 |
|-------------------------------------------|-------------|------------------------------------------------|--------------------------------------|
| PPT / 幻灯片 / 演示文稿（生成整份 / 续写 / 改页等所有 PPT 任务） | slide       | **走 Slide 品类工作流（JSX + tdoc-slide）**             | `slide/entry.md`                     |
| 思维导图 / 脑图 / 层次化知识整理                       | mind        | **`create_mind_by_markdown`**                | `references/diagram_references.md`   |
| 流程图 / 架构图 / 流程展示                          | flowchart   | **`create_flowchart_by_mermaid`**            | `references/diagram_references.md`   |
| 报告 / 笔记 / 文章 / 总结 / 会议纪要 / Markdown       | smartcanvas | **`create_smartcanvas_by_mdx`**                    | `smartcanvas/entry.md`           |
| 论文 / 公文 / 合同等专业 Word 文档                   | doc         | doc 品类创建                                       | `doc/entry.md`                       |
| 数据表格 / 计算 / 统计（Excel）                     | sheet       | sheet 品类创建                                     | `sheet/entry.md`                     |
| 结构化数据管理 / 多视图表格                           | smartsheet  | smartsheet 品类创建                                | `references/smartsheet_references.md` |
| 收集表 / 表单                                  | form        | `manage.create_file`                           | `references/manage_references.md`    |
| **空文件 / 上述品类创建失败的兜底**                     | —           | **`manage.create_file`**                       | `references/manage_references.md`    |

### 2️⃣ 文档改写、内容增删（编辑已有文档）

**先判断原始文档的类型**（通过 `file_id` / 文档链接前缀 / `manage.query_file_info`等手段确定品类），**再路由到对应品类的编辑工具集**。严禁用 A 品类的工具去改 B 品类文档。

| 原始文档类型                                                                          | 品类         | 编辑工具集            | 参考文档                                       |
| ------------------------------------------------------------------------------------- | ------------ | --------------------- |--------------------------------------------|
| 智能文档（报告/笔记/文章）                                                            | smartcanvas  | `smartcanvas.*`       | `smartcanvas/entry.md`                     |
| **PPT / 幻灯片**（增删页 / 形状 / 文本 / 表格 / 图表 / 批注 / 动画 / 主题 / 备注等）  | slide        | **`slide_*`（tdoc-slide）**，统一按 Slide 工作流执行 | **`slide/entry.md`（工作流） + `references/slideengine_references.md`（工具 API）** |
| Word 文档                                                                             | doc          | `doc.*`（tdoc-doc）    | `references/docengine_references.md`        |
| Excel / 计算 / 筛选 / 统计 / 保护区域                                                  | sheet        | `sheet.*`（tdoc-sheet）| `sheet/entry.md`                           |
| 智能表格（结构化数据管理）                                                            | smartsheet   | `smartsheet.*`        | `references/smartsheet_references.md`      |

### 3️⃣ 文件管理动作（不改内容，只动文件 / 目录 / 权限）

| 动作                                                       | 参考文档                            |
| ---------------------------------------------------------- | ----------------------------------- |
| 重命名 / 移动 / 删除 / 复制 / 导入导出 / 权限变更          | `references/manage_references.md`   |
| 知识库空间管理（创建空间 / 空间列表 / 节点 / 文件夹结构）  | `references/space_references.md`    |

### 4️⃣ 转换工具（图片 / 格式转文档）

| 场景                                          | 工具      | 参考文档                          |
| --------------------------------------------- | --------- | --------------------------------- |
| 图片识别 / 图片转 Word / 图片转 Excel（OCR） | `ocr.*`   | `references/ocr_references.md`    |

### 📎 公共能力

| 场景                                              | 参考文档                                             |
| ------------------------------------------------- | ---------------------------------------------------- |
| 获取文档内容 / 上传图片                           | `references/workflows.md`（get_content / upload_image） |
| 网页剪藏（URL → 文档）                            | `references/workflows.md`（scrape_url → scrape_progress） |
| 本地文件 / HTML 一键上云（.aipage 打包 + 导入）   | `references/aipage_references.md`                    |
| 不支持能力上报（report_unsupported_feature）      | `references/unsupported_feature_reporting.md`        |

## 📁 文件目录结构

```
tencent-docs/
├──