1. WorkBuddy + Obsidian
Obsidian 是一款强大的本地 Markdown 知识管理工具,所有笔记以 .md 纯文本存储在本地文件夹(称为 vault)中。它的核心特色是双链笔记([[wikilinks]]),让笔记之间形成网状关联。官方文档:help.obsidian.md。
核心功能
WorkBuddy 与 Obsidian 集成后可以做三件事:
- 直接读写文件:用 Write / Edit / Read 工具打开 vault 里的
.md,Obsidian 会实时刷新。最简单、最稳的方式。 - obsidian-cli 高级操作:搜索笔记、创建笔记(可自动打开)、安全重命名/移动(自动更新
[[wikilinks]]和 Markdown 链接)、删除。 - 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。
常见问题及解决方案
先跑
obsidian-cli print-default --path-only;为空就用 set-default 指定。多 vault 时读 obsidian.json 取 open: true 那一个。用
obsidian-cli move 而不是系统 mv,前者会重写所有 [[wikilinks]] 和 Markdown 链接。.md,Obsidian 热刷新。涉及重命名/移动且库里有大量互链时,才用 obsidian-cli move 保链接。2. WorkBuddy + IMA 知识库
IMA 是腾讯推出的云端 AI 知识库与笔记平台(ima.qq.com),支持多端同步、AI 检索和网页/文件批量入库。它通过统一 OpenAPI 暴露两大模块:notes(笔记)和 knowledge-base(知识库)。
核心功能
| 你说的 | 实际走 | 动作 |
|---|---|---|
| "记一下""新建笔记" | notes | import_doc |
| "把这段加到 XX 笔记" | notes | 先搜 note_id 再 append_doc |
| "上传文件到知识库" | knowledge-base | create_media → add_knowledge |
| "把网页存进知识库" | knowledge-base | import_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_media → add_knowledge 两步流程。
常见问题及解决方案
凭证没配。把 client_id/api_key 写进 ~/.config/ima/ 或设环境变量
IMA_OPENAPI_CLIENTID 和 IMA_OPENAPI_APIKEY。notes 写入前必须确认字符串是合法 UTF-8。Windows 用户注意:PowerShell 5.1 的 Invoke-RestMethod 会静默把 UTF-8 转成 GBK,必须显式转 UTF-8 字节数组再发。乱码不可逆,只能重新写入。
IMA 知识库不支持视频文件和这些 URL,请用 IMA 桌面客户端处理。
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。
常见问题及解决方案
用错品类工具了。先用
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 user | lark-cli auth login | 访问你自己的资源(日历、云盘、文档) |
| bot 应用 | --as bot | 自动(appId+appSecret) | 应用级操作,创建的内容归属 bot;看不到用户资源 |
适用场景
- 团队文档/多维表格的批量生成与维护(让 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 可以打印完整请求但不真正执行,适合确认参数。
常见问题及解决方案
user 身份:
lark-cli auth login --scope "缺失scope" 补授权;bot 身份:去飞书开发者后台给应用开通 scope。身份选错了。bot 看不到用户资源,改用
--as user 并先 auth login。lark-cli 对高风险写操作有确认门禁。这不是普通错误,WorkBuddy 会向你确认后再在命令末尾加 --yes 重试。不要静默加 --yes 绕过。5. WorkBuddy + 乐享知识库
乐享知识库(lexiangla.com)是腾讯出品的企业知识库平台,支持团队 Wiki、知识沉淀、文档协作、腾讯会议录制导入和 iWiki 迁移。通过 MCP 连接器接入 WorkBuddy。
核心功能
乐享知识库按意图路由到子模块:
| 意图 | 子模块 | 典型动作 |
|---|---|---|
| 配置 / 401 / Token 过期 | setup | 续期(点按钮,无需重配)、初始 OAuth |
| 搜索 / 查找 / 阅读 | search | 关键词/语义搜索、读页面、看目录 |
| 创建文档 / 写入 / 导入 | writer | 新建文档、导入内容、公众号收藏 |
| 编辑已有页面 | blocks | 加标题、删段落、Block 级增删改移 |
| 上传/下载文件 | files | 二进制三步流程(PDF/Word/图片) |
| 导入腾讯会议 / iWiki | connectors | 会议录制导入、iWiki 页面迁移 |
适用场景
- 团队知识库的内容生产:让 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)。
常见问题及解决方案
立即停手,不要重试。引导续期(点续期按钮)。这是最常见的"连接过期",不是代码问题。
写入必须基于你明确提供的目标(URL / ID / 确认过的名称)。给清晰的 space_id 或 /pages/xxx 链接。
检查是否误把 company_from 拼成了子域名。让 WorkBuddy 用 whoami() 的 company_domain 重新生成。
对比一:存储与部署
| 维度 | Obsidian | IMA 知识库 | 腾讯文档 | 飞书 | 乐享知识库 |
|---|---|---|---|---|---|
| 存储位置 | 本地文件系统 | 腾讯云端 | 腾讯云端 | 字节云端 | 腾讯云端 |
| 部署方式 | 桌面端安装 | 网页/桌面/移动 | 网页/桌面/移动 | 网页/桌面/移动 | 网页/桌面 |
| 多端同步 | 需 Sync/Git | 原生云端同步 | 原生云端同步 | 原生云端同步 | 原生云端同步 |
| 离线支持 | 完全离线可用 | 需联网 | 需联网 | 需联网 | 需联网 |
| 数据所有权 | 完全自有 | 托管在云端 | 托管在云端 | 托管在云端 | 托管在云端 |
对比二:鉴权与安全
| 维度 | Obsidian | IMA 知识库 | 腾讯文档 | 飞书 | 乐享知识库 |
|---|---|---|---|---|---|
| 鉴权方式 | 无需鉴权 | API Key | 连接器票据 | OAuth + bot Token | OAuth |
| 权限粒度 | 文件系统级 | 应用级 | 文档级 | scope 级(细粒度) | 空间级 |
| 凭证管理 | 无 | 配置文件/环境变量 | 宿主自动注入 | auth login 累积授权 | OAuth 续期 |
| 数据安全 | 本地加密可控 | 腾讯云安全 | 腾讯云安全 | 字节云安全 | 腾讯云安全 |
| Token 过期处理 | 不适用 | 重新获取 Key | 宿主自动刷新 | 重新 auth login | 点续期按钮 |
对比三:核心能力
| 维度 | Obsidian | IMA 知识库 | 腾讯文档 | 飞书 | 乐享知识库 |
|---|---|---|---|---|---|
| 文档类型 | Markdown / Canvas | 笔记 + 知识库 | 文档/表格/PPT/脑图/流程图 | 文档/多维表格/表格/幻灯片 | Wiki 页面 + 文件 |
| 协作能力 | 无(单人) | 分享 | 实时协作 | 实时协作 + 评论 | 团队协作 + 权限 |
| 搜索能力 | 全文搜索 | AI 语义检索 | 文档内搜索 | 全文 + 多维筛选 | 关键词 + 语义搜索 |
| AI 能力 | 无内置 | AI 问答/摘要 | OCR | AI 助手 | AI 搜索/推荐 |
| 双链支持 | 原生 [[wikilinks]] | 无 | 无 | 无 | 无 |
对比四:自动化与集成
| 维度 | Obsidian | IMA 知识库 | 腾讯文档 | 飞书 | 乐享知识库 |
|---|---|---|---|---|---|
| API 完整度 | CLI 工具 | OpenAPI 完整 | 多 endpoint MCP | CLI + SDK 完整 | MCP 全功能 |
| 自动化成本 | 最低(写文件) | 低(API 调用) | 中(多 endpoint) | 中(需授权) | 中(需 OAuth) |
| WorkBuddy 集成深度 | 直接读写 + CLI | API 双模块 | 4 品类 MCP | 全栈 CLI + bot | 6 子模块 MCP |
| 定时任务支持 | 文件监听/定时写入 | API 定时调用 | API 定时调用 | bot + webhook | API 定时调用 |
| 扩展性 | 插件生态丰富 | API 扩展 | API 扩展 | 开放平台 + 应用市场 | connectors 扩展 |
对比五:适用场景
| 维度 | Obsidian | IMA 知识库 | 腾讯文档 | 飞书 | 乐享知识库 |
|---|---|---|---|---|---|
| 最适合 | 个人 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 迁移 |