一句话:给 Obsidian 做的全能 AI 助手插件 —— 不只是一个聊天窗口,而是能读写你笔记的智能体系统。

从 2.0.0 起完全免费、源码公开(MIT)。 授权系统已整个删除,旧激活码全部作废——也不再需要。想听这玩意的来龙去脉,看:一个 Obsidian AI 插件的始末

仓库 / 下载https://github.com/zzzzzllllllaaaa/ai-chat-assistant
最新版本2.0.0(免费开源版,MIT)
平台桌面端 + iOS + Android,最低 Obsidian 1.5.0
上架情况未上架官方社区插件市场,手动安装
授权无。旧激活码作废;曾付费用户可开 issue 联系退款
作者我(3zh)

它能干什么

多模型 & 本地模型

  • Ollama 跑本地模型(Llama 3 / Qwen 等),敏感笔记完全不出网
  • 也能接任意 OpenAI 兼容接口(OpenAI、DeepSeek、硅基流动、自建中转……)

笔记智能体(Smart Agents)

  • AI 能自己调工具:读结构、搜笔记、精确替换文本、新建文件
  • 可建垂直 Agent(记账助手、代码分析助手之类),逐个分配工具权限
  • 先取证再动手:修改类任务先进 inspect(读、搜、看结构),确认后再 act;写后必须验证,失败进 repair

知识库检索(RAG)

  • 本地向量库(IndexedDB),不依赖任何外部服务
  • 图谱感知检索:沿 Obsidian 双链抓上下文,理解笔记之间的逻辑网
  • 向量 + 关键词混合搜索 + 重排;增量索引,只算变化的文件

其他

  • MCP 工具生态:接标准 MCP Server(HTTP / SSE),调外部搜索、数据库、本地命令
  • 长期记忆 + 角色卡:后台记偏好设定,兼容 SillyTavern 角色卡(PNG / JSON)
  • 多模型协作:路由模式、慢思考模式、预算控制

装法(3 步)

  1. Releases 下载 main.jsmanifest.jsonstyles.css 三个文件
  2. 放到 <你的库>/.obsidian/plugins/ai-chat-assistant/
  3. 重启 Obsidian → 设置 → 第三方插件 → 启用 AI Chat Assistant

然后进 设置 → AI Chat Assistant 填模型 API Key(用 Ollama 就填本地 URL、Key 留空)。全部功能直接可用,没有激活这一步。

⚠️ 已知不足(老实说)

源码公开时一并说明白,免得别人踩坑后骂人:

  • DeepSeek 缓存命中率没真正优化好:prompt 前缀不稳定,缓存收益远低于预期
  • Skills 与 MCP 是雏形:MCP 只有 HTTP/SSE,没有 stdio,也没在真实客户端上充分验证
  • 大文件技术债main.ts 2569 行、src/ui/views/view.ts 3217 行,拆分没做完
  • 没有自动化测试,改代码靠人肉验证
  • 内置 HTTP API server 无鉴权(默认关闭,仅本机用,别暴露公网)
  • 移动端能用但慢:大仓库索引与检索体验一般

隐私

  • 无遥测:不含埋点或数据收集代码
  • 数据直连:聊天内容和笔记只在你本地设备与你配置的模型服务商之间传输,不经过第三方中转服务器
  • 配本地模型 + 本地向量库,可以完全断网运行

说明

  • 源码已公开(MIT,插件 ID ai-chat-assistant);仓库 = 源码,Releases = 编译产物
  • 2.0.0 是「减法版本」:删掉付费授权后版本号从 1.9.11 直接跳到 2.0.0;这次用 force push 重写历史,把旧 README 里那段测试卡密一起抹掉了
  • 维护策略:不追新功能,能跑就行,欢迎接手
  • 想听故事:一个 Obsidian AI 插件的始末(怎么从「推荐相关笔记」长成智能体、设计取舍、以及做砸的地方)
  • GitHub 国内访问可能不稳定,打不开时需要自备网络手段