ACCOUNT → ACCESS → KNOWLEDGE

Buddy One × 腾讯文档
一次关联，怎样走到一份报告？

案例：关联腾讯文档，把「星河项目计划」接入 WorkBuddy，再与本地 PDF 附件一起整理周报。

发行代码已确认身份关联 → 凭据与工具就绪 → 按需检索 / 读取 → Agent 整理离线说明 · 不调用真实接口

A /

接入流程：先建立关系，再准备访问能力

实线 = 已定位的客户端调用链

流程图可左右滑动查看。

把它想成给助理办通行手续：关联账号、开通访问渠道，随后才按任务取材料。已关联的账号可复用，省略重复办理。

① 接入伪代码

补充关联文档的示例

// URL 省略号仅用于排版；见下方证据。
GET /api/v1/copilot/account/buddyone/apps
POST /api/v1/copilot/account/buddyone/link/apply
{ scene: "upgrade_target_app",
  target_app: "doc" }
openOneID(state_token)  // 用户确认

POST /v2/as/connector/oauth/buddyone-connect
{ connectors: [{ name: "tdocs-app" }] }
if connected && currentAccount:
  connectAuthorized("tencent-docs", token?)
  ensureInstalled(); refreshLibraryAuth()

首次整体加入可走 scene:"normal"；这里选“补充关联文档”。票据有效期、账户一致性和连接成功都要检查。

② 真正的搜索请求

独立的数据调用

POST /agenttool/v1/knowledge_search
// 主账户认证头；示例不包含真实 token
{ query: "星河项目 进展 风险 待办",
  sources: [{ source_type: "tencent_docs" }],
  metadata: { updated_after: "2026-10-26" } }

→ results + searched + unavailable + ranked
→ title / url / snippet → Agent 整理

前提：当前配置已开放腾讯文档来源且有访问权限。默认来源不保证含文档。返回的是检索材料，未保证全文；本调用不等同于逐个调用本地 MCP。

检索片段→必要时由实际产品工具取正文 / 附件→报告

账号类型 doc云连接名称 tdocs-app本地插件 ID tencent-docs

三个名字对应同一个接入案例的不同层。 state_token 用于继续关联业务；mcp_token 是连接器访问凭据；搜索请求使用主账户身份。三者不能互换。

LOCAL PDF → TENCENT DOCS → REPORT

附件怎样真正进入腾讯文档？

这里把“附件”明确为用户选中的本地 PDF，上传目标为腾讯文档资料库。不是检索命中后自动下载远程附件。

EXAMPLE

选择 星河项目补充材料.pdf → 上传到指定目录 → 得到文件链接 → 在有权限和可用工具时纳入周报。

B /

附件上传完整链：申请地址、传输字节、确认处理

apply / complete / query 属于腾讯文档资料库接口

完整过程包括“传输成功”和“任务处理成功”两个阶段。上传后可得到文件信息，但尚不能据此认定 Agent 已读全文或检索立即可见。

③ 附件上传伪代码

按真实步骤简化；不是可运行 SDK

file = prepareUploadFile(userSelectedPDF)
base = "/api/v6/open/agent/manage/"
meta = { name, ext, file_size, md5,
         parent_id?, space_id? }
apply = POST(base + "apply_upload", meta)
upload(apply.upload_url, file.bytes,
       apply.method ?? "PUT")
POST(base + "complete_upload", { ...meta,
  task_id, obj_key, uniq_file_name, etag?, target_ext? })
every 5s: POST(base + "query_task", {task_id})
until retcode == 0 && progress >= 100
return mapV2FileToUi(result) // 文件 ID / 可用链接

票据字段取自实际申请结果，示例按统一名称简写；上传需带返回的 headers。处理超过 180 秒报超时，不能将处理进度当成搜索索引进度。

④ 新旧差异，怎样理解

语义 diff · 非逐行源码补丁

− 分别进入产品，手动授权与配置

+ Buddy One 关联 + 批量接入 / 恢复

− 用户逐处找材料、搬运上下文

+ knowledge_search 统一请求可用来源

+ Agent 复用已有 MCP / CLI 能力

增强区间：5.8.3 → 5.9.x。5.9.2 与 5.9.3 已核对的 Buddy One 核心主进程文件相同。通用 OAuth、MCP 票据和上传能力不能一概算作 Buddy One 首创。

本地文件附入会话→本地引用或云上传

这是另一路径：会话附件可按运行模式使用本地引用，不能画成“所有附件都上传腾讯文档”。

已证实的边界

账号接入、独立知识搜索、文档资料库上传、通用 MCP callTool / readResource 均有静态调用链。主账户与各产品凭据仍需分别处理。

虚线段仍需实际工具声明

腾讯文档中已有附件的具体读取 / 下载 API 未还原；不能编造 read_doc 或把网盘 SDK 当作文档工具。跨应用长期记忆也仍为预告。

展开证据与接口定位（离线内嵌）

5.9.3 main/server.js SHA-256：a471fc017f34ac8d18b7cdea7e0072232e476543b4244c9649556c690be07bba。图是静态重建，未执行登录、上传或检索。
账号接入：BuddyOneBindDialog / createBuddyOneConnectors；排版 server.js 86500 起；插件安装 module.app-server.js:12811。
知识搜索：server.js:125059 / 125132；默认来源 124857，并非五种来源始终开放。
关联页面：https://account.tencent.com/hybrid/account-bind?state_token=…，与主账户 access token 不同。
附件上传：TencentDocsCoreService.uploadFile，server.js 141108；pollUploadTask 141280；桌面读取文件注入 142211。apply 还可带 force_raw_drive_upload?；实际响应允许字段别名；文件链接允许缺省。
Buddy One 官网 · 连接器与权限说明。外链仅供延伸阅读，本文显示与演示无需联网。

Buddy One × 腾讯文档一次关联，怎样走到一份报告？