乐享知识库深度实战：用 MCP 连接器替代手动上传下载1. 为什么选乐享先回答一个基础问题：知识库那么多（Notion

上一节我们理解了 MCP 连接器的概念，启用了第一个连接器。这一节深入乐享知识库连接器——它是 WorkBuddy 里最常用的连接器之一，也是前8节"云端共享"方案的升级版。从手动打包上传到一句话自动归档，本文带你走完从手动到全自动的完整路径。

1. 为什么选乐享

先回答一个基础问题：知识库那么多（Notion、飞书文档、腾讯文档），为什么系列文章一直在用乐享？

三个原因：

维度	乐享	Notion	飞书文档
文件存储	支持任意格式文件上传	以文档为主	支持但非核心
企业渗透	腾讯系内部广泛使用	偏个人/创业团队	飞书生态内
WorkBuddy 集成	原生 MCP 连接器	有连接器	有连接器
权限模型	团队→知识库→文件夹三级	页面级	文档级

核心优势：乐享能存文件。 脚本、Zip 包、日志文件、Excel 报表——什么都能往里塞，返回一个固定的 entry_id，后续通过 ID 下载。这比文档类知识库更适合做自动化脚本的"云端仓库"。

如果你已经在用其他知识库也没关系——MCP 连接器的使用模式是相通的，学会乐享，迁移到 Notion 或飞书只是换个工具名。

2. 两种用法：手动 vs 连接器

基础篇第3节讲过用乐享做云端共享，当时的流程是：

手动方案（第3节）：
  1. 本地打包 zip
  2. 打开乐享网页 → 上传文件 → 拿到 entry_id
  3. 手动记下 entry_id
  4. 新终端 → 告诉 WorkBuddy entry_id → 下载解压

上传这一步必须开浏览器、手动操作。如果脚本是每天自动跑的，日志想自动归档到乐享呢？总不能每天开浏览器上传一次。

连接器方案就是解决这个问题的：

MCP 方案（本文）：
  你说："把今天的执行日志上传到乐享的 OUCN 文件夹"
    ↓
  AI 自动调用 lexiang_upload_file 工具
    ↓
  乐享 MCP Server 处理上传
    ↓
  返回 entry_id → AI 告诉你存好了

不开浏览器，不手动操作，一句话完成。而且这个 entry_id 可以直接用在后续的下载指令里。

3. 乐享连接器工具全解析

启用乐享连接器后（上一节讲过启用步骤），AI 能调用以下工具：

工具清单

工具	功能	关键参数	返回值
`lexiang_search_docs`	全文搜索文档	`query`（关键词）	文档列表（标题+ID+摘要）
`lexiang_list_kb_docs`	列出知识库内文档	`kbId`（知识库ID）	文档列表
`lexiang_get_doc_content`	读取文档正文	`docId`（文档ID）	文档全文（Markdown）
`lexiang_create_doc`	创建新文档	`title`, `content`, `kbId`	新文档ID
`lexiang_upload_file`	上传文件	`filePath`, `folderId`	entry_id
`lexiang_download_file`	下载文件	`entryId`	本地文件路径

注意：你不需要记住这些工具名和参数。 只要用自然语言描述需求，AI 自动匹配工具并填参数。下面通过实战来理解每个工具。

4. 实战一：文件上传——脚本日志自动归档

场景

OUCN 自动化脚本每天跑完后，会生成一份执行日志 ouchn_log_20260713.txt。手动归档太累，想让它自动存到乐享。

手动方案的痛点

1. 脚本跑完 → 生成日志文件
2. 打开乐享网页 → 找到目标文件夹 → 点上传
3. 选文件 → 等上传完成 → 复制 entry_id
4. 手动记到某个表格里

每天重复，忘一次就断了。

连接器方案

直接在对话里说：

把 D:\ouchn_auto\logs\ouchn_log_20260713.txt 上传到乐享的"OUCN自动化"文件夹下

AI 会自动执行：

步骤1：识别意图 → 选择 lexiang_upload_file 工具
步骤2：查找"OUCN自动化"文件夹的 folderId
步骤3：调用上传工具，参数:
  {
    "filePath": "D:\\ouchn_auto\\logs\\ouchn_log_20260713.txt",
    "folderId": "folder_xxx"
  }
步骤4：乐享返回 entry_id
步骤5：AI 回复："已上传，entry_id: abc123def456"

整个过程在对话里完成，你能看到每一步的执行情况。

结合 Automation 实现全自动

上一节讲了连接器是手动触发的。但如果配合第7节的 Automation 定时任务，可以实现全自动闭环：

Automation 定时触发（每天 9:00）
  ↓
Skill 执行 OUCN 自动化任务
  ↓
生成日志文件
  ↓
Skill 指令："上传日志到乐享"
  ↓
AI 调用 lexiang_upload_file
  ↓
乐享存储成功，返回 entry_id
  ↓
Skill 指令："飞书通知我执行结果"
  ↓
AI 调用 feishu_send_message

这是第4节"MCP + Skill 组合技"的预告——Skill 编排流程，连接器提供通道。

5. 实战二：文档搜索与读取

场景

新同事入职，问他之前写的 OUCN 部署文档在哪。你说在乐享里，但他不知道标题，只记得是关于"Edge 调试"的。

搜索

搜索乐享里关于"Edge 调试"的文档

AI 调用 lexiang_search_docs：

工具: lexiang_search_docs
参数: {"query": "Edge 调试"}

返回:
  [
    {
      "docId": "doc_001",
      "title": "OUCN 自动化部署指南",
      "summary": "本文介绍如何配置 Edge 调试浏览器...",
      "updateTime": "2026-07-10"
    },
    {
      "docId": "doc_022",
      "title": "CDP 连接问题排查",
      "summary": "Edge 调试端口无法连接的常见原因...",
      "updateTime": "2026-07-05"
    }
  ]

AI 会把结果整理成列表展示给你。

读取全文

读一下第一篇的内容

AI 调用 lexiang_get_doc_content：

工具: lexiang_get_doc_content
参数: {"docId": "doc_001"}

返回: 文档全文（Markdown 格式）

AI 可以直接把内容展示给你，或者根据内容回答问题。比如：

这篇文档里提到的 Edge 启动命令是什么？

AI 会从文档内容中提取相关信息回答，不用你手动翻。

6. 实战三：创建文档——自动生成执行报告

场景

OUCN 脚本跑完了，想自动生成一份执行报告存到乐享，而不是只存日志文件。

操作

根据今天的执行日志，生成一份执行报告，存到乐享的"OUCN自动化"知识库

AI 执行流程：

步骤1：读取本地日志文件
步骤2：分析日志内容（成功/失败/耗时等）
步骤3：生成 Markdown 格式报告
步骤4：调用 lexiang_create_doc 创建文档
  参数:
  {
    "title": "OUCN 执行报告 - 2026-07-13",
    "content": "# 执行报告\n\n## 执行概要\n...",
    "kbId": "kb_xxx"
  }
步骤5：返回文档 ID → 回复"已创建"

报告内容示例：

# OUCN 执行报告 - 2026-07-13

## 执行概要
- 执行时间: 2026-07-13 08:40
- 耗时: 12分37秒
- 状态: 成功

## 详细数据
| 项目 | 数量 |
|------|------|
| 浏览资源 | 102 |
| 作业批改 | 8 |
| 论坛回复 | 3 |

## 异常记录
无

文件 vs 文档的区别：

lexiang_upload_file：上传任意文件（txt、zip、xlsx），原样存储
lexiang_create_doc：创建乐享文档（在线可编辑），内容是 Markdown

日志用 upload_file（原始保留），报告用 create_doc（方便在线查看和搜索）。按场景选择。

7. 实战四：文件下载——新终端部署

场景

新电脑要部署 OUCN 自动化脚本。基础篇第3节的做法是手动上传 zip 到乐享，记下 entry_id，新终端下载。现在用连接器，全程不用开浏览器。

操作

从乐享下载 entry_id=9b41acdf... 的文件到 D:\ouchn_auto，解压后运行 setup_venv.py

AI 执行：

步骤1：调用 lexiang_download_file
  参数: {"entryId": "9b41acdf..."}
  → 文件下载到本地临时目录

步骤2：解压到 D:\ouchn_auto

步骤3：运行 setup_venv.py 创建虚拟环境

步骤4：报告部署完成

对比第3节的手动方案：

步骤	手动方案	连接器方案
上传脚本包	开浏览器，手动上传	一句话自动上传
记录 entry_id	手动复制粘贴	AI 自动记录
下载部署	手动输入 URL	一句话自动下载
更新脚本	重新上传+通知各终端	上传后各终端自动拉取

整个流程从"5步手动操作"变成"1句自然语言指令"。

8. 权限模型：团队、知识库、文件夹

乐享的权限是三级结构，理解了这个才能正确使用连接器：

🏢 团队（Team）
  └ 📚 知识库（KB）
      └ 📁 文件夹（Folder）
          └ 📄 文档/文件

权限对连接器的影响

操作	需要的权限	说明
搜索文档	团队成员	搜索范围=你有权限的所有文档
读取文档	文档所在知识库的读权限	没权限的文档搜不到也读不到
上传文件	目标文件夹的写权限	需要指定正确的 folderId
创建文档	目标知识库的写权限	需要指定正确的 kbId

指定目标的两种方式

当你说"上传到 OUCN 文件夹"时，AI 需要知道 folderId。两种方式：

方式一：自然语言查找

上传日志到乐享的"OUCN自动化"文件夹

AI 会先搜索文件夹名，找到 folderId，再上传。如果同名文件夹有多个，AI 会让你确认。

方式二：直接指定 ID

上传日志到乐享，folderId=folder_abc123

适合在 Automation 里使用——ID 固定，不会找错。

乐享 Badge 引用

在对话中引用乐享内容时，可以用 Badge 语法：

@lexiang#doc:doc_001:"OUCN部署指南"
@lexiang#kb:kb_xxx:"OUCN自动化知识库"
@lexiang#folder:folder_abc:"日志归档"

Badge 里的 type 和 id 是权威的，AI 会直接用它们调用对应工具，不会按标题去搜索——避免了同名歧义。

9. 常见问题与排错

上传失败

报错	原因	解决
"folder not found"	folderId 错误或无权限	先列出知识库确认文件夹
"file too large"	超过乐享单文件限制	拆分文件或压缩后上传
"permission denied"	当前账号无写权限	联系管理员开通权限

搜索不到文档

你说："搜索乐享里关于 Cookie 的文档"
AI 返回空列表

可能原因：

权限不够：文档存在但你没访问权限 → 找管理员开通
关键词不匹配：乐享全文搜索基于分词，"Cookie" 可能需要用"登录态"搜索
连接器断开：检查连接器管理页状态是否为"已连接"

下载的文件打不开

乐享下载的文件保留了原始格式。如果打不开，检查：

entry_id 是否对应正确的文件
本地路径是否有写入权限
文件是否在上传时损坏

10. 安全注意事项

用连接器操作知识库，安全意识不能少：

风险	防范
敏感信息泄露	不要把密码、Token 写进上传到乐享的文件里
误删文档	连接器目前不支持删除操作（安全设计），删除需手动在网页操作
权限过大	乐享账号只开通需要的知识库权限，不要用管理员账号
连接器被滥用	定期检查连接器状态，不用的及时断开

最佳实践：为自动化任务创建一个专用的乐享账号，只给目标知识库的读写权限，不给管理权限。

小结

学会的	要点
乐享连接器工具	搜索、读取、创建文档 + 上传、下载文件
文件 vs 文档	upload_file 存原始文件，create_doc 存在线文档
自动归档	一句话上传日志，配合 Automation 实现全自动
搜索与读取	自然语言搜索 + 全文读取 + AI 提取信息
新终端部署	从手动5步到一句话自动下载部署
权限模型	团队→知识库→文件夹三级，操作需对应权限
Badge 引用	@lexiang#type:id:"title" 精准引用
安全实践	专用账号 + 最小权限 + 不传敏感信息

技术路线

第1节：理解 MCP，启用第一个连接器 ✅
    ↓
第2节（本文）：乐享连接器深度实战 ✅
    ↓
第3节：自定义 MCP Server（从零写一个连接器）
    ↓
第4节：MCP + Skill 组合技（浏览器 + API 双通道）
    ↓
第5节：消息通知全集成（飞书/钉钉/企业微信）
    ↓
第6节：综合实战（日报自动生成系统）

📺 系列文章：

基础篇（Skill 开发）

第1节：WorkBuddy Skill 入门

第2节：CDP 浏览器操控原理

第3节：云端共享与多终端部署

第4节：WorkBuddy 自动化实战

第5节：登录态持久化

第6节：Angular 页面自动化进阶

第7节：定时任务与自动化调度

第8节：错误处理与运维监控

连接器篇（MCP 实战）

第1节：MCP 连接器入门

第2节：乐享知识库深度实战（本文）

第3节：自定义 MCP Server（待发布）