WorkBuddy 连腾讯文档实测：从"状态灯是绿的"到"接口真的通"，我踩了这些坑

本文参与 #WorkBuddy 话题征文。起因很简单：我想让 WorkBuddy 帮我把会议纪要整理进腾讯文档，结果发现"连接器显示已连接"和"连接器真的能用"是两回事。这篇记录我从零验证到跑通"创建→写入→读取→分享"完整链路的全过程，所有返回结果都是实测真实输出。

一、起因：状态灯是绿的，然后呢？

WorkBuddy 的连接器管理页面里，"腾讯文档（个人版）"的状态灯是绿色的——已连接。

但我的需求是让 AI 把会议纪要直接整理成在线文档，这中间隔着：鉴权票据有没有过期？能不能创建文档？写入的内容读回来对不对？新文档权限默认是什么？能不能直接分享给同事？

状态灯回答不了这些问题。连接器这东西，状态灯只说明"曾经授权过"，能不能用得接口说了算。 于是我决定做一轮接口级实测。

二、实测环境与前置检查

腾讯文档个人版的能力分散在多个 MCP endpoint 上（这是个重要的坑，后面细说）：

第一步先做环境检查（鉴权票据有效性）：

python tencentdocs.py tdoc_init
# 输出：READY

返回 READY，票据有效，开干。（如果返回 ERROR:no_token，需要回 WorkBuddy 重新授权。）

tdoc_init 返回 READY，票据有效

三、实测链路：五步走完"创建→验证→分享"

第 1 步：创建会议纪要文档

会议纪要属于"报告/笔记/纪要"类内容，首选智能文档，用 create_smartcanvas_by_mdx 创建，参数就三个：标题、正文、格式。

{
  "title": "会议纪要模板_WorkBuddy实测_20260830",
  "content_format": "markdown",
  "mdx": "# 会议纪要模板\n\n## 一、会议基本信息\n| 项目 | 内容 |\n|---|---|..."
}

实测返回（真实输出）：

{
  "error": "",
  "file_id": "KFkXBcNbJFki",
  "url": "https://docs.qq.com/aio/DS0ZrWEJjTmJKRmtp"
}

几秒钟，一份带表格的在线文档就躺在我的腾讯文档账号里了。file_id 是后续所有操作的钥匙，务必保存。

生成的会议纪要模板在线文档

第 2 步：读回内容，验证写入

这一步是整个实测里我最想强调的：写进去 ≠ 写对了。用 get_content 把内容读回来核对：

get_content({"file_id": "KFkXBcNbJFki"})
→ 会议纪要模板_WorkBuddy实测_20260830
  一、会议基本信息 | 项目 | 内容 |
  | 会议主题 |（填写会议主题）| ...
  五、其他说明 本模板由 WorkBuddy 连接腾讯文档（个人版）实测创建

get_content 读回验证的终端输出

章节、表格、字段全部一致，写入验证通过。会议纪要这种要发给领导同事的东西，没有读回验证就不算写入完成——这是血泪经验，AI 场景下"静默出错但看起来很专业"的坑太多了。

第 3 步：确认账号归属

顺手调了一下 get_user_info，确认文档落在了哪个账号下：

{ "nick": "卫 ", "user_id": "144115262265496778" }

是我自己的微信授权账号，链路归属清晰。多账号用户（个人版 + 企业版都有）尤其要确认这一步，避免文档建到了另一个账号里。

第 4 步：查权限默认值

get_privilege({"file_id": "KFkXBcNbJFki"})
→ { "policy": 0 }

policy=0 是私密文档——新文档默认只有自己可见。这个默认值很安全，但要分享会议纪要的话就得走下一步。

第 5 步：设置为链接可读，分享闭环

set_privilege({"file_id": "KFkXBcNbJFki", "policy": 2})
get_privilege({"file_id": "KFkXBcNbJFki"})   # 回查确认
→ { "policy": 2 }                              # 已生效

policy=2 所有人可读、policy=3 所有人可编辑。注意我设置完又查了一遍——改权限这种操作，必须回查确认生效，不能只看调用没报错。

至此，"AI 整理会议纪要 → 自动建文档 → 内容核对 → 分享给参会人"的完整工作流验证通过。

四、踩坑记录（都是真金白银换的）

坑 1：状态灯 ≠ 可用。 我遇到过状态灯显示已连接、实际调用时票据失效的情况。养成习惯：每次重要工作流开始前先 tdoc_init 检查一下，5 秒钟省一场空。

坑 2：命令行传长 JSON 会被引号坑。 往接口里传带中文、括号、换行的长 Markdown 内容时，命令行引号解析直接断裂（unexpected EOF while looking for matching quote）。解法很朴素：把参数写进 JSON 文件，用小包装脚本读文件再调用，一劳永逸。凡是要传大段内容的场景，别在命令行里硬拼字符串。

坑 3：多 endpoint 路由。 想精细编辑 Word 类文档却调了主服务的转发工具，会拿到阉割版能力甚至报错。认准品类：Word 编辑走 doc-mcp，表格走 sheet-mcp，PPT 走 slide-mcp，文件管理和智能文档走主服务。

坑 4：个人版和企业版是两个连接器。 tencent-docs（个人版）和 tencent-docs-oa（企业版）各自独立授权。文档建错账号的惨案，多数源于没分清这两个。

五、这套工作流适合谁

• 会议纪要：录音转文字 → 让 WorkBuddy 按模板整理 → 自动建在线文档 → 设链接可读发群里。全程不动手。
• 周报/日报归档：本地写好的 Markdown 直接 create_smartcanvas_by_mdx 上云，团队共享。
• 资料收集：配合网页剪藏能力，把散落的资料沉淀成结构化在线文档。

一句话总结：连接器不是连上就算完，跑一遍"创建→读回→权限"的最小闭环，才算真正落地。

本文实测文档（会议纪要模板）在此，可自行查看效果：https://docs.qq.com/aio/DS0ZrWEJjTmJKRmtp