Smart Composer：把 AI 对话台直接搬进你的笔记库

你有没有过这样的经历：想用 ChatGPT 帮你整理一篇笔记，结果光是把背景信息复制粘贴进去，就花了十分钟？你已经有了 Obsidian 这个强大的第二大脑，里面存满了你的思考、读书笔记、项目记录，可每次问 AI，你还得把这些内容重新喂给它。

Smart Composer 解决的就是这个上下文断层问题。它是一个 Obsidian 插件，让 AI 直接看到你的笔记库，提问时只需输入 @ 引用文件名，AI 就能基于你的笔记内容给出精准回答。灵感来自 Cursor AI 和 ChatGPT Canvas，目标是让写作和 AI 辅助融为一体。

背景：从复制粘贴炼狱到语义搜索增强

这款插件由独立开发者 Heesu Suh（GitHub @glowingjade）从 2024 年初开始维护，目前版本 1.2.9，GitHub 累计 2287 Star。开发者在 2025 年底发布了维护声明，坦言插件目前由单人维护，不再处于活跃开发状态，但会持续发布 bug 修复。社区已经出现了多个 fork 分支。

值得特别注意的是，2026 年 1 月 Anthropic 对第三方 OAuth 访问进行了限制，官方警告使用订阅式 OAuth 存在账户被封禁的风险。插件在 2025 年 12 月紧急上线了直接填 API Key 的方式绕过这一问题。

核心功能：四个使用场景

1. 上下文感知对话（Contextual Chat）

这是插件的核心功能。在聊天框输入 @文件名 可以精确指定对话的上下文范围，AI 只会基于指定的文件内容回答。支持多文件引用——你可以同时选中多个笔记，让 AI 综合分析。

更有意思的是多媒体上下文支持：直接粘贴网页链接，插件会自动抓取页面内容；粘贴 YouTube 链接，插件获取字幕作为上下文；图片也可以直接拖入聊天窗口。2025 年底的更新还增加了对 MCP（Model Context Protocol）的支持，可以通过协议连接更多外部工具和数据源。

2. Apply Edit（一键采纳修改）

灵感来自 Google Docs 的 suggestion mode：AI 分析当前文档后，给出修改建议（绿色高亮），用户一键采纳。这比传统 AI 生成一段文字我来复制粘贴的流程效率高得多。

3. Vault Search（RAG 语义搜索）

按 Cmd+Shift+Enter 触发，插件自动在笔记库中做语义检索，找到与当前问题最相关的笔记段落，作为上下文喂给 AI。这是典型的 RAG（检索增强生成）架构，embedding 模型支持 OpenAI / Cohere / Gemini / Ollama 本地运行。

4. 多模型支持

插件不绑定单一 AI 服务。支持 OpenAI、Anthropic Claude、Google Gemini、Groq、DeepSeek、OpenRouter、Azure OpenAI，以及本地部署的 Ollama 和 LM Studio。甚至支持任何 OpenAI API 兼容的第三方提供商。如果你不想付 API 费用，插件推荐使用 Gemini 免费额度。

技术架构：TypeScript + React + Lexical

从代码结构来看，这是一个相当标准的现代 TypeScript 项目。构建工具使用 esbuild，配合 TypeScript 严格模式检查。UI 框架为 React 18 + Radix UI 组件库（Dialog、Popover、Tooltip 等），富文本编辑使用 Lexical——Facebook 开源的编辑器框架，是 Draft.js 的继任者，用于处理聊天消息和 Apply Edit 的高亮差异展示。

状态管理采用 TanStack React Query（服务端状态）+ React Context 模式。数据库层使用 Drizzle ORM + PGLite（嵌入式 PostgreSQL），用于存储聊天历史和 RAG 向量数据。AI 集成层面，langchain 负责 RAG pipeline，同时集成了多家 SDK（OpenAI / Anthropic / Gemini / Groq）。代码质量方面，有 ESLint + Prettier 格式化规则和 Jest 测试套件。

插件的核心模块包括：RAGEngine（语义检索引擎）、McpManager（MCP 协议管理器）、DatabaseManager（聊天历史持久化）、ChatView / ApplyView（两个主视图）。

部署与使用门槛

安装非常简单：Obsidian 客户端 > 设置 > 社区插件 > 搜索 Smart Composer > 安装启用。最低需要 Obsidian 0.15.0 版本。

配置 API Key 有两种路径。第一种是直接填 API Key（推荐）：在设置页面填入 OpenAI / Claude / Gemini 的 API Key，数据完全走官方 API，隐私有保障。第二种是订阅 OAuth 连接（有风险）：用插件内置的 OAuth 流程连接 Claude/OpenAI 订阅，无需 API Key，但存在账户被封禁的风险，插件已对此发出明确警告。

本地模型支持是隐私敏感用户的最佳选择：配合 Ollama 跑 llama3 / mistral 等开源模型，embedding 也可选 Ollama 的本地向量模型，所有数据不离开本机。

局限与风险

1. 单人维护，非活跃开发：插件作者已明确表示无法及时响应 issue 和 feature request，依赖社区 fork 延续生命力。

2. Claude OAuth 风险：Anthropic 2026 年 1 月的政策变化影响了插件的无 API Key 连接功能。

3. 非 Web 部署：这是 Obsidian 桌面/移动客户端插件，没有 Docker 一键部署选项，团队协作场景受限。

4. PDF/DOCX 支持尚未上线：虽然 roadmap 里有，但目前还不支持文档文件。

行业意义

Smart Composer 代表了 AI + 本地知识管理赛道的一个重要方向：不是把所有数据交给云端 AI 处理，而是让 AI 去索引用户本地的笔记资产。在 Notion AI、Obsidian Local REST API 等竞品的夹击下，它的差异化在于深度集成 Obsidian 的双向链接和文件图谱，Apply Edit 功能填补了 Obsidian 生态中 AI 写作辅助的空白，以及 MCP 支持让插件具备协议级别的扩展性，未来可连接更多外部数据源。

2287 Star 的社区认可度说明这个方向确实戳中了知识工作者的痛点。随着 RAG 技术成熟和本地模型性能提升，类似插件会成为个人 AI 助手的重要组成部分。