Agent Skills
返回列表
📁

腾讯文档

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-tencent-docs。

技能介绍

问题背景

很多自动化脚本能调云盘 API,但腾讯文档的鉴权不是单一的 Authorization: Bearer,而是 Access-Token、Client-Id、Open-Id 三头齐发;响应又是统一的 ret / msg / data 信封。若不理解这些约定,很容易出现「请求发了却不知道 token 已过期」或误把 VIP/积分错误当成参数写错。

技能如何工作

本技能围绕 https://docs.qq.com/openapi,用 curl + jq 在用户 本人已连接的腾讯文档账号 内操作——只能访问该用户可见文件,且受连接时授权的 scope 限制。流程上通常先做廉价的 用量计数 校验连接;再按场景走「清单」:doc(在线文档)、sheet(表格)、slide(幻灯片)、mind / flowchart / smartsheet / form 等类型的 列举目录、关键词搜索、读元数据、读正文或单元格区间、创建文件、上传嵌入用图片。列表与搜索支持 游标分页,需把返回的 next marker 原样带回。

写操作有闸口:重命名、移动、删除、复制及权限变更会动真实文件,技能要求先展示目标标题/URL 与目的地,得到明确确认后再执行;删除进回收站仍视为破坏性操作。用户粘贴 docs.qq.com/doc/(或 /sheet/、/slide/ 等)链接时,应从路径 直接解析 fileID,而不是反复索要 ID。

边界与注意点

  • TENCENTDOCS_ACCESS_TOKEN 等同完整账号访问,禁止 echo、打印或打日志。
  • ret != 0 时优先看 msg:400006 应提示用户 重新连接(勿盲目重试);400007 / 400008 分别对应 超级会员 与 AI 积分,属于账号能力而非请求拼写问题。
  • 免费应用约 2 万次/月 调用配额;AI 类能力另耗积分,完整能力还有智能表格记录、收集表、文件夹 CRUD、权限、导入导出等,见官方接口索引。

使用场景

  • 运维报表脚本需把某在线表格 A1:D10 读出并写入内部系统
  • 用户给出 docs.qq.com 文档链接,助手先读元数据再拉取正文做摘要
  • 要在指定 folderID 下新建 sheet 类型文件并返回可分享的 url
  • 批量整理网盘前先按关键词搜索文件,再分页遍历整棵目录

适合人员

  • 内网集成工程师:要把腾讯文档表格区间定时同步到自有服务
  • 技术写作/运营:需要从在线文档 URL 抽取正文做审阅或改写
  • 团队管理员:在确认前提下批量移动、重命名或清理误建文档
  • 接入 tencentdocs BYOC 的 Agent 开发者:要正确处理 ret 码与三头鉴权