AI Chat Assistant

AI Chat Assistant 是一款为 Obsidian 深度定制的全能 AI 助手插件。它不仅是一个聊天窗口，更是一个能读写你笔记的智能体系统（Agent System）。

无论你是想与本地知识库对话（RAG）、让 AI 自动帮你整理和创建笔记，还是想接入 MCP（模型上下文协议）调用外部工具，它都能满足你的需求。

---

🌟 核心特性 (Key Features)

🤖 强大的多模型支持 & 本地大模型

• 本地隐私优先：完美支持 Ollama 接入。你可以使用完全离线的本地模型（如 Llama 3, Qwen）处理敏感笔记，数据绝不出网。
• 自定义 API：支持任意兼容 OpenAI 格式的第三方中转 API。

📂 真正懂你的“笔记智能体” (Smart Agents)

• 读写与执行：不仅能“聊”，还能“做”。AI 可以自主使用工具来读取结构、搜索笔记、精准替换文本、新建文件。
• 自定义智能体：你可以创建专属的垂直领域 Agent（例如“生活管理智能体”、“代码分析助手”），给它分配不同的工具权限，让它按你的规则全自动处理库内文件。
• 零幻觉机制：执行操作前自动拉取当前笔记上下文，先取证、再思考、后执行。

🧠 增强的知识库检索 (RAG)

• 本地向量数据库：无需依赖外部服务，使用 IndexedDB 在本地进行高效的向量化存储与检索。
• 图谱感知检索 (Graph RAG)：自动沿着 Obsidian 的双向链接（正向/反向链接）抓取上下文，AI 能理解你笔记之间的逻辑网。
• 混合搜索：向量相似度 + 关键词匹配 + 混合重排 (Reranking)，精准定位你遗忘在角落的知识。

🔌 MCP 工具生态接入 (Model Context Protocol)

• 支持接入标准 MCP Server，让你的 Obsidian AI 能直接调用外部网络搜索、执行本地系统命令或读取外部数据库，打破次元壁！

🎭 长期记忆与角色扮演 (Memory & Persona)

• 自动记忆提取：AI 会在后台默默记住你的喜好和设定，跨越多个对话依然“懂你”。
• SillyTavern 兼容：支持导入主流的角色卡片（PNG/JSON格式），在 Obsidian 里和专属角色沉浸式互动。

---

🚀 安装指南 (Installation)

方法一：通过 Obsidian 社区插件市场（推荐）

1. 打开 Obsidian 的 设置 (Settings) -> 第三方插件 (Community plugins)。
2. 关闭 安全模式 (Safe mode)。
3. 点击 浏览 (Browse)，搜索 AI Chat Assistant。
4. 点击 安装 (Install)，然后 启用 (Enable)。

方法二：手动安装 (Manual)

1. 前往本仓库的 Releases 页面 下载最新版本的压缩包（包含 main.js, manifest.json, styles.css）。
2. 将这些文件放入你的 Obsidian 插件目录中：<你的库路径>/.obsidian/plugins/ai-chat-assistant/。
3. 重启 Obsidian，在第三方插件列表中启用它。

---

📖 快速上手 (Getting Started)

第一步：配置大模型 API

1. 启用插件后，打开 设置 -> AI Chat Assistant。
2. 在 API 供应商 (AI Provider) 中选择你喜欢的模型（如 OpenAI, DeepSeek, 或本地 Ollama）。
3. 填入你的 API Key（如果使用 Ollama 等本地模型则留空并配置本地 URL 即可）。

第二步：开始对话与操作笔记

1. 点击 Obsidian 左侧侧边栏的 🤖 机器人图标，打开聊天面板。
2. 普通聊天：直接输入问题，AI 会进行常规回答。
3. 操作笔记：尝试对它说：

   "帮我新建一个名为『本周计划』的笔记，并列出周一到周五的 TODO 列表。"

   "帮我搜索一下库里关于『人工智能』的笔记，总结成一段话写在当前笔记的末尾。"

第三步：创建你自己的专属智能体 (Custom Agents)

想要一个严格按你格式记账的助手？

1. 进入插件设置的 智能体 (Agents) 选项卡。
2. 点击 添加自定义智能体。
3. 填写名称（如“记账助手”），并在系统提示词中写下它的规则："你是一个严格的记账员。每次我告诉你花了多少钱，你必须读取『账本.md』，并在末尾追加记录，最后计算总额..."。
4. 分配工具：为它勾选 read_note 和 modify_note 等工具权限。
5. 在聊天窗口顶部切换到该智能体，即可开始专属工作流！

---

🛡️ 隐私与安全 (Privacy & Security)

我们深知笔记是你的第二大脑，隐私至关重要。

• 无遥测、无后门：本插件绝不包含任何隐藏的埋点或数据收集代码（Telemetry）。
• 数据直连：你的聊天记录和笔记内容只会在你本地设备，与你配置的 AI 服务商（如 OpenAI, 阿里云）之间直接点对点传输，不会经过任何第三方中转服务器。
• 本地化方案：配合本地化大模型（如 Ollama）和本地向量检索，你可以实现 100% 离线 断网运行，彻底杜绝数据泄露风险。

---

❓ 常见问题 (FAQ)

Q: 为什么 AI 说它“修改了笔记”，但我看文件没变化？ A: 确保你当前选中的智能体被授予了 modify_note 等写入工具的权限。对于简短的闲聊，系统默认会关闭修改权限以防大模型误操作。如果你使用的是自定义智能体，它将始终拥有你赋予的工具权限。

Q: 移动端 (iOS/Android) 可以使用吗？ A: 完全可以！插件针对移动端界面进行了专门优化，只要你的 API 接口能在手机网络下访问，即可无缝使用。

---

---

测试卡密

T-2DB1-AC6B-713D T-1A41-B346-0289 T-2BC0-B8E0-9D31 T-5CCA-3E87-C8DC T-2F46-1DBA-4EF2 T-3EF0-1781-B81E T-F296-8337-4FF0 T-B473-E6A0-C686 T-AB3D-45ED-D123 T-9EC7-6553-B592 T-D701-6611-0D6F T-2AAC-CA9E-7BCE T-DD81-4212-C24D T-4A8A-D9C7-6DD1 T-259B-7EB9-E004 T-CAE1-5956-7B44 T-44FF-2CB6-1C68 T-C6F0-0A39-B272 T-AF72-A83E-2D50 T-B63E-9A26-ED3F T-7169-A6E8-E314 T-0CC7-5910-473A T-0E14-970C-7DC6 T-ACC7-0C0F-0DE8 T-45E5-E7E7-7976 T-49C9-F95B-4EC6 T-AD0F-D037-A634 T-AA80-6ED0-ABF9 T-CD17-197D-15AD T-28BA-C397-12B9 T-676D-59BB-74E1 T-8031-452F-66EE T-6416-84E6-C9E2 T-7C3F-769D-6A09 T-7265-45F4-D19B T-D146-66C2-C16B T-F256-D04D-6DAC T-A3D5-2A30-3AF6 T-02AD-2BBF-1223 T-849B-73E6-EFBF T-F13F-D954-2BF4 T-CCC4-F700-927D T-6B3D-85F9-ED25 T-6F6A-0DC6-DB21 T-6D02-DD72-F085 T-AD40-45B6-9C8F T-3D7F-2F09-058B T-59F6-4F7B-8747 T-7843-A4EF-B9D7 T-CE1E-9B7E-C45B

---

🤝 支持与贡献 (Support & Contribute)

如果你喜欢这个插件，欢迎：

• 在 GitHub 上点个 ⭐ Star！
• 提交 Issue 反馈 Bug 或提出新功能建议。
• 提交 Pull Request 参与代码贡献。

开发者: 3zh
开源协议: MIT License