tencent-docs

Files (75)

• SKILL.md
• SOURCE.md
• _meta.json
• aipage_pack.js
• README.md · doc/doc_format/
• pure_text_system_prompt.txt · doc/doc_format/prompt/
• scenario_recognition_prompt.txt · doc/doc_format/prompt/
• style_customization_prompt.txt · doc/doc_format/prompt/
• contract.json · doc/doc_format/templates/
• essay.json · doc/doc_format/templates/
• general.json · doc/doc_format/templates/
• government.json · doc/doc_format/templates/
• paper.json · doc/doc_format/templates/
• entry.md · doc/
• generate_slide.js
• import_file.sh
• ocr.js
• aipage_references.md · references/
• auth.md · references/
• diagram_references.md · references/
• docengine_references.md · references/
• manage_references.md · references/
• ocr_references.md · references/
• slide_references.md · references/
• slideengine_references.md · references/
• smartsheet_references.md · references/
• space_references.md · references/
• unsupported_feature_reporting.md · references/
• workflows.md · references/
• setup.sh
• js-script-rule.md · sheet/api/
• mcp-api.md · sheet/api/
• operation-api.md · sheet/api/
• entry.md · sheet/
• skill.json
• entry.md · smartcanvas/
• mdx_references.md · smartcanvas/
• 12_week_muscle_building_workout_plan.mdx · smartcanvas/template/
• 2025_ai_industry_trend_analysis_report.mdx · smartcanvas/template/
• 2026_family_annual_budget_plan.mdx · smartcanvas/template/
• 2026_personal_annual_goal_plan.mdx · smartcanvas/template/
• annual_holiday_greeting_messages.mdx · smartcanvas/template/
• app_2_project_retrospective.mdx · smartcanvas/template/
• british_shorthair_cat_care_guide.mdx · smartcanvas/template/
• career_growth_books_and_movies_recommendations.mdx · smartcanvas/template/
• chinese_modern_wedding_planning_guide.mdx · smartcanvas/template/
• coffee_shop_location_analysis_report.mdx · smartcanvas/template/
• community_fresh_delivery_feasibility_report.mdx · smartcanvas/template/
• community_group_buying_annual_operation_plan.mdx · smartcanvas/template/
• company_5th_anniversary_event_plan.mdx · smartcanvas/template/
• ecommerce_membership_points_prd.mdx · smartcanvas/template/
• english_self_introduction_for_interview.mdx · smartcanvas/template/
• family_weekly_healthy_meal_plan.mdx · smartcanvas/template/
• finance_graduate_career_plan.mdx · smartcanvas/template/
• food_review_self_media_operation_plan.mdx · smartcanvas/template/
• graduate_admission_recommendation_letter.mdx · smartcanvas/template/
• internet_product_manager_cover_letter.mdx · smartcanvas/template/
• internet_product_manager_interview_checklist.mdx · smartcanvas/template/
• maternity_ecommerce_user_persona_report.mdx · smartcanvas/template/
• new_tea_brand_annual_promotion_plan.mdx · smartcanvas/template/
• …and 15 more

SKILL.md (first lines)

# 腾讯文档 MCP 使用指南

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

## 支持的文档类型

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

## ⚙️ 快速配置

首次安装使用时，需要先完成本地安装和注册，详见 `references/auth.md`。

## 🎯 场景路由表

根据任务场景，选择对应的参考文档：

| 场景 | 文档类型 | 参考文档                                                                                        |
|------|---------|---------------------------------------------------------------------------------------------|
| 报告、笔记、文章、总结等 | smartcanvas | `smartcanvas/entry.md`（MDX 格式，兼容全部 Markdown 语法）                                                                      |
| 结构化数据管理 | smartsheet | `references/smartsheet_references.md`                                                       |
| 计算、筛选、统计、Excel 操作 | sheet | `sheet/entry.md`（sheet.* 系列工具，已集成到 tencent-docs 中） |
| Word 文档编辑 | word  | `references/docengine_references.md`（doc.* 系列工具，已集成到 tencent-docs 中））                       |
| 论文、公文、合同等专业文档（作为docengine替补） | word (doc) | `doc/entry.md`                                                                              |
| PPT / 演示文稿（AI 生成整份 PPT） | slide | `references/slide_references.md`                                                            |
| **PPT / 幻灯片精细编辑（增删页 / 形状 / 文本 / 表格 / 图表 / 批注 / 动画 / 主题 / 备注等任何对已有 PPT 的修改）** | **slide** | **`references/slideengine_references.md`（slide_* 系列工具，必须通过独立的 slide-mcp 服务调用；禁止用 doc_* 或 tencent-docs 通用工具改 PPT）** |
| 层次化知识整理 | mind | `references/diagram_references.md`                                                          |
| 流程/架构展示 | flowchart | `references/diagram_references.md`                                                          |
| 收集表 | form | `references/manage_references.md`（使用 manage.create_file，file_type=form；传入 space_id 可在空间内创建） |
| 知识库空间管理（空间/节点/文件夹） | — | `references/space_references.md`                                                            |
| 图片识别 / 图片转 Word / 图片转 Excel | ocr.* | `references/ocr_references.md`                                                              |
| 获取文档内容、上传图片、网页剪藏等公共接口 | — | `references/workflows.md` (get_content/upload_image)                                        |
| 不支持能力上报（report_unsupported_feature） | — | `references/unsupported_feature_reporting.md`                                               |
| 文件管理（重命名/移动/删除/复制/导入导出/权限等） | — | `references/manage_references.md`                                                           |
| 本地 HTML 一键上云（.aipage 打包+导入） | aipage | `references/aipage_references.md` |
| 其他通用场景 | smartcanvas | `smartcanvas/entry.md`                                                                      |

## 📁 文件目录结构

```
tencent-docs/
├── SKILL.md                        # 入口文件（本文件），全局导航与核心规则
├── setup.sh                        # 本地安装脚本
├── import_file.sh                  # 文件导入辅助脚本（预导入+上传COS）
├── aipage_pack.js                  # 本地 HTML 打包成 .aipage
├── ocr.js                    # 本地图片 OCR 辅助脚本（本地图片→base64→调用 ocr.* 工具，跨平台）
├── references/                     # 参考文档（按品类/功能划分）
│   ├── auth.md                     # 鉴权与授权流程
│   ├── workflows.md                # 公共接口（get_content）+ 常见工作流
│   ├── aipage_references.md        # 本地 HTML → .aipage 打包 + 导入完整工作流
│   ├── smartsheet_references.md    # 智能表格（smartsheet）操作
│   ├── slide_references.md         # 幻灯片（slide/PPT）AI 生成
│   ├── slideengine_references.md   # 幻灯片精细编辑（slide.* 系列工具，通过独立的 slide-mcp 服务调用）
│   ├── diagram_references.md       # 思维导图 + 流程图创建
│   ├── docengine_references.md     # Word 文档精细编辑（doc.* 系列工具，已集成到 tencent-docs 中）
│   ├── space_references.md         # 知识库空间管理（空间/节点/文件夹）
│   ├── manage_references.md        # 文件管理（重命名/移动/删除/复制/导入导出/权限）
│   ├── ocr_references.md           # OCR 图片识别（ocr.extract / ocr.toword / ocr.toexcel）
│   └── unsupported_feature_reporting.md # 不支持能力上报规则（report_unsupported_feature）
├── smartcanvas/                    # 智能文档（smartcanvas）品类模块
│   ├── entry.md                    # 智能文档（smartcanvas）品类入口，创建与编辑
│   └── mdx_references.md           # MDX 格式规范（smartcanvas 内容格式）
├── doc/                            # Word 文档（doc）品类模块
│   ├── entry.md                    # Word 品类入口，工作流指引
│   └── doc_format/                 # Word 格式定义与模板
└── sheet/                          # Excel 文档（sheet）品类模块
    ├── entry.md                    # Sheet 品类入口（含 sheet.* 工具列表与工作流指引）
    └── api/                        # Sheet 专用 API 定义
```

## 🔧 调用方式

### 获取工具列表
```bash
mcporter list tencent-docs
mcporter list slide-mcp
```

### 调用工具

```bash
# 通用文档工具（tencent-docs 服务）
mcporter call "tencent-docs" "<工具名>" --args '<JSON参数>'

# PPT 精细编辑工具（slide-mcp 服务，slide_* 前缀）
mcporter call "slide-mcp" "<工具名>" --args '<JSON参数>'
```

> ⚠️ 参考文档中的参数说明应与 MCP 工具 Schema 保持一致。如有冲突，以 `mcporter list tencent-docs` 或 `mcporter list slide-mcp` 返回的 Schema 为准。

### 通用响应结构

所有 API 返回都包含：
- `error`: 错误信息（成功时为空）
- `trace_id`: 调用链追踪 ID

### API 详细参考

各品类工具的完整 API 说明（调用示例、参数说明、返回值说明）请参考场景路由表中对应的参考文档。公共接口和常见工作流详见 `references/workflows.md`。

## 常见工作流

详见 `references/workflows.md`，包含以下内容：

### 公共接口
- **get_content**：获取文档完整内容，支持所有文档类型的通用读取接口

### 工作流列表
- **搜索并读取文档**：manage.search_file 按关键词搜索 → 获取 file_id → get_content 读取内容
- **智能表格操作**：先 smartsheet.list_tables 获取 sheet_id，再使用 smartsheet.* 系列工具

From chuancyzhang/deepseek-cowork, Apache-2.0.

More from chuancyzhang/deepseek-cowork