WorkBuddy 搭配思源笔记:纯小白首次 AI 体验——赋能个人笔记
把思源笔记的 MCP 插件接到 WorkBuddy:一句话搜索、改写、新建笔记,让上千篇本地文档从关键词硬匹配变成自然语言调用,附配置过程、日常用法与踩坑。
WorkBuddy 搭配思源笔记:纯小白首次AI体验——赋能个人笔记#WorkBuddy#
先介绍一下自己吧,我是一个笔记爱好者(或者说单纯的囤囤鼠属性)
每次看到不错的文章、句子都会摘抄下来,上学的时候一直用的notion作为自己的笔记软件,但是毕业之后学生邮箱被注销,notion又限制只能用邮件验证登陆,丢失了很多东西
所以想到做本地的知识笔记,最后找到思源笔记,基本符合我的使用习惯和需求
在过去一年多的时间里,我攒了上千篇文档,但实话实说,很多写完就再也没打开过。搜索靠关键词硬匹配,偶尔整理一次要花很长很长时间,而且每次思路一变,就需要全盘调整之前的分类思路
而最近发现了思源笔记插件市场更新了mcp插件,把思源和ai 用 MCP 连起来之后,整个使用体验完全变了——对着 WorkBuddy 说一句话就能搜笔记、改笔记、写笔记,不用再记那些复杂的语法和路径。
这篇文章把我的配置过程和日常用法整理出来,希望能帮到同样用思源的朋友。
一、为什么要把 WorkBuddy 和思源笔记连起来?
如果你同时满足以下两个条件,这篇文章就是为你写的:
- 你在用思源笔记——本地优先、块级引用、数据自主,但太过内容庞,不方便自己调用整理
- 你在用 WorkBuddy——腾讯出品的 AI 办公工作台,能读文件、跑代码、生成文档
把两者用 MCP 连起来之后,你能做到这些事情:
- 对着 WorkBuddy 说"帮我搜一下笔记里关于 XXX 的所有记录",将直接在思源里全文检索
- 让 AI 读取你的笔记本,自动生成摘要、提炼待办、整理标签
- 把 WorkBuddy 生成的调研报告、会议纪要直接写入思源笔记
- 用 AI 跨笔记本搜索、批量重命名、重构文档结构
核心组件:SiYuan Sisyphus MCP & CLI——一个思源笔记插件,把思源的 100+ 个 API 能力收敛为 13 个 AI 友好的聚合工具,让外部 Agent 能像操作文件系统一样操作笔记。
二、开始前的准备
2.1 环境
| 软件 | 用途 | 获取方式 |
|---|---|---|
| 思源笔记 | 知识库底座 | 官网下载,建议 3.7.0+ |
| 思源 sisyphus MCP & CLI & GIT 插件 (如果你都在用那么只需要在插件市场按照这个插件就好) | MCP 桥接 | 思源集市搜索 "Sisyphus" 安装 |
| WorkBuddy | AI Agent | 官网下载 codebuddy.cn/work |
2.2 在思源中安装 Sisyphus 插件
- 打开思源笔记 → 顶部菜单 → 集市
- 搜索 SiYuan Sisyphus MCP & CLI
- 点击下载并安装
- 安装后进入:设置 → SiYuan Sisyphus MCP & CLI
2.3 配置 WorkBuddy 连接
Sisyphus 提供两种连接方式,这里推荐 MCP 模式(适合多步 Agent 工作流):
发送Sisyphus的map链接到workbuddy
配置完成后,在连接器中点击信任即可
连接成功后,WorkBuddy 会发现以下工具组:
- notebook——笔记本管理(列出、创建、配置权限)
- fs——文件系统式操作(ls / tree / read / write / search)
- document——文档操作(创建、重命名、移动、转换)
- search——全文检索、SQL 查询、反向链接
- block——块级操作
- tag——标签管理
- flashcard——闪卡
- av——数据库(属性视图)
- extension——官方 MCP 插件生态桥接
- system——系统信息与安全
- feedback——反馈提交
- mascot——插件内置小猫(彩蛋)
三、实战场景
场景一:让 AI 全局搜索你的知识库
痛点:思源的搜索框只能关键词匹配,没法理解自然语言意图。
操作方式:直接在 WorkBuddy 里用自然语言提问。
比如你对 WorkBuddy 说:
帮我在思源笔记里搜索所有提到"情绪经济"的内容,按相关度排序,每条结果附带所在文档路径
WorkBuddy 会调用 search 工具的 fulltext action,返回匹配的块内容、文档路径和上下文。你还可以进一步追问:
这些结果里,哪些是我在 2026 年写的?
WorkBuddy 会用 query_sql action 执行 SQL 查询,按时间过滤:
SELECT content, hpath, created
FROM blocks
WHERE content LIKE '%情绪经济%'
AND type = 'p'
ORDER BY created DESC
LIMIT 20场景二:让 AI 帮你整理和重构笔记
痛点:笔记越写越多,结构越来越乱,但手动整理太耗时。
操作方式:用 fs 工具的类文件系统操作。
对 WorkBuddy 说:
读取思源笔记 /个人笔记/读书笔记 这个目录下的所有文档,帮我生成一份目录索引页,包含每篇笔记的标题和一句话摘要
WorkBuddy 会依次调用:
- fs(action="tree", path="/个人笔记/读书笔记")——列出目录结构
- fs(action="read", path="/个人笔记/读书笔记/XXX")——逐篇读取内容
- 生成摘要后,用 fs(action="write", path="/个人笔记/读书笔记/目录索引") 写回一篇索引文档
场景三:把 WorkBuddy 的产出直接写入思源
痛点:用 AI 生成了报告/纪要,还要手动复制粘贴到笔记里。
操作方式:让 WorkBuddy 生成内容后直接调用 fs.write。
比如:
帮我写一份本周工作总结,写完后直接存到思源笔记的 /工作日志/2026-08 第32周 这个路径下
WorkBuddy 先生成周报内容,然后调用:
fs(action="write", path="/工作日志/2026-08 第32周", markdown="...")文档直接出现在思源笔记里,无需任何手动操作。
场景四:批量查找和修复失效引用
痛点:笔记删多了,反向链接全断了,一个个找太痛苦。
操作方式:用 search 的 list_invalid_refs action。
对 WorkBuddy 说:
帮我检查思源笔记里所有失效的引用链接,列出来源文档和目标
WorkBuddy 调用 search(action="list_invalid_refs"),返回所有断链的来源块和目标信息。然后你可以让它帮你批量修复或清理。
场景五:用文档时间线做版本管理
痛点:改了笔记想回退,但思源自带的快照不好用。
Sisyphus 提供了类 Git 的文档时间线功能:
- 为文档创建命名快照(比如"v1.0 初稿")
- 对比历史快照与当前版本(统一 diff / 并排 diff)
- 回退整篇文档或单独恢复部分块
配合 WorkBuddy,你可以让 AI 在修改笔记前先创建快照:
修改 /项目文档/产品方案 之前,先帮我创建一个时间线快照叫"修改前备份",然后再做修改
四、权限与安全:让 AI 在边界内操作
这是很多人最关心的问题:让 AI 直接操作笔记,安全吗?
Sisyphus 的设计哲学是"明确边界":
4.1 笔记本级权限
每个笔记本可以独立设置四种权限:
| 权限 | 含义 | AI 能做什么 |
|---|---|---|
| none | 完全隐藏 | AI 看不到这个笔记本的存在 |
| r | 只读 | AI 可以读取和搜索,不能修改 |
| rw | 可读写 | AI 可以读取和编辑,不能删除 |
| rwd | 可读写删 | AI 可以读取、编辑和删除 |
权限也可以在左侧文件树中,进行快速修改,如下:
建议:日常使用时,把核心笔记本设为 r 或 rw,只把临时笔记本设为 rwd。
4.2 危险操作确认
删除(rm)、移动(mv)、查找替换(find_replace)等操作会触发确认机制,WorkBuddy 会在执行前向你展示操作内容,你确认后才实际执行。
五、进阶技巧
5.1 用 CLI 做自动化
除了 MCP,Sisyphus 还提供命令行工具:
npm i -g siyuan-sisyphus
siyuan-sisyphus init
siyuan-sisyphus notebook listCLI 适合写脚本做定时任务。比如每天早上自动把昨天的日记整理成摘要:
siyuan-sisyphus doc read --path "/日记/$(date -d yesterday +%Y-%m-%d)" | \
# 管道传递给其他工具处理5.2 场景 Skill:让 AI 更懂思源
Sisyphus 内置了面向 Agent 的场景 Skill,覆盖浏览、编辑、搜索、数据库、导出、标签、闪卡等场景。支持安装 SKILL.md 的 Agent 可以直接使用:
siyuan-sisyphus skill install --bundle allWorkBuddy 原生支持 Skill 系统,安装后 AI 会自动在合适场景加载对应指南。
5.3 用 SQL 做复杂查询
search(action="query_sql") 支持 SQL 查询,这是最强大的检索方式:
出最近 7 天更新的所有带标签的段落
SELECT content, hpath, tag, updated
FROM blocks
WHERE type = 'p'
AND tag != ''
AND updated > strftime('%Y%m%d%H%M%S', 'now', '-7 days')
ORDER BY updated DESC
LIMIT 505.4 低上下文设计
Sisyphus 把 100+ 个思源能力收敛为 13 个聚合工具,按 action 路由。这意味着 AI 不需要理解 100 个工具的 Schema,只需要知道 13 个工具名 + action 参数。详细说明按需读取(通过 action="help" 或 siyuan://help/action/{tool}/{action}),大幅降低 Token 消耗。
六、常见问题与避坑
Q:连接失败怎么办?
先检查思源版本是否 ≥ 3.7.0(官方 MCP 生态功能需要)。如果只是用 Sisyphus 自带工具,2.9.0 即可。在 Sisyphus 设置页查看连接状态和错误信息。
Q:MCP 和 CLI 选哪个?
- MCP:适合 WorkBuddy 这类 Agent,需要自动发现工具、多步操作、验证结果
- CLI:适合脚本、自动化、单次任务,不占用模型上下文
两者共用同一套核心调用路径,行为一致。
Q:AI 会不会误删我的笔记?
不会。删除和移动操作需要你手动确认。建议把重要笔记本设为 r 只读权限。
Q:官方 MCP 和 Sisyphus 自带工具有什么区别?
Sisyphus 自带工具始终只调用思源 /api//*,有完整的权限和危险操作控制。官方 MCP 桥接是额外生态入口,转发其他插件注册的 Tool,不继承 Sisyphus 的权限控制。两者可以共存,不需要二选一。
Q:消耗积分多吗?
日常搜索和读取操作消耗很少(10-30 积分)。批量操作和深度整理会多一些(50-200 积分)。建议简单查询用轻量模型,复杂整理任务月初额度充足时做。
七、总结
WorkBuddy + 思源笔记 + MCP 的组合,本质上是给你的知识库装上了一个 AI 大脑+机械臂:
| 能力 | 单独用思源 | 连接 WorkBuddy 后 |
|---|---|---|
| 搜索 | 关键词匹配 | 自然语言 + SQL 查询 |
| 整理 | 手动拖拽 | AI 自动生成索引和摘要 |
| 写入 | 手动复制粘贴 | AI 产出直接写回笔记 |
| 版本管理 | 基础快照 | 类 Git 时间线 + AI 辅助回退 |
| 引用修复 | 逐个检查 | 批量检测和修复 |
安装只需三步:装思源 → 装 Sisyphus 插件 → 在 WorkBuddy 里配置 MCP 连接。
如果你的知识库已经积累了大量笔记但缺少有效的整理和检索手段,这套方案值得一试。
本文基于 WorkBuddy + SiYuan Sisyphus MCP v0.5.1 的实际使用体验整理。#思源笔记##WorkBuddy#
我是 灵能菌子 12667416,一个喜欢折腾 AI 效率工具的普通人
欢迎关注我
如果这篇教程对你有帮助,记得点赞 + 收藏 👍,也欢迎在评论区聊聊……
转载自: https://cloud.tencent.com/developer/article/2720112




