LLM 知识库打造 · 完整版

用 WorkBuddy 连接五大平台,打造你的 AI 知识库

WorkBuddy 不只是自己干活,它还能把产出无缝写入你现有的知识管理工具。本模块覆盖 Obsidian、IMA 知识库、腾讯文档、飞书、乐享知识库五大平台,每个方案都包含核心功能、适用场景、配置步骤、零基础完整教程和常见问题。教程来源优先参考各平台官方文档,结合社区高质量使用经验整理。

5 个平台 约 120 分钟 更新于 2026-07

1. WorkBuddy + Obsidian

Obsidian 是一款强大的本地 Markdown 知识管理工具,所有笔记以 .md 纯文本存储在本地文件夹(称为 vault)中。它的核心特色是双链笔记([[wikilinks]]),让笔记之间形成网状关联。官方文档:help.obsidian.md

核心功能

WorkBuddy 与 Obsidian 集成后可以做三件事:

  1. 直接读写文件:用 Write / Edit / Read 工具打开 vault 里的 .md,Obsidian 会实时刷新。最简单、最稳的方式。
  2. obsidian-cli 高级操作:搜索笔记、创建笔记(可自动打开)、安全重命名/移动(自动更新 [[wikilinks]] 和 Markdown 链接)、删除。
  3. obsidian:// URI 唤起:创建笔记后可直接在 Obsidian 桌面端打开对应笔记。

适用场景

  • 你已有 Obsidian 库,想让 WorkBuddy 帮你批量写笔记、整理、建立双链。
  • 做 Zettelkasten / 卡片盒笔记,需要自动生成带 [[链接]] 的关联卡片。
  • 把对话产出(总结、翻译、提炼)一键落盘到指定文件夹。
  • 远程重构:批量重命名/移动笔记且不破坏双链。

配置步骤

# 1. 确保 Obsidian 桌面端已安装(https://obsidian.md/)

# 2. 设默认 vault(一次性)
obsidian-cli set-default "<vault文件夹名>"

# 3. 验证
obsidian-cli print-default          # 看默认 vault 路径
obsidian-cli search "关键词"        # 搜笔记名
obsidian-cli search-content "关键词" # 搜笔记正文

零基础完整教程

第 1 步:下载安装 Obsidian。访问 obsidian.md 下载对应平台的安装包,安装后创建一个新 vault(选择一个空文件夹即可)。

第 2 步:建好目录骨架。在 vault 里创建以下文件夹:00-Inbox/(待处理)、10-Sources/(已提炼资料)、90-Meta/(配置和来源清单)、Templates/(笔记模板)。

第 3 步:让 WorkBuddy 写第一篇笔记。告诉 WorkBuddy:

# 给 WorkBuddy 的任务
任务:在 00-Inbox/ 下新建一篇笔记,标题《AI 学习笔记》,
内容是关于大语言模型基础概念的 500 字总结,用 Markdown 格式。

第 4 步:批量整理。让 WorkBuddy 读取 00-Inbox/ 下所有笔记,按主题分类移动到 10-Sources/ 对应子目录,并建立双链。

第 5 步:搭自动化。创建一个来源清单文件 90-Meta/sources.md,列出要收集的 RSS 和网页 URL,然后让 WorkBuddy 每天定时读取清单、抓取内容、提炼成卡片、写入 vault。

常见问题及解决方案

WorkBuddy 说找不到 vault?
先跑 obsidian-cli print-default --path-only;为空就用 set-default 指定。多 vault 时读 obsidian.jsonopen: true 那一个。
移动笔记后双链断了?
obsidian-cli move 而不是系统 mv,前者会重写所有 [[wikilinks]] 和 Markdown 链接。
小技巧:简单编辑直接用 Edit 工具改 .md,Obsidian 热刷新。涉及重命名/移动且库里有大量互链时,才用 obsidian-cli move 保链接。

2. WorkBuddy + IMA 知识库

IMA 是腾讯推出的云端 AI 知识库与笔记平台(ima.qq.com),支持多端同步、AI 检索和网页/文件批量入库。它通过统一 OpenAPI 暴露两大模块:notes(笔记)和 knowledge-base(知识库)。

核心功能

你说的实际走动作
"记一下""新建笔记"notesimport_doc
"把这段加到 XX 笔记"notes先搜 note_id 再 append_doc
"上传文件到知识库"knowledge-basecreate_mediaadd_knowledge
"把网页存进知识库"knowledge-baseimport_urls

适用场景

  • 想把 WorkBuddy 整理出的内容同时存进 AI 知识库,之后用 IMA 的问答/检索能力复用。
  • 多设备(手机/网页/桌面)随时记,WorkBuddy 负责"批量生产"内容再回写。
  • 收集网页文章、PDF 资料进知识库,配合 IMA 的 AI 检索。

配置步骤

# 1. 在 https://ima.qq.com/agent-interface 获取 Client ID 和 API Key

# 2. 存凭证(推荐配置文件方式)
mkdir -p ~/.config/ima
echo "your_client_id" > ~/.config/ima/client_id
echo "your_api_key"    > ~/.config/ima/api_key

# 3. 校验
test -f ~/.config/ima/client_id && test -f ~/.config/ima/api_key \
  && echo "凭证就绪" || echo "缺少凭证"

零基础完整教程

第 1 步:注册 IMA 账号。访问 ima.qq.com,用微信或 QQ 登录,完成基础设置。

第 2 步:获取 API 凭证。agent-interface 页面申请 Client ID 和 API Key,按上方配置步骤存好。

第 3 步:让 WorkBuddy 新建第一篇笔记。告诉 WorkBuddy:

# 给 WorkBuddy 的任务
帮我把下面这段内容新建为 IMA 笔记,标题《AI Agent 入门》:
大语言模型(LLM)是一种基于 Transformer 架构的深度学习模型...

第 4 步:把网页存进知识库。给 WorkBuddy 一个 URL,它会自动走 import_urls 把网页内容存入 IMA 知识库。

# 网页入库
把 https://example.com/article 这篇网页添加到我的 IMA 知识库。

第 5 步:上传文件到知识库。告诉 WorkBuddy 把本地 PDF/Word/图片上传到 IMA 知识库,它会走 create_mediaadd_knowledge 两步流程。

常见问题及解决方案

报错 code: -100 / "NO CREDENTIALS"?
凭证没配。把 client_id/api_key 写进 ~/.config/ima/ 或设环境变量 IMA_OPENAPI_CLIENTIDIMA_OPENAPI_APIKEY
中文内容乱码?
notes 写入前必须确认字符串是合法 UTF-8。Windows 用户注意:PowerShell 5.1 的 Invoke-RestMethod 会静默把 UTF-8 转成 GBK,必须显式转 UTF-8 字节数组再发。乱码不可逆,只能重新写入。
视频/Bilibili/YouTube 链接上传失败?
IMA 知识库不支持视频文件和这些 URL,请用 IMA 桌面客户端处理。
与 Obsidian 的取舍:IMA 胜在云端 + AI 检索 + 多端;Obsidian 胜在本地可控 + 双链 + 零鉴权。常见组合:WorkBuddy 抓资料 → 一份落 Obsidian(本地双链库),一份推 IMA(云端 AI 检索)。

3. WorkBuddy + 腾讯文档

腾讯文档(docs.qq.com)是腾讯出品的云端协作文档平台,支持在线文档、表格、幻灯片、思维导图、流程图等多种文档类型。通过 WorkBuddy 连接器接入,无需自建 OAuth。

核心功能

腾讯文档能力分散在 4 个独立 MCP endpoint:

service职责
tencent-docs文件管理 / 创建 / 搜索 / OCR / 网页剪藏 / smartcanvas
doc-mcp在线文档(Word 类)精细编辑
sheet-mcp在线表格(Excel 类)精细编辑
slide-mcp幻灯片(PPT 类)精细编辑

适用场景

  • 把 WorkBuddy 生成的报告/纪要直接落到云端文档,方便分享协作。
  • 网页剪藏:给 WorkBuddy 一个 URL,它抓正文存成腾讯文档。
  • 图片 OCR 转 editable 文档。
  • 需要在线表格/多维表做结构化数据管理。

配置步骤

腾讯文档 skill 鉴权完全依赖 WorkBuddy 连接器注入的票据。先在 WorkBuddy 连接器面板完成腾讯文档授权,然后验证:

# 环境自检
python3 tencentdocs.py tdoc_init
# READY            → 已就绪
# ERROR:no_token   → 请在 WorkBuddy 中完成腾讯文档授权后重试

零基础完整教程

第 1 步:在 WorkBuddy 连接腾讯文档。打开 WorkBuddy 的连接器面板,找到腾讯文档,点击授权。授权完成后跑 tdoc_init 验证。

第 2 步:创建第一份文档。告诉 WorkBuddy:

# 用 Markdown 生成智能文档
用 Markdown 给我的周报生成一份腾讯文档智能文档,标题《2026-07-31 周报》。
内容包括:本周完成、下周计划、风险与依赖。

第 3 步:网页剪藏。给 WorkBuddy 一个 URL,它会自动抓取网页正文并存成腾讯文档:

# 网页剪藏
把这篇网页 https://example.com 剪藏成腾讯文档,放到"收藏"文件夹。

第 4 步:生成思维导图。用 Markdown 列表生成思维导图:

# 思维导图
用以下结构生成一份思维导图:
- AI 学习路径
  - 提示词工程
  - 模型微调
  - RAG
  - Agent

第 5 步:图片 OCR。给 WorkBuddy 一张图片,它会自动 OCR 转 Word 或 Excel。

常见问题及解决方案

报 400016 文档类型不匹配?
用错品类工具了。先用 manage.query_file_info 确认文档类型,再按品类路由(doc→doc-mcp, sheet→sheet-mcp)。
连续多次写入同一文档报错?
连续 3 次及以上写入必须用批量接口一次提交(如 smartsheet.add_records),不要单条循环。

4. WorkBuddy + 飞书

飞书(feishu.cn)是字节跳动旗下的企业协作平台,覆盖文档、多维表格、电子表格、日历、消息、云盘、任务、视频会议等全栈能力。通过 lark-cli(飞书官方 CLI)接入 WorkBuddy。官方文档:open.feishu.cn

核心功能

lark-cli 覆盖飞书多业务域:文档创建与编辑、多维表格/电子表格操作、日历查询与创建、消息发送(bot 或用户身份)、云盘文件上传下载、任务管理、视频会议等。

关键概念:两种身份

身份标识获取说明
user 用户--as userlark-cli auth login访问你自己的资源(日历、云盘、文档)
bot 应用--as bot自动(appId+appSecret)应用级操作,创建的内容归属 bot;看不到用户资源
经验法则:bot 看不到你的日历/云盘,发消息以应用名义。需要"代表你本人"操作时必须用 user 身份 + 授权。

适用场景

  • 团队文档/多维表格的批量生成与维护(让 WorkBuddy 写飞书文档、填多维表)。
  • 用 bot 在群里自动推送 WorkBuddy 的产出(日报、告警)。
  • 同步日历、管理任务。
  • 企业知识库场景的"WorkBuddy 生产 → 飞书沉淀"。

配置步骤

# 1. 初始化配置(首次)
lark-cli config init --new
# 命令会输出授权链接,WorkBuddy 会生成二维码给你扫

# 2. 授权(按需要选 domain 或 scope)
lark-cli auth login --domain all --no-wait --json
# 或最小权限:lark-cli auth login --scope "<scope>" --no-wait --json

# 3. 验证登录态
lark-cli auth status --json --verify
lark-cli whoami

零基础完整教程

第 1 步:初始化飞书 CLI。在 WorkBuddy 中执行 lark-cli config init --new,它会输出一个授权链接和二维码。用手机飞书扫码授权。

第 2 步:授权需要的权限。按需授权,推荐最小权限原则:

# 仅授权文档 + 云盘
lark-cli auth login --domain docs --domain drive --no-wait --json

第 3 步:创建第一份飞书文档。告诉 WorkBuddy:

# 创建文档
帮我在飞书里创建一篇文档《项目周报》,内容包括本周进展、下周计划和风险项。

第 4 步:往多维表格写入数据。

# 填多维表格
帮我在飞书"产品组"多维表格里新建一条记录:标题《XX》、负责人、截止日。

第 5 步:用 bot 推送消息。切换到 bot 身份,在群里发消息:

# bot 推送消息
用 bot 身份在"运维告警"群发一条消息:今天服务器负载正常。

第 6 步:写操作前预览。--dry-run 可以打印完整请求但不真正执行,适合确认参数。

常见问题及解决方案

报错 missing_scopes / 权限不足?
user 身份:lark-cli auth login --scope "缺失scope" 补授权;bot 身份:去飞书开发者后台给应用开通 scope。
bot 查日历返回空 / 看不到我的文档?
身份选错了。bot 看不到用户资源,改用 --as user 并先 auth login
高风险操作被拦(exit code 10)?
lark-cli 对高风险写操作有确认门禁。这不是普通错误,WorkBuddy 会向你确认后再在命令末尾加 --yes 重试。不要静默加 --yes 绕过。

5. WorkBuddy + 乐享知识库

乐享知识库(lexiangla.com)是腾讯出品的企业知识库平台,支持团队 Wiki、知识沉淀、文档协作、腾讯会议录制导入和 iWiki 迁移。通过 MCP 连接器接入 WorkBuddy。

核心功能

乐享知识库按意图路由到子模块:

意图子模块典型动作
配置 / 401 / Token 过期setup续期(点按钮,无需重配)、初始 OAuth
搜索 / 查找 / 阅读search关键词/语义搜索、读页面、看目录
创建文档 / 写入 / 导入writer新建文档、导入内容、公众号收藏
编辑已有页面blocks加标题、删段落、Block 级增删改移
上传/下载文件files二进制三步流程(PDF/Word/图片)
导入腾讯会议 / iWikiconnectors会议录制导入、iWiki 页面迁移
易混淆:给 /pages/xxx 链接要"改内容"→ blocks;给 /spaces/xxx 要"新建"→ writer;只"读/总结"→ search。

适用场景

  • 团队知识库的内容生产:让 WorkBuddy 把整理好的文档直接写进乐享。
  • 腾讯会议录制导入、iWiki 迁移到乐享(connectors 模块独门能力)。
  • 已有页面的精细化编辑(blocks 级),而不是整篇重写。
  • 文件上传下载管理。

配置步骤

乐享通过 MCP 连接器接入。先在 WorkBuddy 连接器面板完成连接/授权(OAuth),然后验证:

# 调用 whoami() 检查凭证状态
# 成功 → 返回用户信息,继续操作
# 401 → 引导续期(点续期按钮即可,无需重配)
# 连接失败 → 完成初始 OAuth 配置

零基础完整教程

第 1 步:在 WorkBuddy 连接乐享。打开连接器面板,找到乐享知识库,点击连接并完成 OAuth 授权。

第 2 步:验证连接。告诉 WorkBuddy 调用 whoami(),如果返回用户信息就说明连接成功。

第 3 步:新建第一篇文档。告诉 WorkBuddy:

# 新建文档
在乐享"技术文档"空间下新建一篇文档《API 网关设计》,内容如下:
一、背景与目标
二、架构方案
三、接口规范
四、安全策略

第 4 步:读取并总结已有页面。

# 读取页面
读取乐享这个页面 https://xxx.lexiangla.com/pages/abc 并总结要点。

第 5 步:导入腾讯会议录制。这是乐享的独门能力:

# 导入会议录制
把昨天的腾讯会议录制导入到乐享"周会纪要"空间。

第 6 步:编辑已有页面。给 WorkBuddy 一个 /pages/xxx 链接,让它走 blocks 模块做 Block 级编辑(加标题、删段落、移动 Block)。

常见问题及解决方案

报 401?
立即停手,不要重试。引导续期(点续期按钮)。这是最常见的"连接过期",不是代码问题。
写入时说"找不到目标"?
写入必须基于你明确提供的目标(URL / ID / 确认过的名称)。给清晰的 space_id 或 /pages/xxx 链接。
返回链接打不开 / 域名不对?
检查是否误把 company_from 拼成了子域名。让 WorkBuddy 用 whoami() 的 company_domain 重新生成。

对比一:存储与部署

维度ObsidianIMA 知识库腾讯文档飞书乐享知识库
存储位置本地文件系统腾讯云端腾讯云端字节云端腾讯云端
部署方式桌面端安装网页/桌面/移动网页/桌面/移动网页/桌面/移动网页/桌面
多端同步需 Sync/Git原生云端同步原生云端同步原生云端同步原生云端同步
离线支持完全离线可用需联网需联网需联网需联网
数据所有权完全自有托管在云端托管在云端托管在云端托管在云端

对比二:鉴权与安全

维度ObsidianIMA 知识库腾讯文档飞书乐享知识库
鉴权方式无需鉴权API Key连接器票据OAuth + bot TokenOAuth
权限粒度文件系统级应用级文档级scope 级(细粒度)空间级
凭证管理配置文件/环境变量宿主自动注入auth login 累积授权OAuth 续期
数据安全本地加密可控腾讯云安全腾讯云安全字节云安全腾讯云安全
Token 过期处理不适用重新获取 Key宿主自动刷新重新 auth login点续期按钮

对比三:核心能力

维度ObsidianIMA 知识库腾讯文档飞书乐享知识库
文档类型Markdown / Canvas笔记 + 知识库文档/表格/PPT/脑图/流程图文档/多维表格/表格/幻灯片Wiki 页面 + 文件
协作能力无(单人)分享实时协作实时协作 + 评论团队协作 + 权限
搜索能力全文搜索AI 语义检索文档内搜索全文 + 多维筛选关键词 + 语义搜索
AI 能力无内置AI 问答/摘要OCRAI 助手AI 搜索/推荐
双链支持原生 [[wikilinks]]

对比四:自动化与集成

维度ObsidianIMA 知识库腾讯文档飞书乐享知识库
API 完整度CLI 工具OpenAPI 完整多 endpoint MCPCLI + SDK 完整MCP 全功能
自动化成本最低(写文件)低(API 调用)中(多 endpoint)中(需授权)中(需 OAuth)
WorkBuddy 集成深度直接读写 + CLIAPI 双模块4 品类 MCP全栈 CLI + bot6 子模块 MCP
定时任务支持文件监听/定时写入API 定时调用API 定时调用bot + webhookAPI 定时调用
扩展性插件生态丰富API 扩展API 扩展开放平台 + 应用市场connectors 扩展

对比五:适用场景

维度ObsidianIMA 知识库腾讯文档飞书乐享知识库
最适合个人 PKM个人 + AI 应用云端协作文档企业团队协作企业知识沉淀
团队规模单人单人/小团队小到中团队中到大团队中到大团队
典型用例卡片笔记、知识图谱AI 问答、资料收集报告、表格、PPT日报、多维表、消息推送Wiki、会议纪要、文档迁移
推荐组合+ IMA 做云端备份+ Obsidian 做本地双链+ 飞书做全栈协作+ Obsidian 做个人库+ Obsidian 做个人库

对比六:独门能力

平台独门能力其他平台能否替代
Obsidian双链自动更新(obsidian-cli move 重写所有 wikilinks)不可替代,唯一支持本地双链
IMA 知识库URL 一键入库(import_urls 网页直接存入 AI 知识库)腾讯文档有网页剪藏但无 AI 检索
腾讯文档网页剪藏 + OCR(图片转 Word/Excel)飞书有类似能力但 OCR 弱
飞书bot 消息推送(应用身份自动发群消息)不可替代,唯一支持 bot 推送
乐享知识库腾讯会议录制导入 + iWiki 迁移不可替代,唯一支持会议录制和 iWiki 迁移
推荐组合:Obsidian(本地双链主力库)+ 任选一个云端平台做共享/检索。例如个人场景用 Obsidian + IMA,团队场景用 Obsidian + 乐享知识库。WorkBuddy 作为中枢,一份产出同时分流到多个目的地。
已复制。