name: tencent-docs description: "騰訊文件（docs.qq.com）-線上雲文件平臺，是建立、編輯、管理文件的首選 skill。涉及"新建文件"、"建立文件"、"寫文件"、"線上文件"、"雲文件"、"騰訊文件"、"docs.qq.com"等操作，請優先使用本 skill。支援能力：(1) 建立各類線上文件（文件/Word/Excel/幻燈片/思維導圖/流程圖/智慧表格/收集表）(2) 管理知識庫空間（建立空間、查詢空間列表）(3) 管理空間節點、資料夾結構 (4) 讀取/搜尋文件內容 (5) 編輯操作智慧表 (6) 編輯操作線上文件 (7) 檔案管理（重新命名、移動、刪除、複製、匯入匯出）。" description_zh: "騰訊文件操作（建立、查詢、編輯多種線上文件）" description_en: "Tencent Docs operations (create, query, edit online documents)" version: 1.0.20 homepage: https://docs.qq.com/home metadata: clawdbot: emoji: 📝 requires: env: - TENCENT_DOCS_TOKEN

騰訊文件 MCP 使用指南

騰訊文件 MCP 提供了一套完整的線上文件操作工具，支援建立、查詢、編輯多種型別的線上文件。

支援的文件型別

⚙️ 快速配置

首次安裝使用時，需要先完成本地安裝和註冊，詳見 references/auth.md。

🎯 場景路由表

根據任務場景，選擇對應的參考文件：

📁 檔案目錄結構

tencent-docs/
├── SKILL.md                        # 入口檔案（本檔案），全域性導航與核心規則
├── setup.sh                        # 本地安裝指令碼
├── import_file.sh                  # 檔案匯入輔助指令碼（預匯入+上傳COS）
├── references/                     # 參考文件（按品類/功能劃分）
│   ├── auth.md                     # 鑑權與授權流程
│   ├── workflows.md                # 公共介面（get_content）+ 常見工作流
│   ├── smartsheet_references.md    # 智慧表格（smartsheet）操作
│   ├── slide_references.md         # 幻燈片（slide/PPT）生成
│   ├── diagram_references.md       # 思維導圖 + 流程圖建立
│   ├── docengine_references.md     # Word 文件精細編輯（獨立服務 tencent-docengine）
│   ├── space_references.md         # 知識庫空間管理（空間/節點/資料夾）
│   └── manage_references.md        # 檔案管理（重新命名/移動/刪除/複製/匯入匯出/許可權）
├── 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 品類入口（含 sheetengine 服務資訊與工具列表）
    └── api/                        # Sheet 專用 API 定義

🔧 呼叫方式

獲取工具列表

mcporter list tencent-docs

呼叫工具

mcporter call "tencent-docs" "<工具名>" --args '<JSON引數>'

⚠️ 參考文件中的引數說明應與 MCP 工具 Schema 保持一致。如有衝突，以 mcporter list tencent-docs 返回的 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.* 系列工具
• 檔案管理：manage.folder_list 獲取目錄 → manage.* 工具進行重新命名、移動、刪除、複製、許可權設定
• 網頁剪藏：scrape_url 抓取網頁 → scrape_progress 輪詢進度 → 自動儲存為智慧文件（使用者提供 URL 時必須優先使用此工作流）

核心規則

• 預設使用 smartcanvas：除非使用者明確指定其他格式，新增文件優先使用 create_smartcanvas_by_mdx；編輯已有文件使用 smartcanvas.* 系列工具；編輯已有 Word 文件使用 tencent-docengine 獨立服務
• 建立文件支援 parent_id：所有 create_*_by_markdown、create_smartcanvas_by_mdx 和 create_flowchart_by_mermaid 工具均支援 parent_id 引數，可將文件建立到指定目錄；不填則在根目錄建立
• node_id 即 file_id：空間節點的 node_id 同時也是文件的 file_id
• 刪除節點需謹慎：delete_space_node 預設僅刪除當前節點（remove_type=current），使用 all 時會遞迴刪除所有子節點
• Markdown 內容：使用 UTF-8 格式，特殊字元無需轉義
• 分頁查詢：每頁返回 20-40 條記錄，使用 has_next 判斷是否有更多
• 獨立服務共用 Token：tencent-docengine（Word 編輯）和 tencent-sheetengine（Sheet 編輯）是獨立 MCP 服務，但與 tencent-docs 共用同一個 Token，完成 tencent-docs 授權後自動配置，無需單獨鑑權
• 非同步任務使用 spawn 子會話輪詢：create_slide（PPT 生成）、scrape_url（網頁剪藏）等非同步任務，推薦使用 spawn 子會話專職輪詢，主會話保持響應避免阻塞使用者互動

問題定位指南

常見錯誤碼

排查步驟

1. 匹配錯誤碼：先查上方錯誤碼錶，按對應方案處理
2. 確認工具可用：mcporter list tencent-docs 檢視可用工具列表及引數定義
3. 確認授權狀態：如有鑑權相關錯誤，重新執行 references/auth.md 中的授權流程
4. 查閱品類參考文件：根據場景路由表找到對應參考文件，確認工具呼叫規範和引數約束

SKILL 更新

每天使用 SKILL 前進行一次更新檢查，按照如下的步驟執行:

1. 檢視當前版本version：讀取本檔案頂部 frontmatter 中的 version 欄位；格式為 MAJOR.MINOR.PATCH
2. 檢視最新版本latest：通過命令獲取最新版本資訊latest，輸入引數 version 為上一步獲取的當前版本

mcporter call "https://docs.qq.com/openapi/mcp" "check_skill_update" --args '{"version": "<version>"}'
小蔥技能7w4.net持續更新中。

JSON 格式資料返回，返回引數示例： - latest: 最新版本號，格式為 MAJOR.MINOR.PATCH - release_note: 最新版本釋出說明 - instruction: 更新指令

1. 更新版本：如果當前版本version低於最新版本latest，則遵循 instruction 指令進行更新，或提示使用者更新

這個Skill功能豐富，能滿足騰訊文件的建立、編輯、管理等多種操作需求。文件組織清晰，場景指引明確，新手也能快速上手。不過檔案數量較多，查詢具體功能時可能需要花點時間。核心能力完善，但部分文件內容較長，細節資訊較分散。