一句话:给 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 步)
- 到 Releases 下载
main.js、manifest.json、styles.css三个文件 - 放到
<你的库>/.obsidian/plugins/ai-chat-assistant/ - 重启 Obsidian → 设置 → 第三方插件 → 启用 AI Chat Assistant
然后进 设置 → AI Chat Assistant 填模型 API Key(用 Ollama 就填本地 URL、Key 留空)。全部功能直接可用,没有激活这一步。
⚠️ 已知不足(老实说)
源码公开时一并说明白,免得别人踩坑后骂人:
- DeepSeek 缓存命中率没真正优化好:prompt 前缀不稳定,缓存收益远低于预期
- Skills 与 MCP 是雏形:MCP 只有 HTTP/SSE,没有 stdio,也没在真实客户端上充分验证
- 大文件技术债:
main.ts2569 行、src/ui/views/view.ts3217 行,拆分没做完 - 没有自动化测试,改代码靠人肉验证
- 内置 HTTP API server 无鉴权(默认关闭,仅本机用,别暴露公网)
- 移动端能用但慢:大仓库索引与检索体验一般
隐私
- 无遥测:不含埋点或数据收集代码
- 数据直连:聊天内容和笔记只在你本地设备与你配置的模型服务商之间传输,不经过第三方中转服务器
- 配本地模型 + 本地向量库,可以完全断网运行
说明
- 源码已公开(MIT,插件 ID
ai-chat-assistant);仓库 = 源码,Releases = 编译产物 - 2.0.0 是「减法版本」:删掉付费授权后版本号从 1.9.11 直接跳到 2.0.0;这次用 force push 重写历史,把旧 README 里那段测试卡密一起抹掉了
- 维护策略:不追新功能,能跑就行,欢迎接手
- 想听故事:一个 Obsidian AI 插件的始末(怎么从「推荐相关笔记」长成智能体、设计取舍、以及做砸的地方)
- GitHub 国内访问可能不稳定,打不开时需要自备网络手段