WorkBuddy 搭配思源笔记:纯小白首次 AI 体验——赋能个人笔记

把思源笔记的 MCP 插件接到 WorkBuddy:一句话搜索、改写、新建笔记,让上千篇本地文档从关键词硬匹配变成自然语言调用,附配置过程、日常用法与踩坑。

WorkBuddy 搭配思源笔记:纯小白首次AI体验——赋能个人笔记#WorkBuddy#

先介绍一下自己吧,我是一个笔记爱好者(或者说单纯的囤囤鼠属性)
每次看到不错的文章、句子都会摘抄下来,上学的时候一直用的notion作为自己的笔记软件,但是毕业之后学生邮箱被注销,notion又限制只能用邮件验证登陆,丢失了很多东西
所以想到做本地的知识笔记,最后找到思源笔记,基本符合我的使用习惯和需求

在过去一年多的时间里,我攒了上千篇文档,但实话实说,很多写完就再也没打开过。搜索靠关键词硬匹配,偶尔整理一次要花很长很长时间,而且每次思路一变,就需要全盘调整之前的分类思路
而最近发现了思源笔记插件市场更新了mcp插件,把思源和ai 用 MCP 连起来之后,整个使用体验完全变了——对着 WorkBuddy 说一句话就能搜笔记、改笔记、写笔记,不用再记那些复杂的语法和路径。

这篇文章把我的配置过程和日常用法整理出来,希望能帮到同样用思源的朋友。

一、为什么要把 WorkBuddy 和思源笔记连起来?

如果你同时满足以下两个条件,这篇文章就是为你写的:

  1. 你在用思源笔记——本地优先、块级引用、数据自主,但太过内容庞,不方便自己调用整理
  1. 你在用 WorkBuddy——腾讯出品的 AI 办公工作台,能读文件、跑代码、生成文档

把两者用 MCP 连起来之后,你能做到这些事情:

  • 对着 WorkBuddy 说"帮我搜一下笔记里关于 XXX 的所有记录",将直接在思源里全文检索
  • 让 AI 读取你的笔记本,自动生成摘要、提炼待办、整理标签
  • 把 WorkBuddy 生成的调研报告、会议纪要直接写入思源笔记
  • 用 AI 跨笔记本搜索、批量重命名、重构文档结构

核心组件:SiYuan Sisyphus MCP & CLI——一个思源笔记插件,把思源的 100+ 个 API 能力收敛为 13 个 AI 友好的聚合工具,让外部 Agent 能像操作文件系统一样操作笔记。

https://d.321788.cn/uploads/article/202611/20261102-e6bad773574b1aea.png

二、开始前的准备

2.1 环境

软件用途获取方式
思源笔记知识库底座官网下载,建议 3.7.0+
思源 sisyphus MCP & CLI & GIT 插件 (如果你都在用那么只需要在插件市场按照这个插件就好)MCP 桥接思源集市搜索 "Sisyphus" 安装
WorkBuddyAI Agent官网下载 codebuddy.cn/work

2.2 在思源中安装 Sisyphus 插件

  1. 打开思源笔记 → 顶部菜单 → 集市
  1. 搜索 SiYuan Sisyphus MCP & CLI
  1. 点击下载并安装
  1. 安装后进入:设置 → SiYuan Sisyphus MCP & CLI

2.3 配置 WorkBuddy 连接

Sisyphus 提供两种连接方式,这里推荐 MCP 模式(适合多步 Agent 工作流):

发送Sisyphus的map链接到workbuddy
配置完成后,在连接器中点击信任即可

https://d.321788.cn/uploads/article/202611/20261102-f882fbbf62eb6629.png

https://d.321788.cn/uploads/article/202611/20261102-416c2403cb3f115d.png

连接成功后,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 会依次调用:

  1. fs(action="tree", path="/个人笔记/读书笔记")——列出目录结构
  1. fs(action="read", path="/个人笔记/读书笔记/XXX")——逐篇读取内容
  1. 生成摘要后,用 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 可以读取、编辑和删除

https://d.321788.cn/uploads/article/202611/20261102-5485466926c26d82.png

权限也可以在左侧文件树中,进行快速修改,如下:

https://d.321788.cn/uploads/article/202611/20261102-4707a6d67c123657.png

建议:日常使用时,把核心笔记本设为 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 list

CLI 适合写脚本做定时任务。比如每天早上自动把昨天的日记整理成摘要:

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 all

WorkBuddy 原生支持 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 50

5.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


0 个评论

要回复文章请先登录或注册