Obsidian AI 写作助手

中文 · English

在 Obsidian 里让 AI 帮你整理、润色和修改笔记。你选择本轮要用的笔记、文字或图片，修改先显示前后对比，确认后再保存。

使用前提： 桌面版 Obsidian 1.8.7+，以及你自己的 AI 接口与密钥，或已运行的本地 Ollama。使用远程模型时，你选定并发送的内容会交给该服务商处理。

查看演示 · 安装插件 · 模型配置与部署

界面

它能做什么

• 上下文透明 — 本轮用了什么，逐项可见、可移除。
• 写回有门 — 插入、追加、覆盖、新建与多文件 Diff 都需要确认，误操作可撤销。
• 接口自由 — 支持 OpenAI Responses、任何 OpenAI 兼容的 Chat Completions、Anthropic Messages，以及本地跑的 Ollama。
• 敏感信息克制 — API Key 与自定义 Header 默认仅驻留内存；远程接口强制 HTTPS；危险 Header 会被拒绝。
• 完整工作台 — 流式回复、思考过程折叠、图片理解、历史搜索 / 置顶 / 导出、斜杠工作流与提示词缓存。
• 四套全局主题 — 天青、翡翠、晚霞、深灰；右上角切换并持久保存，深灰背景固定为 #17191d。

安装

从 Releases 下载 main.js、manifest.json、styles.css，放进：

<你的 Vault>/.obsidian/plugins/vault-muse/

重启 Obsidian，在「设置 → 社区插件」中启用。然后添加模型配置。

建议保持"在本地保存敏感配置"关闭——这样 API Key 只在内存里，Obsidian 重启后重新输入。如果你更看重方便，可以打开，但要清楚这意味着 Key 会写进 Vault 的插件数据。

完整步骤见安装与部署。

技术上值得一提的地方

写入路径是白名单式的。 路径穿越、绝对路径、.trash 和 Vault 配置目录都被禁止写入。一个能被诱导写 .obsidian/ 的插件，等于能改你的所有配置。

API Key 与自定义 Header 默认只在内存。 远程接口强制 HTTPS；能用来做请求走私或权限提升的危险 Header 直接拒绝，而不是原样转发。

删除只进废纸篓。 不做永久删除——AI 判断错了一次，代价不该是一篇不可恢复的笔记。

四种接口协议是分别实现的。 OpenAI Responses、OpenAI 兼容 Chat Completions、Anthropic Messages 和 Ollama 各有自己的请求 / 流式解析路径，不是靠一个"兼容层"硬套，所以每家的思考过程、缓存和图片语义都能正确对上。

npm run check 是真门禁。 依次跑 ESLint、55 个纯逻辑测试、严格类型检查和生产构建。构建默认只生成本地 main.js，只有开发者显式设置 VAULT_MUSE_DEPLOY_DIR 时才复制到测试 Vault——避免"跑一下测试就把你的真实 Vault 改了"。

它不做什么

• 聊天本身不会修改任何文件，只有你明确确认的动作会写入。
• 不扫描整个 Vault。
• 不代理、不托管、不隐藏你的模型请求。 你选的接口服务商仍然会收到你主动发送的内容——这一点没有任何插件能替你规避，说清楚比含糊更重要。
• 对话与设置保存在当前 Vault 的插件数据里，可在高级设置一键清除。

开发

npm ci
npm run check
npm run package:release

更多文档

安装与部署 · 架构 · 隐私与数据流 · 发布审计 · 版本变更 · 参与开发 · 安全策略

来源与许可

本项目是基于 MIT 项目 grok-obsidian 的独立衍生作品，保留原作者版权与来源说明，详见 NOTICE。

以 MIT License 发布。与 Obsidian、OpenAI、Anthropic 均无隶属或背书关系。