WorkBuddy 接入 Obsidian：Workbuddian 插件安装与使用教程
WorkBuddy 是腾讯出品的全场景 AI 办公工作台。本专题 46 篇课程，覆盖"认识工具—设计任务—验收结果—扩展能力—自动化协作—长期维护—实战案例—进阶方法—岗位行业—底层机制"完整路径，包含 100+ 真实使用场景。
一句话结论
原文转载：@alin_zone 的 Workbuddian 插件教程，把 WorkBuddy 接入 Obsidian 笔记库。以下正文为原文原样。
现在可以直接在 Obsidian 里使用 WorkBuddy 了。
不用切换窗口。装上 Workbuddian 之后，聊天、引用笔记、添加附件、修改文件，全都可以留在 Obsidian 里完成。
今天只讲两件事：
① 安装 Workbuddian，把它连上本地 WorkBuddy，约 3 分钟 ② 看懂输入栏按钮和插件设置，约 3 分钟
跟着截图走就行。
1️⃣ 开始前准备一下
你需要先有下面这些东西：
- Obsidian
- 已安装并登录 WorkBuddy
- Windows 或 macOS 电脑
Workbuddian 目前只支持桌面端，手机和平板上的 Obsidian 暂时不能用。
一句话概括：Workbuddian 会调用 WorkBuddy 自带的 CodeBuddy CLI，所以不用再买一份 API Key。
2️⃣ 安装 Workbuddian
打开 Obsidian，点左下角的齿轮，进入设置。
找到「第三方插件」，点击「浏览」。
在搜索框输入 Workbuddian 。
认准作者 jiang198012 ，点「安装」，装完再点「启用」。
回到 Obsidian 主界面。
左侧工具栏里会多出一个 Workbuddian 图标。点它，右侧就会打开聊天面板。
看到聊天面板，插件本体就装好了。
下面把它和 WorkBuddy 连起来。
3️⃣ 连接 WorkBuddy
这一步，macOS 和 Windows 分开看。
macOS：CodeBuddy 留空，Node.js 手动填写
打开 Obsidian 设置，找到 Workbuddian。
CodeBuddy 路径 留空就行，插件可以自动识别 WorkBuddy 自带的 CodeBuddy CLI。
但我这次在 macOS 上实测，Node.js 没有被自动识别，手动指定 Node.js 路径 仍然要自己填写。
最简单的方法还是直接问 WorkBuddy。
把下面这段发给它：
我要在 macOS 的 Obsidian 中配置 Workbuddian 插件，请只读取和检查本机文件，不要修改或删除任何内容。请帮我找到 WorkBuddy 管理的 Node.js 可执行文件完整路径。路径应该以 /bin/node 结尾。请确认文件真实存在并能运行，最后只返回一条可以直接复制到 Workbuddian 设置中的完整路径。
它返回的路径通常长这样：
/Users/你的用户名/.workbuddy/binaries/node/versions/版本号/bin/node
把自己电脑上查到的完整结果，粘贴到手动指定 Node.js 路径 。
回到聊天面板，发送：
你好
能正常加载模型并回复，说明连接已经完成。
Windows：先自动识别，失败了再查路径
Windows 也先直接打开聊天面板测试。
能回复，就不用填。
如果插件提示找不到 CodeBuddy CLI 或 Node.js，最简单的方法不是自己翻文件夹，而是直接让 WorkBuddy 帮你找。
把下面这段复制到 WorkBuddy：
我要在 Windows 的 Obsidian 中配置 Workbuddian 插件，请只读取和检查本机文件，不要修改或删除任何内容。请帮我找到并验证：WorkBuddy 自带的 CodeBuddy CLI 完整路径 可以运行该 CLI 的 managed Node.js（node.exe）完整路径 请确认这两个文件真实存在，最后只返回两条可以直接复制到 Workbuddian 设置中的完整路径。
win 实际问完之后，WorkBuddy 直接返回了两条路径：
图里返回的是：
D:\workbuddy\resources\app.asar.unpacked\cli\bin\codebuddy C:\Users\Administrator.workbuddy\binaries\node\versions\22.22.2\node.exe
⚠️ 这两条只能看格式，不能照抄。
每个人的安装盘符、Windows 用户名和 Node.js 版本都可能不同。请使用 WorkBuddy 在你自己电脑上查到的结果。
回到 Obsidian → 设置 → Workbuddian，把两条结果分别填到：
- ❶ CodeBuddy 路径
- ❷ 手动指定 Node.js 路径
再回聊天面板发送：
你好
能正常回复，安装和连接就全部完成了。
4️⃣ 输入栏里的按钮有什么用
连接成功之后，先把输入框下面这一排按钮认一下。
Auto：选择模型
左下角的 Auto 是模型选择器。
普通使用保持自动即可。你想指定某个模型时，再点开切换。
回形针：添加附件
可以把截图、图片、PDF 或其他文件一起发给 WorkBuddy。
需要分析一张报错截图，直接从这里添加。
盾牌：切换权限
点击盾牌，会看到三个模式：
- 默认（每步询问） ：修改文件、运行命令之前先问你。新手推荐这个
- 计划模式（只读不改） ：只分析和制定计划，不修改文件
- 完全访问 ：允许直接执行操作，减少逐步确认
刚装好先用默认模式。
等你熟悉它会做什么，再决定要不要打开完全访问。
#：设置常驻指令
点击 # ，可以给所有对话设置一条长期规则或人设。
例如：
始终使用中文回答。修改文件前先说明准备改什么。
保存之后，新开的对话也会遵守这条要求。
纸飞机：发送
点击纸飞机发送消息。
也可以按 Enter 发送，Shift + Enter 换行。
@：引用笔记和文件
在输入框里输入 @ ，可以引用 Vault 里的笔记和文件。
如果后面配置了 MCP 或子代理，也能从这里调用。
这篇先把插件装通，具体玩法以后再展开。
5️⃣ 设置页里有什么
Workbuddian 的设置不少，但第一次使用真正需要看的只有最上面的连接设置。
CodeBuddy 连接
CodeBuddy 路径 ：CodeBuddy CLI 可执行文件的完整路径。
手动指定 Node.js 路径 ：Node.js 可执行文件的完整路径，macOS 上通常以 /bin/node 结尾，Windows 上通常以 node.exe 结尾。
我这次的 macOS 实测结果是：CodeBuddy 路径可以留空，Node.js 路径需要手动填写。
Windows 也先测试自动识别。连接失败时，再用前面的提示词让 WorkBuddy 查询两条路径。
CLI 超时时长 ：单次任务最长等待多久。默认 5 分钟，普通使用不用改。
思考力度 ：控制当前会话的思考设置。没特殊需求，保持默认。
MCP 服务器和子代理
MCP 服务器 用来给 Workbuddian 接外部工具。
子代理 用来配置不同职责的 AI Agent。
第一次安装，这两项全部留空，不影响正常聊天。
其他设置
继续往下还能设置：
- 是否自动注入当前 Vault 路径
- 是否带上当前笔记链接
- 是否自动生成会话标题
- 界面语言和主题颜色
- 上下文窗口上限
- 设置导入、导出和重置
- 查看日志，排查连接或响应问题
先保持默认就行。
如果遇到一直思考、无响应或者路径识别失败，再打开日志看具体报错。
6️⃣ 搞定
到这里，两件事做完了：
① Workbuddian 已经安装并连上 WorkBuddy ② 输入栏和插件设置已经看懂
以后不用在 WorkBuddy 和 Obsidian 之间来回切。
想引用笔记，输入 @ 。想加文件，点回形针。涉及修改时，默认模式会先让你确认。
先把最基础的聊天跑通。
MCP、子代理、笔记修改和更多高级玩法，后面可以再单独写。
原文信息
作者：@alin_zone