SiYuan Note

连接AI与思源笔记,实现知识库的搜索、读取与写入。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:SiYuan Note。
它的用途是:连接AI与思源笔记,实现知识库的搜索、读取与写入。
完整的 Skill 内容见:https://321skill.com/skills/siyuan-note/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我在思源笔记里搜索所有关于‘机器学习模型评估’的笔记,并总结成一份要点摘要。”,它会通过MCP插件连接到你的思源笔记,执行搜索,并将相关笔记块的内容整合成一份清晰的报告。或者,你可以说:“把刚才我们讨论的项目计划要点,写入到思源笔记的‘项目日志’文档中。”,AI便会将对话内容结构化后,创建或更新你指定的笔记。

介绍

SiYuan Note Skill 是一个MCP(Model Context Protocol)插件,它充当了AI助手(如Claude)与本地思源笔记软件之间的桥梁。它解决了AI助手无法直接访问和操作用户本地私有知识库的问题,让AI能够基于你的个人笔记内容进行对话、创作和分析。

使用前,你需要在本地安装并运行思源笔记软件,并确保其服务端口(默认16806)可用。然后在你的AI助手环境中配置此MCP插件,AI助手即可通过该插件调用思源笔记的API,实现对笔记内容的搜索、检索和写入操作。

这个Skill非常适合那些深度使用思源笔记作为个人知识管理系统的用户,尤其是内容创作者、学术研究者和需要频繁整理、调用大量文档知识的专业人士。它能让你的AI助手真正成为你“第二大脑”的智能接口。

使用建议:请确保思源笔记的版本与此插件兼容。由于涉及本地网络连接,初次使用时请检查防火墙或安全软件设置,确保AI助手环境能够访问localhost:16806端口。注意,写入操作会直接修改你的笔记,建议在重要操作前做好备份。

核心特点

与通用的文件读取Skill不同,它深度集成了思源笔记的块级编辑和双向链接特性,支持基于语义和结构的精准搜索与内容关联,而非简单的全文检索。同时,它提供了对思源笔记原生API的直接调用,确保了操作的高效性和数据一致性。

注意事项

不适合未安装或未运行思源笔记软件的用户,也无法直接处理思源笔记仓库之外的其他本地文件。

常见问题

思源笔记必须一直开着吗?

是的,需要思源笔记在本地运行并开启服务端(默认16806端口)才能连接。

它能搜索笔记里的图片内容吗?

目前主要支持文本内容的搜索、检索和写入,对图片等非文本附件的处理能力有限。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/siyuan-note/raw/index.md 读取 SiYuan Note 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。