01 / THESIS
让分散的工作资料，
成为同一项任务的上下文
Buddy One · 面向高级架构师与产品经理的源码解读
协作的客户端机制。
WorkBuddy 接任务与组织工具；Buddy One 关联账号、准备连接并呈现套餐权益；独立知识搜索把相关材料返回给 Agent。
仅分析保全的发行代码；未执行真实绑定、检索或扣费。
02 / PRODUCT FRICTION
痛点可以从补齐的代码路径反推
以下痛点与价值判断是产品推断；右侧机制有直接源码支撑，收益尚未实测。
接入摩擦
授权分散、票据过期、登录后需要恢复连接。
createBuddyOneConnectors()上下文准备摩擦
用户要先找材料、确认出处，再把背景交给 AI。
query / sources / metadata状态认知摩擦
“已关联”“能调用”“有结果”容易被视为同一状态。
disabled / failed / connected03 / ARCHITECTURE
三条链协作，具有不同的成功判定
架构抽象：关联控制、统一检索、通用产品工具执行彼此配合；不是每次任务都固定串行。
凭据、注册条件和调用协议不应混用；搜索接口并不直接把各产品 mcp_token 放进请求体。
关联成功只完成准备阶段；工具可用、检索覆盖和内容读取还需分别展示与验收。
04 / INTERFACES
新增的是专用协作入口与统一搜索调用
“新增”指 5.8.3 → 已检查的 5.9.x 客户端实现；不推定服务端首次发布时间。
| 职责 / HTTP 路径 | 关键输入 | 客户端消费 / 实际目的 |
|---|---|---|
GET/api/v1/copilot/account/buddyone/apps | 无显式 query / body | joined / accounts / buddyone_id?查询关系，发现可接入产品 |
POST/api/v1/copilot/account/buddyone/link/apply | scene / target_app? / code_info? | state_token初始化 OneID 关联流程 |
POST/v2/as/connector/oauth/buddyone-connect | connectors: [{name, code?}] | results[].status / err_code / mcp_token?批量接入与票据快速路径 |
GET/api/v1/copilot/account/buddyone/status | 当前登录上下文 | buddyone_id → event.oneId已观察到统一事件标识用途 |
POST/billing/external/get-buddyone-banned-accounts | {} | accounts[].app_info.app_type不可用账号 / 权益状态展示 |
POST/agenttool/v1/knowledge_search | query / sources / metadata? | results / searched / unavailable / ranked真正获取检索材料 |
05 / TENCENT DOCS
案例：把已关联关系变成可调用能力
补充关联腾讯文档：账号类型 doc → 云连接名 tdocs-app → 本地插件 tencent-docs。
apps → link/apply {scene:"upgrade_target_app", target_app:"doc"}state_token打开 /hybrid/account-bind?state_token=…app_results: doc successbuddyone-connect {connectors:[{name:"tdocs-app"}]}connected + err_code:0 + mcp_token?connectAuthorized → MCP ready → ensureInstalled → 授权状态刷新06 / CREDENTIALS
三种票据，三种边界
状态一致性比“拿到一个 token”更重要；等待过程中切换账号、主动禁用和授权过期都要保留语义。
state_token
link/apply 返回，用于继续 OneID 关联页面流程。
account-bind?state_token=…mcp_token
文档 / ima 预授权快速路径，结合可选到期时间与当前账户验证。
{token, expiresAt, isCurrent}主账户 Bearer
统一检索使用当前主账户认证上下文，并增加用户与请求关联头。
X-User-Ticket / X-Conversation-Request-ID?if currentAccount && tokenUsable && notExpired: applyExternallyManagedToken(plugin, token) else: fallback(status / accesstoken)
not_linked / rejected / unavailable / failed 是不同结果；已绑定但 disabled 的连接器保留关闭状态，不能因恢复流程擅自重开。
07 / KNOWLEDGE CONTRACT
统一检索合同：输入范围，输出覆盖
POST /agenttool/v1/knowledge_search · 有完整 schema、输入校验、HTTP 调用、响应校验与工具结果返回。
{
query: "星河项目 交付风险与待办",
sources: [{ source_type: "tencent_docs" }],
metadata: { updated_after: "2026-10-26" }
}
// sources 空 / 缺省：使用配置允许来源
// source_id?：某来源内进一步收窄范围results + 覆盖元信息
results命中条目；工具说明解释 title / url / snippetsearched实际搜索的来源unavailable未搜索来源及原因ranked排序状态；不是后端算法证明request_id请求关联标识08 / GATES & COVERAGE
支持五类来源，不等于所有账号都能搜全
两个注册门槛 + 一套动态来源配置 + 每次请求与响应共同决定真实覆盖。
Buddy One 门槛
features.BuddyOne === true- 有 uid、个人账户、无 enterpriseId
- 非海外配置，当前身份持续匹配
发行 product.json 中 BuddyOne 默认 false；实际快照可覆盖。
knowledge_search 门槛
- 有 uid，且没有 enterpriseId
- 不直接要求 BuddyOne 开关为 true
- 账户 / 产品配置变化时重新评估
注册可见只说明工具被提供，不证明具体来源授权成功。
09 / WORKED CASE
一份项目周报，包含两种独立的资料路径
解释性案例：已存在的腾讯文档 + 用户主动上传的补充 PDF。假设相关来源与权限已可用；并非实测。
/api/v6/open/agent/manage/apply_upload → upload_url（上传文件字节） → complete_upload → query_task // 每 5 秒查询；180 秒超时
上传处理完成与搜索索引就绪不同。腾讯文档远程正文 / 附件工具名及 schema 未保全，不能编造 read_doc 或保证自动读全文。
10 / VERSION DIFF
5.9.x 的增量是接入与检索整合
版本结论基于已检查样本与哈希交集；“未发现”始终保留搜索边界。
观察到的新增专用实现
- Buddy One apps / status / link / 批量接入
- 独立 knowledge_search 内置工具及 HTTP 路径
- 票据复用、授权状态联动和恢复调用链
五个核心文件字节相同
account.js / server.js / authority-snapshot.js / module-base.js / module.app-server.js
仅为旧研究快照与新版提取范围交集；旧前端依赖不全。
5.8.3 / 5.9.3 的 endpoint、platform、authentication 对象相同。不能由此断言服务端或登录网页全部没改。
不是重造全部连接协议。新分组调用、个人关联流程与统一检索复用基础设施；不能把这些都写成 5.9.3 首次交付。
11 / DELIVERY & PRODUCT
验收对象应该是状态转换，而非入口数量
以下为基于代码机制提出的验收建议；没有真实账户运行数据或收益测量。
| 源码事实 | 面向架构 / 产品的要求 | 建议验证 |
|---|---|---|
| 同账号检查贯穿异步连接 | 切换账号必须阻断旧任务提交 | 关联中换号、注销、配置变化 |
| disabled 与连接失败分开处理 | 保留用户意图，恢复不能悄悄重开 | 主动关闭后重新登录 / restore |
| 结果带 searched / unavailable | 回答与 UI 展示实际覆盖，允许部分成功 | 单来源不可用、空片段、低相关结果 |
| VIP 有独立标记；记忆旁是 comingSoon | 关联能力、套餐识别、长期记忆分开验收 | 账号标记与界面文案，不代替后台权益核验 |
记录“关联成功 → 云连接 → 本地 ready → 搜索调用 → 有来源产出”的分段耗时与失败原因；统一身份遥测不等于已有完整链路追踪。
源码能证明接口、条件和提示；不能确认全部后端权限、积分结算、全文存储、搜索新鲜度或各产品使用同一 Agent 运行时。
12 / EVIDENCE & QUESTIONS
结论可追溯，未知项应进入验证计划
本 deck 的论据仅来自已保全 WorkBuddy 发行代码；未使用官网宣传补足后端实现。
客户端机制存在
关联请求、批量接入、票据快速路径、统一检索、来源配置、插件准备、上传流程、VIP 标记和记忆预告。
降低准备成本
把身份与接入摩擦前置消化，让 Agent 更容易获得任务上下文。这是设计价值解释，不是测量结论。
服务端与真实体验
账户灰度、实际权限、索引延迟、全文读取、积分扣费与多产品运行时。仅有客户端静态代码仍不充分。
12a2be53ec7db2943a9958f6986d7807adcf083bd79b307d26706d83750effa7原始文件逐项校验；展示行号来自仅排版副本。Sxx 是人工源码索引，不是 REA Evidence ID。