腾讯文档
将以下提示词粘贴到你的 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 码与三头鉴权