🔔 开篇导语

先说个扎心的事。

我 Obsidian 里现在攒了快一千条笔记。每次想找点东西，都得一条条翻——翻着翻着，就被另一条笔记勾走，半小时后发现自己在看三个月前记的菜谱。

更烦的是那些"AI 笔记"工具。要么逼你把整个库上传到别人服务器，我心里发毛；要么只认一家大模型，今天想换个模型，明天配置全得重来。

所以我干脆自己做了个插件，叫 Smart Notes。

它干的事很简单：让你仓库里的 AI 真正"懂"你的笔记，同时——这一点我最在意——数据主动权全在你自己手里。

📖 认识 Smart Notes：它到底能做什么

Smart Notes 是个开源的 Obsidian AI 插件（Obsidian 1.11.4 以上就能跑）。说白了，它不替你写笔记，而是在你要用的时候，帮你看清、理顺、补全已经有的知识。

我平时用得最多的，是底下这三块。

一、在右侧栏，跟你的仓库聊天

右侧有个 AI 对话面板，你可以问整个仓库，也可以只问当前这篇笔记。

讲真，下面这些功能一旦用顺手，就回不去了：

• 多会话并行：新建、切换、改名、删会话都行，每个会话单独存自己的消息、附件和联网状态。我一般"技术问答"开一个、"写文章"开一个，互不干扰。
• 流式回复 + Token 显示：回答是实时刷出来的，而且每条后面都标了 Token 花了几个——这点对我这种计较成本的人太友好了。
• 每次对话单独选模型和角色：这条用 DeepSeek，那条用 GPT，随你。
• 推理过程看得见：像 DeepSeek-R1、OpenAI o1 这种会"思考"的模型，思考过程折起来放在答案上面，想看就看。
• 历史窗口：聊长了，前面几轮会自动压成摘要，省 Token 又不丢上下文。

二、模型你说了算，不绑任何一家

Smart Notes 不站队任何厂商。你可以配一个或多个 模型链接（Model Link），每个指向一个 AI 后端：

• OpenAI 兼容：OpenAI、Azure、DeepSeek、本地网关都行，填个 Base URL + API Key 就完事。
• Ollama 本地：只填 Base URL，模型在你自己机器上跑，完全离线。
• API Key 存在 Obsidian 钥匙串（SecretStorage） 里，不是明文堆在插件数据里；保存前还能点 测试连接 先试试通不通。
• 任意一个链接都能设成 默认，全插件所有 AI 功能统一走它。

✨ 价值所在：为什么我愿意一直用

功能多不稀奇。真正让我留下来的，是它那股"不绑架你"的劲儿。

三、隐私优先：AI 只看你主动给它看的

这是我设计时的铁律：AI 只读取你明确告诉它的东西。

• 文件路径索引（可选）：只把全部 Markdown 的路径喂给提示词，AI 知道库里有什么，但不加载正文。
• Frontmatter 索引（可选）：只注入每个笔记的 YAML 属性（标签、分类、摘要），同样不含正文。
• 附件 / @ 点名：你手动附加的文件、或在消息里 @ 的某个笔记，内容才会被读。
• 剩下的全留在本地；甚至能彻底隐藏"附加文件/文件夹"那个按钮。

💡 打个比方：它给你一张"门禁卡"，你不开门，AI 一步也进不来。

四、从工具到助手：角色、技能、联网、长期记忆

Smart Notes 不只是个"问答工具"，它会慢慢变成懂你的助手：

• 角色（Roles）：把常用的系统提示词存成可复用角色，比如"严厉的审稿人""接地气的科普老师"，默认角色会注进所有 AI 功能。
• 技能（Skills）：把带 SKILL.md 的文件夹扔进 skills/ 目录就能用，只有激活的技能内容才发给 AI。
• 联网搜索（可选）：支持 Tavily / Serper / Brave / SearXNG，多个密钥轮着用，结果能内联 [n] 引用；默认关着，需要再开。
• 长期画像记忆：后台会把聊天历史提炼成 memory/MEMORY.md 长期画像，当背景上下文注进去，而且你随时能手动改。

🚀 安装上手：三步就能用

门槛真的低，三步完事。

五、实操步骤

1. 装插件：最简单的——Obsidian 里打开 设置 → 第三方插件（Community plugins），关掉安全模式，搜 Smart Notes 一键装好启用（它已经上架 Obsidian 第三方应用市场了）。当然也能手动装（把 main.js、manifest.json、styles.css 丢进 .obsidian/plugins/smart-notes/），或者用 BRAT 加 beta 库。
2. 配模型链接：进 设置 → Smart Notes → 模型配置，新增一条链接，填好 Base URL 和 API Key（或 Ollama 地址），点"测试连接"验证，再设成默认。
3. 开聊 / 优化：右侧打开 AI 对话面板提问，或者用命令"优化当前笔记""生成 Frontmatter"给文章润色。

⚠️ 调试的时候，建议拿个独立测试仓库，别直接在主力库上跑。

❓ 常见问题与避坑

Q：我的笔记会被上传吗？

A：不会。除非你主动附加文件、或者在消息里 @ 某条笔记。各种索引只带路径和元数据，不含正文。插件没有任何遥测。

Q：能用本地模型吗？

A：能。配个 Ollama 链接，模型在本地跑，就完全离线，数据不出本机。

Q：Obsidian 有版本要求吗？

A：要 Obsidian 1.11.4 以上。

Q：API Key 安全吗？

A：Key 在 Obsidian 钥匙串里，不是明文插件数据；而且每条链接都能先"测试连接"再存。

📋 全文总结

Smart Notes 想做的，不是又一个"替你写"的 AI 玩具，而是长在 Obsidian 里的一双 AI 眼睛：

• 它懂你的仓库，却不偷看你的隐私；
• 它听你指挥，模型、角色、技能你说了算；
• 它陪你长大，把零散对话沉淀成能手动改的长期记忆。

要是你也被"笔记越多越乱、AI 越用越不放心"折磨过，真心建议试一下。

💬 互动结尾

你现在的 Obsidian 工作流里，最希望 AI 帮你搞定哪一步？是整理链接、润色笔记，还是跨笔记问答？

评论区聊聊你的痛点，也欢迎转给同样被"笔记焦虑"困扰的朋友。