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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/siyuan-note/raw/index.md(查看排版版本)